@futdevpro/nts-dynamo 1.15.151 → 1.15.154

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

@@ -1,68 +1,68 @@
-import { DyNTS_AI_LLM_ServiceBase } from './ai-llm.service-base';
-import { DyFM_AI_Message, DyFM_AI_CallSettings } from '@futdevpro/fsm-dynamo/ai';
-import {
-  DyFM_AI_ConversationBase_Input,
-  DyFM_AI_ConversationSelect_Input,
-  DyFM_AI_ConversationGenericSelect_Input,
-  DyFM_AI_ConversationMultiSelect_Input,
-  DyFM_AI_ConversationGenericMultiSelect_Input,
-  DyFM_AI_ConversationJSONKeysDescription_Input,
-  DyFM_AI_ConversationJSONExactKeys_Input,
-} from '../_models/ai-input-interfaces';
-import { DyFM_getLocalStackLocation, DyFM_Log } from '@futdevpro/fsm-dynamo';
-
-/**
- * Abstract base class for LLM Chat services
- * Extends LLM service with conversation management capabilities
- */
-export abstract class DyNTS_AI_LLMChat_ServiceBase<
-  T_AISettings extends DyFM_AI_CallSettings = DyFM_AI_CallSettings
-> extends DyNTS_AI_LLM_ServiceBase<T_AISettings> {
-  // History management
-  /**
-   * Add a message to the conversation history
-   */
-  /* abstract addMessageToHistory(message: DyFM_AI_Message, issuer: string): void; */
-  
-  /**
-   * Clear the conversation history for an issuer
-   */
-  /* abstract clearHistory(issuer: string): void; */
-  
-  /**
-   * Get the conversation history for an issuer
-   */
-  /* abstract getHistory(issuer: string): DyFM_AI_Message[]; */
-  
-  // Conversation methods (from OAI_LLMChat_ServiceBase)
-  abstract requestSimpleMessageInConversation(set: DyFM_AI_ConversationBase_Input<T_AISettings>): Promise<string>;
-  abstract requestYesNoInConversation(set: DyFM_AI_ConversationBase_Input<T_AISettings>): Promise<boolean>;
-  abstract requestPercentageInConversation(set: DyFM_AI_ConversationBase_Input<T_AISettings>): Promise<number>;
-
-  /* abstract selectQuestionInConversation(set: DyFM_AI_ConversationSelect_Input): Promise<string>; */
-  abstract requestSelectInConversation<T>(
-    set: DyFM_AI_ConversationGenericSelect_Input<T, T_AISettings>
-  ): Promise<T | { unparsableResult: string }>;
-  /* abstract multipleSelectQuestionInConversationWithOptions(
-    set: DyFM_AI_ConversationMultiSelect_Input<T_AISettings>
-  ): Promise<string[]>; */
-  abstract requestMultiselectInConversation<T>(
-    set: DyFM_AI_ConversationGenericMultiSelect_Input<T, T_AISettings>
-  ): Promise<T[] | { unparsableResult: string }>;
-
-  abstract requestJSONInConversation<T = any>(
-    set: DyFM_AI_ConversationBase_Input<T_AISettings>
-  ): Promise<T | { unparsableResult: string }>;
-  abstract requestJSONInConversationWithKeysDescription<T>(
-    set: DyFM_AI_ConversationJSONKeysDescription_Input<T_AISettings>
-  ): Promise<T | { unparsableResult: string }>;
-  abstract requestJSONInConversationWithExactKeys<T>(
-    set: DyFM_AI_ConversationJSONExactKeys_Input<T_AISettings>
-  ): Promise<T | { unparsableResult: string }>;
-  //abstract getQuestionAnswerInConversation(set: DyFM_AI_ConversationQuestion_Input): Promise<string>;
-  //abstract getAnswerInConversation(set: DyFM_AI_ConversationGetAnswer_Input): Promise<string>;
-
-  abstract requestListInConversation(
-    set: DyFM_AI_ConversationBase_Input<T_AISettings>
-  ): Promise<string[] | { unparsableResult: string }>;
-}
+import { DyNTS_AI_LLM_ServiceBase } from './ai-llm.service-base';
+import { DyFM_AI_Message, DyFM_AI_CallSettings } from '@futdevpro/fsm-dynamo/ai';
+import {
+  DyFM_AI_ConversationBase_Input,
+  DyFM_AI_ConversationSelect_Input,
+  DyFM_AI_ConversationGenericSelect_Input,
+  DyFM_AI_ConversationMultiSelect_Input,
+  DyFM_AI_ConversationGenericMultiSelect_Input,
+  DyFM_AI_ConversationJSONKeysDescription_Input,
+  DyFM_AI_ConversationJSONExactKeys_Input,
+} from '../_models/ai-input-interfaces';
+import { DyFM_getLocalStackLocation, DyFM_Log } from '@futdevpro/fsm-dynamo';
+
+/**
+ * Abstract base class for LLM Chat services
+ * Extends LLM service with conversation management capabilities
+ */
+export abstract class DyNTS_AI_LLMChat_ServiceBase<
+  T_AISettings extends DyFM_AI_CallSettings = DyFM_AI_CallSettings
+> extends DyNTS_AI_LLM_ServiceBase<T_AISettings> {
+  // History management
+  /**
+   * Add a message to the conversation history
+   */
+  /* abstract addMessageToHistory(message: DyFM_AI_Message, issuer: string): void; */
+  
+  /**
+   * Clear the conversation history for an issuer
+   */
+  /* abstract clearHistory(issuer: string): void; */
+  
+  /**
+   * Get the conversation history for an issuer
+   */
+  /* abstract getHistory(issuer: string): DyFM_AI_Message[]; */
+  
+  // Conversation methods (from OAI_LLMChat_ServiceBase)
+  abstract requestSimpleMessageInConversation(set: DyFM_AI_ConversationBase_Input<T_AISettings>): Promise<string>;
+  abstract requestYesNoInConversation(set: DyFM_AI_ConversationBase_Input<T_AISettings>): Promise<boolean>;
+  abstract requestPercentageInConversation(set: DyFM_AI_ConversationBase_Input<T_AISettings>): Promise<number>;
+
+  /* abstract selectQuestionInConversation(set: DyFM_AI_ConversationSelect_Input): Promise<string>; */
+  abstract requestSelectInConversation<T>(
+    set: DyFM_AI_ConversationGenericSelect_Input<T, T_AISettings>
+  ): Promise<T | { unparsableResult: string }>;
+  /* abstract multipleSelectQuestionInConversationWithOptions(
+    set: DyFM_AI_ConversationMultiSelect_Input<T_AISettings>
+  ): Promise<string[]>; */
+  abstract requestMultiselectInConversation<T>(
+    set: DyFM_AI_ConversationGenericMultiSelect_Input<T, T_AISettings>
+  ): Promise<T[] | { unparsableResult: string }>;
+
+  abstract requestJSONInConversation<T = any>(
+    set: DyFM_AI_ConversationBase_Input<T_AISettings>
+  ): Promise<T | { unparsableResult: string }>;
+  abstract requestJSONInConversationWithKeysDescription<T>(
+    set: DyFM_AI_ConversationJSONKeysDescription_Input<T_AISettings>
+  ): Promise<T | { unparsableResult: string }>;
+  abstract requestJSONInConversationWithExactKeys<T>(
+    set: DyFM_AI_ConversationJSONExactKeys_Input<T_AISettings>
+  ): Promise<T | { unparsableResult: string }>;
+  //abstract getQuestionAnswerInConversation(set: DyFM_AI_ConversationQuestion_Input): Promise<string>;
+  //abstract getAnswerInConversation(set: DyFM_AI_ConversationGetAnswer_Input): Promise<string>;
+
+  abstract requestListInConversation(
+    set: DyFM_AI_ConversationBase_Input<T_AISettings>
+  ): Promise<string[] | { unparsableResult: string }>;
+}

package/src/_modules/ai/_services/ai-llm.service-base.reconciler.spec.ts

@@ -1,133 +1,133 @@
-import {
-  DyFM_AI_CallSettings,
-  DyFM_AI_ModelInfo,
-  DyFM_AI_ModelType,
-  DyFM_AI_Provider,
-} from '@futdevpro/fsm-dynamo/ai';
-
-import { DyNTS_AI_LLM_ServiceBase } from './ai-llm.service-base';
-
-/** Minden-false capability-blokk a teszt-registry bejegyzesekhez. */
-const NO_CAPS: any = {
-  functionCalling: false,
-  vision: false,
-  streaming: false,
-  jsonMode: false,
-  audioInput: false,
-  audioOutput: false,
-  imageGeneration: false,
-  embeddings: false,
-  adultContent: false,
-};
-
-/** Teszt-registry: egy schema-val rendelkezo es egy schema-mentes modell. */
-const TEST_REGISTRY: DyFM_AI_ModelInfo[] = [
-  {
-    id: 'schema-model',
-    provider: DyFM_AI_Provider.OpenAI,
-    modelType: DyFM_AI_ModelType.Chat,
-    capabilities: NO_CAPS,
-    settingsSchema: {
-      supported: ['maxTokens'],
-      unsupported: ['temperature', 'topP'],
-      extraParams: ['reasoningEffort'],
-      constraints: {
-        maxTokens: { min: 10, max: 100 },
-      },
-    },
-  },
-  {
-    id: 'plain-model',
-    provider: DyFM_AI_Provider.OpenAI,
-    modelType: DyFM_AI_ModelType.Chat,
-    capabilities: NO_CAPS,
-  },
-];
-
-class ReconcilerTestService extends DyNTS_AI_LLM_ServiceBase<DyFM_AI_CallSettings> {
-  readonly aiProvider: any = {} as any;
-  readonly capabilities: any = {} as any;
-  setup = (config: any): void => {};
-  testConnection = async (issuer: string): Promise<boolean> => true;
-
-  readonly defaultSettings: DyFM_AI_CallSettings = {
-    systemPrompt: 'Test',
-    useModel: 'schema-model',
-    debugLog: false,
-  };
-
-  readonly predefinedRequests = { yesNo: { upperCaseYes: 'YES' } };
-
-  requestSimpleMessage = async (set: any): Promise<string> => { return ''; };
-  requestYesNo = async (set: any): Promise<boolean> => { return false; };
-  requestPercentage = async (set: any): Promise<number> => { return 0; };
-  requestSelect = async <T>(set: any): Promise<T | { unparsableResult: string }> => { return null as any; };
-  requestMultiselect = async <T>(set: any): Promise<T[] | { unparsableResult: string }> => { return []; };
-  requestJSON = async <T>(set: any): Promise<T | { unparsableResult: string }> => { return null as any; };
-  requestJSONQuestionWithKeysDescription = async <T>(set: any): Promise<T | { unparsableResult: string }> => { return null as any; };
-  requestJSONWithExactKeys = async <T>(set: any): Promise<T | { unparsableResult: string }> => { return null as any; };
-  requestList = async <T>(set: any): Promise<T[] | { unparsableResult: string }> => { return []; };
-
-  protected override getModelRegistry(): DyFM_AI_ModelInfo[] {
-    return TEST_REGISTRY;
-  }
-
-  static getInstance(): ReconcilerTestService {
-    return ReconcilerTestService.getSingletonInstance();
-  }
-}
-
-describe('| DyNTS_AI_LLM_ServiceBase — FR-048 reconcileCallSettings', () => {
-  let service: ReconcilerTestService;
-
-  beforeEach(() => {
-    service = ReconcilerTestService.getInstance();
-  });
-
-  it('| dropolja az `unsupported` kulcsokat, a tobbit meghagyja', () => {
-    const result: DyFM_AI_CallSettings = (service as any).reconcileCallSettings('schema-model', {
-      temperature: 0.7,
-      topP: 0.9,
-      maxTokens: 50,
-    });
-
-    expect(result.temperature).toBeUndefined();
-    expect(result.topP).toBeUndefined();
-    expect(result.maxTokens).toBe(50);
-  });
-
-  it('| NEM mutalja az eredeti settings-objektumot', () => {
-    const original: DyFM_AI_CallSettings = { temperature: 0.7, maxTokens: 50 };
-
-    (service as any).reconcileCallSettings('schema-model', original);
-
-    expect(original.temperature).toBe(0.7);
-  });
-
-  it('| clamp-eli a `constraints` min/max szerint', () => {
-    const tooHigh: DyFM_AI_CallSettings = (service as any).reconcileCallSettings('schema-model', { maxTokens: 500 });
-    const tooLow: DyFM_AI_CallSettings = (service as any).reconcileCallSettings('schema-model', { maxTokens: 1 });
-
-    expect(tooHigh.maxTokens).toBe(100);
-    expect(tooLow.maxTokens).toBe(10);
-  });
-
-  it('| schema-mentes modell → permisszi­v passthrough (non-breaking)', () => {
-    const input: DyFM_AI_CallSettings = { temperature: 0.7, topP: 0.9 };
-    const result: DyFM_AI_CallSettings = (service as any).reconcileCallSettings('plain-model', input);
-
-    expect(result).toBe(input);
-    expect(result.temperature).toBe(0.7);
-  });
-
-  it('| ismeretlen modell → permisszi­v passthrough (honesty, nem dob)', () => {
-    const input: DyFM_AI_CallSettings = { temperature: 0.7 };
-    const result: DyFM_AI_CallSettings = (service as any).reconcileCallSettings('nincs-ilyen-modell', input);
-
-    expect(result).toBe(input);
-  });
-
-  it('| undefined settings → valtozatlanul visszaadva', () => {
-    expect((service as any).reconcileCallSettings('schema-model', undefined)).toBeUndefined();
-  });
-});
+import {
+  DyFM_AI_CallSettings,
+  DyFM_AI_ModelInfo,
+  DyFM_AI_ModelType,
+  DyFM_AI_Provider,
+} from '@futdevpro/fsm-dynamo/ai';
+
+import { DyNTS_AI_LLM_ServiceBase } from './ai-llm.service-base';
+
+/** Minden-false capability-blokk a teszt-registry bejegyzesekhez. */
+const NO_CAPS: any = {
+  functionCalling: false,
+  vision: false,
+  streaming: false,
+  jsonMode: false,
+  audioInput: false,
+  audioOutput: false,
+  imageGeneration: false,
+  embeddings: false,
+  adultContent: false,
+};
+
+/** Teszt-registry: egy schema-val rendelkezo es egy schema-mentes modell. */
+const TEST_REGISTRY: DyFM_AI_ModelInfo[] = [
+  {
+    id: 'schema-model',
+    provider: DyFM_AI_Provider.OpenAI,
+    modelType: DyFM_AI_ModelType.Chat,
+    capabilities: NO_CAPS,
+    settingsSchema: {
+      supported: ['maxTokens'],
+      unsupported: ['temperature', 'topP'],
+      extraParams: ['reasoningEffort'],
+      constraints: {
+        maxTokens: { min: 10, max: 100 },
+      },
+    },
+  },
+  {
+    id: 'plain-model',
+    provider: DyFM_AI_Provider.OpenAI,
+    modelType: DyFM_AI_ModelType.Chat,
+    capabilities: NO_CAPS,
+  },
+];
+
+class ReconcilerTestService extends DyNTS_AI_LLM_ServiceBase<DyFM_AI_CallSettings> {
+  readonly aiProvider: any = {} as any;
+  readonly capabilities: any = {} as any;
+  setup = (config: any): void => {};
+  testConnection = async (issuer: string): Promise<boolean> => true;
+
+  readonly defaultSettings: DyFM_AI_CallSettings = {
+    systemPrompt: 'Test',
+    useModel: 'schema-model',
+    debugLog: false,
+  };
+
+  readonly predefinedRequests = { yesNo: { upperCaseYes: 'YES' } };
+
+  requestSimpleMessage = async (set: any): Promise<string> => { return ''; };
+  requestYesNo = async (set: any): Promise<boolean> => { return false; };
+  requestPercentage = async (set: any): Promise<number> => { return 0; };
+  requestSelect = async <T>(set: any): Promise<T | { unparsableResult: string }> => { return null as any; };
+  requestMultiselect = async <T>(set: any): Promise<T[] | { unparsableResult: string }> => { return []; };
+  requestJSON = async <T>(set: any): Promise<T | { unparsableResult: string }> => { return null as any; };
+  requestJSONQuestionWithKeysDescription = async <T>(set: any): Promise<T | { unparsableResult: string }> => { return null as any; };
+  requestJSONWithExactKeys = async <T>(set: any): Promise<T | { unparsableResult: string }> => { return null as any; };
+  requestList = async <T>(set: any): Promise<T[] | { unparsableResult: string }> => { return []; };
+
+  protected override getModelRegistry(): DyFM_AI_ModelInfo[] {
+    return TEST_REGISTRY;
+  }
+
+  static getInstance(): ReconcilerTestService {
+    return ReconcilerTestService.getSingletonInstance();
+  }
+}
+
+describe('| DyNTS_AI_LLM_ServiceBase — FR-048 reconcileCallSettings', () => {
+  let service: ReconcilerTestService;
+
+  beforeEach(() => {
+    service = ReconcilerTestService.getInstance();
+  });
+
+  it('| dropolja az `unsupported` kulcsokat, a tobbit meghagyja', () => {
+    const result: DyFM_AI_CallSettings = (service as any).reconcileCallSettings('schema-model', {
+      temperature: 0.7,
+      topP: 0.9,
+      maxTokens: 50,
+    });
+
+    expect(result.temperature).toBeUndefined();
+    expect(result.topP).toBeUndefined();
+    expect(result.maxTokens).toBe(50);
+  });
+
+  it('| NEM mutalja az eredeti settings-objektumot', () => {
+    const original: DyFM_AI_CallSettings = { temperature: 0.7, maxTokens: 50 };
+
+    (service as any).reconcileCallSettings('schema-model', original);
+
+    expect(original.temperature).toBe(0.7);
+  });
+
+  it('| clamp-eli a `constraints` min/max szerint', () => {
+    const tooHigh: DyFM_AI_CallSettings = (service as any).reconcileCallSettings('schema-model', { maxTokens: 500 });
+    const tooLow: DyFM_AI_CallSettings = (service as any).reconcileCallSettings('schema-model', { maxTokens: 1 });
+
+    expect(tooHigh.maxTokens).toBe(100);
+    expect(tooLow.maxTokens).toBe(10);
+  });
+
+  it('| schema-mentes modell → permisszi­v passthrough (non-breaking)', () => {
+    const input: DyFM_AI_CallSettings = { temperature: 0.7, topP: 0.9 };
+    const result: DyFM_AI_CallSettings = (service as any).reconcileCallSettings('plain-model', input);
+
+    expect(result).toBe(input);
+    expect(result.temperature).toBe(0.7);
+  });
+
+  it('| ismeretlen modell → permisszi­v passthrough (honesty, nem dob)', () => {
+    const input: DyFM_AI_CallSettings = { temperature: 0.7 };
+    const result: DyFM_AI_CallSettings = (service as any).reconcileCallSettings('nincs-ilyen-modell', input);
+
+    expect(result).toBe(input);
+  });
+
+  it('| undefined settings → valtozatlanul visszaadva', () => {
+    expect((service as any).reconcileCallSettings('schema-model', undefined)).toBeUndefined();
+  });
+});