@futdevpro/nts-dynamo 1.15.157 → 1.15.163

package/src/_modules/admin-auth/admin-api-key.auth-service.ts

@@ -1,220 +0,0 @@
-import { Request, Response } from 'express';
-import * as crypto from 'crypto';
-
-import { DyFM_Error } from '@futdevpro/fsm-dynamo';
-
-import { DyNTS_SingletonServiceBase } from '../../_services/base/singleton.service-base';
-import { DyNTS_global_settings } from '../../_collections/global-settings.const';
-
-import { DyNTS_AdminApiKey_Config } from './_models/admin-api-key-config.interface';
-
-
-/** Default env var nev az admin API key-hez. */
-const DEFAULT_ENV_VAR_NAME: string = 'DYNTS_ADMIN_API_KEY';
-
-/** Default header nev (Express lowercase-re normalizalja az osszes header-t). */
-const DEFAULT_HEADER_NAME: string = 'x-admin-api-key';
-
-/** Default Bearer fallback engedelyezve van. */
-const DEFAULT_ALLOW_BEARER: boolean = true;
-
-/** Service-nev az error-okhoz. */
-const SERVICE_NAME: string = 'DyNTS_AdminApiKey_AuthService';
-
-/** ErrorCode prefix — system shortcode + saját kod. */
-const buildErrorCode = (subcode: string): string => {
-  const sys: string = DyNTS_global_settings.systemShortCodeName ?? 'DyNTS';
-  return `${sys}|DyNTS-AAK-${subcode}`;
-};
-
-
-/**
- * Admin API key auth service — opt-in HTTP guard a meglevo `DyNTS_Endpoint_Params.preProcesses`
- * mechanizmushoz. Egy env var-ban tarolt fix kulccsal valid-alja a bejovo kerest.
- *
- * **Hasznalat (host app):**
- * ```ts
- * const adminAuth = DyNTS_AdminApiKey_AuthService.getInstance();
- * // opcionalis konfig:
- * // adminAuth.configure({ envVarName: 'MY_KEY', headerName: 'x-my-key' });
- *
- * new DyNTS_Endpoint_Params({
- *   ...,
- *   preProcesses: [adminAuth.verify, ...other],
- * });
- *
- * // vagy a logs routing module-on at
- * DyNTS_getLogsRoutingModule({ authPreProcess: adminAuth.verify });
- * ```
- *
- * **Viselkedes:**
- * - env var beallitva ES helyes header → silent pass
- * - env var beallitva, header hianyzik / rossz → 401 DyFM_Error
- * - env var NINCS beallitva → 500 DyFM_Error (fail-closed; NEM silent allow)
- *
- * **Header lookup:**
- * 1. `x-admin-api-key` (default canonical header)
- * 2. `Authorization: Bearer <key>` (fallback ha `allowAuthorizationBearer === true`)
- *
- * **Timing-safe:** `crypto.timingSafeEqual` Buffer-konvertalassal. Length-mismatch
- * eseten dummy compare-rel azonos idő, hogy a kulcs-hossz ne szivarogjon ki.
- *
- * **Env var read-on-each-call:** a `verify()` minden hivasnal olvassa az env-et,
- * nem cache-eli. Igy a host az env-et utolagosan is allithatja (pl. config
- * loader az auth.service.install() utan).
- *
- * **Singleton:** `getInstance()`-szel hivd. A `.verify` mezo binding-elve van
- * `this`-re, igy direkt atadhato `preProcesses`-be ujracsomagolas nelkul.
- */
-export class DyNTS_AdminApiKey_AuthService extends DyNTS_SingletonServiceBase {
-
-  static getInstance(): DyNTS_AdminApiKey_AuthService {
-    return DyNTS_AdminApiKey_AuthService.getSingletonInstance() as DyNTS_AdminApiKey_AuthService;
-  }
-
-  private envVarName: string = DEFAULT_ENV_VAR_NAME;
-  private headerName: string = DEFAULT_HEADER_NAME;
-  private allowAuthorizationBearer: boolean = DEFAULT_ALLOW_BEARER;
-
-
-  /**
-   * Konfig override. Hianyzo mezok a default-okat orzik.
-   * Hivhato barmikor — a `verify()` a friss config-ot olvassa.
-   */
-  configure(config: DyNTS_AdminApiKey_Config): void {
-    if (config.envVarName !== undefined) {
-      this.envVarName = config.envVarName;
-    }
-    if (config.headerName !== undefined) {
-      // Express lowercase-re normalizal — itt is lowercase-eljuk a konzisztenciaert
-      this.headerName = config.headerName.toLowerCase();
-    }
-    if (config.allowAuthorizationBearer !== undefined) {
-      this.allowAuthorizationBearer = config.allowAuthorizationBearer;
-    }
-  }
-
-  /**
-   * Aktualis konfig olvasasa (test/diagnosztika celokra).
-   */
-  getConfig(): Required<DyNTS_AdminApiKey_Config> {
-    return {
-      envVarName:               this.envVarName,
-      headerName:               this.headerName,
-      allowAuthorizationBearer: this.allowAuthorizationBearer,
-    };
-  }
-
-  /**
-   * Pre-process function — atadhato `DyNTS_Endpoint_Params.preProcesses`-be,
-   * vagy `DyNTS_getLogsRoutingModule({ authPreProcess: ... })`-be.
-   *
-   * Throws:
-   *   - 500 ha az env var nincs beallitva (vagy ures string)
-   *   - 401 ha a header hianyzik vagy nem egyezik
-   *
-   * A `req`/`res` parametereket NEM modositja (a kerest tovabb engedi a tovabbi
-   * preProcess-eknek; csak hiba eseten throw-ol).
-   */
-  readonly verify = async (req: Request, _res: Response): Promise<void> => {
-    const expectedKey: string = process.env[this.envVarName] ?? '';
-    if (expectedKey.length === 0) {
-      throw new DyFM_Error({
-        status: 500,
-        errorCode: buildErrorCode('CONFIG'),
-        addECToUserMsg: true,
-        message: `Admin API key not configured: env var ${this.envVarName} is not set or empty`,
-        userMessage: 'Server configuration error',
-        issuerService: SERVICE_NAME,
-      });
-    }
-
-    const providedKey: string | null = this.extractKeyFromRequest(req);
-    if (providedKey === null) {
-      throw new DyFM_Error({
-        status: 401,
-        errorCode: buildErrorCode('MISSING'),
-        addECToUserMsg: true,
-        message: `Admin API key required (expected header: ${this.headerName})`,
-        userMessage: 'Admin API key required',
-        issuerService: SERVICE_NAME,
-      });
-    }
-
-    if (!this.timingSafeEquals(providedKey, expectedKey)) {
-      throw new DyFM_Error({
-        status: 401,
-        errorCode: buildErrorCode('INVALID'),
-        addECToUserMsg: true,
-        message: 'Admin API key invalid',
-        userMessage: 'Admin API key invalid',
-        issuerService: SERVICE_NAME,
-      });
-    }
-
-    // Silent pass — return resolved promise
-  };
-
-
-  /**
-   * Header lookup — elobb a primer header, aztan opcionalisan az Authorization Bearer.
-   * Az ures string is "hianyzo"-nak szamit (a Buffer.from('') es timingSafeEqual
-   * konzisztencia miatt).
-   */
-  private extractKeyFromRequest(req: Request): string | null {
-    // Primer header
-    const primary: unknown = req.headers[this.headerName];
-    const primaryStr: string = Array.isArray(primary) ? primary[0] ?? '' : (typeof primary === 'string' ? primary : '');
-    if (primaryStr.length > 0) {
-      return primaryStr;
-    }
-
-    // Authorization Bearer fallback
-    if (this.allowAuthorizationBearer) {
-      const authHeader: unknown = req.headers['authorization'];
-      const authStr: string = Array.isArray(authHeader) ? authHeader[0] ?? '' : (typeof authHeader === 'string' ? authHeader : '');
-      if (authStr.toLowerCase().startsWith('bearer ')) {
-        const token: string = authStr.substring(7).trim();
-        if (token.length > 0) {
-          return token;
-        }
-      }
-    }
-
-    return null;
-  }
-
-  /**
-   * Timing-safe compare ket string kozott. Length-mismatch eseten egy dummy
-   * compare-rel azonos idot kenyszeritunk (a kulcs-hossz nem szivaroghat ki
-   * timing-attackal).
-   *
-   * crypto.timingSafeEqual KOTELEZOEN azonos Buffer-hosszt var — kulonbozo
-   * hosszra throw-ol, ezert vizsgaljuk elobb a length-et es csak utana
-   * compare-elunk.
-   */
-  private timingSafeEquals(a: string, b: string): boolean {
-    const aBuf: Buffer = Buffer.from(a, 'utf-8');
-    const bBuf: Buffer = Buffer.from(b, 'utf-8');
-
-    if (aBuf.length !== bBuf.length) {
-      // Dummy compare ugyanazzal a string-gel: konstans ideju mukodest biztosit
-      // mielott visszaternenk false-szal — igy a length-mismatch nem szivaroghat ki.
-      crypto.timingSafeEqual(bBuf, bBuf);
-      return false;
-    }
-
-    return crypto.timingSafeEqual(aBuf, bBuf);
-  }
-
-
-  /**
-   * Test-only: visszaallitja a default config-ot, hogy a specfajlok ne szivarogjak
-   * at egymas state-jet. Production code NE hivja.
-   */
-  _resetForTesting(): void {
-    this.envVarName               = DEFAULT_ENV_VAR_NAME;
-    this.headerName               = DEFAULT_HEADER_NAME;
-    this.allowAuthorizationBearer = DEFAULT_ALLOW_BEARER;
-  }
-}

package/src/_modules/admin-auth/index.ts

@@ -1,2 +0,0 @@
-export { DyNTS_AdminApiKey_AuthService } from './admin-api-key.auth-service';
-export { DyNTS_AdminApiKey_Config } from './_models/admin-api-key-config.interface';

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

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

package/src/_modules/ai/_collections/ai-provider-error.util.ts

@@ -1,144 +0,0 @@
-import { DyFM_AI_Provider } from '@futdevpro/fsm-dynamo/ai';
-
-import { DyNTS_AI_ProviderError } from '../_models/interfaces/dynts-ai-provider-error.interface';
-
-/**
- * Provider-faithful hiba-alakok eloallitasa a FR-048 `settingsSchema` szabalysertesekhez — ugyanaz a
- * hiba-alak, mint amit a valodi provider adna. A forras-igazsag a `settingsSchema` (SSoT); itt CSAK a
- * hiba formazasa tortenik, szabaly-duplikatum nincs.
- *
- * **Pontossag (D4):** a hiba **strukturaja** (mezok + `code`/`type`) a dokumentalt provider-alak szerint
- * keszult; a `message` SZOVEGE a valodi capture-ig kozelites. A gepileg fogyasztott resz (`reason`, `code`,
- * `param`, `httpStatus`) a stabil — a byte-hu message a fixture-capture passzal pontosithato.
- */
-export class DyNTS_AI_ProviderError_Util {
-
-  /** Az Anthropic provider-azonositoja (a hiba-alak valasztasahoz) — az enumbol, nem beegetett stringkent. */
-  private static readonly anthropicProviderId: string = DyFM_AI_Provider.Anthropic;
-
-  /**
-   * Nem tamogatott parameter → provider-hu HTTP 400 hiba-leiro.
-   * @param set - provider-azonosito + modell-azonosito + a kifogasolt parameter neve
-   */
-  static buildUnsupportedParamError(
-    set: {
-      provider: string,
-      model: string,
-      param: string,
-    }
-  ): DyNTS_AI_ProviderError {
-    if (set.provider === this.anthropicProviderId) {
-      return {
-        httpStatus: 400,
-        providerErrorBody: {
-          type: 'error',
-          error: {
-            type: 'invalid_request_error',
-            // MERT (capture 2026-07-21, claude-opus-4-8 + temperature): a valodi uzenet ez, NEM a korabbi
-            // kozelitesem ("Extra inputs are not permitted").
-            message: `\`${set.param}\` is deprecated for this model.`,
-          },
-          // VERIFIED (capture 2026-07-21): a valodi Anthropic hiba-body TOP-LEVEL `request_id`-t is hoz —
-          // ez korabban hianyzott a sablonbol. Fixture-oknel a rogzitett valodi ertek szerepel; itt
-          // szintetikus placeholder, hogy az ALAK hu legyen.
-          request_id: 'req_mock',
-        },
-        reason: `invalid_request_error:${set.param}`,
-      };
-    }
-
-    return {
-      httpStatus: 400,
-      providerErrorBody: {
-        error: {
-          message: `Unsupported parameter: '${set.param}' is not supported with model '${set.model}'.`,
-          type: 'invalid_request_error',
-          param: set.param,
-          code: 'unsupported_parameter',
-        },
-      },
-      reason: `unsupported_parameter:${set.param}`,
-    };
-  }
-
-  /**
-   * Tamogatott parameter, de ERVENYTELEN ertek (tartomanyon kivul, vagy nem az engedett keszletbol) →
-   * provider-hu HTTP 400. Ez a `settingsSchema.constraints` (min/max/allowed) megsertese.
-   * @param set - provider + modell + parameter-nev + a rovid indoklas (pl. 'out of range 0..2')
-   */
-  static buildInvalidValueError(
-    set: {
-      provider: string,
-      model: string,
-      param: string,
-      detail: string,
-    }
-  ): DyNTS_AI_ProviderError {
-    if (set.provider === this.anthropicProviderId) {
-      return {
-        httpStatus: 400,
-        providerErrorBody: {
-          type: 'error',
-          error: {
-            type: 'invalid_request_error',
-            message: `${set.param}: ${set.detail} (model '${set.model}').`,
-          },
-        },
-        reason: `invalid_request_error:${set.param}`,
-      };
-    }
-
-    // MERT (capture 2026-07-21, gpt-4o-mini + temperature: 3): a valodi OpenAI range-hiba kodja
-    // `decimal_above_max_value`, NEM az altalam felteteleztt `invalid_value`, es a message formatuma ez:
-    //   "Invalid 'temperature': decimal above maximum value. Expected a value <= 2, but got 3 instead."
-    return {
-      httpStatus: 400,
-      providerErrorBody: {
-        error: {
-          message: `Invalid '${set.param}': ${set.detail}.`,
-          type: 'invalid_request_error',
-          param: set.param,
-          code: 'decimal_above_max_value',
-        },
-      },
-      reason: `invalid_value:${set.param}`,
-    };
-  }
-
-  /**
-   * Ismeretlen modell → **HTTP 404** (NEM 400), `code: 'model_not_found'`.
-   * MERT (capture 2026-07-21): `The model \`X\` does not exist or you do not have access to it.`
-   * @param set - provider + a nem letezo modell-azonosito
-   */
-  static buildModelNotFoundError(
-    set: {
-      provider: string,
-      model: string,
-    }
-  ): DyNTS_AI_ProviderError {
-    if (set.provider === this.anthropicProviderId) {
-      return {
-        httpStatus: 404,
-        providerErrorBody: {
-          type: 'error',
-          error: { type: 'not_found_error', message: `model: ${set.model}` },
-          request_id: 'req_mock',
-        },
-        reason: `not_found_error:${set.model}`,
-      };
-    }
-
-    return {
-      httpStatus: 404,
-      providerErrorBody: {
-        error: {
-          message: `The model \`${set.model}\` does not exist or you do not have access to it.`,
-          type: 'invalid_request_error',
-          param: null,
-          code: 'model_not_found',
-        },
-      },
-      reason: `model_not_found:${set.model}`,
-    };
-  }
-}