@futdevpro/nts-dynamo 1.15.157 → 1.15.160

package/src/_modules/logs/logs.controller.ts

@@ -1,109 +0,0 @@
-import { Request, Response } from 'express';
-
-import { DyFM_HttpCallType } from '@futdevpro/fsm-dynamo';
-
-import { DyNTS_Controller } from '../../_services/route/controller.service';
-import { DyNTS_Endpoint_Params } from '../../_models/control-models/endpoint-params.control-model';
-import { DyNTS_global_settings } from '../../_collections/global-settings.const';
-import { DyNTS_Logs_Service } from './logs.service';
-
-/**
- * Overseer-szintu log parameter tipus.
- * Az authPreProcess opcionalis — ha megadod, a /get endpoint vedett lesz.
- */
-export interface DyNTS_LogsController_Config {
-  /** Opcionalis auth preprocess. Ha nincs megadva → nyilt hozzaferes. */
-  authPreProcess?: (req: Request, res: Response) => Promise<void>;
-}
-
-/**
- * NTS Logs Controller — beepitett /logs/get endpoint a szerver logok lekeresehez.
- *
- * Hasznalat:
- *   DyNTS_getLogsRoutingModule()  — auth nelkul
- *   DyNTS_getLogsRoutingModule({ authPreProcess: myAuth })  — auth-tal
- *
- * Ha a logs_endpoint.enabled === false, a controller 503-at dob.
- */
-export class DyNTS_Logs_Controller extends DyNTS_Controller {
-
-  private static config: DyNTS_LogsController_Config = {};
-
-  static configure(config: DyNTS_LogsController_Config): void {
-    DyNTS_Logs_Controller.config = config;
-  }
-
-  static getInstance(): DyNTS_Logs_Controller {
-    return DyNTS_Logs_Controller.getSingletonInstance();
-  }
-
-  private readonly logsService: DyNTS_Logs_Service = DyNTS_Logs_Service.getInstance();
-
-  setupEndpoints(): void {
-    const preProcesses: ((req: Request, res: Response) => Promise<void>)[] = [];
-    if (DyNTS_Logs_Controller.config.authPreProcess) {
-      preProcesses.push(DyNTS_Logs_Controller.config.authPreProcess);
-    }
-
-    this.endpoints = [
-      // GET /get?tail=200 — utolso N sor a log bufferbol
-      new DyNTS_Endpoint_Params({
-        name: 'getLogs',
-        type: DyFM_HttpCallType.get,
-        endpoint: '/get',
-        preProcesses: preProcesses,
-        logRequest: false,
-        tasks: [
-          async (req: Request, res: Response): Promise<void> => {
-            // Ellenorzes: be van-e kapcsolva a logs endpoint
-            if (!DyNTS_global_settings.log_settings?.logs_endpoint?.enabled) {
-              res.status(503).send({
-                error: 'Logs endpoint is not enabled on this server.',
-                hint: 'Set DyNTS_global_settings.log_settings.logs_endpoint.enabled = true',
-              });
-              return;
-            }
-
-            // Ellenorzes: install megtortent-e
-            if (!this.logsService.isInstalled()) {
-              res.status(503).send({
-                error: 'Log buffer is not installed. Call DyNTS_Logs_Service.getInstance().install() at server startup.',
-              });
-              return;
-            }
-
-            const tail: number = Math.min(parseInt(req.query.tail as string) || 200, 2000);
-            const lines: string[] = this.logsService.getLines(tail);
-
-            res.send({
-              totalBuffered: this.logsService.getLineCount(),
-              returned: lines.length,
-              lines: lines,
-            });
-          },
-        ],
-      }),
-
-      // DELETE /clear — buffer uritese
-      new DyNTS_Endpoint_Params({
-        name: 'clearLogs',
-        type: DyFM_HttpCallType.delete,
-        endpoint: '/clear',
-        preProcesses: preProcesses,
-        logRequest: false,
-        tasks: [
-          async (req: Request, res: Response): Promise<void> => {
-            if (!DyNTS_global_settings.log_settings?.logs_endpoint?.enabled) {
-              res.status(503).send({ error: 'Logs endpoint is not enabled.' });
-              return;
-            }
-
-            const count: number = this.logsService.getLineCount();
-            this.logsService.clear();
-            res.send({ result: 'Log buffer cleared', clearedLines: count });
-          },
-        ],
-      }),
-    ];
-  }
-}

package/src/_modules/logs/logs.service.ts

@@ -1,100 +0,0 @@
-import { DyNTS_SingletonServiceBase } from '../../_services/base/singleton.service-base';
-import { DyNTS_global_settings } from '../../_collections/global-settings.const';
-
-/**
- * In-memory ring buffer a szerver logokhoz.
- * Interceptalja a console.log/error/warn kimeneteket es tarolja oket.
- * Max entryszam a log_settings.logs_endpoint.maxEntries-bol jon (default: 2000).
- *
- * Hasznalat:
- *   DyNTS_Logs_Service.getInstance().install()  — egyszer, szerver indulasakor
- *   DyNTS_Logs_Service.getInstance().getLines(200)  — utolso N sor
- */
-export class DyNTS_Logs_Service extends DyNTS_SingletonServiceBase {
-
-  static getInstance(): DyNTS_Logs_Service {
-    return DyNTS_Logs_Service.getSingletonInstance() as DyNTS_Logs_Service;
-  }
-
-  private readonly maxEntries: number;
-  private readonly buffer: string[] = [];
-  private installed: boolean = false;
-
-  protected constructor() {
-    super();
-    this.maxEntries = DyNTS_global_settings.log_settings?.logs_endpoint?.maxEntries ?? 2000;
-  }
-
-  /**
-   * Interceptalja a console.log/error/warn kimeneteket es a bufferbe irja.
-   * Egyszer kell hivni, a szerver indulasakor. Tobbszori hivas no-op.
-   */
-  install(): void {
-    if (this.installed) { return; }
-    this.installed = true;
-
-    const originalLog: typeof console.log = console.log.bind(console);
-    const originalError: typeof console.error = console.error.bind(console);
-    const originalWarn: typeof console.warn = console.warn.bind(console);
-
-    const self: DyNTS_Logs_Service = this;
-
-    console.log = (...args: any[]): void => {
-      self.addLine('LOG', args);
-      originalLog(...args);
-    };
-
-    console.error = (...args: any[]): void => {
-      self.addLine('ERR', args);
-      originalError(...args);
-    };
-
-    console.warn = (...args: any[]): void => {
-      self.addLine('WRN', args);
-      originalWarn(...args);
-    };
-  }
-
-  /**
-   * Az utolso N sor lekerdezese.
-   */
-  getLines(count: number = 200): string[] {
-    const start: number = Math.max(0, this.buffer.length - count);
-    return this.buffer.slice(start);
-  }
-
-  /**
-   * Osszes bufferelt sor szama.
-   */
-  getLineCount(): number {
-    return this.buffer.length;
-  }
-
-  /**
-   * Buffer uritese.
-   */
-  clear(): void {
-    this.buffer.length = 0;
-  }
-
-  /**
-   * Telepitve van-e mar a console intercept.
-   */
-  isInstalled(): boolean {
-    return this.installed;
-  }
-
-  private addLine(level: string, args: any[]): void {
-    const message: string = args.map((arg: any) => {
-      if (typeof arg === 'string') { return arg; }
-      try { return JSON.stringify(arg); } catch { return String(arg); }
-    }).join(' ');
-
-    const timestamped: string = `${new Date().toISOString()} [${level}] ${message}`;
-    this.buffer.push(timestamped);
-
-    if (this.buffer.length > this.maxEntries) {
-      this.buffer.shift();
-    }
-  }
-}

package/src/_modules/mcp/_models/interfaces/dynts-mcp.interface.ts

@@ -1,111 +0,0 @@
-/**
- * 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).
- */
-
-/**
- * Egy JSON-schema fragment (a tool input-schema-jának típusa). Szabad-formájú JSON-objektum (a
- * draft-07 / MCP tool-schema dialektusa); a `properties`/`required`/`type` mezők gyakoriak, de a
- * shape nem kényszerített (az MCP-kliens a `tools/list`-ben kapja vissza, ahogy van).
- */
-export interface DyNTS_Mcp_JsonSchema {
-    /** A JSON-schema gyökér-típusa (a tool input-ja jellemzően `object`). */
-    type: string;
-    /** A property-leírások (kulcs → al-schema). */
-    properties?: { [key: string]: DyNTS_Mcp_JsonSchema };
-    /** Kötelező property-nevek. */
-    required?: string[];
-    /** Array-elem schema (`type: 'array'` esetén). */
-    items?: DyNTS_Mcp_JsonSchema;
-    /** Enum-értékek (string/number/boolean literál-halmaz). */
-    enum?: (string | number | boolean)[];
-    /** Emberi leírás (a tool-választáshoz; az LLM ezt olvassa). */
-    description?: string;
-    /** Default érték (a kliens-hint). */
-    default?: unknown;
-    /** Engedi-e a nem-leírt property-ket (`object` schema-n). */
-    additionalProperties?: boolean;
-    /** Beágyazott `oneOf`/`anyOf` alternatívák. */
-    oneOf?: DyNTS_Mcp_JsonSchema[];
-}
-
-/**
- * Egy MCP tool-handler kimenete (a transport-agnosztikus core ezt adja; az adaptor MCP-tool-result-tá
- * fordítja). A `data` a strukturált JSON-payload; az `isError` jelzi a strukturált hibát — a néma
- * hiba TILOS (a hiba MINDIG `isError:true` payload VAGY dobott exception, amit az adaptor egységesen
- * `isError`-re fordít).
- */
-export interface DyNTS_Mcp_ToolOutcome {
-    /** A strukturált eredmény-payload (a tool output-shape JSON-ja). */
-    data: unknown;
-    /** `true`, ha a kimenet strukturált hiba — az adaptor `isError`-re fordítja. */
-    isError?: boolean;
-}
-
-/**
- * Egy tool-handler aláírása. Az `args` a nyers tool-argumentumok (JSON); a handler a saját
- * input-shape-jére validál + a `DyNTS_Mcp_ToolOutcome`-ot adja. A hibát NEM nyeli el (strukturált
- * hiba-payload `isError:true`-val VAGY dobott exception, amit az adaptor egységes MCP-error-ré fordít).
- */
-export type DyNTS_Mcp_ToolHandler = (args: unknown) => Promise<DyNTS_Mcp_ToolOutcome>;
-
-/**
- * Egy MCP tool-definíció (a `registerTool` egységes shape-je). A consumer ezt a shape-et használja az
- * advertised halmazba (`name`+`description`+`inputSchema`+`handler`). A `tools/list` a regisztrált
- * tool-ok `name`/`description`/`inputSchema`-ját hirdeti.
- */
-export interface DyNTS_Mcp_ToolDefinition {
-    /** A tool neve (a `tools/list`-ben + a `tools/call` dispatch-kulcsa — UNIK kell legyen). */
-    name: string;
-    /** Agent-barát leírás (mikor melyik tool; az LLM ezt olvassa a tool-választáshoz). */
-    description: string;
-    /** A tool input JSON-schema-ja (a `tools/list` ezt hirdeti). */
-    inputSchema: DyNTS_Mcp_JsonSchema;
-    /** A handler (a transport-agnosztikus core-logika). */
-    handler: DyNTS_Mcp_ToolHandler;
-}
-
-/**
- * Az MCP-szerver identitása (a SDK `serverInfo`-ja). A `name`/`version` a kliensnek hirdetett.
- */
-export interface DyNTS_Mcp_ServerInfo {
-    /** A szerver neve (a kliensnek hirdetett `serverInfo.name`). */
-    name: string;
-    /** A szerver verziója (a kliensnek hirdetett `serverInfo.version`). */
-    version: string;
-}
-
-/**
- * A támogatott transport-fajták. MVP: `stdio` (a JSON-RPC a stdin/stdout-on). A `start({transport})`
- * ezzel választ — egy jövőbeli transport (pl. `http`/`sse`) NON-breaking módon bővíthető (csak az
- * adaptor `start`-ja kap új ágat; a server-base + a tool-ok változatlanok).
- */
-export type DyNTS_Mcp_TransportKind = 'stdio';
-
-/**
- * A `start()` opciói. A `transport` választja a csatornát (default `stdio`).
- */
-export interface DyNTS_Mcp_StartOptions {
-    /** A transport-csatorna (default `stdio`). */
-    transport?: DyNTS_Mcp_TransportKind;
-}
-
-/**
- * Egy MCP `tools/call` strukturált eredménye (a transport-payload shape-je). Az adaptor ezt termeli;
- * a `content` egy text-JSON blokk, az `isError` a strukturált-hiba jelzés. Ez a SDK
- * `CallToolResult`-tal wire-kompatibilis al-shape (a SDK-t az adaptor izolálja, ezért itt a saját,
- * SDK-független shape él).
- */
-export interface DyNTS_Mcp_CallResult {
-    /** A tartalom-blokkok (MVP: egyetlen `text`-JSON blokk). */
-    content: { type: 'text'; text: string }[];
-    /** `true`, ha a hívás strukturált hibával végződött (no-silent-failure). */
-    isError?: boolean;
-}

package/src/_modules/mcp/_services/dynts-mcp-server.service-base.spec.ts

@@ -1,151 +0,0 @@
-import { DyNTS_Mcp_Server_ServiceBase } from './dynts-mcp-server.service-base';
-import {
-  DyNTS_Mcp_CallResult,
-  DyNTS_Mcp_ServerInfo,
-  DyNTS_Mcp_ToolDefinition
-} from '../_models/interfaces/dynts-mcp.interface';
-
-/**
- * CONTRACT — `DyNTS_Mcp_Server_ServiceBase` tool-registry + dispatch (BFR-AM-003). A transportot NEM nyitjuk
- * meg (nincs valódi stdio-szerver) — a `build()` + `callTool()` közvetlen dispatch-ét teszteljük,
- * ami UGYANAZ a logika, mint a SDK `tools/call`-ja:
- *   - N tool regisztrálása → `getAdvertisedToolNames` PONTOSAN ezeket listázza,
- *   - `callTool` a megfelelő handler-re dispatch-el (a `name` szerint),
- *   - ismeretlen tool → strukturált `isError:true` (NEM néma, NEM crash),
- *   - handler-dobott hiba → `isError:true` fordítás (a payload tartalmazza a message-et),
- *   - `isError:true` outcome → `isError:true` call-result.
- */
-describe('| DyNTS_Mcp_Server_ServiceBase (tool-registry + dispatch, BFR-AM-003)', () => {
-
-  /** A handler-hívások nyoma (melyik tool, milyen args) — a dispatch-helyesség igazolásához. */
-  let calls: { name: string; args: unknown }[];
-
-  /** Egy teszt-tool-definíció gyára (a handler `data`-ba teszi a tool-nevet + az args-ot). */
-  const makeTool = (name: string): DyNTS_Mcp_ToolDefinition => ({
-    name: name,
-    description: `Test tool ${name}.`,
-    inputSchema: { type: 'object', properties: { x: { type: 'string' } } },
-    handler: async (args: unknown) => {
-      calls.push({ name: name, args: args });
-
-      return { data: { tool: name, echo: args } };
-    },
-  });
-
-  /** A teszt-szerver: 3 tool + egy szándékosan dobó tool. */
-  class TestServer extends DyNTS_Mcp_Server_ServiceBase {
-    protected getServerInfo(): DyNTS_Mcp_ServerInfo {
-      return { name: 'test-mcp', version: '0.0.1-spec' };
-    }
-    protected getTools(): DyNTS_Mcp_ToolDefinition[] {
-      return [
-        makeTool('alpha'),
-        makeTool('beta'),
-        {
-          name: 'boom',
-          description: 'Always throws.',
-          inputSchema: { type: 'object' },
-          handler: async () => {
-            throw new Error('kaboom from handler');
-          },
-        },
-        {
-          name: 'structuredError',
-          description: 'Returns a structured error outcome.',
-          inputSchema: { type: 'object' },
-          handler: async () => ({ data: { reason: 'nope' }, isError: true }),
-        },
-      ];
-    }
-  }
-
-  let server: TestServer;
-
-  beforeEach(() => {
-    calls = [];
-    server = new TestServer();
-  });
-
-  /** A `content[0].text` JSON-payload kiparse-olása (a transport text-JSON shape-je). */
-  const payloadOf = (result: DyNTS_Mcp_CallResult): { [key: string]: unknown } =>
-        JSON.parse(result.content[0].text) as { [key: string]: unknown };
-
-  describe('| registry — getTools → advertised', () => {
-    it('| a deklarált tool-okat hirdeti build ELŐTT is (determinisztikus)', () => {
-      expect(server.getAdvertisedToolNames().sort())
-        .toEqual([ 'alpha', 'beta', 'boom', 'structuredError' ]);
-    });
-
-    it('| build() után UGYANAZOK a hirdetett tool-ok (idempotens build)', () => {
-      const adapter1 = server.build();
-      const adapter2 = server.build();
-
-      expect(adapter1).toBe(adapter2);
-      expect(adapter1.getAdvertisedToolNames().sort())
-        .toEqual([ 'alpha', 'beta', 'boom', 'structuredError' ]);
-    });
-  });
-
-  describe('| dispatch — callTool a megfelelő handler-re route-ol', () => {
-    it('| alpha → az alpha handler fut (a data a tool-nevet + az args-ot adja)', async () => {
-      const result: DyNTS_Mcp_CallResult = await server.callTool({ name: 'alpha', arguments: { x: '1' } });
-
-      expect(result.isError).toBe(false);
-      expect(calls).toEqual([{ name: 'alpha', args: { x: '1' } }]);
-      expect(payloadOf(result)).toEqual({ tool: 'alpha', echo: { x: '1' } });
-    });
-
-    it('| beta → a beta handler fut (a dispatch a `name` szerint választ)', async () => {
-      await server.callTool({ name: 'beta', arguments: { x: '2' } });
-      expect(calls).toEqual([{ name: 'beta', args: { x: '2' } }]);
-    });
-  });
-
-  describe('| strukturált hiba (no-silent-failure)', () => {
-    it('| ismeretlen tool → isError:true + advertised-lista a message-ben (NEM néma/crash)', async () => {
-      const result: DyNTS_Mcp_CallResult = await server.callTool({ name: 'does_not_exist' });
-
-      expect(result.isError).toBe(true);
-      const payload = payloadOf(result) as { ok: boolean; error: { message: string } };
-
-      expect(payload.ok).toBe(false);
-      expect(payload.error.message).toContain('does_not_exist');
-      expect(payload.error.message).toContain('alpha');
-      // egyetlen ismeretlen tool sem futtatott handlert.
-      expect(calls.length).toBe(0);
-    });
-
-    it('| handler-dobott hiba → isError:true + a hiba message-e a payload-ban (NEM crash)', async () => {
-      const result: DyNTS_Mcp_CallResult = await server.callTool({ name: 'boom' });
-
-      expect(result.isError).toBe(true);
-      const payload = payloadOf(result) as { ok: boolean; error: { message: string } };
-
-      expect(payload.ok).toBe(false);
-      expect(payload.error.message).toContain('kaboom from handler');
-    });
-
-    it('| isError:true outcome → isError:true call-result (a strukturált hiba átmegy)', async () => {
-      const result: DyNTS_Mcp_CallResult = await server.callTool({ name: 'structuredError' });
-
-      expect(result.isError).toBe(true);
-      expect(payloadOf(result)).toEqual({ reason: 'nope' });
-    });
-  });
-
-  describe('| start — transport-választás', () => {
-    it('| ismeretlen transport → dob (exhaustiveness-guard); stdio nem nyílik a spec-ben', async () => {
-      let thrown: unknown;
-
-      try {
-        // Szándékosan érvénytelen transport (a típus-szűkítés megkerülésével) — a guard-ágat teszteli,
-        // valódi stdio-szervert NEM indítunk.
-        await server.start({ transport: 'http' as never });
-      } catch (error) {
-        thrown = error;
-      }
-      expect(thrown).toBeDefined();
-      expect((thrown as Error).message).toContain('Unsupported MCP transport');
-    });
-  });
-});

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

@@ -1,125 +0,0 @@
-import { DyFM_Log } from '@futdevpro/fsm-dynamo';
-
-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 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: DyNTS_Mcp_Adapter | null = null;
-
-    /**
-     * 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.
-     */
-    public build(): DyNTS_Mcp_Adapter {
-      if (this.adapter) {
-        return this.adapter;
-      }
-      const adapter: DyNTS_Mcp_Adapter = new 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.
-     */
-    public async start(options?: DyNTS_Mcp_StartOptions): Promise<void> {
-      const transport: 'stdio' = options?.transport ?? 'stdio';
-      const adapter: DyNTS_Mcp_Adapter = this.build();
-      const info: DyNTS_Mcp_ServerInfo = this.getServerInfo();
-
-      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).
-     */
-    public getAdvertisedToolNames(): string[] {
-      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`).
-     */
-    public async callTool(set: { name: string; arguments?: unknown }): Promise<DyNTS_Mcp_CallResult> {
-      return this.build().dispatchToolCall(set);
-    }
-
-    /** A szerver leállítása (graceful close — teszt-/shutdown-úthoz). */
-    public async close(): Promise<void> {
-      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`.
-     */
-    private async startTransport(adapter: DyNTS_Mcp_Adapter, transport: 'stdio'): Promise<void> {
-      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 as string}'.`);
-      }
-    }
-}