@futdevpro/nts-dynamo 1.15.156 → 1.15.157

package/build/_modules/ai/_services/lmstudio-embedding.control-service.js

@@ -1,298 +1,298 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.DyNTS_LMStudio_Embedding_ControlService = void 0;
-const fsm_dynamo_1 = require("@futdevpro/fsm-dynamo");
-const ai_1 = require("@futdevpro/fsm-dynamo/ai");
-const global_settings_const_1 = require("../../../_collections/global-settings.const");
-const ai_embedding_service_base_1 = require("./ai-embedding.service-base");
-/**
- * `DyNTS_LMStudio_Embedding_ControlService` (BFR-AM-002) — OpenAI-kompatibilis **lokális** embedding
- * adapter `fetch`-en (Node 20 global `fetch`, így a Dynamo NEM hoz be provider-specifikus SDK-t a
- * lokális path-hoz). A FAM `FAM_LMStudio_EmbeddingProvider` workaround-ját emeli bedrock-szintre.
- *
- * A `baseUrl` + `modelId` config-ot a constructor-on kapja (mint a `DyNTS_OAI_Embedding_ControlService`
- * a `DyFM_OAI_Settings`-et). A `${baseUrl}/embeddings` POST-ra a `{ model, input }` body-t küldi, a
- * `data[].embedding` sorrendje == a `texts` sorrendje.
- *
- * **Cost-event (BFR-AM-007):** minden sikeres call után `emitCostEvent`-tel jelez (callType
- * `embedding-single` / `embedding-batch`, provider `'lm-studio'`). Lokális futás → nincs USD-költség,
- * a token-fogyasztás a `usage`-ből (ha az endpoint adja), különben becsült (4 char ≈ 1 token).
- */
-class DyNTS_LMStudio_Embedding_ControlService extends ai_embedding_service_base_1.DyNTS_AI_Embedding_ServiceBase {
-    /** A provider-azonosító a `LocalAI` enum-érték (LM Studio = lokális OpenAI-kompatibilis endpoint). */
-    aiProvider = ai_1.DyFM_AI_Provider.LocalAI;
-    /** A cost-event provider-string (a `DyNTS_AI_CostEvent.provider` szabad-string mezőjéhez). */
-    costProvider = 'lm-studio';
-    /** LM Studio (OpenAI-kompatibilis lokális) capability-k: csak embedding-et igénylünk innen. */
-    capabilities = {
-        chat: false,
-        embeddings: true,
-        imageGeneration: false,
-        vision: false,
-        audioGeneration: false,
-        audioAnalysis: false,
-        functionCalling: false,
-        streaming: false,
-        batchOperations: true,
-        supportedModelTypes: [],
-    };
-    /** Az OpenAI-kompatibilis endpoint base URL-je (trailing slash-mentes). */
-    baseUrl;
-    /** Opcionális Bearer token. */
-    apiKey;
-    /**
-     * @param set baseUrl + opc. apiKey + opc. onCostEvent. A `baseUrl` kötelező — ha üres, a
-     *   `DyNTS-LMS-ECS-CFG` hibát dobjuk (lokális endpoint nincs konfigurálva).
-     */
-    constructor(set) {
-        super();
-        if (!set?.baseUrl?.trim().length) {
-            throw new fsm_dynamo_1.DyFM_Error({
-                ...this.getDefaultErrorSettings('constructor', new Error('LM Studio baseUrl is required (OpenAI-compatible local endpoint)'), 'DyNTS_LMStudio_Embedding_ControlService'),
-                errorCode: `${global_settings_const_1.DyNTS_global_settings.systemShortCodeName}|DyNTS-LMS-ECS-CFG`,
-            });
-        }
-        this.baseUrl = this.trimTrailingSlashes(set.baseUrl.trim());
-        this.apiKey = set.apiKey;
-        if (set.onCostEvent) {
-            this.onCostEvent = set.onCostEvent;
-        }
-    }
-    /**
-     * Az LM Studio client-et nem SDK-val, hanem `fetch`-csel hívjuk; a `setup` a `baseUrl` (és
-     * opcionálisan az `apiKey`) átkonfigurálását teszi lehetővé (a base-szerződés egységessége miatt).
-     */
-    setup(config) {
-        if (config?.baseURL) {
-            this.baseUrl = this.trimTrailingSlashes(config.baseURL);
-        }
-        if (config?.apiKey) {
-            this.apiKey = config.apiKey;
-        }
-    }
-    /**
-     * Egy-szöveg embedding (a `createEmbeddings` egyelemű alakja). `fullResponse=true` esetén a
-     * teljes (OpenAI-alakú) válasz-objektumot adja vissza, különben a tiszta `number[]`-t.
-     */
-    async createEmbedding(set) {
-        try {
-            if (!set.text) {
-                throw new fsm_dynamo_1.DyFM_Error({
-                    ...this.getDefaultErrorSettings('createEmbedding', new Error('text is required'), set.issuer),
-                    errorCode: `${global_settings_const_1.DyNTS_global_settings.systemShortCodeName}|DyNTS-LMS-ECS-CE1`,
-                });
-            }
-            const start = Date.now();
-            const response = await this.callEmbeddingsEndpoint(set.model, set.text, set.issuer);
-            const durationMs = Date.now() - start;
-            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 fsm_dynamo_1.DyFM_Error) {
-                throw error;
-            }
-            throw new fsm_dynamo_1.DyFM_Error({
-                ...this.getDefaultErrorSettings('createEmbedding', error, set.issuer),
-                errorCode: `${global_settings_const_1.DyNTS_global_settings.systemShortCodeName}|DyNTS-LMS-ECS-CE0`,
-            });
-        }
-    }
-    /**
-     * Batch-embedding az OpenAI-kompatibilis `/embeddings` végpontra. A `texts` sorrendje == a
-     * visszaadott `number[][]` sorrendje. `fullResponse=true` esetén a teljes válasz-objektum.
-     */
-    async createEmbeddings(set) {
-        try {
-            if (!set.texts) {
-                throw new fsm_dynamo_1.DyFM_Error({
-                    ...this.getDefaultErrorSettings('createEmbeddings', new Error('texts is required'), set.issuer),
-                    errorCode: `${global_settings_const_1.DyNTS_global_settings.systemShortCodeName}|DyNTS-LMS-ECS-CES1`,
-                });
-            }
-            const start = Date.now();
-            const response = await this.callEmbeddingsEndpoint(set.model, set.texts, set.issuer);
-            const durationMs = Date.now() - start;
-            this.emitLmStudioCostEvent('embedding-batch', set.model, set.texts, response, durationMs, set.issuer);
-            if (set.fullResponse) {
-                return response;
-            }
-            return response.data.map((item) => item.embedding);
-        }
-        catch (error) {
-            if (error instanceof fsm_dynamo_1.DyFM_Error) {
-                throw error;
-            }
-            throw new fsm_dynamo_1.DyFM_Error({
-                ...this.getDefaultErrorSettings('createEmbeddings', error, set.issuer),
-                errorCode: `${global_settings_const_1.DyNTS_global_settings.systemShortCodeName}|DyNTS-LMS-ECS-CES0`,
-            });
-        }
-    }
-    /**
-     * Embedding model-info (a `DyFM_DAI_EmbeddingInfo` szerződés szerint). A provider `LocalAI`, a
-     * model a megadott azonosító (a lokális endpoint natív dimenzióját nem ismerjük előre).
-     */
-    getEmbeddingInfo(model) {
-        return {
-            provider: ai_1.DyFM_AI_Provider.LocalAI,
-            model: model,
-        };
-    }
-    /**
-     * Provider-elérhetőség: egy minimál embedding-próba (rövid token). Ha a hívás dob (endpoint down /
-     * model hiányzik), `false`. Soha nem propagál hibát (try/catch → false).
-     */
-    async testConnection(issuer) {
-        try {
-            const vectors = await this.createEmbeddings({
-                texts: ['ping'],
-                model: this.defaultProbeModel(),
-                fullResponse: false,
-                issuer: issuer,
-            });
-            return Array.isArray(vectors) && vectors.length === 1 && vectors[0].length > 0;
-        }
-        catch (error) {
-            fsm_dynamo_1.DyFM_Log.error('DyNTS_LMStudio_Embedding_ControlService', 'testConnection', 'Connection test failed', {
-                error: error,
-                issuer: issuer,
-            });
-            return false;
-        }
-    }
-    // =========================================================================
-    // belső: fetch + parse + cost-event
-    // =========================================================================
-    /**
-     * Az OpenAI-kompatibilis `/embeddings` POST-hívás `fetch`-csel. A `input` lehet egyetlen string
-     * vagy string-tömb (mindkettőt az OpenAI-spec megengedi). A választ `CreateEmbeddingResponse`-alakra
-     * normalizáljuk (a `data[].embedding`-eket kivonatoljuk). HTTP-/parse-hiba deskriptív üzenettel dobódik.
-     */
-    async callEmbeddingsEndpoint(model, input, issuer) {
-        const url = `${this.baseUrl}/embeddings`;
-        const headers = { 'Content-Type': 'application/json' };
-        if (this.apiKey && this.apiKey.trim().length) {
-            headers.Authorization = `Bearer ${this.apiKey.trim()}`;
-        }
-        const response = await fetch(url, {
-            method: 'POST',
-            headers: headers,
-            body: JSON.stringify({ model: model, input: input }),
-        });
-        const rawText = await response.text();
-        if (!response.ok) {
-            throw new Error(`LM Studio (OpenAI-compatible) embeddings HTTP ${response.status} | url=${url} | `
-                + `model=${model} | body=${this.snapshot(rawText)} | issuer=${issuer}`);
-        }
-        let parsed;
-        try {
-            parsed = JSON.parse(rawText);
-        }
-        catch {
-            throw new Error(`LM Studio embeddings: non-JSON response | url=${url} | model=${model} | body=${this.snapshot(rawText)}`);
-        }
-        const expectedCount = Array.isArray(input) ? input.length : 1;
-        return this.normalizeResponse(parsed, expectedCount, url, model);
-    }
-    /**
-     * A nyers (OpenAI-kompatibilis) választ `CreateEmbeddingResponse`-alakra normalizálja: a `data[]`-ból
-     * a `embedding` tömböket emeli ki (csak véges number-eket), a darabszámot ellenőrzi (1:1 a `texts`-szel),
-     * és átveszi a `usage`-t ha van (a cost-event token-számához). Hibás/hiányzó mező → deskriptív hiba.
-     */
-    normalizeResponse(json, expectedCount, url, modelId) {
-        if (json === null || typeof json !== 'object' || Array.isArray(json)) {
-            throw new Error(`LM Studio embeddings: invalid response object | url=${url} | model=${modelId}`);
-        }
-        const dataRaw = Reflect.get(json, 'data');
-        if (!Array.isArray(dataRaw)) {
-            throw new Error(`LM Studio embeddings: missing data array | url=${url} | model=${modelId}`);
-        }
-        const data = [];
-        let index = 0;
-        for (const item of dataRaw) {
-            if (item === null || typeof item !== 'object' || Array.isArray(item)) {
-                continue;
-            }
-            const embRaw = Reflect.get(item, 'embedding');
-            if (!Array.isArray(embRaw)) {
-                continue;
-            }
-            const vec = embRaw.filter((x) => typeof x === 'number' && Number.isFinite(x));
-            if (vec.length) {
-                data.push({ object: 'embedding', embedding: vec, index: index });
-                index++;
-            }
-        }
-        if (data.length !== expectedCount) {
-            throw new Error(`LM Studio embeddings: expected ${expectedCount} vectors, got ${data.length} | url=${url} | model=${modelId}`);
-        }
-        const usageRaw = Reflect.get(json, 'usage');
-        const promptTokens = this.readNumber(usageRaw, 'prompt_tokens');
-        const totalTokens = this.readNumber(usageRaw, 'total_tokens');
-        return {
-            object: 'list',
-            model: modelId,
-            data: data,
-            usage: {
-                prompt_tokens: promptTokens,
-                total_tokens: totalTokens || promptTokens,
-            },
-        };
-    }
-    /**
-     * Cost-event emit (BFR-AM-007). A token a `usage`-ből (ha az endpoint adta), különben becsült
-     * (4 char ≈ 1 token, defenzív lokális heurisztika). A provider mindig `'lm-studio'` string.
-     */
-    emitLmStudioCostEvent(callType, model, texts, response, durationMs, issuer) {
-        const reportedInput = response.usage?.prompt_tokens ?? 0;
-        const input = reportedInput || this.estimateTokens(texts);
-        const total = response.usage?.total_tokens || input;
-        this.emitCostEvent({
-            callType: callType,
-            provider: this.costProvider,
-            model: model,
-            tokensUsed: {
-                input: input,
-                total: total,
-            },
-            durationMs: durationMs,
-            issuer: issuer,
-            timestamp: new Date(),
-        });
-    }
-    /** Becsült token-szám lokális endpoint-hoz (ha nincs `usage`): 4 char ≈ 1 token. */
-    estimateTokens(texts) {
-        let chars = 0;
-        for (const text of texts) {
-            chars += (text ?? '').length;
-        }
-        return Math.max(1, Math.ceil(chars / 4));
-    }
-    /** A `testConnection` próba-modellje (env-override-olható, default a FAM-mintára). */
-    defaultProbeModel() {
-        return process.env.LMSTUDIO_EMBEDDING_MODEL || 'nomic-embed-text-v1.5';
-    }
-    /** Trailing `/`-ek levágása (kettős slash elkerülése a `/embeddings` join-nál). */
-    trimTrailingSlashes(value) {
-        return value.replace(/\/+$/, '');
-    }
-    /** Rövid, biztonságos válasz-snapshot a hiba-üzenethez (max 300 char). */
-    snapshot(value) {
-        const trimmed = (value ?? '').slice(0, 300);
-        return trimmed.length === 300 ? `${trimmed}…` : trimmed;
-    }
-    /** Egy number mező típusbiztos kiolvasása egy ismeretlen objektumból (hiány → 0). */
-    readNumber(obj, key) {
-        if (obj === null || typeof obj !== 'object') {
-            return 0;
-        }
-        const value = Reflect.get(obj, key);
-        return typeof value === 'number' && Number.isFinite(value) ? value : 0;
-    }
-}
-exports.DyNTS_LMStudio_Embedding_ControlService = DyNTS_LMStudio_Embedding_ControlService;
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.DyNTS_LMStudio_Embedding_ControlService = void 0;
+const fsm_dynamo_1 = require("@futdevpro/fsm-dynamo");
+const ai_1 = require("@futdevpro/fsm-dynamo/ai");
+const global_settings_const_1 = require("../../../_collections/global-settings.const");
+const ai_embedding_service_base_1 = require("./ai-embedding.service-base");
+/**
+ * `DyNTS_LMStudio_Embedding_ControlService` (BFR-AM-002) — OpenAI-kompatibilis **lokális** embedding
+ * adapter `fetch`-en (Node 20 global `fetch`, így a Dynamo NEM hoz be provider-specifikus SDK-t a
+ * lokális path-hoz). A FAM `FAM_LMStudio_EmbeddingProvider` workaround-ját emeli bedrock-szintre.
+ *
+ * A `baseUrl` + `modelId` config-ot a constructor-on kapja (mint a `DyNTS_OAI_Embedding_ControlService`
+ * a `DyFM_OAI_Settings`-et). A `${baseUrl}/embeddings` POST-ra a `{ model, input }` body-t küldi, a
+ * `data[].embedding` sorrendje == a `texts` sorrendje.
+ *
+ * **Cost-event (BFR-AM-007):** minden sikeres call után `emitCostEvent`-tel jelez (callType
+ * `embedding-single` / `embedding-batch`, provider `'lm-studio'`). Lokális futás → nincs USD-költség,
+ * a token-fogyasztás a `usage`-ből (ha az endpoint adja), különben becsült (4 char ≈ 1 token).
+ */
+class DyNTS_LMStudio_Embedding_ControlService extends ai_embedding_service_base_1.DyNTS_AI_Embedding_ServiceBase {
+    /** A provider-azonosító a `LocalAI` enum-érték (LM Studio = lokális OpenAI-kompatibilis endpoint). */
+    aiProvider = ai_1.DyFM_AI_Provider.LocalAI;
+    /** A cost-event provider-string (a `DyNTS_AI_CostEvent.provider` szabad-string mezőjéhez). */
+    costProvider = 'lm-studio';
+    /** LM Studio (OpenAI-kompatibilis lokális) capability-k: csak embedding-et igénylünk innen. */
+    capabilities = {
+        chat: false,
+        embeddings: true,
+        imageGeneration: false,
+        vision: false,
+        audioGeneration: false,
+        audioAnalysis: false,
+        functionCalling: false,
+        streaming: false,
+        batchOperations: true,
+        supportedModelTypes: [],
+    };
+    /** Az OpenAI-kompatibilis endpoint base URL-je (trailing slash-mentes). */
+    baseUrl;
+    /** Opcionális Bearer token. */
+    apiKey;
+    /**
+     * @param set baseUrl + opc. apiKey + opc. onCostEvent. A `baseUrl` kötelező — ha üres, a
+     *   `DyNTS-LMS-ECS-CFG` hibát dobjuk (lokális endpoint nincs konfigurálva).
+     */
+    constructor(set) {
+        super();
+        if (!set?.baseUrl?.trim().length) {
+            throw new fsm_dynamo_1.DyFM_Error({
+                ...this.getDefaultErrorSettings('constructor', new Error('LM Studio baseUrl is required (OpenAI-compatible local endpoint)'), 'DyNTS_LMStudio_Embedding_ControlService'),
+                errorCode: `${global_settings_const_1.DyNTS_global_settings.systemShortCodeName}|DyNTS-LMS-ECS-CFG`,
+            });
+        }
+        this.baseUrl = this.trimTrailingSlashes(set.baseUrl.trim());
+        this.apiKey = set.apiKey;
+        if (set.onCostEvent) {
+            this.onCostEvent = set.onCostEvent;
+        }
+    }
+    /**
+     * Az LM Studio client-et nem SDK-val, hanem `fetch`-csel hívjuk; a `setup` a `baseUrl` (és
+     * opcionálisan az `apiKey`) átkonfigurálását teszi lehetővé (a base-szerződés egységessége miatt).
+     */
+    setup(config) {
+        if (config?.baseURL) {
+            this.baseUrl = this.trimTrailingSlashes(config.baseURL);
+        }
+        if (config?.apiKey) {
+            this.apiKey = config.apiKey;
+        }
+    }
+    /**
+     * Egy-szöveg embedding (a `createEmbeddings` egyelemű alakja). `fullResponse=true` esetén a
+     * teljes (OpenAI-alakú) válasz-objektumot adja vissza, különben a tiszta `number[]`-t.
+     */
+    async createEmbedding(set) {
+        try {
+            if (!set.text) {
+                throw new fsm_dynamo_1.DyFM_Error({
+                    ...this.getDefaultErrorSettings('createEmbedding', new Error('text is required'), set.issuer),
+                    errorCode: `${global_settings_const_1.DyNTS_global_settings.systemShortCodeName}|DyNTS-LMS-ECS-CE1`,
+                });
+            }
+            const start = Date.now();
+            const response = await this.callEmbeddingsEndpoint(set.model, set.text, set.issuer);
+            const durationMs = Date.now() - start;
+            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 fsm_dynamo_1.DyFM_Error) {
+                throw error;
+            }
+            throw new fsm_dynamo_1.DyFM_Error({
+                ...this.getDefaultErrorSettings('createEmbedding', error, set.issuer),
+                errorCode: `${global_settings_const_1.DyNTS_global_settings.systemShortCodeName}|DyNTS-LMS-ECS-CE0`,
+            });
+        }
+    }
+    /**
+     * Batch-embedding az OpenAI-kompatibilis `/embeddings` végpontra. A `texts` sorrendje == a
+     * visszaadott `number[][]` sorrendje. `fullResponse=true` esetén a teljes válasz-objektum.
+     */
+    async createEmbeddings(set) {
+        try {
+            if (!set.texts) {
+                throw new fsm_dynamo_1.DyFM_Error({
+                    ...this.getDefaultErrorSettings('createEmbeddings', new Error('texts is required'), set.issuer),
+                    errorCode: `${global_settings_const_1.DyNTS_global_settings.systemShortCodeName}|DyNTS-LMS-ECS-CES1`,
+                });
+            }
+            const start = Date.now();
+            const response = await this.callEmbeddingsEndpoint(set.model, set.texts, set.issuer);
+            const durationMs = Date.now() - start;
+            this.emitLmStudioCostEvent('embedding-batch', set.model, set.texts, response, durationMs, set.issuer);
+            if (set.fullResponse) {
+                return response;
+            }
+            return response.data.map((item) => item.embedding);
+        }
+        catch (error) {
+            if (error instanceof fsm_dynamo_1.DyFM_Error) {
+                throw error;
+            }
+            throw new fsm_dynamo_1.DyFM_Error({
+                ...this.getDefaultErrorSettings('createEmbeddings', error, set.issuer),
+                errorCode: `${global_settings_const_1.DyNTS_global_settings.systemShortCodeName}|DyNTS-LMS-ECS-CES0`,
+            });
+        }
+    }
+    /**
+     * Embedding model-info (a `DyFM_DAI_EmbeddingInfo` szerződés szerint). A provider `LocalAI`, a
+     * model a megadott azonosító (a lokális endpoint natív dimenzióját nem ismerjük előre).
+     */
+    getEmbeddingInfo(model) {
+        return {
+            provider: ai_1.DyFM_AI_Provider.LocalAI,
+            model: model,
+        };
+    }
+    /**
+     * Provider-elérhetőség: egy minimál embedding-próba (rövid token). Ha a hívás dob (endpoint down /
+     * model hiányzik), `false`. Soha nem propagál hibát (try/catch → false).
+     */
+    async testConnection(issuer) {
+        try {
+            const vectors = await this.createEmbeddings({
+                texts: ['ping'],
+                model: this.defaultProbeModel(),
+                fullResponse: false,
+                issuer: issuer,
+            });
+            return Array.isArray(vectors) && vectors.length === 1 && vectors[0].length > 0;
+        }
+        catch (error) {
+            fsm_dynamo_1.DyFM_Log.error('DyNTS_LMStudio_Embedding_ControlService', 'testConnection', 'Connection test failed', {
+                error: error,
+                issuer: issuer,
+            });
+            return false;
+        }
+    }
+    // =========================================================================
+    // belső: fetch + parse + cost-event
+    // =========================================================================
+    /**
+     * Az OpenAI-kompatibilis `/embeddings` POST-hívás `fetch`-csel. A `input` lehet egyetlen string
+     * vagy string-tömb (mindkettőt az OpenAI-spec megengedi). A választ `CreateEmbeddingResponse`-alakra
+     * normalizáljuk (a `data[].embedding`-eket kivonatoljuk). HTTP-/parse-hiba deskriptív üzenettel dobódik.
+     */
+    async callEmbeddingsEndpoint(model, input, issuer) {
+        const url = `${this.baseUrl}/embeddings`;
+        const headers = { 'Content-Type': 'application/json' };
+        if (this.apiKey && this.apiKey.trim().length) {
+            headers.Authorization = `Bearer ${this.apiKey.trim()}`;
+        }
+        const response = await fetch(url, {
+            method: 'POST',
+            headers: headers,
+            body: JSON.stringify({ model: model, input: input }),
+        });
+        const rawText = await response.text();
+        if (!response.ok) {
+            throw new Error(`LM Studio (OpenAI-compatible) embeddings HTTP ${response.status} | url=${url} | `
+                + `model=${model} | body=${this.snapshot(rawText)} | issuer=${issuer}`);
+        }
+        let parsed;
+        try {
+            parsed = JSON.parse(rawText);
+        }
+        catch {
+            throw new Error(`LM Studio embeddings: non-JSON response | url=${url} | model=${model} | body=${this.snapshot(rawText)}`);
+        }
+        const expectedCount = Array.isArray(input) ? input.length : 1;
+        return this.normalizeResponse(parsed, expectedCount, url, model);
+    }
+    /**
+     * A nyers (OpenAI-kompatibilis) választ `CreateEmbeddingResponse`-alakra normalizálja: a `data[]`-ból
+     * a `embedding` tömböket emeli ki (csak véges number-eket), a darabszámot ellenőrzi (1:1 a `texts`-szel),
+     * és átveszi a `usage`-t ha van (a cost-event token-számához). Hibás/hiányzó mező → deskriptív hiba.
+     */
+    normalizeResponse(json, expectedCount, url, modelId) {
+        if (json === null || typeof json !== 'object' || Array.isArray(json)) {
+            throw new Error(`LM Studio embeddings: invalid response object | url=${url} | model=${modelId}`);
+        }
+        const dataRaw = Reflect.get(json, 'data');
+        if (!Array.isArray(dataRaw)) {
+            throw new Error(`LM Studio embeddings: missing data array | url=${url} | model=${modelId}`);
+        }
+        const data = [];
+        let index = 0;
+        for (const item of dataRaw) {
+            if (item === null || typeof item !== 'object' || Array.isArray(item)) {
+                continue;
+            }
+            const embRaw = Reflect.get(item, 'embedding');
+            if (!Array.isArray(embRaw)) {
+                continue;
+            }
+            const vec = embRaw.filter((x) => typeof x === 'number' && Number.isFinite(x));
+            if (vec.length) {
+                data.push({ object: 'embedding', embedding: vec, index: index });
+                index++;
+            }
+        }
+        if (data.length !== expectedCount) {
+            throw new Error(`LM Studio embeddings: expected ${expectedCount} vectors, got ${data.length} | url=${url} | model=${modelId}`);
+        }
+        const usageRaw = Reflect.get(json, 'usage');
+        const promptTokens = this.readNumber(usageRaw, 'prompt_tokens');
+        const totalTokens = this.readNumber(usageRaw, 'total_tokens');
+        return {
+            object: 'list',
+            model: modelId,
+            data: data,
+            usage: {
+                prompt_tokens: promptTokens,
+                total_tokens: totalTokens || promptTokens,
+            },
+        };
+    }
+    /**
+     * Cost-event emit (BFR-AM-007). A token a `usage`-ből (ha az endpoint adta), különben becsült
+     * (4 char ≈ 1 token, defenzív lokális heurisztika). A provider mindig `'lm-studio'` string.
+     */
+    emitLmStudioCostEvent(callType, model, texts, response, durationMs, issuer) {
+        const reportedInput = response.usage?.prompt_tokens ?? 0;
+        const input = reportedInput || this.estimateTokens(texts);
+        const total = response.usage?.total_tokens || input;
+        this.emitCostEvent({
+            callType: callType,
+            provider: this.costProvider,
+            model: model,
+            tokensUsed: {
+                input: input,
+                total: total,
+            },
+            durationMs: durationMs,
+            issuer: issuer,
+            timestamp: new Date(),
+        });
+    }
+    /** Becsült token-szám lokális endpoint-hoz (ha nincs `usage`): 4 char ≈ 1 token. */
+    estimateTokens(texts) {
+        let chars = 0;
+        for (const text of texts) {
+            chars += (text ?? '').length;
+        }
+        return Math.max(1, Math.ceil(chars / 4));
+    }
+    /** A `testConnection` próba-modellje (env-override-olható, default a FAM-mintára). */
+    defaultProbeModel() {
+        return process.env.LMSTUDIO_EMBEDDING_MODEL || 'nomic-embed-text-v1.5';
+    }
+    /** Trailing `/`-ek levágása (kettős slash elkerülése a `/embeddings` join-nál). */
+    trimTrailingSlashes(value) {
+        return value.replace(/\/+$/, '');
+    }
+    /** Rövid, biztonságos válasz-snapshot a hiba-üzenethez (max 300 char). */
+    snapshot(value) {
+        const trimmed = (value ?? '').slice(0, 300);
+        return trimmed.length === 300 ? `${trimmed}…` : trimmed;
+    }
+    /** Egy number mező típusbiztos kiolvasása egy ismeretlen objektumból (hiány → 0). */
+    readNumber(obj, key) {
+        if (obj === null || typeof obj !== 'object') {
+            return 0;
+        }
+        const value = Reflect.get(obj, key);
+        return typeof value === 'number' && Number.isFinite(value) ? value : 0;
+    }
+}
+exports.DyNTS_LMStudio_Embedding_ControlService = DyNTS_LMStudio_Embedding_ControlService;
 //# sourceMappingURL=lmstudio-embedding.control-service.js.map

package/build/_modules/ai/index.d.ts

@@ -1,17 +1,17 @@
-export * from '@futdevpro/fsm-dynamo/ai';
-export * from './_models/ai-input-interfaces';
-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';
-export * from './_models/interfaces/dynts-ai-provider-error.interface';
-export * from './_collections/ai-provider-error.util';
-export * from './_collections/ai-model-config-validator.util';
-export * from './_services/ai-provider.service-base';
-export * from './_services/ai-llm.service-base';
-export * from './_services/ai-llm-chat.service-base';
-export * from './_services/ai-embedding.service-base';
-export * from './_services/ai-user-key.service-base';
-export * from './_services/lmstudio-embedding.control-service';
-export * from './_services/ai-embedding-provider.registry';
-export * from './_modules/ai-mock/_services/ai-embedding-mock.service';
+export * from '@futdevpro/fsm-dynamo/ai';
+export * from './_models/ai-input-interfaces';
+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';
+export * from './_models/interfaces/dynts-ai-provider-error.interface';
+export * from './_collections/ai-provider-error.util';
+export * from './_collections/ai-model-config-validator.util';
+export * from './_services/ai-provider.service-base';
+export * from './_services/ai-llm.service-base';
+export * from './_services/ai-llm-chat.service-base';
+export * from './_services/ai-embedding.service-base';
+export * from './_services/ai-user-key.service-base';
+export * from './_services/lmstudio-embedding.control-service';
+export * from './_services/ai-embedding-provider.registry';
+export * from './_modules/ai-mock/_services/ai-embedding-mock.service';
 //# sourceMappingURL=index.d.ts.map