@futdevpro/nts-dynamo 1.15.36 → 1.15.38

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

@@ -1,862 +1,1011 @@
-import { OpenAI } from 'openai';
-
-import { DyFM_OAI_Settings, DyFM_OAI_Model, DyFM_OAI_CallSettings } 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
-} from '@futdevpro/fsm-dynamo/ai';
-
-import { DyNTS_global_settings } from '../../../../../_collections/global-settings.const';
-import { ChatCompletion } from 'openai/resources';
-import { ChatCompletionCreateParamsBase, ChatCompletionMessageParam } 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 result: ChatCompletionCreateParamsBase = {
-        model: settings?.useModel ?? this.defaultModel,
-        messages: set.conversation as ChatCompletionMessageParam[],
-      };
-
-      result.temperature = DyFM_notNull(settings?.temperature) ? 
-        settings.temperature : 
-        this.defaultSettings.temperature;
-      
-      /* result.max_completion_tokens = DyFM_notNull(settings?.maxTokens) ? 
-        settings.maxTokens : 
-        this.defaultSettings.maxTokens; */
-      result.max_completion_tokens = DyFM_notNull(settings?.maxTokens) ? 
-        settings.maxTokens : 
-        this.defaultSettings.maxTokens;
-
-      result.top_p = DyFM_notNull(settings?.topP) ? 
-        settings.topP : 
-        this.defaultSettings.topP;
-
-      result.frequency_penalty = DyFM_notNull(settings?.frequencyPenalty) ? 
-        settings.frequencyPenalty : 
-        this.defaultSettings.frequencyPenalty;
-
-      result.presence_penalty = DyFM_notNull(settings?.presencePenalty) ? 
-        settings.presencePenalty : 
-        this.defaultSettings.presencePenalty;
-
-      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;
-    }
-  }
-
-//  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
-}
+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
+} 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 result: ChatCompletionCreateParamsBase = {
+        model: settings?.useModel ?? this.defaultModel,
+        messages: set.conversation as ChatCompletionMessageParam[],
+      };
+
+      result.temperature = DyFM_notNull(settings?.temperature) ? 
+        settings.temperature : 
+        this.defaultSettings.temperature;
+      
+      /* result.max_completion_tokens = DyFM_notNull(settings?.maxTokens) ? 
+        settings.maxTokens : 
+        this.defaultSettings.maxTokens; */
+      result.max_completion_tokens = DyFM_notNull(settings?.maxTokens) ? 
+        settings.maxTokens : 
+        this.defaultSettings.maxTokens;
+
+      result.top_p = DyFM_notNull(settings?.topP) ? 
+        settings.topP : 
+        this.defaultSettings.topP;
+
+      result.frequency_penalty = DyFM_notNull(settings?.frequencyPenalty) ? 
+        settings.frequencyPenalty : 
+        this.defaultSettings.frequencyPenalty;
+
+      result.presence_penalty = DyFM_notNull(settings?.presencePenalty) ? 
+        settings.presencePenalty : 
+        this.defaultSettings.presencePenalty;
+
+      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 input: ChatCompletionCreateParamsBase = {
+        model: settings?.useModel ?? this.defaultModel,
+        messages: messages,
+        temperature: DyFM_notNull(settings?.temperature) ? settings.temperature : this.defaultSettings.temperature,
+        max_completion_tokens: DyFM_notNull(settings?.maxTokens) ? settings.maxTokens : this.defaultSettings.maxTokens,
+        top_p: DyFM_notNull(settings?.topP) ? settings.topP : this.defaultSettings.topP,
+        frequency_penalty: DyFM_notNull(settings?.frequencyPenalty) ? settings.frequencyPenalty : this.defaultSettings.frequencyPenalty,
+        presence_penalty: DyFM_notNull(settings?.presencePenalty) ? settings.presencePenalty : this.defaultSettings.presencePenalty,
+        tools: set.tools.map((tool: DyFM_AI_Tool) => this.toOpenAITool(tool)),
+        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 {};
+    }
+  }
+
+  //#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
+}