@futdevpro/nts-dynamo 1.15.308 → 1.15.309

package/build/_modules/cli/_collections/cli-mcp-caller.util.d.ts

@@ -0,0 +1,41 @@
+import { DyCLI_Command_Params } from '../_models/control-models/cli-command-params.control-model';
+import { DyCLI_OperationCaller } from '../_services/cli-program.control-service';
+/**
+ * The server caller of generated CLI commands (HP-DOPL MP-4.5, decision D-4 C-branch): a command's values are the MCP
+ * arguments of its operation, so the call is one `tools/call` through `DyNTS_McpClient_Util`.
+ *
+ * - The target: `--base-url` / `--api-key` / `--timeout` of the call win over the defaults given here.
+ * - `--dry-run` (the common option) is sent as the `dryRun` argument.
+ * - The tool name: `toolPrefix` + the command name (= the operation name, the default MCP tool name).
+ * - Warnings of the call go to `onWarnings` (default: `warning: <w>` lines on stderr, so stdout stays pure JSON).
+ *
+ * @example
+ * ```ts
+ * const cli: DyCLI_Program_ControlService = new DyCLI_Program_ControlService({
+ *   name: 'fo', description: 'Organizer CLI', version, commands,
+ *   callOperation: DyCLI_McpCaller_Util.create({ baseUrl: 'https://organizer.example.com/api', apiKey: savedKey }),
+ * });
+ * ```
+ */
+export declare class DyCLI_McpCaller_Util {
+    /**
+     * Creates the caller.
+     * @param set.baseUrl - the default server base URL (`--base-url` wins)
+     * @param set.apiKey - the default API key (`--api-key` wins)
+     * @param set.endpointPath - the MCP endpoint path; default `/mcp`
+     * @param set.timeoutMs - the default timeout (`--timeout` wins)
+     * @param set.toolPrefix - the server's `mcp_settings.toolPrefix`
+     * @param set.onWarnings - receives the warnings of a successful call
+     */
+    static create(set?: {
+        baseUrl?: string;
+        apiKey?: string;
+        endpointPath?: string;
+        timeoutMs?: number;
+        toolPrefix?: string;
+        onWarnings?(warnings: string[], params: DyCLI_Command_Params): void;
+    }): DyCLI_OperationCaller;
+    /** The default warning output: one `warning:` line per warning on stderr. */
+    private static writeWarnings;
+}
+//# sourceMappingURL=cli-mcp-caller.util.d.ts.map

package/build/_modules/cli/_collections/cli-mcp-caller.util.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli-mcp-caller.util.d.ts","sourceRoot":"","sources":["../../../../src/_modules/cli/_collections/cli-mcp-caller.util.ts"],"names":[],"mappings":"AAIA,OAAO,EACL,oBAAoB,EACrB,MAAM,4DAA4D,CAAC;AAEpE,OAAO,EAAE,qBAAqB,EAAE,MAAM,0CAA0C,CAAC;AAGjF;;;;;;;;;;;;;;;;GAgBG;AACH,qBAAa,oBAAoB;IAC/B;;;;;;;;OAQG;IACH,MAAM,CAAC,MAAM,CAAC,GAAG,GAAE;QACjB,OAAO,CAAC,EAAE,MAAM,CAAC;QACjB,MAAM,CAAC,EAAE,MAAM,CAAC;QAChB,YAAY,CAAC,EAAE,MAAM,CAAC;QACtB,SAAS,CAAC,EAAE,MAAM,CAAC;QACnB,UAAU,CAAC,EAAE,MAAM,CAAC;QACpB,UAAU,CAAC,CAAC,QAAQ,EAAE,MAAM,EAAE,EAAE,MAAM,EAAE,oBAAoB,GAAG,IAAI,CAAC;KAChE,GAAG,qBAAqB;IA8B9B,6EAA6E;IAC7E,OAAO,CAAC,MAAM,CAAC,aAAa;CAK7B"}

package/build/_modules/cli/_collections/cli-mcp-caller.util.js

@@ -0,0 +1,67 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.DyCLI_McpCaller_Util = void 0;
+const fsm_dynamo_1 = require("@futdevpro/fsm-dynamo");
+const global_settings_const_1 = require("../../../_collections/global-settings.const");
+const mcp_client_util_1 = require("../../mcp/_collections/mcp-client.util");
+/**
+ * The server caller of generated CLI commands (HP-DOPL MP-4.5, decision D-4 C-branch): a command's values are the MCP
+ * arguments of its operation, so the call is one `tools/call` through `DyNTS_McpClient_Util`.
+ *
+ * - The target: `--base-url` / `--api-key` / `--timeout` of the call win over the defaults given here.
+ * - `--dry-run` (the common option) is sent as the `dryRun` argument.
+ * - The tool name: `toolPrefix` + the command name (= the operation name, the default MCP tool name).
+ * - Warnings of the call go to `onWarnings` (default: `warning: <w>` lines on stderr, so stdout stays pure JSON).
+ *
+ * @example
+ * ```ts
+ * const cli: DyCLI_Program_ControlService = new DyCLI_Program_ControlService({
+ *   name: 'fo', description: 'Organizer CLI', version, commands,
+ *   callOperation: DyCLI_McpCaller_Util.create({ baseUrl: 'https://organizer.example.com/api', apiKey: savedKey }),
+ * });
+ * ```
+ */
+class DyCLI_McpCaller_Util {
+    /**
+     * Creates the caller.
+     * @param set.baseUrl - the default server base URL (`--base-url` wins)
+     * @param set.apiKey - the default API key (`--api-key` wins)
+     * @param set.endpointPath - the MCP endpoint path; default `/mcp`
+     * @param set.timeoutMs - the default timeout (`--timeout` wins)
+     * @param set.toolPrefix - the server's `mcp_settings.toolPrefix`
+     * @param set.onWarnings - receives the warnings of a successful call
+     */
+    static create(set = {}) {
+        return async (params, values, common) => {
+            const baseUrl = common.baseUrl ?? set.baseUrl;
+            if (!baseUrl) {
+                throw new fsm_dynamo_1.DyFM_Error({
+                    status: 400,
+                    errorCode: `${global_settings_const_1.DyNTS_global_settings.systemShortCodeName}|DyNTS-CLI-URL`,
+                    message: `command "${params.command}" needs the server address`,
+                    userMessage: `"${params.command}" needs the server address: pass --base-url <url>.`,
+                });
+            }
+            const outcome = await mcp_client_util_1.DyNTS_McpClient_Util.callTool({
+                baseUrl: baseUrl,
+                endpointPath: set.endpointPath,
+                apiKey: common.apiKey ?? set.apiKey,
+                timeoutMs: common.timeoutMs ?? set.timeoutMs,
+                name: `${set.toolPrefix ?? ''}${params.command}`,
+                arguments: common.dryRun ? { ...values, dryRun: true } : values,
+            });
+            if (outcome.warnings.length) {
+                (set.onWarnings ?? DyCLI_McpCaller_Util.writeWarnings)(outcome.warnings, params);
+            }
+            return outcome.data;
+        };
+    }
+    /** The default warning output: one `warning:` line per warning on stderr. */
+    static writeWarnings(warnings) {
+        warnings.forEach((warning) => {
+            process.stderr.write(`warning: ${warning}\n`);
+        });
+    }
+}
+exports.DyCLI_McpCaller_Util = DyCLI_McpCaller_Util;
+//# sourceMappingURL=cli-mcp-caller.util.js.map

package/build/_modules/cli/_collections/cli-mcp-caller.util.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli-mcp-caller.util.js","sourceRoot":"","sources":["../../../../src/_modules/cli/_collections/cli-mcp-caller.util.ts"],"names":[],"mappings":";;;AAAA,sDAAmD;AAEnD,uFAAoF;AACpF,4EAA0G;AAQ1G;;;;;;;;;;;;;;;;GAgBG;AACH,MAAa,oBAAoB;IAC/B;;;;;;;;OAQG;IACH,MAAM,CAAC,MAAM,CAAC,MAOV,EAAE;QACJ,OAAO,KAAK,EAAE,MAA4B,EAAE,MAA2B,EAAE,MAA2B,EAAE,EAAE;YACtG,MAAM,OAAO,GAAuB,MAAM,CAAC,OAAO,IAAI,GAAG,CAAC,OAAO,CAAC;YAElE,IAAI,CAAC,OAAO,EAAE,CAAC;gBACb,MAAM,IAAI,uBAAU,CAAC;oBACnB,MAAM,EAAE,GAAG;oBACX,SAAS,EAAE,GAAG,6CAAqB,CAAC,mBAAmB,gBAAgB;oBACvE,OAAO,EAAE,YAAY,MAAM,CAAC,OAAO,4BAA4B;oBAC/D,WAAW,EAAE,IAAI,MAAM,CAAC,OAAO,oDAAoD;iBACpF,CAAC,CAAC;YACL,CAAC;YAED,MAAM,OAAO,GAA+B,MAAM,sCAAoB,CAAC,QAAQ,CAAC;gBAC9E,OAAO,EAAE,OAAO;gBAChB,YAAY,EAAE,GAAG,CAAC,YAAY;gBAC9B,MAAM,EAAE,MAAM,CAAC,MAAM,IAAI,GAAG,CAAC,MAAM;gBACnC,SAAS,EAAE,MAAM,CAAC,SAAS,IAAI,GAAG,CAAC,SAAS;gBAC5C,IAAI,EAAE,GAAG,GAAG,CAAC,UAAU,IAAI,EAAE,GAAG,MAAM,CAAC,OAAO,EAAE;gBAChD,SAAS,EAAE,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,GAAG,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,MAAM;aAChE,CAAC,CAAC;YAEH,IAAI,OAAO,CAAC,QAAQ,CAAC,MAAM,EAAE,CAAC;gBAC5B,CAAC,GAAG,CAAC,UAAU,IAAI,oBAAoB,CAAC,aAAa,CAAC,CAAC,OAAO,CAAC,QAAQ,EAAE,MAAM,CAAC,CAAC;YACnF,CAAC;YAED,OAAO,OAAO,CAAC,IAAI,CAAC;QACtB,CAAC,CAAC;IACJ,CAAC;IAED,6EAA6E;IACrE,MAAM,CAAC,aAAa,CAAC,QAAkB;QAC7C,QAAQ,CAAC,OAAO,CAAC,CAAC,OAAe,EAAQ,EAAE;YACzC,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,YAAY,OAAO,IAAI,CAAC,CAAC;QAChD,CAAC,CAAC,CAAC;IACL,CAAC;CACF;AArDD,oDAqDC"}

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

@@ -9,5 +9,6 @@ export * from './_models/control-models/cli-command-params.control-model';
 export * from './_collections/cli-commander.util';
 export * from './_collections/cli-envelope.util';
 export * from './_collections/cli-flag.util';
+export * from './_collections/cli-mcp-caller.util';
 export * from './_services/cli-program.control-service';
 //# sourceMappingURL=index.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/_modules/cli/index.ts"],"names":[],"mappings":"AAOA,cAAc,kCAAkC,CAAC;AACjD,cAAc,mCAAmC,CAAC;AAClD,cAAc,+BAA+B,CAAC;AAG9C,cAAc,mDAAmD,CAAC;AAClE,cAAc,6CAA6C,CAAC;AAC5D,cAAc,yCAAyC,CAAC;AACxD,cAAc,6CAA6C,CAAC;AAG5D,cAAc,2DAA2D,CAAC;AAG1E,cAAc,mCAAmC,CAAC;AAClD,cAAc,kCAAkC,CAAC;AACjD,cAAc,8BAA8B,CAAC;AAG7C,cAAc,yCAAyC,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/_modules/cli/index.ts"],"names":[],"mappings":"AAOA,cAAc,kCAAkC,CAAC;AACjD,cAAc,mCAAmC,CAAC;AAClD,cAAc,+BAA+B,CAAC;AAG9C,cAAc,mDAAmD,CAAC;AAClE,cAAc,6CAA6C,CAAC;AAC5D,cAAc,yCAAyC,CAAC;AACxD,cAAc,6CAA6C,CAAC;AAG5D,cAAc,2DAA2D,CAAC;AAG1E,cAAc,mCAAmC,CAAC;AAClD,cAAc,kCAAkC,CAAC;AACjD,cAAc,8BAA8B,CAAC;AAC7C,cAAc,oCAAoC,CAAC;AAGnD,cAAc,yCAAyC,CAAC"}

package/build/_modules/cli/index.js

@@ -19,6 +19,7 @@ tslib_1.__exportStar(require("./_models/control-models/cli-command-params.contro
 tslib_1.__exportStar(require("./_collections/cli-commander.util"), exports);
 tslib_1.__exportStar(require("./_collections/cli-envelope.util"), exports);
 tslib_1.__exportStar(require("./_collections/cli-flag.util"), exports);
+tslib_1.__exportStar(require("./_collections/cli-mcp-caller.util"), exports);
 // SERVICES
 tslib_1.__exportStar(require("./_services/cli-program.control-service"), exports);
 //# sourceMappingURL=index.js.map

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

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/_modules/cli/index.ts"],"names":[],"mappings":";AAEA,qHAAqH;AACrH,qHAAqH;AACrH,8DAA8D;;;AAE9D,QAAQ;AACR,2EAAiD;AACjD,4EAAkD;AAClD,wEAA8C;AAE9C,aAAa;AACb,4FAAkE;AAClE,sFAA4D;AAC5D,kFAAwD;AACxD,sFAA4D;AAE5D,iBAAiB;AACjB,oGAA0E;AAE1E,cAAc;AACd,4EAAkD;AAClD,2EAAiD;AACjD,uEAA6C;AAE7C,WAAW;AACX,kFAAwD"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/_modules/cli/index.ts"],"names":[],"mappings":";AAEA,qHAAqH;AACrH,qHAAqH;AACrH,8DAA8D;;;AAE9D,QAAQ;AACR,2EAAiD;AACjD,4EAAkD;AAClD,wEAA8C;AAE9C,aAAa;AACb,4FAAkE;AAClE,sFAA4D;AAC5D,kFAAwD;AACxD,sFAA4D;AAE5D,iBAAiB;AACjB,oGAA0E;AAE1E,cAAc;AACd,4EAAkD;AAClD,2EAAiD;AACjD,uEAA6C;AAC7C,6EAAmD;AAEnD,WAAW;AACX,kFAAwD"}

package/build/_modules/mcp/_collections/mcp-client.util.d.ts

@@ -0,0 +1,86 @@
+/** One MCP server call target. */
+export interface DyNTS_McpClient_Target {
+    /** The server base URL (e.g. `https://organizer.example.com/api`). */
+    baseUrl: string;
+    /** The MCP endpoint path under the base URL; default: `/mcp` (the `DyNTS_McpHttpEndpoint_Util` default). */
+    endpointPath?: string;
+    /** Sent as `Authorization: Bearer <apiKey>`. */
+    apiKey?: string;
+    /** Extra request headers. */
+    headers?: {
+        [name: string]: string;
+    };
+    /** The request timeout in milliseconds; default: 20 000 (the organizer `fo` client). */
+    timeoutMs?: number;
+}
+/** The outcome of a `tools/call`. */
+export interface DyNTS_McpClient_ToolResult {
+    /** The tool output: the first text block, parsed as JSON when it is JSON. */
+    data: unknown;
+    /** The non-fatal warnings of the call (the second `{ warnings }` block of a Dynamo MCP server). */
+    warnings: string[];
+}
+/** A tool as `tools/list` advertises it. */
+export interface DyNTS_McpClient_Tool {
+    /** The tool name. */
+    name: string;
+    /** The tool description. */
+    description?: string;
+    /** The JSON schema of the arguments. */
+    inputSchema?: {
+        [key: string]: unknown;
+    };
+}
+/**
+ * The standard MCP client (HP-DOPL MP-4.5, DMCP-015): `tools/list` and `tools/call` over Streamable HTTP with plain
+ * `fetch` — no SDK, so a CLI stays light. It replaces the hand-written JSON-RPC clients of the fleet (organizer `fo`,
+ * the CCAP probe) with one tested implementation.
+ *
+ * Every failure is a coded `DyFM_Error` with an HTTP-like status, so a CLI maps it to the right exit code:
+ * - the server answered non-2xx → that status (`DyNTS-MCC-HTP`);
+ * - a JSON-RPC error → `DyNTS_McpError_Util.statusOfCode` (`DyNTS-MCC-RPC`);
+ * - a tool error (`isError`) → the status of its code, its own `errorCode` and message kept;
+ * - the server could not be reached or timed out → no status, the network code kept on `error` (`DyNTS-MCC-NET`);
+ * - an unreadable answer → 502 (`DyNTS-MCC-RES`).
+ *
+ * @example
+ * ```ts
+ * const result: DyNTS_McpClient_ToolResult = await DyNTS_McpClient_Util.callTool({
+ *   baseUrl: 'https://organizer.example.com/api', apiKey: key, name: 'tasks.list', arguments: { projectId: 'p-1' },
+ * });
+ * ```
+ */
+export declare class DyNTS_McpClient_Util {
+    /**
+     * Lists the advertised tools.
+     * @param target - the server
+     */
+    static listTools(target: DyNTS_McpClient_Target): Promise<DyNTS_McpClient_Tool[]>;
+    /**
+     * Calls a tool.
+     * @param set - the server, the tool name and its arguments
+     * @throws a coded `DyFM_Error` — see the class description
+     */
+    static callTool(set: DyNTS_McpClient_Target & {
+        name: string;
+        arguments?: object;
+    }): Promise<DyNTS_McpClient_ToolResult>;
+    /**
+     * Sends one JSON-RPC request and returns its `result`.
+     * @param set - the server, the method and its params
+     * @throws a coded `DyFM_Error` — see the class description
+     */
+    static request(set: DyNTS_McpClient_Target & {
+        method: string;
+        params?: object;
+    }): Promise<unknown>;
+    /** The JSON-RPC message of an answer: a JSON body, or the last `data:` event of an SSE stream. */
+    private static parseBody;
+    /** A text parsed as JSON when it is JSON, else the text itself (`undefined` stays `undefined`). */
+    private static parseText;
+    /** The coded error of a tool error payload `{ ok: false, error: { code, message, errorCode } }`. */
+    private static toolError;
+    /** A coded client error. */
+    private static error;
+}
+//# sourceMappingURL=mcp-client.util.d.ts.map

package/build/_modules/mcp/_collections/mcp-client.util.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mcp-client.util.d.ts","sourceRoot":"","sources":["../../../../src/_modules/mcp/_collections/mcp-client.util.ts"],"names":[],"mappings":"AAMA,kCAAkC;AAClC,MAAM,WAAW,sBAAsB;IACrC,sEAAsE;IACtE,OAAO,EAAE,MAAM,CAAC;IAChB,4GAA4G;IAC5G,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,gDAAgD;IAChD,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,6BAA6B;IAC7B,OAAO,CAAC,EAAE;QAAE,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAAA;KAAE,CAAC;IACrC,wFAAwF;IACxF,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,qCAAqC;AACrC,MAAM,WAAW,0BAA0B;IACzC,6EAA6E;IAC7E,IAAI,EAAE,OAAO,CAAC;IACd,mGAAmG;IACnG,QAAQ,EAAE,MAAM,EAAE,CAAC;CACpB;AAED,4CAA4C;AAC5C,MAAM,WAAW,oBAAoB;IACnC,qBAAqB;IACrB,IAAI,EAAE,MAAM,CAAC;IACb,4BAA4B;IAC5B,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,wCAAwC;IACxC,WAAW,CAAC,EAAE;QAAE,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAA;KAAE,CAAC;CAC1C;AAKD;;;;;;;;;;;;;;;;;;GAkBG;AACH,qBAAa,oBAAoB;IAC/B;;;OAGG;WACU,SAAS,CAAC,MAAM,EAAE,sBAAsB,GAAG,OAAO,CAAC,oBAAoB,EAAE,CAAC;IAWvF;;;;OAIG;WACU,QAAQ,CAAC,GAAG,EAAE,sBAAsB,GAAG;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,SAAS,CAAC,EAAE,MAAM,CAAA;KAAE,GAAG,OAAO,CAAC,0BAA0B,CAAC;IAoB9H;;;;OAIG;WACU,OAAO,CAAC,GAAG,EAAE,sBAAsB,GAAG;QAAE,MAAM,EAAE,MAAM,CAAC;QAAC,MAAM,CAAC,EAAE,MAAM,CAAA;KAAE,GAAG,OAAO,CAAC,OAAO,CAAC;IA2DzG,kGAAkG;IAClG,OAAO,CAAC,MAAM,CAAC,SAAS;IAcxB,mGAAmG;IACnG,OAAO,CAAC,MAAM,CAAC,SAAS;IAYxB,oGAAoG;IACpG,OAAO,CAAC,MAAM,CAAC,SAAS;IAexB,4BAA4B;IAC5B,OAAO,CAAC,MAAM,CAAC,KAAK;CAerB"}

package/build/_modules/mcp/_collections/mcp-client.util.js

@@ -0,0 +1,169 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.DyNTS_McpClient_Util = void 0;
+const fsm_dynamo_1 = require("@futdevpro/fsm-dynamo");
+const global_settings_const_1 = require("../../../_collections/global-settings.const");
+const mcp_error_util_1 = require("./mcp-error.util");
+/** The JSON-RPC request id counter of the process. */
+let DyNTS_mcpClientRequestId = 0;
+/**
+ * The standard MCP client (HP-DOPL MP-4.5, DMCP-015): `tools/list` and `tools/call` over Streamable HTTP with plain
+ * `fetch` — no SDK, so a CLI stays light. It replaces the hand-written JSON-RPC clients of the fleet (organizer `fo`,
+ * the CCAP probe) with one tested implementation.
+ *
+ * Every failure is a coded `DyFM_Error` with an HTTP-like status, so a CLI maps it to the right exit code:
+ * - the server answered non-2xx → that status (`DyNTS-MCC-HTP`);
+ * - a JSON-RPC error → `DyNTS_McpError_Util.statusOfCode` (`DyNTS-MCC-RPC`);
+ * - a tool error (`isError`) → the status of its code, its own `errorCode` and message kept;
+ * - the server could not be reached or timed out → no status, the network code kept on `error` (`DyNTS-MCC-NET`);
+ * - an unreadable answer → 502 (`DyNTS-MCC-RES`).
+ *
+ * @example
+ * ```ts
+ * const result: DyNTS_McpClient_ToolResult = await DyNTS_McpClient_Util.callTool({
+ *   baseUrl: 'https://organizer.example.com/api', apiKey: key, name: 'tasks.list', arguments: { projectId: 'p-1' },
+ * });
+ * ```
+ */
+class DyNTS_McpClient_Util {
+    /**
+     * Lists the advertised tools.
+     * @param target - the server
+     */
+    static async listTools(target) {
+        const result = await DyNTS_McpClient_Util.request({ ...target, method: 'tools/list', params: {} });
+        if (!Array.isArray(result?.tools)) {
+            throw DyNTS_McpClient_Util.error({ code: 'DyNTS-MCC-RES', status: 502, message: 'tools/list answered without tools' });
+        }
+        return result.tools;
+    }
+    /**
+     * Calls a tool.
+     * @param set - the server, the tool name and its arguments
+     * @throws a coded `DyFM_Error` — see the class description
+     */
+    static async callTool(set) {
+        const result = await DyNTS_McpClient_Util.request({
+            ...set, method: 'tools/call', params: { name: set.name, arguments: set.arguments ?? {} },
+        });
+        const texts = (Array.isArray(result?.content) ? result.content : [])
+            .filter((block) => block?.type === 'text' && typeof block.text === 'string')
+            .map((block) => block.text);
+        const data = DyNTS_McpClient_Util.parseText(texts[0]);
+        if (result?.isError === true) {
+            throw DyNTS_McpClient_Util.toolError(set.name, data);
+        }
+        const second = DyNTS_McpClient_Util.parseText(texts[1]);
+        const warnings = Array.isArray(second?.warnings) ?
+            second.warnings.filter((warning) => typeof warning === 'string') : [];
+        return { data: data, warnings: warnings };
+    }
+    /**
+     * Sends one JSON-RPC request and returns its `result`.
+     * @param set - the server, the method and its params
+     * @throws a coded `DyFM_Error` — see the class description
+     */
+    static async request(set) {
+        const url = `${set.baseUrl?.replace(/\/+$/, '') ?? ''}${set.endpointPath ?? '/mcp'}`;
+        const controller = new AbortController();
+        const timer = setTimeout(() => controller.abort(), set.timeoutMs ?? 20000);
+        let response;
+        let text;
+        try {
+            response = await fetch(url, {
+                method: 'POST',
+                headers: {
+                    'content-type': 'application/json',
+                    // a Streamable HTTP server may answer with JSON or with an SSE stream
+                    'accept': 'application/json, text/event-stream',
+                    ...(set.apiKey ? { authorization: `Bearer ${set.apiKey}` } : {}),
+                    ...set.headers,
+                },
+                body: JSON.stringify({ jsonrpc: '2.0', id: ++DyNTS_mcpClientRequestId, method: set.method, params: set.params ?? {} }),
+                signal: controller.signal,
+            });
+            text = await response.text();
+        }
+        catch (error) {
+            const aborted = error?.name === 'AbortError';
+            const code = aborted ? 'ETIMEDOUT' : error?.cause?.code;
+            throw DyNTS_McpClient_Util.error({
+                code: 'DyNTS-MCC-NET',
+                message: aborted ? `the MCP server did not answer within ${set.timeoutMs ?? 20000} ms (${url})` :
+                    `the MCP server could not be reached (${url}${code ? `, ${code}` : ''})`,
+                cause: { code: code ?? 'ECONNREFUSED' },
+            });
+        }
+        finally {
+            clearTimeout(timer);
+        }
+        const body = DyNTS_McpClient_Util.parseBody(text, response.headers.get('content-type'));
+        if (!response.ok) {
+            throw DyNTS_McpClient_Util.error({
+                code: 'DyNTS-MCC-HTP', status: response.status,
+                message: `the MCP server answered HTTP ${response.status}${body?.error?.message ? `: ${body.error.message}` : ''}`,
+            });
+        }
+        if (!body || typeof body !== 'object') {
+            throw DyNTS_McpClient_Util.error({ code: 'DyNTS-MCC-RES', status: 502, message: `unreadable MCP answer from ${url}` });
+        }
+        if (body.error) {
+            throw DyNTS_McpClient_Util.error({
+                code: 'DyNTS-MCC-RPC', status: mcp_error_util_1.DyNTS_McpError_Util.statusOfCode(body.error.code),
+                message: `${set.method}: ${body.error.message ?? 'JSON-RPC error'} (${body.error.code})`,
+            });
+        }
+        return body.result;
+    }
+    /** The JSON-RPC message of an answer: a JSON body, or the last `data:` event of an SSE stream. */
+    static parseBody(text, contentType) {
+        if (contentType?.includes('text/event-stream')) {
+            const events = text.split(/\r?\n/)
+                .filter((line) => line.startsWith('data:'))
+                .map((line) => line.slice(5).trim());
+            return DyNTS_McpClient_Util.parseText(events[events.length - 1]);
+        }
+        return DyNTS_McpClient_Util.parseText(text);
+    }
+    /** A text parsed as JSON when it is JSON, else the text itself (`undefined` stays `undefined`). */
+    static parseText(text) {
+        if (text === undefined) {
+            return undefined;
+        }
+        try {
+            return JSON.parse(text);
+        }
+        catch {
+            return text;
+        }
+    }
+    /** The coded error of a tool error payload `{ ok: false, error: { code, message, errorCode } }`. */
+    static toolError(tool, payload) {
+        const failure = payload?.error ?? {};
+        const message = typeof failure.message === 'string' && failure.message ?
+            failure.message : `the tool "${tool}" failed`;
+        return new fsm_dynamo_1.DyFM_Error({
+            status: mcp_error_util_1.DyNTS_McpError_Util.statusOfCode(failure.code),
+            errorCode: failure.errorCode || `${global_settings_const_1.DyNTS_global_settings.systemShortCodeName}|DyNTS-MCC-TOL`,
+            message: message,
+            userMessage: message,
+            additionalContent: { tool: tool, jsonRpcCode: failure.code },
+        });
+    }
+    /** A coded client error. */
+    static error(set) {
+        const error = new fsm_dynamo_1.DyFM_Error({
+            status: set.status,
+            errorCode: `${global_settings_const_1.DyNTS_global_settings.systemShortCodeName}|${set.code}`,
+            message: set.message,
+            userMessage: set.message,
+        });
+        // the network code of an unreachable server, where a CLI looks for it (`DyCLI_Command_Params.exitCodeOf`)
+        if (set.cause) {
+            error.cause = set.cause;
+        }
+        return error;
+    }
+}
+exports.DyNTS_McpClient_Util = DyNTS_McpClient_Util;
+//# sourceMappingURL=mcp-client.util.js.map

package/build/_modules/mcp/_collections/mcp-client.util.js.map

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

package/build/_modules/mcp/_collections/mcp-error.util.d.ts

@@ -30,6 +30,13 @@ export declare class DyNTS_McpError_Util {
      * @param status - the HTTP status of a `DyFM_Error`
      */
     static codeOfStatus(status: number | undefined): DyNTS_McpErrorCode_Type;
+    /**
+     * The HTTP-like status of a JSON-RPC error code — the inverse of `codeOfStatus`, for a CLIENT that turns an MCP error
+     * back into a coded error (HP-DOPL MP-4.5): invalid params → 400 · method not found → 404 · forbidden → 403 ·
+     * conflict → 409 · internal → 500 · any other code → 502 (the server answered with something unknown).
+     * @param code - the JSON-RPC error code
+     */
+    static statusOfCode(code: number | undefined): number;
     /** A generic, caller-safe label of a code. */
     private static labelOf;
     /** Drops the undefined fields, so the serialized data stays compact. */

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

@@ -1 +1 @@
-{"version":3,"file":"mcp-error.util.d.ts","sourceRoot":"","sources":["../../../../src/_modules/mcp/_collections/mcp-error.util.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,uBAAuB,EAAE,MAAM,oCAAoC,CAAC;AAI7E,OAAO,EAAE,sBAAsB,EAAE,MAAM,oDAAoD,CAAC;AAG5F;;;;;;;;;;;;GAYG;AACH,qBAAa,mBAAmB;IAC9B;;;;;OAKG;IACH,MAAM,CAAC,cAAc,CAAC,GAAG,EAAE;QAAE,KAAK,EAAE,OAAO,CAAC;QAAC,MAAM,CAAC,EAAE,MAAM,CAAC;QAAC,YAAY,CAAC,EAAE,MAAM,EAAE,CAAA;KAAE,GAAG,sBAAsB;IAwChH;;;OAGG;IACH,MAAM,CAAC,YAAY,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,GAAG,uBAAuB;IAgBxE,8CAA8C;IAC9C,OAAO,CAAC,MAAM,CAAC,OAAO;IAetB,wEAAwE;IACxE,OAAO,CAAC,MAAM,CAAC,gBAAgB;CAShC"}
+{"version":3,"file":"mcp-error.util.d.ts","sourceRoot":"","sources":["../../../../src/_modules/mcp/_collections/mcp-error.util.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,uBAAuB,EAAE,MAAM,oCAAoC,CAAC;AAI7E,OAAO,EAAE,sBAAsB,EAAE,MAAM,oDAAoD,CAAC;AAG5F;;;;;;;;;;;;GAYG;AACH,qBAAa,mBAAmB;IAC9B;;;;;OAKG;IACH,MAAM,CAAC,cAAc,CAAC,GAAG,EAAE;QAAE,KAAK,EAAE,OAAO,CAAC;QAAC,MAAM,CAAC,EAAE,MAAM,CAAC;QAAC,YAAY,CAAC,EAAE,MAAM,EAAE,CAAA;KAAE,GAAG,sBAAsB;IAwChH;;;OAGG;IACH,MAAM,CAAC,YAAY,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,GAAG,uBAAuB;IAgBxE;;;;;OAKG;IACH,MAAM,CAAC,YAAY,CAAC,IAAI,EAAE,MAAM,GAAG,SAAS,GAAG,MAAM;IAiBrD,8CAA8C;IAC9C,OAAO,CAAC,MAAM,CAAC,OAAO;IAetB,wEAAwE;IACxE,OAAO,CAAC,MAAM,CAAC,gBAAgB;CAShC"}

package/build/_modules/mcp/_collections/mcp-error.util.js

@@ -74,6 +74,28 @@ class DyNTS_McpError_Util {
         }
         return mcp_error_code_type_enum_1.DyNTS_McpErrorCode_Type.internal;
     }
+    /**
+     * The HTTP-like status of a JSON-RPC error code — the inverse of `codeOfStatus`, for a CLIENT that turns an MCP error
+     * back into a coded error (HP-DOPL MP-4.5): invalid params → 400 · method not found → 404 · forbidden → 403 ·
+     * conflict → 409 · internal → 500 · any other code → 502 (the server answered with something unknown).
+     * @param code - the JSON-RPC error code
+     */
+    static statusOfCode(code) {
+        switch (code) {
+            case mcp_error_code_type_enum_1.DyNTS_McpErrorCode_Type.invalidParams:
+                return 400;
+            case mcp_error_code_type_enum_1.DyNTS_McpErrorCode_Type.methodNotFound:
+                return 404;
+            case mcp_error_code_type_enum_1.DyNTS_McpErrorCode_Type.forbidden:
+                return 403;
+            case mcp_error_code_type_enum_1.DyNTS_McpErrorCode_Type.conflict:
+                return 409;
+            case mcp_error_code_type_enum_1.DyNTS_McpErrorCode_Type.internal:
+                return 500;
+            default:
+                return 502;
+        }
+    }
     /** A generic, caller-safe label of a code. */
     static labelOf(code) {
         switch (code) {

package/build/_modules/mcp/_collections/mcp-error.util.js.map

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

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

@@ -12,6 +12,7 @@ export * from './_models/errors/mcp-internal.error';
 export * from './_models/errors/mcp-invalid-params.error';
 export * from './_models/errors/mcp-method-not-found.error';
 export * from './_models/control-models/mcp-tool-params.control-model';
+export * from './_collections/mcp-client.util';
 export * from './_collections/mcp-error.util';
 export * from './_collections/mcp-http-endpoint.util';
 export * from './_collections/mcp-ref.util';

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/_modules/mcp/index.ts"],"names":[],"mappings":"AAQA,cAAc,mCAAmC,CAAC;AAClD,cAAc,sCAAsC,CAAC;AAGrD,cAAc,0CAA0C,CAAC;AACzD,cAAc,+CAA+C,CAAC;AAC9D,cAAc,mDAAmD,CAAC;AAClE,cAAc,6CAA6C,CAAC;AAC5D,cAAc,0DAA0D,CAAC;AAGzE,cAAc,iCAAiC,CAAC;AAChD,cAAc,qCAAqC,CAAC;AACpD,cAAc,sCAAsC,CAAC;AACrD,cAAc,qCAAqC,CAAC;AACpD,cAAc,2CAA2C,CAAC;AAC1D,cAAc,6CAA6C,CAAC;AAG5D,cAAc,wDAAwD,CAAC;AAGvE,cAAc,+BAA+B,CAAC;AAC9C,cAAc,uCAAuC,CAAC;AACtD,cAAc,6BAA6B,CAAC;AAC5C,cAAc,yCAAyC,CAAC;AACxD,cAAc,mCAAmC,CAAC;AAGlD,cAAc,+BAA+B,CAAC;AAC9C,cAAc,qCAAqC,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/_modules/mcp/index.ts"],"names":[],"mappings":"AAQA,cAAc,mCAAmC,CAAC;AAClD,cAAc,sCAAsC,CAAC;AAGrD,cAAc,0CAA0C,CAAC;AACzD,cAAc,+CAA+C,CAAC;AAC9D,cAAc,mDAAmD,CAAC;AAClE,cAAc,6CAA6C,CAAC;AAC5D,cAAc,0DAA0D,CAAC;AAGzE,cAAc,iCAAiC,CAAC;AAChD,cAAc,qCAAqC,CAAC;AACpD,cAAc,sCAAsC,CAAC;AACrD,cAAc,qCAAqC,CAAC;AACpD,cAAc,2CAA2C,CAAC;AAC1D,cAAc,6CAA6C,CAAC;AAG5D,cAAc,wDAAwD,CAAC;AAGvE,cAAc,gCAAgC,CAAC;AAC/C,cAAc,+BAA+B,CAAC;AAC9C,cAAc,uCAAuC,CAAC;AACtD,cAAc,6BAA6B,CAAC;AAC5C,cAAc,yCAAyC,CAAC;AACxD,cAAc,mCAAmC,CAAC;AAGlD,cAAc,+BAA+B,CAAC;AAC9C,cAAc,qCAAqC,CAAC"}

package/build/_modules/mcp/index.js

@@ -24,6 +24,7 @@ tslib_1.__exportStar(require("./_models/errors/mcp-method-not-found.error"), exp
 // CONTROL MODELS
 tslib_1.__exportStar(require("./_models/control-models/mcp-tool-params.control-model"), exports);
 // COLLECTIONS
+tslib_1.__exportStar(require("./_collections/mcp-client.util"), exports);
 tslib_1.__exportStar(require("./_collections/mcp-error.util"), exports);
 tslib_1.__exportStar(require("./_collections/mcp-http-endpoint.util"), exports);
 tslib_1.__exportStar(require("./_collections/mcp-ref.util"), exports);

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

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/_modules/mcp/index.ts"],"names":[],"mappings":";AAEA,iGAAiG;AACjG,6FAA6F;AAC7F,4GAA4G;AAC5G,kGAAkG;;;AAElG,QAAQ;AACR,4EAAkD;AAClD,+EAAqD;AAErD,aAAa;AACb,mFAAyD;AACzD,wFAA8D;AAC9D,4FAAkE;AAClE,sFAA4D;AAC5D,mGAAyE;AAEzE,SAAS;AACT,0EAAgD;AAChD,8EAAoD;AACpD,+EAAqD;AACrD,8EAAoD;AACpD,oFAA0D;AAC1D,sFAA4D;AAE5D,iBAAiB;AACjB,iGAAuE;AAEvE,cAAc;AACd,wEAA8C;AAC9C,gFAAsD;AACtD,sEAA4C;AAC5C,kFAAwD;AACxD,4EAAkD;AAElD,WAAW;AACX,wEAA8C;AAC9C,8EAAoD"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/_modules/mcp/index.ts"],"names":[],"mappings":";AAEA,iGAAiG;AACjG,6FAA6F;AAC7F,4GAA4G;AAC5G,kGAAkG;;;AAElG,QAAQ;AACR,4EAAkD;AAClD,+EAAqD;AAErD,aAAa;AACb,mFAAyD;AACzD,wFAA8D;AAC9D,4FAAkE;AAClE,sFAA4D;AAC5D,mGAAyE;AAEzE,SAAS;AACT,0EAAgD;AAChD,8EAAoD;AACpD,+EAAqD;AACrD,8EAAoD;AACpD,oFAA0D;AAC1D,sFAA4D;AAE5D,iBAAiB;AACjB,iGAAuE;AAEvE,cAAc;AACd,yEAA+C;AAC/C,wEAA8C;AAC9C,gFAAsD;AACtD,sEAA4C;AAC5C,kFAAwD;AACxD,4EAAkD;AAElD,WAAW;AACX,wEAA8C;AAC9C,8EAAoD"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@futdevpro/nts-dynamo",
-  "version": "01.15.308",
+  "version": "01.15.309",
   "description": "Dynamic NodeTS (NodeJS-Typescript), MongoDB Backend System Framework by Future Development Program Ltd.",
   "DyBu_settings": {
     "packageType": "server-package",