@futdevpro/nts-dynamo 1.15.58 → 1.15.64

package/src/_modules/ai/_modules/document-ai/_collections/dai-code-chunking.util.ts

@@ -1,5 +1,7 @@
 import * as ts from 'typescript';
+
 import { DyFM_Log } from '@futdevpro/fsm-dynamo';
+
 import { DyNTS_DAI_CodeChunk, DyNTS_DAI_CodeChunkType } from '../_models/interfaces/dai-code-chunk.interface';
 
 /** A kód-chunker méret-paraméterei (a FAM/CCAP konstansokkal egyező default-ok). */
@@ -80,13 +82,14 @@ export class DyNTS_DAI_CodeChunking_Util {
    * @returns A szemantikus kód-chunkok listája (0-alapú `chunkIndex`-szel).
    */
   static chunkTs(code: string, opts?: DyNTS_DAI_CodeChunking_Options): DyNTS_DAI_CodeChunk[] {
-    if (!code || !code.trim()) {
+    if (!code?.trim()) {
       return [];
     }
 
     const sizing: DyNTS_DAI_CodeChunking_Sizing = this.resolveSizing(opts);
 
     let blocks: DyNTS_DAI_CodeBlock[] = [];
+
     try {
       const sourceFile: ts.SourceFile = ts.createSourceFile(
         'chunk-input.ts',
@@ -95,6 +98,7 @@ export class DyNTS_DAI_CodeChunking_Util {
         /* setParentNodes */ true,
         ts.ScriptKind.TSX
       );
+
       blocks = this.identifyBlocks(sourceFile, code, sizing);
     } catch (error) {
       // Parse-hiba (degenerált forrás) → a tiny-fallback veszi át lentebb.
@@ -114,6 +118,7 @@ export class DyNTS_DAI_CodeChunking_Util {
     const lineStartOffsets: number[] = this.computeLineStartOffsets(code);
 
     const chunks: DyNTS_DAI_CodeChunk[] = [];
+
     for (const block of blocks) {
       // Zaj-szűrés: CSAK a névtelen `generic` blokkokat dobjuk a minChunkSize alatt. A nevesített
       // szemantikus deklarációk (type-alias / rövid function / class-fej / metódus / interface /
@@ -156,11 +161,13 @@ export class DyNTS_DAI_CodeChunking_Util {
     if (this.isTsLike(filename)) {
       return this.chunkTs(content, opts);
     }
+
     // Nem-kód (pl. .md / .txt / ismeretlen): nyers fallback chunkok — a tartalmat megőrizzük,
     // de NEM próbáljuk szemantikusan darabolni (a markdown-darabolás külön util-é).
-    if (!content || !content.trim()) {
+    if (!content?.trim()) {
       return [];
     }
+
     return this.buildFallbackChunks(content, this.resolveSizing(opts));
   }
 
@@ -174,6 +181,7 @@ export class DyNTS_DAI_CodeChunking_Util {
     const maxChunkSize: number = Math.max(1, opts?.maxChunkSize ?? this.DEFAULT_MAX_CHUNK_SIZE);
     const overlap: number = Math.max(0, Math.min(opts?.overlap ?? this.DEFAULT_OVERLAP, maxChunkSize - 1));
     const minChunkSize: number = Math.max(0, opts?.minChunkSize ?? this.DEFAULT_MIN_CHUNK_SIZE);
+
     return { maxChunkSize: maxChunkSize, overlap: overlap, minChunkSize: minChunkSize };
   }
 
@@ -198,6 +206,7 @@ export class DyNTS_DAI_CodeChunking_Util {
         return;
       }
       const text: string = code.substring(importStart, importEnd);
+
       if (text.trim().length) {
         blocks.push({
           text: text,
@@ -215,6 +224,7 @@ export class DyNTS_DAI_CodeChunking_Util {
     for (const statement of sourceFile.statements) {
       if (this.isImportLike(statement)) {
         const start: number = statement.getStart(sourceFile, /* includeJsDocComment */ true);
+
         if (importStart < 0) {
           importStart = start;
         }
@@ -229,7 +239,7 @@ export class DyNTS_DAI_CodeChunking_Util {
       const start: number = statement.getStart(sourceFile, /* includeJsDocComment */ true);
       const end: number = statement.getEnd();
       const text: string = code.substring(start, end);
-      const symbolSegments: string[] = detected.name ? [`${detected.chunkType}:${detected.name}`] : [];
+      const symbolSegments: string[] = detected.name ? [ `${detected.chunkType}:${detected.name}` ] : [];
 
       // Nagy osztály → metódusonkénti bontás (osztály-fej + metódusok).
       if (ts.isClassDeclaration(statement) && text.length > sizing.maxChunkSize) {
@@ -258,10 +268,12 @@ export class DyNTS_DAI_CodeChunking_Util {
     if (ts.isImportDeclaration(statement) || ts.isImportEqualsDeclaration(statement)) {
       return true;
     }
+
     // `export { ... } from '...'` / `export * from '...'` — csak ha van moduleSpecifier.
     if (ts.isExportDeclaration(statement) && !!statement.moduleSpecifier) {
       return true;
     }
+
     return false;
   }
 
@@ -270,18 +282,23 @@ export class DyNTS_DAI_CodeChunking_Util {
     if (ts.isClassDeclaration(statement)) {
       return { chunkType: 'class', name: statement.name?.getText() };
     }
+
     if (ts.isInterfaceDeclaration(statement)) {
       return { chunkType: 'interface', name: statement.name.getText() };
     }
+
     if (ts.isEnumDeclaration(statement)) {
       return { chunkType: 'enum', name: statement.name.getText() };
     }
+
     if (ts.isTypeAliasDeclaration(statement)) {
       return { chunkType: 'type', name: statement.name.getText() };
     }
+
     if (ts.isFunctionDeclaration(statement)) {
       return { chunkType: 'function', name: statement.name?.getText() };
     }
+
     if (ts.isVariableStatement(statement)) {
       const firstDecl: ts.VariableDeclaration | undefined = statement.declarationList.declarations[0];
       const name: string | undefined = firstDecl && ts.isIdentifier(firstDecl.name)
@@ -291,8 +308,10 @@ export class DyNTS_DAI_CodeChunking_Util {
       const initializer: ts.Expression | undefined = firstDecl?.initializer;
       const isFn: boolean = !!initializer
         && (ts.isArrowFunction(initializer) || ts.isFunctionExpression(initializer));
+
       return { chunkType: isFn ? 'function' : 'variable', name: name };
     }
+
     return { chunkType: 'generic', name: undefined };
   }
 
@@ -311,18 +330,19 @@ export class DyNTS_DAI_CodeChunking_Util {
     const classSegment: string = `class:${className ?? 'anonymous'}`;
     const classStart: number = classDecl.getStart(sourceFile, /* includeJsDocComment */ true);
 
-    const members: ts.ClassElement[] = [...classDecl.members];
+    const members: ts.ClassElement[] = [ ...classDecl.members ];
 
     // Osztály-fej: a class kezdetétől az első tag kezdetéig (dekorátorok/JSDoc + `class X {`-rész).
     const headerEnd: number = members.length
       ? members[0].getStart(sourceFile, /* includeJsDocComment */ true)
       : classDecl.getEnd();
     const headerText: string = code.substring(classStart, headerEnd);
+
     if (headerText.trim().length) {
       blocks.push({
         text: headerText,
         chunkType: 'class',
-        symbolSegments: [classSegment],
+        symbolSegments: [ classSegment ],
         symbolName: className,
         charStart: classStart,
         charEnd: headerEnd,
@@ -334,6 +354,7 @@ export class DyNTS_DAI_CodeChunking_Util {
       const memberStart: number = member.getStart(sourceFile, /* includeJsDocComment */ true);
       const memberEnd: number = member.getEnd();
       const memberText: string = code.substring(memberStart, memberEnd);
+
       if (!memberText.trim().length) {
         continue;
       }
@@ -349,7 +370,7 @@ export class DyNTS_DAI_CodeChunking_Util {
       blocks.push({
         text: memberText,
         chunkType: memberKind,
-        symbolSegments: [classSegment, memberSegment],
+        symbolSegments: [ classSegment, memberSegment ],
         symbolName: memberName,
         charStart: memberStart,
         charEnd: memberEnd,
@@ -367,6 +388,7 @@ export class DyNTS_DAI_CodeChunking_Util {
     ) {
       return 'method';
     }
+
     return 'variable';
   }
 
@@ -378,6 +400,7 @@ export class DyNTS_DAI_CodeChunking_Util {
   ): DyNTS_DAI_CodeChunk {
     const lineStart: number = this.lineOfOffset(block.charStart, lineStartOffsets);
     const lineEnd: number = this.lineOfOffset(Math.max(block.charStart, block.charEnd - 1), lineStartOffsets);
+
     return {
       content: block.text,
       chunkType: block.chunkType,
@@ -448,6 +471,7 @@ export class DyNTS_DAI_CodeChunking_Util {
    */
   private static buildFallbackChunks(content: string, sizing: DyNTS_DAI_CodeChunking_Sizing): DyNTS_DAI_CodeChunk[] {
     const trimmed: string = content.trim();
+
     if (!trimmed) {
       return [];
     }
@@ -457,6 +481,7 @@ export class DyNTS_DAI_CodeChunking_Util {
     // Kis tartalom → egyetlen fallback chunk.
     if (content.length <= sizing.maxChunkSize) {
       const lineEnd: number = this.lineOfOffset(Math.max(0, content.length - 1), lineStartOffsets);
+
       return [{
         content: content,
         chunkType: 'fallback',
@@ -481,7 +506,9 @@ export class DyNTS_DAI_CodeChunking_Util {
       charEnd: content.length,
     };
     const out: DyNTS_DAI_CodeChunk[] = [];
+
     this.splitLargeBlock(fallbackBlock, sizing, out, lineStartOffsets);
+
     return out;
   }
 
@@ -491,12 +518,14 @@ export class DyNTS_DAI_CodeChunking_Util {
    * konverziót ad a chunkokhoz.
    */
   private static computeLineStartOffsets(source: string): number[] {
-    const offsets: number[] = [0];
+    const offsets: number[] = [ 0 ];
+
     for (let i: number = 0; i < source.length; i++) {
       if (source[i] === '\n') {
         offsets.push(i + 1);
       }
     }
+
     return offsets;
   }
 
@@ -507,14 +536,17 @@ export class DyNTS_DAI_CodeChunking_Util {
   private static lineOfOffset(offset: number, lineStartOffsets: number[]): number {
     let lo: number = 0;
     let hi: number = lineStartOffsets.length - 1;
+
     while (lo < hi) {
       const mid: number = (lo + hi + 1) >> 1;
+
       if (lineStartOffsets[mid] <= offset) {
         lo = mid;
       } else {
         hi = mid - 1;
       }
     }
+
     return lo + 1;
   }
 }

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

@@ -1,11 +1,11 @@
 import * as crypto from 'crypto';
-
 import { CreateEmbeddingResponse } from 'openai/resources';
+
 import { DyFM_AI_Provider, DyFM_AI_ProviderCapabilities, DyFM_AI_Config } from '@futdevpro/fsm-dynamo/ai';
 import { DyFM_DAI_EmbeddingInfo } from '@futdevpro/fsm-dynamo/ai/document-ai';
 
-import { DyNTS_AI_Embedding_ServiceBase } from './ai-embedding.service-base';
 import { DyNTS_AI_CostEventCallback } from '../_models/interfaces/dynts-ai-cost-event-callback.interface';
+import { DyNTS_AI_Embedding_ServiceBase } from './ai-embedding.service-base';
 
 /** A mock-embedding default dimenziója (kicsi, hogy a teszt-pool gyors legyen, de elég a koszinuszhoz). */
 export const DyNTS_AI_MOCK_EMBEDDING_DIMS: number = 64;
@@ -61,6 +61,7 @@ export class DyNTS_AI_Embedding_MockService extends DyNTS_AI_Embedding_ServiceBa
   constructor(set?: DyNTS_AI_Embedding_MockSettings) {
     super();
     this.dims = set?.dims && set.dims > 0 ? set.dims : DyNTS_AI_MOCK_EMBEDDING_DIMS;
+
     if (set?.onCostEvent) {
       this.onCostEvent = set.onCostEvent;
     }
@@ -69,6 +70,7 @@ export class DyNTS_AI_Embedding_MockService extends DyNTS_AI_Embedding_ServiceBa
   /** A mock-nak nincs külső config-ja; a `setup` a dimenzió override-jára szolgál (config.dimensions). */
   setup(config: DyFM_AI_Config): void {
     const dims: unknown = Reflect.get(config ?? {}, 'dimensions');
+
     if (typeof dims === 'number' && dims > 0) {
       this.dims = dims;
     }
@@ -90,11 +92,12 @@ export class DyNTS_AI_Embedding_MockService extends DyNTS_AI_Embedding_ServiceBa
     const vector: number[] = this.deterministicVector(`${set.model}::${set.text ?? ''}`);
     const durationMs: number = Date.now() - start;
 
-    this.emitMockCostEvent('embedding-single', set.model, [set.text ?? ''], durationMs, set.issuer);
+    this.emitMockCostEvent('embedding-single', set.model, [ set.text ?? '' ], durationMs, set.issuer);
 
     if (set.fullResponse) {
-      return this.toResponse([vector], set.model, [set.text ?? '']);
+      return this.toResponse([ vector ], set.model, [ set.text ?? '' ]);
     }
+
     return vector;
   }
 
@@ -120,6 +123,7 @@ export class DyNTS_AI_Embedding_MockService extends DyNTS_AI_Embedding_ServiceBa
     if (set.fullResponse) {
       return this.toResponse(vectors, set.model, texts);
     }
+
     return vectors;
   }
 
@@ -148,31 +152,38 @@ export class DyNTS_AI_Embedding_MockService extends DyNTS_AI_Embedding_ServiceBa
   protected deterministicVector(seed: string): number[] {
     const hash: Buffer = crypto.createHash('sha256').update(seed).digest();
     const vector: number[] = [];
+
     for (let i = 0; i < this.dims; i++) {
       const byte: number = hash[i % hash.length];
       const mix: number = hash[(i * 7 + 3) % hash.length];
       const combined: number = (byte ^ mix) & 0xff;
+
       vector.push((combined / 255) * 2 - 1);
     }
+
     return this.l2Normalize(vector);
   }
 
   /** L2-normalizálás (egységhossz). Nulla-vektor → változatlan (elkerüli a 0-osztást). */
   protected l2Normalize(vector: number[]): number[] {
     let sumSq: number = 0;
+
     for (const value of vector) {
       sumSq += value * value;
     }
     const norm: number = Math.sqrt(sumSq);
+
     if (!norm) {
       return vector;
     }
+
     return vector.map((value) => value / norm);
   }
 
   /** OpenAI-alakú válasz-objektum a vektorokból (a `fullResponse=true` ághoz). */
   protected toResponse(vectors: number[][], model: string, texts: string[]): CreateEmbeddingResponse {
     const tokens: number = this.estimateTokens(texts);
+
     return {
       object: 'list',
       model: model,
@@ -193,6 +204,7 @@ export class DyNTS_AI_Embedding_MockService extends DyNTS_AI_Embedding_ServiceBa
     issuer: string,
   ): void {
     const tokens: number = this.estimateTokens(texts);
+
     this.emitCostEvent({
       callType: callType,
       provider: this.costProvider,
@@ -211,9 +223,11 @@ export class DyNTS_AI_Embedding_MockService extends DyNTS_AI_Embedding_ServiceBa
   /** Becsült (fake) token-szám: 4 char ≈ 1 token. */
   protected estimateTokens(texts: string[]): number {
     let chars: number = 0;
+
     for (const text of texts) {
       chars += (text ?? '').length;
     }
+
     return Math.max(1, Math.ceil(chars / 4));
   }
 }

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

@@ -60,12 +60,14 @@ export class DyNTS_AI_EmbeddingProvider_Registry {
         });
       case 'lmstudio': {
         const baseUrl: string | undefined = options?.lmStudioSettings?.baseUrl ?? process.env.LMSTUDIO_BASE_URL;
+
         if (!baseUrl) {
           throw new Error(
             'DyNTS_AI_EmbeddingProvider_Registry: the lmstudio provider was selected but no baseUrl '
             + 'was provided (set lmStudioSettings.baseUrl or the LMSTUDIO_BASE_URL env var).',
           );
         }
+
         return new DyNTS_LMStudio_Embedding_ControlService({
           baseUrl: baseUrl,
           apiKey: options?.lmStudioSettings?.apiKey ?? process.env.LMSTUDIO_API_KEY,
@@ -86,6 +88,7 @@ export class DyNTS_AI_EmbeddingProvider_Registry {
    */
   static normalizeKey(provider?: string): DyNTS_AI_EmbeddingProviderKey {
     const raw: string = (provider ?? process.env.AI_EMBEDDING_PROVIDER ?? 'openai').trim().toLowerCase();
+
     switch (raw) {
       case 'openai':
       case 'open-ai':
@@ -100,6 +103,7 @@ export class DyNTS_AI_EmbeddingProvider_Registry {
       case 'fake':
       case 'test':
         return 'mock';
+
       default:
         throw new Error(
           `DyNTS_AI_EmbeddingProvider_Registry: unknown embedding provider '${raw}'. `

package/src/_modules/ai/_services/lmstudio-embedding.control-service.ts

@@ -1,11 +1,12 @@
 import { CreateEmbeddingResponse } from 'openai/resources';
+
+import { DyFM_Error, DyFM_Log } from '@futdevpro/fsm-dynamo';
 import { DyFM_AI_Provider, DyFM_AI_ProviderCapabilities, DyFM_AI_Config } from '@futdevpro/fsm-dynamo/ai';
 import { DyFM_DAI_EmbeddingInfo } from '@futdevpro/fsm-dynamo/ai/document-ai';
-import { DyFM_Error, DyFM_Log } from '@futdevpro/fsm-dynamo';
 
-import { DyNTS_AI_Embedding_ServiceBase } from './ai-embedding.service-base';
 import { DyNTS_AI_CostEventCallback } from '../_models/interfaces/dynts-ai-cost-event-callback.interface';
 import { DyNTS_global_settings } from '../../../_collections/global-settings.const';
+import { DyNTS_AI_Embedding_ServiceBase } from './ai-embedding.service-base';
 
 /**
  * Az LM Studio embedding control-service config-set-je. A `baseUrl` az OpenAI-kompatibilis
@@ -68,7 +69,8 @@ export class DyNTS_LMStudio_Embedding_ControlService extends DyNTS_AI_Embedding_
    */
   constructor(set: DyNTS_LMStudio_Embedding_Settings) {
     super();
-    if (!set?.baseUrl || !set.baseUrl.trim().length) {
+
+    if (!set?.baseUrl?.trim().length) {
       throw new DyFM_Error({
         ...this.getDefaultErrorSettings(
           'constructor',
@@ -80,6 +82,7 @@ export class DyNTS_LMStudio_Embedding_ControlService extends DyNTS_AI_Embedding_
     }
     this.baseUrl = this.trimTrailingSlashes(set.baseUrl.trim());
     this.apiKey = set.apiKey;
+
     if (set.onCostEvent) {
       this.onCostEvent = set.onCostEvent;
     }
@@ -93,6 +96,7 @@ export class DyNTS_LMStudio_Embedding_ControlService extends DyNTS_AI_Embedding_
     if (config?.baseURL) {
       this.baseUrl = this.trimTrailingSlashes(config.baseURL);
     }
+
     if (config?.apiKey) {
       this.apiKey = config.apiKey;
     }
@@ -122,16 +126,18 @@ export class DyNTS_LMStudio_Embedding_ControlService extends DyNTS_AI_Embedding_
       const response: CreateEmbeddingResponse = await this.callEmbeddingsEndpoint(set.model, set.text, set.issuer);
       const durationMs: number = Date.now() - start;
 
-      this.emitLmStudioCostEvent('embedding-single', set.model, [set.text], response, durationMs, set.issuer);
+      this.emitLmStudioCostEvent('embedding-single', set.model, [ set.text ], response, durationMs, set.issuer);
 
       if (set.fullResponse) {
         return response;
       }
+
       return response.data[0].embedding;
     } catch (error) {
       if (error instanceof DyFM_Error) {
         throw error;
       }
+
       throw new DyFM_Error({
         ...this.getDefaultErrorSettings('createEmbedding', error, set.issuer),
         errorCode: `${DyNTS_global_settings.systemShortCodeName}|DyNTS-LMS-ECS-CE0`,
@@ -168,11 +174,13 @@ export class DyNTS_LMStudio_Embedding_ControlService extends DyNTS_AI_Embedding_
       if (set.fullResponse) {
         return response;
       }
+
       return response.data.map((item) => item.embedding);
     } catch (error) {
       if (error instanceof DyFM_Error) {
         throw error;
       }
+
       throw new DyFM_Error({
         ...this.getDefaultErrorSettings('createEmbeddings', error, set.issuer),
         errorCode: `${DyNTS_global_settings.systemShortCodeName}|DyNTS-LMS-ECS-CES0`,
@@ -198,17 +206,19 @@ export class DyNTS_LMStudio_Embedding_ControlService extends DyNTS_AI_Embedding_
   async testConnection(issuer: string): Promise<boolean> {
     try {
       const vectors: number[][] | CreateEmbeddingResponse = await this.createEmbeddings({
-        texts: ['ping'],
+        texts: [ 'ping' ],
         model: this.defaultProbeModel(),
         fullResponse: false,
         issuer: issuer,
       });
+
       return Array.isArray(vectors) && vectors.length === 1 && vectors[0].length > 0;
     } catch (error) {
       DyFM_Log.error('DyNTS_LMStudio_Embedding_ControlService', 'testConnection', 'Connection test failed', {
         error: error,
         issuer: issuer,
       });
+
       return false;
     }
   }
@@ -229,6 +239,7 @@ export class DyNTS_LMStudio_Embedding_ControlService extends DyNTS_AI_Embedding_
   ): Promise<CreateEmbeddingResponse> {
     const url: string = `${this.baseUrl}/embeddings`;
     const headers: { [key: string]: string } = { 'Content-Type': 'application/json' };
+
     if (this.apiKey && this.apiKey.trim().length) {
       headers.Authorization = `Bearer ${this.apiKey.trim()}`;
     }
@@ -248,6 +259,7 @@ export class DyNTS_LMStudio_Embedding_ControlService extends DyNTS_AI_Embedding_
     }
 
     let parsed: unknown;
+
     try {
       parsed = JSON.parse(rawText);
     } catch {
@@ -257,6 +269,7 @@ export class DyNTS_LMStudio_Embedding_ControlService extends DyNTS_AI_Embedding_
     }
 
     const expectedCount: number = Array.isArray(input) ? input.length : 1;
+
     return this.normalizeResponse(parsed, expectedCount, url, model);
   }
 
@@ -270,21 +283,25 @@ export class DyNTS_LMStudio_Embedding_ControlService extends DyNTS_AI_Embedding_
       throw new Error(`LM Studio embeddings: invalid response object | url=${url} | model=${modelId}`);
     }
     const dataRaw: unknown = Reflect.get(json, 'data');
+
     if (!Array.isArray(dataRaw)) {
       throw new Error(`LM Studio embeddings: missing data array | url=${url} | model=${modelId}`);
     }
 
     const data: CreateEmbeddingResponse['data'] = [];
     let index: number = 0;
+
     for (const item of dataRaw) {
       if (item === null || typeof item !== 'object' || Array.isArray(item)) {
         continue;
       }
       const embRaw: unknown = Reflect.get(item, 'embedding');
+
       if (!Array.isArray(embRaw)) {
         continue;
       }
       const vec: number[] = embRaw.filter((x: unknown): x is number => typeof x === 'number' && Number.isFinite(x));
+
       if (vec.length) {
         data.push({ object: 'embedding', embedding: vec, index: index });
         index++;
@@ -345,9 +362,11 @@ export class DyNTS_LMStudio_Embedding_ControlService extends DyNTS_AI_Embedding_
   /** Becsült token-szám lokális endpoint-hoz (ha nincs `usage`): 4 char ≈ 1 token. */
   protected estimateTokens(texts: string[]): number {
     let chars: number = 0;
+
     for (const text of texts) {
       chars += (text ?? '').length;
     }
+
     return Math.max(1, Math.ceil(chars / 4));
   }
 
@@ -364,6 +383,7 @@ export class DyNTS_LMStudio_Embedding_ControlService extends DyNTS_AI_Embedding_
   /** Rövid, biztonságos válasz-snapshot a hiba-üzenethez (max 300 char). */
   protected snapshot(value: string): string {
     const trimmed: string = (value ?? '').slice(0, 300);
+
     return trimmed.length === 300 ? `${trimmed}…` : trimmed;
   }
 
@@ -373,6 +393,7 @@ export class DyNTS_LMStudio_Embedding_ControlService extends DyNTS_AI_Embedding_
       return 0;
     }
     const value: unknown = Reflect.get(obj, key);
+
     return typeof value === 'number' && Number.isFinite(value) ? value : 0;
   }
 }

package/src/_modules/ai/index.ts

@@ -5,6 +5,11 @@ export * from '@futdevpro/fsm-dynamo/ai';
 export * from './_models/ai-input-interfaces';
 export * from './_models/ai-test-generation-result.interface';
 
+// Cost-event interfaces (BFR-AM-007) — a consumer (CCAP / FAM) ezekkel típusozza az `onCostEvent`
+// callback-jét; ezért barrel-export kell (M3, FAM-REV bedrock-fix).
+export * from './_models/interfaces/dynts-ai-cost-event.interface';
+export * from './_models/interfaces/dynts-ai-cost-event-callback.interface';
+
 // Abstract Services
 export * from './_services/ai-provider.service-base';
 export * from './_services/ai-llm.service-base';