@futdevpro/nts-dynamo 1.15.157 → 1.15.160

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

@@ -1,1085 +0,0 @@
-import { OpenAI } from 'openai';
-
-import { DyFM_OAI_Settings, DyFM_OAI_Model, DyFM_OAI_CallSettings, DyFM_OAI_Models } from '@futdevpro/fsm-dynamo/ai/open-ai';
-import { DyFM_AnyError, DyFM_Error, DyFM_Error_Settings, DyFM_Log, DyFM_notNull, DyFM_Object } from '@futdevpro/fsm-dynamo';
-import {
-  DyFM_AI_Message,
-  DyFM_AI_MessageRole,
-  DyFM_AI_Provider,
-  DyFM_AI_ProviderCapabilities,
-  DyFM_AI_CallSettings,
-  DyFM_AI_Config,
-  DyFM_AI_LLM_Response,
-  DyFM_AI_Tool,
-  DyFM_AI_ToolCall,
-  DyFM_AI_ModelInfo,
-  DyFM_AI_ModelRegistry_Util
-} from '@futdevpro/fsm-dynamo/ai';
-
-import { DyNTS_global_settings } from '../../../../../_collections/global-settings.const';
-import { ChatCompletion } from 'openai/resources';
-import { ChatCompletionCreateParamsBase, ChatCompletionMessageParam, ChatCompletionTool } from 'openai/resources/chat/completions';
-import { DyNTS_AI_CostEventCallback } from '../../../_models/interfaces/dynts-ai-cost-event-callback.interface';
-import { DyNTS_OAI_LLM_Predefined_Requests } from '../_models/interfaces/oai-llm-predefined-requests.interface';
-import { DyNTS_OAI_global_settings } from '../_collections/oai-global-settings.const';
-import { DyNTS_OAI_LLMDefaultPredefined_Requests } from '../_collections/oai-llm-predefined-requests.conts';
-import { DyNTS_AI_LLM_ServiceBase } from '../../../_services/ai-llm.service-base';
-import {
-  DyFM_AI_Message_Input,
-  DyFM_AI_GenericSelect_Input,
-  DyFM_AI_GenericMultiSelect_Input,
-  DyFM_AI_JSONKeysDescription_Input,
-  DyFM_AI_JSONExactKeys_Input,
-  DyFM_AI_MultiSelect_Input,
-  DyFM_AI_ConversationBase_Input
-} from '../../../_models/ai-input-interfaces';
-
-
-/**
- * {
- *   organization: 'org-XY',
- *   apiKey: 'sk-XY',
- *   project: 'proj_XY',
- * }
- */
-
-// Di Dictionary DiModel DiEz DiAz
-
-export class DyNTS_OAI_LLM_ServiceBase extends DyNTS_AI_LLM_ServiceBase {
-
-  /* readonly defaultErrorUserMsg: string = 
-    `We encountered an unhandled Control Service Error, ` +
-    `\nplease contact the responsible development team.`;  */
-
-  openai: OpenAI;
-
-  readonly defaultSettings: DyFM_OAI_CallSettings;
-
-  // Provider properties from DyNTS_AI_Provider_ServiceBase
-  readonly aiProvider: DyFM_AI_Provider = DyFM_AI_Provider.OpenAI;
-
-  readonly capabilities: DyFM_AI_ProviderCapabilities = {
-    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;
-  } */
-
-  override get defaultModel(): DyFM_OAI_Model | string {
-    return this.defaultSettings.useModel;
-  }
-
-  predefinedRequests: DyNTS_OAI_LLM_Predefined_Requests = DyNTS_OAI_LLMDefaultPredefined_Requests;
-
-  constructor(
-    set?: DyFM_OAI_Settings & { onCostEvent?: DyNTS_AI_CostEventCallback }
-  ) {
-    super();
-
-    DyNTS_global_settings.openAi_settings ??= DyNTS_OAI_global_settings;
-
-    this.openai = new OpenAI(
-      set?.config ??
-      {
-        organization: DyNTS_global_settings.env_settings.openAi.organization,
-        apiKey: DyNTS_global_settings.env_settings.openAi.apiKey,
-        project: DyNTS_global_settings.env_settings.openAi.project,
-      }
-    );
-
-    this.defaultSettings = set?.defaultSettings ??
-      DyNTS_OAI_global_settings.defaultSettings ??
-      new 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: DyFM_AI_Config): void {
-    this.openai = new 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: DyFM_AI_Message_Input
-  ): Promise<boolean> {
-    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: DyFM_AI_Message_Input
-  ): Promise<number> {
-    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<T>(
-    set: DyFM_AI_GenericSelect_Input<T>
-  ): Promise<T | { unparsableResult: string }> {
-    const options: string[] = 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<T>(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<T>(
-    set: DyFM_AI_GenericMultiSelect_Input<T, DyFM_OAI_CallSettings>
-  ): Promise<T[] | { unparsableResult: string }> {
-    const options: string[] = 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<T>(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<T = any>(
-    set: DyFM_AI_Message_Input<DyFM_OAI_CallSettings>
-  ): Promise<T | { unparsableResult: string }> {
-    set.message += this.predefinedRequests.jsonRequest;
-
-    const answer = await this.requestSimpleMessage(set);
-    
-    return this.convertAnswerToJSON<T>(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<T = any>(
-    set: DyFM_AI_JSONKeysDescription_Input<DyFM_OAI_CallSettings>
-  ): Promise<T | { unparsableResult: string }> {
-    const jsonRequestWithKeysDescription = this.predefinedRequests.jsonRequestWithKeysDescription.replace(
-      '{{DyNTS_jsonKeysDescription}}', 
-      set.keysDescription
-    );
-    set.message += jsonRequestWithKeysDescription;
-
-    const answer = await this.requestSimpleMessage(set);
-
-    return this.convertAnswerToJSON<T>(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<T = any>(
-    set: DyFM_AI_JSONExactKeys_Input<DyFM_OAI_CallSettings>
-  ): Promise<T | { unparsableResult: string }> {
-    const jsonRequestWithExactKeys = this.predefinedRequests.jsonRequestWithExactKeys.replace(
-      '{{DyNTS_jsonKeys}}', 
-      this.getTextListAsText(set.keys)
-    );
-    set.message += jsonRequestWithExactKeys;
-
-    const answer = await this.requestSimpleMessage(set);
-
-    return this.convertAnswerToJSON<T>(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<T = any>(
-    set: DyFM_AI_Message_Input<DyFM_OAI_CallSettings>
-  ): Promise<T[] | { unparsableResult: string }> {
-    set.message += this.predefinedRequests.listRequest;
-
-    const answer = await this.requestSimpleMessage(set);
-
-    return this.convertAnswerToList<T>(answer, set.message);
-  }
-  
-  /**
-   * Asks the AI to answer a question
-   * 
-   * Uses the {@link resolveSimpleUserMessage}
-   */
-  async requestSimpleMessage(
-    set: DyFM_AI_Message_Input<DyFM_OAI_CallSettings>
-  ): Promise<string> {
-    this.logQuestion(set);
-
-    set.conversation ??= [];
-    set.conversation.push({ role: DyFM_AI_MessageRole.user, content: set.message });
-
-    const answer: string = await this.resolveMessage({
-      ...set,
-      conversation: set.conversation,
-      getFullResponse: false,
-    }) as string;
-
-    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: DyFM_AI_ConversationBase_Input<DyFM_OAI_CallSettings>
-    /* {
-      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
-    } */
-  ): Promise<string | ChatCompletion> {
-    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: number = 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: ChatCompletionCreateParamsBase = this.getMessageCreateInput(set);
-      const start: number = Date.now();
-      const result: ChatCompletion = await this.openai.chat.completions.create(
-        input,
-      ) as ChatCompletion;
-      const durationMs: number = 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 DyFM_Error({
-        ...this.getDefaultErrorSettings('resolveConversation', error, set.issuer),
-
-        errorCode: `${DyNTS_global_settings.systemShortCodeName}|DyNTS-OLSB-RM0`,
-      });
-    }
-  }
-
-  /**
-   * Creates a message create input
-   * 
-   * Uses the {@link getDefaultSystemMessage}
-   */
-  protected getMessageCreateInput(
-    set: {
-      conversation: DyFM_AI_Message[],
-      issuer: string,
-      settings?: DyFM_OAI_CallSettings
-    }
-  ): ChatCompletionCreateParamsBase {
-    try {
-      const settings = set.settings ?? this.defaultSettings;
-
-      const useModel: string = String(settings?.useModel ?? this.defaultModel);
-
-      const result: ChatCompletionCreateParamsBase = {
-        model: useModel,
-        messages: set.conversation as ChatCompletionMessageParam[],
-      };
-
-      // 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 DyFM_Error({
-        ...this.getDefaultErrorSettings('getMessageCreateSettings', error, set.issuer),
-        
-        errorCode: `${DyNTS_global_settings.systemShortCodeName}|DyNTS-OLSB-RC0`,
-      });
-    }
-  }
-
-  /**
-   * Teszteli a kapcsolatot az OpenAI API-val
-   * 
-   * Tests the connection to OpenAI API
-   */
-  async testConnection(issuer: string): Promise<boolean> {
-    try {
-      await this.openai.models.list();
-      return true;
-    } catch (error) {
-      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). */
-  protected override getModelRegistry(): DyFM_AI_ModelInfo[] {
-    return 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'.
-   */
-  protected override async callModelWithTools(
-    set: {
-      conversation: DyFM_AI_Message[];
-      tools: DyFM_AI_Tool[];
-      settings?: DyFM_OAI_CallSettings;
-      issuer: string;
-    }
-  ): Promise<DyFM_AI_LLM_Response> {
-    try {
-      const settings: DyFM_OAI_CallSettings = set.settings ?? this.defaultSettings;
-
-      const messages: ChatCompletionMessageParam[] = [
-        this.toOpenAIMessage(this.getDefaultSystemMessage(settings)),
-        ...set.conversation.map((message: DyFM_AI_Message) => this.toOpenAIMessage(message)),
-      ];
-
-      const useModel: DyFM_OAI_Model | string = settings?.useModel ?? this.defaultModel;
-
-      const input: ChatCompletionCreateParamsBase = {
-        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: DyFM_AI_Tool) => this.toOpenAITool(tool));
-        input.tool_choice = 'auto';
-      }
-
-      const start: number = Date.now();
-      const result: ChatCompletion = await this.openai.chat.completions.create(input) as ChatCompletion;
-      const durationMs: number = Date.now() - start;
-
-      const message = result.choices[0].message;
-
-      const toolCalls: DyFM_AI_ToolCall[] = (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 DyFM_Error({
-        ...this.getDefaultErrorSettings('callModelWithTools', error, set.issuer),
-        errorCode: `${DyNTS_global_settings.systemShortCodeName}|DyNTS-OLSB-TC0`,
-      });
-    }
-  }
-
-  /** Agnosztikus tool-definicio → OpenAI ChatCompletionTool. */
-  protected toOpenAITool(tool: DyFM_AI_Tool): ChatCompletionTool {
-    return {
-      type: 'function',
-      function: {
-        name: tool.name,
-        description: tool.description,
-        parameters: tool.parameters as Record<string, unknown>,
-      },
-    };
-  }
-
-  /**
-   * Agnosztikus DyFM_AI_Message → OpenAI ChatCompletionMessageParam.
-   * Kezeli a tool-result (role:'tool') es a tool-hivo assistant (tool_calls) uzeneteket is.
-   */
-  protected toOpenAIMessage(message: DyFM_AI_Message): ChatCompletionMessageParam {
-    if (message.role === DyFM_AI_MessageRole.tool) {
-      return {
-        role: 'tool',
-        tool_call_id: message.toolCallId ?? '',
-        content: message.content,
-      };
-    }
-
-    if (message.role === DyFM_AI_MessageRole.assistant && message.toolCalls?.length) {
-      return {
-        role: 'assistant',
-        content: message.content || null,
-        tool_calls: message.toolCalls.map((toolCall: DyFM_AI_ToolCall) => ({
-          id: toolCall.id,
-          type: 'function' as const,
-          function: {
-            name: toolCall.name,
-            arguments: JSON.stringify(toolCall.arguments),
-          },
-        })),
-      };
-    }
-
-    return {
-      role: message.role as 'system' | 'user' | 'assistant',
-      content: message.content,
-    };
-  }
-
-  /** Tool-argumentumok parse-olasa (OpenAI JSON-string → object); hibas JSON eseten ures object. */
-  protected parseToolArguments(raw: string): Record<string, unknown> {
-    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.
-   */
-  protected isReasoningModel(modelId: string): boolean {
-    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.
-   */
-  protected applySamplingParams(
-    set: {
-      input: ChatCompletionCreateParamsBase,
-      useModel: string,
-      settings?: DyFM_OAI_CallSettings,
-    }
-  ): void {
-    const source: DyFM_OAI_CallSettings = set.settings ?? this.defaultSettings;
-
-    const resolved: DyFM_OAI_CallSettings = {
-      ...source,
-      useModel: set.useModel,
-      temperature: DyFM_notNull(source?.temperature) ? source.temperature : this.defaultSettings.temperature,
-      maxTokens: DyFM_notNull(source?.maxTokens) ? source.maxTokens : this.defaultSettings.maxTokens,
-      topP: DyFM_notNull(source?.topP) ? source.topP : this.defaultSettings.topP,
-      frequencyPenalty: DyFM_notNull(source?.frequencyPenalty) ?
-        source.frequencyPenalty : this.defaultSettings.frequencyPenalty,
-      presencePenalty: DyFM_notNull(source?.presencePenalty) ?
-        source.presencePenalty : this.defaultSettings.presencePenalty,
-    };
-
-    const final: DyFM_OAI_CallSettings = this.reconcileCallSettings(set.useModel, resolved);
-
-    const modelInfo: DyFM_AI_ModelInfo = DyFM_AI_ModelRegistry_Util.findModelInfo(
-      this.getModelRegistry(),
-      set.useModel
-    );
-    const dropSampling: boolean = !modelInfo?.settingsSchema && this.isReasoningModel(set.useModel);
-
-    if (DyFM_notNull(final?.maxTokens)) {
-      set.input.max_completion_tokens = final.maxTokens;
-    }
-
-    if (dropSampling) {
-      return;
-    }
-
-    if (DyFM_notNull(final?.temperature)) {
-      set.input.temperature = final.temperature;
-    }
-    if (DyFM_notNull(final?.topP)) {
-      set.input.top_p = final.topP;
-    }
-    if (DyFM_notNull(final?.frequencyPenalty)) {
-      set.input.frequency_penalty = final.frequencyPenalty;
-    }
-    if (DyFM_notNull(final?.presencePenalty)) {
-      set.input.presence_penalty = final.presencePenalty;
-    }
-  }
-
-  //#endregion
-
-//  async askJSONListQuestion(
-//    question: string,
-//    issuer: string,
-//    settings?: DyFM_OAI_CallSettings,
-//    debugLog?: boolean,
-//    /** this is used to readably replace too long contents to eg '...' in logs */
-//    replaceThisInLog?: string,
-//  ): Promise<{ key: string, input: string }[]> {
-//    question += this.predefinedRequests.jsonListRequest;
-//
-//    const answer = await this.askQuestion(question, issuer, settings, debugLog, replaceThisInLog);
-//
-//    return DyFM_Object.safeParseList<{ key: string, input: string }[]>(answer);
-//  }
-
-  //#region Tools
-
-  /**
-   * Logs the question if the debugLog is true
-   */
-  /* protected logQuestion(
-    set: DyFM_AI_Base_Input<DyFM_OAI_CallSettings>
-  ): void {
-    if (set.settings?.debugLog ?? this._debugLog) {
-      console.log('\n - ', set.message);
-    }
-  } */
-
-  /**
-   * olvasható mondatszerű-listaszerű formába teszi a listaelemeket
-   * pl.: ['a', 'b', 'c'] -> '"a", "b" or "c"'
-   */
-  /* getTextListAsText(list: string[]): string {
-    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(', ');
-  } */
-
-  /* protected getDefaultSystemMessage(settings: DyFM_OAI_CallSettings): DyFM_AI_Message {
-    return {
-      role: DyFM_AI_MessageRole.system,
-      content: settings?.systemPrompt || this.defaultSystemPrompt,
-    };
-  } */
-
-  /* protected validateConversation(conversation: DyFM_AI_Message[]): void {
-    conversation.forEach((message: DyFM_AI_Message, index: number) => {
-      if (!message.role) {
-        throw new DyFM_Error({
-          message: `Message has no role at index ${index}`,
-          additionalContent: {
-            invalidMessage: message,
-            conversation: conversation,
-          }
-        });
-      }
-
-      if (!message.content) {
-        throw new DyFM_Error({
-          message: `Message has no content at index ${index}`,
-          additionalContent: {
-            invalidMessage: message,
-            conversation: conversation,
-          }
-        });
-      }
-    });
-  } */
-  
-  /* protected getDefaultErrorSettings(
-    fnName: string, 
-    error: DyFM_AnyError,
-    issuer: string
-  ): DyFM_Error_Settings {
-    return {
-      status: (error as DyFM_Error)?.___status ?? 500,
-      message: (error as Error)?.message ??
-        (error as DyFM_Error)?._message ??
-        `${fnName} was UNSUCCESSFUL (${DyNTS_global_settings.systemShortCodeName})`,
-      addECToUserMsg: !(error as DyFM_Error)?.__userMessage,
-      userMessage: (error as DyFM_Error)?.__userMessage ?? this.defaultErrorUserMsg,
-      issuer: issuer,
-      issuerService: this.constructor?.name,
-      error: error,
-    };
-  } */
-
-  //#endregion
-
-  //#region Provider Methods (from DyNTS_AI_Provider_ServiceBase)
-
-  //#endregion
-
-  //#region Abstract LLM Methods (from DyNTS_AI_LLM_ServiceBase)
-
-  /**
-   * Meghívja az LLM-et system és user message-szel
-   * 
-   * Calls the LLM with system and user messages
-   */
-  /* async callLLM(
-    systemMessage: string,
-    userMessage: string,
-    settings?: DyFM_AI_CallSettings,
-    issuer?: string
-  ): Promise<string> {
-    const result = await this.resolveMessage({
-      conversation: [
-        { role: DyFM_AI_MessageRole.system, content: systemMessage },
-        { role: DyFM_AI_MessageRole.user, content: userMessage }
-      ],
-      issuer: issuer ?? 'system',
-      settings: this.convertToOAISettings(settings),
-      getFullResponse: false
-    });
-    
-    if (typeof result === 'string') {
-      return result;
-    }
-    return '';
-  } */
-
-  /**
-   * Meghívja az LLM-et üzenet history-val
-   * 
-   * Calls the LLM with message history
-   */
-  /* async callLLMWithHistory(
-    messages: DyFM_AI_Message[],
-    settings?: DyFM_AI_CallSettings,
-    issuer?: string
-  ): Promise<string> {
-    const result = await this.resolveMessage({
-      conversation: messages,
-      issuer: issuer ?? 'system',
-      settings: this.convertToOAISettings(settings),
-      getFullResponse: false
-    });
-    
-    if (typeof result === 'string') {
-      return result;
-    }
-    return '';
-  } */
-
-  /**
-   * Meghívja az LLM-et és visszaadja a raw response-t
-   * 
-   * Calls the LLM and returns raw response
-   */
-  /* async callLLMRaw(
-    messages: DyFM_AI_Message[],
-    settings?: DyFM_AI_CallSettings,
-    issuer?: string
-  ): Promise<DyFM_AI_LLM_Response> {
-    const result = await this.resolveMessage({
-      conversation: messages,
-      issuer: issuer ?? 'system',
-      settings: this.convertToOAISettings(settings),
-      getFullResponse: true
-    }) as ChatCompletion;
-
-    return {
-      content: result.choices[0].message.content,
-      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,
-      rawResponse: result
-    };
-  } */
-
-  /**
-   * Küld egy egyszerű üzenetet az LLM-nek
-   * 
-   * Sends a simple message to the LLM
-   */
-  /* async sendMessage(set: DyFM_AI_Base_Input<DyFM_OAI_CallSettings>): Promise<string> {
-    return await this.resolveSimpleUserMessage({
-      message: set.message,
-      issuer: set.issuer,
-      settings: set.settings ? this.convertToOAISettings(set.settings) : undefined
-    });
-  } */
-
-  /**
-   * Kérdez egy kérdést és JSON választ vár exact keys-szel
-   * 
-   * Asks a question and expects JSON response with exact keys
-   */
-  /* async requestJSONWithExactKeys<T = any>(
-    set: DyFM_AI_JSONExactKeys_Input
-  ): Promise<T> {
-    const answer = await this.askJSONQuestionWithExactKeys({
-      question: set.question,
-      keys: set.keys,
-      issuer: set.issuer,
-      settings: set.settings ? this.convertToOAISettings(set.settings) : undefined,
-      debugLog: set.debugLog,
-      replaceThisInLog: set.replaceThisInLog
-    });
-
-    if ('unparsableResult' in answer) {
-      throw new DyFM_Error({
-        message: 'Invalid JSON response from AI',
-        additionalContent: { answer },
-        userMessage: 'Failed to parse AI response'
-      });
-    }
-
-    return answer as T;
-  } */
-
-  /**
-   * Kérdez egy kérdést és több választ vár
-   * 
-   * Asks a question and expects multiple responses
-   */
-  /* async requestMultiselect<T = any>(
-    set: DyFM_AI_GenericMultiSelect_Input<T>
-  ): Promise<T[]> {
-    const answer = await this.requestMultipleSelect({
-      question: set.message,
-      options: set.options,
-      issuer: set.issuer,
-      settings: set.settings ? this.convertToOAISettings(set.settings) : undefined,
-      debugLog: set.debugLog,
-      replaceThisInLog: set.replaceThisInLog
-    });
-
-    return answer as T[];
-  } */
-
-  /**
-   * Konvertálja a generic AI settings-et OpenAI specifikus settings-re
-   * 
-   * Converts generic AI settings to OpenAI-specific settings
-   */
-  /* private convertToOAISettings(settings?: DyFM_AI_CallSettings): DyFM_OAI_CallSettings {
-    if (!settings) {
-      return undefined;
-    } 
-
-    const oaiSettings = new DyFM_OAI_CallSettings();
-    
-    if (settings.systemPrompt !== undefined) { 
-      oaiSettings.systemPrompt = settings.systemPrompt;
-    }
-
-    if (settings.useModel !== undefined) { 
-      oaiSettings.useModel = settings.useModel as DyFM_OAI_Model;
-    }
-
-    if (settings.project !== undefined) { 
-      oaiSettings.project = settings.project;
-    }
-
-    if (settings.debugLog !== undefined)  {
-      oaiSettings.debugLog = settings.debugLog;
-    }
-
-    if (settings.temperature !== undefined) { 
-      oaiSettings.temperature = settings.temperature;
-    }
-
-    if (settings.maxTokens !== undefined)  {
-      oaiSettings.maxTokens = settings.maxTokens;
-    }
-
-    if (settings.topP !== undefined) { 
-      oaiSettings.topP = settings.topP;
-    }
-
-    if (settings.frequencyPenalty !== undefined) { 
-      oaiSettings.frequencyPenalty = settings.frequencyPenalty;
-    }
-
-    if (settings.presencePenalty !== undefined) { 
-      oaiSettings.presencePenalty = settings.presencePenalty;
-    }
-
-    return oaiSettings;
-  } */
-
-  //#endregion
-}