@futdevpro/nts-dynamo 1.10.77 → 1.11.2

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

@@ -0,0 +1,344 @@
+"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 oai_gpt_message_role_enum_1 = require("../_enums/oai-gpt-message-role.enum");
+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 {
+    /**
+     * 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 yesNoQuestionInConversation(conversation, question, issuer, debugLog, settings, 
+    /** this is used to readably replace too long contents to eg '...' in logs */
+    replaceThisInLog) {
+        question += this.predefinedRequests.yesNo.request;
+        this.logQuestion(question, replaceThisInLog, debugLog);
+        const answer = await this.getAnswerInConversation(conversation, question, issuer, settings, debugLog, replaceThisInLog);
+        return answer.toUpperCase().includes(this.predefinedRequests.yesNo.upperCaseYes);
+    }
+    askYesNoQuestionInConversation = this.yesNoQuestionInConversation;
+    /**
+     * Asks the AI to answer a simple question
+     *
+     * Uses the {@link DyNTS_OAI_LLM_Predefined_Requests.simpleQuestion} to ask the question
+     */
+    async simpleQuestionInConversation(conversation, question, issuer, settings, debugLog, 
+    /** this is used to readably replace too long contents to eg '...' in logs */
+    replaceThisInLog) {
+        this.logQuestion(question, replaceThisInLog, debugLog);
+        return await this.getAnswerInConversation(conversation, question, issuer, settings, debugLog, replaceThisInLog);
+    }
+    askSimpleQuestionInConversation = this.simpleQuestionInConversation;
+    /**
+     * Asks the AI to answer a percentage question
+     *
+     * Uses the {@link DyNTS_OAI_LLM_Predefined_Requests.percentageOnly} to ask the question
+     */
+    async percentageQuestionInConversation(conversation, question, issuer, settings, debugLog, 
+    /** this is used to readably replace too long contents to eg '...' in logs */
+    replaceThisInLog) {
+        question += this.predefinedRequests.percentageOnly;
+        this.logQuestion(question, replaceThisInLog, debugLog);
+        const answer = await this.getAnswerInConversation(conversation, question, issuer, settings, debugLog, replaceThisInLog);
+        if (isNaN(+answer)) {
+            fsm_dynamo_1.DyFM_Log.error('GPT_ServiceBase', 'asykPercentageQuestion', 'Invalid answer', {
+                question,
+                answer,
+            });
+            return null;
+        }
+        return +answer;
+    }
+    askPercentageQuestionInConversation = 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 selectQuestionInConversation(conversation, question, selectFrom, issuer, settings, debugLog, 
+    /** this is used to readably replace too long contents to eg '...' in logs */
+    replaceThisInLog) {
+        // replace the {{DyNTS_selectOptions}} with the list of options
+        const selectQuestionAddition = this.predefinedRequests.selectRequest.replace('{{DyNTS_selectOptions}}', this.getTextListAsText(selectFrom));
+        question += selectQuestionAddition;
+        this.logQuestion(question, replaceThisInLog, debugLog);
+        let answer = await this.getAnswerInConversation(conversation, question, issuer, settings, debugLog, replaceThisInLog);
+        answer = answer.toLocaleUpperCase();
+        for (const item of selectFrom) {
+            if (answer.includes(item.toLocaleUpperCase()))
+                return item;
+        }
+        return null;
+    }
+    askSelectQuestionInConversation = 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(conversation, question, selectFrom, issuer, settings, debugLog, 
+    /** this is used to readably replace too long contents to eg '...' in logs */
+    replaceThisInLog) {
+        const selectQuestionAddition = this.predefinedRequests.selectRequest.replace('{{DyNTS_selectOptions}}', this.getTextListAsText(selectFrom.map(item => `"${JSON.stringify(item)}"`)));
+        question += selectQuestionAddition;
+        this.logQuestion(question, null, debugLog);
+        const answer = await this.getAnswerInConversation(conversation, question, issuer, settings, debugLog, replaceThisInLog);
+        return (0, oai_llm_service_base_1.DyFM_safeParseJSON)(answer);
+    }
+    askRequestSelectInConversation = 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 multipleSelectQuestionWithOptionsInConversation(conversation, question, options, issuer, settings, debugLog, 
+    /** this is used to readably replace too long contents to eg '...' in logs */
+    replaceThisInLog) {
+        const selectQuestionAddition = this.predefinedRequests.multiselect.replace('{{DyNTS_selectOptions}}', this.getTextListAsText(options));
+        question += selectQuestionAddition;
+        let answer = await this.getAnswerInConversation(conversation, question, issuer, settings, debugLog, replaceThisInLog);
+        answer = answer.toLocaleUpperCase();
+        const result = [];
+        for (const item of options) {
+            if (answer.includes(item.toLocaleUpperCase())) {
+                result.push(item);
+            }
+        }
+        return result;
+    }
+    askMultipleSelectQuestionWithOptionsInConversation = 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 requestMultipleSelectInConversation(conversation, question, options, issuer, settings, debugLog, 
+    /** this is used to readably replace too long contents to eg '...' in logs */
+    replaceThisInLog) {
+        const selectQuestionAddition = this.predefinedRequests.multiselect.replace('{{DyNTS_selectOptions}}', this.getTextListAsText(options.map(item => `"${JSON.stringify(item)}"`)));
+        question += selectQuestionAddition;
+        this.logQuestion(question, null, debugLog);
+        const answer = await this.getAnswerInConversation(conversation, question, issuer, settings, debugLog, replaceThisInLog);
+        return (0, oai_llm_service_base_1.DyFM_safeParseList)(answer);
+    }
+    askRequestMultipleSelectInConversation = 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 jsonQuestionInConversation(conversation, question, issuer, settings, debugLog, 
+    /** this is used to readably replace too long contents to eg '...' in logs */
+    replaceThisInLog) {
+        question += this.predefinedRequests.jsonRequest;
+        this.logQuestion(question, replaceThisInLog, debugLog);
+        const answer = await this.getAnswerInConversation(conversation, question, issuer, settings, debugLog, replaceThisInLog);
+        return (0, oai_llm_service_base_1.DyFM_safeParseJSON)(answer);
+    }
+    askJsonQuestionInConversation = 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 jsonQuestionWithKeysDescriptionInConversation(conversation, question, keysDescription, issuer, settings, debugLog, 
+    /** this is used to readably replace too long contents to eg '...' in logs */
+    replaceThisInLog) {
+        const jsonRequestWithKeysDescription = this.predefinedRequests.jsonRequestWithKeysDescription.replace('{{DyNTS_jsonKeysDescription}}', keysDescription);
+        question += jsonRequestWithKeysDescription;
+        this.logQuestion(question, replaceThisInLog, debugLog);
+        const answer = await this.getAnswerInConversation(conversation, question, issuer, settings, debugLog, replaceThisInLog);
+        return (0, oai_llm_service_base_1.DyFM_safeParseJSON)(answer);
+    }
+    askJsonQuestionWithKeysDescriptionInConversation = 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 jsonQuestionWithExactKeysInConversation(conversation, question, keys, issuer, settings, debugLog, 
+    /** this is used to readably replace too long contents to eg '...' in logs */
+    replaceThisInLog) {
+        const jsonRequestWithExactKeys = this.predefinedRequests.jsonRequestWithExactKeys.replace('{{DyNTS_jsonKeys}}', this.getTextListAsText(keys));
+        question += jsonRequestWithExactKeys;
+        this.logQuestion(question, replaceThisInLog, debugLog);
+        const answer = await this.getAnswerInConversation(conversation, question, issuer, settings, debugLog, replaceThisInLog);
+        return (0, oai_llm_service_base_1.DyFM_safeParseJSON)(answer);
+    }
+    askJsonQuestionWithExactKeysInConversation = 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_safeParseList})
+     */
+    async listQuestionInConversation(conversation, question, issuer, settings, debugLog, 
+    /** this is used to readably replace too long contents to eg '...' in logs */
+    replaceThisInLog) {
+        question += this.predefinedRequests.listRequest;
+        this.logQuestion(question, replaceThisInLog, debugLog);
+        const answer = await this.getAnswerInConversation(conversation, question, issuer, settings, debugLog, replaceThisInLog);
+        return (0, oai_llm_service_base_1.DyFM_safeParseList)(answer);
+    }
+    askListQuestionInConversation = this.listQuestionInConversation;
+    /**
+     * Asks the AI to answer a question
+     *
+     * Uses the {@link resolveSimpleUserMessage}
+     */
+    /* async getQuestionAnswerInConversation(
+      conversation: DyNTS_OAI_GPT_Message[],
+      question: string,
+      issuer: string,
+      debugLog?: boolean,
+      messageSettings: DyFM_GPTCall_Settings = this.defaultSettings
+    ): Promise<string> {
+      const answer = await this.resolveSimpleUserMessageInConversation(
+        conversation,
+        question,
+        issuer,
+        messageSettings,
+      ) as Promise<string>;
+  
+      if (debugLog) {
+        console.log(' - ', answer);
+      }
+  
+      return answer;
+    } */
+    /**
+     * 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 getAnswerInConversation(conversation, newMessage, issuer, settings, debugLog, 
+    /** this is used to readably replace too long contents to eg '...' in logs */
+    replaceThisInLog) {
+        conversation.push({
+            role: oai_gpt_message_role_enum_1.DyNTS_OAI_GPT_Message_Role.user,
+            content: newMessage,
+        });
+        const answer = (await this.resolveConversation(conversation, issuer, settings, false, debugLog, replaceThisInLog));
+        if (debugLog || this.debugLog) {
+            console.log(' - answer: ', answer);
+        }
+        return answer;
+    }
+    getQuestionAnswerInConversation = this.getAnswerInConversation;
+    getQuestionInConversation = this.getAnswerInConversation;
+    askQuestionInConversation = this.getAnswerInConversation;
+    /**
+     * Resolves a conversation
+     *
+     * Uses the {@link getMessageCreateInput}
+     */
+    async resolveConversation(conversation, issuer, settings, getFullResponse, debugLog, 
+    /** this is used to readably replace too long contents to eg '...' in logs */
+    replaceThisInLog) {
+        try {
+            conversation.unshift(this.getDefaultSystemMessage(settings));
+            // conversation shortening
+            const shortenedConversation = this.shortenConversation(conversation, issuer, debugLog);
+            this.logConversation(shortenedConversation, debugLog, replaceThisInLog);
+            const result = await this.openai.chat.completions.create(this.getMessageCreateInput(shortenedConversation, issuer, settings));
+            if (getFullResponse) {
+                return result;
+            }
+            return result.choices[0].message.content;
+        }
+        catch (error) {
+            throw new fsm_dynamo_1.DyFM_Error({
+                ...this.getDefaultErrorSettings('resolveConversation', error, issuer),
+                errorCode: `${global_settings_const_1.DyNTS_global_settings.systemShortCodeName}|DyNTS-OAB-RC0`,
+            });
+        }
+    }
+    resolveSimpleUserMessageInConversation = this.resolveConversation;
+    shortenConversation(conversation, issuer, debugLog) {
+        try {
+            const clonedConversation = (0, fsm_dynamo_1.DyFM_clone)(conversation);
+            const systemMessages = clonedConversation.filter(message => message.role === oai_gpt_message_role_enum_1.DyNTS_OAI_GPT_Message_Role.system);
+            const systemMessagesStringLength = JSON.stringify(systemMessages).length;
+            const msgs = clonedConversation.filter(message => message.role !== oai_gpt_message_role_enum_1.DyNTS_OAI_GPT_Message_Role.system).map(message => message.content);
+            let stringifiedMessages = JSON.stringify(msgs);
+            if (this.debugLog || debugLog) {
+                console.log('stringifiedMessagesCount before removing', stringifiedMessages.length);
+            }
+            let removedMessagesCount = 0;
+            let lastStringifiedMessagesLength = stringifiedMessages.length;
+            while ((stringifiedMessages.length + systemMessagesStringLength) > oai_global_settings_const_1.DyNTS_OAI_global_settings.maxMessagesStringLength &&
+                clonedConversation.length > 1) {
+                clonedConversation.splice(0, 1);
+                msgs.splice(0, 1);
+                removedMessagesCount++;
+                stringifiedMessages = JSON.stringify(msgs);
+                lastStringifiedMessagesLength = stringifiedMessages.length;
+            }
+            if (this.debugLog || debugLog) {
+                console.log('removedMessagesCount', removedMessagesCount);
+                console.log('lastStringifiedMessagesLength', lastStringifiedMessagesLength);
+            }
+            if (!clonedConversation.length) {
+                fsm_dynamo_1.DyFM_Log.error('No conversation messages (left)', {
+                    /* conversation: DyFM_clone(conversation), */
+                    conversationLength: conversation.length,
+                    clonedConversation: (0, fsm_dynamo_1.DyFM_clone)(clonedConversation),
+                });
+                throw new Error('No conversation messages (left)');
+            }
+            return [...systemMessages, ...clonedConversation];
+        }
+        catch (error) {
+            console.error('❌❌ Error shortening conversation:', error);
+            throw new fsm_dynamo_1.DyFM_Error({
+                ...this.getDefaultErrorSettings('shortenConversation', error, issuer),
+                errorCode: `${global_settings_const_1.DyNTS_global_settings.systemShortCodeName}|DyNTS-OAB-SC0`,
+            });
+        }
+    }
+    logConversation(conversation, debugLog, 
+    /** this is used to readably replace too long contents to eg '...' in logs */
+    replaceThisInLog) {
+        if (debugLog || this.debugLog) {
+            conversation.forEach(message => {
+                console.log(` - ${message.role}: ${message.content.replace(replaceThisInLog, this.defaultLogReplacer)}`);
+            });
+        }
+    }
+}
+exports.DyNTS_OAI_LLMChat_ServiceBase = DyNTS_OAI_LLMChat_ServiceBase;
+//# sourceMappingURL=oai-llm-chat.service-base.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"oai-llm-chat.service-base.js","sourceRoot":"","sources":["../../../../src/_modules/open-ai/_services/oai-llm-chat.service-base.ts"],"names":[],"mappings":";;;AAGA,sDAA2H;AAE3H,uFAAoF;AAIpF,mFAAiF;AAEjF,iEAA2G;AAC3G,yFAAsF;AAGtF;;;;;;GAMG;AAEH,kCAAkC;AAElC,MAAa,6BAA8B,SAAQ,gDAAyB;IAE1E;;;;;OAKG;IACH,KAAK,CAAC,2BAA2B,CAC/B,YAAqC,EACrC,QAAgB,EAChB,MAAc,EACd,QAAkB,EAClB,QAAgC;IAChC,6EAA6E;IAC7E,gBAAyB;QAEzB,QAAQ,IAAI,IAAI,CAAC,kBAAkB,CAAC,KAAK,CAAC,OAAO,CAAC;QAElD,IAAI,CAAC,WAAW,CAAC,QAAQ,EAAE,gBAAgB,EAAE,QAAQ,CAAC,CAAC;QAEvD,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,uBAAuB,CAC/C,YAAY,EACZ,QAAQ,EACR,MAAM,EACN,QAAQ,EACR,QAAQ,EACR,gBAAgB,CACjB,CAAC;QAEF,OAAO,MAAM,CAAC,WAAW,EAAE,CAAC,QAAQ,CAAC,IAAI,CAAC,kBAAkB,CAAC,KAAK,CAAC,YAAY,CAAC,CAAC;IACnF,CAAC;IACD,8BAA8B,GAAG,IAAI,CAAC,2BAA2B,CAAC;IAElE;;;;OAIG;IACH,KAAK,CAAC,4BAA4B,CAChC,YAAqC,EACrC,QAAgB,EAChB,MAAc,EACd,QAAgC,EAChC,QAAkB;IAClB,6EAA6E;IAC7E,gBAAyB;QAEzB,IAAI,CAAC,WAAW,CAAC,QAAQ,EAAE,gBAAgB,EAAE,QAAQ,CAAC,CAAC;QAEvD,OAAO,MAAM,IAAI,CAAC,uBAAuB,CACvC,YAAY,EACZ,QAAQ,EACR,MAAM,EACN,QAAQ,EACR,QAAQ,EACR,gBAAgB,CACjB,CAAC;IACJ,CAAC;IACD,+BAA+B,GAAG,IAAI,CAAC,4BAA4B,CAAC;IAEpE;;;;OAIG;IACH,KAAK,CAAC,gCAAgC,CACpC,YAAqC,EACrC,QAAgB,EAChB,MAAc,EACd,QAAgC,EAChC,QAAkB;IAClB,6EAA6E;IAC7E,gBAAyB;QAEzB,QAAQ,IAAI,IAAI,CAAC,kBAAkB,CAAC,cAAc,CAAC;QAEnD,IAAI,CAAC,WAAW,CAAC,QAAQ,EAAE,gBAAgB,EAAE,QAAQ,CAAC,CAAC;QAEvD,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,uBAAuB,CAC/C,YAAY,EACZ,QAAQ,EACR,MAAM,EACN,QAAQ,EACR,QAAQ,EACR,gBAAgB,CACjB,CAAC;QAEF,IAAI,KAAK,CAAC,CAAC,MAAM,CAAC,EAAE,CAAC;YACnB,qBAAQ,CAAC,KAAK,CAAC,iBAAiB,EAAE,wBAAwB,EAAE,gBAAgB,EAAE;gBAC5E,QAAQ;gBACR,MAAM;aACP,CAAC,CAAC;YAEH,OAAO,IAAI,CAAC;QACd,CAAC;QAED,OAAO,CAAC,MAAM,CAAC;IACjB,CAAC;IACD,mCAAmC,GAAG,IAAI,CAAC,gCAAgC,CAAC;IAG5E;;;;OAIG;IACH,KAAK,CAAC,4BAA4B,CAChC,YAAqC,EACrC,QAAgB,EAChB,UAAoB,EACpB,MAAc,EACd,QAAgC,EAChC,QAAkB;IAClB,6EAA6E;IAC7E,gBAAyB;QAEzB,+DAA+D;QAC/D,MAAM,sBAAsB,GAAG,IAAI,CAAC,kBAAkB,CAAC,aAAa,CAAC,OAAO,CAC1E,yBAAyB,EACzB,IAAI,CAAC,iBAAiB,CAAC,UAAU,CAAC,CACnC,CAAC;QACF,QAAQ,IAAI,sBAAsB,CAAC;QAEnC,IAAI,CAAC,WAAW,CAAC,QAAQ,EAAE,gBAAgB,EAAE,QAAQ,CAAC,CAAC;QAEvD,IAAI,MAAM,GAAG,MAAM,IAAI,CAAC,uBAAuB,CAC7C,YAAY,EACZ,QAAQ,EACR,MAAM,EACN,QAAQ,EACR,QAAQ,EACR,gBAAgB,CACjB,CAAC;QAEF,MAAM,GAAG,MAAM,CAAC,iBAAiB,EAAE,CAAC;QAEpC,KAAK,MAAM,IAAI,IAAI,UAAU,EAAE,CAAC;YAC9B,IAAI,MAAM,CAAC,QAAQ,CAAC,IAAI,CAAC,iBAAiB,EAAE,CAAC;gBAAE,OAAO,IAAI,CAAC;QAC7D,CAAC;QAED,OAAO,IAAI,CAAC;IACd,CAAC;IACD,+BAA+B,GAAG,IAAI,CAAC,4BAA4B,CAAC;IAEpE;;;;;;OAMG;IACH,KAAK,CAAC,2BAA2B,CAC/B,YAAqC,EACrC,QAAgB,EAChB,UAAe,EACf,MAAc,EACd,QAAgC,EAChC,QAAkB;IAClB,6EAA6E;IAC7E,gBAAyB;QAEzB,MAAM,sBAAsB,GAAG,IAAI,CAAC,kBAAkB,CAAC,aAAa,CAAC,OAAO,CAC1E,yBAAyB,EACzB,IAAI,CAAC,iBAAiB,CAAC,UAAU,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC,IAAI,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAC5E,CAAC;QACF,QAAQ,IAAI,sBAAsB,CAAC;QAEnC,IAAI,CAAC,WAAW,CAAC,QAAQ,EAAE,IAAI,EAAE,QAAQ,CAAC,CAAC;QAE3C,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,uBAAuB,CAC/C,YAAY,EACZ,QAAQ,EACR,MAAM,EACN,QAAQ,EACR,QAAQ,EACR,gBAAgB,CACjB,CAAC;QAEF,OAAO,IAAA,yCAAkB,EAAI,MAAM,CAAC,CAAC;IACvC,CAAC;IACD,8BAA8B,GAAG,IAAI,CAAC,2BAA2B,CAAC;IAElE;;;;OAIG;IACH,KAAK,CAAC,+CAA+C,CACnD,YAAqC,EACrC,QAAgB,EAChB,OAAiB,EACjB,MAAc,EACd,QAAgC,EAChC,QAAkB;IAClB,6EAA6E;IAC7E,gBAAyB;QAEzB,MAAM,sBAAsB,GAAG,IAAI,CAAC,kBAAkB,CAAC,WAAW,CAAC,OAAO,CACxE,yBAAyB,EACzB,IAAI,CAAC,iBAAiB,CAAC,OAAO,CAAC,CAChC,CAAC;QACF,QAAQ,IAAI,sBAAsB,CAAC;QAEnC,IAAI,MAAM,GAAG,MAAM,IAAI,CAAC,uBAAuB,CAC7C,YAAY,EACZ,QAAQ,EACR,MAAM,EACN,QAAQ,EACR,QAAQ,EACR,gBAAgB,CACjB,CAAC;QAEF,MAAM,GAAG,MAAM,CAAC,iBAAiB,EAAE,CAAC;QAEpC,MAAM,MAAM,GAAa,EAAE,CAAC;QAE5B,KAAK,MAAM,IAAI,IAAI,OAAO,EAAE,CAAC;YAC3B,IAAI,MAAM,CAAC,QAAQ,CAAC,IAAI,CAAC,iBAAiB,EAAE,CAAC,EAAE,CAAC;gBAC9C,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;YACpB,CAAC;QACH,CAAC;QAED,OAAO,MAAM,CAAC;IAChB,CAAC;IACD,kDAAkD,GAAG,IAAI,CAAC,+CAA+C,CAAC;IAE1G;;;;;;OAMG;IACH,KAAK,CAAC,mCAAmC,CACvC,YAAqC,EACrC,QAAgB,EAChB,OAAY,EACZ,MAAc,EACd,QAAgC,EAChC,QAAkB;IAClB,6EAA6E;IAC7E,gBAAyB;QAEzB,MAAM,sBAAsB,GAAG,IAAI,CAAC,kBAAkB,CAAC,WAAW,CAAC,OAAO,CACxE,yBAAyB,EACzB,IAAI,CAAC,iBAAiB,CAAC,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC,IAAI,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CACzE,CAAC;QACF,QAAQ,IAAI,sBAAsB,CAAC;QAEnC,IAAI,CAAC,WAAW,CAAC,QAAQ,EAAE,IAAI,EAAE,QAAQ,CAAC,CAAC;QAE3C,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,uBAAuB,CAC/C,YAAY,EACZ,QAAQ,EACR,MAAM,EACN,QAAQ,EACR,QAAQ,EACR,gBAAgB,CACjB,CAAC;QAEF,OAAO,IAAA,yCAAkB,EAAM,MAAM,CAAC,CAAC;IACzC,CAAC;IACD,sCAAsC,GAAG,IAAI,CAAC,mCAAmC,CAAC;IAElF;;;;;;;;OAQG;IACH,KAAK,CAAC,0BAA0B,CAC9B,YAAqC,EACrC,QAAgB,EAChB,MAAc,EACd,QAAgC,EAChC,QAAkB;IAClB,6EAA6E;IAC7E,gBAAyB;QAEzB,QAAQ,IAAI,IAAI,CAAC,kBAAkB,CAAC,WAAW,CAAC;QAEhD,IAAI,CAAC,WAAW,CAAC,QAAQ,EAAE,gBAAgB,EAAE,QAAQ,CAAC,CAAC;QAEvD,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,uBAAuB,CAC/C,YAAY,EACZ,QAAQ,EACR,MAAM,EACN,QAAQ,EACR,QAAQ,EACR,gBAAgB,CACjB,CAAC;QAEF,OAAO,IAAA,yCAAkB,EAAI,MAAM,CAAC,CAAC;IACvC,CAAC;IACD,6BAA6B,GAAG,IAAI,CAAC,0BAA0B,CAAC;IAEhE;;;;;;;;OAQG;IACH,KAAK,CAAC,6CAA6C,CACjD,YAAqC,EACrC,QAAgB,EAChB,eAAuB,EACvB,MAAc,EACd,QAAgC,EAChC,QAAkB;IAClB,6EAA6E;IAC7E,gBAAyB;QAEzB,MAAM,8BAA8B,GAAG,IAAI,CAAC,kBAAkB,CAAC,8BAA8B,CAAC,OAAO,CACnG,+BAA+B,EAC/B,eAAe,CAChB,CAAC;QACF,QAAQ,IAAI,8BAA8B,CAAC;QAE3C,IAAI,CAAC,WAAW,CAAC,QAAQ,EAAE,gBAAgB,EAAE,QAAQ,CAAC,CAAC;QAEvD,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,uBAAuB,CAC/C,YAAY,EACZ,QAAQ,EACR,MAAM,EACN,QAAQ,EACR,QAAQ,EACR,gBAAgB,CACjB,CAAC;QAEF,OAAO,IAAA,yCAAkB,EAAI,MAAM,CAAC,CAAC;IACvC,CAAC;IACD,gDAAgD,GAAG,IAAI,CAAC,6CAA6C,CAAC;IAEtG;;;;;;;;OAQG;IACH,KAAK,CAAC,uCAAuC,CAC3C,YAAqC,EACrC,QAAgB,EAChB,IAAc,EACd,MAAc,EACd,QAAgC,EAChC,QAAkB;IAClB,6EAA6E;IAC7E,gBAAyB;QAEzB,MAAM,wBAAwB,GAAG,IAAI,CAAC,kBAAkB,CAAC,wBAAwB,CAAC,OAAO,CACvF,oBAAoB,EACpB,IAAI,CAAC,iBAAiB,CAAC,IAAI,CAAC,CAC7B,CAAC;QACF,QAAQ,IAAI,wBAAwB,CAAC;QAErC,IAAI,CAAC,WAAW,CAAC,QAAQ,EAAE,gBAAgB,EAAE,QAAQ,CAAC,CAAC;QAEvD,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,uBAAuB,CAC/C,YAAY,EACZ,QAAQ,EACR,MAAM,EACN,QAAQ,EACR,QAAQ,EACR,gBAAgB,CACjB,CAAC;QAEF,OAAO,IAAA,yCAAkB,EAAI,MAAM,CAAC,CAAC;IACvC,CAAC;IACD,0CAA0C,GAAG,IAAI,CAAC,uCAAuC,CAAC;IAE1F;;;;;;;;OAQG;IACH,KAAK,CAAC,0BAA0B,CAC9B,YAAqC,EACrC,QAAgB,EAChB,MAAc,EACd,QAAgC,EAChC,QAAkB;IAClB,6EAA6E;IAC7E,gBAAyB;QAEzB,QAAQ,IAAI,IAAI,CAAC,kBAAkB,CAAC,WAAW,CAAC;QAEhD,IAAI,CAAC,WAAW,CAAC,QAAQ,EAAE,gBAAgB,EAAE,QAAQ,CAAC,CAAC;QAEvD,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,uBAAuB,CAC/C,YAAY,EACZ,QAAQ,EACR,MAAM,EACN,QAAQ,EACR,QAAQ,EACR,gBAAgB,CACjB,CAAC;QAEF,OAAO,IAAA,yCAAkB,EAAC,MAAM,CAAC,CAAC;IACpC,CAAC;IACD,6BAA6B,GAAG,IAAI,CAAC,0BAA0B,CAAC;IAEhE;;;;OAIG;IACH;;;;;;;;;;;;;;;;;;;QAmBI;IAEJ;;;;;;OAMG;IACH,KAAK,CAAC,uBAAuB,CAC3B,YAAqC,EACrC,UAAkB,EAClB,MAAc,EACd,QAAgC,EAChC,QAAkB;IAClB,6EAA6E;IAC7E,gBAAyB;QAEzB,YAAY,CAAC,IAAI,CAAC;YAChB,IAAI,EAAE,sDAA0B,CAAC,IAAI;YACrC,OAAO,EAAE,UAAU;SACpB,CAAC,CAAC;QAEH,MAAM,MAAM,GAAW,CAAC,MAAM,IAAI,CAAC,mBAAmB,CACpD,YAAY,EACZ,MAAM,EACN,QAAQ,EACR,KAAK,EACL,QAAQ,EACR,gBAAgB,CACjB,CAAW,CAAC;QAEb,IAAI,QAAQ,IAAI,IAAI,CAAC,QAAQ,EAAE,CAAC;YAC9B,OAAO,CAAC,GAAG,CAAC,aAAa,EAAE,MAAM,CAAC,CAAC;QACrC,CAAC;QAED,OAAO,MAAM,CAAC;IAChB,CAAC;IACD,+BAA+B,GAAG,IAAI,CAAC,uBAAuB,CAAC;IAC/D,yBAAyB,GAAG,IAAI,CAAC,uBAAuB,CAAC;IACzD,yBAAyB,GAAG,IAAI,CAAC,uBAAuB,CAAC;IAEzD;;;;OAIG;IACH,KAAK,CAAC,mBAAmB,CACvB,YAAqC,EACrC,MAAc,EACd,QAAgC,EAChC,eAAyB,EACzB,QAAkB;IAClB,6EAA6E;IAC7E,gBAAyB;QAEzB,IAAI,CAAC;YACH,YAAY,CAAC,OAAO,CAAC,IAAI,CAAC,uBAAuB,CAAC,QAAQ,CAAC,CAAC,CAAC;YAE7D,0BAA0B;YAC1B,MAAM,qBAAqB,GAAG,IAAI,CAAC,mBAAmB,CAAC,YAAY,EAAE,MAAM,EAAE,QAAQ,CAAC,CAAC;YAEvF,IAAI,CAAC,eAAe,CAAC,qBAAqB,EAAE,QAAQ,EAAE,gBAAgB,CAAC,CAAC;YAExE,MAAM,MAAM,GAAmB,MAAM,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,WAAW,CAAC,MAAM,CACtE,IAAI,CAAC,qBAAqB,CAAC,qBAAqB,EAAE,MAAM,EAAE,QAAQ,CAAC,CAClD,CAAC;YAEpB,IAAI,eAAe,EAAE,CAAC;gBACpB,OAAO,MAAM,CAAC;YAChB,CAAC;YAED,OAAO,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,OAAO,CAAC;QAC3C,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,MAAM,IAAI,uBAAU,CAAC;gBACnB,GAAG,IAAI,CAAC,uBAAuB,CAAC,qBAAqB,EAAE,KAAK,EAAE,MAAM,CAAC;gBAErE,SAAS,EAAE,GAAG,6CAAqB,CAAC,mBAAmB,gBAAgB;aACxE,CAAC,CAAC;QACL,CAAC;IACH,CAAC;IACD,sCAAsC,GAAG,IAAI,CAAC,mBAAmB,CAAC;IAExD,mBAAmB,CAC3B,YAAqC,EACrC,MAAc,EACd,QAAkB;QAElB,IAAI,CAAC;YACH,MAAM,kBAAkB,GAAG,IAAA,uBAAU,EAAC,YAAY,CAAC,CAAC;YACpD,MAAM,cAAc,GAAG,kBAAkB,CAAC,MAAM,CAC9C,OAAO,CAAC,EAAE,CAAC,OAAO,CAAC,IAAI,KAAK,sDAA0B,CAAC,MAAM,CAC9D,CAAC;YACF,MAAM,0BAA0B,GAAG,IAAI,CAAC,SAAS,CAAC,cAAc,CAAC,CAAC,MAAM,CAAC;YACzE,MAAM,IAAI,GAAa,kBAAkB,CAAC,MAAM,CAC9C,OAAO,CAAC,EAAE,CAAC,OAAO,CAAC,IAAI,KAAK,sDAA0B,CAAC,MAAM,CAC9D,CAAC,GAAG,CAAC,OAAO,CAAC,EAAE,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC;YAClC,IAAI,mBAAmB,GAAG,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC;YAE/C,IAAI,IAAI,CAAC,QAAQ,IAAI,QAAQ,EAAE,CAAC;gBAC9B,OAAO,CAAC,GAAG,CAAC,0CAA0C,EAAE,mBAAmB,CAAC,MAAM,CAAC,CAAC;YACtF,CAAC;YAED,IAAI,oBAAoB,GAAG,CAAC,CAAC;YAC7B,IAAI,6BAA6B,GAAG,mBAAmB,CAAC,MAAM,CAAC;YAE/D,OACE,CAAC,mBAAmB,CAAC,MAAM,GAAG,0BAA0B,CAAC,GAAG,qDAAyB,CAAC,uBAAuB;gBAC7G,kBAAkB,CAAC,MAAM,GAAG,CAAC,EAC7B,CAAC;gBACD,kBAAkB,CAAC,MAAM,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;gBAChC,IAAI,CAAC,MAAM,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;gBAClB,oBAAoB,EAAE,CAAC;gBACvB,mBAAmB,GAAG,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC;gBAC3C,6BAA6B,GAAG,mBAAmB,CAAC,MAAM,CAAC;YAC7D,CAAC;YAED,IAAI,IAAI,CAAC,QAAQ,IAAI,QAAQ,EAAE,CAAC;gBAC9B,OAAO,CAAC,GAAG,CAAC,sBAAsB,EAAE,oBAAoB,CAAC,CAAC;gBAC1D,OAAO,CAAC,GAAG,CAAC,+BAA+B,EAAE,6BAA6B,CAAC,CAAC;YAC9E,CAAC;YAED,IAAI,CAAC,kBAAkB,CAAC,MAAM,EAAE,CAAC;gBAC/B,qBAAQ,CAAC,KAAK,CAAC,iCAAiC,EAAE;oBAChD,6CAA6C;oBAC7C,kBAAkB,EAAE,YAAY,CAAC,MAAM;oBACvC,kBAAkB,EAAE,IAAA,uBAAU,EAAC,kBAAkB,CAAC;iBACnD,CAAC,CAAC;gBACH,MAAM,IAAI,KAAK,CAAC,iCAAiC,CAAC,CAAC;YACrD,CAAC;YAED,OAAO,CAAE,GAAG,cAAc,EAAE,GAAG,kBAAkB,CAAE,CAAC;QACtD,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,OAAO,CAAC,KAAK,CAAC,mCAAmC,EAAE,KAAK,CAAC,CAAC;YAC1D,MAAM,IAAI,uBAAU,CAAC;gBACnB,GAAG,IAAI,CAAC,uBAAuB,CAAC,qBAAqB,EAAE,KAAK,EAAE,MAAM,CAAC;gBAErE,SAAS,EAAE,GAAG,6CAAqB,CAAC,mBAAmB,gBAAgB;aACxE,CAAC,CAAC;QACL,CAAC;IACH,CAAC;IAES,eAAe,CACvB,YAAqC,EACrC,QAAkB;IAClB,6EAA6E;IAC7E,gBAAyB;QAEzB,IAAI,QAAQ,IAAI,IAAI,CAAC,QAAQ,EAAE,CAAC;YAC9B,YAAY,CAAC,OAAO,CAAC,OAAO,CAAC,EAAE;gBAC7B,OAAO,CAAC,GAAG,CACT,MAAM,OAAO,CAAC,IAAI,KAAK,OAAO,CAAC,OAAO,CAAC,OAAO,CAAC,gBAAgB,EAAE,IAAI,CAAC,kBAAkB,CAAC,EAAE,CAC5F,CAAC;YACJ,CAAC,CAAC,CAAC;QACL,CAAC;IACH,CAAC;CACF;AAnlBD,sEAmlBC"}

package/build/_modules/open-ai/_services/oai-llm.service-base.d.ts

@@ -0,0 +1,234 @@
+import { OpenAI } from 'openai';
+import { DyFM_OpenAI_Settings, DyFM_OpenAIModel, DyFM_GPTCall_Settings } from '@futdevpro/fsm-dynamo/open-ai';
+import { DyFM_AnyError, DyFM_Error_Settings } from '@futdevpro/fsm-dynamo';
+import { DyNTS_OAI_GPT_Message } from '../_models/interfaces/oai-gpt-message.interface';
+import { ChatCompletion } from 'openai/resources';
+import { ChatCompletionCreateParamsBase } from 'openai/resources/chat/completions';
+import { DyNTS_OAI_LLM_Predefined_Requests } from '../_models/interfaces/oai-llm-predefined-requests.interface';
+/**
+ * {
+ *   organization: 'org-XY',
+ *   apiKey: 'sk-XY',
+ *   project: 'proj_XY',
+ * }
+ */
+export declare class DyNTS_OAI_LLM_ServiceBase {
+    readonly defaultErrorUserMsg: string;
+    readonly openai: OpenAI;
+    readonly defaultSettings: DyFM_GPTCall_Settings;
+    get debugLog(): boolean;
+    get defaultSystemPrompt(): string;
+    get defaultModel(): DyFM_OpenAIModel | string;
+    predefinedRequests: DyNTS_OAI_LLM_Predefined_Requests;
+    constructor(set?: DyFM_OpenAI_Settings);
+    readonly defaultLogReplacer: string;
+    /**
+     * 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
+     */
+    askYesNoQuestion(question: string, issuer: string, settings?: DyFM_GPTCall_Settings, debugLog?: boolean, 
+    /** this is used to readably replace too long contents to eg '...' in logs */
+    replaceThisInLog?: string): Promise<boolean>;
+    /** the exact same as {@link askYesNoQuestion} */
+    yesNoQuestion: (question: string, issuer: string, settings?: DyFM_GPTCall_Settings, debugLog?: boolean, replaceThisInLog?: string) => Promise<boolean>;
+    /**
+     * Asks the AI to answer a percentage question
+     *
+     * Uses the {@link DyNTS_OAI_LLM_Predefined_Requests.percentageOnly} to ask the question
+     */
+    askPercentageQuestion(question: string, issuer: string, settings?: DyFM_GPTCall_Settings, debugLog?: boolean, 
+    /** this is used to readably replace too long contents to eg '...' in logs */
+    replaceThisInLog?: string): Promise<number>;
+    /** the exact same as {@link askPercentageQuestion} */
+    percentageQuestion: (question: string, issuer: string, settings?: DyFM_GPTCall_Settings, debugLog?: boolean, replaceThisInLog?: string) => Promise<number>;
+    /**
+     * 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
+     */
+    askSelectQuestion(question: string, selectFrom: string[], issuer: string, settings?: DyFM_GPTCall_Settings, debugLog?: boolean, 
+    /** this is used to readably replace too long contents to eg '...' in logs */
+    replaceThisInLog?: string): Promise<string>;
+    /** the exact same as {@link askSelectQuestion} */
+    selectQuestion: (question: string, selectFrom: string[], issuer: string, settings?: DyFM_GPTCall_Settings, debugLog?: boolean, replaceThisInLog?: string) => Promise<string>;
+    /**
+     * 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
+     */
+    requestSelect<T>(question: string, selectFrom: T[], issuer: string, settings?: DyFM_GPTCall_Settings, debugLog?: boolean, 
+    /** this is used to readably replace too long contents to eg '...' in logs */
+    replaceThisInLog?: string): Promise<T | {
+        unparsableResult: string;
+    }>;
+    /** the exact same as {@link requestSelect} */
+    selectRequest: <T>(question: string, selectFrom: T[], issuer: string, settings?: DyFM_GPTCall_Settings, debugLog?: boolean, replaceThisInLog?: string) => Promise<T | {
+        unparsableResult: string;
+    }>;
+    /**
+     * 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
+     */
+    askMultipleSelectQuestionWithOptions(question: string, options: string[], issuer: string, settings?: DyFM_GPTCall_Settings, debugLog?: boolean, 
+    /** this is used to readably replace too long contents to eg '...' in logs */
+    replaceThisInLog?: string): Promise<string[]>;
+    /** the exact same as {@link askMultipleSelectQuestionWithOptions} */
+    multipleSelectQuestion: (question: string, options: string[], issuer: string, settings?: DyFM_GPTCall_Settings, debugLog?: boolean, replaceThisInLog?: string) => Promise<string[]>;
+    /**
+     * 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
+     */
+    requestMultipleSelect<T>(question: string, options: T[], issuer: string, settings?: DyFM_GPTCall_Settings, debugLog?: boolean, 
+    /** this is used to readably replace too long contents to eg '...' in logs */
+    replaceThisInLog?: string): Promise<T[]>;
+    /** the exact same as {@link requestMultipleSelect} */
+    multipleSelectRequest: <T>(question: string, options: T[], issuer: string, settings?: DyFM_GPTCall_Settings, debugLog?: boolean, replaceThisInLog?: string) => Promise<T[]>;
+    /**
+     * 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})
+     */
+    askJSONQuestion<T = any>(question: string, issuer: string, settings?: DyFM_GPTCall_Settings, debugLog?: boolean, 
+    /** this is used to readably replace too long contents to eg '...' in logs */
+    replaceThisInLog?: string): Promise<T | {
+        unparsableResult: string;
+    }>;
+    /** the exact same as {@link askJSONQuestion} */
+    jsonQuestion: <T = any>(question: string, issuer: string, settings?: DyFM_GPTCall_Settings, debugLog?: boolean, replaceThisInLog?: string) => Promise<T | {
+        unparsableResult: string;
+    }>;
+    /**
+     * 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})
+     */
+    askJSONQuestionWithKeysDescription<T = any>(question: string, keysDescription: string, issuer: string, settings?: DyFM_GPTCall_Settings, debugLog?: boolean, 
+    /** this is used to readably replace too long contents to eg '...' in logs */
+    replaceThisInLog?: string): Promise<T | {
+        unparsableResult: string;
+    }>;
+    /** the exact same as {@link askJSONQuestionWithKeysDescription} */
+    jsonQuestionWithKeysDescription: <T = any>(question: string, keysDescription: string, issuer: string, settings?: DyFM_GPTCall_Settings, debugLog?: boolean, replaceThisInLog?: string) => Promise<T | {
+        unparsableResult: string;
+    }>;
+    /**
+     * 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})
+     */
+    askJSONQuestionWithExactKeys<T = any>(question: string, keys: string[], issuer: string, settings?: DyFM_GPTCall_Settings, debugLog?: boolean, 
+    /** this is used to readably replace too long contents to eg '...' in logs */
+    replaceThisInLog?: string): Promise<T | {
+        unparsableResult: string;
+    }>;
+    /** the exact same as {@link askJSONQuestionWithExactKeys} */
+    jsonQuestionWithExactKeys: <T = any>(question: string, keys: string[], issuer: string, settings?: DyFM_GPTCall_Settings, debugLog?: boolean, replaceThisInLog?: string) => Promise<T | {
+        unparsableResult: string;
+    }>;
+    /**
+     * 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_safeParseList})
+     */
+    askListQuestion(question: string, issuer: string, settings?: DyFM_GPTCall_Settings, debugLog?: boolean, 
+    /** this is used to readably replace too long contents to eg '...' in logs */
+    replaceThisInLog?: string): Promise<string[]>;
+    /** the exact same as {@link askListQuestion} */
+    listQuestion: (question: string, issuer: string, settings?: DyFM_GPTCall_Settings, debugLog?: boolean, replaceThisInLog?: string) => Promise<string[]>;
+    /** the exact same as {@link askListQuestion} */
+    listRequest: (question: string, issuer: string, settings?: DyFM_GPTCall_Settings, debugLog?: boolean, replaceThisInLog?: string) => Promise<string[]>;
+    /**
+     * Asks the AI to answer a question
+     *
+     * Uses the {@link resolveSimpleUserMessage}
+     */
+    askQuestion(question: string, issuer: string, settings?: DyFM_GPTCall_Settings, debugLog?: boolean, 
+    /** this is used to readably replace too long contents to eg '...' in logs */
+    replaceThisInLog?: string): Promise<string>;
+    /** the exact same as {@link askQuestion} */
+    answer: (question: string, issuer: string, settings?: DyFM_GPTCall_Settings, debugLog?: boolean, replaceThisInLog?: string) => Promise<string>;
+    /** the exact same as {@link askQuestion} */
+    getQuestionAnswer: (question: string, issuer: string, settings?: DyFM_GPTCall_Settings, debugLog?: boolean, replaceThisInLog?: string) => Promise<string>;
+    /** the exact same as {@link askQuestion} */
+    simpleQuestion: (question: string, issuer: string, settings?: DyFM_GPTCall_Settings, debugLog?: boolean, replaceThisInLog?: string) => Promise<string>;
+    /** the exact same as {@link askQuestion} */
+    askSimpleQuestion: (question: string, issuer: string, settings?: DyFM_GPTCall_Settings, debugLog?: boolean, replaceThisInLog?: string) => Promise<string>;
+    /**
+     * Resolves a simple user message and returns the answer as string
+     *
+     * Uses the {@link resolveMessage}
+     */
+    resolveSimpleUserMessage(message: string, issuer: string, settings?: DyFM_GPTCall_Settings): Promise<string>;
+    /** the exact same as {@link resolveSimpleUserMessage} */
+    simpleUserMessage: (message: string, issuer: string, settings?: DyFM_GPTCall_Settings) => Promise<string>;
+    /**
+     * Resolves a conversation
+     *
+     * Uses the {@link getMessageCreateInput}
+     */
+    resolveMessage(conversation: DyNTS_OAI_GPT_Message[], issuer: string, settings?: DyFM_GPTCall_Settings, getFullResponse?: boolean): Promise<string | ChatCompletion>;
+    /**
+     * Logs the question if the debugLog is true
+     */
+    protected logQuestion(question: string, replaceThisInLog?: string, debugLog?: boolean): void;
+    /**
+     * olvasható mondatszerű-listaszerű formába teszi a listaelemeket
+     * pl.: ['a', 'b', 'c'] -> '"a", "b" or "c"'
+     */
+    getTextListAsText(list: string[]): string;
+    /**
+     * Creates a message create input
+     *
+     * Uses the {@link getDefaultSystemMessage}
+     */
+    protected getMessageCreateInput(messages: DyNTS_OAI_GPT_Message[], issuer: string, settings?: DyFM_GPTCall_Settings): ChatCompletionCreateParamsBase;
+    protected getDefaultSystemMessage(settings: DyFM_GPTCall_Settings): DyNTS_OAI_GPT_Message;
+    protected getDefaultErrorSettings(fnName: string, error: DyFM_AnyError, issuer: string): DyFM_Error_Settings;
+}
+/**
+ * parses the JSON list, if it fails, it returns the answer as a single item in an array
+ *
+ * (uses {@link DyFM_safeParseJSON})
+ * @deprecated use {@link DyFM_Shared.safeParseList} instead
+ */
+export declare function DyFM_safeParseList<T extends Array<any>>(textedJSON: string, disableErrorLog?: boolean): T;
+/**
+ * parses the JSON, if it fails, it returns { unparsableResult: textedJSON }
+ *
+ * (uses {@link DyFM_failableSafeParseJSON})
+ * @deprecated use {@link DyFM_Shared.safeParseJSON} instead
+ */
+export declare function DyFM_safeParseJSON<T = any>(textedJSON: string, disableErrorLog?: boolean): T | {
+    unparsableResult: string;
+};
+/**
+ * parses the JSON, if it fails, it throws an error
+ * (also will extract the JSON from "```json ... ```" wrapper)
+ * @deprecated use {@link DyFM_Shared.failableSafeParseJSON} instead
+ */
+export declare function DyFM_failableSafeParseJSON<T = any>(textedJSON: string): T;
+//# sourceMappingURL=oai-llm.service-base.d.ts.map

package/build/_modules/open-ai/_services/oai-llm.service-base.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"oai-llm.service-base.d.ts","sourceRoot":"","sources":["../../../../src/_modules/open-ai/_services/oai-llm.service-base.ts"],"names":[],"mappings":"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"}