@futdevpro/nts-dynamo 1.15.151 → 1.15.154

package/src/_modules/ai/_collections/ai-model-config-validator.util.spec.ts

@@ -1,150 +1,150 @@
-import { DyFM_Error } from '@futdevpro/fsm-dynamo';
-import { DyFM_AI_ModelInfo, DyFM_AI_ModelType, DyFM_AI_Provider } from '@futdevpro/fsm-dynamo/ai';
-
-import { DyNTS_AI_ModelConfig_Validator } from './ai-model-config-validator.util';
-
-describe('| DyNTS_AI_ModelConfig_Validator (FR-048 validate-mode)', () => {
-
-  const registry: DyFM_AI_ModelInfo[] = [
-    {
-      id: 'reasoning-model',
-      provider: DyFM_AI_Provider.OpenAI,
-      modelType: DyFM_AI_ModelType.Chat,
-      capabilities: {} as any,
-      settingsSchema: { unsupported: ['temperature', 'topP'] },
-    },
-    {
-      id: 'opus-model',
-      provider: DyFM_AI_Provider.Anthropic,
-      modelType: DyFM_AI_ModelType.Chat,
-      capabilities: {} as any,
-      settingsSchema: { unsupported: ['temperature'] },
-    },
-    {
-      id: 'plain-model',
-      provider: DyFM_AI_Provider.OpenAI,
-      modelType: DyFM_AI_ModelType.Chat,
-      capabilities: {} as any,
-    },
-    {
-      id: 'constrained-model',
-      provider: DyFM_AI_Provider.OpenAI,
-      modelType: DyFM_AI_ModelType.Chat,
-      capabilities: {} as any,
-      settingsSchema: {
-        supported: ['maxTokens', 'reasoningEffort'],
-        constraints: {
-          reasoningEffort: { allowed: ['low', 'medium', 'high'] },
-          maxTokens: { min: 10, max: 100 },
-        },
-      },
-    },
-  ];
-
-  it('| nem tamogatott param → provider-faithful DyFM_Error', () => {
-    const error: DyFM_Error = DyNTS_AI_ModelConfig_Validator.validate({
-      provider: 'open-ai',
-      model: 'reasoning-model',
-      config: { temperature: 0.5 },
-      registry: registry,
-    });
-
-    expect(error instanceof DyFM_Error).toBe(true);
-    expect(error.message).toContain('unsupported_parameter:temperature');
-  });
-
-  it('| csak tamogatott paramok → null (OK)', () => {
-    const error: DyFM_Error = DyNTS_AI_ModelConfig_Validator.validate({
-      provider: 'open-ai',
-      model: 'reasoning-model',
-      config: { maxTokens: 100 },
-      registry: registry,
-    });
-
-    expect(error).toBeNull();
-  });
-
-  it('| Anthropic provider → anthropic-alaku hiba-body', () => {
-    const error: DyFM_Error = DyNTS_AI_ModelConfig_Validator.validate({
-      provider: 'anthropic',
-      model: 'opus-model',
-      config: { temperature: 0.5 },
-      registry: registry,
-    });
-
-    expect(error.message).toContain('invalid_request_error:temperature');
-  });
-
-  it('| schema-mentes modell → null (permisszi­v, nem talalgat)', () => {
-    const error: DyFM_Error = DyNTS_AI_ModelConfig_Validator.validate({
-      provider: 'open-ai',
-      model: 'plain-model',
-      config: { temperature: 0.5 },
-      registry: registry,
-    });
-
-    expect(error).toBeNull();
-  });
-
-  it('| ismeretlen modell → null (permisszi­v)', () => {
-    const error: DyFM_Error = DyNTS_AI_ModelConfig_Validator.validate({
-      provider: 'open-ai',
-      model: 'nincs-ilyen',
-      config: { temperature: 0.5 },
-      registry: registry,
-    });
-
-    expect(error).toBeNull();
-  });
-
-  it('| constraints.allowed megsertve → invalid_value hiba', () => {
-    const error: DyFM_Error = DyNTS_AI_ModelConfig_Validator.validate({
-      provider: 'open-ai',
-      model: 'constrained-model',
-      config: { reasoningEffort: 'ultra' },
-      registry: registry,
-    });
-
-    expect(error instanceof DyFM_Error).toBe(true);
-    expect(error.message).toContain('invalid_value:reasoningEffort');
-  });
-
-  it('| constraints.allowed betartva → null', () => {
-    expect(DyNTS_AI_ModelConfig_Validator.validate({
-      provider: 'open-ai',
-      model: 'constrained-model',
-      config: { reasoningEffort: 'medium' },
-      registry: registry,
-    })).toBeNull();
-  });
-
-  it('| constraints min/max megsertve → invalid_value hiba', () => {
-    const tooHigh: DyFM_Error = DyNTS_AI_ModelConfig_Validator.validate({
-      provider: 'open-ai',
-      model: 'constrained-model',
-      config: { maxTokens: 5000 },
-      registry: registry,
-    });
-
-    expect(tooHigh.message).toContain('invalid_value:maxTokens');
-  });
-
-  it('| constraints tartomanyon belul → null', () => {
-    expect(DyNTS_AI_ModelConfig_Validator.validate({
-      provider: 'open-ai',
-      model: 'constrained-model',
-      config: { maxTokens: 50 },
-      registry: registry,
-    })).toBeNull();
-  });
-
-  it('| config nelkul → null', () => {
-    const error: DyFM_Error = DyNTS_AI_ModelConfig_Validator.validate({
-      provider: 'open-ai',
-      model: 'reasoning-model',
-      registry: registry,
-    });
-
-    expect(error).toBeNull();
-  });
-});
+import { DyFM_Error } from '@futdevpro/fsm-dynamo';
+import { DyFM_AI_ModelInfo, DyFM_AI_ModelType, DyFM_AI_Provider } from '@futdevpro/fsm-dynamo/ai';
+
+import { DyNTS_AI_ModelConfig_Validator } from './ai-model-config-validator.util';
+
+describe('| DyNTS_AI_ModelConfig_Validator (FR-048 validate-mode)', () => {
+
+  const registry: DyFM_AI_ModelInfo[] = [
+    {
+      id: 'reasoning-model',
+      provider: DyFM_AI_Provider.OpenAI,
+      modelType: DyFM_AI_ModelType.Chat,
+      capabilities: {} as any,
+      settingsSchema: { unsupported: ['temperature', 'topP'] },
+    },
+    {
+      id: 'opus-model',
+      provider: DyFM_AI_Provider.Anthropic,
+      modelType: DyFM_AI_ModelType.Chat,
+      capabilities: {} as any,
+      settingsSchema: { unsupported: ['temperature'] },
+    },
+    {
+      id: 'plain-model',
+      provider: DyFM_AI_Provider.OpenAI,
+      modelType: DyFM_AI_ModelType.Chat,
+      capabilities: {} as any,
+    },
+    {
+      id: 'constrained-model',
+      provider: DyFM_AI_Provider.OpenAI,
+      modelType: DyFM_AI_ModelType.Chat,
+      capabilities: {} as any,
+      settingsSchema: {
+        supported: ['maxTokens', 'reasoningEffort'],
+        constraints: {
+          reasoningEffort: { allowed: ['low', 'medium', 'high'] },
+          maxTokens: { min: 10, max: 100 },
+        },
+      },
+    },
+  ];
+
+  it('| nem tamogatott param → provider-faithful DyFM_Error', () => {
+    const error: DyFM_Error = DyNTS_AI_ModelConfig_Validator.validate({
+      provider: 'open-ai',
+      model: 'reasoning-model',
+      config: { temperature: 0.5 },
+      registry: registry,
+    });
+
+    expect(error instanceof DyFM_Error).toBe(true);
+    expect(error.message).toContain('unsupported_parameter:temperature');
+  });
+
+  it('| csak tamogatott paramok → null (OK)', () => {
+    const error: DyFM_Error = DyNTS_AI_ModelConfig_Validator.validate({
+      provider: 'open-ai',
+      model: 'reasoning-model',
+      config: { maxTokens: 100 },
+      registry: registry,
+    });
+
+    expect(error).toBeNull();
+  });
+
+  it('| Anthropic provider → anthropic-alaku hiba-body', () => {
+    const error: DyFM_Error = DyNTS_AI_ModelConfig_Validator.validate({
+      provider: 'anthropic',
+      model: 'opus-model',
+      config: { temperature: 0.5 },
+      registry: registry,
+    });
+
+    expect(error.message).toContain('invalid_request_error:temperature');
+  });
+
+  it('| schema-mentes modell → null (permisszi­v, nem talalgat)', () => {
+    const error: DyFM_Error = DyNTS_AI_ModelConfig_Validator.validate({
+      provider: 'open-ai',
+      model: 'plain-model',
+      config: { temperature: 0.5 },
+      registry: registry,
+    });
+
+    expect(error).toBeNull();
+  });
+
+  it('| ismeretlen modell → null (permisszi­v)', () => {
+    const error: DyFM_Error = DyNTS_AI_ModelConfig_Validator.validate({
+      provider: 'open-ai',
+      model: 'nincs-ilyen',
+      config: { temperature: 0.5 },
+      registry: registry,
+    });
+
+    expect(error).toBeNull();
+  });
+
+  it('| constraints.allowed megsertve → invalid_value hiba', () => {
+    const error: DyFM_Error = DyNTS_AI_ModelConfig_Validator.validate({
+      provider: 'open-ai',
+      model: 'constrained-model',
+      config: { reasoningEffort: 'ultra' },
+      registry: registry,
+    });
+
+    expect(error instanceof DyFM_Error).toBe(true);
+    expect(error.message).toContain('invalid_value:reasoningEffort');
+  });
+
+  it('| constraints.allowed betartva → null', () => {
+    expect(DyNTS_AI_ModelConfig_Validator.validate({
+      provider: 'open-ai',
+      model: 'constrained-model',
+      config: { reasoningEffort: 'medium' },
+      registry: registry,
+    })).toBeNull();
+  });
+
+  it('| constraints min/max megsertve → invalid_value hiba', () => {
+    const tooHigh: DyFM_Error = DyNTS_AI_ModelConfig_Validator.validate({
+      provider: 'open-ai',
+      model: 'constrained-model',
+      config: { maxTokens: 5000 },
+      registry: registry,
+    });
+
+    expect(tooHigh.message).toContain('invalid_value:maxTokens');
+  });
+
+  it('| constraints tartomanyon belul → null', () => {
+    expect(DyNTS_AI_ModelConfig_Validator.validate({
+      provider: 'open-ai',
+      model: 'constrained-model',
+      config: { maxTokens: 50 },
+      registry: registry,
+    })).toBeNull();
+  });
+
+  it('| config nelkul → null', () => {
+    const error: DyFM_Error = DyNTS_AI_ModelConfig_Validator.validate({
+      provider: 'open-ai',
+      model: 'reasoning-model',
+      registry: registry,
+    });
+
+    expect(error).toBeNull();
+  });
+});

package/src/_modules/ai/_collections/ai-model-config-validator.util.ts

@@ -1,131 +1,131 @@
-import { DyFM_Error } from '@futdevpro/fsm-dynamo';
-import {
-  DyFM_AI_ModelInfo,
-  DyFM_AI_ModelRegistry_Util,
-  DyFM_AI_ModelSettingsSchema,
-  DyFM_AI_SettingConstraint,
-} from '@futdevpro/fsm-dynamo/ai';
-
-import { DyNTS_AI_ProviderError } from '../_models/interfaces/dynts-ai-provider-error.interface';
-import { DyNTS_AI_ProviderError_Util } from './ai-provider-error.util';
-
-/**
- * FR-048 **validate-mode** — a per-model `settingsSchema` szerinti config-ellenorzes MUTACIO NELKUL.
- *
- * Testvere a `DyNTS_AI_LLM_ServiceBase.reconcileCallSettings`-nek: a reconciler a hivas elott CSENDBEN
- * dropol/clampel (hogy a hivas atmenjen), ez viszont HIBAT AD — igy hasznalhato **production
- * pre-validaciora** (UI-form submit elott, backend service-boundary-n) es tesztben egyarant.
- * **Ugyanabbol az egy forrasbol** (`settingsSchema`) dolgozik mindketto — nincs parhuzamos szabaly-keszlet.
- *
- * A visszateres `null` = OK; kulonben provider-faithful `DyFM_Error` (a nativ hiba-body az
- * `additionalContent.providerErrorBody`-ban).
- *
- * Ismeretlen modell / schema-mentes registry-bejegyzes → `null` (permisszi­v, best-effort) — NEM talalgatunk.
- */
-export class DyNTS_AI_ModelConfig_Validator {
-
-  /**
-   * Egy hivas-config ellenorzese a modell `settingsSchema`-ja ellen.
-   * @param set - provider + modell + a vizsgalando config + a provider modell-registry-je
-   */
-  static validate(
-    set: {
-      provider: string,
-      model: string,
-      config?: Record<string, unknown>,
-      registry: DyFM_AI_ModelInfo[],
-    }
-  ): DyFM_Error {
-    if (!set.config) {
-      return null;
-    }
-
-    const modelInfo: DyFM_AI_ModelInfo = DyFM_AI_ModelRegistry_Util.findModelInfo(set.registry ?? [], set.model);
-    const schema: DyFM_AI_ModelSettingsSchema = modelInfo?.settingsSchema;
-
-    if (!schema) {
-      return null;
-    }
-
-    // 1) NEM tamogatott parameter (a modell 400-zal elutasitana)
-    for (const param of schema.unsupported ?? []) {
-      if (set.config[param] !== undefined) {
-        return this.toError(
-          DyNTS_AI_ProviderError_Util.buildUnsupportedParamError({
-            provider: set.provider,
-            model: set.model,
-            param: param,
-          })
-        );
-      }
-    }
-
-    // 2) Tamogatott parameter, de ervenytelen ertek (constraints: allowed / min / max)
-    return this.validateConstraints({
-      provider: set.provider,
-      model: set.model,
-      config: set.config,
-      schema: schema,
-    });
-  }
-
-  /** A `constraints` (allowed / min / max) ellenorzese. `null` = OK. */
-  private static validateConstraints(
-    set: {
-      provider: string,
-      model: string,
-      config: Record<string, unknown>,
-      schema: DyFM_AI_ModelSettingsSchema,
-    }
-  ): DyFM_Error {
-    const constraints: Record<string, DyFM_AI_SettingConstraint> = set.schema.constraints ?? {};
-
-    for (const param of Object.keys(constraints)) {
-      const constraint: DyFM_AI_SettingConstraint = constraints[param];
-      const value: unknown = set.config[param];
-
-      if (value === undefined) {
-        continue;
-      }
-
-      if (constraint.allowed?.length && !constraint.allowed.includes(value)) {
-        return this.toError(
-          DyNTS_AI_ProviderError_Util.buildInvalidValueError({
-            provider: set.provider,
-            model: set.model,
-            param: param,
-            detail: `must be one of [${constraint.allowed.join(', ')}]`,
-          })
-        );
-      }
-
-      if (typeof value === 'number') {
-        const belowMin: boolean = typeof constraint.min === 'number' && value < constraint.min;
-        const aboveMax: boolean = typeof constraint.max === 'number' && value > constraint.max;
-
-        if (belowMin || aboveMax) {
-          return this.toError(
-            DyNTS_AI_ProviderError_Util.buildInvalidValueError({
-              provider: set.provider,
-              model: set.model,
-              param: param,
-              detail: `out of range (${constraint.min ?? '-∞'}..${constraint.max ?? '∞'})`,
-            })
-          );
-        }
-      }
-    }
-
-    return null;
-  }
-
-  /** Provider-faithful hiba-leiroból a `DyFM_Error`. */
-  private static toError(providerError: DyNTS_AI_ProviderError): DyFM_Error {
-    return new DyFM_Error({
-      message: `[FR-048] provider-faithful error (HTTP ${providerError.httpStatus}): ${providerError.reason}`,
-      userMessage: 'The AI request contains a parameter this model does not accept.',
-      errorCode: 'DyNTS-AICFG-UNSUP',
-      additionalContent: { providerErrorBody: providerError.providerErrorBody },
-    });
-  }
-}
+import { DyFM_Error } from '@futdevpro/fsm-dynamo';
+import {
+  DyFM_AI_ModelInfo,
+  DyFM_AI_ModelRegistry_Util,
+  DyFM_AI_ModelSettingsSchema,
+  DyFM_AI_SettingConstraint,
+} from '@futdevpro/fsm-dynamo/ai';
+
+import { DyNTS_AI_ProviderError } from '../_models/interfaces/dynts-ai-provider-error.interface';
+import { DyNTS_AI_ProviderError_Util } from './ai-provider-error.util';
+
+/**
+ * FR-048 **validate-mode** — a per-model `settingsSchema` szerinti config-ellenorzes MUTACIO NELKUL.
+ *
+ * Testvere a `DyNTS_AI_LLM_ServiceBase.reconcileCallSettings`-nek: a reconciler a hivas elott CSENDBEN
+ * dropol/clampel (hogy a hivas atmenjen), ez viszont HIBAT AD — igy hasznalhato **production
+ * pre-validaciora** (UI-form submit elott, backend service-boundary-n) es tesztben egyarant.
+ * **Ugyanabbol az egy forrasbol** (`settingsSchema`) dolgozik mindketto — nincs parhuzamos szabaly-keszlet.
+ *
+ * A visszateres `null` = OK; kulonben provider-faithful `DyFM_Error` (a nativ hiba-body az
+ * `additionalContent.providerErrorBody`-ban).
+ *
+ * Ismeretlen modell / schema-mentes registry-bejegyzes → `null` (permisszi­v, best-effort) — NEM talalgatunk.
+ */
+export class DyNTS_AI_ModelConfig_Validator {
+
+  /**
+   * Egy hivas-config ellenorzese a modell `settingsSchema`-ja ellen.
+   * @param set - provider + modell + a vizsgalando config + a provider modell-registry-je
+   */
+  static validate(
+    set: {
+      provider: string,
+      model: string,
+      config?: Record<string, unknown>,
+      registry: DyFM_AI_ModelInfo[],
+    }
+  ): DyFM_Error {
+    if (!set.config) {
+      return null;
+    }
+
+    const modelInfo: DyFM_AI_ModelInfo = DyFM_AI_ModelRegistry_Util.findModelInfo(set.registry ?? [], set.model);
+    const schema: DyFM_AI_ModelSettingsSchema = modelInfo?.settingsSchema;
+
+    if (!schema) {
+      return null;
+    }
+
+    // 1) NEM tamogatott parameter (a modell 400-zal elutasitana)
+    for (const param of schema.unsupported ?? []) {
+      if (set.config[param] !== undefined) {
+        return this.toError(
+          DyNTS_AI_ProviderError_Util.buildUnsupportedParamError({
+            provider: set.provider,
+            model: set.model,
+            param: param,
+          })
+        );
+      }
+    }
+
+    // 2) Tamogatott parameter, de ervenytelen ertek (constraints: allowed / min / max)
+    return this.validateConstraints({
+      provider: set.provider,
+      model: set.model,
+      config: set.config,
+      schema: schema,
+    });
+  }
+
+  /** A `constraints` (allowed / min / max) ellenorzese. `null` = OK. */
+  private static validateConstraints(
+    set: {
+      provider: string,
+      model: string,
+      config: Record<string, unknown>,
+      schema: DyFM_AI_ModelSettingsSchema,
+    }
+  ): DyFM_Error {
+    const constraints: Record<string, DyFM_AI_SettingConstraint> = set.schema.constraints ?? {};
+
+    for (const param of Object.keys(constraints)) {
+      const constraint: DyFM_AI_SettingConstraint = constraints[param];
+      const value: unknown = set.config[param];
+
+      if (value === undefined) {
+        continue;
+      }
+
+      if (constraint.allowed?.length && !constraint.allowed.includes(value)) {
+        return this.toError(
+          DyNTS_AI_ProviderError_Util.buildInvalidValueError({
+            provider: set.provider,
+            model: set.model,
+            param: param,
+            detail: `must be one of [${constraint.allowed.join(', ')}]`,
+          })
+        );
+      }
+
+      if (typeof value === 'number') {
+        const belowMin: boolean = typeof constraint.min === 'number' && value < constraint.min;
+        const aboveMax: boolean = typeof constraint.max === 'number' && value > constraint.max;
+
+        if (belowMin || aboveMax) {
+          return this.toError(
+            DyNTS_AI_ProviderError_Util.buildInvalidValueError({
+              provider: set.provider,
+              model: set.model,
+              param: param,
+              detail: `out of range (${constraint.min ?? '-∞'}..${constraint.max ?? '∞'})`,
+            })
+          );
+        }
+      }
+    }
+
+    return null;
+  }
+
+  /** Provider-faithful hiba-leiroból a `DyFM_Error`. */
+  private static toError(providerError: DyNTS_AI_ProviderError): DyFM_Error {
+    return new DyFM_Error({
+      message: `[FR-048] provider-faithful error (HTTP ${providerError.httpStatus}): ${providerError.reason}`,
+      userMessage: 'The AI request contains a parameter this model does not accept.',
+      errorCode: 'DyNTS-AICFG-UNSUP',
+      additionalContent: { providerErrorBody: providerError.providerErrorBody },
+    });
+  }
+}