@futdevpro/nts-dynamo 1.15.104 → 1.15.107

package/build/_modules/ai/_collections/ai-model-config-validator.util.js

@@ -0,0 +1,95 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.DyNTS_AI_ModelConfig_Validator = void 0;
+const fsm_dynamo_1 = require("@futdevpro/fsm-dynamo");
+const ai_1 = require("@futdevpro/fsm-dynamo/ai");
+const ai_provider_error_util_1 = require("./ai-provider-error.util");
+/**
+ * FR-048 **validate-mode** — a per-model `settingsSchema` szerinti config-ellenorzes MUTACIO NELKUL.
+ *
+ * Testvere a `DyNTS_AI_LLM_ServiceBase.reconcileCallSettings`-nek: a reconciler a hivas elott CSENDBEN
+ * dropol/clampel (hogy a hivas atmenjen), ez viszont HIBAT AD — igy hasznalhato **production
+ * pre-validaciora** (UI-form submit elott, backend service-boundary-n) es tesztben egyarant.
+ * **Ugyanabbol az egy forrasbol** (`settingsSchema`) dolgozik mindketto — nincs parhuzamos szabaly-keszlet.
+ *
+ * A visszateres `null` = OK; kulonben provider-faithful `DyFM_Error` (a nativ hiba-body az
+ * `additionalContent.providerErrorBody`-ban).
+ *
+ * Ismeretlen modell / schema-mentes registry-bejegyzes → `null` (permisszi­v, best-effort) — NEM talalgatunk.
+ */
+class DyNTS_AI_ModelConfig_Validator {
+    /**
+     * Egy hivas-config ellenorzese a modell `settingsSchema`-ja ellen.
+     * @param set - provider + modell + a vizsgalando config + a provider modell-registry-je
+     */
+    static validate(set) {
+        if (!set.config) {
+            return null;
+        }
+        const modelInfo = ai_1.DyFM_AI_ModelRegistry_Util.findModelInfo(set.registry ?? [], set.model);
+        const schema = modelInfo?.settingsSchema;
+        if (!schema) {
+            return null;
+        }
+        // 1) NEM tamogatott parameter (a modell 400-zal elutasitana)
+        for (const param of schema.unsupported ?? []) {
+            if (set.config[param] !== undefined) {
+                return this.toError(ai_provider_error_util_1.DyNTS_AI_ProviderError_Util.buildUnsupportedParamError({
+                    provider: set.provider,
+                    model: set.model,
+                    param: param,
+                }));
+            }
+        }
+        // 2) Tamogatott parameter, de ervenytelen ertek (constraints: allowed / min / max)
+        return this.validateConstraints({
+            provider: set.provider,
+            model: set.model,
+            config: set.config,
+            schema: schema,
+        });
+    }
+    /** A `constraints` (allowed / min / max) ellenorzese. `null` = OK. */
+    static validateConstraints(set) {
+        const constraints = set.schema.constraints ?? {};
+        for (const param of Object.keys(constraints)) {
+            const constraint = constraints[param];
+            const value = set.config[param];
+            if (value === undefined) {
+                continue;
+            }
+            if (constraint.allowed?.length && !constraint.allowed.includes(value)) {
+                return this.toError(ai_provider_error_util_1.DyNTS_AI_ProviderError_Util.buildInvalidValueError({
+                    provider: set.provider,
+                    model: set.model,
+                    param: param,
+                    detail: `must be one of [${constraint.allowed.join(', ')}]`,
+                }));
+            }
+            if (typeof value === 'number') {
+                const belowMin = typeof constraint.min === 'number' && value < constraint.min;
+                const aboveMax = typeof constraint.max === 'number' && value > constraint.max;
+                if (belowMin || aboveMax) {
+                    return this.toError(ai_provider_error_util_1.DyNTS_AI_ProviderError_Util.buildInvalidValueError({
+                        provider: set.provider,
+                        model: set.model,
+                        param: param,
+                        detail: `out of range (${constraint.min ?? '-∞'}..${constraint.max ?? '∞'})`,
+                    }));
+                }
+            }
+        }
+        return null;
+    }
+    /** Provider-faithful hiba-leiroból a `DyFM_Error`. */
+    static toError(providerError) {
+        return new fsm_dynamo_1.DyFM_Error({
+            message: `[FR-048] provider-faithful error (HTTP ${providerError.httpStatus}): ${providerError.reason}`,
+            userMessage: 'The AI request contains a parameter this model does not accept.',
+            errorCode: 'DyNTS-AICFG-UNSUP',
+            additionalContent: { providerErrorBody: providerError.providerErrorBody },
+        });
+    }
+}
+exports.DyNTS_AI_ModelConfig_Validator = DyNTS_AI_ModelConfig_Validator;
+//# sourceMappingURL=ai-model-config-validator.util.js.map

package/build/_modules/ai/_collections/ai-model-config-validator.util.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ai-model-config-validator.util.js","sourceRoot":"","sources":["../../../../src/_modules/ai/_collections/ai-model-config-validator.util.ts"],"names":[],"mappings":"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"}

package/build/_modules/ai/_collections/ai-provider-error.util.d.ts

@@ -0,0 +1,35 @@
+import { DyNTS_AI_ProviderError } from '../_models/interfaces/dynts-ai-provider-error.interface';
+/**
+ * Provider-faithful hiba-alakok eloallitasa a FR-048 `settingsSchema` szabalysertesekhez — ugyanaz a
+ * hiba-alak, mint amit a valodi provider adna. A forras-igazsag a `settingsSchema` (SSoT); itt CSAK a
+ * hiba formazasa tortenik, szabaly-duplikatum nincs.
+ *
+ * **Pontossag (D4):** a hiba **strukturaja** (mezok + `code`/`type`) a dokumentalt provider-alak szerint
+ * keszult; a `message` SZOVEGE a valodi capture-ig kozelites. A gepileg fogyasztott resz (`reason`, `code`,
+ * `param`, `httpStatus`) a stabil — a byte-hu message a fixture-capture passzal pontosithato.
+ */
+export declare class DyNTS_AI_ProviderError_Util {
+    /** Az Anthropic provider-azonositoja (a hiba-alak valasztasahoz) — az enumbol, nem beegetett stringkent. */
+    private static readonly anthropicProviderId;
+    /**
+     * Nem tamogatott parameter → provider-hu HTTP 400 hiba-leiro.
+     * @param set - provider-azonosito + modell-azonosito + a kifogasolt parameter neve
+     */
+    static buildUnsupportedParamError(set: {
+        provider: string;
+        model: string;
+        param: string;
+    }): DyNTS_AI_ProviderError;
+    /**
+     * Tamogatott parameter, de ERVENYTELEN ertek (tartomanyon kivul, vagy nem az engedett keszletbol) →
+     * provider-hu HTTP 400. Ez a `settingsSchema.constraints` (min/max/allowed) megsertese.
+     * @param set - provider + modell + parameter-nev + a rovid indoklas (pl. 'out of range 0..2')
+     */
+    static buildInvalidValueError(set: {
+        provider: string;
+        model: string;
+        param: string;
+        detail: string;
+    }): DyNTS_AI_ProviderError;
+}
+//# sourceMappingURL=ai-provider-error.util.d.ts.map

package/build/_modules/ai/_collections/ai-provider-error.util.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ai-provider-error.util.d.ts","sourceRoot":"","sources":["../../../../src/_modules/ai/_collections/ai-provider-error.util.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,sBAAsB,EAAE,MAAM,yDAAyD,CAAC;AAEjG;;;;;;;;GAQG;AACH,qBAAa,2BAA2B;IAEtC,4GAA4G;IAC5G,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,mBAAmB,CAAsC;IAEjF;;;OAGG;IACH,MAAM,CAAC,0BAA0B,CAC/B,GAAG,EAAE;QACH,QAAQ,EAAE,MAAM,CAAC;QACjB,KAAK,EAAE,MAAM,CAAC;QACd,KAAK,EAAE,MAAM,CAAC;KACf,GACA,sBAAsB;IA6BzB;;;;OAIG;IACH,MAAM,CAAC,sBAAsB,CAC3B,GAAG,EAAE;QACH,QAAQ,EAAE,MAAM,CAAC;QACjB,KAAK,EAAE,MAAM,CAAC;QACd,KAAK,EAAE,MAAM,CAAC;QACd,MAAM,EAAE,MAAM,CAAC;KAChB,GACA,sBAAsB;CA4B1B"}

package/build/_modules/ai/_collections/ai-provider-error.util.js

@@ -0,0 +1,82 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.DyNTS_AI_ProviderError_Util = void 0;
+const ai_1 = require("@futdevpro/fsm-dynamo/ai");
+/**
+ * Provider-faithful hiba-alakok eloallitasa a FR-048 `settingsSchema` szabalysertesekhez — ugyanaz a
+ * hiba-alak, mint amit a valodi provider adna. A forras-igazsag a `settingsSchema` (SSoT); itt CSAK a
+ * hiba formazasa tortenik, szabaly-duplikatum nincs.
+ *
+ * **Pontossag (D4):** a hiba **strukturaja** (mezok + `code`/`type`) a dokumentalt provider-alak szerint
+ * keszult; a `message` SZOVEGE a valodi capture-ig kozelites. A gepileg fogyasztott resz (`reason`, `code`,
+ * `param`, `httpStatus`) a stabil — a byte-hu message a fixture-capture passzal pontosithato.
+ */
+class DyNTS_AI_ProviderError_Util {
+    /** Az Anthropic provider-azonositoja (a hiba-alak valasztasahoz) — az enumbol, nem beegetett stringkent. */
+    static anthropicProviderId = ai_1.DyFM_AI_Provider.Anthropic;
+    /**
+     * Nem tamogatott parameter → provider-hu HTTP 400 hiba-leiro.
+     * @param set - provider-azonosito + modell-azonosito + a kifogasolt parameter neve
+     */
+    static buildUnsupportedParamError(set) {
+        if (set.provider === this.anthropicProviderId) {
+            return {
+                httpStatus: 400,
+                providerErrorBody: {
+                    type: 'error',
+                    error: {
+                        type: 'invalid_request_error',
+                        message: `${set.param}: Extra inputs are not permitted for model '${set.model}'.`,
+                    },
+                },
+                reason: `invalid_request_error:${set.param}`,
+            };
+        }
+        return {
+            httpStatus: 400,
+            providerErrorBody: {
+                error: {
+                    message: `Unsupported parameter: '${set.param}' is not supported with model '${set.model}'.`,
+                    type: 'invalid_request_error',
+                    param: set.param,
+                    code: 'unsupported_parameter',
+                },
+            },
+            reason: `unsupported_parameter:${set.param}`,
+        };
+    }
+    /**
+     * Tamogatott parameter, de ERVENYTELEN ertek (tartomanyon kivul, vagy nem az engedett keszletbol) →
+     * provider-hu HTTP 400. Ez a `settingsSchema.constraints` (min/max/allowed) megsertese.
+     * @param set - provider + modell + parameter-nev + a rovid indoklas (pl. 'out of range 0..2')
+     */
+    static buildInvalidValueError(set) {
+        if (set.provider === this.anthropicProviderId) {
+            return {
+                httpStatus: 400,
+                providerErrorBody: {
+                    type: 'error',
+                    error: {
+                        type: 'invalid_request_error',
+                        message: `${set.param}: ${set.detail} (model '${set.model}').`,
+                    },
+                },
+                reason: `invalid_request_error:${set.param}`,
+            };
+        }
+        return {
+            httpStatus: 400,
+            providerErrorBody: {
+                error: {
+                    message: `Invalid value for '${set.param}': ${set.detail} (model '${set.model}').`,
+                    type: 'invalid_request_error',
+                    param: set.param,
+                    code: 'invalid_value',
+                },
+            },
+            reason: `invalid_value:${set.param}`,
+        };
+    }
+}
+exports.DyNTS_AI_ProviderError_Util = DyNTS_AI_ProviderError_Util;
+//# sourceMappingURL=ai-provider-error.util.js.map

package/build/_modules/ai/_collections/ai-provider-error.util.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ai-provider-error.util.js","sourceRoot":"","sources":["../../../../src/_modules/ai/_collections/ai-provider-error.util.ts"],"names":[],"mappings":";;;AAAA,iDAA4D;AAI5D;;;;;;;;GAQG;AACH,MAAa,2BAA2B;IAEtC,4GAA4G;IACpG,MAAM,CAAU,mBAAmB,GAAW,qBAAgB,CAAC,SAAS,CAAC;IAEjF;;;OAGG;IACH,MAAM,CAAC,0BAA0B,CAC/B,GAIC;QAED,IAAI,GAAG,CAAC,QAAQ,KAAK,IAAI,CAAC,mBAAmB,EAAE,CAAC;YAC9C,OAAO;gBACL,UAAU,EAAE,GAAG;gBACf,iBAAiB,EAAE;oBACjB,IAAI,EAAE,OAAO;oBACb,KAAK,EAAE;wBACL,IAAI,EAAE,uBAAuB;wBAC7B,OAAO,EAAE,GAAG,GAAG,CAAC,KAAK,+CAA+C,GAAG,CAAC,KAAK,IAAI;qBAClF;iBACF;gBACD,MAAM,EAAE,yBAAyB,GAAG,CAAC,KAAK,EAAE;aAC7C,CAAC;QACJ,CAAC;QAED,OAAO;YACL,UAAU,EAAE,GAAG;YACf,iBAAiB,EAAE;gBACjB,KAAK,EAAE;oBACL,OAAO,EAAE,2BAA2B,GAAG,CAAC,KAAK,kCAAkC,GAAG,CAAC,KAAK,IAAI;oBAC5F,IAAI,EAAE,uBAAuB;oBAC7B,KAAK,EAAE,GAAG,CAAC,KAAK;oBAChB,IAAI,EAAE,uBAAuB;iBAC9B;aACF;YACD,MAAM,EAAE,yBAAyB,GAAG,CAAC,KAAK,EAAE;SAC7C,CAAC;IACJ,CAAC;IAED;;;;OAIG;IACH,MAAM,CAAC,sBAAsB,CAC3B,GAKC;QAED,IAAI,GAAG,CAAC,QAAQ,KAAK,IAAI,CAAC,mBAAmB,EAAE,CAAC;YAC9C,OAAO;gBACL,UAAU,EAAE,GAAG;gBACf,iBAAiB,EAAE;oBACjB,IAAI,EAAE,OAAO;oBACb,KAAK,EAAE;wBACL,IAAI,EAAE,uBAAuB;wBAC7B,OAAO,EAAE,GAAG,GAAG,CAAC,KAAK,KAAK,GAAG,CAAC,MAAM,YAAY,GAAG,CAAC,KAAK,KAAK;qBAC/D;iBACF;gBACD,MAAM,EAAE,yBAAyB,GAAG,CAAC,KAAK,EAAE;aAC7C,CAAC;QACJ,CAAC;QAED,OAAO;YACL,UAAU,EAAE,GAAG;YACf,iBAAiB,EAAE;gBACjB,KAAK,EAAE;oBACL,OAAO,EAAE,sBAAsB,GAAG,CAAC,KAAK,MAAM,GAAG,CAAC,MAAM,YAAY,GAAG,CAAC,KAAK,KAAK;oBAClF,IAAI,EAAE,uBAAuB;oBAC7B,KAAK,EAAE,GAAG,CAAC,KAAK;oBAChB,IAAI,EAAE,eAAe;iBACtB;aACF;YACD,MAAM,EAAE,iBAAiB,GAAG,CAAC,KAAK,EAAE;SACrC,CAAC;IACJ,CAAC;;AAnFH,kEAoFC"}

package/build/_modules/ai/_models/interfaces/dynts-ai-provider-error.interface.d.ts

@@ -0,0 +1,17 @@
+/**
+ * Provider-faithful hiba-leiro — azt irja le, MILYEN hibat adna a valodi provider egy szabalytalan
+ * hivasra (FR-048). A `providerErrorBody` a provider NATIV hiba-JSON-ja (OpenAI:
+ * `{error:{message,type,param,code}}`, Anthropic: `{type:'error',error:{type,message}}`).
+ *
+ * Egy helyen definialva, hogy a Layer A validator (`DyNTS_AI_ModelConfig_Validator`) es a Layer B
+ * mock-fixture-ok UGYANAZT az alakot hasznaljak — nincs parhuzamos hiba-shape (SSoT).
+ */
+export interface DyNTS_AI_ProviderError {
+    /** A reprodukalando HTTP-statusz (pl. 400). */
+    httpStatus: number;
+    /** A provider nativ hiba-body-ja. */
+    providerErrorBody: unknown;
+    /** Rovid, gepi ok-jeloles (pl. 'unsupported_parameter:temperature'). */
+    reason: string;
+}
+//# sourceMappingURL=dynts-ai-provider-error.interface.d.ts.map

package/build/_modules/ai/_models/interfaces/dynts-ai-provider-error.interface.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"dynts-ai-provider-error.interface.d.ts","sourceRoot":"","sources":["../../../../../src/_modules/ai/_models/interfaces/dynts-ai-provider-error.interface.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AACH,MAAM,WAAW,sBAAsB;IACrC,+CAA+C;IAC/C,UAAU,EAAE,MAAM,CAAC;IACnB,qCAAqC;IACrC,iBAAiB,EAAE,OAAO,CAAC;IAC3B,wEAAwE;IACxE,MAAM,EAAE,MAAM,CAAC;CAChB"}

package/build/_modules/ai/_models/interfaces/dynts-ai-provider-error.interface.js

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=dynts-ai-provider-error.interface.js.map

package/build/_modules/ai/_models/interfaces/dynts-ai-provider-error.interface.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"dynts-ai-provider-error.interface.js","sourceRoot":"","sources":["../../../../../src/_modules/ai/_models/interfaces/dynts-ai-provider-error.interface.ts"],"names":[],"mappings":""}

package/build/_modules/ai/_modules/ai-mock/_collections/aim-default-collection.util.d.ts

@@ -0,0 +1,23 @@
+import { DyFM_AI_Provider } from '@futdevpro/fsm-dynamo/ai';
+import { DyNTS_AIMock_Modality } from '../_enums/aim-modality.enum';
+import { DyNTS_AIMock_Fixture } from '../_models/interfaces/aim-fixture.interface';
+import { DyNTS_AIMock_ServiceCollection } from '../_models/interfaces/aim-service-collection.interface';
+/**
+ * **Default-bundle factory** (MP-7 SP-7.1) — egy hivassal osszeallit egy hasznalatra kesz AI-mock keszletet:
+ * fixture-tar + mock-provider + a config-validaciohoz bekototott modell-registry.
+ *
+ * A `fdp-templates` `getApiDefaultSettings`-mintajat koveti: a consumer teszt-modul egyetlen sorral kap egy
+ * mukodo mockot, es DI-vel a valodi provider helyere teheti.
+ *
+ * @param set - opcionalis szukites: mely providerek registry-je legyen bekotve, mely modalitasok
+ *   fixture-oi keruljenek be, es a kezdo fixture-keszlet.
+ */
+export declare function getDefaultAiMockServiceCollection(set?: {
+    /** Mely providerek registry-je legyen bekotve a config-validaciohoz (default: mind a harom schema-s). */
+    providers?: DyFM_AI_Provider[];
+    /** Ha meg van adva, CSAK az itt felsorolt modalitasu fixture-ok kerulnek a tarba. */
+    modalities?: DyNTS_AIMock_Modality[];
+    /** A kezdo (beegetett) fixture-keszlet. */
+    fixtures?: DyNTS_AIMock_Fixture[];
+}): DyNTS_AIMock_ServiceCollection;
+//# sourceMappingURL=aim-default-collection.util.d.ts.map

package/build/_modules/ai/_modules/ai-mock/_collections/aim-default-collection.util.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"aim-default-collection.util.d.ts","sourceRoot":"","sources":["../../../../../../src/_modules/ai/_modules/ai-mock/_collections/aim-default-collection.util.ts"],"names":[],"mappings":"AAAA,OAAO,EAAqB,gBAAgB,EAAE,MAAM,0BAA0B,CAAC;AAK/E,OAAO,EAAE,qBAAqB,EAAE,MAAM,6BAA6B,CAAC;AACpE,OAAO,EAAE,oBAAoB,EAAE,MAAM,6CAA6C,CAAC;AACnF,OAAO,EAAE,8BAA8B,EAAE,MAAM,wDAAwD,CAAC;AAwBxG;;;;;;;;;GASG;AACH,wBAAgB,iCAAiC,CAC/C,GAAG,CAAC,EAAE;IACJ,yGAAyG;IACzG,SAAS,CAAC,EAAE,gBAAgB,EAAE,CAAC;IAC/B,qFAAqF;IACrF,UAAU,CAAC,EAAE,qBAAqB,EAAE,CAAC;IACrC,2CAA2C;IAC3C,QAAQ,CAAC,EAAE,oBAAoB,EAAE,CAAC;CACnC,GACA,8BAA8B,CAoBhC"}

package/build/_modules/ai/_modules/ai-mock/_collections/aim-default-collection.util.js

@@ -0,0 +1,52 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getDefaultAiMockServiceCollection = getDefaultAiMockServiceCollection;
+const ai_1 = require("@futdevpro/fsm-dynamo/ai");
+const open_ai_1 = require("@futdevpro/fsm-dynamo/ai/open-ai");
+const anthropic_1 = require("@futdevpro/fsm-dynamo/ai/anthropic");
+const google_1 = require("@futdevpro/fsm-dynamo/ai/google");
+const aim_fixture_store_service_1 = require("../_services/aim-fixture-store.service");
+const aim_mock_service_1 = require("../_services/aim-mock.service");
+/**
+ * Provider → modell-registry hozzarendeles.
+ *
+ * CSAK azok a providerek szerepelnek, amelyeknek van FR-048 `settingsSchema`-juk — a `local-ai` es az
+ * `fdp-ai` szandekosan schema-mentes (runtime/gateway-fuggo), igy a registry-be emelesuk a validaciohoz
+ * semmit nem adna hozza. L. a fsm registry-fejleceket + `FR-048-LAYER-A.md`.
+ */
+const REGISTRY_BY_PROVIDER = {
+    [ai_1.DyFM_AI_Provider.OpenAI]: open_ai_1.DyFM_OAI_Models,
+    [ai_1.DyFM_AI_Provider.Anthropic]: anthropic_1.DyFM_AAI_Models,
+    [ai_1.DyFM_AI_Provider.Google]: google_1.DyFM_GAI_Models,
+};
+/** Provider-default: minden schema-val rendelkezo provider. */
+const DEFAULT_PROVIDERS = [
+    ai_1.DyFM_AI_Provider.OpenAI,
+    ai_1.DyFM_AI_Provider.Anthropic,
+    ai_1.DyFM_AI_Provider.Google,
+];
+/**
+ * **Default-bundle factory** (MP-7 SP-7.1) — egy hivassal osszeallit egy hasznalatra kesz AI-mock keszletet:
+ * fixture-tar + mock-provider + a config-validaciohoz bekototott modell-registry.
+ *
+ * A `fdp-templates` `getApiDefaultSettings`-mintajat koveti: a consumer teszt-modul egyetlen sorral kap egy
+ * mukodo mockot, es DI-vel a valodi provider helyere teheti.
+ *
+ * @param set - opcionalis szukites: mely providerek registry-je legyen bekotve, mely modalitasok
+ *   fixture-oi keruljenek be, es a kezdo fixture-keszlet.
+ */
+function getDefaultAiMockServiceCollection(set) {
+    const providers = set?.providers?.length ? set.providers : DEFAULT_PROVIDERS;
+    const registry = providers.reduce((all, provider) => all.concat(REGISTRY_BY_PROVIDER[provider] ?? []), []);
+    const allFixtures = set?.fixtures ?? [];
+    const fixtures = set?.modalities?.length ?
+        allFixtures.filter((fixture) => set.modalities.includes(fixture.modality)) :
+        allFixtures;
+    const store = new aim_fixture_store_service_1.DyNTS_AIMock_FixtureStore_Service(fixtures);
+    return {
+        store: store,
+        service: new aim_mock_service_1.DyNTS_AIMock_Service(store, registry),
+        registry: registry,
+    };
+}
+//# sourceMappingURL=aim-default-collection.util.js.map

package/build/_modules/ai/_modules/ai-mock/_collections/aim-default-collection.util.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"aim-default-collection.util.js","sourceRoot":"","sources":["../../../../../../src/_modules/ai/_modules/ai-mock/_collections/aim-default-collection.util.ts"],"names":[],"mappings":";;AAyCA,8EA6BC;AAtED,iDAA+E;AAC/E,8DAAmE;AACnE,kEAAqE;AACrE,4DAAkE;AAKlE,sFAA2F;AAC3F,oEAAqE;AAErE;;;;;;GAMG;AACH,MAAM,oBAAoB,GAAwC;IAChE,CAAC,qBAAgB,CAAC,MAAM,CAAC,EAAE,yBAAe;IAC1C,CAAC,qBAAgB,CAAC,SAAS,CAAC,EAAE,2BAAe;IAC7C,CAAC,qBAAgB,CAAC,MAAM,CAAC,EAAE,wBAAe;CAC3C,CAAC;AAEF,+DAA+D;AAC/D,MAAM,iBAAiB,GAAuB;IAC5C,qBAAgB,CAAC,MAAM;IACvB,qBAAgB,CAAC,SAAS;IAC1B,qBAAgB,CAAC,MAAM;CACxB,CAAC;AAEF;;;;;;;;;GASG;AACH,SAAgB,iCAAiC,CAC/C,GAOC;IAED,MAAM,SAAS,GAAuB,GAAG,EAAE,SAAS,EAAE,MAAM,CAAC,CAAC,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC,CAAC,iBAAiB,CAAC;IAEjG,MAAM,QAAQ,GAAwB,SAAS,CAAC,MAAM,CACpD,CAAC,GAAwB,EAAE,QAA0B,EAAE,EAAE,CAAC,GAAG,CAAC,MAAM,CAAC,oBAAoB,CAAC,QAAQ,CAAC,IAAI,EAAE,CAAC,EAC1G,EAAE,CACH,CAAC;IAEF,MAAM,WAAW,GAA2B,GAAG,EAAE,QAAQ,IAAI,EAAE,CAAC;IAChE,MAAM,QAAQ,GAA2B,GAAG,EAAE,UAAU,EAAE,MAAM,CAAC,CAAC;QAChE,WAAW,CAAC,MAAM,CAAC,CAAC,OAA6B,EAAE,EAAE,CAAC,GAAG,CAAC,UAAU,CAAC,QAAQ,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC;QAClG,WAAW,CAAC;IAEd,MAAM,KAAK,GAAsC,IAAI,6DAAiC,CAAC,QAAQ,CAAC,CAAC;IAEjG,OAAO;QACL,KAAK,EAAE,KAAK;QACZ,OAAO,EAAE,IAAI,uCAAoB,CAAC,KAAK,EAAE,QAAQ,CAAC;QAClD,QAAQ,EAAE,QAAQ;KACnB,CAAC;AACJ,CAAC"}

package/build/_modules/ai/_modules/ai-mock/_collections/aim-fixture-match.util.d.ts

@@ -0,0 +1,34 @@
+import { DyNTS_AIMock_Request } from '../_models/interfaces/aim-request.interface';
+/**
+ * A fixture-match kulcs DETERMINISZTIKUS képzése. Cél: azonos „jelentésű" request → azonos kulcs,
+ * függetlenül a config-kulcsok sorrendjétől és az input whitespace-variánsaitól (különben false
+ * reject-on-unknown, l. HYPERPLAN D3 + MP-3 SP-3.1). NEM végez generálást — tiszta, hálózat-mentes.
+ */
+export declare class DyNTS_AIMock_FixtureMatch_Util {
+    /**
+     * A teljes match-kulcs: `provider|model|modality|<config-hash>|<input-hash>`.
+     * @param request - a mock-hívás bemenete
+     */
+    static buildMatchKey(request: DyNTS_AIMock_Request): string;
+    /**
+     * Csak az input-hash (a `DyNTS_AIMock_Fixture.inputHash`-hez): a kanonizált input SHA-256-ja.
+     * @param input - a modalitás-függő bemenet
+     */
+    static buildInputHash(input: unknown): string;
+    /**
+     * Kulcs-rendezett, stabil szöveg egy config-objektumból (a config-kulcsok sorrend-függetlenségéhez).
+     * Megjegyzés: a nested-objektum mély-kanonizációja jövőbeli finomítás (a shallow key-sort a config-flat
+     * paramétereket — temperature/dimensions/size — fedi).
+     * @param config - a kanonizálandó config
+     */
+    private static canonicalizeConfig;
+    /**
+     * Input-kanonizáció: string → trim + belső whitespace-összevonás; egyéb (pl. embedding-szöveg-tömb) →
+     * stabil JSON (a sorrend jelentős, pl. batch-embedding).
+     * @param input - a bemenet
+     */
+    private static canonicalizeInput;
+    /** SHA-256 hex az adott szövegből. */
+    private static hash;
+}
+//# sourceMappingURL=aim-fixture-match.util.d.ts.map

package/build/_modules/ai/_modules/ai-mock/_collections/aim-fixture-match.util.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"aim-fixture-match.util.d.ts","sourceRoot":"","sources":["../../../../../../src/_modules/ai/_modules/ai-mock/_collections/aim-fixture-match.util.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,oBAAoB,EAAE,MAAM,6CAA6C,CAAC;AAEnF;;;;GAIG;AACH,qBAAa,8BAA8B;IACzC;;;OAGG;IACH,MAAM,CAAC,aAAa,CAAC,OAAO,EAAE,oBAAoB,GAAG,MAAM;IAO3D;;;OAGG;IACH,MAAM,CAAC,cAAc,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM;IAI7C;;;;;OAKG;IACH,OAAO,CAAC,MAAM,CAAC,kBAAkB;IAOjC;;;;OAIG;IACH,OAAO,CAAC,MAAM,CAAC,iBAAiB;IAQhC,sCAAsC;IACtC,OAAO,CAAC,MAAM,CAAC,IAAI;CAGpB"}

package/build/_modules/ai/_modules/ai-mock/_collections/aim-fixture-match.util.js

@@ -0,0 +1,56 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.DyNTS_AIMock_FixtureMatch_Util = void 0;
+const tslib_1 = require("tslib");
+const crypto = tslib_1.__importStar(require("crypto"));
+/**
+ * A fixture-match kulcs DETERMINISZTIKUS képzése. Cél: azonos „jelentésű" request → azonos kulcs,
+ * függetlenül a config-kulcsok sorrendjétől és az input whitespace-variánsaitól (különben false
+ * reject-on-unknown, l. HYPERPLAN D3 + MP-3 SP-3.1). NEM végez generálást — tiszta, hálózat-mentes.
+ */
+class DyNTS_AIMock_FixtureMatch_Util {
+    /**
+     * A teljes match-kulcs: `provider|model|modality|<config-hash>|<input-hash>`.
+     * @param request - a mock-hívás bemenete
+     */
+    static buildMatchKey(request) {
+        const configHash = this.hash(this.canonicalizeConfig(request.config ?? {}));
+        const inputHash = this.buildInputHash(request.input);
+        return `${request.provider}|${request.model}|${request.modality}|${configHash}|${inputHash}`;
+    }
+    /**
+     * Csak az input-hash (a `DyNTS_AIMock_Fixture.inputHash`-hez): a kanonizált input SHA-256-ja.
+     * @param input - a modalitás-függő bemenet
+     */
+    static buildInputHash(input) {
+        return this.hash(this.canonicalizeInput(input));
+    }
+    /**
+     * Kulcs-rendezett, stabil szöveg egy config-objektumból (a config-kulcsok sorrend-függetlenségéhez).
+     * Megjegyzés: a nested-objektum mély-kanonizációja jövőbeli finomítás (a shallow key-sort a config-flat
+     * paramétereket — temperature/dimensions/size — fedi).
+     * @param config - a kanonizálandó config
+     */
+    static canonicalizeConfig(config) {
+        const sortedKeys = Object.keys(config).sort();
+        const parts = sortedKeys.map((key) => `${key}:${JSON.stringify(config[key])}`);
+        return parts.join('|');
+    }
+    /**
+     * Input-kanonizáció: string → trim + belső whitespace-összevonás; egyéb (pl. embedding-szöveg-tömb) →
+     * stabil JSON (a sorrend jelentős, pl. batch-embedding).
+     * @param input - a bemenet
+     */
+    static canonicalizeInput(input) {
+        if (typeof input === 'string') {
+            return input.trim().replace(/\s+/g, ' ');
+        }
+        return JSON.stringify(input);
+    }
+    /** SHA-256 hex az adott szövegből. */
+    static hash(value) {
+        return crypto.createHash('sha256').update(value).digest('hex');
+    }
+}
+exports.DyNTS_AIMock_FixtureMatch_Util = DyNTS_AIMock_FixtureMatch_Util;
+//# sourceMappingURL=aim-fixture-match.util.js.map

package/build/_modules/ai/_modules/ai-mock/_collections/aim-fixture-match.util.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"aim-fixture-match.util.js","sourceRoot":"","sources":["../../../../../../src/_modules/ai/_modules/ai-mock/_collections/aim-fixture-match.util.ts"],"names":[],"mappings":";;;;AAAA,uDAAiC;AAIjC;;;;GAIG;AACH,MAAa,8BAA8B;IACzC;;;OAGG;IACH,MAAM,CAAC,aAAa,CAAC,OAA6B;QAChD,MAAM,UAAU,GAAW,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,kBAAkB,CAAC,OAAO,CAAC,MAAM,IAAI,EAAE,CAAC,CAAC,CAAC;QACpF,MAAM,SAAS,GAAW,IAAI,CAAC,cAAc,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC;QAE7D,OAAO,GAAG,OAAO,CAAC,QAAQ,IAAI,OAAO,CAAC,KAAK,IAAI,OAAO,CAAC,QAAQ,IAAI,UAAU,IAAI,SAAS,EAAE,CAAC;IAC/F,CAAC;IAED;;;OAGG;IACH,MAAM,CAAC,cAAc,CAAC,KAAc;QAClC,OAAO,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,iBAAiB,CAAC,KAAK,CAAC,CAAC,CAAC;IAClD,CAAC;IAED;;;;;OAKG;IACK,MAAM,CAAC,kBAAkB,CAAC,MAA+B;QAC/D,MAAM,UAAU,GAAa,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,IAAI,EAAE,CAAC;QACxD,MAAM,KAAK,GAAa,UAAU,CAAC,GAAG,CAAC,CAAC,GAAW,EAAE,EAAE,CAAC,GAAG,GAAG,IAAI,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,EAAE,CAAC,CAAC;QAEjG,OAAO,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;IACzB,CAAC;IAED;;;;OAIG;IACK,MAAM,CAAC,iBAAiB,CAAC,KAAc;QAC7C,IAAI,OAAO,KAAK,KAAK,QAAQ,EAAE,CAAC;YAC9B,OAAO,KAAK,CAAC,IAAI,EAAE,CAAC,OAAO,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;QAC3C,CAAC;QAED,OAAO,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC;IAC/B,CAAC;IAED,sCAAsC;IAC9B,MAAM,CAAC,IAAI,CAAC,KAAa;QAC/B,OAAO,MAAM,CAAC,UAAU,CAAC,QAAQ,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;IACjE,CAAC;CACF;AAlDD,wEAkDC"}

package/build/_modules/ai/_modules/ai-mock/_collections/aim-fixture-serializer.util.d.ts

@@ -0,0 +1,33 @@
+import { DyNTS_AIMock_Fixture } from '../_models/interfaces/aim-fixture.interface';
+/**
+ * Beegetett fixture-ok **determinisztikus** TS-konstans fajlla alakitasa (D6: git-tracked, NEM env-fuggo).
+ *
+ * A determinizmus itt nem kozmetika: a fixture-fajlok verziokezeltek, ezert ugyanaz a fixture-keszlet
+ * MINDIG ugyanazt a fajl-tartalmat kell adja — kulonben minden ujra-generalas zajos diff-et okoz, es a
+ * code-review hasznalhatatlanna valik. Ezert: a fixture-ok **match-kulcs szerint rendezve**, az objektum-
+ * kulcsok pedig **rekurzivan abc-sorrendben** kerulnek ki.
+ */
+export declare class DyNTS_AIMock_FixtureSerializer_Util {
+    /** Behuzas egy szintje. */
+    private static readonly indentUnit;
+    /**
+     * Fixture-tomb → teljes TS-konstans fajl tartalma (import + export const + JSDoc-fejlec).
+     * @param set - a konstans neve + a fixture-ok + opcionalis fejlec-megjegyzes
+     */
+    static toConstantFile(set: {
+        constName: string;
+        fixtures: DyNTS_AIMock_Fixture[];
+        headerNote?: string;
+    }): string;
+    /** Fixture-ok stabil rendezese (provider|model|modality|inputHash). */
+    private static sortFixtures;
+    /** A rendezesi kulcs egy fixture-hoz. */
+    private static sortKeyOf;
+    /**
+     * Rekurziv, kulcs-rendezett stringify (a `JSON.stringify` a beszurasi sorrendet tartana meg — az nem stabil).
+     * @param value - a szerializalando ertek
+     * @param indent - az aktualis behuzas
+     */
+    private static stringify;
+}
+//# sourceMappingURL=aim-fixture-serializer.util.d.ts.map

package/build/_modules/ai/_modules/ai-mock/_collections/aim-fixture-serializer.util.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"aim-fixture-serializer.util.d.ts","sourceRoot":"","sources":["../../../../../../src/_modules/ai/_modules/ai-mock/_collections/aim-fixture-serializer.util.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,oBAAoB,EAAE,MAAM,6CAA6C,CAAC;AAEnF;;;;;;;GAOG;AACH,qBAAa,mCAAmC;IAE9C,2BAA2B;IAC3B,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,UAAU,CAAgB;IAElD;;;OAGG;IACH,MAAM,CAAC,cAAc,CACnB,GAAG,EAAE;QACH,SAAS,EAAE,MAAM,CAAC;QAClB,QAAQ,EAAE,oBAAoB,EAAE,CAAC;QACjC,UAAU,CAAC,EAAE,MAAM,CAAC;KACrB,GACA,MAAM;IAwBT,uEAAuE;IACvE,OAAO,CAAC,MAAM,CAAC,YAAY;IAM3B,yCAAyC;IACzC,OAAO,CAAC,MAAM,CAAC,SAAS;IAIxB;;;;OAIG;IACH,OAAO,CAAC,MAAM,CAAC,SAAS;CAwCzB"}

package/build/_modules/ai/_modules/ai-mock/_collections/aim-fixture-serializer.util.js

@@ -0,0 +1,89 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.DyNTS_AIMock_FixtureSerializer_Util = void 0;
+/**
+ * Beegetett fixture-ok **determinisztikus** TS-konstans fajlla alakitasa (D6: git-tracked, NEM env-fuggo).
+ *
+ * A determinizmus itt nem kozmetika: a fixture-fajlok verziokezeltek, ezert ugyanaz a fixture-keszlet
+ * MINDIG ugyanazt a fajl-tartalmat kell adja — kulonben minden ujra-generalas zajos diff-et okoz, es a
+ * code-review hasznalhatatlanna valik. Ezert: a fixture-ok **match-kulcs szerint rendezve**, az objektum-
+ * kulcsok pedig **rekurzivan abc-sorrendben** kerulnek ki.
+ */
+class DyNTS_AIMock_FixtureSerializer_Util {
+    /** Behuzas egy szintje. */
+    static indentUnit = '  ';
+    /**
+     * Fixture-tomb → teljes TS-konstans fajl tartalma (import + export const + JSDoc-fejlec).
+     * @param set - a konstans neve + a fixture-ok + opcionalis fejlec-megjegyzes
+     */
+    static toConstantFile(set) {
+        const sorted = this.sortFixtures(set.fixtures);
+        const body = sorted
+            .map((fixture) => this.stringify(fixture, this.indentUnit))
+            .join(',\n');
+        const note = set.headerNote ?? 'Auto-generalt fixture-keszlet — kezzel NE szerkeszd.';
+        return [
+            `import { DyNTS_AIMock_Fixture } from '@futdevpro/nts-dynamo/ai/ai-mock';`,
+            '',
+            '/**',
+            ` * ${note}`,
+            ' *',
+            ' * Determinisztikus sorrend (match-kulcs szerint) + rendezett objektum-kulcsok, hogy az ujra-generalas',
+            ' * ne okozzon zajos diff-et. Forras: `DyNTS_AIMock_FixtureSerializer_Util`.',
+            ' */',
+            `export const ${set.constName}: DyNTS_AIMock_Fixture[] = [`,
+            body,
+            '];',
+            '',
+        ].join('\n');
+    }
+    /** Fixture-ok stabil rendezese (provider|model|modality|inputHash). */
+    static sortFixtures(fixtures) {
+        return [...fixtures].sort((a, b) => {
+            return this.sortKeyOf(a).localeCompare(this.sortKeyOf(b));
+        });
+    }
+    /** A rendezesi kulcs egy fixture-hoz. */
+    static sortKeyOf(fixture) {
+        return `${fixture.provider}|${fixture.model}|${fixture.modality}|${fixture.inputHash}`;
+    }
+    /**
+     * Rekurziv, kulcs-rendezett stringify (a `JSON.stringify` a beszurasi sorrendet tartana meg — az nem stabil).
+     * @param value - a szerializalando ertek
+     * @param indent - az aktualis behuzas
+     */
+    static stringify(value, indent) {
+        if (value === null || value === undefined) {
+            return `${indent}null`;
+        }
+        if (Array.isArray(value)) {
+            if (!value.length) {
+                return `${indent}[]`;
+            }
+            const items = value
+                .map((item) => this.stringify(item, indent + this.indentUnit))
+                .join(',\n');
+            return `${indent}[\n${items}\n${indent}]`;
+        }
+        if (typeof value === 'object') {
+            // `Object.entries` a generikus `object`-en is mukodik → nincs szukseg `as`-castra.
+            const source = new Map(Object.entries(value));
+            const keys = [...source.keys()]
+                .filter((key) => source.get(key) !== undefined)
+                .sort();
+            if (!keys.length) {
+                return `${indent}{}`;
+            }
+            const entries = keys
+                .map((key) => {
+                const rendered = this.stringify(source.get(key), indent + this.indentUnit).trimStart();
+                return `${indent}${this.indentUnit}${JSON.stringify(key)}: ${rendered}`;
+            })
+                .join(',\n');
+            return `${indent}{\n${entries}\n${indent}}`;
+        }
+        return `${indent}${JSON.stringify(value)}`;
+    }
+}
+exports.DyNTS_AIMock_FixtureSerializer_Util = DyNTS_AIMock_FixtureSerializer_Util;
+//# sourceMappingURL=aim-fixture-serializer.util.js.map

package/build/_modules/ai/_modules/ai-mock/_collections/aim-fixture-serializer.util.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"aim-fixture-serializer.util.js","sourceRoot":"","sources":["../../../../../../src/_modules/ai/_modules/ai-mock/_collections/aim-fixture-serializer.util.ts"],"names":[],"mappings":"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"}

package/build/_modules/ai/_modules/ai-mock/_enums/aim-modality.enum.d.ts

@@ -0,0 +1,16 @@
+/**
+ * Az AI-mock által kezelt modalitások. A mock MINDEN modalitásra ugyanazt a replay / reject-on-unknown
+ * viselkedést adja (l. `documentations/plans/ai-mocking-system/HYPERPLAN.md` D3). A `value` a beégetett
+ * fixture-ök + a match-kulcs modality-szegmense.
+ */
+export declare enum DyNTS_AIMock_Modality {
+    /** Szöveg-completion (chat / LLM). */
+    text = "text",
+    /** Embedding-vektor kimenet. */
+    embedding = "embedding",
+    /** Kép-generálás (base64 kimenet). */
+    image = "image",
+    /** Hang: transcription (audio→szöveg) vagy TTS (szöveg→base64-audio). */
+    audio = "audio"
+}
+//# sourceMappingURL=aim-modality.enum.d.ts.map

package/build/_modules/ai/_modules/ai-mock/_enums/aim-modality.enum.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"aim-modality.enum.d.ts","sourceRoot":"","sources":["../../../../../../src/_modules/ai/_modules/ai-mock/_enums/aim-modality.enum.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,oBAAY,qBAAqB;IAC/B,sCAAsC;IACtC,IAAI,SAAS;IACb,gCAAgC;IAChC,SAAS,cAAc;IACvB,sCAAsC;IACtC,KAAK,UAAU;IACf,yEAAyE;IACzE,KAAK,UAAU;CAChB"}

package/build/_modules/ai/_modules/ai-mock/_enums/aim-modality.enum.js

@@ -0,0 +1,20 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.DyNTS_AIMock_Modality = void 0;
+/**
+ * Az AI-mock által kezelt modalitások. A mock MINDEN modalitásra ugyanazt a replay / reject-on-unknown
+ * viselkedést adja (l. `documentations/plans/ai-mocking-system/HYPERPLAN.md` D3). A `value` a beégetett
+ * fixture-ök + a match-kulcs modality-szegmense.
+ */
+var DyNTS_AIMock_Modality;
+(function (DyNTS_AIMock_Modality) {
+    /** Szöveg-completion (chat / LLM). */
+    DyNTS_AIMock_Modality["text"] = "text";
+    /** Embedding-vektor kimenet. */
+    DyNTS_AIMock_Modality["embedding"] = "embedding";
+    /** Kép-generálás (base64 kimenet). */
+    DyNTS_AIMock_Modality["image"] = "image";
+    /** Hang: transcription (audio→szöveg) vagy TTS (szöveg→base64-audio). */
+    DyNTS_AIMock_Modality["audio"] = "audio";
+})(DyNTS_AIMock_Modality || (exports.DyNTS_AIMock_Modality = DyNTS_AIMock_Modality = {}));
+//# sourceMappingURL=aim-modality.enum.js.map

package/build/_modules/ai/_modules/ai-mock/_enums/aim-modality.enum.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"aim-modality.enum.js","sourceRoot":"","sources":["../../../../../../src/_modules/ai/_modules/ai-mock/_enums/aim-modality.enum.ts"],"names":[],"mappings":";;;AAAA;;;;GAIG;AACH,IAAY,qBASX;AATD,WAAY,qBAAqB;IAC/B,sCAAsC;IACtC,sCAAa,CAAA;IACb,gCAAgC;IAChC,gDAAuB,CAAA;IACvB,sCAAsC;IACtC,wCAAe,CAAA;IACf,yEAAyE;IACzE,wCAAe,CAAA;AACjB,CAAC,EATW,qBAAqB,qCAArB,qBAAqB,QAShC"}