@futdevpro/nts-dynamo 1.15.105 → 1.15.107

package/src/_modules/ai/_modules/ai-mock/_services/aim-mock.service.ts

@@ -0,0 +1,142 @@
+import { DyFM_Error } from '@futdevpro/fsm-dynamo';
+import { DyFM_AI_ModelInfo } from '@futdevpro/fsm-dynamo/ai';
+
+import { DyNTS_AIMock_Modality } from '../_enums/aim-modality.enum';
+import { DyNTS_AI_ModelConfig_Validator } from '../../../_collections/ai-model-config-validator.util';
+import { DyNTS_AIMock_Request } from '../_models/interfaces/aim-request.interface';
+import { DyNTS_AIMock_Fixture } from '../_models/interfaces/aim-fixture.interface';
+import { DyNTS_AIMock_Error } from '../_models/interfaces/aim-error.interface';
+import { DyNTS_AIMock_CallInput } from '../_models/interfaces/aim-call-input.interface';
+import { DyNTS_AIMock_FixtureMatch_Util } from '../_collections/aim-fixture-match.util';
+import { DyNTS_AIMock_FixtureStore_Service } from './aim-fixture-store.service';
+
+/**
+ * A mock provider-surface (MP-4 SP-4.1) — a valódi AI-hívás kiváltása beégetett fixture-ökkel, outbound
+ * hívás NÉLKÜL. Négy modalitás-metódus (`chatCompletion`/`embed`/`generateImage`/`generateAudio`), mind a
+ * `DyNTS_AIMock_FixtureStore`-ból replay-el: hit → a beégetett kimenet; miss → strukturált reject-on-unknown
+ * (D3, NEM silent-fallback, NEM outbound); beégetett provider-faithful hiba → ugyanaz a hiba, mint a valódi
+ * providernél. A config-validáció (FR-048 reconciler validate-mode) a `settingsSchema` populálása UTÁN
+ * kötendő be (G4) — l. a `replay` TODO-ját; addig SZÁNDÉKOSAN nem validálunk (nem fake-elünk provider-error-t).
+ */
+export class DyNTS_AIMock_Service {
+
+  /** A fixture-tár, amiből a replay megy. */
+  private readonly store: DyNTS_AIMock_FixtureStore_Service;
+
+  /**
+   * A modell-registry a config-validaciohoz (FR-048 `settingsSchema`). Ures registry → NINCS
+   * config-validacio (permisszi­v), csak fixture-replay — igy a mock a schema kikerulese elott is hasznalhato.
+   */
+  private readonly modelRegistry: DyFM_AI_ModelInfo[];
+
+  /**
+   * @param store a beégetett fixture-ök tára.
+   * @param modelRegistry opcionális modell-registry (pl. `DyFM_OAI_Models`) a FR-048 config-validációhoz.
+   */
+  constructor(store: DyNTS_AIMock_FixtureStore_Service, modelRegistry?: DyFM_AI_ModelInfo[]) {
+    this.store = store;
+    this.modelRegistry = modelRegistry ?? [];
+  }
+
+  /**
+   * Chat/completion replay a beégetett fixture-ből.
+   * @param set - provider + model + opcionális config + prompt-input
+   */
+  async chatCompletion(set: DyNTS_AIMock_CallInput): Promise<unknown> {
+    return this.replay(this.toRequest(set, DyNTS_AIMock_Modality.text));
+  }
+
+  /**
+   * Embedding replay a beégetett fixture-ből.
+   * @param set - provider + model + opcionális config + szöveg(ek)-input
+   */
+  async embed(set: DyNTS_AIMock_CallInput): Promise<unknown> {
+    return this.replay(this.toRequest(set, DyNTS_AIMock_Modality.embedding));
+  }
+
+  /**
+   * Kép-generálás replay a beégetett fixture-ből.
+   * @param set - provider + model + opcionális config + kép-prompt-input
+   */
+  async generateImage(set: DyNTS_AIMock_CallInput): Promise<unknown> {
+    return this.replay(this.toRequest(set, DyNTS_AIMock_Modality.image));
+  }
+
+  /**
+   * Hang (transcription / TTS) replay a beégetett fixture-ből.
+   * @param set - provider + model + opcionális config + audio/szöveg-input
+   */
+  async generateAudio(set: DyNTS_AIMock_CallInput): Promise<unknown> {
+    return this.replay(this.toRequest(set, DyNTS_AIMock_Modality.audio));
+  }
+
+  /** A modalitás-metódus bemenetéből teljes `DyNTS_AIMock_Request`. */
+  private toRequest(set: DyNTS_AIMock_CallInput, modality: DyNTS_AIMock_Modality): DyNTS_AIMock_Request {
+    return {
+      provider: set.provider,
+      model: set.model,
+      modality: modality,
+      config: set.config,
+      input: set.input,
+    };
+  }
+
+  /** A közös replay/reject-mag. */
+  private replay(request: DyNTS_AIMock_Request): unknown {
+    // FR-048: a config-validáció a modell `settingsSchema.unsupported`-ja alapján — MÉG a fixture-lookup
+    // ELŐTT, ahogy a valódi providernél is a szerver utasítja el a rossz paramétert.
+    this.validateConfig(request);
+
+    const fixture: DyNTS_AIMock_Fixture | undefined = this.store.resolve(request);
+
+    if (!fixture) {
+      throw this.rejectOnUnknown(request);
+    }
+
+    if (fixture.error) {
+      throw this.toProviderFaithfulError(fixture.error);
+    }
+
+    return fixture.output;
+  }
+
+  /**
+   * FR-048 config-validáció — **delegál** a modul-szintű `DyNTS_AI_ModelConfig_Validator`-ra, hogy EGY
+   * validációs út legyen (SSoT): ugyanaz a kód dönt a production pre-validációnál és a mockban.
+   * Üres registry / schema-mentes modell → permisszív (nem találgatunk).
+   */
+  private validateConfig(request: DyNTS_AIMock_Request): void {
+    const error: DyFM_Error = DyNTS_AI_ModelConfig_Validator.validate({
+      provider: request.provider,
+      model: request.model,
+      config: request.config,
+      registry: this.modelRegistry,
+    });
+
+    if (error) {
+      throw error;
+    }
+  }
+
+  /** Egy `DyNTS_AIMock_Error` leíróból a dobandó `DyFM_Error`. */
+  private toProviderFaithfulError(error: DyNTS_AIMock_Error): DyFM_Error {
+    return new DyFM_Error({
+      message: `[ai-mock] provider-faithful error (HTTP ${error.httpStatus}): ${error.reason}`,
+      userMessage: 'AI request rejected (mock).',
+      errorCode: 'DyNTS-AIMOCK-PERR',
+      additionalContent: { providerErrorBody: error.providerErrorBody },
+    });
+  }
+
+  /** Strukturált „no-fixture" hiba (D3) — beszédes, a hiányzó kulccsal + az extend-recepttel (MP-6). */
+  private rejectOnUnknown(request: DyNTS_AIMock_Request): DyFM_Error {
+    const matchKey: string = DyNTS_AIMock_FixtureMatch_Util.buildMatchKey(request);
+
+    return new DyFM_Error({
+      message: `[ai-mock] no fixture for '${request.provider}:${request.model}' (${request.modality}). ` +
+        `Match-key: ${matchKey}. Beégetés: 'dc ai-mock-extend' (MP-6).`,
+      userMessage: 'No mock fixture is registered for this AI request.',
+      errorCode: 'DyNTS-AIMOCK-NOFIX',
+    });
+  }
+}

package/src/_modules/ai/_modules/ai-mock/index.ts

@@ -0,0 +1,44 @@
+//
+// ai-mock module (@futdevpro/nts-dynamo/ai/ai-mock)
+//
+// AI Mocking System — provider-faithful mock-service + fixture-store (Layer B) a valódi AI-hívások
+// kiváltására teszt/CI/lokál-fejlesztésben. A Layer A (per-model config-registry + validátor) a FR-048
+// (`DyFM_AI_ModelSettingsSchema` + reconciler) — az ai-mock azt FOGYASZTJA a provider-faithful
+// error-reprodukcióhoz. Terv: `documentations/plans/ai-mocking-system/HYPERPLAN.md`.
+//
+// SCAFFOLD (Cikl. 2, 2026-07-21): a modul-váz + a meglévő determinisztikus embedding-mock re-exportja.
+// A további szolgáltatások (fixture-store, mock-service, coverage) MP-3..MP-6 során kerülnek ide;
+// almappák (_collections/_enums/_models/_services) csak 3-5+ elemnél jönnek létre (FDP folder-rule).
+//
+
+// Layer B embedding-mag: a determinisztikus embedding-mock (BFR-AM-008) — MP-5 SP-5.1 során FIZIKAILAG
+// ide költözött (`_services/ai-embedding-mock.service.ts`). A régi `@futdevpro/nts-dynamo/ai` útvonal
+// backward-compat re-exportként tovább él, így a FAM-consumer nem törik.
+export * from './_services/ai-embedding-mock.service';
+
+// ENUMS
+export * from './_enums/aim-modality.enum';
+
+// MODELS / INTERFACES — fixture-shape (MP-3 SP-3.1)
+export * from './_models/interfaces/aim-request.interface';
+export * from './_models/interfaces/aim-error.interface';
+export * from './_models/interfaces/aim-fixture.interface';
+export * from './_models/interfaces/aim-call-input.interface';
+export * from './_models/interfaces/aim-service-collection.interface';
+
+// COLLECTIONS — input-match normalizáció (MP-3 SP-3.1).
+// A provider-faithful hiba-alak + a validate-mode a MODUL-SZINTŰ `ai/` alatt él (SSoT), mert production
+// pre-validációra is kell — nem az ai-mock-ból importálandó: `@futdevpro/nts-dynamo/ai`.
+export * from './_collections/aim-fixture-match.util';
+
+// DEFAULT-BUNDLE factory (MP-7 SP-7.1) — egy hívással álló mock-készlet.
+export * from './_collections/aim-default-collection.util';
+
+// FIXTURE-SERIALIZER (MP-3 SP-3.1) — determinisztikus, diff-barát konstans-fájl generálás.
+export * from './_collections/aim-fixture-serializer.util';
+
+// SERVICES — fixture-store (MP-3) + mock-service surface (MP-4 SP-4.1) + generáló harness (MP-3 SP-3.2).
+// A harness KÉT biztonsági zárral véd a véletlen pénzköltés ellen (spend-guard default OFF + D2 tier-cap).
+export * from './_services/aim-fixture-store.service';
+export * from './_services/aim-mock.service';
+export * from './_services/aim-fixture-harness.service';

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

@@ -12,7 +12,8 @@ import {
   DyFM_AI_LLM_Response,
   DyFM_AI_Tool,
   DyFM_AI_ToolCall,
-  DyFM_AI_ModelInfo
+  DyFM_AI_ModelInfo,
+  DyFM_AI_ModelRegistry_Util
 } from '@futdevpro/fsm-dynamo/ai';
 
 import { DyNTS_global_settings } from '../../../../../_collections/global-settings.const';
@@ -514,33 +515,17 @@ export class DyNTS_OAI_LLM_ServiceBase extends DyNTS_AI_LLM_ServiceBase {
     try {
       const settings = set.settings ?? this.defaultSettings;
 
+      const useModel: string = String(settings?.useModel ?? this.defaultModel);
+
       const result: ChatCompletionCreateParamsBase = {
-        model: settings?.useModel ?? this.defaultModel,
+        model: useModel,
         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;
+      // FR-048 §3: a sampling-parameterek (+ max_completion_tokens) a per-model `settingsSchema` szerint
+      // kerulnek ra (drop/clamp). KORABBAN ez a NEM-tool ag FELTETEL NELKUL kuldte a sampling-parametereket,
+      // ezert reasoning modellen (GPT-5.x / o-series) 400-zal elhasalt volna — ezt itt zarjuk le.
+      this.applySamplingParams({ input: result, useModel: useModel, settings: set.settings });
 
       return result;
     } catch (error) {
@@ -603,19 +588,12 @@ export class DyNTS_OAI_LLM_ServiceBase extends DyNTS_AI_LLM_ServiceBase {
       const input: ChatCompletionCreateParamsBase = {
         model: useModel,
         messages: messages,
-        max_completion_tokens: DyFM_notNull(settings?.maxTokens) ? settings.maxTokens : this.defaultSettings.maxTokens,
       };
 
-      // Reasoning modellek (GPT-5.x / o-series) elutasitjak a sampling-parametereket
-      // (temperature != 1, top_p, frequency/presence_penalty) -> 400. Ezeket NEM kuldjuk
-      // reasoning modellnel. (Ez a FR-048 per-model settings elv lokalis, OpenAI-specifikus
-      // alkalmazasa — amig a general reconciler el nem keszul.)
-      if (!this.isReasoningModel(String(useModel))) {
-        input.temperature = DyFM_notNull(settings?.temperature) ? settings.temperature : this.defaultSettings.temperature;
-        input.top_p = DyFM_notNull(settings?.topP) ? settings.topP : this.defaultSettings.topP;
-        input.frequency_penalty = DyFM_notNull(settings?.frequencyPenalty) ? settings.frequencyPenalty : this.defaultSettings.frequencyPenalty;
-        input.presence_penalty = DyFM_notNull(settings?.presencePenalty) ? settings.presencePenalty : this.defaultSettings.presencePenalty;
-      }
+      // FR-048 §3: a sampling-parameterek + `max_completion_tokens` a per-model `settingsSchema` szerint
+      // kerulnek ra. A korabbi lokalis `isReasoningModel`-drop atmeneti fallback-kent bent maradt a
+      // helper-ben (l. `applySamplingParams`), amig a schema ki nem kerul a fsm-bol — igy nincs regresszio.
+      this.applySamplingParams({ input: input, useModel: String(useModel), settings: set.settings });
 
       // Ures tools-tomb -> 400 ("tools must have minimum length 1"). Csak akkor kuldjuk, ha van tool.
       if (set.tools.length) {
@@ -736,6 +714,70 @@ export class DyNTS_OAI_LLM_ServiceBase extends DyNTS_AI_LLM_ServiceBase {
     return /^gpt-5/.test(modelId) || /^o[0-9]/.test(modelId);
   }
 
+  /**
+   * FR-048 §3 — feloldja az agnosztikus sampling-settingseket (hivas-settings > default), atengedi a
+   * per-model reconciler-en (`settingsSchema` szerinti drop/clamp), majd RAKEPZI a natív OpenAI mezokre.
+   * Csak azok a natív mezok kerulnek az input-ra, amik a reconcile utan MEGMARADTAK.
+   *
+   * Ezzel a "melyik modell mit fogad el" tudas a registry `settingsSchema`-jaban (SSoT) el, nem
+   * provider-translatoronkent duplikalva.
+   *
+   * **Atmeneti fallback (szandekos):** ha a registry-bejegyzesnek MEG NINCS `settingsSchema`-ja (regebbi
+   * fsm-verzio, vagy registry-ben nem szereplo modell), a korabbi lokalis `isReasoningModel`-drop marad
+   * ervenyben — igy a FR-047 `514153f` fix NEM regresszal, amig a schema ki nem kerul a fsm-bol. Amint a
+   * schema mindenhol elerheto, ez a fallback (es az `isReasoningModel`) elhagyhato.
+   */
+  protected applySamplingParams(
+    set: {
+      input: ChatCompletionCreateParamsBase,
+      useModel: string,
+      settings?: DyFM_OAI_CallSettings,
+    }
+  ): void {
+    const source: DyFM_OAI_CallSettings = set.settings ?? this.defaultSettings;
+
+    const resolved: DyFM_OAI_CallSettings = {
+      ...source,
+      useModel: set.useModel,
+      temperature: DyFM_notNull(source?.temperature) ? source.temperature : this.defaultSettings.temperature,
+      maxTokens: DyFM_notNull(source?.maxTokens) ? source.maxTokens : this.defaultSettings.maxTokens,
+      topP: DyFM_notNull(source?.topP) ? source.topP : this.defaultSettings.topP,
+      frequencyPenalty: DyFM_notNull(source?.frequencyPenalty) ?
+        source.frequencyPenalty : this.defaultSettings.frequencyPenalty,
+      presencePenalty: DyFM_notNull(source?.presencePenalty) ?
+        source.presencePenalty : this.defaultSettings.presencePenalty,
+    };
+
+    const final: DyFM_OAI_CallSettings = this.reconcileCallSettings(set.useModel, resolved);
+
+    const modelInfo: DyFM_AI_ModelInfo = DyFM_AI_ModelRegistry_Util.findModelInfo(
+      this.getModelRegistry(),
+      set.useModel
+    );
+    const dropSampling: boolean = !modelInfo?.settingsSchema && this.isReasoningModel(set.useModel);
+
+    if (DyFM_notNull(final?.maxTokens)) {
+      set.input.max_completion_tokens = final.maxTokens;
+    }
+
+    if (dropSampling) {
+      return;
+    }
+
+    if (DyFM_notNull(final?.temperature)) {
+      set.input.temperature = final.temperature;
+    }
+    if (DyFM_notNull(final?.topP)) {
+      set.input.top_p = final.topP;
+    }
+    if (DyFM_notNull(final?.frequencyPenalty)) {
+      set.input.frequency_penalty = final.frequencyPenalty;
+    }
+    if (DyFM_notNull(final?.presencePenalty)) {
+      set.input.presence_penalty = final.presencePenalty;
+    }
+  }
+
   //#endregion
 
 //  async askJSONListQuestion(

package/src/_modules/ai/_services/ai-embedding-provider.registry.spec.ts

@@ -1,6 +1,6 @@
 import { DyNTS_AI_EmbeddingProvider_Registry } from './ai-embedding-provider.registry';
 import { DyNTS_LMStudio_Embedding_ControlService } from './lmstudio-embedding.control-service';
-import { DyNTS_AI_Embedding_MockService } from './ai-embedding-mock.service';
+import { DyNTS_AI_Embedding_MockService } from '../_modules/ai-mock/_services/ai-embedding-mock.service';
 import { DyNTS_OAI_Embedding_ControlService } from '../_modules/open-ai/_services/oai-embedding.control-service';
 
 describe('| DyNTS_AI_EmbeddingProvider_Registry', () => {

package/src/_modules/ai/_services/ai-embedding-provider.registry.ts

@@ -3,7 +3,7 @@ import { DyFM_OAI_Settings } from '@futdevpro/fsm-dynamo/ai/open-ai';
 import { DyNTS_AI_Embedding_ServiceBase } from './ai-embedding.service-base';
 import { DyNTS_OAI_Embedding_ControlService } from '../_modules/open-ai/_services/oai-embedding.control-service';
 import { DyNTS_LMStudio_Embedding_ControlService, DyNTS_LMStudio_Embedding_Settings } from './lmstudio-embedding.control-service';
-import { DyNTS_AI_Embedding_MockService, DyNTS_AI_Embedding_MockSettings } from './ai-embedding-mock.service';
+import { DyNTS_AI_Embedding_MockService, DyNTS_AI_Embedding_MockSettings } from '../_modules/ai-mock/_services/ai-embedding-mock.service';
 import { DyNTS_AI_CostEventCallback } from '../_models/interfaces/dynts-ai-cost-event-callback.interface';
 
 /**

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

@@ -0,0 +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();
+  });
+});

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

@@ -10,6 +10,8 @@ import {
   DyFM_AI_ToolHandlers,
   DyFM_AI_ModelInfo,
   DyFM_AI_ModelRegistry_Util,
+  DyFM_AI_ModelSettingsSchema,
+  DyFM_AI_SettingConstraint,
 } from '@futdevpro/fsm-dynamo/ai';
 import { DyFM_Error, DyFM_Error_Settings, DyFM_getLocalStackLocation, DyFM_Log, DyFM_Object } from '@futdevpro/fsm-dynamo';
 import {
@@ -82,6 +84,84 @@ export abstract class DyNTS_AI_LLM_ServiceBase<
     }
   }
 
+  //////////////////////////////////////////////////////////////////////////////////////////
+                    // PER-MODEL SETTINGS RECONCILER — FR-048 //
+  //////////////////////////////////////////////////////////////////////////////////////////
+
+  /**
+   * FR-048 reconciler — a resolved modell `settingsSchema`-ja szerint egyezteti a call-settings-et a
+   * tenyleges provider-hivas ELOTT: DROPolja az `unsupported` kulcsokat (debug-log, SOHA nem csendben),
+   * CLAMP-eli a `constraints` (min/max) szerint. Ismeretlen modell / schema-mentes registry-bejegyzes →
+   * permisszi­v passthrough + log (best-effort, honesty).
+   *
+   * Ezzel altalanosul a FR-047 Phase-4 lokalis param-drop (Anthropic Opus 4.7+ temperature/topP/topK) es a
+   * FR-047 `isReasoningModel` sampling-drop: a tudas mostantol a registry `settingsSchema`-jaban (SSoT) el,
+   * nem provider-translator-onkent duplikalva.
+   *
+   * NON-BREAKING: ha a registry ures vagy a modellnek nincs schemaja, a bemenet valtozatlanul ter vissza —
+   * igy a meglevo providerek viselkedese nem valtozik, amig a schema nincs feltoltve.
+   * @param modelId - a feloldott modell azonositoja
+   * @param settings - a hivas-settings (opcionalis)
+   */
+  protected reconcileCallSettings(modelId: string, settings?: T_AISettings): T_AISettings {
+    if (!settings) {
+      return settings;
+    }
+
+    const modelInfo: DyFM_AI_ModelInfo = DyFM_AI_ModelRegistry_Util.findModelInfo(this.getModelRegistry(), modelId);
+    const schema: DyFM_AI_ModelSettingsSchema = modelInfo?.settingsSchema;
+
+    if (!schema) {
+      if (this.debugLog) {
+        DyFM_Log.info(`[FR-048] no settingsSchema for '${modelId}' — passthrough (best-effort)`);
+      }
+
+      return settings;
+    }
+
+    const reconciled: T_AISettings = { ...settings };
+    // A generikus `T_AISettings` csak OLVASASRA indexelheto (TS2862), ezert a mutaciot egy nem-generikus
+    // aliason vegezzuk — UGYANARRA az objektumra mutat, igy cast nelkul is tipus-helyes marad.
+    const mutable: Record<string, unknown> = reconciled;
+
+    for (const key of schema.unsupported ?? []) {
+      if (mutable[key] !== undefined) {
+        if (this.debugLog) {
+          DyFM_Log.info(`[FR-048] drop unsupported '${key}' for model '${modelId}'`);
+        }
+        delete mutable[key];
+      }
+    }
+
+    const constraints: Record<string, DyFM_AI_SettingConstraint> = schema.constraints ?? {};
+
+    for (const key of Object.keys(constraints)) {
+      const constraint: DyFM_AI_SettingConstraint = constraints[key];
+      const value: unknown = mutable[key];
+
+      if (typeof value !== 'number') {
+        continue;
+      }
+
+      let next: number = value;
+
+      if (typeof constraint.min === 'number' && next < constraint.min) {
+        next = constraint.min;
+      }
+      if (typeof constraint.max === 'number' && next > constraint.max) {
+        next = constraint.max;
+      }
+      if (next !== value) {
+        if (this.debugLog) {
+          DyFM_Log.info(`[FR-048] clamp '${key}' ${value} → ${next} for model '${modelId}'`);
+        }
+        mutable[key] = next;
+      }
+    }
+
+    return reconciled;
+  }
+
   /**
    * GPT valasz Function Calling Agent Tool-okkal — provider-agnosztikus agent-loop.
    * @description A `tools` definiciok + `toolHandlers` alapjan tool-loop-ot futtat: hivja a

package/src/_modules/ai/index.ts

@@ -10,6 +10,12 @@ export * from './_models/ai-test-generation-result.interface';
 export * from './_models/interfaces/dynts-ai-cost-event.interface';
 export * from './_models/interfaces/dynts-ai-cost-event-callback.interface';
 
+// FR-048 per-model settings — provider-faithful hiba-alak + validate-mode (production pre-validation).
+// A reconciler (`DyNTS_AI_LLM_ServiceBase.reconcileCallSettings`) testvére: UGYANAZ a `settingsSchema` forrás.
+export * from './_models/interfaces/dynts-ai-provider-error.interface';
+export * from './_collections/ai-provider-error.util';
+export * from './_collections/ai-model-config-validator.util';
+
 // Abstract Services
 export * from './_services/ai-provider.service-base';
 export * from './_services/ai-llm.service-base';
@@ -19,5 +25,9 @@ export * from './_services/ai-user-key.service-base';
 
 // Concrete Embedding Services + provider-dispatch (BFR-AM-002 / 007 / 008)
 export * from './_services/lmstudio-embedding.control-service';
-export * from './_services/ai-embedding-mock.service';
 export * from './_services/ai-embedding-provider.registry';
+
+// BACKWARD-COMPAT (MP-5 SP-5.1): a determinisztikus embedding-mock FIZIKAILAG az `ai-mock` submodulba
+// koltozott (`./_modules/ai-mock/_services/`), de a `@futdevpro/nts-dynamo/ai` import-utvonal VALTOZATLAN —
+// a meglevo consumer (FAM `EMBEDDING_PROVIDER=mock`) nem torik. Uj kod inkabb `@futdevpro/nts-dynamo/ai/ai-mock`.
+export * from './_modules/ai-mock/_services/ai-embedding-mock.service';

package/build/_modules/ai/_services/ai-embedding-mock.service.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"ai-embedding-mock.service.d.ts","sourceRoot":"","sources":["../../../../src/_modules/ai/_services/ai-embedding-mock.service.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,uBAAuB,EAAE,MAAM,kBAAkB,CAAC;AAE3D,OAAO,EAAE,gBAAgB,EAAE,4BAA4B,EAAE,cAAc,EAAE,MAAM,0BAA0B,CAAC;AAC1G,OAAO,EAAE,sBAAsB,EAAE,MAAM,sCAAsC,CAAC;AAE9E,OAAO,EAAE,0BAA0B,EAAE,MAAM,8DAA8D,CAAC;AAC1G,OAAO,EAAE,8BAA8B,EAAE,MAAM,6BAA6B,CAAC;AAE7E,2GAA2G;AAC3G,eAAO,MAAM,4BAA4B,EAAE,MAAW,CAAC;AAEvD;;;GAGG;AACH,MAAM,WAAW,+BAA+B;IAC9C,6EAA6E;IAC7E,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,kGAAkG;IAClG,WAAW,CAAC,EAAE,0BAA0B,CAAC;CAC1C;AAED;;;;;;;;;;GAUG;AACH,qBAAa,8BAA+B,SAAQ,8BAA8B;IAEhF,yEAAyE;IACzE,QAAQ,CAAC,UAAU,EAAE,gBAAgB,CAA4B;IAEjE,8FAA8F;IAC9F,SAAS,CAAC,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAU;IAEjD,4DAA4D;IAC5D,QAAQ,CAAC,YAAY,EAAE,4BAA4B,CAWjD;IAEF,oCAAoC;IACpC,SAAS,CAAC,IAAI,EAAE,MAAM,CAAC;IAEvB,gDAAgD;gBACpC,GAAG,CAAC,EAAE,+BAA+B;IASjD,wGAAwG;IACxG,KAAK,CAAC,MAAM,EAAE,cAAc,GAAG,IAAI;IAQnC;;;OAGG;IACG,eAAe,CACnB,GAAG,EAAE;QACH,IAAI,EAAE,MAAM,CAAC;QACb,KAAK,EAAE,MAAM,CAAC;QACd,YAAY,CAAC,EAAE,OAAO,CAAC;QACvB,MAAM,EAAE,MAAM,CAAC;KAChB,GACA,OAAO,CAAC,MAAM,EAAE,GAAG,uBAAuB,CAAC;IAc9C;;;OAGG;IACG,gBAAgB,CACpB,GAAG,EAAE;QACH,KAAK,EAAE,MAAM,EAAE,CAAC;QAChB,KAAK,EAAE,MAAM,CAAC;QACd,YAAY,CAAC,EAAE,OAAO,CAAC;QACvB,MAAM,EAAE,MAAM,CAAC;KAChB,GACA,OAAO,CAAC,MAAM,EAAE,EAAE,GAAG,uBAAuB,CAAC;IAehD,4EAA4E;IAC5E,gBAAgB,CAAC,KAAK,EAAE,MAAM,GAAG,sBAAsB;IAOvD,qDAAqD;IAC/C,cAAc,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAQvD;;;;OAIG;IACH,SAAS,CAAC,mBAAmB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,EAAE;IAerD,wFAAwF;IACxF,SAAS,CAAC,WAAW,CAAC,MAAM,EAAE,MAAM,EAAE,GAAG,MAAM,EAAE;IAejD,gFAAgF;IAChF,SAAS,CAAC,UAAU,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE,EAAE,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,GAAG,uBAAuB;IAclG,wFAAwF;IACxF,SAAS,CAAC,iBAAiB,CACzB,QAAQ,EAAE,kBAAkB,GAAG,iBAAiB,EAChD,KAAK,EAAE,MAAM,EACb,KAAK,EAAE,MAAM,EAAE,EACf,UAAU,EAAE,MAAM,EAClB,MAAM,EAAE,MAAM,GACb,IAAI;IAkBP,mDAAmD;IACnD,SAAS,CAAC,cAAc,CAAC,KAAK,EAAE,MAAM,EAAE,GAAG,MAAM;CASlD"}

package/build/_modules/ai/_services/ai-embedding-mock.service.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"ai-embedding-mock.service.js","sourceRoot":"","sources":["../../../../src/_modules/ai/_services/ai-embedding-mock.service.ts"],"names":[],"mappings":"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"}