@futdevpro/nts-dynamo 1.15.156 → 1.15.157

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

@@ -1,379 +1,379 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.DyNTS_AI_LLM_ServiceBase = void 0;
-const ai_provider_service_base_1 = require("./ai-provider.service-base");
-const ai_1 = require("@futdevpro/fsm-dynamo/ai");
-const fsm_dynamo_1 = require("@futdevpro/fsm-dynamo");
-/**
- * Abstract base class for LLM services
- * Defines all methods that must be implemented by AI providers
- */
-class DyNTS_AI_LLM_ServiceBase extends ai_provider_service_base_1.DyNTS_AI_Provider_ServiceBase {
-    _debugLog = false;
-    get debugLog() {
-        return this.defaultSettings?.debugLog ?? this._debugLog;
-    }
-    get defaultSystemPrompt() {
-        return this.defaultSettings.systemPrompt;
-    }
-    get defaultModel() {
-        return this.defaultSettings.useModel;
-    }
-    defaultLogReplacer = '...long-context...';
-    //////////////////////////////////////////////////////////////////////////////////////////
-    // FUNCTION CALLING (TOOL USE) — FR-047 //
-    //////////////////////////////////////////////////////////////////////////////////////////
-    // Provider-agnostic agent-loop. The loop logic lives here ONCE (ported from the legacy
-    // FDPNTS_GPT_ControlService.getAnswerWithTools); each provider only overrides
-    // `callModelWithTools` (one provider turn) and `getModelRegistry` (capability honesty).
-    // Tools are a REQUEST parameter (not on settings), per the FR-047 design.
-    /**
-     * A provider tool-kepes modell-registry-je (override providerenkent — pl. DyFM_OAI_Models).
-     * Ures default → a modell tool-kepessege ismeretlen → a precheck elutasitja (honesty).
-     */
-    getModelRegistry() {
-        return [];
-    }
-    /**
-     * Ellenorzi, hogy a feloldott modell tamogatja-e a function calling-ot; ha nem, beszedes
-     * hibaval elhasal MIELOTT barmilyen API-hivas tortenne (kritikus pl. a Local providernel).
-     */
-    assertToolsSupported(modelId) {
-        if (!ai_1.DyFM_AI_ModelRegistry_Util.modelSupportsTools(this.getModelRegistry(), modelId)) {
-            throw new fsm_dynamo_1.DyFM_Error({
-                message: `Model '${modelId}' does not support function calling (provider: ${this.aiProvider})`,
-                userMessage: `The selected AI model does not support tools.`,
-                errorCode: 'DyNTS-AILSB-TLC0',
-            });
-        }
-    }
-    //////////////////////////////////////////////////////////////////////////////////////////
-    // PER-MODEL SETTINGS RECONCILER — FR-048 //
-    //////////////////////////////////////////////////////////////////////////////////////////
-    /**
-     * FR-048 reconciler — a resolved modell `settingsSchema`-ja szerint egyezteti a call-settings-et a
-     * tenyleges provider-hivas ELOTT: DROPolja az `unsupported` kulcsokat (debug-log, SOHA nem csendben),
-     * CLAMP-eli a `constraints` (min/max) szerint. Ismeretlen modell / schema-mentes registry-bejegyzes →
-     * permisszi­v passthrough + log (best-effort, honesty).
-     *
-     * Ezzel altalanosul a FR-047 Phase-4 lokalis param-drop (Anthropic Opus 4.7+ temperature/topP/topK) es a
-     * FR-047 `isReasoningModel` sampling-drop: a tudas mostantol a registry `settingsSchema`-jaban (SSoT) el,
-     * nem provider-translator-onkent duplikalva.
-     *
-     * NON-BREAKING: ha a registry ures vagy a modellnek nincs schemaja, a bemenet valtozatlanul ter vissza —
-     * igy a meglevo providerek viselkedese nem valtozik, amig a schema nincs feltoltve.
-     * @param modelId - a feloldott modell azonositoja
-     * @param settings - a hivas-settings (opcionalis)
-     */
-    reconcileCallSettings(modelId, settings) {
-        if (!settings) {
-            return settings;
-        }
-        const modelInfo = ai_1.DyFM_AI_ModelRegistry_Util.findModelInfo(this.getModelRegistry(), modelId);
-        const schema = modelInfo?.settingsSchema;
-        if (!schema) {
-            if (this.debugLog) {
-                fsm_dynamo_1.DyFM_Log.info(`[FR-048] no settingsSchema for '${modelId}' — passthrough (best-effort)`);
-            }
-            return settings;
-        }
-        const reconciled = { ...settings };
-        // A generikus `T_AISettings` csak OLVASASRA indexelheto (TS2862), ezert a mutaciot egy nem-generikus
-        // aliason vegezzuk — UGYANARRA az objektumra mutat, igy cast nelkul is tipus-helyes marad.
-        const mutable = reconciled;
-        for (const key of schema.unsupported ?? []) {
-            if (mutable[key] !== undefined) {
-                if (this.debugLog) {
-                    fsm_dynamo_1.DyFM_Log.info(`[FR-048] drop unsupported '${key}' for model '${modelId}'`);
-                }
-                delete mutable[key];
-            }
-        }
-        const constraints = schema.constraints ?? {};
-        for (const key of Object.keys(constraints)) {
-            const constraint = constraints[key];
-            const value = mutable[key];
-            if (typeof value !== 'number') {
-                continue;
-            }
-            let next = value;
-            if (typeof constraint.min === 'number' && next < constraint.min) {
-                next = constraint.min;
-            }
-            if (typeof constraint.max === 'number' && next > constraint.max) {
-                next = constraint.max;
-            }
-            if (next !== value) {
-                if (this.debugLog) {
-                    fsm_dynamo_1.DyFM_Log.info(`[FR-048] clamp '${key}' ${value} → ${next} for model '${modelId}'`);
-                }
-                mutable[key] = next;
-            }
-        }
-        return reconciled;
-    }
-    /**
-     * GPT valasz Function Calling Agent Tool-okkal — provider-agnosztikus agent-loop.
-     * @description A `tools` definiciok + `toolHandlers` alapjan tool-loop-ot futtat: hivja a
-     *   modellt (callModelWithTools) → ha a valaszban tool-call van, lefuttatja a regisztralt
-     *   handler-t (runToolCall, never-throw) es az eredmenyt visszafuzi → ismetli, amig a model
-     *   vegso (tool-call nelkuli) valaszt ad, vagy a maxIterations limitet eleri. A tool-ok a
-     *   REQUEST-parameterben jonnek, nem a settings-ben.
-     */
-    async requestWithTools(set) {
-        const modelId = (set.settings?.useModel ?? this.defaultModel);
-        if (!modelId) {
-            throw new fsm_dynamo_1.DyFM_Error({
-                message: `No model configured for function calling (provider: ${this.aiProvider})`,
-                userMessage: `No AI model is configured for tools.`,
-                errorCode: 'DyNTS-AILSB-TLM0',
-            });
-        }
-        this.assertToolsSupported(modelId);
-        return this.runToolLoop(set);
-    }
-    /**
-     * Egy provider-kor a tool-loop-ban: elkuldi a beszelgetest + tool-okat, normalizalt valaszt ad.
-     * @description Override-olando providerenkent (OpenAI / Anthropic / Google / …). A default
-     *   elhasal — egy provider, ami nem implementalja, tool-use-t nem tud kiszolgalni.
-     */
-    async callModelWithTools(_set) {
-        throw new fsm_dynamo_1.DyFM_Error({
-            message: `callModelWithTools is not implemented for provider '${this.aiProvider}'`,
-            userMessage: `Function calling is not available for this AI provider yet.`,
-            errorCode: 'DyNTS-AILSB-TLN0',
-        });
-    }
-    /**
-     * A provider-agnosztikus agent-loop torzse. A bemeno `conversation` ele a provider teszi a
-     * system-message-et (callModelWithTools); a loop a tool-call/tool-result uzeneteket fuzi hozza.
-     */
-    async runToolLoop(set) {
-        const maxIterations = set.maxIterations ?? 8;
-        const conversation = [...set.conversation];
-        for (let iteration = 0; iteration < maxIterations; iteration++) {
-            const response = await this.callModelWithTools({
-                conversation: conversation,
-                tools: set.tools,
-                settings: set.settings,
-                issuer: set.issuer,
-            });
-            // nincs tool-hivas → ez a vegso valasz
-            if (!response.toolCalls?.length) {
-                return response;
-            }
-            // a model tool-hivo (assistant) uzenetet visszatesszuk a kontextusba
-            conversation.push({
-                role: ai_1.DyFM_AI_MessageRole.assistant,
-                content: response.content ?? '',
-                toolCalls: response.toolCalls,
-            });
-            // minden tool-hivast lefuttatunk (never-throw), es az eredmenyt visszaadjuk a modellnek
-            const results = await Promise.all(response.toolCalls.map((call) => this.runToolCall(call, set.toolHandlers)));
-            results.forEach((result) => {
-                conversation.push({
-                    role: ai_1.DyFM_AI_MessageRole.tool,
-                    content: result.content,
-                    toolCallId: result.toolCallId,
-                });
-            });
-        }
-        // a tool-loop nem konvergalt a limiten belul
-        throw new fsm_dynamo_1.DyFM_Error({
-            message: `Tool loop did not converge within ${maxIterations} iterations`,
-            userMessage: `We encountered an error while running AI tools, please contact the responsible development team.`,
-            errorCode: 'DyNTS-AILSB-TL0',
-        });
-    }
-    /**
-     * Egy tool-hivas lefuttatasa a regisztralt handler-rel. SOHA nem dob — a tool-hiba string-kent
-     * megy vissza a modellnek (hogy korrigalhasson), hianyzo handler eseten is informativ uzenet
-     * (soha nem [object Object]).
-     */
-    async runToolCall(call, toolHandlers) {
-        const handler = toolHandlers[call.name];
-        if (!handler) {
-            return {
-                toolCallId: call.id,
-                content: `ERROR: no handler registered for tool '${call.name}'`,
-                isError: true,
-            };
-        }
-        try {
-            return {
-                toolCallId: call.id,
-                content: await handler(call.arguments),
-            };
-        }
-        catch (error) {
-            return {
-                toolCallId: call.id,
-                content: `ERROR executing tool '${call.name}': ` +
-                    `${error instanceof Error ? error.message : String(error)}`,
-                isError: true,
-            };
-        }
-    }
-    // Helper methods
-    /* protected abstract getDefaultErrorSettings(
-      method: string,
-      error: any,
-      issuer?: string
-    ): DyFM_Error_Settings; */
-    /* protected abstract getTextListAsText(list: string[]): string; */
-    /* protected abstract logQuestion(set: DyFM_AI_Base_Input<T_AISettings>): void; */
-    convertAnswerToBoolean(answer) {
-        return answer.toUpperCase().includes(this.predefinedRequests.yesNo.upperCaseYes);
-    }
-    convertAnswerToNumber(answer, message) {
-        if (this.isAnswerValid(answer, message)) {
-            return null;
-        }
-        if (isNaN(+answer)) {
-            fsm_dynamo_1.DyFM_Log.T_error('DyNTS_AI_LLMChat_ServiceBase.convertAnswerToNumber got an invalid answer', {
-                question: message,
-                answer: answer,
-            });
-            return null;
-        }
-        return +answer;
-    }
-    convertAnswerToSelectOption(answer, message, options) {
-        if (this.isAnswerValid(answer, message)) {
-            return null;
-        }
-        answer = answer.toLocaleUpperCase();
-        const stringifiedOptions = this.stringifySelectOptions(options);
-        for (const stringifiedItem of stringifiedOptions) {
-            if (answer.includes(stringifiedItem.toLocaleUpperCase())) {
-                const parsedItem = fsm_dynamo_1.DyFM_Object.safeParseJSON(stringifiedItem);
-                if (parsedItem.unparsableResult) {
-                    fsm_dynamo_1.DyFM_Log.T_error('DyNTS_AI_LLMChat_ServiceBase.convertAnswerToSelectOption got an invalid answer', {
-                        question: message,
-                        answer: answer,
-                    });
-                    return stringifiedItem;
-                }
-                else {
-                    return parsedItem;
-                }
-            }
-        }
-        return null;
-    }
-    convertAnswerToSelectOptions(answer, message, options) {
-        if (this.isAnswerValid(answer, message)) {
-            return null;
-        }
-        const enrichedOptions = options.map((option) => ({
-            stringifiedOption: this.stringifySelectOption(option),
-            parsedOption: option
-        }));
-        const result = [];
-        for (const item of enrichedOptions) {
-            if (answer.includes(item.stringifiedOption)) {
-                result.push(item.parsedOption);
-            }
-        }
-        return result;
-    }
-    convertAnswerToJSON(answer, message) {
-        if (this.isAnswerValid(answer, message)) {
-            return { unparsableResult: answer };
-        }
-        const parsedItem = fsm_dynamo_1.DyFM_Object.safeParseJSON(answer);
-        if (parsedItem.unparsableResult) {
-            fsm_dynamo_1.DyFM_Log.T_error('DyNTS_AI_LLMChat_ServiceBase.convertAnswerToJSON got an invalid answer', {
-                question: message,
-                answer: answer,
-            });
-            return { unparsableResult: answer };
-        }
-        return parsedItem;
-    }
-    convertAnswerToList(answer, message) {
-        if (this.isAnswerValid(answer, message)) {
-            return { unparsableResult: answer };
-        }
-        // Check if safeParseJSON returns unparsableResult before calling safeParseList
-        // because safeParseList doesn't properly handle unparsableResult
-        const parsedCheck = fsm_dynamo_1.DyFM_Object.safeParseJSON(answer, true);
-        if (parsedCheck.unparsableResult) {
-            fsm_dynamo_1.DyFM_Log.T_error('DyNTS_AI_LLMChat_ServiceBase.convertAnswerToList got an invalid answer', {
-                question: message,
-                answer: answer,
-            });
-            return { unparsableResult: answer };
-        }
-        return fsm_dynamo_1.DyFM_Object.safeParseList(answer);
-    }
-    stringifySelectOptions(options) {
-        return options.map(item => this.stringifySelectOption(item));
-    }
-    stringifySelectOption(option) {
-        return JSON.stringify(option);
-    }
-    isAnswerValid(answer, message) {
-        if (!answer?.trim?.()?.length) {
-            fsm_dynamo_1.DyFM_Log.T_error('DyNTS_AI_LLMChat_ServiceBase.convertAnswerToSelectOption got an invalid answer', {
-                question: message,
-                answer: answer,
-            });
-            return true;
-        }
-        return false;
-    }
-    /**
-     * olvasható mondatszerű-listaszerű formába teszi a listaelemeket
-     * pl.: ['a', 'b', 'c'] -> '"a", "b" or "c"'
-     */
-    getTextListAsText(list) {
-        list = list.filter(item => item?.trim()).map(item => `"${item}"`);
-        /* list = list.map(item => item.toLocaleLowerCase()); */
-        list.push(list.pop() + ' or ' + list.pop());
-        return list.join(', ');
-    }
-    logQuestion(set) {
-        if (set.settings?.debugLog ?? this._debugLog) {
-            console.log('\n - ', set.message);
-        }
-    }
-    getDefaultSystemMessage(settings) {
-        return {
-            role: ai_1.DyFM_AI_MessageRole.system,
-            content: settings?.systemPrompt || this.defaultSystemPrompt,
-        };
-    }
-    validateConversation(conversation) {
-        conversation.forEach((message, index) => {
-            if (!message.role) {
-                throw new fsm_dynamo_1.DyFM_Error({
-                    message: `Message has no role at index ${index}`,
-                    additionalContent: {
-                        invalidMessage: message,
-                        conversation: conversation,
-                    }
-                });
-            }
-        });
-        conversation = conversation.filter(message => message.content);
-    }
-    logAnswer(answer) {
-        if (this._debugLog) {
-            console.log(' - answer: ', answer);
-        }
-    }
-    //////////////////////////////////////////////////////////////////////////////////////////
-    // LLM CHAT METHODS //
-    //////////////////////////////////////////////////////////////////////////////////////////
-    logConversation(set) {
-        if (set.debugLog || this._debugLog) {
-            fsm_dynamo_1.DyFM_Log.info('Conversation log at', (0, fsm_dynamo_1.DyFM_getLocalStackLocation)());
-            set.conversation.forEach(message => {
-                console.log(` - ${message.role}: ${message.content.replace(set.replaceThisInLog, this.defaultLogReplacer)}`);
-            });
-        }
-    }
-}
-exports.DyNTS_AI_LLM_ServiceBase = DyNTS_AI_LLM_ServiceBase;
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.DyNTS_AI_LLM_ServiceBase = void 0;
+const ai_provider_service_base_1 = require("./ai-provider.service-base");
+const ai_1 = require("@futdevpro/fsm-dynamo/ai");
+const fsm_dynamo_1 = require("@futdevpro/fsm-dynamo");
+/**
+ * Abstract base class for LLM services
+ * Defines all methods that must be implemented by AI providers
+ */
+class DyNTS_AI_LLM_ServiceBase extends ai_provider_service_base_1.DyNTS_AI_Provider_ServiceBase {
+    _debugLog = false;
+    get debugLog() {
+        return this.defaultSettings?.debugLog ?? this._debugLog;
+    }
+    get defaultSystemPrompt() {
+        return this.defaultSettings.systemPrompt;
+    }
+    get defaultModel() {
+        return this.defaultSettings.useModel;
+    }
+    defaultLogReplacer = '...long-context...';
+    //////////////////////////////////////////////////////////////////////////////////////////
+    // FUNCTION CALLING (TOOL USE) — FR-047 //
+    //////////////////////////////////////////////////////////////////////////////////////////
+    // Provider-agnostic agent-loop. The loop logic lives here ONCE (ported from the legacy
+    // FDPNTS_GPT_ControlService.getAnswerWithTools); each provider only overrides
+    // `callModelWithTools` (one provider turn) and `getModelRegistry` (capability honesty).
+    // Tools are a REQUEST parameter (not on settings), per the FR-047 design.
+    /**
+     * A provider tool-kepes modell-registry-je (override providerenkent — pl. DyFM_OAI_Models).
+     * Ures default → a modell tool-kepessege ismeretlen → a precheck elutasitja (honesty).
+     */
+    getModelRegistry() {
+        return [];
+    }
+    /**
+     * Ellenorzi, hogy a feloldott modell tamogatja-e a function calling-ot; ha nem, beszedes
+     * hibaval elhasal MIELOTT barmilyen API-hivas tortenne (kritikus pl. a Local providernel).
+     */
+    assertToolsSupported(modelId) {
+        if (!ai_1.DyFM_AI_ModelRegistry_Util.modelSupportsTools(this.getModelRegistry(), modelId)) {
+            throw new fsm_dynamo_1.DyFM_Error({
+                message: `Model '${modelId}' does not support function calling (provider: ${this.aiProvider})`,
+                userMessage: `The selected AI model does not support tools.`,
+                errorCode: 'DyNTS-AILSB-TLC0',
+            });
+        }
+    }
+    //////////////////////////////////////////////////////////////////////////////////////////
+    // PER-MODEL SETTINGS RECONCILER — FR-048 //
+    //////////////////////////////////////////////////////////////////////////////////////////
+    /**
+     * FR-048 reconciler — a resolved modell `settingsSchema`-ja szerint egyezteti a call-settings-et a
+     * tenyleges provider-hivas ELOTT: DROPolja az `unsupported` kulcsokat (debug-log, SOHA nem csendben),
+     * CLAMP-eli a `constraints` (min/max) szerint. Ismeretlen modell / schema-mentes registry-bejegyzes →
+     * permisszi­v passthrough + log (best-effort, honesty).
+     *
+     * Ezzel altalanosul a FR-047 Phase-4 lokalis param-drop (Anthropic Opus 4.7+ temperature/topP/topK) es a
+     * FR-047 `isReasoningModel` sampling-drop: a tudas mostantol a registry `settingsSchema`-jaban (SSoT) el,
+     * nem provider-translator-onkent duplikalva.
+     *
+     * NON-BREAKING: ha a registry ures vagy a modellnek nincs schemaja, a bemenet valtozatlanul ter vissza —
+     * igy a meglevo providerek viselkedese nem valtozik, amig a schema nincs feltoltve.
+     * @param modelId - a feloldott modell azonositoja
+     * @param settings - a hivas-settings (opcionalis)
+     */
+    reconcileCallSettings(modelId, settings) {
+        if (!settings) {
+            return settings;
+        }
+        const modelInfo = ai_1.DyFM_AI_ModelRegistry_Util.findModelInfo(this.getModelRegistry(), modelId);
+        const schema = modelInfo?.settingsSchema;
+        if (!schema) {
+            if (this.debugLog) {
+                fsm_dynamo_1.DyFM_Log.info(`[FR-048] no settingsSchema for '${modelId}' — passthrough (best-effort)`);
+            }
+            return settings;
+        }
+        const reconciled = { ...settings };
+        // A generikus `T_AISettings` csak OLVASASRA indexelheto (TS2862), ezert a mutaciot egy nem-generikus
+        // aliason vegezzuk — UGYANARRA az objektumra mutat, igy cast nelkul is tipus-helyes marad.
+        const mutable = reconciled;
+        for (const key of schema.unsupported ?? []) {
+            if (mutable[key] !== undefined) {
+                if (this.debugLog) {
+                    fsm_dynamo_1.DyFM_Log.info(`[FR-048] drop unsupported '${key}' for model '${modelId}'`);
+                }
+                delete mutable[key];
+            }
+        }
+        const constraints = schema.constraints ?? {};
+        for (const key of Object.keys(constraints)) {
+            const constraint = constraints[key];
+            const value = mutable[key];
+            if (typeof value !== 'number') {
+                continue;
+            }
+            let next = value;
+            if (typeof constraint.min === 'number' && next < constraint.min) {
+                next = constraint.min;
+            }
+            if (typeof constraint.max === 'number' && next > constraint.max) {
+                next = constraint.max;
+            }
+            if (next !== value) {
+                if (this.debugLog) {
+                    fsm_dynamo_1.DyFM_Log.info(`[FR-048] clamp '${key}' ${value} → ${next} for model '${modelId}'`);
+                }
+                mutable[key] = next;
+            }
+        }
+        return reconciled;
+    }
+    /**
+     * GPT valasz Function Calling Agent Tool-okkal — provider-agnosztikus agent-loop.
+     * @description A `tools` definiciok + `toolHandlers` alapjan tool-loop-ot futtat: hivja a
+     *   modellt (callModelWithTools) → ha a valaszban tool-call van, lefuttatja a regisztralt
+     *   handler-t (runToolCall, never-throw) es az eredmenyt visszafuzi → ismetli, amig a model
+     *   vegso (tool-call nelkuli) valaszt ad, vagy a maxIterations limitet eleri. A tool-ok a
+     *   REQUEST-parameterben jonnek, nem a settings-ben.
+     */
+    async requestWithTools(set) {
+        const modelId = (set.settings?.useModel ?? this.defaultModel);
+        if (!modelId) {
+            throw new fsm_dynamo_1.DyFM_Error({
+                message: `No model configured for function calling (provider: ${this.aiProvider})`,
+                userMessage: `No AI model is configured for tools.`,
+                errorCode: 'DyNTS-AILSB-TLM0',
+            });
+        }
+        this.assertToolsSupported(modelId);
+        return this.runToolLoop(set);
+    }
+    /**
+     * Egy provider-kor a tool-loop-ban: elkuldi a beszelgetest + tool-okat, normalizalt valaszt ad.
+     * @description Override-olando providerenkent (OpenAI / Anthropic / Google / …). A default
+     *   elhasal — egy provider, ami nem implementalja, tool-use-t nem tud kiszolgalni.
+     */
+    async callModelWithTools(_set) {
+        throw new fsm_dynamo_1.DyFM_Error({
+            message: `callModelWithTools is not implemented for provider '${this.aiProvider}'`,
+            userMessage: `Function calling is not available for this AI provider yet.`,
+            errorCode: 'DyNTS-AILSB-TLN0',
+        });
+    }
+    /**
+     * A provider-agnosztikus agent-loop torzse. A bemeno `conversation` ele a provider teszi a
+     * system-message-et (callModelWithTools); a loop a tool-call/tool-result uzeneteket fuzi hozza.
+     */
+    async runToolLoop(set) {
+        const maxIterations = set.maxIterations ?? 8;
+        const conversation = [...set.conversation];
+        for (let iteration = 0; iteration < maxIterations; iteration++) {
+            const response = await this.callModelWithTools({
+                conversation: conversation,
+                tools: set.tools,
+                settings: set.settings,
+                issuer: set.issuer,
+            });
+            // nincs tool-hivas → ez a vegso valasz
+            if (!response.toolCalls?.length) {
+                return response;
+            }
+            // a model tool-hivo (assistant) uzenetet visszatesszuk a kontextusba
+            conversation.push({
+                role: ai_1.DyFM_AI_MessageRole.assistant,
+                content: response.content ?? '',
+                toolCalls: response.toolCalls,
+            });
+            // minden tool-hivast lefuttatunk (never-throw), es az eredmenyt visszaadjuk a modellnek
+            const results = await Promise.all(response.toolCalls.map((call) => this.runToolCall(call, set.toolHandlers)));
+            results.forEach((result) => {
+                conversation.push({
+                    role: ai_1.DyFM_AI_MessageRole.tool,
+                    content: result.content,
+                    toolCallId: result.toolCallId,
+                });
+            });
+        }
+        // a tool-loop nem konvergalt a limiten belul
+        throw new fsm_dynamo_1.DyFM_Error({
+            message: `Tool loop did not converge within ${maxIterations} iterations`,
+            userMessage: `We encountered an error while running AI tools, please contact the responsible development team.`,
+            errorCode: 'DyNTS-AILSB-TL0',
+        });
+    }
+    /**
+     * Egy tool-hivas lefuttatasa a regisztralt handler-rel. SOHA nem dob — a tool-hiba string-kent
+     * megy vissza a modellnek (hogy korrigalhasson), hianyzo handler eseten is informativ uzenet
+     * (soha nem [object Object]).
+     */
+    async runToolCall(call, toolHandlers) {
+        const handler = toolHandlers[call.name];
+        if (!handler) {
+            return {
+                toolCallId: call.id,
+                content: `ERROR: no handler registered for tool '${call.name}'`,
+                isError: true,
+            };
+        }
+        try {
+            return {
+                toolCallId: call.id,
+                content: await handler(call.arguments),
+            };
+        }
+        catch (error) {
+            return {
+                toolCallId: call.id,
+                content: `ERROR executing tool '${call.name}': ` +
+                    `${error instanceof Error ? error.message : String(error)}`,
+                isError: true,
+            };
+        }
+    }
+    // Helper methods
+    /* protected abstract getDefaultErrorSettings(
+      method: string,
+      error: any,
+      issuer?: string
+    ): DyFM_Error_Settings; */
+    /* protected abstract getTextListAsText(list: string[]): string; */
+    /* protected abstract logQuestion(set: DyFM_AI_Base_Input<T_AISettings>): void; */
+    convertAnswerToBoolean(answer) {
+        return answer.toUpperCase().includes(this.predefinedRequests.yesNo.upperCaseYes);
+    }
+    convertAnswerToNumber(answer, message) {
+        if (this.isAnswerValid(answer, message)) {
+            return null;
+        }
+        if (isNaN(+answer)) {
+            fsm_dynamo_1.DyFM_Log.T_error('DyNTS_AI_LLMChat_ServiceBase.convertAnswerToNumber got an invalid answer', {
+                question: message,
+                answer: answer,
+            });
+            return null;
+        }
+        return +answer;
+    }
+    convertAnswerToSelectOption(answer, message, options) {
+        if (this.isAnswerValid(answer, message)) {
+            return null;
+        }
+        answer = answer.toLocaleUpperCase();
+        const stringifiedOptions = this.stringifySelectOptions(options);
+        for (const stringifiedItem of stringifiedOptions) {
+            if (answer.includes(stringifiedItem.toLocaleUpperCase())) {
+                const parsedItem = fsm_dynamo_1.DyFM_Object.safeParseJSON(stringifiedItem);
+                if (parsedItem.unparsableResult) {
+                    fsm_dynamo_1.DyFM_Log.T_error('DyNTS_AI_LLMChat_ServiceBase.convertAnswerToSelectOption got an invalid answer', {
+                        question: message,
+                        answer: answer,
+                    });
+                    return stringifiedItem;
+                }
+                else {
+                    return parsedItem;
+                }
+            }
+        }
+        return null;
+    }
+    convertAnswerToSelectOptions(answer, message, options) {
+        if (this.isAnswerValid(answer, message)) {
+            return null;
+        }
+        const enrichedOptions = options.map((option) => ({
+            stringifiedOption: this.stringifySelectOption(option),
+            parsedOption: option
+        }));
+        const result = [];
+        for (const item of enrichedOptions) {
+            if (answer.includes(item.stringifiedOption)) {
+                result.push(item.parsedOption);
+            }
+        }
+        return result;
+    }
+    convertAnswerToJSON(answer, message) {
+        if (this.isAnswerValid(answer, message)) {
+            return { unparsableResult: answer };
+        }
+        const parsedItem = fsm_dynamo_1.DyFM_Object.safeParseJSON(answer);
+        if (parsedItem.unparsableResult) {
+            fsm_dynamo_1.DyFM_Log.T_error('DyNTS_AI_LLMChat_ServiceBase.convertAnswerToJSON got an invalid answer', {
+                question: message,
+                answer: answer,
+            });
+            return { unparsableResult: answer };
+        }
+        return parsedItem;
+    }
+    convertAnswerToList(answer, message) {
+        if (this.isAnswerValid(answer, message)) {
+            return { unparsableResult: answer };
+        }
+        // Check if safeParseJSON returns unparsableResult before calling safeParseList
+        // because safeParseList doesn't properly handle unparsableResult
+        const parsedCheck = fsm_dynamo_1.DyFM_Object.safeParseJSON(answer, true);
+        if (parsedCheck.unparsableResult) {
+            fsm_dynamo_1.DyFM_Log.T_error('DyNTS_AI_LLMChat_ServiceBase.convertAnswerToList got an invalid answer', {
+                question: message,
+                answer: answer,
+            });
+            return { unparsableResult: answer };
+        }
+        return fsm_dynamo_1.DyFM_Object.safeParseList(answer);
+    }
+    stringifySelectOptions(options) {
+        return options.map(item => this.stringifySelectOption(item));
+    }
+    stringifySelectOption(option) {
+        return JSON.stringify(option);
+    }
+    isAnswerValid(answer, message) {
+        if (!answer?.trim?.()?.length) {
+            fsm_dynamo_1.DyFM_Log.T_error('DyNTS_AI_LLMChat_ServiceBase.convertAnswerToSelectOption got an invalid answer', {
+                question: message,
+                answer: answer,
+            });
+            return true;
+        }
+        return false;
+    }
+    /**
+     * olvasható mondatszerű-listaszerű formába teszi a listaelemeket
+     * pl.: ['a', 'b', 'c'] -> '"a", "b" or "c"'
+     */
+    getTextListAsText(list) {
+        list = list.filter(item => item?.trim()).map(item => `"${item}"`);
+        /* list = list.map(item => item.toLocaleLowerCase()); */
+        list.push(list.pop() + ' or ' + list.pop());
+        return list.join(', ');
+    }
+    logQuestion(set) {
+        if (set.settings?.debugLog ?? this._debugLog) {
+            console.log('\n - ', set.message);
+        }
+    }
+    getDefaultSystemMessage(settings) {
+        return {
+            role: ai_1.DyFM_AI_MessageRole.system,
+            content: settings?.systemPrompt || this.defaultSystemPrompt,
+        };
+    }
+    validateConversation(conversation) {
+        conversation.forEach((message, index) => {
+            if (!message.role) {
+                throw new fsm_dynamo_1.DyFM_Error({
+                    message: `Message has no role at index ${index}`,
+                    additionalContent: {
+                        invalidMessage: message,
+                        conversation: conversation,
+                    }
+                });
+            }
+        });
+        conversation = conversation.filter(message => message.content);
+    }
+    logAnswer(answer) {
+        if (this._debugLog) {
+            console.log(' - answer: ', answer);
+        }
+    }
+    //////////////////////////////////////////////////////////////////////////////////////////
+    // LLM CHAT METHODS //
+    //////////////////////////////////////////////////////////////////////////////////////////
+    logConversation(set) {
+        if (set.debugLog || this._debugLog) {
+            fsm_dynamo_1.DyFM_Log.info('Conversation log at', (0, fsm_dynamo_1.DyFM_getLocalStackLocation)());
+            set.conversation.forEach(message => {
+                console.log(` - ${message.role}: ${message.content.replace(set.replaceThisInLog, this.defaultLogReplacer)}`);
+            });
+        }
+    }
+}
+exports.DyNTS_AI_LLM_ServiceBase = DyNTS_AI_LLM_ServiceBase;
 //# sourceMappingURL=ai-llm.service-base.js.map