@futdevpro/nts-dynamo 1.15.68 → 1.15.71

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

@@ -1,202 +1,202 @@
-import { OpenAI } from 'openai';
-import { DyFM_OAI_Settings, DyFM_OAI_Model, DyFM_OAI_CallSettings } from '@futdevpro/fsm-dynamo/ai/open-ai';
-import { DyFM_AI_Message, DyFM_AI_Provider, DyFM_AI_ProviderCapabilities, DyFM_AI_Config, DyFM_AI_LLM_Response, DyFM_AI_Tool, DyFM_AI_ModelInfo } from '@futdevpro/fsm-dynamo/ai';
-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_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_ConversationBase_Input } from '../../../_models/ai-input-interfaces';
-/**
- * {
- *   organization: 'org-XY',
- *   apiKey: 'sk-XY',
- *   project: 'proj_XY',
- * }
- */
-export declare class DyNTS_OAI_LLM_ServiceBase extends DyNTS_AI_LLM_ServiceBase {
-    openai: OpenAI;
-    readonly defaultSettings: DyFM_OAI_CallSettings;
-    readonly aiProvider: DyFM_AI_Provider;
-    readonly capabilities: DyFM_AI_ProviderCapabilities;
-    get defaultModel(): DyFM_OAI_Model | string;
-    predefinedRequests: DyNTS_OAI_LLM_Predefined_Requests;
-    constructor(set?: DyFM_OAI_Settings & {
-        onCostEvent?: DyNTS_AI_CostEventCallback;
-    });
-    /**
-     * Inicializálja az OpenAI client-et a megadott config-gal
-     *
-     * Reinitializes the OpenAI client with the provided config
-     */
-    setup(config: DyFM_AI_Config): void;
-    /**
-     * 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
-     */
-    requestYesNo(set: DyFM_AI_Message_Input): Promise<boolean>;
-    /** the exact same as {@link requestYesNo} */
-    /**
-     * Asks the AI to answer a percentage question
-     *
-     * Uses the {@link DyNTS_OAI_LLM_Predefined_Requests.percentageOnly} to ask the question
-     */
-    requestPercentage(set: DyFM_AI_Message_Input): Promise<number>;
-    /** the exact same as {@link requestPercentage} */
-    /**
-     * 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
-     */
-    /** the exact same as {@link 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
-     */
-    requestSelect<T>(set: DyFM_AI_GenericSelect_Input<T>): Promise<T | {
-        unparsableResult: string;
-    }>;
-    /** the exact same as {@link 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
-     */
-    requestMultiselect<T>(set: DyFM_AI_GenericMultiSelect_Input<T, DyFM_OAI_CallSettings>): Promise<T[] | {
-        unparsableResult: string;
-    }>;
-    /** the exact same as {@link 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
-     */
-    /** the exact same as {@link 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})
-     */
-    requestJSON<T = any>(set: DyFM_AI_Message_Input<DyFM_OAI_CallSettings>): Promise<T | {
-        unparsableResult: string;
-    }>;
-    /** the exact same as {@link 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})
-     */
-    requestJSONQuestionWithKeysDescription<T = any>(set: DyFM_AI_JSONKeysDescription_Input<DyFM_OAI_CallSettings>): Promise<T | {
-        unparsableResult: string;
-    }>;
-    /** the exact same as {@link requestJSONQuestionWithKeysDescription} */
-    /**
-     * 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})
-     */
-    requestJSONWithExactKeys<T = any>(set: DyFM_AI_JSONExactKeys_Input<DyFM_OAI_CallSettings>): Promise<T | {
-        unparsableResult: string;
-    }>;
-    /** the exact same as {@link 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})
-     */
-    /** the exact same as {@link askListQuestion} */
-    /** the exact same as {@link askListQuestion} */
-    requestList<T = any>(set: DyFM_AI_Message_Input<DyFM_OAI_CallSettings>): Promise<T[] | {
-        unparsableResult: string;
-    }>;
-    /**
-     * Asks the AI to answer a question
-     *
-     * Uses the {@link resolveSimpleUserMessage}
-     */
-    requestSimpleMessage(set: DyFM_AI_Message_Input<DyFM_OAI_CallSettings>): Promise<string>;
-    /** the exact same as {@link requestSimpleMessage} */
-    /** the exact same as {@link requestSimpleMessage} */
-    /** the exact same as {@link requestSimpleMessage} */
-    /** the exact same as {@link requestSimpleMessage} */
-    /**
-     * Resolves a simple user message and returns the answer as string
-     *
-     * Uses the {@link resolveMessage}
-     */
-    /** the exact same as {@link resolveSimpleUserMessage} */
-    /**
-     * Resolves a conversation
-     *
-     * Uses the {@link getMessageCreateInput}
-     */
-    resolveMessage(set: DyFM_AI_ConversationBase_Input<DyFM_OAI_CallSettings>): Promise<string | ChatCompletion>;
-    /**
-     * Creates a message create input
-     *
-     * Uses the {@link getDefaultSystemMessage}
-     */
-    protected getMessageCreateInput(set: {
-        conversation: DyFM_AI_Message[];
-        issuer: string;
-        settings?: DyFM_OAI_CallSettings;
-    }): ChatCompletionCreateParamsBase;
-    /**
-     * Teszteli a kapcsolatot az OpenAI API-val
-     *
-     * Tests the connection to OpenAI API
-     */
-    testConnection(issuer: string): Promise<boolean>;
-    /** OpenAI tool-kepes modell-registry (a base capability-precheck-jehez). */
-    protected getModelRegistry(): DyFM_AI_ModelInfo[];
-    /**
-     * 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 callModelWithTools(set: {
-        conversation: DyFM_AI_Message[];
-        tools: DyFM_AI_Tool[];
-        settings?: DyFM_OAI_CallSettings;
-        issuer: string;
-    }): Promise<DyFM_AI_LLM_Response>;
-    /** Agnosztikus tool-definicio → OpenAI ChatCompletionTool. */
-    protected toOpenAITool(tool: DyFM_AI_Tool): ChatCompletionTool;
-    /**
-     * 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;
-    /** Tool-argumentumok parse-olasa (OpenAI JSON-string → object); hibas JSON eseten ures object. */
-    protected parseToolArguments(raw: string): Record<string, unknown>;
-    /**
-     * Reasoning modell-e (GPT-5.x sor vagy o-series, pl. o1/o3/o4)? Ezek elutasitjak a
-     * sampling-parametereket (temperature != 1, top_p, frequency/presence_penalty). A `gpt-4o`
-     * NEM reasoning (a 'gpt-5' prefix nem illeszti, 'o'-prefix sem).
-     */
-    protected isReasoningModel(modelId: string): boolean;
-}
+import { OpenAI } from 'openai';
+import { DyFM_OAI_Settings, DyFM_OAI_Model, DyFM_OAI_CallSettings } from '@futdevpro/fsm-dynamo/ai/open-ai';
+import { DyFM_AI_Message, DyFM_AI_Provider, DyFM_AI_ProviderCapabilities, DyFM_AI_Config, DyFM_AI_LLM_Response, DyFM_AI_Tool, DyFM_AI_ModelInfo } from '@futdevpro/fsm-dynamo/ai';
+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_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_ConversationBase_Input } from '../../../_models/ai-input-interfaces';
+/**
+ * {
+ *   organization: 'org-XY',
+ *   apiKey: 'sk-XY',
+ *   project: 'proj_XY',
+ * }
+ */
+export declare class DyNTS_OAI_LLM_ServiceBase extends DyNTS_AI_LLM_ServiceBase {
+    openai: OpenAI;
+    readonly defaultSettings: DyFM_OAI_CallSettings;
+    readonly aiProvider: DyFM_AI_Provider;
+    readonly capabilities: DyFM_AI_ProviderCapabilities;
+    get defaultModel(): DyFM_OAI_Model | string;
+    predefinedRequests: DyNTS_OAI_LLM_Predefined_Requests;
+    constructor(set?: DyFM_OAI_Settings & {
+        onCostEvent?: DyNTS_AI_CostEventCallback;
+    });
+    /**
+     * Inicializálja az OpenAI client-et a megadott config-gal
+     *
+     * Reinitializes the OpenAI client with the provided config
+     */
+    setup(config: DyFM_AI_Config): void;
+    /**
+     * 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
+     */
+    requestYesNo(set: DyFM_AI_Message_Input): Promise<boolean>;
+    /** the exact same as {@link requestYesNo} */
+    /**
+     * Asks the AI to answer a percentage question
+     *
+     * Uses the {@link DyNTS_OAI_LLM_Predefined_Requests.percentageOnly} to ask the question
+     */
+    requestPercentage(set: DyFM_AI_Message_Input): Promise<number>;
+    /** the exact same as {@link requestPercentage} */
+    /**
+     * 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
+     */
+    /** the exact same as {@link 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
+     */
+    requestSelect<T>(set: DyFM_AI_GenericSelect_Input<T>): Promise<T | {
+        unparsableResult: string;
+    }>;
+    /** the exact same as {@link 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
+     */
+    requestMultiselect<T>(set: DyFM_AI_GenericMultiSelect_Input<T, DyFM_OAI_CallSettings>): Promise<T[] | {
+        unparsableResult: string;
+    }>;
+    /** the exact same as {@link 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
+     */
+    /** the exact same as {@link 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})
+     */
+    requestJSON<T = any>(set: DyFM_AI_Message_Input<DyFM_OAI_CallSettings>): Promise<T | {
+        unparsableResult: string;
+    }>;
+    /** the exact same as {@link 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})
+     */
+    requestJSONQuestionWithKeysDescription<T = any>(set: DyFM_AI_JSONKeysDescription_Input<DyFM_OAI_CallSettings>): Promise<T | {
+        unparsableResult: string;
+    }>;
+    /** the exact same as {@link requestJSONQuestionWithKeysDescription} */
+    /**
+     * 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})
+     */
+    requestJSONWithExactKeys<T = any>(set: DyFM_AI_JSONExactKeys_Input<DyFM_OAI_CallSettings>): Promise<T | {
+        unparsableResult: string;
+    }>;
+    /** the exact same as {@link 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})
+     */
+    /** the exact same as {@link askListQuestion} */
+    /** the exact same as {@link askListQuestion} */
+    requestList<T = any>(set: DyFM_AI_Message_Input<DyFM_OAI_CallSettings>): Promise<T[] | {
+        unparsableResult: string;
+    }>;
+    /**
+     * Asks the AI to answer a question
+     *
+     * Uses the {@link resolveSimpleUserMessage}
+     */
+    requestSimpleMessage(set: DyFM_AI_Message_Input<DyFM_OAI_CallSettings>): Promise<string>;
+    /** the exact same as {@link requestSimpleMessage} */
+    /** the exact same as {@link requestSimpleMessage} */
+    /** the exact same as {@link requestSimpleMessage} */
+    /** the exact same as {@link requestSimpleMessage} */
+    /**
+     * Resolves a simple user message and returns the answer as string
+     *
+     * Uses the {@link resolveMessage}
+     */
+    /** the exact same as {@link resolveSimpleUserMessage} */
+    /**
+     * Resolves a conversation
+     *
+     * Uses the {@link getMessageCreateInput}
+     */
+    resolveMessage(set: DyFM_AI_ConversationBase_Input<DyFM_OAI_CallSettings>): Promise<string | ChatCompletion>;
+    /**
+     * Creates a message create input
+     *
+     * Uses the {@link getDefaultSystemMessage}
+     */
+    protected getMessageCreateInput(set: {
+        conversation: DyFM_AI_Message[];
+        issuer: string;
+        settings?: DyFM_OAI_CallSettings;
+    }): ChatCompletionCreateParamsBase;
+    /**
+     * Teszteli a kapcsolatot az OpenAI API-val
+     *
+     * Tests the connection to OpenAI API
+     */
+    testConnection(issuer: string): Promise<boolean>;
+    /** OpenAI tool-kepes modell-registry (a base capability-precheck-jehez). */
+    protected getModelRegistry(): DyFM_AI_ModelInfo[];
+    /**
+     * 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 callModelWithTools(set: {
+        conversation: DyFM_AI_Message[];
+        tools: DyFM_AI_Tool[];
+        settings?: DyFM_OAI_CallSettings;
+        issuer: string;
+    }): Promise<DyFM_AI_LLM_Response>;
+    /** Agnosztikus tool-definicio → OpenAI ChatCompletionTool. */
+    protected toOpenAITool(tool: DyFM_AI_Tool): ChatCompletionTool;
+    /**
+     * 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;
+    /** Tool-argumentumok parse-olasa (OpenAI JSON-string → object); hibas JSON eseten ures object. */
+    protected parseToolArguments(raw: string): Record<string, unknown>;
+    /**
+     * Reasoning modell-e (GPT-5.x sor vagy o-series, pl. o1/o3/o4)? Ezek elutasitjak a
+     * sampling-parametereket (temperature != 1, top_p, frequency/presence_penalty). A `gpt-4o`
+     * NEM reasoning (a 'gpt-5' prefix nem illeszti, 'o'-prefix sem).
+     */
+    protected isReasoningModel(modelId: string): boolean;
+}
 //# sourceMappingURL=oai-llm.service-base.d.ts.map