@futdevpro/nts-dynamo 1.15.154 → 1.15.156

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

@@ -1,99 +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;
+"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.adapter.d.ts

@@ -1,57 +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;
-}
+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.js

@@ -1,139 +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;
+"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/index.d.ts

@@ -1,4 +1,4 @@
-export * from './_models/interfaces/dynts-mcp.interface';
-export * from './_services/dynts-mcp.adapter';
-export * from './_services/dynts-mcp-server.service-base';
+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.js

@@ -1,13 +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);
+"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