@futdevpro/nts-dynamo 1.15.156 → 1.15.157

package/build/_modules/ai/_services/ai-provider.service-base.d.ts

@@ -1,47 +1,47 @@
-import { DyFM_AI_Provider } from '@futdevpro/fsm-dynamo/ai';
-import { DyFM_AI_ProviderCapabilities } from '@futdevpro/fsm-dynamo/ai';
-import { DyFM_AI_Config } from '@futdevpro/fsm-dynamo/ai';
-import { DyNTS_AI_CostEvent } from '../_models/interfaces/dynts-ai-cost-event.interface';
-import { DyNTS_AI_CostEventCallback } from '../_models/interfaces/dynts-ai-cost-event-callback.interface';
-import { DyNTS_SingletonService } from '../../../_services/base/singleton.service';
-/**
- * Abstract base class for all AI providers
- * Defines the common interface that all AI providers must implement
- *
- * **Cost-event hook (FR-002)**: a leszármazott concrete service-ek (OAI
- * Embedding / LLM / Chat) a constructor-ban opcionálisan kapnak egy
- * `onCostEvent` callback-et. Minden sikeres AI-call után `emitCostEvent`-tel
- * hívják, ami safe (try/catch) — a callback hibája NEM akasztja meg az
- * AI-call-t. Lásd `DyNTS_AI_CostEvent` interface.
- */
-export declare abstract class DyNTS_AI_Provider_ServiceBase extends DyNTS_SingletonService {
-    /** The AI provider this service represents */
-    abstract readonly aiProvider: DyFM_AI_Provider;
-    /** The capabilities supported by this provider */
-    abstract readonly capabilities: DyFM_AI_ProviderCapabilities;
-    /**
-     * Optional per-call cost-event callback (FR-002).
-     * A leszármazott service-ek minden sikeres AI-call után meghívják az
-     * `emitCostEvent` helper-en keresztül. Non-breaking: ha undefined, nincs emit.
-     */
-    protected onCostEvent?: DyNTS_AI_CostEventCallback;
-    /**
-     * Initialize the provider with configuration
-     * @param config - Provider-specific configuration
-     */
-    abstract setup(config: DyFM_AI_Config): void;
-    /**
-     * Test the connection to the AI provider
-     * @param issuer - The issuer making the request
-     * @returns Promise<boolean> - True if connection is successful
-     */
-    abstract testConnection(issuer: string): Promise<boolean>;
-    /**
-     * Safe cost-event emit: ha van regisztrált `onCostEvent` callback, meghívja.
-     * A callback hibája NEM propagálódik — try/catch-csel safen hívjuk és
-     * `DyFM_Log.warn`-nal jelezzük. Ezzel a consumer-oldali integráció
-     * (CCAP `CT_`, telemetry, stb.) hibái nem akasztják meg az AI-call-t.
-     */
-    protected emitCostEvent(event: DyNTS_AI_CostEvent): void;
-}
+import { DyFM_AI_Provider } from '@futdevpro/fsm-dynamo/ai';
+import { DyFM_AI_ProviderCapabilities } from '@futdevpro/fsm-dynamo/ai';
+import { DyFM_AI_Config } from '@futdevpro/fsm-dynamo/ai';
+import { DyNTS_AI_CostEvent } from '../_models/interfaces/dynts-ai-cost-event.interface';
+import { DyNTS_AI_CostEventCallback } from '../_models/interfaces/dynts-ai-cost-event-callback.interface';
+import { DyNTS_SingletonService } from '../../../_services/base/singleton.service';
+/**
+ * Abstract base class for all AI providers
+ * Defines the common interface that all AI providers must implement
+ *
+ * **Cost-event hook (FR-002)**: a leszármazott concrete service-ek (OAI
+ * Embedding / LLM / Chat) a constructor-ban opcionálisan kapnak egy
+ * `onCostEvent` callback-et. Minden sikeres AI-call után `emitCostEvent`-tel
+ * hívják, ami safe (try/catch) — a callback hibája NEM akasztja meg az
+ * AI-call-t. Lásd `DyNTS_AI_CostEvent` interface.
+ */
+export declare abstract class DyNTS_AI_Provider_ServiceBase extends DyNTS_SingletonService {
+    /** The AI provider this service represents */
+    abstract readonly aiProvider: DyFM_AI_Provider;
+    /** The capabilities supported by this provider */
+    abstract readonly capabilities: DyFM_AI_ProviderCapabilities;
+    /**
+     * Optional per-call cost-event callback (FR-002).
+     * A leszármazott service-ek minden sikeres AI-call után meghívják az
+     * `emitCostEvent` helper-en keresztül. Non-breaking: ha undefined, nincs emit.
+     */
+    protected onCostEvent?: DyNTS_AI_CostEventCallback;
+    /**
+     * Initialize the provider with configuration
+     * @param config - Provider-specific configuration
+     */
+    abstract setup(config: DyFM_AI_Config): void;
+    /**
+     * Test the connection to the AI provider
+     * @param issuer - The issuer making the request
+     * @returns Promise<boolean> - True if connection is successful
+     */
+    abstract testConnection(issuer: string): Promise<boolean>;
+    /**
+     * Safe cost-event emit: ha van regisztrált `onCostEvent` callback, meghívja.
+     * A callback hibája NEM propagálódik — try/catch-csel safen hívjuk és
+     * `DyFM_Log.warn`-nal jelezzük. Ezzel a consumer-oldali integráció
+     * (CCAP `CT_`, telemetry, stb.) hibái nem akasztják meg az AI-call-t.
+     */
+    protected emitCostEvent(event: DyNTS_AI_CostEvent): void;
+}
 //# sourceMappingURL=ai-provider.service-base.d.ts.map

package/build/_modules/ai/_services/ai-provider.service-base.js

@@ -1,44 +1,44 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.DyNTS_AI_Provider_ServiceBase = void 0;
-const fsm_dynamo_1 = require("@futdevpro/fsm-dynamo");
-const singleton_service_1 = require("../../../_services/base/singleton.service");
-/**
- * Abstract base class for all AI providers
- * Defines the common interface that all AI providers must implement
- *
- * **Cost-event hook (FR-002)**: a leszármazott concrete service-ek (OAI
- * Embedding / LLM / Chat) a constructor-ban opcionálisan kapnak egy
- * `onCostEvent` callback-et. Minden sikeres AI-call után `emitCostEvent`-tel
- * hívják, ami safe (try/catch) — a callback hibája NEM akasztja meg az
- * AI-call-t. Lásd `DyNTS_AI_CostEvent` interface.
- */
-class DyNTS_AI_Provider_ServiceBase extends singleton_service_1.DyNTS_SingletonService {
-    /**
-     * Optional per-call cost-event callback (FR-002).
-     * A leszármazott service-ek minden sikeres AI-call után meghívják az
-     * `emitCostEvent` helper-en keresztül. Non-breaking: ha undefined, nincs emit.
-     */
-    onCostEvent;
-    /**
-     * Safe cost-event emit: ha van regisztrált `onCostEvent` callback, meghívja.
-     * A callback hibája NEM propagálódik — try/catch-csel safen hívjuk és
-     * `DyFM_Log.warn`-nal jelezzük. Ezzel a consumer-oldali integráció
-     * (CCAP `CT_`, telemetry, stb.) hibái nem akasztják meg az AI-call-t.
-     */
-    emitCostEvent(event) {
-        if (!this.onCostEvent) {
-            return;
-        }
-        try {
-            this.onCostEvent(event);
-        }
-        catch (err) {
-            const msg = err instanceof Error ? err.message : String(err);
-            fsm_dynamo_1.DyFM_Log.warn(`DyNTS AI | onCostEvent callback threw (call-type: ${event.callType},`
-                + ` model: ${event.model}, issuer: ${event.issuer}): ${msg}`);
-        }
-    }
-}
-exports.DyNTS_AI_Provider_ServiceBase = DyNTS_AI_Provider_ServiceBase;
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.DyNTS_AI_Provider_ServiceBase = void 0;
+const fsm_dynamo_1 = require("@futdevpro/fsm-dynamo");
+const singleton_service_1 = require("../../../_services/base/singleton.service");
+/**
+ * Abstract base class for all AI providers
+ * Defines the common interface that all AI providers must implement
+ *
+ * **Cost-event hook (FR-002)**: a leszármazott concrete service-ek (OAI
+ * Embedding / LLM / Chat) a constructor-ban opcionálisan kapnak egy
+ * `onCostEvent` callback-et. Minden sikeres AI-call után `emitCostEvent`-tel
+ * hívják, ami safe (try/catch) — a callback hibája NEM akasztja meg az
+ * AI-call-t. Lásd `DyNTS_AI_CostEvent` interface.
+ */
+class DyNTS_AI_Provider_ServiceBase extends singleton_service_1.DyNTS_SingletonService {
+    /**
+     * Optional per-call cost-event callback (FR-002).
+     * A leszármazott service-ek minden sikeres AI-call után meghívják az
+     * `emitCostEvent` helper-en keresztül. Non-breaking: ha undefined, nincs emit.
+     */
+    onCostEvent;
+    /**
+     * Safe cost-event emit: ha van regisztrált `onCostEvent` callback, meghívja.
+     * A callback hibája NEM propagálódik — try/catch-csel safen hívjuk és
+     * `DyFM_Log.warn`-nal jelezzük. Ezzel a consumer-oldali integráció
+     * (CCAP `CT_`, telemetry, stb.) hibái nem akasztják meg az AI-call-t.
+     */
+    emitCostEvent(event) {
+        if (!this.onCostEvent) {
+            return;
+        }
+        try {
+            this.onCostEvent(event);
+        }
+        catch (err) {
+            const msg = err instanceof Error ? err.message : String(err);
+            fsm_dynamo_1.DyFM_Log.warn(`DyNTS AI | onCostEvent callback threw (call-type: ${event.callType},`
+                + ` model: ${event.model}, issuer: ${event.issuer}): ${msg}`);
+        }
+    }
+}
+exports.DyNTS_AI_Provider_ServiceBase = DyNTS_AI_Provider_ServiceBase;
 //# sourceMappingURL=ai-provider.service-base.js.map

package/build/_modules/ai/_services/ai-user-key.service-base.d.ts

@@ -1,45 +1,45 @@
-import { DyFM_AI_Provider, DyFM_AI_Config } from '@futdevpro/fsm-dynamo/ai';
-import { DyFM_AI_UserProviderConfig } from '@futdevpro/fsm-dynamo/ai';
-import { DyNTS_SingletonService } from '../../../_services/base/singleton.service';
-import { DyNTS_AI_TestGeneration_Result } from '../_models/ai-test-generation-result.interface';
-/**
- * Absztrakt bazis osztaly a user AI provider kulcs kezeleshez
- *
- * A titkositas/visszafejtes NEM itt tortenik -- azt az fdp-auth-service Auth_ControlService-e vegzi.
- * Ezek a service-ek a mar visszafejtett config-ot es API kulcsot kapjak,
- * es abbol allitjak ossze a provider-specifikus konfigot.
- */
-export declare abstract class DyNTS_AI_UserKey_ServiceBase extends DyNTS_SingletonService {
-    /** melyik provider-hez tartozik ez a service */
-    abstract readonly aiProvider: DyFM_AI_Provider;
-    /**
-     * Visszafejtett user config + kulcs -> provider-specifikus AI config osszeallitas
-     * @param userProviderConfig - a user provider konfiguracioja
-     * @param decryptedApiKey - a mar visszafejtett API kulcs
-     */
-    abstract resolveConfig(userProviderConfig: DyFM_AI_UserProviderConfig, decryptedApiKey: string): DyFM_AI_Config;
-    /**
-     * Kapcsolat tesztelese a provider-rel a visszafejtett kulccsal
-     * @param userProviderConfig - a user provider konfiguracioja
-     * @param decryptedApiKey - a mar visszafejtett API kulcs
-     */
-    abstract testConnection(userProviderConfig: DyFM_AI_UserProviderConfig, decryptedApiKey: string): Promise<boolean>;
-    /**
-     * Elerheto modellek lekerdezese a provider API-rol
-     * @param userProviderConfig - a user provider konfiguracioja
-     * @param decryptedApiKey - a mar visszafejtett API kulcs
-     */
-    abstract listAvailableModels(userProviderConfig: DyFM_AI_UserProviderConfig, decryptedApiKey: string): Promise<string[]>;
-    /**
-     * Teszt generalas a provider-rel
-     * @param set.userProviderConfig - a user provider konfiguracioja
-     * @param set.decryptedApiKey - a mar visszafejtett API kulcs
-     * @param set.model - a hasznalando modell
-     */
-    abstract testGeneration(set: {
-        userProviderConfig: DyFM_AI_UserProviderConfig;
-        decryptedApiKey: string;
-        model: string;
-    }): Promise<DyNTS_AI_TestGeneration_Result>;
-}
+import { DyFM_AI_Provider, DyFM_AI_Config } from '@futdevpro/fsm-dynamo/ai';
+import { DyFM_AI_UserProviderConfig } from '@futdevpro/fsm-dynamo/ai';
+import { DyNTS_SingletonService } from '../../../_services/base/singleton.service';
+import { DyNTS_AI_TestGeneration_Result } from '../_models/ai-test-generation-result.interface';
+/**
+ * Absztrakt bazis osztaly a user AI provider kulcs kezeleshez
+ *
+ * A titkositas/visszafejtes NEM itt tortenik -- azt az fdp-auth-service Auth_ControlService-e vegzi.
+ * Ezek a service-ek a mar visszafejtett config-ot es API kulcsot kapjak,
+ * es abbol allitjak ossze a provider-specifikus konfigot.
+ */
+export declare abstract class DyNTS_AI_UserKey_ServiceBase extends DyNTS_SingletonService {
+    /** melyik provider-hez tartozik ez a service */
+    abstract readonly aiProvider: DyFM_AI_Provider;
+    /**
+     * Visszafejtett user config + kulcs -> provider-specifikus AI config osszeallitas
+     * @param userProviderConfig - a user provider konfiguracioja
+     * @param decryptedApiKey - a mar visszafejtett API kulcs
+     */
+    abstract resolveConfig(userProviderConfig: DyFM_AI_UserProviderConfig, decryptedApiKey: string): DyFM_AI_Config;
+    /**
+     * Kapcsolat tesztelese a provider-rel a visszafejtett kulccsal
+     * @param userProviderConfig - a user provider konfiguracioja
+     * @param decryptedApiKey - a mar visszafejtett API kulcs
+     */
+    abstract testConnection(userProviderConfig: DyFM_AI_UserProviderConfig, decryptedApiKey: string): Promise<boolean>;
+    /**
+     * Elerheto modellek lekerdezese a provider API-rol
+     * @param userProviderConfig - a user provider konfiguracioja
+     * @param decryptedApiKey - a mar visszafejtett API kulcs
+     */
+    abstract listAvailableModels(userProviderConfig: DyFM_AI_UserProviderConfig, decryptedApiKey: string): Promise<string[]>;
+    /**
+     * Teszt generalas a provider-rel
+     * @param set.userProviderConfig - a user provider konfiguracioja
+     * @param set.decryptedApiKey - a mar visszafejtett API kulcs
+     * @param set.model - a hasznalando modell
+     */
+    abstract testGeneration(set: {
+        userProviderConfig: DyFM_AI_UserProviderConfig;
+        decryptedApiKey: string;
+        model: string;
+    }): Promise<DyNTS_AI_TestGeneration_Result>;
+}
 //# sourceMappingURL=ai-user-key.service-base.d.ts.map

package/build/_modules/ai/_services/ai-user-key.service-base.js

@@ -1,15 +1,15 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.DyNTS_AI_UserKey_ServiceBase = void 0;
-const singleton_service_1 = require("../../../_services/base/singleton.service");
-/**
- * Absztrakt bazis osztaly a user AI provider kulcs kezeleshez
- *
- * A titkositas/visszafejtes NEM itt tortenik -- azt az fdp-auth-service Auth_ControlService-e vegzi.
- * Ezek a service-ek a mar visszafejtett config-ot es API kulcsot kapjak,
- * es abbol allitjak ossze a provider-specifikus konfigot.
- */
-class DyNTS_AI_UserKey_ServiceBase extends singleton_service_1.DyNTS_SingletonService {
-}
-exports.DyNTS_AI_UserKey_ServiceBase = DyNTS_AI_UserKey_ServiceBase;
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.DyNTS_AI_UserKey_ServiceBase = void 0;
+const singleton_service_1 = require("../../../_services/base/singleton.service");
+/**
+ * Absztrakt bazis osztaly a user AI provider kulcs kezeleshez
+ *
+ * A titkositas/visszafejtes NEM itt tortenik -- azt az fdp-auth-service Auth_ControlService-e vegzi.
+ * Ezek a service-ek a mar visszafejtett config-ot es API kulcsot kapjak,
+ * es abbol allitjak ossze a provider-specifikus konfigot.
+ */
+class DyNTS_AI_UserKey_ServiceBase extends singleton_service_1.DyNTS_SingletonService {
+}
+exports.DyNTS_AI_UserKey_ServiceBase = DyNTS_AI_UserKey_ServiceBase;
 //# sourceMappingURL=ai-user-key.service-base.js.map

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

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