@futdevpro/nts-dynamo 1.15.202 → 1.15.215

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

@@ -0,0 +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;
+//# sourceMappingURL=lm-studio-embedding.control-service.js.map

package/build/_modules/ai/_services/lm-studio-embedding.control-service.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"lm-studio-embedding.control-service.js","sourceRoot":"","sources":["../../../../src/_modules/ai/_services/lm-studio-embedding.control-service.ts"],"names":[],"mappings":";;;AAEA,sDAA6D;AAC7D,iDAA0G;AAI1G,uFAAoF;AACpF,2EAA6E;AAgB7E;;;;;;;;;;;;GAYG;AACH,MAAa,uCAAwC,SAAQ,0DAA8B;IAEzF,sGAAsG;IAC7F,UAAU,GAAqB,qBAAgB,CAAC,OAAO,CAAC;IAEjE,8FAA8F;IAC3E,YAAY,GAAW,WAAW,CAAC;IAEtD,+FAA+F;IACtF,YAAY,GAAiC;QACpD,IAAI,EAAE,KAAK;QACX,UAAU,EAAE,IAAI;QAChB,eAAe,EAAE,KAAK;QACtB,MAAM,EAAE,KAAK;QACb,eAAe,EAAE,KAAK;QACtB,aAAa,EAAE,KAAK;QACpB,eAAe,EAAE,KAAK;QACtB,SAAS,EAAE,KAAK;QAChB,eAAe,EAAE,IAAI;QACrB,mBAAmB,EAAE,EAAE;KACxB,CAAC;IAEF,2EAA2E;IACjE,OAAO,CAAS;IAE1B,+BAA+B;IACrB,MAAM,CAAU;IAE1B;;;OAGG;IACH,YAAY,GAAsC;QAChD,KAAK,EAAE,CAAC;QAER,IAAI,CAAC,GAAG,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC,MAAM,EAAE,CAAC;YACjC,MAAM,IAAI,uBAAU,CAAC;gBACnB,GAAG,IAAI,CAAC,uBAAuB,CAC7B,aAAa,EACb,IAAI,KAAK,CAAC,kEAAkE,CAAC,EAC7E,yCAAyC,CAC1C;gBACD,SAAS,EAAE,GAAG,6CAAqB,CAAC,mBAAmB,oBAAoB;aAC5E,CAAC,CAAC;QACL,CAAC;QACD,IAAI,CAAC,OAAO,GAAG,IAAI,CAAC,mBAAmB,CAAC,GAAG,CAAC,OAAO,CAAC,IAAI,EAAE,CAAC,CAAC;QAC5D,IAAI,CAAC,MAAM,GAAG,GAAG,CAAC,MAAM,CAAC;QAEzB,IAAI,GAAG,CAAC,WAAW,EAAE,CAAC;YACpB,IAAI,CAAC,WAAW,GAAG,GAAG,CAAC,WAAW,CAAC;QACrC,CAAC;IACH,CAAC;IAED;;;OAGG;IACH,KAAK,CAAC,MAAsB;QAC1B,IAAI,MAAM,EAAE,OAAO,EAAE,CAAC;YACpB,IAAI,CAAC,OAAO,GAAG,IAAI,CAAC,mBAAmB,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;QAC1D,CAAC;QAED,IAAI,MAAM,EAAE,MAAM,EAAE,CAAC;YACnB,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC,MAAM,CAAC;QAC9B,CAAC;IACH,CAAC;IAED;;;OAGG;IACH,KAAK,CAAC,eAAe,CACnB,GAKC;QAED,IAAI,CAAC;YACH,IAAI,CAAC,GAAG,CAAC,IAAI,EAAE,CAAC;gBACd,MAAM,IAAI,uBAAU,CAAC;oBACnB,GAAG,IAAI,CAAC,uBAAuB,CAAC,iBAAiB,EAAE,IAAI,KAAK,CAAC,kBAAkB,CAAC,EAAE,GAAG,CAAC,MAAM,CAAC;oBAC7F,SAAS,EAAE,GAAG,6CAAqB,CAAC,mBAAmB,oBAAoB;iBAC5E,CAAC,CAAC;YACL,CAAC;YAED,MAAM,KAAK,GAAW,IAAI,CAAC,GAAG,EAAE,CAAC;YACjC,MAAM,QAAQ,GAA4B,MAAM,IAAI,CAAC,sBAAsB,CAAC,GAAG,CAAC,KAAK,EAAE,GAAG,CAAC,IAAI,EAAE,GAAG,CAAC,MAAM,CAAC,CAAC;YAC7G,MAAM,UAAU,GAAW,IAAI,CAAC,GAAG,EAAE,GAAG,KAAK,CAAC;YAE9C,IAAI,CAAC,qBAAqB,CAAC,kBAAkB,EAAE,GAAG,CAAC,KAAK,EAAE,CAAE,GAAG,CAAC,IAAI,CAAE,EAAE,QAAQ,EAAE,UAAU,EAAE,GAAG,CAAC,MAAM,CAAC,CAAC;YAE1G,IAAI,GAAG,CAAC,YAAY,EAAE,CAAC;gBACrB,OAAO,QAAQ,CAAC;YAClB,CAAC;YAED,OAAO,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;QACpC,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,IAAI,KAAK,YAAY,uBAAU,EAAE,CAAC;gBAChC,MAAM,KAAK,CAAC;YACd,CAAC;YAED,MAAM,IAAI,uBAAU,CAAC;gBACnB,GAAG,IAAI,CAAC,uBAAuB,CAAC,iBAAiB,EAAE,KAAK,EAAE,GAAG,CAAC,MAAM,CAAC;gBACrE,SAAS,EAAE,GAAG,6CAAqB,CAAC,mBAAmB,oBAAoB;aAC5E,CAAC,CAAC;QACL,CAAC;IACH,CAAC;IAED;;;OAGG;IACH,KAAK,CAAC,gBAAgB,CACpB,GAKC;QAED,IAAI,CAAC;YACH,IAAI,CAAC,GAAG,CAAC,KAAK,EAAE,CAAC;gBACf,MAAM,IAAI,uBAAU,CAAC;oBACnB,GAAG,IAAI,CAAC,uBAAuB,CAAC,kBAAkB,EAAE,IAAI,KAAK,CAAC,mBAAmB,CAAC,EAAE,GAAG,CAAC,MAAM,CAAC;oBAC/F,SAAS,EAAE,GAAG,6CAAqB,CAAC,mBAAmB,qBAAqB;iBAC7E,CAAC,CAAC;YACL,CAAC;YAED,MAAM,KAAK,GAAW,IAAI,CAAC,GAAG,EAAE,CAAC;YACjC,MAAM,QAAQ,GAA4B,MAAM,IAAI,CAAC,sBAAsB,CAAC,GAAG,CAAC,KAAK,EAAE,GAAG,CAAC,KAAK,EAAE,GAAG,CAAC,MAAM,CAAC,CAAC;YAC9G,MAAM,UAAU,GAAW,IAAI,CAAC,GAAG,EAAE,GAAG,KAAK,CAAC;YAE9C,IAAI,CAAC,qBAAqB,CAAC,iBAAiB,EAAE,GAAG,CAAC,KAAK,EAAE,GAAG,CAAC,KAAK,EAAE,QAAQ,EAAE,UAAU,EAAE,GAAG,CAAC,MAAM,CAAC,CAAC;YAEtG,IAAI,GAAG,CAAC,YAAY,EAAE,CAAC;gBACrB,OAAO,QAAQ,CAAC;YAClB,CAAC;YAED,OAAO,QAAQ,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;QACrD,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,IAAI,KAAK,YAAY,uBAAU,EAAE,CAAC;gBAChC,MAAM,KAAK,CAAC;YACd,CAAC;YAED,MAAM,IAAI,uBAAU,CAAC;gBACnB,GAAG,IAAI,CAAC,uBAAuB,CAAC,kBAAkB,EAAE,KAAK,EAAE,GAAG,CAAC,MAAM,CAAC;gBACtE,SAAS,EAAE,GAAG,6CAAqB,CAAC,mBAAmB,qBAAqB;aAC7E,CAAC,CAAC;QACL,CAAC;IACH,CAAC;IAED;;;OAGG;IACH,gBAAgB,CAAC,KAAa;QAC5B,OAAO;YACL,QAAQ,EAAE,qBAAgB,CAAC,OAAO;YAClC,KAAK,EAAE,KAAK;SACb,CAAC;IACJ,CAAC;IAED;;;OAGG;IACH,KAAK,CAAC,cAAc,CAAC,MAAc;QACjC,IAAI,CAAC;YACH,MAAM,OAAO,GAAyC,MAAM,IAAI,CAAC,gBAAgB,CAAC;gBAChF,KAAK,EAAE,CAAE,MAAM,CAAE;gBACjB,KAAK,EAAE,IAAI,CAAC,iBAAiB,EAAE;gBAC/B,YAAY,EAAE,KAAK;gBACnB,MAAM,EAAE,MAAM;aACf,CAAC,CAAC;YAEH,OAAO,KAAK,CAAC,OAAO,CAAC,OAAO,CAAC,IAAI,OAAO,CAAC,MAAM,KAAK,CAAC,IAAI,OAAO,CAAC,CAAC,CAAC,CAAC,MAAM,GAAG,CAAC,CAAC;QACjF,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,qBAAQ,CAAC,KAAK,CAAC,yCAAyC,EAAE,gBAAgB,EAAE,wBAAwB,EAAE;gBACpG,KAAK,EAAE,KAAK;gBACZ,MAAM,EAAE,MAAM;aACf,CAAC,CAAC;YAEH,OAAO,KAAK,CAAC;QACf,CAAC;IACH,CAAC;IAED,4EAA4E;IAC5E,oCAAoC;IACpC,4EAA4E;IAE5E;;;;OAIG;IACO,KAAK,CAAC,sBAAsB,CACpC,KAAa,EACb,KAAwB,EACxB,MAAc;QAEd,MAAM,GAAG,GAAW,GAAG,IAAI,CAAC,OAAO,aAAa,CAAC;QACjD,MAAM,OAAO,GAA8B,EAAE,cAAc,EAAE,kBAAkB,EAAE,CAAC;QAElF,IAAI,IAAI,CAAC,MAAM,IAAI,IAAI,CAAC,MAAM,CAAC,IAAI,EAAE,CAAC,MAAM,EAAE,CAAC;YAC7C,OAAO,CAAC,aAAa,GAAG,UAAU,IAAI,CAAC,MAAM,CAAC,IAAI,EAAE,EAAE,CAAC;QACzD,CAAC;QAED,MAAM,QAAQ,GAAa,MAAM,KAAK,CAAC,GAAG,EAAE;YAC1C,MAAM,EAAE,MAAM;YACd,OAAO,EAAE,OAAO;YAChB,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,EAAE,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,CAAC;SACrD,CAAC,CAAC;QACH,MAAM,OAAO,GAAW,MAAM,QAAQ,CAAC,IAAI,EAAE,CAAC;QAE9C,IAAI,CAAC,QAAQ,CAAC,EAAE,EAAE,CAAC;YACjB,MAAM,IAAI,KAAK,CACb,iDAAiD,QAAQ,CAAC,MAAM,UAAU,GAAG,KAAK;kBAChF,SAAS,KAAK,WAAW,IAAI,CAAC,QAAQ,CAAC,OAAO,CAAC,aAAa,MAAM,EAAE,CACvE,CAAC;QACJ,CAAC;QAED,IAAI,MAAe,CAAC;QAEpB,IAAI,CAAC;YACH,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;QAC/B,CAAC;QAAC,MAAM,CAAC;YACP,MAAM,IAAI,KAAK,CACb,iDAAiD,GAAG,YAAY,KAAK,WAAW,IAAI,CAAC,QAAQ,CAAC,OAAO,CAAC,EAAE,CACzG,CAAC;QACJ,CAAC;QAED,MAAM,aAAa,GAAW,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC;QAEtE,OAAO,IAAI,CAAC,iBAAiB,CAAC,MAAM,EAAE,aAAa,EAAE,GAAG,EAAE,KAAK,CAAC,CAAC;IACnE,CAAC;IAED;;;;OAIG;IACO,iBAAiB,CAAC,IAAa,EAAE,aAAqB,EAAE,GAAW,EAAE,OAAe;QAC5F,IAAI,IAAI,KAAK,IAAI,IAAI,OAAO,IAAI,KAAK,QAAQ,IAAI,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,EAAE,CAAC;YACrE,MAAM,IAAI,KAAK,CAAC,uDAAuD,GAAG,YAAY,OAAO,EAAE,CAAC,CAAC;QACnG,CAAC;QACD,MAAM,OAAO,GAAY,OAAO,CAAC,GAAG,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC;QAEnD,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,OAAO,CAAC,EAAE,CAAC;YAC5B,MAAM,IAAI,KAAK,CAAC,kDAAkD,GAAG,YAAY,OAAO,EAAE,CAAC,CAAC;QAC9F,CAAC;QAED,MAAM,IAAI,GAAoC,EAAE,CAAC;QACjD,IAAI,KAAK,GAAW,CAAC,CAAC;QAEtB,KAAK,MAAM,IAAI,IAAI,OAAO,EAAE,CAAC;YAC3B,IAAI,IAAI,KAAK,IAAI,IAAI,OAAO,IAAI,KAAK,QAAQ,IAAI,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,EAAE,CAAC;gBACrE,SAAS;YACX,CAAC;YACD,MAAM,MAAM,GAAY,OAAO,CAAC,GAAG,CAAC,IAAI,EAAE,WAAW,CAAC,CAAC;YAEvD,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC,EAAE,CAAC;gBAC3B,SAAS;YACX,CAAC;YACD,MAAM,GAAG,GAAa,MAAM,CAAC,MAAM,CAAC,CAAC,CAAU,EAAe,EAAE,CAAC,OAAO,CAAC,KAAK,QAAQ,IAAI,MAAM,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC;YAE9G,IAAI,GAAG,CAAC,MAAM,EAAE,CAAC;gBACf,IAAI,CAAC,IAAI,CAAC,EAAE,MAAM,EAAE,WAAW,EAAE,SAAS,EAAE,GAAG,EAAE,KAAK,EAAE,KAAK,EAAE,CAAC,CAAC;gBACjE,KAAK,EAAE,CAAC;YACV,CAAC;QACH,CAAC;QAED,IAAI,IAAI,CAAC,MAAM,KAAK,aAAa,EAAE,CAAC;YAClC,MAAM,IAAI,KAAK,CACb,kCAAkC,aAAa,iBAAiB,IAAI,CAAC,MAAM,UAAU,GAAG,YAAY,OAAO,EAAE,CAC9G,CAAC;QACJ,CAAC;QAED,MAAM,QAAQ,GAAY,OAAO,CAAC,GAAG,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC;QACrD,MAAM,YAAY,GAAW,IAAI,CAAC,UAAU,CAAC,QAAQ,EAAE,eAAe,CAAC,CAAC;QACxE,MAAM,WAAW,GAAW,IAAI,CAAC,UAAU,CAAC,QAAQ,EAAE,cAAc,CAAC,CAAC;QAEtE,OAAO;YACL,MAAM,EAAE,MAAM;YACd,KAAK,EAAE,OAAO;YACd,IAAI,EAAE,IAAI;YACV,KAAK,EAAE;gBACL,aAAa,EAAE,YAAY;gBAC3B,YAAY,EAAE,WAAW,IAAI,YAAY;aAC1C;SACF,CAAC;IACJ,CAAC;IAED;;;OAGG;IACO,qBAAqB,CAC7B,QAAgD,EAChD,KAAa,EACb,KAAe,EACf,QAAiC,EACjC,UAAkB,EAClB,MAAc;QAEd,MAAM,aAAa,GAAW,QAAQ,CAAC,KAAK,EAAE,aAAa,IAAI,CAAC,CAAC;QACjE,MAAM,KAAK,GAAW,aAAa,IAAI,IAAI,CAAC,cAAc,CAAC,KAAK,CAAC,CAAC;QAClE,MAAM,KAAK,GAAW,QAAQ,CAAC,KAAK,EAAE,YAAY,IAAI,KAAK,CAAC;QAE5D,IAAI,CAAC,aAAa,CAAC;YACjB,QAAQ,EAAE,QAAQ;YAClB,QAAQ,EAAE,IAAI,CAAC,YAAY;YAC3B,KAAK,EAAE,KAAK;YACZ,UAAU,EAAE;gBACV,KAAK,EAAE,KAAK;gBACZ,KAAK,EAAE,KAAK;aACb;YACD,UAAU,EAAE,UAAU;YACtB,MAAM,EAAE,MAAM;YACd,SAAS,EAAE,IAAI,IAAI,EAAE;SACtB,CAAC,CAAC;IACL,CAAC;IAED,oFAAoF;IAC1E,cAAc,CAAC,KAAe;QACtC,IAAI,KAAK,GAAW,CAAC,CAAC;QAEtB,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;YACzB,KAAK,IAAI,CAAC,IAAI,IAAI,EAAE,CAAC,CAAC,MAAM,CAAC;QAC/B,CAAC;QAED,OAAO,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,IAAI,CAAC,KAAK,GAAG,CAAC,CAAC,CAAC,CAAC;IAC3C,CAAC;IAED,sFAAsF;IAC5E,iBAAiB;QACzB,OAAO,OAAO,CAAC,GAAG,CAAC,wBAAwB,IAAI,uBAAuB,CAAC;IACzE,CAAC;IAED,mFAAmF;IACzE,mBAAmB,CAAC,KAAa;QACzC,OAAO,KAAK,CAAC,OAAO,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC;IACnC,CAAC;IAED,0EAA0E;IAChE,QAAQ,CAAC,KAAa;QAC9B,MAAM,OAAO,GAAW,CAAC,KAAK,IAAI,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC;QAEpD,OAAO,OAAO,CAAC,MAAM,KAAK,GAAG,CAAC,CAAC,CAAC,GAAG,OAAO,GAAG,CAAC,CAAC,CAAC,OAAO,CAAC;IAC1D,CAAC;IAED,qFAAqF;IAC3E,UAAU,CAAC,GAAY,EAAE,GAAW;QAC5C,IAAI,GAAG,KAAK,IAAI,IAAI,OAAO,GAAG,KAAK,QAAQ,EAAE,CAAC;YAC5C,OAAO,CAAC,CAAC;QACX,CAAC;QACD,MAAM,KAAK,GAAY,OAAO,CAAC,GAAG,CAAC,GAAG,EAAE,GAAG,CAAC,CAAC;QAE7C,OAAO,OAAO,KAAK,KAAK,QAAQ,IAAI,MAAM,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC;IACzE,CAAC;CACF;AAzWD,0FAyWC"}

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

@@ -1,111 +1,3 @@
-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_CostEventCallback } from '../_models/interfaces/dynts-ai-cost-event-callback.interface';
-import { DyNTS_AI_Embedding_ServiceBase } from './ai-embedding.service-base';
-/**
- * Az LM Studio embedding control-service config-set-je. A `baseUrl` az OpenAI-kompatibilis
- * lokális endpoint (pl. `http://localhost:1234/v1`), az `apiKey` opcionális (LM Studio default-
- * ban nem kér Bearer-t). Az `onCostEvent` a per-call cost-event sink (FR-002, BFR-AM-007).
- */
-export interface DyNTS_LMStudio_Embedding_Settings {
-    /** OpenAI-kompatibilis lokális embedding-endpoint base URL-je (pl. `http://localhost:1234/v1`). */
-    baseUrl: string;
-    /** Opcionális Bearer token (LM Studio default-ban nem kér). */
-    apiKey?: string;
-    /** Per-call cost-event callback (FR-002 / BFR-AM-007). Non-breaking: ha undefined, nincs emit. */
-    onCostEvent?: DyNTS_AI_CostEventCallback;
-}
-/**
- * `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).
- */
-export declare class DyNTS_LMStudio_Embedding_ControlService extends DyNTS_AI_Embedding_ServiceBase {
-    /** A provider-azonosító a `LocalAI` enum-érték (LM Studio = lokális OpenAI-kompatibilis endpoint). */
-    readonly aiProvider: DyFM_AI_Provider;
-    /** A cost-event provider-string (a `DyNTS_AI_CostEvent.provider` szabad-string mezőjéhez). */
-    protected readonly costProvider: string;
-    /** LM Studio (OpenAI-kompatibilis lokális) capability-k: csak embedding-et igénylünk innen. */
-    readonly capabilities: DyFM_AI_ProviderCapabilities;
-    /** Az OpenAI-kompatibilis endpoint base URL-je (trailing slash-mentes). */
-    protected baseUrl: string;
-    /** Opcionális Bearer token. */
-    protected apiKey?: string;
-    /**
-     * @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: DyNTS_LMStudio_Embedding_Settings);
-    /**
-     * 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: DyFM_AI_Config): void;
-    /**
-     * 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.
-     */
-    createEmbedding(set: {
-        text: string;
-        model: string;
-        fullResponse?: boolean;
-        issuer: string;
-    }): Promise<number[] | CreateEmbeddingResponse>;
-    /**
-     * Batch-embedding az OpenAI-kompatibilis `/embeddings` végpontra. A `texts` sorrendje == a
-     * visszaadott `number[][]` sorrendje. `fullResponse=true` esetén a teljes válasz-objektum.
-     */
-    createEmbeddings(set: {
-        texts: string[];
-        model: string;
-        fullResponse?: boolean;
-        issuer: string;
-    }): Promise<number[][] | CreateEmbeddingResponse>;
-    /**
-     * 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: string): DyFM_DAI_EmbeddingInfo;
-    /**
-     * 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).
-     */
-    testConnection(issuer: string): Promise<boolean>;
-    /**
-     * 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.
-     */
-    protected callEmbeddingsEndpoint(model: string, input: string | string[], issuer: string): Promise<CreateEmbeddingResponse>;
-    /**
-     * 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.
-     */
-    protected normalizeResponse(json: unknown, expectedCount: number, url: string, modelId: string): CreateEmbeddingResponse;
-    /**
-     * 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.
-     */
-    protected emitLmStudioCostEvent(callType: 'embedding-single' | 'embedding-batch', model: string, texts: string[], response: CreateEmbeddingResponse, durationMs: number, issuer: string): void;
-    /** Becsült token-szám lokális endpoint-hoz (ha nincs `usage`): 4 char ≈ 1 token. */
-    protected estimateTokens(texts: string[]): number;
-    /** A `testConnection` próba-modellje (env-override-olható, default a FAM-mintára). */
-    protected defaultProbeModel(): string;
-    /** Trailing `/`-ek levágása (kettős slash elkerülése a `/embeddings` join-nál). */
-    protected trimTrailingSlashes(value: string): string;
-    /** Rövid, biztonságos válasz-snapshot a hiba-üzenethez (max 300 char). */
-    protected snapshot(value: string): string;
-    /** Egy number mező típusbiztos kiolvasása egy ismeretlen objektumból (hiány → 0). */
-    protected readNumber(obj: unknown, key: string): number;
-}
+/** @deprecated Use the canonical lm-studio-embedding.control-service module. Retained for existing module paths. */
+export * from './lm-studio-embedding.control-service';
 //# sourceMappingURL=lmstudio-embedding.control-service.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"lmstudio-embedding.control-service.d.ts","sourceRoot":"","sources":["../../../../src/_modules/ai/_services/lmstudio-embedding.control-service.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"lmstudio-embedding.control-service.d.ts","sourceRoot":"","sources":["../../../../src/_modules/ai/_services/lmstudio-embedding.control-service.ts"],"names":[],"mappings":"AAAA,oHAAoH;AACpH,cAAc,uCAAuC,CAAC"}