@futdevpro/nts-dynamo 1.15.156 → 1.15.157

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

@@ -1,618 +1,618 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.DyNTS_OAI_LLM_ServiceBase = void 0;
-const openai_1 = require("openai");
-const open_ai_1 = require("@futdevpro/fsm-dynamo/ai/open-ai");
-const fsm_dynamo_1 = require("@futdevpro/fsm-dynamo");
-const ai_1 = require("@futdevpro/fsm-dynamo/ai");
-const global_settings_const_1 = require("../../../../../_collections/global-settings.const");
-const oai_global_settings_const_1 = require("../_collections/oai-global-settings.const");
-const oai_llm_predefined_requests_conts_1 = require("../_collections/oai-llm-predefined-requests.conts");
-const ai_llm_service_base_1 = require("../../../_services/ai-llm.service-base");
-/**
- * {
- *   organization: 'org-XY',
- *   apiKey: 'sk-XY',
- *   project: 'proj_XY',
- * }
- */
-// Di Dictionary DiModel DiEz DiAz
-class DyNTS_OAI_LLM_ServiceBase extends ai_llm_service_base_1.DyNTS_AI_LLM_ServiceBase {
-    /* readonly defaultErrorUserMsg: string =
-      `We encountered an unhandled Control Service Error, ` +
-      `\nplease contact the responsible development team.`;  */
-    openai;
-    defaultSettings;
-    // Provider properties from DyNTS_AI_Provider_ServiceBase
-    aiProvider = ai_1.DyFM_AI_Provider.OpenAI;
-    capabilities = {
-        chat: true,
-        embeddings: true,
-        imageGeneration: true,
-        vision: true,
-        audioGeneration: true,
-        audioAnalysis: true,
-        functionCalling: true,
-        streaming: true,
-        batchOperations: true,
-        maxContextLength: 128000,
-        supportedModelTypes: ['gpt-4o', 'gpt-4o-mini', 'text-embedding-3-large', 'text-embedding-3-small']
-    };
-    /* get _debugLog(): boolean {
-      return this.defaultSettings.debugLog;
-    } */
-    /* get defaultSystemPrompt(): string {
-      return this.defaultSettings.systemPrompt;
-    } */
-    get defaultModel() {
-        return this.defaultSettings.useModel;
-    }
-    predefinedRequests = oai_llm_predefined_requests_conts_1.DyNTS_OAI_LLMDefaultPredefined_Requests;
-    constructor(set) {
-        super();
-        global_settings_const_1.DyNTS_global_settings.openAi_settings ??= oai_global_settings_const_1.DyNTS_OAI_global_settings;
-        this.openai = new openai_1.OpenAI(set?.config ??
-            {
-                organization: global_settings_const_1.DyNTS_global_settings.env_settings.openAi.organization,
-                apiKey: global_settings_const_1.DyNTS_global_settings.env_settings.openAi.apiKey,
-                project: global_settings_const_1.DyNTS_global_settings.env_settings.openAi.project,
-            });
-        this.defaultSettings = set?.defaultSettings ??
-            oai_global_settings_const_1.DyNTS_OAI_global_settings.defaultSettings ??
-            new open_ai_1.DyFM_OAI_CallSettings();
-        // FR-002 — opcionális per-call cost-event callback átadás a base-osztálynak
-        if (set?.onCostEvent) {
-            this.onCostEvent = set.onCostEvent;
-        }
-    }
-    /**
-     * Inicializálja az OpenAI client-et a megadott config-gal
-     *
-     * Reinitializes the OpenAI client with the provided config
-     */
-    setup(config) {
-        this.openai = new openai_1.OpenAI(config);
-    }
-    /* readonly defaultLogReplacer: string = '...long-context...'; */
-    //#region Ask Questions
-    /**
-     * 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 requestYesNo(set) {
-        set.message += this.predefinedRequests.yesNo.request;
-        const answer = await this.requestSimpleMessage(set);
-        return this.convertAnswerToBoolean(answer);
-    }
-    /** the exact same as {@link requestYesNo} */
-    //yesNoQuestion = this.askYesNoQuestion;
-    /**
-     * Asks the AI to answer a percentage question
-     *
-     * Uses the {@link DyNTS_OAI_LLM_Predefined_Requests.percentageOnly} to ask the question
-     */
-    async requestPercentage(set) {
-        set.message += this.predefinedRequests.percentageOnly;
-        const answer = await this.requestSimpleMessage(set);
-        return this.convertAnswerToNumber(answer, set.message);
-    }
-    /** the exact same as {@link requestPercentage} */
-    //percentageQuestion = this.askPercentageQuestion;
-    /**
-     * 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 askSelectQuestion(
-      set: DyFM_AI_GenericSelect_Input<string>
-    ): Promise<string> {
-      // replace the {{DyNTS_selectOptions}} with the list of options
-      const selectQuestionAddition = this.predefinedRequests.selectRequest.replace(
-        '{{DyNTS_selectOptions}}',
-        this.getTextListAsText(set.selectFrom)
-      );
-      set.message += selectQuestionAddition;
-  
-      let answer = await this.requestSimpleMessage(set);
-      
-      answer = answer.toLocaleUpperCase();
-      
-      for (const item of set.selectFrom) {
-        if (answer.includes(item.toLocaleUpperCase())) return item;
-      }
-  
-      return null;
-    } */
-    /** the exact same as {@link askSelectQuestion} */
-    //selectQuestion = this.askSelectQuestion;
-    /**
-     * 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 requestSelect(set) {
-        const options = this.stringifySelectOptions(set.selectFrom);
-        const selectQuestionAddition = this.predefinedRequests.selectRequest.replace('{{DyNTS_selectOptions}}', this.getTextListAsText(options));
-        set.message += selectQuestionAddition;
-        const answer = await this.requestSimpleMessage(set);
-        return this.convertAnswerToSelectOption(answer, set.message, set.selectFrom);
-    }
-    /** the exact same as {@link requestSelect} */
-    //selectRequest = this.requestSelect;
-    /**
-     * 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 requestMultiselect(set) {
-        const options = this.stringifySelectOptions(set.options);
-        const selectQuestionAddition = this.predefinedRequests.multiselect.replace('{{DyNTS_selectOptions}}', this.getTextListAsText(options));
-        set.message += selectQuestionAddition;
-        let answer = await this.requestSimpleMessage(set);
-        answer = answer.toLocaleUpperCase();
-        return this.convertAnswerToSelectOptions(answer, set.message, set.options);
-        /* const result: T[] = [];
-    
-        for (const item of options) {
-          if (answer.includes(item.toLocaleUpperCase())) {
-            const parsedItem: T | { unparsableResult: string } = DyFM_Object.safeParseJSON<T>(item);
-            if ((parsedItem as { unparsableResult: string }).unparsableResult) {
-              result.push(item as any);
-            } else {
-              result.push(parsedItem as T);
-            }
-              
-          }
-        }
-    
-        if (!result.length && !answer.trim().length) {
-          return { unparsableResult: answer };
-        }
-    
-        return result; */
-    }
-    /** the exact same as {@link askMultipleSelectQuestionWithOptions} */
-    //multipleSelectQuestion = this.askMultipleSelectQuestionWithOptions;
-    /**
-     * 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 requestMultiselect<T>(
-      set: DyFM_AI_GenericMultiSelect_Input<T, DyFM_OAI_CallSettings>
-    ): Promise<T[]> {
-      const selectQuestionAddition = this.predefinedRequests.multiselect.replace(
-        '{{DyNTS_selectOptions}}',
-        this.getTextListAsText(set.options.map(item => `"${JSON.stringify(item)}"`))
-      );
-      set.message += selectQuestionAddition;
-      
-      const answer = await this.requestSimpleMessage(set);
-  
-      return DyFM_Object.safeParseList<T[]>(answer);
-    } */
-    /** the exact same as {@link requestMultipleSelect} */
-    //multipleSelectRequest = this.requestMultipleSelect;
-    /**
-     * 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 requestJSON(set) {
-        set.message += this.predefinedRequests.jsonRequest;
-        const answer = await this.requestSimpleMessage(set);
-        return this.convertAnswerToJSON(answer, set.message);
-    }
-    /** the exact same as {@link askJSONQuestion} */
-    //jsonQuestion = this.askJSONQuestion;
-    /**
-     * 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 requestJSONQuestionWithKeysDescription(set) {
-        const jsonRequestWithKeysDescription = this.predefinedRequests.jsonRequestWithKeysDescription.replace('{{DyNTS_jsonKeysDescription}}', set.keysDescription);
-        set.message += jsonRequestWithKeysDescription;
-        const answer = await this.requestSimpleMessage(set);
-        return this.convertAnswerToJSON(answer, set.message);
-    }
-    /** the exact same as {@link requestJSONQuestionWithKeysDescription} */
-    //jsonQuestionWithKeysDescription = this.askJSONQuestionWithKeysDescription;
-    /**
-     * 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 requestJSONWithExactKeys(set) {
-        const jsonRequestWithExactKeys = this.predefinedRequests.jsonRequestWithExactKeys.replace('{{DyNTS_jsonKeys}}', this.getTextListAsText(set.keys));
-        set.message += jsonRequestWithExactKeys;
-        const answer = await this.requestSimpleMessage(set);
-        return this.convertAnswerToJSON(answer, set.message);
-    }
-    /** the exact same as {@link askJSONQuestionWithExactKeys} */
-    //jsonQuestionWithExactKeys = this.askJSONQuestionWithExactKeys;
-    /**
-     * 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 requestList(
-      set: DyFM_AI_Base_Input<DyFM_OAI_CallSettings>
-    ): Promise<string[]> {
-      set.message += this.predefinedRequests.listRequest;
-  
-      const answer = await this.requestSimpleMessage(set);
-  
-      return this.convertAnswerToList<string>(answer, set.message);
-    } */
-    /** the exact same as {@link askListQuestion} */
-    //listQuestion = this.askListQuestion;
-    /** the exact same as {@link askListQuestion} */
-    //listRequest = this.askListQuestion;
-    async requestList(set) {
-        set.message += this.predefinedRequests.listRequest;
-        const answer = await this.requestSimpleMessage(set);
-        return this.convertAnswerToList(answer, set.message);
-    }
-    /**
-     * Asks the AI to answer a question
-     *
-     * Uses the {@link resolveSimpleUserMessage}
-     */
-    async requestSimpleMessage(set) {
-        this.logQuestion(set);
-        set.conversation ??= [];
-        set.conversation.push({ role: ai_1.DyFM_AI_MessageRole.user, content: set.message });
-        const answer = await this.resolveMessage({
-            ...set,
-            conversation: set.conversation,
-            getFullResponse: false,
-        });
-        this.logAnswer(answer);
-        return answer;
-    }
-    /** the exact same as {@link requestSimpleMessage} */
-    //answer = this.askQuestion;
-    /** the exact same as {@link requestSimpleMessage} */
-    //getQuestionAnswer = this.askQuestion;
-    /** the exact same as {@link requestSimpleMessage} */
-    //simpleQuestion = this.askQuestion;
-    /** the exact same as {@link requestSimpleMessage} */
-    //askSimpleQuestion = this.askQuestion;
-    /**
-     * Resolves a simple user message and returns the answer as string
-     *
-     * Uses the {@link resolveMessage}
-     */
-    /* async resolveSimpleUserMessage(
-      set: DyFM_AI_Base_Input<DyFM_OAI_CallSettings>
-    ): Promise<string> {
-      return this.resolveMessage({
-        conversation: [{ role: DyFM_AI_MessageRole.user, content: set.message }],
-        issuer: set.issuer ?? 'unknown',
-        settings: set.settings ?? this.defaultSettings,
-        getFullResponse: false,
-      }) as Promise<string>;
-    } */
-    /** the exact same as {@link resolveSimpleUserMessage} */
-    //simpleUserMessage = this.resolveSimpleUserMessage;
-    //#endregion
-    /**
-     * Resolves a conversation
-     *
-     * Uses the {@link getMessageCreateInput}
-     */
-    async resolveMessage(set
-    /* {
-      conversation: [{ role: DyFM_AI_MessageRole.user, content: set.message }],
-      issuer: set.issuer ?? 'unknown',
-      settings: set.settings ?? this.defaultSettings,
-      getFullResponse: false,
-    } */
-    /* {
-      conversation: DyFM_AI_Message[],
-      issuer: string,
-      settings?: DyFM_OAI_CallSettings,
-      getFullResponse?: boolean
-    } */
-    ) {
-        try {
-            // FR-002 — callType meghatározás a unshift ELŐTT (a system-message hozzáadás
-            // után már 2+ message lenne, ami a "chat" kategóriát mindig kiváltja).
-            // 1 user-message → 'llm-completion'; több → 'llm-chat'. A 'llm-tool-use'
-            // categoria a tools paraméterek bevezetésekor kerül használatba (jövőbeli FR).
-            const userMessageCount = set.conversation.length;
-            set.conversation.unshift(this.getDefaultSystemMessage(set.settings));
-            // FR-002 — per-call cost-event timing: a tényleges API-call latency mérve
-            const input = this.getMessageCreateInput(set);
-            const start = Date.now();
-            const result = await this.openai.chat.completions.create(input);
-            const durationMs = Date.now() - start;
-            // FR-002 — cost-event emit (safe, no-op ha nincs onCostEvent callback)
-            this.emitCostEvent({
-                callType: userMessageCount === 1 ? 'llm-completion' : 'llm-chat',
-                provider: this.aiProvider,
-                model: String(input.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-OLSB-RM0`,
-            });
-        }
-    }
-    /**
-     * Creates a message create input
-     *
-     * Uses the {@link getDefaultSystemMessage}
-     */
-    getMessageCreateInput(set) {
-        try {
-            const settings = set.settings ?? this.defaultSettings;
-            const useModel = String(settings?.useModel ?? this.defaultModel);
-            const result = {
-                model: useModel,
-                messages: set.conversation,
-            };
-            // FR-048 §3: a sampling-parameterek (+ max_completion_tokens) a per-model `settingsSchema` szerint
-            // kerulnek ra (drop/clamp). KORABBAN ez a NEM-tool ag FELTETEL NELKUL kuldte a sampling-parametereket,
-            // ezert reasoning modellen (GPT-5.x / o-series) 400-zal elhasalt volna — ezt itt zarjuk le.
-            this.applySamplingParams({ input: result, useModel: useModel, settings: set.settings });
-            return result;
-        }
-        catch (error) {
-            throw new fsm_dynamo_1.DyFM_Error({
-                ...this.getDefaultErrorSettings('getMessageCreateSettings', error, set.issuer),
-                errorCode: `${global_settings_const_1.DyNTS_global_settings.systemShortCodeName}|DyNTS-OLSB-RC0`,
-            });
-        }
-    }
-    /**
-     * Teszteli a kapcsolatot az OpenAI API-val
-     *
-     * Tests the connection to OpenAI API
-     */
-    async testConnection(issuer) {
-        try {
-            await this.openai.models.list();
-            return true;
-        }
-        catch (error) {
-            fsm_dynamo_1.DyFM_Log.error('DyNTS_OAI_LLM_ServiceBase', 'testConnection', 'Connection test failed', {
-                error,
-                issuer
-            });
-            return false;
-        }
-    }
-    //#region Function calling (tool use) — FR-047
-    /** OpenAI tool-kepes modell-registry (a base capability-precheck-jehez). */
-    getModelRegistry() {
-        return open_ai_1.DyFM_OAI_Models;
-    }
-    /**
-     * Egy OpenAI-kor a tool-loop-ban: felepiti a natív request-et (system + a teljes beszelgetes
-     * tool-uzenetekkel + tools), meghivja az API-t, es normalizalt DyFM_AI_LLM_Response-t ad vissza
-     * (toolCalls feltoltve, ha a model tool-t akar hivni). FR-002 cost-event: 'llm-tool-use'.
-     */
-    async callModelWithTools(set) {
-        try {
-            const settings = set.settings ?? this.defaultSettings;
-            const messages = [
-                this.toOpenAIMessage(this.getDefaultSystemMessage(settings)),
-                ...set.conversation.map((message) => this.toOpenAIMessage(message)),
-            ];
-            const useModel = settings?.useModel ?? this.defaultModel;
-            const input = {
-                model: useModel,
-                messages: messages,
-            };
-            // FR-048 §3: a sampling-parameterek + `max_completion_tokens` a per-model `settingsSchema` szerint
-            // kerulnek ra. A korabbi lokalis `isReasoningModel`-drop atmeneti fallback-kent bent maradt a
-            // helper-ben (l. `applySamplingParams`), amig a schema ki nem kerul a fsm-bol — igy nincs regresszio.
-            this.applySamplingParams({ input: input, useModel: String(useModel), settings: set.settings });
-            // Ures tools-tomb -> 400 ("tools must have minimum length 1"). Csak akkor kuldjuk, ha van tool.
-            if (set.tools.length) {
-                input.tools = set.tools.map((tool) => this.toOpenAITool(tool));
-                input.tool_choice = 'auto';
-            }
-            const start = Date.now();
-            const result = await this.openai.chat.completions.create(input);
-            const durationMs = Date.now() - start;
-            const message = result.choices[0].message;
-            const toolCalls = (message.tool_calls ?? [])
-                .filter((toolCall) => toolCall.type === 'function')
-                .map((toolCall) => ({
-                id: toolCall.id,
-                name: toolCall.function.name,
-                arguments: this.parseToolArguments(toolCall.function.arguments),
-            }));
-            this.emitCostEvent({
-                callType: 'llm-tool-use',
-                provider: this.aiProvider,
-                model: String(input.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(),
-            });
-            return {
-                content: message.content ?? '',
-                toolCalls: toolCalls.length ? toolCalls : undefined,
-                usage: result.usage ? {
-                    promptTokens: result.usage.prompt_tokens,
-                    completionTokens: result.usage.completion_tokens,
-                    totalTokens: result.usage.total_tokens,
-                } : undefined,
-                model: result.model,
-                finishReason: result.choices[0].finish_reason,
-                stopReason: result.choices[0].finish_reason,
-                rawResponse: result,
-            };
-        }
-        catch (error) {
-            throw new fsm_dynamo_1.DyFM_Error({
-                ...this.getDefaultErrorSettings('callModelWithTools', error, set.issuer),
-                errorCode: `${global_settings_const_1.DyNTS_global_settings.systemShortCodeName}|DyNTS-OLSB-TC0`,
-            });
-        }
-    }
-    /** Agnosztikus tool-definicio → OpenAI ChatCompletionTool. */
-    toOpenAITool(tool) {
-        return {
-            type: 'function',
-            function: {
-                name: tool.name,
-                description: tool.description,
-                parameters: tool.parameters,
-            },
-        };
-    }
-    /**
-     * Agnosztikus DyFM_AI_Message → OpenAI ChatCompletionMessageParam.
-     * Kezeli a tool-result (role:'tool') es a tool-hivo assistant (tool_calls) uzeneteket is.
-     */
-    toOpenAIMessage(message) {
-        if (message.role === ai_1.DyFM_AI_MessageRole.tool) {
-            return {
-                role: 'tool',
-                tool_call_id: message.toolCallId ?? '',
-                content: message.content,
-            };
-        }
-        if (message.role === ai_1.DyFM_AI_MessageRole.assistant && message.toolCalls?.length) {
-            return {
-                role: 'assistant',
-                content: message.content || null,
-                tool_calls: message.toolCalls.map((toolCall) => ({
-                    id: toolCall.id,
-                    type: 'function',
-                    function: {
-                        name: toolCall.name,
-                        arguments: JSON.stringify(toolCall.arguments),
-                    },
-                })),
-            };
-        }
-        return {
-            role: message.role,
-            content: message.content,
-        };
-    }
-    /** Tool-argumentumok parse-olasa (OpenAI JSON-string → object); hibas JSON eseten ures object. */
-    parseToolArguments(raw) {
-        try {
-            return JSON.parse(raw || '{}');
-        }
-        catch {
-            return {};
-        }
-    }
-    /**
-     * ⚠️ **TUL TAG HEURISZTIKA — csak FALLBACK, ne ez legyen az igazsag forrasa.**
-     *
-     * Eredetileg (FR-047) azt felteteleztuk, hogy MINDEN `gpt-5.x` + o-series modell elutasitja a
-     * sampling-parametereket. **Live capture 2026-07-21 ezt MEGCAFOLTA:**
-     *  - elutasit: `gpt-5.5`, `o3-mini`, `o4-mini`
-     *  - **ELFOGADJA**: `gpt-5.4-mini`, `gpt-5.4-nano` (HTTP 200, `reasoning_tokens: 0`)
-     *
-     * Vagyis erre a ket modellre ez a regex **NEMAN kidobna ervenyes parametereket** — halkan rontva a
-     * kimenetet. Ezert az `applySamplingParams` a **registry `settingsSchema`-t reszesiti elonyben**, es ezt
-     * a heurisztikat CSAK akkor hasznalja, ha az adott modellhez nincs schema (regi fsm-verzio / ismeretlen
-     * modell). Amint a populalt schema mindenhol elerheto, ez a metodus elhagyhato.
-     *
-     * Reszletek: `fdp-documentations/plans/ai-mocking-system/CAPTURE-FINDINGS.md` §1.
-     */
-    isReasoningModel(modelId) {
-        return /^gpt-5/.test(modelId) || /^o[0-9]/.test(modelId);
-    }
-    /**
-     * FR-048 §3 — feloldja az agnosztikus sampling-settingseket (hivas-settings > default), atengedi a
-     * per-model reconciler-en (`settingsSchema` szerinti drop/clamp), majd RAKEPZI a natív OpenAI mezokre.
-     * Csak azok a natív mezok kerulnek az input-ra, amik a reconcile utan MEGMARADTAK.
-     *
-     * Ezzel a "melyik modell mit fogad el" tudas a registry `settingsSchema`-jaban (SSoT) el, nem
-     * provider-translatoronkent duplikalva.
-     *
-     * **Atmeneti fallback (szandekos):** ha a registry-bejegyzesnek MEG NINCS `settingsSchema`-ja (regebbi
-     * fsm-verzio, vagy registry-ben nem szereplo modell), a korabbi lokalis `isReasoningModel`-drop marad
-     * ervenyben — igy a FR-047 `514153f` fix NEM regresszal, amig a schema ki nem kerul a fsm-bol. Amint a
-     * schema mindenhol elerheto, ez a fallback (es az `isReasoningModel`) elhagyhato.
-     */
-    applySamplingParams(set) {
-        const source = set.settings ?? this.defaultSettings;
-        const resolved = {
-            ...source,
-            useModel: set.useModel,
-            temperature: (0, fsm_dynamo_1.DyFM_notNull)(source?.temperature) ? source.temperature : this.defaultSettings.temperature,
-            maxTokens: (0, fsm_dynamo_1.DyFM_notNull)(source?.maxTokens) ? source.maxTokens : this.defaultSettings.maxTokens,
-            topP: (0, fsm_dynamo_1.DyFM_notNull)(source?.topP) ? source.topP : this.defaultSettings.topP,
-            frequencyPenalty: (0, fsm_dynamo_1.DyFM_notNull)(source?.frequencyPenalty) ?
-                source.frequencyPenalty : this.defaultSettings.frequencyPenalty,
-            presencePenalty: (0, fsm_dynamo_1.DyFM_notNull)(source?.presencePenalty) ?
-                source.presencePenalty : this.defaultSettings.presencePenalty,
-        };
-        const final = this.reconcileCallSettings(set.useModel, resolved);
-        const modelInfo = ai_1.DyFM_AI_ModelRegistry_Util.findModelInfo(this.getModelRegistry(), set.useModel);
-        const dropSampling = !modelInfo?.settingsSchema && this.isReasoningModel(set.useModel);
-        if ((0, fsm_dynamo_1.DyFM_notNull)(final?.maxTokens)) {
-            set.input.max_completion_tokens = final.maxTokens;
-        }
-        if (dropSampling) {
-            return;
-        }
-        if ((0, fsm_dynamo_1.DyFM_notNull)(final?.temperature)) {
-            set.input.temperature = final.temperature;
-        }
-        if ((0, fsm_dynamo_1.DyFM_notNull)(final?.topP)) {
-            set.input.top_p = final.topP;
-        }
-        if ((0, fsm_dynamo_1.DyFM_notNull)(final?.frequencyPenalty)) {
-            set.input.frequency_penalty = final.frequencyPenalty;
-        }
-        if ((0, fsm_dynamo_1.DyFM_notNull)(final?.presencePenalty)) {
-            set.input.presence_penalty = final.presencePenalty;
-        }
-    }
-}
-exports.DyNTS_OAI_LLM_ServiceBase = DyNTS_OAI_LLM_ServiceBase;
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.DyNTS_OAI_LLM_ServiceBase = void 0;
+const openai_1 = require("openai");
+const open_ai_1 = require("@futdevpro/fsm-dynamo/ai/open-ai");
+const fsm_dynamo_1 = require("@futdevpro/fsm-dynamo");
+const ai_1 = require("@futdevpro/fsm-dynamo/ai");
+const global_settings_const_1 = require("../../../../../_collections/global-settings.const");
+const oai_global_settings_const_1 = require("../_collections/oai-global-settings.const");
+const oai_llm_predefined_requests_conts_1 = require("../_collections/oai-llm-predefined-requests.conts");
+const ai_llm_service_base_1 = require("../../../_services/ai-llm.service-base");
+/**
+ * {
+ *   organization: 'org-XY',
+ *   apiKey: 'sk-XY',
+ *   project: 'proj_XY',
+ * }
+ */
+// Di Dictionary DiModel DiEz DiAz
+class DyNTS_OAI_LLM_ServiceBase extends ai_llm_service_base_1.DyNTS_AI_LLM_ServiceBase {
+    /* readonly defaultErrorUserMsg: string =
+      `We encountered an unhandled Control Service Error, ` +
+      `\nplease contact the responsible development team.`;  */
+    openai;
+    defaultSettings;
+    // Provider properties from DyNTS_AI_Provider_ServiceBase
+    aiProvider = ai_1.DyFM_AI_Provider.OpenAI;
+    capabilities = {
+        chat: true,
+        embeddings: true,
+        imageGeneration: true,
+        vision: true,
+        audioGeneration: true,
+        audioAnalysis: true,
+        functionCalling: true,
+        streaming: true,
+        batchOperations: true,
+        maxContextLength: 128000,
+        supportedModelTypes: ['gpt-4o', 'gpt-4o-mini', 'text-embedding-3-large', 'text-embedding-3-small']
+    };
+    /* get _debugLog(): boolean {
+      return this.defaultSettings.debugLog;
+    } */
+    /* get defaultSystemPrompt(): string {
+      return this.defaultSettings.systemPrompt;
+    } */
+    get defaultModel() {
+        return this.defaultSettings.useModel;
+    }
+    predefinedRequests = oai_llm_predefined_requests_conts_1.DyNTS_OAI_LLMDefaultPredefined_Requests;
+    constructor(set) {
+        super();
+        global_settings_const_1.DyNTS_global_settings.openAi_settings ??= oai_global_settings_const_1.DyNTS_OAI_global_settings;
+        this.openai = new openai_1.OpenAI(set?.config ??
+            {
+                organization: global_settings_const_1.DyNTS_global_settings.env_settings.openAi.organization,
+                apiKey: global_settings_const_1.DyNTS_global_settings.env_settings.openAi.apiKey,
+                project: global_settings_const_1.DyNTS_global_settings.env_settings.openAi.project,
+            });
+        this.defaultSettings = set?.defaultSettings ??
+            oai_global_settings_const_1.DyNTS_OAI_global_settings.defaultSettings ??
+            new open_ai_1.DyFM_OAI_CallSettings();
+        // FR-002 — opcionális per-call cost-event callback átadás a base-osztálynak
+        if (set?.onCostEvent) {
+            this.onCostEvent = set.onCostEvent;
+        }
+    }
+    /**
+     * Inicializálja az OpenAI client-et a megadott config-gal
+     *
+     * Reinitializes the OpenAI client with the provided config
+     */
+    setup(config) {
+        this.openai = new openai_1.OpenAI(config);
+    }
+    /* readonly defaultLogReplacer: string = '...long-context...'; */
+    //#region Ask Questions
+    /**
+     * 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 requestYesNo(set) {
+        set.message += this.predefinedRequests.yesNo.request;
+        const answer = await this.requestSimpleMessage(set);
+        return this.convertAnswerToBoolean(answer);
+    }
+    /** the exact same as {@link requestYesNo} */
+    //yesNoQuestion = this.askYesNoQuestion;
+    /**
+     * Asks the AI to answer a percentage question
+     *
+     * Uses the {@link DyNTS_OAI_LLM_Predefined_Requests.percentageOnly} to ask the question
+     */
+    async requestPercentage(set) {
+        set.message += this.predefinedRequests.percentageOnly;
+        const answer = await this.requestSimpleMessage(set);
+        return this.convertAnswerToNumber(answer, set.message);
+    }
+    /** the exact same as {@link requestPercentage} */
+    //percentageQuestion = this.askPercentageQuestion;
+    /**
+     * 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 askSelectQuestion(
+      set: DyFM_AI_GenericSelect_Input<string>
+    ): Promise<string> {
+      // replace the {{DyNTS_selectOptions}} with the list of options
+      const selectQuestionAddition = this.predefinedRequests.selectRequest.replace(
+        '{{DyNTS_selectOptions}}',
+        this.getTextListAsText(set.selectFrom)
+      );
+      set.message += selectQuestionAddition;
+  
+      let answer = await this.requestSimpleMessage(set);
+      
+      answer = answer.toLocaleUpperCase();
+      
+      for (const item of set.selectFrom) {
+        if (answer.includes(item.toLocaleUpperCase())) return item;
+      }
+  
+      return null;
+    } */
+    /** the exact same as {@link askSelectQuestion} */
+    //selectQuestion = this.askSelectQuestion;
+    /**
+     * 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 requestSelect(set) {
+        const options = this.stringifySelectOptions(set.selectFrom);
+        const selectQuestionAddition = this.predefinedRequests.selectRequest.replace('{{DyNTS_selectOptions}}', this.getTextListAsText(options));
+        set.message += selectQuestionAddition;
+        const answer = await this.requestSimpleMessage(set);
+        return this.convertAnswerToSelectOption(answer, set.message, set.selectFrom);
+    }
+    /** the exact same as {@link requestSelect} */
+    //selectRequest = this.requestSelect;
+    /**
+     * 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 requestMultiselect(set) {
+        const options = this.stringifySelectOptions(set.options);
+        const selectQuestionAddition = this.predefinedRequests.multiselect.replace('{{DyNTS_selectOptions}}', this.getTextListAsText(options));
+        set.message += selectQuestionAddition;
+        let answer = await this.requestSimpleMessage(set);
+        answer = answer.toLocaleUpperCase();
+        return this.convertAnswerToSelectOptions(answer, set.message, set.options);
+        /* const result: T[] = [];
+    
+        for (const item of options) {
+          if (answer.includes(item.toLocaleUpperCase())) {
+            const parsedItem: T | { unparsableResult: string } = DyFM_Object.safeParseJSON<T>(item);
+            if ((parsedItem as { unparsableResult: string }).unparsableResult) {
+              result.push(item as any);
+            } else {
+              result.push(parsedItem as T);
+            }
+              
+          }
+        }
+    
+        if (!result.length && !answer.trim().length) {
+          return { unparsableResult: answer };
+        }
+    
+        return result; */
+    }
+    /** the exact same as {@link askMultipleSelectQuestionWithOptions} */
+    //multipleSelectQuestion = this.askMultipleSelectQuestionWithOptions;
+    /**
+     * 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 requestMultiselect<T>(
+      set: DyFM_AI_GenericMultiSelect_Input<T, DyFM_OAI_CallSettings>
+    ): Promise<T[]> {
+      const selectQuestionAddition = this.predefinedRequests.multiselect.replace(
+        '{{DyNTS_selectOptions}}',
+        this.getTextListAsText(set.options.map(item => `"${JSON.stringify(item)}"`))
+      );
+      set.message += selectQuestionAddition;
+      
+      const answer = await this.requestSimpleMessage(set);
+  
+      return DyFM_Object.safeParseList<T[]>(answer);
+    } */
+    /** the exact same as {@link requestMultipleSelect} */
+    //multipleSelectRequest = this.requestMultipleSelect;
+    /**
+     * 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 requestJSON(set) {
+        set.message += this.predefinedRequests.jsonRequest;
+        const answer = await this.requestSimpleMessage(set);
+        return this.convertAnswerToJSON(answer, set.message);
+    }
+    /** the exact same as {@link askJSONQuestion} */
+    //jsonQuestion = this.askJSONQuestion;
+    /**
+     * 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 requestJSONQuestionWithKeysDescription(set) {
+        const jsonRequestWithKeysDescription = this.predefinedRequests.jsonRequestWithKeysDescription.replace('{{DyNTS_jsonKeysDescription}}', set.keysDescription);
+        set.message += jsonRequestWithKeysDescription;
+        const answer = await this.requestSimpleMessage(set);
+        return this.convertAnswerToJSON(answer, set.message);
+    }
+    /** the exact same as {@link requestJSONQuestionWithKeysDescription} */
+    //jsonQuestionWithKeysDescription = this.askJSONQuestionWithKeysDescription;
+    /**
+     * 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 requestJSONWithExactKeys(set) {
+        const jsonRequestWithExactKeys = this.predefinedRequests.jsonRequestWithExactKeys.replace('{{DyNTS_jsonKeys}}', this.getTextListAsText(set.keys));
+        set.message += jsonRequestWithExactKeys;
+        const answer = await this.requestSimpleMessage(set);
+        return this.convertAnswerToJSON(answer, set.message);
+    }
+    /** the exact same as {@link askJSONQuestionWithExactKeys} */
+    //jsonQuestionWithExactKeys = this.askJSONQuestionWithExactKeys;
+    /**
+     * 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 requestList(
+      set: DyFM_AI_Base_Input<DyFM_OAI_CallSettings>
+    ): Promise<string[]> {
+      set.message += this.predefinedRequests.listRequest;
+  
+      const answer = await this.requestSimpleMessage(set);
+  
+      return this.convertAnswerToList<string>(answer, set.message);
+    } */
+    /** the exact same as {@link askListQuestion} */
+    //listQuestion = this.askListQuestion;
+    /** the exact same as {@link askListQuestion} */
+    //listRequest = this.askListQuestion;
+    async requestList(set) {
+        set.message += this.predefinedRequests.listRequest;
+        const answer = await this.requestSimpleMessage(set);
+        return this.convertAnswerToList(answer, set.message);
+    }
+    /**
+     * Asks the AI to answer a question
+     *
+     * Uses the {@link resolveSimpleUserMessage}
+     */
+    async requestSimpleMessage(set) {
+        this.logQuestion(set);
+        set.conversation ??= [];
+        set.conversation.push({ role: ai_1.DyFM_AI_MessageRole.user, content: set.message });
+        const answer = await this.resolveMessage({
+            ...set,
+            conversation: set.conversation,
+            getFullResponse: false,
+        });
+        this.logAnswer(answer);
+        return answer;
+    }
+    /** the exact same as {@link requestSimpleMessage} */
+    //answer = this.askQuestion;
+    /** the exact same as {@link requestSimpleMessage} */
+    //getQuestionAnswer = this.askQuestion;
+    /** the exact same as {@link requestSimpleMessage} */
+    //simpleQuestion = this.askQuestion;
+    /** the exact same as {@link requestSimpleMessage} */
+    //askSimpleQuestion = this.askQuestion;
+    /**
+     * Resolves a simple user message and returns the answer as string
+     *
+     * Uses the {@link resolveMessage}
+     */
+    /* async resolveSimpleUserMessage(
+      set: DyFM_AI_Base_Input<DyFM_OAI_CallSettings>
+    ): Promise<string> {
+      return this.resolveMessage({
+        conversation: [{ role: DyFM_AI_MessageRole.user, content: set.message }],
+        issuer: set.issuer ?? 'unknown',
+        settings: set.settings ?? this.defaultSettings,
+        getFullResponse: false,
+      }) as Promise<string>;
+    } */
+    /** the exact same as {@link resolveSimpleUserMessage} */
+    //simpleUserMessage = this.resolveSimpleUserMessage;
+    //#endregion
+    /**
+     * Resolves a conversation
+     *
+     * Uses the {@link getMessageCreateInput}
+     */
+    async resolveMessage(set
+    /* {
+      conversation: [{ role: DyFM_AI_MessageRole.user, content: set.message }],
+      issuer: set.issuer ?? 'unknown',
+      settings: set.settings ?? this.defaultSettings,
+      getFullResponse: false,
+    } */
+    /* {
+      conversation: DyFM_AI_Message[],
+      issuer: string,
+      settings?: DyFM_OAI_CallSettings,
+      getFullResponse?: boolean
+    } */
+    ) {
+        try {
+            // FR-002 — callType meghatározás a unshift ELŐTT (a system-message hozzáadás
+            // után már 2+ message lenne, ami a "chat" kategóriát mindig kiváltja).
+            // 1 user-message → 'llm-completion'; több → 'llm-chat'. A 'llm-tool-use'
+            // categoria a tools paraméterek bevezetésekor kerül használatba (jövőbeli FR).
+            const userMessageCount = set.conversation.length;
+            set.conversation.unshift(this.getDefaultSystemMessage(set.settings));
+            // FR-002 — per-call cost-event timing: a tényleges API-call latency mérve
+            const input = this.getMessageCreateInput(set);
+            const start = Date.now();
+            const result = await this.openai.chat.completions.create(input);
+            const durationMs = Date.now() - start;
+            // FR-002 — cost-event emit (safe, no-op ha nincs onCostEvent callback)
+            this.emitCostEvent({
+                callType: userMessageCount === 1 ? 'llm-completion' : 'llm-chat',
+                provider: this.aiProvider,
+                model: String(input.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-OLSB-RM0`,
+            });
+        }
+    }
+    /**
+     * Creates a message create input
+     *
+     * Uses the {@link getDefaultSystemMessage}
+     */
+    getMessageCreateInput(set) {
+        try {
+            const settings = set.settings ?? this.defaultSettings;
+            const useModel = String(settings?.useModel ?? this.defaultModel);
+            const result = {
+                model: useModel,
+                messages: set.conversation,
+            };
+            // FR-048 §3: a sampling-parameterek (+ max_completion_tokens) a per-model `settingsSchema` szerint
+            // kerulnek ra (drop/clamp). KORABBAN ez a NEM-tool ag FELTETEL NELKUL kuldte a sampling-parametereket,
+            // ezert reasoning modellen (GPT-5.x / o-series) 400-zal elhasalt volna — ezt itt zarjuk le.
+            this.applySamplingParams({ input: result, useModel: useModel, settings: set.settings });
+            return result;
+        }
+        catch (error) {
+            throw new fsm_dynamo_1.DyFM_Error({
+                ...this.getDefaultErrorSettings('getMessageCreateSettings', error, set.issuer),
+                errorCode: `${global_settings_const_1.DyNTS_global_settings.systemShortCodeName}|DyNTS-OLSB-RC0`,
+            });
+        }
+    }
+    /**
+     * Teszteli a kapcsolatot az OpenAI API-val
+     *
+     * Tests the connection to OpenAI API
+     */
+    async testConnection(issuer) {
+        try {
+            await this.openai.models.list();
+            return true;
+        }
+        catch (error) {
+            fsm_dynamo_1.DyFM_Log.error('DyNTS_OAI_LLM_ServiceBase', 'testConnection', 'Connection test failed', {
+                error,
+                issuer
+            });
+            return false;
+        }
+    }
+    //#region Function calling (tool use) — FR-047
+    /** OpenAI tool-kepes modell-registry (a base capability-precheck-jehez). */
+    getModelRegistry() {
+        return open_ai_1.DyFM_OAI_Models;
+    }
+    /**
+     * Egy OpenAI-kor a tool-loop-ban: felepiti a natív request-et (system + a teljes beszelgetes
+     * tool-uzenetekkel + tools), meghivja az API-t, es normalizalt DyFM_AI_LLM_Response-t ad vissza
+     * (toolCalls feltoltve, ha a model tool-t akar hivni). FR-002 cost-event: 'llm-tool-use'.
+     */
+    async callModelWithTools(set) {
+        try {
+            const settings = set.settings ?? this.defaultSettings;
+            const messages = [
+                this.toOpenAIMessage(this.getDefaultSystemMessage(settings)),
+                ...set.conversation.map((message) => this.toOpenAIMessage(message)),
+            ];
+            const useModel = settings?.useModel ?? this.defaultModel;
+            const input = {
+                model: useModel,
+                messages: messages,
+            };
+            // FR-048 §3: a sampling-parameterek + `max_completion_tokens` a per-model `settingsSchema` szerint
+            // kerulnek ra. A korabbi lokalis `isReasoningModel`-drop atmeneti fallback-kent bent maradt a
+            // helper-ben (l. `applySamplingParams`), amig a schema ki nem kerul a fsm-bol — igy nincs regresszio.
+            this.applySamplingParams({ input: input, useModel: String(useModel), settings: set.settings });
+            // Ures tools-tomb -> 400 ("tools must have minimum length 1"). Csak akkor kuldjuk, ha van tool.
+            if (set.tools.length) {
+                input.tools = set.tools.map((tool) => this.toOpenAITool(tool));
+                input.tool_choice = 'auto';
+            }
+            const start = Date.now();
+            const result = await this.openai.chat.completions.create(input);
+            const durationMs = Date.now() - start;
+            const message = result.choices[0].message;
+            const toolCalls = (message.tool_calls ?? [])
+                .filter((toolCall) => toolCall.type === 'function')
+                .map((toolCall) => ({
+                id: toolCall.id,
+                name: toolCall.function.name,
+                arguments: this.parseToolArguments(toolCall.function.arguments),
+            }));
+            this.emitCostEvent({
+                callType: 'llm-tool-use',
+                provider: this.aiProvider,
+                model: String(input.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(),
+            });
+            return {
+                content: message.content ?? '',
+                toolCalls: toolCalls.length ? toolCalls : undefined,
+                usage: result.usage ? {
+                    promptTokens: result.usage.prompt_tokens,
+                    completionTokens: result.usage.completion_tokens,
+                    totalTokens: result.usage.total_tokens,
+                } : undefined,
+                model: result.model,
+                finishReason: result.choices[0].finish_reason,
+                stopReason: result.choices[0].finish_reason,
+                rawResponse: result,
+            };
+        }
+        catch (error) {
+            throw new fsm_dynamo_1.DyFM_Error({
+                ...this.getDefaultErrorSettings('callModelWithTools', error, set.issuer),
+                errorCode: `${global_settings_const_1.DyNTS_global_settings.systemShortCodeName}|DyNTS-OLSB-TC0`,
+            });
+        }
+    }
+    /** Agnosztikus tool-definicio → OpenAI ChatCompletionTool. */
+    toOpenAITool(tool) {
+        return {
+            type: 'function',
+            function: {
+                name: tool.name,
+                description: tool.description,
+                parameters: tool.parameters,
+            },
+        };
+    }
+    /**
+     * Agnosztikus DyFM_AI_Message → OpenAI ChatCompletionMessageParam.
+     * Kezeli a tool-result (role:'tool') es a tool-hivo assistant (tool_calls) uzeneteket is.
+     */
+    toOpenAIMessage(message) {
+        if (message.role === ai_1.DyFM_AI_MessageRole.tool) {
+            return {
+                role: 'tool',
+                tool_call_id: message.toolCallId ?? '',
+                content: message.content,
+            };
+        }
+        if (message.role === ai_1.DyFM_AI_MessageRole.assistant && message.toolCalls?.length) {
+            return {
+                role: 'assistant',
+                content: message.content || null,
+                tool_calls: message.toolCalls.map((toolCall) => ({
+                    id: toolCall.id,
+                    type: 'function',
+                    function: {
+                        name: toolCall.name,
+                        arguments: JSON.stringify(toolCall.arguments),
+                    },
+                })),
+            };
+        }
+        return {
+            role: message.role,
+            content: message.content,
+        };
+    }
+    /** Tool-argumentumok parse-olasa (OpenAI JSON-string → object); hibas JSON eseten ures object. */
+    parseToolArguments(raw) {
+        try {
+            return JSON.parse(raw || '{}');
+        }
+        catch {
+            return {};
+        }
+    }
+    /**
+     * ⚠️ **TUL TAG HEURISZTIKA — csak FALLBACK, ne ez legyen az igazsag forrasa.**
+     *
+     * Eredetileg (FR-047) azt felteteleztuk, hogy MINDEN `gpt-5.x` + o-series modell elutasitja a
+     * sampling-parametereket. **Live capture 2026-07-21 ezt MEGCAFOLTA:**
+     *  - elutasit: `gpt-5.5`, `o3-mini`, `o4-mini`
+     *  - **ELFOGADJA**: `gpt-5.4-mini`, `gpt-5.4-nano` (HTTP 200, `reasoning_tokens: 0`)
+     *
+     * Vagyis erre a ket modellre ez a regex **NEMAN kidobna ervenyes parametereket** — halkan rontva a
+     * kimenetet. Ezert az `applySamplingParams` a **registry `settingsSchema`-t reszesiti elonyben**, es ezt
+     * a heurisztikat CSAK akkor hasznalja, ha az adott modellhez nincs schema (regi fsm-verzio / ismeretlen
+     * modell). Amint a populalt schema mindenhol elerheto, ez a metodus elhagyhato.
+     *
+     * Reszletek: `fdp-documentations/plans/ai-mocking-system/CAPTURE-FINDINGS.md` §1.
+     */
+    isReasoningModel(modelId) {
+        return /^gpt-5/.test(modelId) || /^o[0-9]/.test(modelId);
+    }
+    /**
+     * FR-048 §3 — feloldja az agnosztikus sampling-settingseket (hivas-settings > default), atengedi a
+     * per-model reconciler-en (`settingsSchema` szerinti drop/clamp), majd RAKEPZI a natív OpenAI mezokre.
+     * Csak azok a natív mezok kerulnek az input-ra, amik a reconcile utan MEGMARADTAK.
+     *
+     * Ezzel a "melyik modell mit fogad el" tudas a registry `settingsSchema`-jaban (SSoT) el, nem
+     * provider-translatoronkent duplikalva.
+     *
+     * **Atmeneti fallback (szandekos):** ha a registry-bejegyzesnek MEG NINCS `settingsSchema`-ja (regebbi
+     * fsm-verzio, vagy registry-ben nem szereplo modell), a korabbi lokalis `isReasoningModel`-drop marad
+     * ervenyben — igy a FR-047 `514153f` fix NEM regresszal, amig a schema ki nem kerul a fsm-bol. Amint a
+     * schema mindenhol elerheto, ez a fallback (es az `isReasoningModel`) elhagyhato.
+     */
+    applySamplingParams(set) {
+        const source = set.settings ?? this.defaultSettings;
+        const resolved = {
+            ...source,
+            useModel: set.useModel,
+            temperature: (0, fsm_dynamo_1.DyFM_notNull)(source?.temperature) ? source.temperature : this.defaultSettings.temperature,
+            maxTokens: (0, fsm_dynamo_1.DyFM_notNull)(source?.maxTokens) ? source.maxTokens : this.defaultSettings.maxTokens,
+            topP: (0, fsm_dynamo_1.DyFM_notNull)(source?.topP) ? source.topP : this.defaultSettings.topP,
+            frequencyPenalty: (0, fsm_dynamo_1.DyFM_notNull)(source?.frequencyPenalty) ?
+                source.frequencyPenalty : this.defaultSettings.frequencyPenalty,
+            presencePenalty: (0, fsm_dynamo_1.DyFM_notNull)(source?.presencePenalty) ?
+                source.presencePenalty : this.defaultSettings.presencePenalty,
+        };
+        const final = this.reconcileCallSettings(set.useModel, resolved);
+        const modelInfo = ai_1.DyFM_AI_ModelRegistry_Util.findModelInfo(this.getModelRegistry(), set.useModel);
+        const dropSampling = !modelInfo?.settingsSchema && this.isReasoningModel(set.useModel);
+        if ((0, fsm_dynamo_1.DyFM_notNull)(final?.maxTokens)) {
+            set.input.max_completion_tokens = final.maxTokens;
+        }
+        if (dropSampling) {
+            return;
+        }
+        if ((0, fsm_dynamo_1.DyFM_notNull)(final?.temperature)) {
+            set.input.temperature = final.temperature;
+        }
+        if ((0, fsm_dynamo_1.DyFM_notNull)(final?.topP)) {
+            set.input.top_p = final.topP;
+        }
+        if ((0, fsm_dynamo_1.DyFM_notNull)(final?.frequencyPenalty)) {
+            set.input.frequency_penalty = final.frequencyPenalty;
+        }
+        if ((0, fsm_dynamo_1.DyFM_notNull)(final?.presencePenalty)) {
+            set.input.presence_penalty = final.presencePenalty;
+        }
+    }
+}
+exports.DyNTS_OAI_LLM_ServiceBase = DyNTS_OAI_LLM_ServiceBase;
 //# sourceMappingURL=oai-llm.service-base.js.map