@futdevpro/nts-dynamo 1.15.56 → 1.15.58

package/build/_modules/ai/_services/ai-embedding-mock.service.js

@@ -0,0 +1,167 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.DyNTS_AI_Embedding_MockService = exports.DyNTS_AI_MOCK_EMBEDDING_DIMS = void 0;
+const tslib_1 = require("tslib");
+const crypto = tslib_1.__importStar(require("crypto"));
+const ai_1 = require("@futdevpro/fsm-dynamo/ai");
+const ai_embedding_service_base_1 = require("./ai-embedding.service-base");
+/** A mock-embedding default dimenziója (kicsi, hogy a teszt-pool gyors legyen, de elég a koszinuszhoz). */
+exports.DyNTS_AI_MOCK_EMBEDDING_DIMS = 64;
+/**
+ * `DyNTS_AI_Embedding_MockService` (BFR-AM-008) — determinisztikus, hash-alapú, fix-dimenziós,
+ * l2-normalizált pszeudo-vektor a szövegből. Provider- és hálózat-mentes → a tesztek + a tsc-/offline-
+ * smoke valódi API-kulcs nélkül futnak. Azonos `(model, text)` → azonos vektor (idempotens), így a
+ * koszinusz-keresés determinisztikusan tesztelhető. A FAM `FAM_Mock_EmbeddingProvider` workaround-ját
+ * emeli bedrock-szintre, mint újrahasználható test-double.
+ *
+ * **Cost-event (BFR-AM-007):** minden call után `emitCostEvent`-tel jelez (fake token-fogyasztás,
+ * 4 char ≈ 1 token), provider `'mock'`, callType `embedding-single` / `embedding-batch`. Így a
+ * cost-aggregáló pipeline mock-providerrel is end-to-end tesztelhető.
+ */
+class DyNTS_AI_Embedding_MockService extends ai_embedding_service_base_1.DyNTS_AI_Embedding_ServiceBase {
+    /** A mock a `LocalAI` provider-enum alá tartozik (nincs külső hívás). */
+    aiProvider = ai_1.DyFM_AI_Provider.LocalAI;
+    /** A cost-event provider-string (a `DyNTS_AI_CostEvent.provider` szabad-string mezőjéhez). */
+    costProvider = 'mock';
+    /** Mock capability-k: csak embedding (determinisztikus). */
+    capabilities = {
+        chat: false,
+        embeddings: true,
+        imageGeneration: false,
+        vision: false,
+        audioGeneration: false,
+        audioAnalysis: false,
+        functionCalling: false,
+        streaming: false,
+        batchOperations: true,
+        supportedModelTypes: [],
+    };
+    /** A generált vektor dimenziója. */
+    dims;
+    /** @param set opcionális dims + onCostEvent. */
+    constructor(set) {
+        super();
+        this.dims = set?.dims && set.dims > 0 ? set.dims : exports.DyNTS_AI_MOCK_EMBEDDING_DIMS;
+        if (set?.onCostEvent) {
+            this.onCostEvent = set.onCostEvent;
+        }
+    }
+    /** A mock-nak nincs külső config-ja; a `setup` a dimenzió override-jára szolgál (config.dimensions). */
+    setup(config) {
+        const dims = Reflect.get(config ?? {}, 'dimensions');
+        if (typeof dims === 'number' && dims > 0) {
+            this.dims = dims;
+        }
+    }
+    /**
+     * Egy determinisztikus embedding. A `model`-t beleszövi a seed-be, hogy modell-váltás más vektort
+     * adjon (re-embed teszteléshez). `fullResponse=true` → OpenAI-alakú válasz-objektum.
+     */
+    async createEmbedding(set) {
+        const start = Date.now();
+        const vector = this.deterministicVector(`${set.model}::${set.text ?? ''}`);
+        const durationMs = Date.now() - start;
+        this.emitMockCostEvent('embedding-single', set.model, [set.text ?? ''], durationMs, set.issuer);
+        if (set.fullResponse) {
+            return this.toResponse([vector], set.model, [set.text ?? '']);
+        }
+        return vector;
+    }
+    /**
+     * Determinisztikus batch-embedding: minden szöveghez a `(model, text)` seed-ből generál egy fix-
+     * dimenziós, l2-normalizált vektort. A `texts` sorrendje == a visszaadott `number[][]` sorrendje.
+     */
+    async createEmbeddings(set) {
+        const texts = set.texts ?? [];
+        const start = Date.now();
+        const vectors = texts.map((text) => this.deterministicVector(`${set.model}::${text}`));
+        const durationMs = Date.now() - start;
+        this.emitMockCostEvent('embedding-batch', set.model, texts, durationMs, set.issuer);
+        if (set.fullResponse) {
+            return this.toResponse(vectors, set.model, texts);
+        }
+        return vectors;
+    }
+    /** Embedding model-info: provider `LocalAI`, model a megadott azonosító. */
+    getEmbeddingInfo(model) {
+        return {
+            provider: ai_1.DyFM_AI_Provider.LocalAI,
+            model: model,
+        };
+    }
+    /** A mock mindig elérhető (nincs külső függőség). */
+    async testConnection(_issuer) {
+        return true;
+    }
+    // =========================================================================
+    // belső: determinisztikus vektor + cost-event + response-alak
+    // =========================================================================
+    /**
+     * Egy determinisztikus, l2-normalizált vektor a seed-ből. A SHA-256 hash bájtjait körkörösen
+     * használja a `dims` kitöltésére, [-1, 1) tartományra képzi, majd l2-normalizál (egységhossz a
+     * koszinuszhoz). Egy második hash-bájttal kever, hogy a hosszabb dimenziókon ne ismétlődjön a minta.
+     */
+    deterministicVector(seed) {
+        const hash = crypto.createHash('sha256').update(seed).digest();
+        const vector = [];
+        for (let i = 0; i < this.dims; i++) {
+            const byte = hash[i % hash.length];
+            const mix = hash[(i * 7 + 3) % hash.length];
+            const combined = (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). */
+    l2Normalize(vector) {
+        let sumSq = 0;
+        for (const value of vector) {
+            sumSq += value * value;
+        }
+        const norm = 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). */
+    toResponse(vectors, model, texts) {
+        const tokens = this.estimateTokens(texts);
+        return {
+            object: 'list',
+            model: model,
+            data: vectors.map((embedding, index) => ({ object: 'embedding', embedding: embedding, index: index })),
+            usage: {
+                prompt_tokens: tokens,
+                total_tokens: tokens,
+            },
+        };
+    }
+    /** Cost-event emit (BFR-AM-007) fake tokennel (4 char ≈ 1 token), provider `'mock'`. */
+    emitMockCostEvent(callType, model, texts, durationMs, issuer) {
+        const tokens = this.estimateTokens(texts);
+        this.emitCostEvent({
+            callType: callType,
+            provider: this.costProvider,
+            model: model,
+            tokensUsed: {
+                input: tokens,
+                total: tokens,
+            },
+            durationMs: durationMs,
+            issuer: issuer,
+            timestamp: new Date(),
+            estimatedCostUsd: 0,
+        });
+    }
+    /** Becsült (fake) token-szám: 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));
+    }
+}
+exports.DyNTS_AI_Embedding_MockService = DyNTS_AI_Embedding_MockService;
+//# sourceMappingURL=ai-embedding-mock.service.js.map

package/build/_modules/ai/_services/ai-embedding-mock.service.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ai-embedding-mock.service.js","sourceRoot":"","sources":["../../../../src/_modules/ai/_services/ai-embedding-mock.service.ts"],"names":[],"mappings":";;;;AAAA,uDAAiC;AAGjC,iDAA0G;AAG1G,2EAA6E;AAG7E,2GAA2G;AAC9F,QAAA,4BAA4B,GAAW,EAAE,CAAC;AAavD;;;;;;;;;;GAUG;AACH,MAAa,8BAA+B,SAAQ,0DAA8B;IAEhF,yEAAyE;IAChE,UAAU,GAAqB,qBAAgB,CAAC,OAAO,CAAC;IAEjE,8FAA8F;IAC3E,YAAY,GAAW,MAAM,CAAC;IAEjD,4DAA4D;IACnD,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,oCAAoC;IAC1B,IAAI,CAAS;IAEvB,gDAAgD;IAChD,YAAY,GAAqC;QAC/C,KAAK,EAAE,CAAC;QACR,IAAI,CAAC,IAAI,GAAG,GAAG,EAAE,IAAI,IAAI,GAAG,CAAC,IAAI,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC,CAAC,oCAA4B,CAAC;QAChF,IAAI,GAAG,EAAE,WAAW,EAAE,CAAC;YACrB,IAAI,CAAC,WAAW,GAAG,GAAG,CAAC,WAAW,CAAC;QACrC,CAAC;IACH,CAAC;IAED,wGAAwG;IACxG,KAAK,CAAC,MAAsB;QAC1B,MAAM,IAAI,GAAY,OAAO,CAAC,GAAG,CAAC,MAAM,IAAI,EAAE,EAAE,YAAY,CAAC,CAAC;QAC9D,IAAI,OAAO,IAAI,KAAK,QAAQ,IAAI,IAAI,GAAG,CAAC,EAAE,CAAC;YACzC,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC;QACnB,CAAC;IACH,CAAC;IAED;;;OAGG;IACH,KAAK,CAAC,eAAe,CACnB,GAKC;QAED,MAAM,KAAK,GAAW,IAAI,CAAC,GAAG,EAAE,CAAC;QACjC,MAAM,MAAM,GAAa,IAAI,CAAC,mBAAmB,CAAC,GAAG,GAAG,CAAC,KAAK,KAAK,GAAG,CAAC,IAAI,IAAI,EAAE,EAAE,CAAC,CAAC;QACrF,MAAM,UAAU,GAAW,IAAI,CAAC,GAAG,EAAE,GAAG,KAAK,CAAC;QAE9C,IAAI,CAAC,iBAAiB,CAAC,kBAAkB,EAAE,GAAG,CAAC,KAAK,EAAE,CAAC,GAAG,CAAC,IAAI,IAAI,EAAE,CAAC,EAAE,UAAU,EAAE,GAAG,CAAC,MAAM,CAAC,CAAC;QAEhG,IAAI,GAAG,CAAC,YAAY,EAAE,CAAC;YACrB,OAAO,IAAI,CAAC,UAAU,CAAC,CAAC,MAAM,CAAC,EAAE,GAAG,CAAC,KAAK,EAAE,CAAC,GAAG,CAAC,IAAI,IAAI,EAAE,CAAC,CAAC,CAAC;QAChE,CAAC;QACD,OAAO,MAAM,CAAC;IAChB,CAAC;IAED;;;OAGG;IACH,KAAK,CAAC,gBAAgB,CACpB,GAKC;QAED,MAAM,KAAK,GAAa,GAAG,CAAC,KAAK,IAAI,EAAE,CAAC;QACxC,MAAM,KAAK,GAAW,IAAI,CAAC,GAAG,EAAE,CAAC;QACjC,MAAM,OAAO,GAAe,KAAK,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,mBAAmB,CAAC,GAAG,GAAG,CAAC,KAAK,KAAK,IAAI,EAAE,CAAC,CAAC,CAAC;QACnG,MAAM,UAAU,GAAW,IAAI,CAAC,GAAG,EAAE,GAAG,KAAK,CAAC;QAE9C,IAAI,CAAC,iBAAiB,CAAC,iBAAiB,EAAE,GAAG,CAAC,KAAK,EAAE,KAAK,EAAE,UAAU,EAAE,GAAG,CAAC,MAAM,CAAC,CAAC;QAEpF,IAAI,GAAG,CAAC,YAAY,EAAE,CAAC;YACrB,OAAO,IAAI,CAAC,UAAU,CAAC,OAAO,EAAE,GAAG,CAAC,KAAK,EAAE,KAAK,CAAC,CAAC;QACpD,CAAC;QACD,OAAO,OAAO,CAAC;IACjB,CAAC;IAED,4EAA4E;IAC5E,gBAAgB,CAAC,KAAa;QAC5B,OAAO;YACL,QAAQ,EAAE,qBAAgB,CAAC,OAAO;YAClC,KAAK,EAAE,KAAK;SACb,CAAC;IACJ,CAAC;IAED,qDAAqD;IACrD,KAAK,CAAC,cAAc,CAAC,OAAe;QAClC,OAAO,IAAI,CAAC;IACd,CAAC;IAED,4EAA4E;IAC5E,8DAA8D;IAC9D,4EAA4E;IAE5E;;;;OAIG;IACO,mBAAmB,CAAC,IAAY;QACxC,MAAM,IAAI,GAAW,MAAM,CAAC,UAAU,CAAC,QAAQ,CAAC,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,MAAM,EAAE,CAAC;QACvE,MAAM,MAAM,GAAa,EAAE,CAAC;QAC5B,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,IAAI,CAAC,IAAI,EAAE,CAAC,EAAE,EAAE,CAAC;YACnC,MAAM,IAAI,GAAW,IAAI,CAAC,CAAC,GAAG,IAAI,CAAC,MAAM,CAAC,CAAC;YAC3C,MAAM,GAAG,GAAW,IAAI,CAAC,CAAC,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,GAAG,IAAI,CAAC,MAAM,CAAC,CAAC;YACpD,MAAM,QAAQ,GAAW,CAAC,IAAI,GAAG,GAAG,CAAC,GAAG,IAAI,CAAC;YAC7C,MAAM,CAAC,IAAI,CAAC,CAAC,QAAQ,GAAG,GAAG,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,CAAC;QACxC,CAAC;QACD,OAAO,IAAI,CAAC,WAAW,CAAC,MAAM,CAAC,CAAC;IAClC,CAAC;IAED,wFAAwF;IAC9E,WAAW,CAAC,MAAgB;QACpC,IAAI,KAAK,GAAW,CAAC,CAAC;QACtB,KAAK,MAAM,KAAK,IAAI,MAAM,EAAE,CAAC;YAC3B,KAAK,IAAI,KAAK,GAAG,KAAK,CAAC;QACzB,CAAC;QACD,MAAM,IAAI,GAAW,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;QACtC,IAAI,CAAC,IAAI,EAAE,CAAC;YACV,OAAO,MAAM,CAAC;QAChB,CAAC;QACD,OAAO,MAAM,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,GAAG,IAAI,CAAC,CAAC;IAC7C,CAAC;IAED,gFAAgF;IACtE,UAAU,CAAC,OAAmB,EAAE,KAAa,EAAE,KAAe;QACtE,MAAM,MAAM,GAAW,IAAI,CAAC,cAAc,CAAC,KAAK,CAAC,CAAC;QAClD,OAAO;YACL,MAAM,EAAE,MAAM;YACd,KAAK,EAAE,KAAK;YACZ,IAAI,EAAE,OAAO,CAAC,GAAG,CAAC,CAAC,SAAS,EAAE,KAAK,EAAE,EAAE,CAAC,CAAC,EAAE,MAAM,EAAE,WAAW,EAAE,SAAS,EAAE,SAAS,EAAE,KAAK,EAAE,KAAK,EAAE,CAAC,CAAC;YACtG,KAAK,EAAE;gBACL,aAAa,EAAE,MAAM;gBACrB,YAAY,EAAE,MAAM;aACrB;SACF,CAAC;IACJ,CAAC;IAED,wFAAwF;IAC9E,iBAAiB,CACzB,QAAgD,EAChD,KAAa,EACb,KAAe,EACf,UAAkB,EAClB,MAAc;QAEd,MAAM,MAAM,GAAW,IAAI,CAAC,cAAc,CAAC,KAAK,CAAC,CAAC;QAClD,IAAI,CAAC,aAAa,CAAC;YACjB,QAAQ,EAAE,QAAQ;YAClB,QAAQ,EAAE,IAAI,CAAC,YAAY;YAC3B,KAAK,EAAE,KAAK;YACZ,UAAU,EAAE;gBACV,KAAK,EAAE,MAAM;gBACb,KAAK,EAAE,MAAM;aACd;YACD,UAAU,EAAE,UAAU;YACtB,MAAM,EAAE,MAAM;YACd,SAAS,EAAE,IAAI,IAAI,EAAE;YACrB,gBAAgB,EAAE,CAAC;SACpB,CAAC,CAAC;IACL,CAAC;IAED,mDAAmD;IACzC,cAAc,CAAC,KAAe;QACtC,IAAI,KAAK,GAAW,CAAC,CAAC;QACtB,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;YACzB,KAAK,IAAI,CAAC,IAAI,IAAI,EAAE,CAAC,CAAC,MAAM,CAAC;QAC/B,CAAC;QACD,OAAO,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,IAAI,CAAC,KAAK,GAAG,CAAC,CAAC,CAAC,CAAC;IAC3C,CAAC;CACF;AAxLD,wEAwLC"}

package/build/_modules/ai/_services/ai-embedding-provider.registry.d.ts

@@ -0,0 +1,52 @@
+import { DyFM_OAI_Settings } from '@futdevpro/fsm-dynamo/ai/open-ai';
+import { DyNTS_AI_Embedding_ServiceBase } from './ai-embedding.service-base';
+import { DyNTS_LMStudio_Embedding_Settings } from './lmstudio-embedding.control-service';
+import { DyNTS_AI_Embedding_MockSettings } from './ai-embedding-mock.service';
+import { DyNTS_AI_CostEventCallback } from '../_models/interfaces/dynts-ai-cost-event-callback.interface';
+/**
+ * Az embedding-provider kulcsa (BFR-AM-002). String-union, NEM enum (a cost-event provider-stringekkel
+ * konzisztens): `'openai'` (SDK reuse), `'lmstudio'` (lokális OpenAI-kompatibilis HTTP), `'mock'`
+ * (determinisztikus test-double). Az env-feloldás kis-/nagybetűt és a `lm-studio` alias-t is elfogad.
+ */
+export type DyNTS_AI_EmbeddingProviderKey = 'openai' | 'lmstudio' | 'mock';
+/**
+ * A provider-feloldás opciói. A `provider` explicit kulcsot ad; ha hiányzik, az env-ből oldjuk fel
+ * (`AI_EMBEDDING_PROVIDER`, default `openai`). A többi mező a megfelelő provider config-ját adja át.
+ */
+export interface DyNTS_AI_EmbeddingResolveOptions {
+    /** Explicit provider-kulcs; ha hiányzik → env-feloldás. */
+    provider?: DyNTS_AI_EmbeddingProviderKey | string;
+    /** Per-call cost-event sink (FR-002 / BFR-AM-007) — mind a 3 providernek átadva. */
+    onCostEvent?: DyNTS_AI_CostEventCallback;
+    /** OpenAI-specifikus config (apiKey/org/project/defaultSettings) — `openai` providerhez. */
+    openAiSettings?: DyFM_OAI_Settings;
+    /** LM Studio config (baseUrl/apiKey) — `lmstudio` providerhez; baseUrl hiány → env (`LMSTUDIO_BASE_URL`). */
+    lmStudioSettings?: Partial<DyNTS_LMStudio_Embedding_Settings>;
+    /** Mock config (dims) — `mock` providerhez. */
+    mockSettings?: DyNTS_AI_Embedding_MockSettings;
+}
+/**
+ * `DyNTS_AI_EmbeddingProvider_Registry` (BFR-AM-002) — provider-dispatch resolver. A provider-kulcs
+ * (`openai` | `lmstudio` | `mock`) alapján a megfelelő `DyNTS_AI_Embedding_ServiceBase` példányt adja
+ * vissza, így a hívók egységes embedding-felületet látnak a konkrét provider-impl mögött (a FAM
+ * `FAM_Embedding_ControlService.buildProvider` dispatch-ét emeli bedrock-szintre, generikusan).
+ *
+ * Static util (nincs állapota): minden hívás friss példányt épít (env/secret a hívás-időpontban
+ * érvényes — memory: `dynts_dataservice_eager_resolve`-konzisztens, nincs élő singleton-állapot).
+ */
+export declare class DyNTS_AI_EmbeddingProvider_Registry {
+    /**
+     * A megadott (vagy env-ből feloldott) provider-kulcs alapján egy embedding-service példányt épít.
+     * - `openai` → `DyNTS_OAI_Embedding_ControlService` (SDK reuse, cost-event sink-kel),
+     * - `lmstudio` → `DyNTS_LMStudio_Embedding_ControlService` (HTTP; baseUrl a config vagy env),
+     * - `mock` → `DyNTS_AI_Embedding_MockService` (determinisztikus),
+     * - ismeretlen → `Error` (provider nincs konfigurálva — nem néma).
+     */
+    static resolve(options?: DyNTS_AI_EmbeddingResolveOptions): DyNTS_AI_Embedding_ServiceBase;
+    /**
+     * A provider-kulcs normalizálása: kis-/nagybetű-független, a `lm-studio` / `local-ai` alias-t
+     * `lmstudio`-ra képzi. Hiány → env (`AI_EMBEDDING_PROVIDER`) → default `openai`. Ismeretlen → `Error`.
+     */
+    static normalizeKey(provider?: string): DyNTS_AI_EmbeddingProviderKey;
+}
+//# sourceMappingURL=ai-embedding-provider.registry.d.ts.map

package/build/_modules/ai/_services/ai-embedding-provider.registry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ai-embedding-provider.registry.d.ts","sourceRoot":"","sources":["../../../../src/_modules/ai/_services/ai-embedding-provider.registry.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,iBAAiB,EAAE,MAAM,kCAAkC,CAAC;AAErE,OAAO,EAAE,8BAA8B,EAAE,MAAM,6BAA6B,CAAC;AAE7E,OAAO,EAA2C,iCAAiC,EAAE,MAAM,sCAAsC,CAAC;AAClI,OAAO,EAAkC,+BAA+B,EAAE,MAAM,6BAA6B,CAAC;AAC9G,OAAO,EAAE,0BAA0B,EAAE,MAAM,8DAA8D,CAAC;AAE1G;;;;GAIG;AACH,MAAM,MAAM,6BAA6B,GAAG,QAAQ,GAAG,UAAU,GAAG,MAAM,CAAC;AAE3E;;;GAGG;AACH,MAAM,WAAW,gCAAgC;IAC/C,2DAA2D;IAC3D,QAAQ,CAAC,EAAE,6BAA6B,GAAG,MAAM,CAAC;IAClD,oFAAoF;IACpF,WAAW,CAAC,EAAE,0BAA0B,CAAC;IACzC,4FAA4F;IAC5F,cAAc,CAAC,EAAE,iBAAiB,CAAC;IACnC,6GAA6G;IAC7G,gBAAgB,CAAC,EAAE,OAAO,CAAC,iCAAiC,CAAC,CAAC;IAC9D,+CAA+C;IAC/C,YAAY,CAAC,EAAE,+BAA+B,CAAC;CAChD;AAED;;;;;;;;GAQG;AACH,qBAAa,mCAAmC;IAE9C;;;;;;OAMG;IACH,MAAM,CAAC,OAAO,CAAC,OAAO,CAAC,EAAE,gCAAgC,GAAG,8BAA8B;IAgC1F;;;OAGG;IACH,MAAM,CAAC,YAAY,CAAC,QAAQ,CAAC,EAAE,MAAM,GAAG,6BAA6B;CAuBtE"}

package/build/_modules/ai/_services/ai-embedding-provider.registry.js

@@ -0,0 +1,79 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.DyNTS_AI_EmbeddingProvider_Registry = void 0;
+const oai_embedding_control_service_1 = require("../_modules/open-ai/_services/oai-embedding.control-service");
+const lmstudio_embedding_control_service_1 = require("./lmstudio-embedding.control-service");
+const ai_embedding_mock_service_1 = require("./ai-embedding-mock.service");
+/**
+ * `DyNTS_AI_EmbeddingProvider_Registry` (BFR-AM-002) — provider-dispatch resolver. A provider-kulcs
+ * (`openai` | `lmstudio` | `mock`) alapján a megfelelő `DyNTS_AI_Embedding_ServiceBase` példányt adja
+ * vissza, így a hívók egységes embedding-felületet látnak a konkrét provider-impl mögött (a FAM
+ * `FAM_Embedding_ControlService.buildProvider` dispatch-ét emeli bedrock-szintre, generikusan).
+ *
+ * Static util (nincs állapota): minden hívás friss példányt épít (env/secret a hívás-időpontban
+ * érvényes — memory: `dynts_dataservice_eager_resolve`-konzisztens, nincs élő singleton-állapot).
+ */
+class DyNTS_AI_EmbeddingProvider_Registry {
+    /**
+     * A megadott (vagy env-ből feloldott) provider-kulcs alapján egy embedding-service példányt épít.
+     * - `openai` → `DyNTS_OAI_Embedding_ControlService` (SDK reuse, cost-event sink-kel),
+     * - `lmstudio` → `DyNTS_LMStudio_Embedding_ControlService` (HTTP; baseUrl a config vagy env),
+     * - `mock` → `DyNTS_AI_Embedding_MockService` (determinisztikus),
+     * - ismeretlen → `Error` (provider nincs konfigurálva — nem néma).
+     */
+    static resolve(options) {
+        const key = DyNTS_AI_EmbeddingProvider_Registry.normalizeKey(options?.provider);
+        const onCostEvent = options?.onCostEvent;
+        switch (key) {
+            case 'openai':
+                return new oai_embedding_control_service_1.DyNTS_OAI_Embedding_ControlService({
+                    ...(options?.openAiSettings ?? {}),
+                    onCostEvent: onCostEvent,
+                });
+            case 'lmstudio': {
+                const baseUrl = 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 lmstudio_embedding_control_service_1.DyNTS_LMStudio_Embedding_ControlService({
+                    baseUrl: baseUrl,
+                    apiKey: options?.lmStudioSettings?.apiKey ?? process.env.LMSTUDIO_API_KEY,
+                    onCostEvent: onCostEvent,
+                });
+            }
+            case 'mock':
+                return new ai_embedding_mock_service_1.DyNTS_AI_Embedding_MockService({
+                    ...(options?.mockSettings ?? {}),
+                    onCostEvent: onCostEvent,
+                });
+        }
+    }
+    /**
+     * A provider-kulcs normalizálása: kis-/nagybetű-független, a `lm-studio` / `local-ai` alias-t
+     * `lmstudio`-ra képzi. Hiány → env (`AI_EMBEDDING_PROVIDER`) → default `openai`. Ismeretlen → `Error`.
+     */
+    static normalizeKey(provider) {
+        const raw = (provider ?? process.env.AI_EMBEDDING_PROVIDER ?? 'openai').trim().toLowerCase();
+        switch (raw) {
+            case 'openai':
+            case 'open-ai':
+            case 'oai':
+                return 'openai';
+            case 'lmstudio':
+            case 'lm-studio':
+            case 'local-ai':
+            case 'localai':
+                return 'lmstudio';
+            case 'mock':
+            case 'fake':
+            case 'test':
+                return 'mock';
+            default:
+                throw new Error(`DyNTS_AI_EmbeddingProvider_Registry: unknown embedding provider '${raw}'. `
+                    + `Available: 'openai' | 'lmstudio' | 'mock'.`);
+        }
+    }
+}
+exports.DyNTS_AI_EmbeddingProvider_Registry = DyNTS_AI_EmbeddingProvider_Registry;
+//# sourceMappingURL=ai-embedding-provider.registry.js.map

package/build/_modules/ai/_services/ai-embedding-provider.registry.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ai-embedding-provider.registry.js","sourceRoot":"","sources":["../../../../src/_modules/ai/_services/ai-embedding-provider.registry.ts"],"names":[],"mappings":";;;AAGA,+GAAiH;AACjH,6FAAkI;AAClI,2EAA8G;AA2B9G;;;;;;;;GAQG;AACH,MAAa,mCAAmC;IAE9C;;;;;;OAMG;IACH,MAAM,CAAC,OAAO,CAAC,OAA0C;QACvD,MAAM,GAAG,GAAkC,mCAAmC,CAAC,YAAY,CAAC,OAAO,EAAE,QAAQ,CAAC,CAAC;QAC/G,MAAM,WAAW,GAA2C,OAAO,EAAE,WAAW,CAAC;QAEjF,QAAQ,GAAG,EAAE,CAAC;YACZ,KAAK,QAAQ;gBACX,OAAO,IAAI,kEAAkC,CAAC;oBAC5C,GAAG,CAAC,OAAO,EAAE,cAAc,IAAI,EAAE,CAAC;oBAClC,WAAW,EAAE,WAAW;iBACzB,CAAC,CAAC;YACL,KAAK,UAAU,CAAC,CAAC,CAAC;gBAChB,MAAM,OAAO,GAAuB,OAAO,EAAE,gBAAgB,EAAE,OAAO,IAAI,OAAO,CAAC,GAAG,CAAC,iBAAiB,CAAC;gBACxG,IAAI,CAAC,OAAO,EAAE,CAAC;oBACb,MAAM,IAAI,KAAK,CACb,yFAAyF;0BACvF,+EAA+E,CAClF,CAAC;gBACJ,CAAC;gBACD,OAAO,IAAI,4EAAuC,CAAC;oBACjD,OAAO,EAAE,OAAO;oBAChB,MAAM,EAAE,OAAO,EAAE,gBAAgB,EAAE,MAAM,IAAI,OAAO,CAAC,GAAG,CAAC,gBAAgB;oBACzE,WAAW,EAAE,WAAW;iBACzB,CAAC,CAAC;YACL,CAAC;YACD,KAAK,MAAM;gBACT,OAAO,IAAI,0DAA8B,CAAC;oBACxC,GAAG,CAAC,OAAO,EAAE,YAAY,IAAI,EAAE,CAAC;oBAChC,WAAW,EAAE,WAAW;iBACzB,CAAC,CAAC;QACP,CAAC;IACH,CAAC;IAED;;;OAGG;IACH,MAAM,CAAC,YAAY,CAAC,QAAiB;QACnC,MAAM,GAAG,GAAW,CAAC,QAAQ,IAAI,OAAO,CAAC,GAAG,CAAC,qBAAqB,IAAI,QAAQ,CAAC,CAAC,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC;QACrG,QAAQ,GAAG,EAAE,CAAC;YACZ,KAAK,QAAQ,CAAC;YACd,KAAK,SAAS,CAAC;YACf,KAAK,KAAK;gBACR,OAAO,QAAQ,CAAC;YAClB,KAAK,UAAU,CAAC;YAChB,KAAK,WAAW,CAAC;YACjB,KAAK,UAAU,CAAC;YAChB,KAAK,SAAS;gBACZ,OAAO,UAAU,CAAC;YACpB,KAAK,MAAM,CAAC;YACZ,KAAK,MAAM,CAAC;YACZ,KAAK,MAAM;gBACT,OAAO,MAAM,CAAC;YAChB;gBACE,MAAM,IAAI,KAAK,CACb,oEAAoE,GAAG,KAAK;sBAC1E,4CAA4C,CAC/C,CAAC;QACN,CAAC;IACH,CAAC;CACF;AApED,kFAoEC"}

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

@@ -0,0 +1,111 @@
+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';
+/**
+ * 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;
+}
+//# sourceMappingURL=lmstudio-embedding.control-service.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"lmstudio-embedding.control-service.d.ts","sourceRoot":"","sources":["../../../../src/_modules/ai/_services/lmstudio-embedding.control-service.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,uBAAuB,EAAE,MAAM,kBAAkB,CAAC;AAC3D,OAAO,EAAE,gBAAgB,EAAE,4BAA4B,EAAE,cAAc,EAAE,MAAM,0BAA0B,CAAC;AAC1G,OAAO,EAAE,sBAAsB,EAAE,MAAM,sCAAsC,CAAC;AAG9E,OAAO,EAAE,8BAA8B,EAAE,MAAM,6BAA6B,CAAC;AAC7E,OAAO,EAAE,0BAA0B,EAAE,MAAM,8DAA8D,CAAC;AAG1G;;;;GAIG;AACH,MAAM,WAAW,iCAAiC;IAChD,mGAAmG;IACnG,OAAO,EAAE,MAAM,CAAC;IAChB,+DAA+D;IAC/D,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,kGAAkG;IAClG,WAAW,CAAC,EAAE,0BAA0B,CAAC;CAC1C;AAED;;;;;;;;;;;;GAYG;AACH,qBAAa,uCAAwC,SAAQ,8BAA8B;IAEzF,sGAAsG;IACtG,QAAQ,CAAC,UAAU,EAAE,gBAAgB,CAA4B;IAEjE,8FAA8F;IAC9F,SAAS,CAAC,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAe;IAEtD,+FAA+F;IAC/F,QAAQ,CAAC,YAAY,EAAE,4BAA4B,CAWjD;IAEF,2EAA2E;IAC3E,SAAS,CAAC,OAAO,EAAE,MAAM,CAAC;IAE1B,+BAA+B;IAC/B,SAAS,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC;IAE1B;;;OAGG;gBACS,GAAG,EAAE,iCAAiC;IAmBlD;;;OAGG;IACH,KAAK,CAAC,MAAM,EAAE,cAAc,GAAG,IAAI;IASnC;;;OAGG;IACG,eAAe,CACnB,GAAG,EAAE;QACH,IAAI,EAAE,MAAM,CAAC;QACb,KAAK,EAAE,MAAM,CAAC;QACd,YAAY,CAAC,EAAE,OAAO,CAAC;QACvB,MAAM,EAAE,MAAM,CAAC;KAChB,GACA,OAAO,CAAC,MAAM,EAAE,GAAG,uBAAuB,CAAC;IA8B9C;;;OAGG;IACG,gBAAgB,CACpB,GAAG,EAAE;QACH,KAAK,EAAE,MAAM,EAAE,CAAC;QAChB,KAAK,EAAE,MAAM,CAAC;QACd,YAAY,CAAC,EAAE,OAAO,CAAC;QACvB,MAAM,EAAE,MAAM,CAAC;KAChB,GACA,OAAO,CAAC,MAAM,EAAE,EAAE,GAAG,uBAAuB,CAAC;IA8BhD;;;OAGG;IACH,gBAAgB,CAAC,KAAK,EAAE,MAAM,GAAG,sBAAsB;IAOvD;;;OAGG;IACG,cAAc,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAsBtD;;;;OAIG;cACa,sBAAsB,CACpC,KAAK,EAAE,MAAM,EACb,KAAK,EAAE,MAAM,GAAG,MAAM,EAAE,EACxB,MAAM,EAAE,MAAM,GACb,OAAO,CAAC,uBAAuB,CAAC;IAkCnC;;;;OAIG;IACH,SAAS,CAAC,iBAAiB,CAAC,IAAI,EAAE,OAAO,EAAE,aAAa,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,uBAAuB;IA+CxH;;;OAGG;IACH,SAAS,CAAC,qBAAqB,CAC7B,QAAQ,EAAE,kBAAkB,GAAG,iBAAiB,EAChD,KAAK,EAAE,MAAM,EACb,KAAK,EAAE,MAAM,EAAE,EACf,QAAQ,EAAE,uBAAuB,EACjC,UAAU,EAAE,MAAM,EAClB,MAAM,EAAE,MAAM,GACb,IAAI;IAmBP,oFAAoF;IACpF,SAAS,CAAC,cAAc,CAAC,KAAK,EAAE,MAAM,EAAE,GAAG,MAAM;IAQjD,sFAAsF;IACtF,SAAS,CAAC,iBAAiB,IAAI,MAAM;IAIrC,mFAAmF;IACnF,SAAS,CAAC,mBAAmB,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM;IAIpD,0EAA0E;IAC1E,SAAS,CAAC,QAAQ,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM;IAKzC,qFAAqF;IACrF,SAAS,CAAC,UAAU,CAAC,GAAG,EAAE,OAAO,EAAE,GAAG,EAAE,MAAM,GAAG,MAAM;CAOxD"}