@futdevpro/nts-dynamo 1.15.68 → 1.15.70

package/build/_modules/ai/_modules/open-ai/_services/oai-llm-chat.service-base.js

@@ -1,480 +1,480 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.DyNTS_OAI_LLMChat_ServiceBase = void 0;
-const fsm_dynamo_1 = require("@futdevpro/fsm-dynamo");
-const global_settings_const_1 = require("../../../../../_collections/global-settings.const");
-const ai_1 = require("@futdevpro/fsm-dynamo/ai");
-const oai_llm_service_base_1 = require("./oai-llm.service-base");
-const oai_global_settings_const_1 = require("../_collections/oai-global-settings.const");
-/**
- * {
- *   organization: 'org-XY',
- *   apiKey: 'sk-XY',
- *   project: 'proj_XY',
- * }
- */
-// Di Dictionary DiModel DiEz DiAz
-class DyNTS_OAI_LLMChat_ServiceBase extends oai_llm_service_base_1.DyNTS_OAI_LLM_ServiceBase {
-    // History management
-    /* private conversationHistories: Map<string, DyFM_AI_Message[]> = new Map(); */
-    /**
-     * Hozzáad egy üzenetet a conversation history-hoz
-     *
-     * Adds a message to conversation history
-     */
-    /* addMessageToHistory(message: DyFM_AI_Message, issuer: string): void {
-      if (!this.conversationHistories.has(issuer)) {
-        this.conversationHistories.set(issuer, []);
-      }
-      this.conversationHistories.get(issuer).push(message);
-    } */
-    /**
-     * Törli a conversation history-t
-     *
-     * Clears conversation history
-     */
-    /* clearHistory(issuer: string): void {
-      this.conversationHistories.delete(issuer);
-    } */
-    /**
-     * Visszaadja a conversation history-t
-     *
-     * Gets conversation history
-     */
-    /* getHistory(issuer: string): DyFM_AI_Message[] {
-      return this.conversationHistories.get(issuer) || [];
-    } */
-    /**
-     * Converts generic AI messages to OpenAI-specific format
-     *
-     * Az generic AI üzeneteket OpenAI-specifikus formátumra alakítja át
-     */
-    /* private convertToOAIMessages(messages: DyFM_AI_Message[]): DyFM_AI_Message[] {
-      return messages;
-    } */
-    /**
-     * Asks the AI to answer a yes/no question
-     *
-     * Uses the {@link DyNTS_OAI_LLM_Predefined_Requests.yesNo.request} to ask the question,
-     * and the {@link DyNTS_OAI_LLM_Predefined_Requests.yesNo.upperCaseYes} to check the answer
-     */
-    async requestYesNoInConversation(set) {
-        set.message += this.predefinedRequests.yesNo.request;
-        //this.logQuestion(set);
-        const answer = await this.requestSimpleMessageInConversation(set);
-        return this.convertAnswerToBoolean(answer);
-    }
-    //askYesNoQuestionInConversation: typeof this.yesNoQuestionInConversation = this.yesNoQuestionInConversation;
-    /**
-     * Asks the AI to answer a simple question
-     *
-     * Uses the {@link DyNTS_OAI_LLM_Predefined_Requests.simpleQuestion} to ask the question
-     */
-    /* async requestSimpleQuestionInConversation(
-      set: DyFM_AI_ConversationBase_Input<DyFM_OAI_CallSettings>
-    ): Promise<string> {
-      this.logQuestion(set);
-  
-      return await this.getQuestionAnswerInConversation(set);
-    } */
-    //askSimpleQuestionInConversation: typeof this.simpleQuestionInConversation = this.simpleQuestionInConversation;
-    /**
-     * Asks the AI to answer a percentage question
-     *
-     * Uses the {@link DyNTS_OAI_LLM_Predefined_Requests.percentageOnly} to ask the question
-     */
-    async requestPercentageInConversation(set) {
-        set.message += this.predefinedRequests.percentageOnly;
-        //this.logQuestion(set);
-        const answer = await this.requestSimpleMessageInConversation(set);
-        return this.convertAnswerToNumber(answer, set.message);
-    }
-    //askPercentageQuestionInConversation: typeof this.percentageQuestionInConversation = this.percentageQuestionInConversation;
-    /**
-     * Asks the AI to select one of the options from the list
-     *
-     * Uses the {@link DyNTS_OAI_LLM_Predefined_Requests.selectRequest} to ask the question
-     */
-    async requestSelectInConversation(set) {
-        // replace the {{DyNTS_selectOptions}} with the list of options
-        const selectQuestionAddition = this.predefinedRequests.selectRequest.replace('{{DyNTS_selectOptions}}', this.getTextListAsText(this.stringifySelectOptions(set.selectFrom)));
-        set.message += selectQuestionAddition;
-        //this.logQuestion(set);
-        const answer = await this.requestSimpleMessageInConversation(set);
-        return this.convertAnswerToSelectOption(answer, set.message, set.selectFrom);
-    }
-    //askSelectQuestionInConversation: typeof this.selectQuestionInConversation = this.selectQuestionInConversation;
-    /**
-     * Asks the AI to select one of the options from the list
-     * Similar to {@link askSelectQuestion},
-     * but with a more generic approach that can be used for objects
-     *
-     * Uses the {@link DyNTS_OAI_LLM_Predefined_Requests.selectRequest} to ask the question
-     */
-    /* async requestSelectInConversation<T>(
-      set: DyFM_AI_ConversationGenericSelect_Input<T, DyFM_OAI_CallSettings>
-    ): Promise<T | { unparsableResult: string }> {
-      const selectQuestionAddition = this.predefinedRequests.selectRequest.replace(
-        '{{DyNTS_selectOptions}}',
-        this.getTextListAsText(set.selectFrom.map(item => `"${JSON.stringify(item)}"`))
-      );
-      set.message += selectQuestionAddition;
-  
-      this.logQuestion(set);
-  
-      const answer = await this.getQuestionAnswerInConversation(set);
-  
-      return DyFM_Object.safeParseJSON<T>(answer);
-    } */
-    //askRequestSelectInConversation: typeof this.requestSelectInConversation = this.requestSelectInConversation;
-    /**
-     * Asks the AI to select one or more of the options from the list
-     *
-     * Uses the {@link DyNTS_OAI_LLM_Predefined_Requests.multiselect} to ask the question
-     */
-    /* async requestMultiselectInConversation(set: DyFM_AI_ConversationMultiSelect_Input): Promise<string[]> {
-      const selectQuestionAddition = this.predefinedRequests.multiselect.replace(
-        '{{DyNTS_selectOptions}}',
-        this.getTextListAsText(set.options)
-      );
-      set.message += selectQuestionAddition;
-  
-      let answer = await this.getQuestionAnswerInConversation(set);
-      
-      answer = answer.toLocaleUpperCase();
-      
-      const result: string[] = [];
-  
-      for (const item of set.options) {
-        if (answer.includes(item.toLocaleUpperCase())) {
-          result.push(item);
-        }
-      }
-  
-      return result;
-    } */
-    //askMultipleSelectQuestionWithOptionsInConversation: typeof this.multipleSelectQuestionWithOptionsInConversation = this.multipleSelectQuestionWithOptionsInConversation;
-    /**
-     * Asks the AI to select one or more of the options from the list
-     * Similar to {@link askMultipleSelectQuestionWithOptions},
-     * but with a more generic approach that can be used for objects
-     *
-     * Uses the {@link DyNTS_OAI_LLM_Predefined_Requests.multiselect} to ask the question
-     */
-    async requestMultiselectInConversation(set) {
-        const selectQuestionAddition = this.predefinedRequests.multiselect.replace('{{DyNTS_selectOptions}}', this.getTextListAsText(this.stringifySelectOptions(set.options)));
-        set.message += selectQuestionAddition;
-        //this.logQuestion(set);
-        const answer = await this.requestSimpleMessageInConversation(set);
-        return this.convertAnswerToList(answer, set.message);
-    }
-    //askRequestMultipleSelectInConversation: typeof this.requestMultipleSelectInConversation = this.requestMultipleSelectInConversation;
-    /**
-     * Asks the AI to answer a question that must result a JSON object
-     *
-     * If the answer is not a valid JSON object, it will return { unparsableResult: answer }
-     *
-     * Uses the {@link DyNTS_OAI_LLM_Predefined_Requests.jsonRequest} to ask the question
-     *
-     * (uses {@link DyFM_safeParseJSON})
-     */
-    async requestJSONInConversation(set) {
-        set.message += this.predefinedRequests.jsonRequest;
-        //this.logQuestion(set);
-        const answer = await this.requestSimpleMessageInConversation(set);
-        return this.convertAnswerToJSON(answer, set.message);
-    }
-    //askJsonQuestionInConversation: typeof this.jsonQuestionInConversation = this.jsonQuestionInConversation;
-    /**
-     * Asks the AI to answer a question that must result a JSON object with specific key descriptions
-     *
-     * If the answer is not a valid JSON object, it will return { unparsableResult: answer }
-     *
-     * Uses the {@link DyNTS_OAI_LLM_Predefined_Requests.jsonRequestWithKeysDescription} to ask the question
-     *
-     * (uses {@link DyFM_safeParseJSON})
-     */
-    /* async requestJSONInConversationWithKeysDescription<T = any>(
-      set: DyFM_AI_ConversationJSONKeysDescription_Input<DyFM_OAI_CallSettings>
-    ): Promise<T | { unparsableResult: string }> {
-      return this.jsonQuestionWithKeysDescriptionInConversation<any>(set);
-    } */
-    /**
-     * Asks the AI to answer a question that must result a JSON object with specific key descriptions
-     *
-     * If the answer is not a valid JSON object, it will return { unparsableResult: answer }
-     *
-     * Uses the {@link DyNTS_OAI_LLM_Predefined_Requests.jsonRequestWithKeysDescription} to ask the question
-     *
-     * (uses {@link DyFM_safeParseJSON})
-     */
-    async requestJSONInConversationWithKeysDescription(set) {
-        const jsonRequestWithKeysDescription = this.predefinedRequests.jsonRequestWithKeysDescription.replace('{{DyNTS_jsonKeysDescription}}', set.keysDescription);
-        set.message += jsonRequestWithKeysDescription;
-        //this.logQuestion(set);
-        const answer = await this.requestSimpleMessageInConversation(set);
-        return this.convertAnswerToJSON(answer, set.message);
-    }
-    //askJsonQuestionWithKeysDescriptionInConversation: typeof this.jsonQuestionWithKeysDescriptionInConversation = this.jsonQuestionWithKeysDescriptionInConversation;
-    /**
-     * Asks the AI to answer a question that must result a JSON object with specific keys
-     *
-     * If the answer is not a valid JSON object, it will return { unparsableResult: answer }
-     *
-     * Uses the {@link DyNTS_OAI_LLM_Predefined_Requests.jsonRequestWithExactKeys} to ask the question
-     *
-     * (uses {@link DyFM_safeParseJSON})
-     */
-    /* async requestJSONInConversationWithExactKeys(set: DyFM_AI_ConversationJSONExactKeys_Input): Promise<object> {
-      const result = await this.jsonQuestionWithExactKeysInConversation<any>(set);
-      return typeof result === 'object' ? result : {};
-    } */
-    /**
-     * Asks the AI to answer a question that must result a JSON object with specific keys
-     *
-     * If the answer is not a valid JSON object, it will return { unparsableResult: answer }
-     *
-     * Uses the {@link DyNTS_OAI_LLM_Predefined_Requests.jsonRequestWithExactKeys} to ask the question
-     *
-     * (uses {@link DyFM_safeParseJSON})
-     */
-    async requestJSONInConversationWithExactKeys(set) {
-        const jsonRequestWithExactKeys = this.predefinedRequests.jsonRequestWithExactKeys.replace('{{DyNTS_jsonKeys}}', this.getTextListAsText(set.keys));
-        set.message += jsonRequestWithExactKeys;
-        //this.logQuestion(set);
-        const answer = await this.requestSimpleMessageInConversation(set);
-        return this.convertAnswerToJSON(answer, set.message);
-    }
-    //askJsonQuestionWithExactKeysInConversation: typeof this.jsonQuestionWithExactKeysInConversation = this.jsonQuestionWithExactKeysInConversation;
-    /**
-     * Asks the AI to answer a question that must result a list of strings
-     *
-     * If the answer is not a valid JSON list, it will return the answer as a single item in an array
-     *
-     * Uses the {@link DyNTS_OAI_LLM_Predefined_Requests.listRequest} to ask the question
-     *
-     * (uses {@link DyFM_Object.safeParseList})
-     */
-    async requestListInConversation(set) {
-        set.message += this.predefinedRequests.listRequest;
-        //this.logQuestion(set);
-        const answer = await this.requestSimpleMessageInConversation(set);
-        return this.convertAnswerToList(answer, set.message);
-    }
-    //askListQuestionInConversation: typeof this.listQuestionInConversation = this.listQuestionInConversation;
-    /**
-     * Asks the AI to answer a question
-     *
-     * Uses the {@link resolveSimpleUserMessage}
-     */
-    /* async getQuestionAnswerInConversation(
-      conversation: DyFM_AI_Message[],
-      question: string,
-      issuer: string,
-      debugLog?: boolean,
-      messageSettings: DyFM_OAI_CallSettings = this.defaultSettings
-    ): Promise<string> {
-      const answer = await this.resolveSimpleUserMessageInConversation(
-        conversation,
-        question,
-        issuer,
-        messageSettings,
-      ) as Promise<string>;
-  
-      if (debugLog) {
-        console.log(' - ', answer);
-      }
-  
-      return answer;
-    } */
-    /* async requestSimpleQuestionInConversation(set: DyFM_AI_ConversationMessage_Input): Promise<string> {
-      return await this.getAnswerInConversation({
-        ...set,
-        newMessage: set.message,
-      });
-    } */
-    /* getQuestionAnswerInConversation = this.getAnswerInConversation; */
-    //getQuestionInConversation: typeof this.getQuestionAnswerInConversation = this.getQuestionAnswerInConversation;
-    //askQuestionInConversation: typeof this.getQuestionAnswerInConversation = this.getQuestionAnswerInConversation;
-    //getConversationAnswer: typeof this.getAnswerInConversation = this.getAnswerInConversation;
-    /**
-     * Asks the AI to answer a question using the whole conversation
-     * (If you want to use only the conversation, without adding a new message,
-     * use directly the {@link resolveConversation})
-     *
-     * Uses the {@link resolveConversation}
-     */
-    async requestSimpleMessageInConversation(set) {
-        // Convert generic AI messages to OpenAI-specific format
-        //const oaiConversation: DyFM_AI_Message[] = /* this.convertToOAIMessages(set.conversation) */ set.conversation;
-        if (set.message) {
-            set.conversation.push({
-                role: ai_1.DyFM_AI_MessageRole.user,
-                content: set.message,
-            });
-        }
-        const answer = await this.resolveConversation({
-            ...set,
-            getFullResponse: false,
-        });
-        this.logAnswer(answer);
-        return answer;
-    }
-    /* async resolveConversationMessage(
-      set: {
-        conversation: DyFM_AI_Message[],
-        issuer: string,
-        settings?: DyFM_OAI_CallSettings,
-        getFullResponse?: boolean,
-        debugLog?: boolean,
-         * this is used to readably replace too long contents to eg '...' in logs
-        replaceThisInLog?: string,
-      }
-    ): Promise<string> {
-      return await this.resolveConversation(set) as string;
-    } */
-    /**
-     * Resolves a conversation
-     *
-     * Uses the {@link getMessageCreateInput}
-     */
-    async resolveConversation(set) {
-        try {
-            if (!set.conversation.some(message => message.role === ai_1.DyFM_AI_MessageRole.system)) {
-                /* throw new DyFM_Error({
-                  ...this.getDefaultErrorSettings(
-                    'resolveConversation',
-                    new Error('System message found in conversation'),
-                    set.issuer
-                  ),
-                  errorCode: `${DyNTS_global_settings.systemShortCodeName}|DyNTS-OAB-RC1`,
-                }); */
-                /* DyFM_Log.error('System message found in conversation', {
-                  conversation: set.conversation,
-                });
-              } else { */
-                set.conversation.unshift(this.getDefaultSystemMessage(set.settings));
-            }
-            // conversation shortening
-            const shortenedConversation = this.shortenConversation(set);
-            this.validateConversation(shortenedConversation);
-            //this.logQuestion(set);
-            this.logConversation({
-                ...set,
-                conversation: shortenedConversation,
-            });
-            // FR-002 — per-call cost-event timing
-            const callInput = this.getMessageCreateInput({
-                ...set,
-                conversation: shortenedConversation,
-            });
-            const start = Date.now();
-            const result = await this.openai.chat.completions.create(callInput);
-            const durationMs = Date.now() - start;
-            // FR-002 — cost-event emit (resolveConversation = 'llm-chat' flow alapból)
-            this.emitCostEvent({
-                callType: 'llm-chat',
-                provider: this.aiProvider,
-                model: String(callInput.model ?? this.defaultModel),
-                tokensUsed: {
-                    input: result.usage?.prompt_tokens ?? 0,
-                    output: result.usage?.completion_tokens ?? 0,
-                    total: result.usage?.total_tokens ?? 0,
-                },
-                durationMs: durationMs,
-                issuer: set.issuer,
-                timestamp: new Date(),
-            });
-            if (set.getFullResponse) {
-                return result;
-            }
-            return result.choices[0].message.content;
-        }
-        catch (error) {
-            throw new fsm_dynamo_1.DyFM_Error({
-                ...this.getDefaultErrorSettings('resolveConversation', error, set.issuer),
-                errorCode: `${global_settings_const_1.DyNTS_global_settings.systemShortCodeName}|DyNTS-OAB-RC0`,
-            });
-        }
-    }
-    //resolveSimpleUserMessageInConversation: typeof this.resolveConversation = this.resolveConversation;
-    shortenConversation(set) {
-        try {
-            // Step 1: Clone the conversation to avoid mutating the original
-            const clonedConversation = fsm_dynamo_1.DyFM_Object.clone(set.conversation);
-            // Step 2: Separate system messages from user/assistant messages
-            // System messages are kept and not shortened
-            const systemMessages = clonedConversation.filter((message) => message.role === ai_1.DyFM_AI_MessageRole.system);
-            // Step 3: Calculate system messages length as JSON string
-            // ⚠️ ISSUE: This measures JSON string length, not actual token count
-            // ⚠️ ISSUE: Doesn't account for message structure overhead (role, content keys, formatting)
-            const systemMessagesStringLength = JSON.stringify(systemMessages).length;
-            // Step 4: Extract only content strings from non-system messages
-            // ⚠️ ISSUE: Only measuring content strings, not full message structure
-            // ⚠️ ISSUE: OpenAI counts tokens for full message format: {"role": "...", "content": "..."}
-            const msgs = clonedConversation.filter((message) => message.role !== ai_1.DyFM_AI_MessageRole.system).map((message) => message.content);
-            // Step 5: Stringify the content array to measure total length
-            // ⚠️ ISSUE: This is character count, not token count - ratio varies (1 token ≈ 1-4 chars)
-            let stringifiedMessages = JSON.stringify(msgs);
-            // Step 6: Log initial state if debug is enabled
-            if (this._debugLog || set.debugLog) {
-                fsm_dynamo_1.DyFM_Log.info(' DyNTS_OAI_LLMChat_ServiceBase: before shortening conversation', {
-                    stringifiedMessagesLength: stringifiedMessages.length,
-                    conversationLength: clonedConversation.length,
-                    lastMessage: fsm_dynamo_1.DyFM_Array.last(clonedConversation)?.content,
-                });
-            }
-            // Step 7: Initialize tracking variables
-            let removedMessagesCount = 0;
-            let lastStringifiedMessagesLength = stringifiedMessages.length;
-            // Step 8: Loop to remove messages until under character limit
-            // ⚠️ ISSUE: Comparing character count to token limit - different units!
-            // ⚠️ ISSUE: maxMessagesStringLength (120k chars) may not safely map to 128k tokens
-            // ⚠️ ISSUE: Condition allows single very long message to remain (length > 1)
-            while ((stringifiedMessages.length + systemMessagesStringLength) > oai_global_settings_const_1.DyNTS_OAI_global_settings.maxMessagesStringLength &&
-                clonedConversation.length > 1) {
-                // Step 8a: Remove oldest message from full conversation
-                clonedConversation.splice(0, 1);
-                // Step 8b: Remove corresponding content from msgs array
-                // ⚠️ CRITICAL BUG: Always removes from msgs, even if removed message was a system message!
-                // ⚠️ This causes array desynchronization - msgs and clonedConversation get out of sync
-                msgs.splice(0, 1);
-                removedMessagesCount++;
-                // Step 8c: Recalculate stringified length after removal
-                stringifiedMessages = JSON.stringify(msgs);
-                lastStringifiedMessagesLength = stringifiedMessages.length;
-            }
-            // Step 9: Log final state if debug is enabled
-            if (this._debugLog || set.debugLog) {
-                fsm_dynamo_1.DyFM_Log.info(' DyNTS_OAI_LLMChat_ServiceBase: after shortening conversation', {
-                    removedMessagesCount: removedMessagesCount,
-                    lastStringifiedMessagesLength: lastStringifiedMessagesLength,
-                    lastMessage: fsm_dynamo_1.DyFM_Array.last(clonedConversation)?.content,
-                    localStackLocation: (0, fsm_dynamo_1.DyFM_getLocalStackLocation)(),
-                });
-            }
-            // Step 10: Safety check - ensure we didn't remove everything
-            if (!clonedConversation.length) {
-                fsm_dynamo_1.DyFM_Log.error('No conversation messages (left)', {
-                    /* conversation: DyFM_Object.clone(conversation), */
-                    conversationLength: set.conversation.length,
-                    clonedConversation: fsm_dynamo_1.DyFM_Object.clone(clonedConversation),
-                });
-                throw new Error('No conversation messages (left)');
-            }
-            // Step 11: Reconstruct conversation: system messages first, then shortened non-system messages
-            // ⚠️ ISSUE: clonedConversation may still contain system messages mixed in
-            // ⚠️ This could result in duplicate system messages in the final array
-            return [...systemMessages, ...clonedConversation];
-        }
-        catch (error) {
-            fsm_dynamo_1.DyFM_Error.logSimple('❌❌ Error shortening conversation:', error);
-            throw new fsm_dynamo_1.DyFM_Error({
-                ...this.getDefaultErrorSettings('shortenConversation', error, set.issuer),
-                errorCode: `${global_settings_const_1.DyNTS_global_settings.systemShortCodeName}|DyNTS-OAB-SC0`,
-            });
-        }
-    }
-}
-exports.DyNTS_OAI_LLMChat_ServiceBase = DyNTS_OAI_LLMChat_ServiceBase;
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.DyNTS_OAI_LLMChat_ServiceBase = void 0;
+const fsm_dynamo_1 = require("@futdevpro/fsm-dynamo");
+const global_settings_const_1 = require("../../../../../_collections/global-settings.const");
+const ai_1 = require("@futdevpro/fsm-dynamo/ai");
+const oai_llm_service_base_1 = require("./oai-llm.service-base");
+const oai_global_settings_const_1 = require("../_collections/oai-global-settings.const");
+/**
+ * {
+ *   organization: 'org-XY',
+ *   apiKey: 'sk-XY',
+ *   project: 'proj_XY',
+ * }
+ */
+// Di Dictionary DiModel DiEz DiAz
+class DyNTS_OAI_LLMChat_ServiceBase extends oai_llm_service_base_1.DyNTS_OAI_LLM_ServiceBase {
+    // History management
+    /* private conversationHistories: Map<string, DyFM_AI_Message[]> = new Map(); */
+    /**
+     * Hozzáad egy üzenetet a conversation history-hoz
+     *
+     * Adds a message to conversation history
+     */
+    /* addMessageToHistory(message: DyFM_AI_Message, issuer: string): void {
+      if (!this.conversationHistories.has(issuer)) {
+        this.conversationHistories.set(issuer, []);
+      }
+      this.conversationHistories.get(issuer).push(message);
+    } */
+    /**
+     * Törli a conversation history-t
+     *
+     * Clears conversation history
+     */
+    /* clearHistory(issuer: string): void {
+      this.conversationHistories.delete(issuer);
+    } */
+    /**
+     * Visszaadja a conversation history-t
+     *
+     * Gets conversation history
+     */
+    /* getHistory(issuer: string): DyFM_AI_Message[] {
+      return this.conversationHistories.get(issuer) || [];
+    } */
+    /**
+     * Converts generic AI messages to OpenAI-specific format
+     *
+     * Az generic AI üzeneteket OpenAI-specifikus formátumra alakítja át
+     */
+    /* private convertToOAIMessages(messages: DyFM_AI_Message[]): DyFM_AI_Message[] {
+      return messages;
+    } */
+    /**
+     * Asks the AI to answer a yes/no question
+     *
+     * Uses the {@link DyNTS_OAI_LLM_Predefined_Requests.yesNo.request} to ask the question,
+     * and the {@link DyNTS_OAI_LLM_Predefined_Requests.yesNo.upperCaseYes} to check the answer
+     */
+    async requestYesNoInConversation(set) {
+        set.message += this.predefinedRequests.yesNo.request;
+        //this.logQuestion(set);
+        const answer = await this.requestSimpleMessageInConversation(set);
+        return this.convertAnswerToBoolean(answer);
+    }
+    //askYesNoQuestionInConversation: typeof this.yesNoQuestionInConversation = this.yesNoQuestionInConversation;
+    /**
+     * Asks the AI to answer a simple question
+     *
+     * Uses the {@link DyNTS_OAI_LLM_Predefined_Requests.simpleQuestion} to ask the question
+     */
+    /* async requestSimpleQuestionInConversation(
+      set: DyFM_AI_ConversationBase_Input<DyFM_OAI_CallSettings>
+    ): Promise<string> {
+      this.logQuestion(set);
+  
+      return await this.getQuestionAnswerInConversation(set);
+    } */
+    //askSimpleQuestionInConversation: typeof this.simpleQuestionInConversation = this.simpleQuestionInConversation;
+    /**
+     * Asks the AI to answer a percentage question
+     *
+     * Uses the {@link DyNTS_OAI_LLM_Predefined_Requests.percentageOnly} to ask the question
+     */
+    async requestPercentageInConversation(set) {
+        set.message += this.predefinedRequests.percentageOnly;
+        //this.logQuestion(set);
+        const answer = await this.requestSimpleMessageInConversation(set);
+        return this.convertAnswerToNumber(answer, set.message);
+    }
+    //askPercentageQuestionInConversation: typeof this.percentageQuestionInConversation = this.percentageQuestionInConversation;
+    /**
+     * Asks the AI to select one of the options from the list
+     *
+     * Uses the {@link DyNTS_OAI_LLM_Predefined_Requests.selectRequest} to ask the question
+     */
+    async requestSelectInConversation(set) {
+        // replace the {{DyNTS_selectOptions}} with the list of options
+        const selectQuestionAddition = this.predefinedRequests.selectRequest.replace('{{DyNTS_selectOptions}}', this.getTextListAsText(this.stringifySelectOptions(set.selectFrom)));
+        set.message += selectQuestionAddition;
+        //this.logQuestion(set);
+        const answer = await this.requestSimpleMessageInConversation(set);
+        return this.convertAnswerToSelectOption(answer, set.message, set.selectFrom);
+    }
+    //askSelectQuestionInConversation: typeof this.selectQuestionInConversation = this.selectQuestionInConversation;
+    /**
+     * Asks the AI to select one of the options from the list
+     * Similar to {@link askSelectQuestion},
+     * but with a more generic approach that can be used for objects
+     *
+     * Uses the {@link DyNTS_OAI_LLM_Predefined_Requests.selectRequest} to ask the question
+     */
+    /* async requestSelectInConversation<T>(
+      set: DyFM_AI_ConversationGenericSelect_Input<T, DyFM_OAI_CallSettings>
+    ): Promise<T | { unparsableResult: string }> {
+      const selectQuestionAddition = this.predefinedRequests.selectRequest.replace(
+        '{{DyNTS_selectOptions}}',
+        this.getTextListAsText(set.selectFrom.map(item => `"${JSON.stringify(item)}"`))
+      );
+      set.message += selectQuestionAddition;
+  
+      this.logQuestion(set);
+  
+      const answer = await this.getQuestionAnswerInConversation(set);
+  
+      return DyFM_Object.safeParseJSON<T>(answer);
+    } */
+    //askRequestSelectInConversation: typeof this.requestSelectInConversation = this.requestSelectInConversation;
+    /**
+     * Asks the AI to select one or more of the options from the list
+     *
+     * Uses the {@link DyNTS_OAI_LLM_Predefined_Requests.multiselect} to ask the question
+     */
+    /* async requestMultiselectInConversation(set: DyFM_AI_ConversationMultiSelect_Input): Promise<string[]> {
+      const selectQuestionAddition = this.predefinedRequests.multiselect.replace(
+        '{{DyNTS_selectOptions}}',
+        this.getTextListAsText(set.options)
+      );
+      set.message += selectQuestionAddition;
+  
+      let answer = await this.getQuestionAnswerInConversation(set);
+      
+      answer = answer.toLocaleUpperCase();
+      
+      const result: string[] = [];
+  
+      for (const item of set.options) {
+        if (answer.includes(item.toLocaleUpperCase())) {
+          result.push(item);
+        }
+      }
+  
+      return result;
+    } */
+    //askMultipleSelectQuestionWithOptionsInConversation: typeof this.multipleSelectQuestionWithOptionsInConversation = this.multipleSelectQuestionWithOptionsInConversation;
+    /**
+     * Asks the AI to select one or more of the options from the list
+     * Similar to {@link askMultipleSelectQuestionWithOptions},
+     * but with a more generic approach that can be used for objects
+     *
+     * Uses the {@link DyNTS_OAI_LLM_Predefined_Requests.multiselect} to ask the question
+     */
+    async requestMultiselectInConversation(set) {
+        const selectQuestionAddition = this.predefinedRequests.multiselect.replace('{{DyNTS_selectOptions}}', this.getTextListAsText(this.stringifySelectOptions(set.options)));
+        set.message += selectQuestionAddition;
+        //this.logQuestion(set);
+        const answer = await this.requestSimpleMessageInConversation(set);
+        return this.convertAnswerToList(answer, set.message);
+    }
+    //askRequestMultipleSelectInConversation: typeof this.requestMultipleSelectInConversation = this.requestMultipleSelectInConversation;
+    /**
+     * Asks the AI to answer a question that must result a JSON object
+     *
+     * If the answer is not a valid JSON object, it will return { unparsableResult: answer }
+     *
+     * Uses the {@link DyNTS_OAI_LLM_Predefined_Requests.jsonRequest} to ask the question
+     *
+     * (uses {@link DyFM_safeParseJSON})
+     */
+    async requestJSONInConversation(set) {
+        set.message += this.predefinedRequests.jsonRequest;
+        //this.logQuestion(set);
+        const answer = await this.requestSimpleMessageInConversation(set);
+        return this.convertAnswerToJSON(answer, set.message);
+    }
+    //askJsonQuestionInConversation: typeof this.jsonQuestionInConversation = this.jsonQuestionInConversation;
+    /**
+     * Asks the AI to answer a question that must result a JSON object with specific key descriptions
+     *
+     * If the answer is not a valid JSON object, it will return { unparsableResult: answer }
+     *
+     * Uses the {@link DyNTS_OAI_LLM_Predefined_Requests.jsonRequestWithKeysDescription} to ask the question
+     *
+     * (uses {@link DyFM_safeParseJSON})
+     */
+    /* async requestJSONInConversationWithKeysDescription<T = any>(
+      set: DyFM_AI_ConversationJSONKeysDescription_Input<DyFM_OAI_CallSettings>
+    ): Promise<T | { unparsableResult: string }> {
+      return this.jsonQuestionWithKeysDescriptionInConversation<any>(set);
+    } */
+    /**
+     * Asks the AI to answer a question that must result a JSON object with specific key descriptions
+     *
+     * If the answer is not a valid JSON object, it will return { unparsableResult: answer }
+     *
+     * Uses the {@link DyNTS_OAI_LLM_Predefined_Requests.jsonRequestWithKeysDescription} to ask the question
+     *
+     * (uses {@link DyFM_safeParseJSON})
+     */
+    async requestJSONInConversationWithKeysDescription(set) {
+        const jsonRequestWithKeysDescription = this.predefinedRequests.jsonRequestWithKeysDescription.replace('{{DyNTS_jsonKeysDescription}}', set.keysDescription);
+        set.message += jsonRequestWithKeysDescription;
+        //this.logQuestion(set);
+        const answer = await this.requestSimpleMessageInConversation(set);
+        return this.convertAnswerToJSON(answer, set.message);
+    }
+    //askJsonQuestionWithKeysDescriptionInConversation: typeof this.jsonQuestionWithKeysDescriptionInConversation = this.jsonQuestionWithKeysDescriptionInConversation;
+    /**
+     * Asks the AI to answer a question that must result a JSON object with specific keys
+     *
+     * If the answer is not a valid JSON object, it will return { unparsableResult: answer }
+     *
+     * Uses the {@link DyNTS_OAI_LLM_Predefined_Requests.jsonRequestWithExactKeys} to ask the question
+     *
+     * (uses {@link DyFM_safeParseJSON})
+     */
+    /* async requestJSONInConversationWithExactKeys(set: DyFM_AI_ConversationJSONExactKeys_Input): Promise<object> {
+      const result = await this.jsonQuestionWithExactKeysInConversation<any>(set);
+      return typeof result === 'object' ? result : {};
+    } */
+    /**
+     * Asks the AI to answer a question that must result a JSON object with specific keys
+     *
+     * If the answer is not a valid JSON object, it will return { unparsableResult: answer }
+     *
+     * Uses the {@link DyNTS_OAI_LLM_Predefined_Requests.jsonRequestWithExactKeys} to ask the question
+     *
+     * (uses {@link DyFM_safeParseJSON})
+     */
+    async requestJSONInConversationWithExactKeys(set) {
+        const jsonRequestWithExactKeys = this.predefinedRequests.jsonRequestWithExactKeys.replace('{{DyNTS_jsonKeys}}', this.getTextListAsText(set.keys));
+        set.message += jsonRequestWithExactKeys;
+        //this.logQuestion(set);
+        const answer = await this.requestSimpleMessageInConversation(set);
+        return this.convertAnswerToJSON(answer, set.message);
+    }
+    //askJsonQuestionWithExactKeysInConversation: typeof this.jsonQuestionWithExactKeysInConversation = this.jsonQuestionWithExactKeysInConversation;
+    /**
+     * Asks the AI to answer a question that must result a list of strings
+     *
+     * If the answer is not a valid JSON list, it will return the answer as a single item in an array
+     *
+     * Uses the {@link DyNTS_OAI_LLM_Predefined_Requests.listRequest} to ask the question
+     *
+     * (uses {@link DyFM_Object.safeParseList})
+     */
+    async requestListInConversation(set) {
+        set.message += this.predefinedRequests.listRequest;
+        //this.logQuestion(set);
+        const answer = await this.requestSimpleMessageInConversation(set);
+        return this.convertAnswerToList(answer, set.message);
+    }
+    //askListQuestionInConversation: typeof this.listQuestionInConversation = this.listQuestionInConversation;
+    /**
+     * Asks the AI to answer a question
+     *
+     * Uses the {@link resolveSimpleUserMessage}
+     */
+    /* async getQuestionAnswerInConversation(
+      conversation: DyFM_AI_Message[],
+      question: string,
+      issuer: string,
+      debugLog?: boolean,
+      messageSettings: DyFM_OAI_CallSettings = this.defaultSettings
+    ): Promise<string> {
+      const answer = await this.resolveSimpleUserMessageInConversation(
+        conversation,
+        question,
+        issuer,
+        messageSettings,
+      ) as Promise<string>;
+  
+      if (debugLog) {
+        console.log(' - ', answer);
+      }
+  
+      return answer;
+    } */
+    /* async requestSimpleQuestionInConversation(set: DyFM_AI_ConversationMessage_Input): Promise<string> {
+      return await this.getAnswerInConversation({
+        ...set,
+        newMessage: set.message,
+      });
+    } */
+    /* getQuestionAnswerInConversation = this.getAnswerInConversation; */
+    //getQuestionInConversation: typeof this.getQuestionAnswerInConversation = this.getQuestionAnswerInConversation;
+    //askQuestionInConversation: typeof this.getQuestionAnswerInConversation = this.getQuestionAnswerInConversation;
+    //getConversationAnswer: typeof this.getAnswerInConversation = this.getAnswerInConversation;
+    /**
+     * Asks the AI to answer a question using the whole conversation
+     * (If you want to use only the conversation, without adding a new message,
+     * use directly the {@link resolveConversation})
+     *
+     * Uses the {@link resolveConversation}
+     */
+    async requestSimpleMessageInConversation(set) {
+        // Convert generic AI messages to OpenAI-specific format
+        //const oaiConversation: DyFM_AI_Message[] = /* this.convertToOAIMessages(set.conversation) */ set.conversation;
+        if (set.message) {
+            set.conversation.push({
+                role: ai_1.DyFM_AI_MessageRole.user,
+                content: set.message,
+            });
+        }
+        const answer = await this.resolveConversation({
+            ...set,
+            getFullResponse: false,
+        });
+        this.logAnswer(answer);
+        return answer;
+    }
+    /* async resolveConversationMessage(
+      set: {
+        conversation: DyFM_AI_Message[],
+        issuer: string,
+        settings?: DyFM_OAI_CallSettings,
+        getFullResponse?: boolean,
+        debugLog?: boolean,
+         * this is used to readably replace too long contents to eg '...' in logs
+        replaceThisInLog?: string,
+      }
+    ): Promise<string> {
+      return await this.resolveConversation(set) as string;
+    } */
+    /**
+     * Resolves a conversation
+     *
+     * Uses the {@link getMessageCreateInput}
+     */
+    async resolveConversation(set) {
+        try {
+            if (!set.conversation.some(message => message.role === ai_1.DyFM_AI_MessageRole.system)) {
+                /* throw new DyFM_Error({
+                  ...this.getDefaultErrorSettings(
+                    'resolveConversation',
+                    new Error('System message found in conversation'),
+                    set.issuer
+                  ),
+                  errorCode: `${DyNTS_global_settings.systemShortCodeName}|DyNTS-OAB-RC1`,
+                }); */
+                /* DyFM_Log.error('System message found in conversation', {
+                  conversation: set.conversation,
+                });
+              } else { */
+                set.conversation.unshift(this.getDefaultSystemMessage(set.settings));
+            }
+            // conversation shortening
+            const shortenedConversation = this.shortenConversation(set);
+            this.validateConversation(shortenedConversation);
+            //this.logQuestion(set);
+            this.logConversation({
+                ...set,
+                conversation: shortenedConversation,
+            });
+            // FR-002 — per-call cost-event timing
+            const callInput = this.getMessageCreateInput({
+                ...set,
+                conversation: shortenedConversation,
+            });
+            const start = Date.now();
+            const result = await this.openai.chat.completions.create(callInput);
+            const durationMs = Date.now() - start;
+            // FR-002 — cost-event emit (resolveConversation = 'llm-chat' flow alapból)
+            this.emitCostEvent({
+                callType: 'llm-chat',
+                provider: this.aiProvider,
+                model: String(callInput.model ?? this.defaultModel),
+                tokensUsed: {
+                    input: result.usage?.prompt_tokens ?? 0,
+                    output: result.usage?.completion_tokens ?? 0,
+                    total: result.usage?.total_tokens ?? 0,
+                },
+                durationMs: durationMs,
+                issuer: set.issuer,
+                timestamp: new Date(),
+            });
+            if (set.getFullResponse) {
+                return result;
+            }
+            return result.choices[0].message.content;
+        }
+        catch (error) {
+            throw new fsm_dynamo_1.DyFM_Error({
+                ...this.getDefaultErrorSettings('resolveConversation', error, set.issuer),
+                errorCode: `${global_settings_const_1.DyNTS_global_settings.systemShortCodeName}|DyNTS-OAB-RC0`,
+            });
+        }
+    }
+    //resolveSimpleUserMessageInConversation: typeof this.resolveConversation = this.resolveConversation;
+    shortenConversation(set) {
+        try {
+            // Step 1: Clone the conversation to avoid mutating the original
+            const clonedConversation = fsm_dynamo_1.DyFM_Object.clone(set.conversation);
+            // Step 2: Separate system messages from user/assistant messages
+            // System messages are kept and not shortened
+            const systemMessages = clonedConversation.filter((message) => message.role === ai_1.DyFM_AI_MessageRole.system);
+            // Step 3: Calculate system messages length as JSON string
+            // ⚠️ ISSUE: This measures JSON string length, not actual token count
+            // ⚠️ ISSUE: Doesn't account for message structure overhead (role, content keys, formatting)
+            const systemMessagesStringLength = JSON.stringify(systemMessages).length;
+            // Step 4: Extract only content strings from non-system messages
+            // ⚠️ ISSUE: Only measuring content strings, not full message structure
+            // ⚠️ ISSUE: OpenAI counts tokens for full message format: {"role": "...", "content": "..."}
+            const msgs = clonedConversation.filter((message) => message.role !== ai_1.DyFM_AI_MessageRole.system).map((message) => message.content);
+            // Step 5: Stringify the content array to measure total length
+            // ⚠️ ISSUE: This is character count, not token count - ratio varies (1 token ≈ 1-4 chars)
+            let stringifiedMessages = JSON.stringify(msgs);
+            // Step 6: Log initial state if debug is enabled
+            if (this._debugLog || set.debugLog) {
+                fsm_dynamo_1.DyFM_Log.info(' DyNTS_OAI_LLMChat_ServiceBase: before shortening conversation', {
+                    stringifiedMessagesLength: stringifiedMessages.length,
+                    conversationLength: clonedConversation.length,
+                    lastMessage: fsm_dynamo_1.DyFM_Array.last(clonedConversation)?.content,
+                });
+            }
+            // Step 7: Initialize tracking variables
+            let removedMessagesCount = 0;
+            let lastStringifiedMessagesLength = stringifiedMessages.length;
+            // Step 8: Loop to remove messages until under character limit
+            // ⚠️ ISSUE: Comparing character count to token limit - different units!
+            // ⚠️ ISSUE: maxMessagesStringLength (120k chars) may not safely map to 128k tokens
+            // ⚠️ ISSUE: Condition allows single very long message to remain (length > 1)
+            while ((stringifiedMessages.length + systemMessagesStringLength) > oai_global_settings_const_1.DyNTS_OAI_global_settings.maxMessagesStringLength &&
+                clonedConversation.length > 1) {
+                // Step 8a: Remove oldest message from full conversation
+                clonedConversation.splice(0, 1);
+                // Step 8b: Remove corresponding content from msgs array
+                // ⚠️ CRITICAL BUG: Always removes from msgs, even if removed message was a system message!
+                // ⚠️ This causes array desynchronization - msgs and clonedConversation get out of sync
+                msgs.splice(0, 1);
+                removedMessagesCount++;
+                // Step 8c: Recalculate stringified length after removal
+                stringifiedMessages = JSON.stringify(msgs);
+                lastStringifiedMessagesLength = stringifiedMessages.length;
+            }
+            // Step 9: Log final state if debug is enabled
+            if (this._debugLog || set.debugLog) {
+                fsm_dynamo_1.DyFM_Log.info(' DyNTS_OAI_LLMChat_ServiceBase: after shortening conversation', {
+                    removedMessagesCount: removedMessagesCount,
+                    lastStringifiedMessagesLength: lastStringifiedMessagesLength,
+                    lastMessage: fsm_dynamo_1.DyFM_Array.last(clonedConversation)?.content,
+                    localStackLocation: (0, fsm_dynamo_1.DyFM_getLocalStackLocation)(),
+                });
+            }
+            // Step 10: Safety check - ensure we didn't remove everything
+            if (!clonedConversation.length) {
+                fsm_dynamo_1.DyFM_Log.error('No conversation messages (left)', {
+                    /* conversation: DyFM_Object.clone(conversation), */
+                    conversationLength: set.conversation.length,
+                    clonedConversation: fsm_dynamo_1.DyFM_Object.clone(clonedConversation),
+                });
+                throw new Error('No conversation messages (left)');
+            }
+            // Step 11: Reconstruct conversation: system messages first, then shortened non-system messages
+            // ⚠️ ISSUE: clonedConversation may still contain system messages mixed in
+            // ⚠️ This could result in duplicate system messages in the final array
+            return [...systemMessages, ...clonedConversation];
+        }
+        catch (error) {
+            fsm_dynamo_1.DyFM_Error.logSimple('❌❌ Error shortening conversation:', error);
+            throw new fsm_dynamo_1.DyFM_Error({
+                ...this.getDefaultErrorSettings('shortenConversation', error, set.issuer),
+                errorCode: `${global_settings_const_1.DyNTS_global_settings.systemShortCodeName}|DyNTS-OAB-SC0`,
+            });
+        }
+    }
+}
+exports.DyNTS_OAI_LLMChat_ServiceBase = DyNTS_OAI_LLMChat_ServiceBase;
 //# sourceMappingURL=oai-llm-chat.service-base.js.map