@futdevpro/nts-dynamo 1.15.57 → 1.15.60

package/build/_modules/mcp/_models/interfaces/dynts-mcp.interface.js

@@ -0,0 +1,14 @@
+"use strict";
+/**
+ * MCP-réteg shared vokabulár (BFR-AM-003) — a domain-agnosztikus MCP-szerver-base + adaptor közös
+ * típusai. Egy fájlban a szorosan összetartozó tool-/transport-típusok (`*.interface.ts` az
+ * egy-export-per-file konvenció ismert kivétele a tightly-coupled shape-ekre).
+ *
+ * Boundary: a `DyNTS_McpToolDefinition` + a `DyNTS_Mcp_Adapter` egyetlen `registerTool` choke-pontot
+ * ad — a hivatalos `@modelcontextprotocol/sdk` KIZÁRÓLAG az adaptor mögött él, így egy jövőbeli
+ * transport-/SDK-csere NEM-breaking (csak az adaptor cserélődik, a `DyNTS_Mcp_Server_ServiceBase` + a
+ * consumer-tool-ok változatlanok). A consumer a SAJÁT tool-jait regisztrálja (a bedrock NEM definiál
+ * domain-tool-okat — csak a server-base + a transport + a registry).
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=dynts-mcp.interface.js.map

package/build/_modules/mcp/_models/interfaces/dynts-mcp.interface.js.map

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

package/build/_modules/mcp/_services/dynts-mcp-server.service-base.d.ts

@@ -0,0 +1,71 @@
+import { DyNTS_Mcp_CallResult, DyNTS_Mcp_ServerInfo, DyNTS_Mcp_StartOptions, DyNTS_Mcp_ToolDefinition } from '../_models/interfaces/dynts-mcp.interface';
+import { DyNTS_Mcp_Adapter } from './dynts-mcp.adapter';
+/**
+ * `DyNTS_Mcp_Server_ServiceBase` (BFR-AM-003) — a **domain-agnosztikus** MCP-szerver-base. Egy bedrock-réteg
+ * a hivatalos `@modelcontextprotocol/sdk` fölött: a server-base felel a tool-registry-ért, a
+ * `tools/list`/`tools/call` dispatch-ért (az adaptoron át) + a transport-indításért — a SDK KIZÁRÓLAG
+ * a `DyNTS_Mcp_Adapter` mögött él (egy jövőbeli transport-/SDK-csere NON-breaking).
+ *
+ * **Használat (consumer):** a consumer leszármazik (`extends DyNTS_Mcp_Server_ServiceBase`) + implementálja a
+ * `getServerInfo()` (név/verzió) és `getTools()` (a SAJÁT tool-jai) abstract metódusokat. A bedrock
+ * SEMMILYEN domain-tool-t NEM definiál — csak a server-base + a transport + a registry. (Pl. a FAM a
+ * `read`/`write`/`capabilities` tool-jait itt regisztrálja, a bedrock-on kívül.)
+ *
+ * ```ts
+ * class My_McpServer extends DyNTS_Mcp_Server_ServiceBase {
+ *   protected getServerInfo() { return { name: 'my-app', version: '1.0.0' }; }
+ *   protected getTools() { return [readTool, writeTool]; }
+ * }
+ * await new My_McpServer().start({ transport: 'stdio' });
+ * ```
+ *
+ * **stdio-konvenció:** a stdout a JSON-RPC csatorna — a boot-üzenet + minden log a stderr-re megy (a
+ * hívó App a `DyFM_Log`-ot stdio-módban stderr-re konfigurálja).
+ */
+export declare abstract class DyNTS_Mcp_Server_ServiceBase {
+    /** Az MCP-adaptor (a regisztrált tool-ok + a transport mögötti SDK-réteg). Lazy a `build()`-ben. */
+    private adapter;
+    /**
+     * A szerver identitása (név/verzió) — a consumer adja. A SDK `serverInfo`-jaként hirdetődik.
+     */
+    protected abstract getServerInfo(): DyNTS_Mcp_ServerInfo;
+    /**
+     * A consumer SAJÁT tool-definíciói (az advertised halmaz). A `build()` ezeket regisztrálja az
+     * adaptoron át — a `tools/list` PONTOSAN ezeket hirdeti, a `tools/call` ezekre dispatch-el.
+     */
+    protected abstract getTools(): DyNTS_Mcp_ToolDefinition[];
+    /**
+     * A szerver felépítése (a consumer-tool-ok regisztrálása az adaptoron). NEM indítja a transportot
+     * — a `start()` teszi. Külön lépés a contract-teszt kedvéért (a szerver felépül + a tool-okat
+     * hirdeti, transport nélkül). Idempotens: ismételt hívás ugyanazt az adaptort adja vissza.
+     */
+    build(): DyNTS_Mcp_Adapter;
+    /**
+     * Az MCP-szerver indítása a választott transporton (default `stdio`). Felépíti a szervert (ha még
+     * nem), majd a transportot csatlakoztatja — innentől a `tools/list` a consumer-tool-okat hirdeti,
+     * a `tools/call` route-ol. A boot-üzenet a stderr-en.
+     */
+    start(options?: DyNTS_Mcp_StartOptions): Promise<void>;
+    /**
+     * A felépített tool-nevek (a contract/diszjunkció-teszthez). Build előtt a deklarált `getTools()`
+     * neveit adja (transport nélkül is determinisztikus).
+     */
+    getAdvertisedToolNames(): string[];
+    /**
+     * Egy tool KÖZVETLEN hívása (a transport megkerülésével) — a contract-teszthez / REST-paritáshoz.
+     * Felépíti a szervert (ha még nem), majd az adaptor egységes dispatch-ét futtatja (ismeretlen
+     * tool → strukturált hiba; handler-hiba → `isError:true`).
+     */
+    callTool(set: {
+        name: string;
+        arguments?: unknown;
+    }): Promise<DyNTS_Mcp_CallResult>;
+    /** A szerver leállítása (graceful close — teszt-/shutdown-úthoz). */
+    close(): Promise<void>;
+    /**
+     * A transport-indítás dispatch-e. Külön metódus, hogy egy jövőbeli transport (http/sse) NON-breaking
+     * módon bővíthető legyen (a `start()` + a registry változatlan). MVP: csak `stdio`.
+     */
+    private startTransport;
+}
+//# sourceMappingURL=dynts-mcp-server.service-base.d.ts.map

package/build/_modules/mcp/_services/dynts-mcp-server.service-base.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"dynts-mcp-server.service-base.d.ts","sourceRoot":"","sources":["../../../../src/_modules/mcp/_services/dynts-mcp-server.service-base.ts"],"names":[],"mappings":"AAEA,OAAO,EACL,oBAAoB,EACpB,oBAAoB,EACpB,sBAAsB,EACtB,wBAAwB,EACzB,MAAM,2CAA2C,CAAC;AACnD,OAAO,EAAE,iBAAiB,EAAE,MAAM,qBAAqB,CAAC;AAExD;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,8BAAsB,4BAA4B;IAEhD,oGAAoG;IACpG,OAAO,CAAC,OAAO,CAAkC;IAE/C;;OAEG;IACH,SAAS,CAAC,QAAQ,CAAC,aAAa,IAAI,oBAAoB;IAExD;;;OAGG;IACH,SAAS,CAAC,QAAQ,CAAC,QAAQ,IAAI,wBAAwB,EAAE;IAEzD;;;;OAIG;IACI,KAAK,IAAI,iBAAiB;IAcjC;;;;OAIG;IACU,KAAK,CAAC,OAAO,CAAC,EAAE,sBAAsB,GAAG,OAAO,CAAC,IAAI,CAAC;IAUnE;;;OAGG;IACI,sBAAsB,IAAI,MAAM,EAAE;IAMzC;;;;OAIG;IACU,QAAQ,CAAC,GAAG,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,SAAS,CAAC,EAAE,OAAO,CAAA;KAAE,GAAG,OAAO,CAAC,oBAAoB,CAAC;IAIhG,qEAAqE;IACxD,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAMnC;;;OAGG;YACW,cAAc;CAY/B"}

package/build/_modules/mcp/_services/dynts-mcp-server.service-base.js

@@ -0,0 +1,99 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.DyNTS_Mcp_Server_ServiceBase = void 0;
+const fsm_dynamo_1 = require("@futdevpro/fsm-dynamo");
+const dynts_mcp_adapter_1 = require("./dynts-mcp.adapter");
+/**
+ * `DyNTS_Mcp_Server_ServiceBase` (BFR-AM-003) — a **domain-agnosztikus** MCP-szerver-base. Egy bedrock-réteg
+ * a hivatalos `@modelcontextprotocol/sdk` fölött: a server-base felel a tool-registry-ért, a
+ * `tools/list`/`tools/call` dispatch-ért (az adaptoron át) + a transport-indításért — a SDK KIZÁRÓLAG
+ * a `DyNTS_Mcp_Adapter` mögött él (egy jövőbeli transport-/SDK-csere NON-breaking).
+ *
+ * **Használat (consumer):** a consumer leszármazik (`extends DyNTS_Mcp_Server_ServiceBase`) + implementálja a
+ * `getServerInfo()` (név/verzió) és `getTools()` (a SAJÁT tool-jai) abstract metódusokat. A bedrock
+ * SEMMILYEN domain-tool-t NEM definiál — csak a server-base + a transport + a registry. (Pl. a FAM a
+ * `read`/`write`/`capabilities` tool-jait itt regisztrálja, a bedrock-on kívül.)
+ *
+ * ```ts
+ * class My_McpServer extends DyNTS_Mcp_Server_ServiceBase {
+ *   protected getServerInfo() { return { name: 'my-app', version: '1.0.0' }; }
+ *   protected getTools() { return [readTool, writeTool]; }
+ * }
+ * await new My_McpServer().start({ transport: 'stdio' });
+ * ```
+ *
+ * **stdio-konvenció:** a stdout a JSON-RPC csatorna — a boot-üzenet + minden log a stderr-re megy (a
+ * hívó App a `DyFM_Log`-ot stdio-módban stderr-re konfigurálja).
+ */
+class DyNTS_Mcp_Server_ServiceBase {
+    /** Az MCP-adaptor (a regisztrált tool-ok + a transport mögötti SDK-réteg). Lazy a `build()`-ben. */
+    adapter = null;
+    /**
+     * A szerver felépítése (a consumer-tool-ok regisztrálása az adaptoron). NEM indítja a transportot
+     * — a `start()` teszi. Külön lépés a contract-teszt kedvéért (a szerver felépül + a tool-okat
+     * hirdeti, transport nélkül). Idempotens: ismételt hívás ugyanazt az adaptort adja vissza.
+     */
+    build() {
+        if (this.adapter) {
+            return this.adapter;
+        }
+        const adapter = new dynts_mcp_adapter_1.DyNTS_Mcp_Adapter(this.getServerInfo());
+        for (const tool of this.getTools()) {
+            adapter.registerTool(tool);
+        }
+        this.adapter = adapter;
+        return adapter;
+    }
+    /**
+     * Az MCP-szerver indítása a választott transporton (default `stdio`). Felépíti a szervert (ha még
+     * nem), majd a transportot csatlakoztatja — innentől a `tools/list` a consumer-tool-okat hirdeti,
+     * a `tools/call` route-ol. A boot-üzenet a stderr-en.
+     */
+    async start(options) {
+        const transport = options?.transport ?? 'stdio';
+        const adapter = this.build();
+        const info = this.getServerInfo();
+        fsm_dynamo_1.DyFM_Log.testInfo(`[DyNTS MCP] ${transport} server starting (${info.name} v${info.version}); `
+            + `advertised tools: ${adapter.getAdvertisedToolNames().join(', ')}`);
+        await this.startTransport(adapter, transport);
+    }
+    /**
+     * A felépített tool-nevek (a contract/diszjunkció-teszthez). Build előtt a deklarált `getTools()`
+     * neveit adja (transport nélkül is determinisztikus).
+     */
+    getAdvertisedToolNames() {
+        return this.adapter
+            ? this.adapter.getAdvertisedToolNames()
+            : this.getTools().map((tool) => tool.name);
+    }
+    /**
+     * Egy tool KÖZVETLEN hívása (a transport megkerülésével) — a contract-teszthez / REST-paritáshoz.
+     * Felépíti a szervert (ha még nem), majd az adaptor egységes dispatch-ét futtatja (ismeretlen
+     * tool → strukturált hiba; handler-hiba → `isError:true`).
+     */
+    async callTool(set) {
+        return this.build().dispatchToolCall(set);
+    }
+    /** A szerver leállítása (graceful close — teszt-/shutdown-úthoz). */
+    async close() {
+        if (this.adapter) {
+            await this.adapter.close();
+        }
+    }
+    /**
+     * A transport-indítás dispatch-e. Külön metódus, hogy egy jövőbeli transport (http/sse) NON-breaking
+     * módon bővíthető legyen (a `start()` + a registry változatlan). MVP: csak `stdio`.
+     */
+    async startTransport(adapter, transport) {
+        switch (transport) {
+            case 'stdio':
+                await adapter.startStdio();
+                return;
+            default:
+                // Exhaustiveness-guard: a `DyNTS_Mcp_TransportKind` bővülésekor itt fordítási hibát kapunk.
+                throw new Error(`Unsupported MCP transport: '${transport}'.`);
+        }
+    }
+}
+exports.DyNTS_Mcp_Server_ServiceBase = DyNTS_Mcp_Server_ServiceBase;
+//# sourceMappingURL=dynts-mcp-server.service-base.js.map

package/build/_modules/mcp/_services/dynts-mcp-server.service-base.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"dynts-mcp-server.service-base.js","sourceRoot":"","sources":["../../../../src/_modules/mcp/_services/dynts-mcp-server.service-base.ts"],"names":[],"mappings":";;;AAAA,sDAAiD;AAQjD,2DAAwD;AAExD;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,MAAsB,4BAA4B;IAEhD,oGAAoG;IAC5F,OAAO,GAA6B,IAAI,CAAC;IAa/C;;;;OAIG;IACI,KAAK;QACV,IAAI,IAAI,CAAC,OAAO,EAAE,CAAC;YACjB,OAAO,IAAI,CAAC,OAAO,CAAC;QACtB,CAAC;QACD,MAAM,OAAO,GAAsB,IAAI,qCAAiB,CAAC,IAAI,CAAC,aAAa,EAAE,CAAC,CAAC;QAE/E,KAAK,MAAM,IAAI,IAAI,IAAI,CAAC,QAAQ,EAAE,EAAE,CAAC;YACnC,OAAO,CAAC,YAAY,CAAC,IAAI,CAAC,CAAC;QAC7B,CAAC;QACD,IAAI,CAAC,OAAO,GAAG,OAAO,CAAC;QAEvB,OAAO,OAAO,CAAC;IACjB,CAAC;IAED;;;;OAIG;IACI,KAAK,CAAC,KAAK,CAAC,OAAgC;QACjD,MAAM,SAAS,GAAY,OAAO,EAAE,SAAS,IAAI,OAAO,CAAC;QACzD,MAAM,OAAO,GAAsB,IAAI,CAAC,KAAK,EAAE,CAAC;QAChD,MAAM,IAAI,GAAyB,IAAI,CAAC,aAAa,EAAE,CAAC;QAExD,qBAAQ,CAAC,QAAQ,CAAC,eAAe,SAAS,qBAAqB,IAAI,CAAC,IAAI,KAAK,IAAI,CAAC,OAAO,KAAK;cACtF,qBAAqB,OAAO,CAAC,sBAAsB,EAAE,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;QAC5E,MAAM,IAAI,CAAC,cAAc,CAAC,OAAO,EAAE,SAAS,CAAC,CAAC;IAChD,CAAC;IAED;;;OAGG;IACI,sBAAsB;QAC3B,OAAO,IAAI,CAAC,OAAO;YACjB,CAAC,CAAC,IAAI,CAAC,OAAO,CAAC,sBAAsB,EAAE;YACvC,CAAC,CAAC,IAAI,CAAC,QAAQ,EAAE,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IAC/C,CAAC;IAED;;;;OAIG;IACI,KAAK,CAAC,QAAQ,CAAC,GAA0C;QAC9D,OAAO,IAAI,CAAC,KAAK,EAAE,CAAC,gBAAgB,CAAC,GAAG,CAAC,CAAC;IAC5C,CAAC;IAED,qEAAqE;IAC9D,KAAK,CAAC,KAAK;QAChB,IAAI,IAAI,CAAC,OAAO,EAAE,CAAC;YACjB,MAAM,IAAI,CAAC,OAAO,CAAC,KAAK,EAAE,CAAC;QAC7B,CAAC;IACH,CAAC;IAED;;;OAGG;IACK,KAAK,CAAC,cAAc,CAAC,OAA0B,EAAE,SAAkB;QACzE,QAAQ,SAAS,EAAE,CAAC;YAClB,KAAK,OAAO;gBACV,MAAM,OAAO,CAAC,UAAU,EAAE,CAAC;gBAE3B,OAAO;YAET;gBACE,4FAA4F;gBAC5F,MAAM,IAAI,KAAK,CAAC,+BAA+B,SAAmB,IAAI,CAAC,CAAC;QAC5E,CAAC;IACH,CAAC;CACJ;AA5FD,oEA4FC"}

package/build/_modules/mcp/_services/dynts-mcp.adapter.d.ts

@@ -0,0 +1,57 @@
+import { DyNTS_Mcp_CallResult, DyNTS_Mcp_ServerInfo, DyNTS_Mcp_ToolDefinition } from '../_models/interfaces/dynts-mcp.interface';
+/**
+ * `DyNTS_Mcp_Adapter` (BFR-AM-003) — a hivatalos `@modelcontextprotocol/sdk` köré épített **vékony
+ * adaptor-réteg**. EZ az EGYETLEN hely a `/mcp` submodule-ban, ahol a SDK-típusok megjelennek — a
+ * `DyNTS_Mcp_Server_ServiceBase` + a consumer tool-jai SDK-mentesek, így egy jövőbeli transport-/SDK-csere
+ * NON-breaking (csak ez az osztály cserélődik).
+ *
+ * Felelősség (3 dolog, semmi domain-logika):
+ *   1. EGY `registerTool` choke-pont (a tool-name → def map),
+ *   2. a `tools/list` + `tools/call` JSON-RPC handler bekötése a SDK-szerverre,
+ *   3. egységes hiba-fordítás: a tool-handler dobott hibája (vagy `isError:true` outcome-ja)
+ *      strukturált `CallToolResult { isError:true }`-tá fordul — SOHA nem néma, SOHA nem crash.
+ *
+ * **stdio-konvenció:** a stdout a JSON-RPC csatorna — az adaptor maga SEMMIT nem ír a stdout-ra a
+ * transport-payload-on kívül (minden log/diag a hívó App felelőssége, stderr-re).
+ */
+export declare class DyNTS_Mcp_Adapter {
+    /** A SDK MCP-szerver (a transport-agnosztikus protocol-réteg). */
+    private readonly server;
+    /** A regisztrált tool-definíciók `name` → def map-je (a `tools/call` dispatch-hez). */
+    private readonly tools;
+    constructor(set: DyNTS_Mcp_ServerInfo);
+    /**
+       * Az EGYETLEN tool-regisztrációs choke-pont. A regisztrált tool-ok hirdetődnek a `tools/list`-ben
+       * és dispatch-elhetők a `tools/call`-on. Az azonos nevű ismételt regisztráció felülír (last-wins).
+       */
+    registerTool(definition: DyNTS_Mcp_ToolDefinition): void;
+    /** A hirdetett (regisztrált) tool-nevek (a contract/diszjunkció-teszthez). */
+    getAdvertisedToolNames(): string[];
+    /**
+       * A stdio transport csatlakoztatása + a szerver indítása. A `connect` után a `tools/list` a
+       * regisztrált tool-okat hirdeti. A boot-üzenetek a stderr-en (a hívó App felel).
+       */
+    startStdio(): Promise<void>;
+    /** A szerver leállítása (graceful close — teszt-/shutdown-úthoz). */
+    close(): Promise<void>;
+    /**
+       * Egy tool-hívás KÖZVETLEN dispatch-elése (a transport-megkerülésével) — a contract/registry-teszt
+       * ezt hívja a stdio-szerver indítása nélkül. Ugyanaz a logika fut, mint a SDK `tools/call`-on:
+       * ismeretlen tool → strukturált hiba; handler-hiba → `isError:true` fordítás.
+       */
+    dispatchToolCall(set: {
+        name: string;
+        arguments?: unknown;
+    }): Promise<DyNTS_Mcp_CallResult>;
+    /** A `tools/list` és a `tools/call` JSON-RPC handler bekötése a SDK-szerverre. */
+    private installHandlers;
+    /** Egy sikeres (vagy strukturált-hiba) handler-outcome → `CallToolResult` (text-JSON content). */
+    private toCallResult;
+    /** Egy hiba → `CallToolResult { isError:true }` strukturált hiba-payload-dal (soha nem néma). */
+    private errorResult;
+    /** Egy hiba ember-olvasható üzenete (DyFM_Error → message; Error → message; egyéb → fallback). */
+    private describeError;
+    /** JSON-stringify (a transport text-content payload-ja); szerializálás-hiba → strukturált hiba. */
+    private stringify;
+}
+//# sourceMappingURL=dynts-mcp.adapter.d.ts.map

package/build/_modules/mcp/_services/dynts-mcp.adapter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"dynts-mcp.adapter.d.ts","sourceRoot":"","sources":["../../../../src/_modules/mcp/_services/dynts-mcp.adapter.ts"],"names":[],"mappings":"AAWA,OAAO,EACL,oBAAoB,EACpB,oBAAoB,EACpB,wBAAwB,EAEzB,MAAM,2CAA2C,CAAC;AAEnD;;;;;;;;;;;;;;GAcG;AACH,qBAAa,iBAAiB;IAE5B,kEAAkE;IAClE,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAS;IAEhC,uFAAuF;IACvF,OAAO,CAAC,QAAQ,CAAC,KAAK,CACwB;gBAElC,GAAG,EAAE,oBAAoB;IAQrC;;;SAGK;IACE,YAAY,CAAC,UAAU,EAAE,wBAAwB,GAAG,IAAI;IAI/D,8EAA8E;IACvE,sBAAsB,IAAI,MAAM,EAAE;IAIzC;;;SAGK;IACQ,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC;IAMxC,qEAAqE;IACxD,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAInC;;;;SAIK;IACQ,gBAAgB,CAAC,GAAG,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,SAAS,CAAC,EAAE,OAAO,CAAA;KAAE,GAAG,OAAO,CAAC,oBAAoB,CAAC;IAoBxG,kFAAkF;IAClF,OAAO,CAAC,eAAe;IAwBvB,kGAAkG;IAClG,OAAO,CAAC,YAAY;IAOpB,iGAAiG;IACjG,OAAO,CAAC,WAAW;IASnB,kGAAkG;IAClG,OAAO,CAAC,aAAa;IAYrB,mGAAmG;IACnG,OAAO,CAAC,SAAS;CAOlB"}

package/build/_modules/mcp/_services/dynts-mcp.adapter.js

@@ -0,0 +1,139 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.DyNTS_Mcp_Adapter = void 0;
+// A `@modelcontextprotocol/sdk` ESM-only csomag; a deep subpath-importjai (server/index, server/stdio,
+// types) KÖTELEZŐEN `.js`-suffixet igényelnek (az SDK `exports`-map így oldja fel) — ezért a `no-js-import`
+// szabály ITT indokoltan kikapcsolva (C2, FAM-REV bedrock-fix). Suffix-strip → resolve-hiba.
+/* eslint-disable @futdevpro/dynamo/no-js-import */
+const index_js_1 = require("@modelcontextprotocol/sdk/server/index.js");
+const stdio_js_1 = require("@modelcontextprotocol/sdk/server/stdio.js");
+const types_js_1 = require("@modelcontextprotocol/sdk/types.js");
+/* eslint-enable @futdevpro/dynamo/no-js-import */
+const fsm_dynamo_1 = require("@futdevpro/fsm-dynamo");
+/**
+ * `DyNTS_Mcp_Adapter` (BFR-AM-003) — a hivatalos `@modelcontextprotocol/sdk` köré épített **vékony
+ * adaptor-réteg**. EZ az EGYETLEN hely a `/mcp` submodule-ban, ahol a SDK-típusok megjelennek — a
+ * `DyNTS_Mcp_Server_ServiceBase` + a consumer tool-jai SDK-mentesek, így egy jövőbeli transport-/SDK-csere
+ * NON-breaking (csak ez az osztály cserélődik).
+ *
+ * Felelősség (3 dolog, semmi domain-logika):
+ *   1. EGY `registerTool` choke-pont (a tool-name → def map),
+ *   2. a `tools/list` + `tools/call` JSON-RPC handler bekötése a SDK-szerverre,
+ *   3. egységes hiba-fordítás: a tool-handler dobott hibája (vagy `isError:true` outcome-ja)
+ *      strukturált `CallToolResult { isError:true }`-tá fordul — SOHA nem néma, SOHA nem crash.
+ *
+ * **stdio-konvenció:** a stdout a JSON-RPC csatorna — az adaptor maga SEMMIT nem ír a stdout-ra a
+ * transport-payload-on kívül (minden log/diag a hívó App felelőssége, stderr-re).
+ */
+class DyNTS_Mcp_Adapter {
+    /** A SDK MCP-szerver (a transport-agnosztikus protocol-réteg). */
+    server;
+    /** A regisztrált tool-definíciók `name` → def map-je (a `tools/call` dispatch-hez). */
+    tools = new Map();
+    constructor(set) {
+        this.server = new index_js_1.Server({ name: set.name, version: set.version }, { capabilities: { tools: {} } });
+        this.installHandlers();
+    }
+    /**
+       * Az EGYETLEN tool-regisztrációs choke-pont. A regisztrált tool-ok hirdetődnek a `tools/list`-ben
+       * és dispatch-elhetők a `tools/call`-on. Az azonos nevű ismételt regisztráció felülír (last-wins).
+       */
+    registerTool(definition) {
+        this.tools.set(definition.name, definition);
+    }
+    /** A hirdetett (regisztrált) tool-nevek (a contract/diszjunkció-teszthez). */
+    getAdvertisedToolNames() {
+        return Array.from(this.tools.keys());
+    }
+    /**
+       * A stdio transport csatlakoztatása + a szerver indítása. A `connect` után a `tools/list` a
+       * regisztrált tool-okat hirdeti. A boot-üzenetek a stderr-en (a hívó App felel).
+       */
+    async startStdio() {
+        const transport = new stdio_js_1.StdioServerTransport();
+        await this.server.connect(transport);
+    }
+    /** A szerver leállítása (graceful close — teszt-/shutdown-úthoz). */
+    async close() {
+        await this.server.close();
+    }
+    /**
+       * Egy tool-hívás KÖZVETLEN dispatch-elése (a transport-megkerülésével) — a contract/registry-teszt
+       * ezt hívja a stdio-szerver indítása nélkül. Ugyanaz a logika fut, mint a SDK `tools/call`-on:
+       * ismeretlen tool → strukturált hiba; handler-hiba → `isError:true` fordítás.
+       */
+    async dispatchToolCall(set) {
+        const definition = this.tools.get(set.name);
+        if (!definition) {
+            return this.errorResult(`Unknown tool: '${set.name}'. Advertised tools: `
+                + `${this.getAdvertisedToolNames().join(', ')}.`);
+        }
+        try {
+            const outcome = await definition.handler(set.arguments);
+            return this.toCallResult(outcome);
+        }
+        catch (error) {
+            return this.errorResult(this.describeError(error), error);
+        }
+    }
+    // =========================================================================
+    // SDK request-handler bekötés (tools/list + tools/call)
+    // =========================================================================
+    /** A `tools/list` és a `tools/call` JSON-RPC handler bekötése a SDK-szerverre. */
+    installHandlers() {
+        // tools/list — PONTOSAN a regisztrált (advertised) tool-okat hirdeti.
+        this.server.setRequestHandler(types_js_1.ListToolsRequestSchema, async () => ({
+            tools: Array.from(this.tools.values()).map((definition) => ({
+                name: definition.name,
+                description: definition.description,
+                inputSchema: definition.inputSchema,
+            })),
+        }));
+        // tools/call — a megfelelő handler futtatása + egységes hiba-fordítás (a közös dispatch-en át).
+        // A `DyNTS_Mcp_CallResult` a SDK `CallToolResult` egy al-shape-je (text-content + isError) — a
+        // SDK-cast KIZÁRÓLAG itt, az adaptor-boundary-n él (a SDK izolálva marad).
+        this.server.setRequestHandler(types_js_1.CallToolRequestSchema, async (request) => (await this.dispatchToolCall({
+            name: request.params.name,
+            arguments: request.params.arguments,
+        })));
+    }
+    // =========================================================================
+    // CallToolResult fordítás (a transport-payload — text-JSON; egységes hiba-fordítás)
+    // =========================================================================
+    /** Egy sikeres (vagy strukturált-hiba) handler-outcome → `CallToolResult` (text-JSON content). */
+    toCallResult(outcome) {
+        return {
+            content: [{ type: 'text', text: this.stringify(outcome.data) }],
+            isError: outcome.isError === true,
+        };
+    }
+    /** Egy hiba → `CallToolResult { isError:true }` strukturált hiba-payload-dal (soha nem néma). */
+    errorResult(message, error) {
+        const errorCode = error instanceof fsm_dynamo_1.DyFM_Error
+            ? fsm_dynamo_1.DyFM_Error.getErrorCode(error)
+            : undefined;
+        const payload = { ok: false, error: { errorCode: errorCode, message: message } };
+        return { content: [{ type: 'text', text: this.stringify(payload) }], isError: true };
+    }
+    /** Egy hiba ember-olvasható üzenete (DyFM_Error → message; Error → message; egyéb → fallback). */
+    describeError(error) {
+        if (error instanceof fsm_dynamo_1.DyFM_Error) {
+            return fsm_dynamo_1.DyFM_Error.getErrorMessage(error) || 'Unknown DyFM error.';
+        }
+        if (error instanceof Error) {
+            return error.message;
+        }
+        return 'Unknown error during tool execution.';
+    }
+    /** JSON-stringify (a transport text-content payload-ja); szerializálás-hiba → strukturált hiba. */
+    stringify(data) {
+        try {
+            return JSON.stringify(data);
+        }
+        catch {
+            return JSON.stringify({ ok: false, error: { message: 'The response is not JSON-serializable.' } });
+        }
+    }
+}
+exports.DyNTS_Mcp_Adapter = DyNTS_Mcp_Adapter;
+//# sourceMappingURL=dynts-mcp.adapter.js.map

package/build/_modules/mcp/_services/dynts-mcp.adapter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"dynts-mcp.adapter.js","sourceRoot":"","sources":["../../../../src/_modules/mcp/_services/dynts-mcp.adapter.ts"],"names":[],"mappings":"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"}

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

@@ -0,0 +1,4 @@
+export * from './_models/interfaces/dynts-mcp.interface';
+export * from './_services/dynts-mcp.adapter';
+export * from './_services/dynts-mcp-server.service-base';
+//# sourceMappingURL=index.d.ts.map

package/build/_modules/mcp/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/_modules/mcp/index.ts"],"names":[],"mappings":"AAQA,cAAc,0CAA0C,CAAC;AAGzD,cAAc,+BAA+B,CAAC;AAC9C,cAAc,2CAA2C,CAAC"}

package/build/_modules/mcp/index.js

@@ -0,0 +1,13 @@
+"use strict";
+// MCP MODULE (BFR-AM-003) — domain-agnosztikus Model Context Protocol szerver-base + transport +
+// tool-registry, a hivatalos `@modelcontextprotocol/sdk` köré izolált adaptorral. A consumer
+// leszármazik a `DyNTS_Mcp_Server_ServiceBase`-ből + a SAJÁT tool-jait regisztrálja (a bedrock NEM definiál
+// domain-tool-t). A SDK KIZÁRÓLAG a `DyNTS_Mcp_Adapter` mögött él (transport-csere NON-breaking).
+Object.defineProperty(exports, "__esModule", { value: true });
+const tslib_1 = require("tslib");
+// INTERFACES
+tslib_1.__exportStar(require("./_models/interfaces/dynts-mcp.interface"), exports);
+// SERVICES
+tslib_1.__exportStar(require("./_services/dynts-mcp.adapter"), exports);
+tslib_1.__exportStar(require("./_services/dynts-mcp-server.service-base"), exports);
+//# sourceMappingURL=index.js.map

package/build/_modules/mcp/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/_modules/mcp/index.ts"],"names":[],"mappings":";AAEA,iGAAiG;AACjG,6FAA6F;AAC7F,4GAA4G;AAC5G,kGAAkG;;;AAElG,aAAa;AACb,mFAAyD;AAEzD,WAAW;AACX,wEAA8C;AAC9C,oFAA0D"}

package/build/_modules/scoped-config/_enums/dynts-scoped-config-level.enum.d.ts

@@ -0,0 +1,19 @@
+/**
+ * `DyNTS_ScopedConfig_Level` — a DB-backed scoped config feloldási-szintjei (BFR-AM-004).
+ *
+ * A precedencia: **scope (leaf→root) > table > global > builtin-default**. Egy `DyNTS_ScopedConfig`
+ * dokumentum mindig pontosan EGY szinten él; a `level` + `tableScope` + `scopeId` hármas adja a
+ * feloldási-kulcsot (a `key`-vel együtt a logikai unique-constraint).
+ *
+ * **Domain-agnosztikus:** a konkrét table-/scope-nevek a fogyasztó dolga; a bedrock csak a generikus
+ * precedencia-engine + a tárolás szintjeit definiálja (a katalógus/kulcsok NEM ide tartoznak).
+ */
+export declare enum DyNTS_ScopedConfig_Level {
+    /** Rendszer-szintű default (a legalacsonyabb precedencia a builtin felett). */
+    global = "global",
+    /** Egy adott logikai tár/táblázat szintje (`tableScope` kötelező). */
+    table = "table",
+    /** A legspecifikusabb szint: egy konkrét scope-entitás (`tableScope` + `scopeId` kötelező). */
+    scope = "scope"
+}
+//# sourceMappingURL=dynts-scoped-config-level.enum.d.ts.map

package/build/_modules/scoped-config/_enums/dynts-scoped-config-level.enum.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"dynts-scoped-config-level.enum.d.ts","sourceRoot":"","sources":["../../../../src/_modules/scoped-config/_enums/dynts-scoped-config-level.enum.ts"],"names":[],"mappings":"AACA;;;;;;;;;GASG;AACH,oBAAY,wBAAwB;IAElC,+EAA+E;IAC/E,MAAM,WAAW;IAEjB,sEAAsE;IACtE,KAAK,UAAU;IAEf,+FAA+F;IAC/F,KAAK,UAAU;CAChB"}

package/build/_modules/scoped-config/_enums/dynts-scoped-config-level.enum.js

@@ -0,0 +1,23 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.DyNTS_ScopedConfig_Level = void 0;
+/**
+ * `DyNTS_ScopedConfig_Level` — a DB-backed scoped config feloldási-szintjei (BFR-AM-004).
+ *
+ * A precedencia: **scope (leaf→root) > table > global > builtin-default**. Egy `DyNTS_ScopedConfig`
+ * dokumentum mindig pontosan EGY szinten él; a `level` + `tableScope` + `scopeId` hármas adja a
+ * feloldási-kulcsot (a `key`-vel együtt a logikai unique-constraint).
+ *
+ * **Domain-agnosztikus:** a konkrét table-/scope-nevek a fogyasztó dolga; a bedrock csak a generikus
+ * precedencia-engine + a tárolás szintjeit definiálja (a katalógus/kulcsok NEM ide tartoznak).
+ */
+var DyNTS_ScopedConfig_Level;
+(function (DyNTS_ScopedConfig_Level) {
+    /** Rendszer-szintű default (a legalacsonyabb precedencia a builtin felett). */
+    DyNTS_ScopedConfig_Level["global"] = "global";
+    /** Egy adott logikai tár/táblázat szintje (`tableScope` kötelező). */
+    DyNTS_ScopedConfig_Level["table"] = "table";
+    /** A legspecifikusabb szint: egy konkrét scope-entitás (`tableScope` + `scopeId` kötelező). */
+    DyNTS_ScopedConfig_Level["scope"] = "scope";
+})(DyNTS_ScopedConfig_Level || (exports.DyNTS_ScopedConfig_Level = DyNTS_ScopedConfig_Level = {}));
+//# sourceMappingURL=dynts-scoped-config-level.enum.js.map

package/build/_modules/scoped-config/_enums/dynts-scoped-config-level.enum.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"dynts-scoped-config-level.enum.js","sourceRoot":"","sources":["../../../../src/_modules/scoped-config/_enums/dynts-scoped-config-level.enum.ts"],"names":[],"mappings":";;;AACA;;;;;;;;;GASG;AACH,IAAY,wBAUX;AAVD,WAAY,wBAAwB;IAElC,+EAA+E;IAC/E,6CAAiB,CAAA;IAEjB,sEAAsE;IACtE,2CAAe,CAAA;IAEf,+FAA+F;IAC/F,2CAAe,CAAA;AACjB,CAAC,EAVW,wBAAwB,wCAAxB,wBAAwB,QAUnC"}

package/build/_modules/scoped-config/_models/data-models/dynts-scoped-config.data-model.d.ts

@@ -0,0 +1,44 @@
+import { DyFM_DataModel_Params, DyFM_Metadata } from '@futdevpro/fsm-dynamo';
+import { DyNTS_ScopedConfig_Level } from '../../_enums/dynts-scoped-config-level.enum';
+/**
+ * `DyNTS_ScopedConfig` entitás (BFR-AM-004) — egy dokumentum = **egy setting-érték egy adott szinten**.
+ * A `level` + `tableScope` + `scopeId` hármas adja a feloldási-kulcsot (a `key`-vel együtt a logikai
+ * unique-constraint); a precedencia: **scope (leaf→root) > table > global > builtin-default**.
+ *
+ * `extends DyFM_Metadata`: az identitás/metadata (`_id`, `__created`, `__lastModified`, `_deleted`)
+ * az ősből jön; a `_deleted` soft-delete marker (Date), amit a `DyNTS_ArchiveDataService` kezel — ez
+ * a felülírás-history alapja (egy `set` a régi aktív rekordot archiválja, az újat aktívan írja).
+ *
+ * **Domain-agnosztikus:** a `key` `string`, a `value` `unknown` (Mongoose `Mixed`, séma-szinten
+ * `type:'object'`). A bedrock NEM validál séma-szinten — a típushelyesség / katalógus a FOGYASZTÓ
+ * dolga. A `value` írása **`$set`-tel atomikus** (Mongoose Mixed silent-drop ellen — lásd
+ * `DyNTS_ScopedConfig_DataService.setValue`).
+ */
+export declare class DyNTS_ScopedConfig extends DyFM_Metadata {
+    /** A feloldási-szint (`global`|`table`|`scope`). */
+    level?: DyNTS_ScopedConfig_Level;
+    /** `level='table'|'scope'` esetén kötelező: melyik logikai tár. */
+    tableScope?: string;
+    /** `level='scope'` esetén kötelező: a scope-entitás logikai azonosítója. */
+    scopeId?: string;
+    /** A config-kulcs (a fogyasztó katalógusából; string-ként perzistált). */
+    key?: string;
+    /** A setting-érték; típusa a fogyasztó katalógusa szerint. Mongoose `Mixed`. */
+    value?: unknown;
+    /** Ki/mi állította be (audit). */
+    setBy?: string;
+    /** Beállítás-részlet (pl. preset-név, CLI-user). */
+    setByDetail?: string;
+    /** Opcionális indoklás. */
+    note?: string;
+    constructor(set?: Partial<DyNTS_ScopedConfig>);
+}
+/**
+ * MongoDB data-params a `dynts_scoped_config` collection-höz (BFR-AM-004). `addArchive: true` → a
+ * felülírt (régi) értékek soft-delete-elve megőrződnek (audit-trail / history).
+ *
+ * A `value` `type:'object'` (Mongoose `Mixed`) — a séma NEM validál; a típushelyesség a fogyasztó
+ * katalógusának + set-kori validációjának dolga.
+ */
+export declare const DyNTS_scopedConfig_dataParams: DyFM_DataModel_Params<DyNTS_ScopedConfig>;
+//# sourceMappingURL=dynts-scoped-config.data-model.d.ts.map

package/build/_modules/scoped-config/_models/data-models/dynts-scoped-config.data-model.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"dynts-scoped-config.data-model.d.ts","sourceRoot":"","sources":["../../../../../src/_modules/scoped-config/_models/data-models/dynts-scoped-config.data-model.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,qBAAqB,EAAE,aAAa,EAAe,MAAM,uBAAuB,CAAC;AAE1F,OAAO,EAAE,wBAAwB,EAAE,MAAM,6CAA6C,CAAC;AAEvF;;;;;;;;;;;;;GAaG;AACH,qBAAa,kBAAmB,SAAQ,aAAa;IAInD,oDAAoD;IACpD,KAAK,CAAC,EAAE,wBAAwB,CAAC;IAEjC,mEAAmE;IACnE,UAAU,CAAC,EAAE,MAAM,CAAC;IAEpB,4EAA4E;IAC5E,OAAO,CAAC,EAAE,MAAM,CAAC;IAIjB,0EAA0E;IAC1E,GAAG,CAAC,EAAE,MAAM,CAAC;IAEb,gFAAgF;IAChF,KAAK,CAAC,EAAE,OAAO,CAAC;IAIhB,kCAAkC;IAClC,KAAK,CAAC,EAAE,MAAM,CAAC;IAEf,oDAAoD;IACpD,WAAW,CAAC,EAAE,MAAM,CAAC;IAErB,2BAA2B;IAC3B,IAAI,CAAC,EAAE,MAAM,CAAC;gBAEF,GAAG,CAAC,EAAE,OAAO,CAAC,kBAAkB,CAAC;CAO9C;AAED;;;;;;GAMG;AACH,eAAO,MAAM,6BAA6B,EAAE,qBAAqB,CAAC,kBAAkB,CAchF,CAAC"}

package/build/_modules/scoped-config/_models/data-models/dynts-scoped-config.data-model.js

@@ -0,0 +1,68 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.DyNTS_scopedConfig_dataParams = exports.DyNTS_ScopedConfig = void 0;
+const fsm_dynamo_1 = require("@futdevpro/fsm-dynamo");
+/**
+ * `DyNTS_ScopedConfig` entitás (BFR-AM-004) — egy dokumentum = **egy setting-érték egy adott szinten**.
+ * A `level` + `tableScope` + `scopeId` hármas adja a feloldási-kulcsot (a `key`-vel együtt a logikai
+ * unique-constraint); a precedencia: **scope (leaf→root) > table > global > builtin-default**.
+ *
+ * `extends DyFM_Metadata`: az identitás/metadata (`_id`, `__created`, `__lastModified`, `_deleted`)
+ * az ősből jön; a `_deleted` soft-delete marker (Date), amit a `DyNTS_ArchiveDataService` kezel — ez
+ * a felülírás-history alapja (egy `set` a régi aktív rekordot archiválja, az újat aktívan írja).
+ *
+ * **Domain-agnosztikus:** a `key` `string`, a `value` `unknown` (Mongoose `Mixed`, séma-szinten
+ * `type:'object'`). A bedrock NEM validál séma-szinten — a típushelyesség / katalógus a FOGYASZTÓ
+ * dolga. A `value` írása **`$set`-tel atomikus** (Mongoose Mixed silent-drop ellen — lásd
+ * `DyNTS_ScopedConfig_DataService.setValue`).
+ */
+class DyNTS_ScopedConfig extends fsm_dynamo_1.DyFM_Metadata {
+    // --- a feloldási kulcs ---
+    /** A feloldási-szint (`global`|`table`|`scope`). */
+    level;
+    /** `level='table'|'scope'` esetén kötelező: melyik logikai tár. */
+    tableScope;
+    /** `level='scope'` esetén kötelező: a scope-entitás logikai azonosítója. */
+    scopeId;
+    // --- a setting maga ---
+    /** A config-kulcs (a fogyasztó katalógusából; string-ként perzistált). */
+    key;
+    /** A setting-érték; típusa a fogyasztó katalógusa szerint. Mongoose `Mixed`. */
+    value;
+    // --- audit ---
+    /** Ki/mi állította be (audit). */
+    setBy;
+    /** Beállítás-részlet (pl. preset-név, CLI-user). */
+    setByDetail;
+    /** Opcionális indoklás. */
+    note;
+    constructor(set) {
+        super(set);
+        if (set) {
+            fsm_dynamo_1.DyFM_Object.cleanAssign(this, set);
+        }
+    }
+}
+exports.DyNTS_ScopedConfig = DyNTS_ScopedConfig;
+/**
+ * MongoDB data-params a `dynts_scoped_config` collection-höz (BFR-AM-004). `addArchive: true` → a
+ * felülírt (régi) értékek soft-delete-elve megőrződnek (audit-trail / history).
+ *
+ * A `value` `type:'object'` (Mongoose `Mixed`) — a séma NEM validál; a típushelyesség a fogyasztó
+ * katalógusának + set-kori validációjának dolga.
+ */
+exports.DyNTS_scopedConfig_dataParams = new fsm_dynamo_1.DyFM_DataModel_Params({
+    dataName: 'dynts_scoped_config',
+    addArchive: true,
+    properties: {
+        level: { type: 'string', index: true, required: true },
+        tableScope: { type: 'string', index: true },
+        scopeId: { type: 'string', index: true },
+        key: { type: 'string', index: true, required: true },
+        value: { type: 'object' },
+        setBy: { type: 'string', index: true },
+        setByDetail: { type: 'string' },
+        note: { type: 'string' },
+    },
+});
+//# sourceMappingURL=dynts-scoped-config.data-model.js.map

package/build/_modules/scoped-config/_models/data-models/dynts-scoped-config.data-model.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"dynts-scoped-config.data-model.js","sourceRoot":"","sources":["../../../../../src/_modules/scoped-config/_models/data-models/dynts-scoped-config.data-model.ts"],"names":[],"mappings":";;;AACA,sDAA0F;AAI1F;;;;;;;;;;;;;GAaG;AACH,MAAa,kBAAmB,SAAQ,0BAAa;IAEnD,4BAA4B;IAE5B,oDAAoD;IACpD,KAAK,CAA4B;IAEjC,mEAAmE;IACnE,UAAU,CAAU;IAEpB,4EAA4E;IAC5E,OAAO,CAAU;IAEjB,yBAAyB;IAEzB,0EAA0E;IAC1E,GAAG,CAAU;IAEb,gFAAgF;IAChF,KAAK,CAAW;IAEhB,gBAAgB;IAEhB,kCAAkC;IAClC,KAAK,CAAU;IAEf,oDAAoD;IACpD,WAAW,CAAU;IAErB,2BAA2B;IAC3B,IAAI,CAAU;IAEd,YAAY,GAAiC;QAC3C,KAAK,CAAC,GAAG,CAAC,CAAC;QAEX,IAAI,GAAG,EAAE,CAAC;YACR,wBAAW,CAAC,WAAW,CAAC,IAAI,EAAE,GAAG,CAAC,CAAC;QACrC,CAAC;IACH,CAAC;CACF;AAvCD,gDAuCC;AAED;;;;;;GAMG;AACU,QAAA,6BAA6B,GACxC,IAAI,kCAAqB,CAAqB;IAC5C,QAAQ,EAAE,qBAAqB;IAC/B,UAAU,EAAE,IAAI;IAChB,UAAU,EAAE;QACV,KAAK,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,KAAK,EAAE,IAAI,EAAE,QAAQ,EAAE,IAAI,EAAE;QACtD,UAAU,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,KAAK,EAAE,IAAI,EAAE;QAC3C,OAAO,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,KAAK,EAAE,IAAI,EAAE;QACxC,GAAG,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,KAAK,EAAE,IAAI,EAAE,QAAQ,EAAE,IAAI,EAAE;QACpD,KAAK,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE;QACzB,KAAK,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,KAAK,EAAE,IAAI,EAAE;QACtC,WAAW,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE;QAC/B,IAAI,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE;KACzB;CACF,CAAC,CAAC"}