@futdevpro/nts-dynamo 1.15.293 → 1.15.296

package/build/_collections/global-settings.const.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"global-settings.const.d.ts","sourceRoot":"","sources":["../../src/_collections/global-settings.const.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,qBAAqB,EAAE,MAAM,iDAAiD,CAAC;AAIxF;;;GAGG;AACH,eAAO,MAAM,qBAAqB,EAAE,qBA+HnC,CAAC"}
+{"version":3,"file":"global-settings.const.d.ts","sourceRoot":"","sources":["../../src/_collections/global-settings.const.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,qBAAqB,EAAE,MAAM,iDAAiD,CAAC;AAIxF;;;GAGG;AACH,eAAO,MAAM,qBAAqB,EAAE,qBAiInC,CAAC"}

package/build/_collections/global-settings.const.js

@@ -57,6 +57,7 @@ exports.DyNTS_global_settings = {
         optional: false,
     },
     bot_settings: null,
+    mcp_settings: null,
     openAi_settings: null,
     dias_settings: null,
     assistant_settings: null,

package/build/_collections/global-settings.const.js.map

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

package/build/_models/interfaces/global-settings.interface.d.ts

@@ -4,6 +4,7 @@ import { DyNTS_AppVersionHeader_Settings } from './app-version-header-settings.i
 import { DyNTS_Environment_Settings } from './environment-settings.interface';
 import { DyNTS_GlobalLog_Settings } from './global-log-settings.interface';
 import { DyNTS_SecurityHeaders_Settings } from './security-headers-settings.interface';
+import type { DyNTS_Mcp_Settings } from '../../_modules/mcp/_models/interfaces/mcp-settings.interface';
 /**
  *
  *
@@ -112,6 +113,11 @@ export interface DyNTS_Global_Settings {
      * default settings: {@link DyNTS_Bot_Global_Settings}
      */
     bot_settings: any;
+    /**
+     * Server-wide MCP defaults (HP-DOPL MP-3.2): tool-name prefix, read-only server, heavy-tool load protection.
+     * `null` (default) = every field takes its documented default ({@link DyNTS_Mcp_Settings}).
+     */
+    mcp_settings: DyNTS_Mcp_Settings | null;
     /**
      * this setting will set the openai settings
      * (this will be set in the {@link DyNTS_OAI_LLMChat_ServiceBase} constructor)

package/build/_models/interfaces/global-settings.interface.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"global-settings.interface.d.ts","sourceRoot":"","sources":["../../../src/_models/interfaces/global-settings.interface.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"global-settings.interface.d.ts","sourceRoot":"","sources":["../../../src/_models/interfaces/global-settings.interface.ts"],"names":[],"mappings":"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"}

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

@@ -0,0 +1,38 @@
+import { DyNTS_McpErrorCode_Type } from '../_enums/mcp-error-code.type-enum';
+import { DyNTS_Mcp_JsonRpcError } from '../_models/interfaces/mcp-json-rpc-error.interface';
+/**
+ * Turns any error into a caller-safe JSON-RPC error of the MCP layer (HP-DOPL MP-3.6, DMCP-006) — lifted from the
+ * organizer `Mcp_Controller.toJsonRpcError`, including its measured leak fix (`TD-20260817-003`: an internal provider
+ * message carried an API key prefix into the response).
+ *
+ * - `DyNTS_Mcp_*Error` → its own code, message and data (written for the caller);
+ * - `DyFM_Error` → the code from its HTTP status (400/404/422 invalid params · 401/403 forbidden ·
+ *   409/412/428 conflict · otherwise internal); the message is the `__userMessage` or a generic text with the error
+ *   code — ⛔ the internal `_message` is NEVER sent (neither as `message` nor inside `data`);
+ * - any other `Error` / value → internal error with a generic message (the detail stays in the server log).
+ *
+ * ⭐ To give an agent a helpful text for a `DyFM_Error`, set its `userMessage`.
+ */
+export declare class DyNTS_McpError_Util {
+    /**
+     * Builds the JSON-RPC error of an MCP call.
+     * @param set.error - the thrown error
+     * @param set.method - the called tool / method name
+     * @param set.validMethods - the valid method names, added to a method-not-found error
+     */
+    static toJsonRpcError(set: {
+        error: unknown;
+        method?: string;
+        validMethods?: string[];
+    }): DyNTS_Mcp_JsonRpcError;
+    /**
+     * The JSON-RPC code of an HTTP status — the same rejection on REST and MCP (DMCP-012 parity).
+     * @param status - the HTTP status of a `DyFM_Error`
+     */
+    static codeOfStatus(status: number | undefined): DyNTS_McpErrorCode_Type;
+    /** A generic, caller-safe label of a code. */
+    private static labelOf;
+    /** Drops the undefined fields, so the serialized data stays compact. */
+    private static withoutUndefined;
+}
+//# sourceMappingURL=mcp-error.util.d.ts.map

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

@@ -0,0 +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"}

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

@@ -0,0 +1,103 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.DyNTS_McpError_Util = void 0;
+const fsm_dynamo_1 = require("@futdevpro/fsm-dynamo");
+const mcp_error_code_type_enum_1 = require("../_enums/mcp-error-code.type-enum");
+const mcp_error_base_1 = require("../_models/errors/mcp.error-base");
+const mcp_method_not_found_error_1 = require("../_models/errors/mcp-method-not-found.error");
+/**
+ * Turns any error into a caller-safe JSON-RPC error of the MCP layer (HP-DOPL MP-3.6, DMCP-006) — lifted from the
+ * organizer `Mcp_Controller.toJsonRpcError`, including its measured leak fix (`TD-20260817-003`: an internal provider
+ * message carried an API key prefix into the response).
+ *
+ * - `DyNTS_Mcp_*Error` → its own code, message and data (written for the caller);
+ * - `DyFM_Error` → the code from its HTTP status (400/404/422 invalid params · 401/403 forbidden ·
+ *   409/412/428 conflict · otherwise internal); the message is the `__userMessage` or a generic text with the error
+ *   code — ⛔ the internal `_message` is NEVER sent (neither as `message` nor inside `data`);
+ * - any other `Error` / value → internal error with a generic message (the detail stays in the server log).
+ *
+ * ⭐ To give an agent a helpful text for a `DyFM_Error`, set its `userMessage`.
+ */
+class DyNTS_McpError_Util {
+    /**
+     * Builds the JSON-RPC error of an MCP call.
+     * @param set.error - the thrown error
+     * @param set.method - the called tool / method name
+     * @param set.validMethods - the valid method names, added to a method-not-found error
+     */
+    static toJsonRpcError(set) {
+        const error = set.error;
+        if (error instanceof mcp_error_base_1.DyNTS_Mcp_ErrorBase) {
+            const data = {
+                message: error.message,
+                userMessage: error.message,
+                ...error.data,
+                method: error.data?.method ?? set.method,
+            };
+            if (error instanceof mcp_method_not_found_error_1.DyNTS_Mcp_MethodNotFoundError && !data.validMethods && set.validMethods) {
+                data.validMethods = [...set.validMethods];
+            }
+            return { code: error.code, message: error.message, data: DyNTS_McpError_Util.withoutUndefined(data) };
+        }
+        if (error instanceof fsm_dynamo_1.DyFM_Error) {
+            const code = DyNTS_McpError_Util.codeOfStatus(error.___status);
+            const errorCode = error._errorCode || undefined;
+            const message = error.__userMessage ??
+                `${DyNTS_McpError_Util.labelOf(code)}${errorCode ? ` (${errorCode})` : ''}`;
+            return {
+                code: code,
+                message: message,
+                data: DyNTS_McpError_Util.withoutUndefined({
+                    message: message, userMessage: error.__userMessage, errorCode: errorCode, method: set.method,
+                }),
+            };
+        }
+        return {
+            code: mcp_error_code_type_enum_1.DyNTS_McpErrorCode_Type.internal,
+            message: 'Internal error',
+            data: DyNTS_McpError_Util.withoutUndefined({ message: 'Internal error', method: set.method }),
+        };
+    }
+    /**
+     * The JSON-RPC code of an HTTP status — the same rejection on REST and MCP (DMCP-012 parity).
+     * @param status - the HTTP status of a `DyFM_Error`
+     */
+    static codeOfStatus(status) {
+        if (status === 400 || status === 404 || status === 422) {
+            return mcp_error_code_type_enum_1.DyNTS_McpErrorCode_Type.invalidParams;
+        }
+        if (status === 401 || status === 403) {
+            return mcp_error_code_type_enum_1.DyNTS_McpErrorCode_Type.forbidden;
+        }
+        if (status === 409 || status === 412 || status === 428) {
+            return mcp_error_code_type_enum_1.DyNTS_McpErrorCode_Type.conflict;
+        }
+        return mcp_error_code_type_enum_1.DyNTS_McpErrorCode_Type.internal;
+    }
+    /** A generic, caller-safe label of a code. */
+    static labelOf(code) {
+        switch (code) {
+            case mcp_error_code_type_enum_1.DyNTS_McpErrorCode_Type.invalidParams:
+                return 'Invalid params';
+            case mcp_error_code_type_enum_1.DyNTS_McpErrorCode_Type.forbidden:
+                return 'Forbidden';
+            case mcp_error_code_type_enum_1.DyNTS_McpErrorCode_Type.conflict:
+                return 'Conflict';
+            case mcp_error_code_type_enum_1.DyNTS_McpErrorCode_Type.methodNotFound:
+                return 'Method not found';
+            default:
+                return 'Internal error';
+        }
+    }
+    /** Drops the undefined fields, so the serialized data stays compact. */
+    static withoutUndefined(data) {
+        Object.keys(data).forEach((key) => {
+            if (data[key] === undefined) {
+                delete data[key];
+            }
+        });
+        return data;
+    }
+}
+exports.DyNTS_McpError_Util = DyNTS_McpError_Util;
+//# sourceMappingURL=mcp-error.util.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"mcp-error.util.js","sourceRoot":"","sources":["../../../../src/_modules/mcp/_collections/mcp-error.util.ts"],"names":[],"mappings":";;;AAAA,sDAAmD;AAEnD,iFAA6E;AAC7E,qEAAuE;AACvE,6FAA6F;AAK7F;;;;;;;;;;;;GAYG;AACH,MAAa,mBAAmB;IAC9B;;;;;OAKG;IACH,MAAM,CAAC,cAAc,CAAC,GAAiE;QACrF,MAAM,KAAK,GAAY,GAAG,CAAC,KAAK,CAAC;QAEjC,IAAI,KAAK,YAAY,oCAAmB,EAAE,CAAC;YACzC,MAAM,IAAI,GAAwB;gBAChC,OAAO,EAAE,KAAK,CAAC,OAAO;gBACtB,WAAW,EAAE,KAAK,CAAC,OAAO;gBAC1B,GAAG,KAAK,CAAC,IAAI;gBACb,MAAM,EAAE,KAAK,CAAC,IAAI,EAAE,MAAM,IAAI,GAAG,CAAC,MAAM;aACzC,CAAC;YAEF,IAAI,KAAK,YAAY,0DAA6B,IAAI,CAAC,IAAI,CAAC,YAAY,IAAI,GAAG,CAAC,YAAY,EAAE,CAAC;gBAC7F,IAAI,CAAC,YAAY,GAAG,CAAE,GAAG,GAAG,CAAC,YAAY,CAAE,CAAC;YAC9C,CAAC;YAED,OAAO,EAAE,IAAI,EAAE,KAAK,CAAC,IAAI,EAAE,OAAO,EAAE,KAAK,CAAC,OAAO,EAAE,IAAI,EAAE,mBAAmB,CAAC,gBAAgB,CAAC,IAAI,CAAC,EAAE,CAAC;QACxG,CAAC;QAED,IAAI,KAAK,YAAY,uBAAU,EAAE,CAAC;YAChC,MAAM,IAAI,GAA4B,mBAAmB,CAAC,YAAY,CAAC,KAAK,CAAC,SAAS,CAAC,CAAC;YACxF,MAAM,SAAS,GAAuB,KAAK,CAAC,UAAU,IAAI,SAAS,CAAC;YACpE,MAAM,OAAO,GAAW,KAAK,CAAC,aAAa;gBACzC,GAAG,mBAAmB,CAAC,OAAO,CAAC,IAAI,CAAC,GAAG,SAAS,CAAC,CAAC,CAAC,KAAK,SAAS,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC;YAE9E,OAAO;gBACL,IAAI,EAAE,IAAI;gBACV,OAAO,EAAE,OAAO;gBAChB,IAAI,EAAE,mBAAmB,CAAC,gBAAgB,CAAC;oBACzC,OAAO,EAAE,OAAO,EAAE,WAAW,EAAE,KAAK,CAAC,aAAa,EAAE,SAAS,EAAE,SAAS,EAAE,MAAM,EAAE,GAAG,CAAC,MAAM;iBAC7F,CAAC;aACH,CAAC;QACJ,CAAC;QAED,OAAO;YACL,IAAI,EAAE,kDAAuB,CAAC,QAAQ;YACtC,OAAO,EAAE,gBAAgB;YACzB,IAAI,EAAE,mBAAmB,CAAC,gBAAgB,CAAC,EAAE,OAAO,EAAE,gBAAgB,EAAE,MAAM,EAAE,GAAG,CAAC,MAAM,EAAE,CAAC;SAC9F,CAAC;IACJ,CAAC;IAED;;;OAGG;IACH,MAAM,CAAC,YAAY,CAAC,MAA0B;QAC5C,IAAI,MAAM,KAAK,GAAG,IAAI,MAAM,KAAK,GAAG,IAAI,MAAM,KAAK,GAAG,EAAE,CAAC;YACvD,OAAO,kDAAuB,CAAC,aAAa,CAAC;QAC/C,CAAC;QAED,IAAI,MAAM,KAAK,GAAG,IAAI,MAAM,KAAK,GAAG,EAAE,CAAC;YACrC,OAAO,kDAAuB,CAAC,SAAS,CAAC;QAC3C,CAAC;QAED,IAAI,MAAM,KAAK,GAAG,IAAI,MAAM,KAAK,GAAG,IAAI,MAAM,KAAK,GAAG,EAAE,CAAC;YACvD,OAAO,kDAAuB,CAAC,QAAQ,CAAC;QAC1C,CAAC;QAED,OAAO,kDAAuB,CAAC,QAAQ,CAAC;IAC1C,CAAC;IAED,8CAA8C;IACtC,MAAM,CAAC,OAAO,CAAC,IAA6B;QAClD,QAAQ,IAAI,EAAE,CAAC;YACb,KAAK,kDAAuB,CAAC,aAAa;gBACxC,OAAO,gBAAgB,CAAC;YAC1B,KAAK,kDAAuB,CAAC,SAAS;gBACpC,OAAO,WAAW,CAAC;YACrB,KAAK,kDAAuB,CAAC,QAAQ;gBACnC,OAAO,UAAU,CAAC;YACpB,KAAK,kDAAuB,CAAC,cAAc;gBACzC,OAAO,kBAAkB,CAAC;YAC5B;gBACE,OAAO,gBAAgB,CAAC;QAC5B,CAAC;IACH,CAAC;IAED,wEAAwE;IAChE,MAAM,CAAC,gBAAgB,CAAC,IAAyB;QACvD,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,OAAO,CAAC,CAAC,GAAW,EAAQ,EAAE;YAC9C,IAAK,IAA2C,CAAC,GAAG,CAAC,KAAK,SAAS,EAAE,CAAC;gBACpE,OAAQ,IAA2C,CAAC,GAAG,CAAC,CAAC;YAC3D,CAAC;QACH,CAAC,CAAC,CAAC;QAEH,OAAO,IAAI,CAAC;IACd,CAAC;CACF;AA7FD,kDA6FC"}

package/build/_modules/mcp/_collections/mcp-tool-load.util.d.ts

@@ -0,0 +1,46 @@
+import { DyNTS_McpTool_Params } from '../_models/control-models/mcp-tool-params.control-model';
+import { DyNTS_Mcp_Settings } from '../_models/interfaces/mcp-settings.interface';
+/**
+ * Load protection of MCP tool calls (HP-DOPL MP-3.2, DMCP-013) — the FAM `assertHeapCapacity` +
+ * `FAM_OperationQueue_Service` pattern at bedrock level. Only HEAVY tools (`DyNTS_McpTool_Params.isHeavy`) are guarded;
+ * a light call runs immediately.
+ *
+ * For a heavy call, in this order:
+ * 1. **load shed** — while the installed `DyNTS_MemoryGuard` reports critical pressure the call is rejected with 503
+ *    `DyNTS-MTL-SHD` (retryable), so a new heavy job does not push a strained heap into OOM;
+ * 2. **serialization** — at most `mcp_settings.heavyToolConcurrency` (default 1) heavy calls run at once; the rest
+ *    wait in FIFO order. A failed call releases its slot too.
+ *
+ * @example
+ * ```ts
+ * const result: unknown = await DyNTS_McpToolLoad_Util.run(scanTool, () => scanTool.operation.run(ctx, path));
+ * ```
+ */
+export declare class DyNTS_McpToolLoad_Util {
+    /** Heavy calls running now. */
+    private static running;
+    /** Resolvers of the heavy calls waiting for a slot (FIFO). */
+    private static readonly waiters;
+    /**
+     * Runs the task with the load protection of the tool.
+     * @param tool - the tool being called
+     * @param task - the call itself
+     * @param settings - the MCP settings (default: `DyNTS_global_settings.mcp_settings`)
+     * @throws 503 `DyNTS-MTL-SHD` when a heavy call is shed under memory pressure
+     */
+    static run<T>(tool: DyNTS_McpTool_Params, task: () => Promise<T>, settings?: DyNTS_Mcp_Settings | null): Promise<T>;
+    /** Heavy calls running and waiting — for health endpoints and specs. */
+    static stats(): {
+        running: number;
+        queued: number;
+    };
+    /** Rejects a heavy call while the installed memory guard wants to shed load. */
+    private static assertMemoryCapacity;
+    /** Waits for a heavy slot (FIFO). */
+    private static acquire;
+    /** Hands the slot to the next waiter, or frees it. */
+    private static release;
+    /** The heavy concurrency limit (at least 1). */
+    private static limit;
+}
+//# sourceMappingURL=mcp-tool-load.util.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"mcp-tool-load.util.d.ts","sourceRoot":"","sources":["../../../../src/_modules/mcp/_collections/mcp-tool-load.util.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,oBAAoB,EAAE,MAAM,yDAAyD,CAAC;AAC/F,OAAO,EAAE,kBAAkB,EAAE,MAAM,8CAA8C,CAAC;AAGlF;;;;;;;;;;;;;;;GAeG;AACH,qBAAa,sBAAsB;IACjC,+BAA+B;IAC/B,OAAO,CAAC,MAAM,CAAC,OAAO,CAAa;IAEnC,8DAA8D;IAC9D,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,OAAO,CAAsB;IAErD;;;;;;OAMG;WACU,GAAG,CAAC,CAAC,EAChB,IAAI,EAAE,oBAAoB,EAC1B,IAAI,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,EACtB,QAAQ,GAAE,kBAAkB,GAAG,IAAyC,GACvE,OAAO,CAAC,CAAC,CAAC;IAgBb,wEAAwE;IACxE,MAAM,CAAC,KAAK,IAAI;QAAE,OAAO,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE;IAInD,gFAAgF;IAChF,OAAO,CAAC,MAAM,CAAC,oBAAoB;IAenC,qCAAqC;mBAChB,OAAO;IAa5B,sDAAsD;IACtD,OAAO,CAAC,MAAM,CAAC,OAAO;IAYtB,gDAAgD;IAChD,OAAO,CAAC,MAAM,CAAC,KAAK;CAGrB"}

package/build/_modules/mcp/_collections/mcp-tool-load.util.js

@@ -0,0 +1,93 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.DyNTS_McpToolLoad_Util = void 0;
+const fsm_dynamo_1 = require("@futdevpro/fsm-dynamo");
+const global_settings_const_1 = require("../../../_collections/global-settings.const");
+const memory_guard_service_1 = require("../../../_services/core/memory-guard.service");
+/**
+ * Load protection of MCP tool calls (HP-DOPL MP-3.2, DMCP-013) — the FAM `assertHeapCapacity` +
+ * `FAM_OperationQueue_Service` pattern at bedrock level. Only HEAVY tools (`DyNTS_McpTool_Params.isHeavy`) are guarded;
+ * a light call runs immediately.
+ *
+ * For a heavy call, in this order:
+ * 1. **load shed** — while the installed `DyNTS_MemoryGuard` reports critical pressure the call is rejected with 503
+ *    `DyNTS-MTL-SHD` (retryable), so a new heavy job does not push a strained heap into OOM;
+ * 2. **serialization** — at most `mcp_settings.heavyToolConcurrency` (default 1) heavy calls run at once; the rest
+ *    wait in FIFO order. A failed call releases its slot too.
+ *
+ * @example
+ * ```ts
+ * const result: unknown = await DyNTS_McpToolLoad_Util.run(scanTool, () => scanTool.operation.run(ctx, path));
+ * ```
+ */
+class DyNTS_McpToolLoad_Util {
+    /** Heavy calls running now. */
+    static running = 0;
+    /** Resolvers of the heavy calls waiting for a slot (FIFO). */
+    static waiters = [];
+    /**
+     * Runs the task with the load protection of the tool.
+     * @param tool - the tool being called
+     * @param task - the call itself
+     * @param settings - the MCP settings (default: `DyNTS_global_settings.mcp_settings`)
+     * @throws 503 `DyNTS-MTL-SHD` when a heavy call is shed under memory pressure
+     */
+    static async run(tool, task, settings = global_settings_const_1.DyNTS_global_settings.mcp_settings) {
+        if (!tool.isHeavy) {
+            return task();
+        }
+        DyNTS_McpToolLoad_Util.assertMemoryCapacity(tool, settings);
+        await DyNTS_McpToolLoad_Util.acquire(settings);
+        try {
+            return await task();
+        }
+        finally {
+            DyNTS_McpToolLoad_Util.release(settings);
+        }
+    }
+    /** Heavy calls running and waiting — for health endpoints and specs. */
+    static stats() {
+        return { running: DyNTS_McpToolLoad_Util.running, queued: DyNTS_McpToolLoad_Util.waiters.length };
+    }
+    /** Rejects a heavy call while the installed memory guard wants to shed load. */
+    static assertMemoryCapacity(tool, settings) {
+        const guard = memory_guard_service_1.DyNTS_MemoryGuard.getInstance();
+        if (settings?.shedHeavyToolsUnderMemoryPressure === false || !guard.isInstalled() || !guard.shouldShedLoad()) {
+            return;
+        }
+        throw new fsm_dynamo_1.DyFM_Error({
+            status: 503,
+            errorCode: `${global_settings_const_1.DyNTS_global_settings.systemShortCodeName}|DyNTS-MTL-SHD`,
+            message: `heavy MCP tool "${tool.tool}" rejected under memory pressure - retry when the pressure eases`,
+            additionalContent: { tool: tool.tool, pressure: guard.pressure() },
+        });
+    }
+    /** Waits for a heavy slot (FIFO). */
+    static async acquire(settings) {
+        if (DyNTS_McpToolLoad_Util.running < DyNTS_McpToolLoad_Util.limit(settings)) {
+            DyNTS_McpToolLoad_Util.running++;
+            return;
+        }
+        // the slot is handed over by release(), so `running` already counts this call when it resumes
+        await new Promise((resolve) => {
+            DyNTS_McpToolLoad_Util.waiters.push(resolve);
+        });
+    }
+    /** Hands the slot to the next waiter, or frees it. */
+    static release(settings) {
+        const next = DyNTS_McpToolLoad_Util.running <= DyNTS_McpToolLoad_Util.limit(settings) ?
+            DyNTS_McpToolLoad_Util.waiters.shift() : undefined;
+        if (next) {
+            next();
+        }
+        else {
+            DyNTS_McpToolLoad_Util.running--;
+        }
+    }
+    /** The heavy concurrency limit (at least 1). */
+    static limit(settings) {
+        return Math.max(1, Math.floor(settings?.heavyToolConcurrency ?? 1));
+    }
+}
+exports.DyNTS_McpToolLoad_Util = DyNTS_McpToolLoad_Util;
+//# sourceMappingURL=mcp-tool-load.util.js.map

package/build/_modules/mcp/_collections/mcp-tool-load.util.js.map

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

package/build/_modules/mcp/_enums/mcp-error-code.type-enum.d.ts

@@ -0,0 +1,17 @@
+/**
+ * JSON-RPC error codes of the MCP layer (HP-DOPL MP-3.6, DMCP-006) — lifted from the organizer MCP server, where they
+ * are in production. The standard JSON-RPC codes plus two server-defined codes (-32000…-32099 range).
+ */
+export declare enum DyNTS_McpErrorCode_Type {
+    /** JSON-RPC: the method does not exist. */
+    methodNotFound = -32601,
+    /** JSON-RPC: invalid method parameters (also used for a missing entity, as in the organizer). */
+    invalidParams = -32602,
+    /** JSON-RPC: internal error. */
+    internal = -32603,
+    /** Server-defined: optimistic concurrency conflict (etag / If-Match mismatch). */
+    conflict = -32001,
+    /** Server-defined: the caller is not allowed (unauthenticated, missing scope, protected entity). */
+    forbidden = -32002
+}
+//# sourceMappingURL=mcp-error-code.type-enum.d.ts.map

package/build/_modules/mcp/_enums/mcp-error-code.type-enum.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mcp-error-code.type-enum.d.ts","sourceRoot":"","sources":["../../../../src/_modules/mcp/_enums/mcp-error-code.type-enum.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,oBAAY,uBAAuB;IACjC,2CAA2C;IAC3C,cAAc,SAAS;IACvB,iGAAiG;IACjG,aAAa,SAAS;IACtB,gCAAgC;IAChC,QAAQ,SAAS;IACjB,kFAAkF;IAClF,QAAQ,SAAS;IACjB,oGAAoG;IACpG,SAAS,SAAS;CACnB"}

package/build/_modules/mcp/_enums/mcp-error-code.type-enum.js

@@ -0,0 +1,21 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.DyNTS_McpErrorCode_Type = void 0;
+/**
+ * JSON-RPC error codes of the MCP layer (HP-DOPL MP-3.6, DMCP-006) — lifted from the organizer MCP server, where they
+ * are in production. The standard JSON-RPC codes plus two server-defined codes (-32000…-32099 range).
+ */
+var DyNTS_McpErrorCode_Type;
+(function (DyNTS_McpErrorCode_Type) {
+    /** JSON-RPC: the method does not exist. */
+    DyNTS_McpErrorCode_Type[DyNTS_McpErrorCode_Type["methodNotFound"] = -32601] = "methodNotFound";
+    /** JSON-RPC: invalid method parameters (also used for a missing entity, as in the organizer). */
+    DyNTS_McpErrorCode_Type[DyNTS_McpErrorCode_Type["invalidParams"] = -32602] = "invalidParams";
+    /** JSON-RPC: internal error. */
+    DyNTS_McpErrorCode_Type[DyNTS_McpErrorCode_Type["internal"] = -32603] = "internal";
+    /** Server-defined: optimistic concurrency conflict (etag / If-Match mismatch). */
+    DyNTS_McpErrorCode_Type[DyNTS_McpErrorCode_Type["conflict"] = -32001] = "conflict";
+    /** Server-defined: the caller is not allowed (unauthenticated, missing scope, protected entity). */
+    DyNTS_McpErrorCode_Type[DyNTS_McpErrorCode_Type["forbidden"] = -32002] = "forbidden";
+})(DyNTS_McpErrorCode_Type || (exports.DyNTS_McpErrorCode_Type = DyNTS_McpErrorCode_Type = {}));
+//# sourceMappingURL=mcp-error-code.type-enum.js.map

package/build/_modules/mcp/_enums/mcp-error-code.type-enum.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"mcp-error-code.type-enum.js","sourceRoot":"","sources":["../../../../src/_modules/mcp/_enums/mcp-error-code.type-enum.ts"],"names":[],"mappings":";;;AAAA;;;GAGG;AACH,IAAY,uBAWX;AAXD,WAAY,uBAAuB;IACjC,2CAA2C;IAC3C,8FAAuB,CAAA;IACvB,iGAAiG;IACjG,4FAAsB,CAAA;IACtB,gCAAgC;IAChC,kFAAiB,CAAA;IACjB,kFAAkF;IAClF,kFAAiB,CAAA;IACjB,oGAAoG;IACpG,oFAAkB,CAAA;AACpB,CAAC,EAXW,uBAAuB,uCAAvB,uBAAuB,QAWlC"}

package/build/_modules/mcp/_enums/mcp-tool-exposure.type-enum.d.ts

@@ -0,0 +1,14 @@
+/**
+ * How an operation is exposed as an MCP tool (HP-DOPL MP-3.2, DMCP-001/018).
+ *
+ * - `default` — advertised in `tools/list`, except on a read-only MCP server (`mcp_settings.readOnly`);
+ * - `none` — never advertised (the operation stays REST/CLI only; the coverage review counts it as deliberate);
+ * - `read-only` — the tool has no side effects: advertised on a read-only server too, with the MCP
+ *   `readOnlyHint` annotation.
+ */
+export declare enum DyNTS_McpToolExposure_Type {
+    default = "default",
+    none = "none",
+    readOnly = "read-only"
+}
+//# sourceMappingURL=mcp-tool-exposure.type-enum.d.ts.map

package/build/_modules/mcp/_enums/mcp-tool-exposure.type-enum.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mcp-tool-exposure.type-enum.d.ts","sourceRoot":"","sources":["../../../../src/_modules/mcp/_enums/mcp-tool-exposure.type-enum.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AACH,oBAAY,0BAA0B;IACpC,OAAO,YAAY;IACnB,IAAI,SAAS;IACb,QAAQ,cAAc;CACvB"}

package/build/_modules/mcp/_enums/mcp-tool-exposure.type-enum.js

@@ -0,0 +1,18 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.DyNTS_McpToolExposure_Type = void 0;
+/**
+ * How an operation is exposed as an MCP tool (HP-DOPL MP-3.2, DMCP-001/018).
+ *
+ * - `default` — advertised in `tools/list`, except on a read-only MCP server (`mcp_settings.readOnly`);
+ * - `none` — never advertised (the operation stays REST/CLI only; the coverage review counts it as deliberate);
+ * - `read-only` — the tool has no side effects: advertised on a read-only server too, with the MCP
+ *   `readOnlyHint` annotation.
+ */
+var DyNTS_McpToolExposure_Type;
+(function (DyNTS_McpToolExposure_Type) {
+    DyNTS_McpToolExposure_Type["default"] = "default";
+    DyNTS_McpToolExposure_Type["none"] = "none";
+    DyNTS_McpToolExposure_Type["readOnly"] = "read-only";
+})(DyNTS_McpToolExposure_Type || (exports.DyNTS_McpToolExposure_Type = DyNTS_McpToolExposure_Type = {}));
+//# sourceMappingURL=mcp-tool-exposure.type-enum.js.map

package/build/_modules/mcp/_enums/mcp-tool-exposure.type-enum.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"mcp-tool-exposure.type-enum.js","sourceRoot":"","sources":["../../../../src/_modules/mcp/_enums/mcp-tool-exposure.type-enum.ts"],"names":[],"mappings":";;;AAAA;;;;;;;GAOG;AACH,IAAY,0BAIX;AAJD,WAAY,0BAA0B;IACpC,iDAAmB,CAAA;IACnB,2CAAa,CAAA;IACb,oDAAsB,CAAA;AACxB,CAAC,EAJW,0BAA0B,0CAA1B,0BAA0B,QAIrC"}

package/build/_modules/mcp/_models/control-models/mcp-tool-params.control-model.d.ts

@@ -0,0 +1,81 @@
+import { DyFM_Operation_Context, DyFM_Operation_JsonSchema, DyFM_Operation_Settings } from '@futdevpro/fsm-dynamo';
+import { DyNTS_McpToolExposure_Type } from '../../_enums/mcp-tool-exposure.type-enum';
+import { DyNTS_Mcp_Settings } from '../interfaces/mcp-settings.interface';
+/**
+ * An operation exposed as an MCP tool (HP-DOPL MP-3.2, decision B+C): the MCP-specific settings on top of a
+ * transport-independent `DyFM_Operation_Settings` — the tool name, the exposure, an optional input schema override
+ * and the load protection flag. The operation stays the single source of the implementation (`run`).
+ *
+ * Follows the Dynamo settings pattern: a `set` constructor, defaults applied in the constructor, construction-time
+ * validation with a coded `DyFM_Error` that carries the construction location.
+ *
+ * @example
+ * ```ts
+ * const getNoteTool: DyNTS_McpTool_Params = new DyNTS_McpTool_Params({
+ *   operation: getNote,                                  // name: 'notes.get'
+ *   exposure: DyNTS_McpToolExposure_Type.readOnly,
+ *   // agent-friendly output (DMCP-011): may be async and use the caller context, e.g. for a parent name lookup
+ *   outputMapper: async (note: Note, ctx: DyFM_Operation_Context): Promise<NoteResult> =>
+ *     NoteMapper.toResult(note, await loadParentName(note, ctx.issuer)),
+ * });
+ * // getNoteTool.getToolName() === 'notes.get' (or 'organizer.notes.get' with mcp_settings.toolPrefix)
+ * ```
+ */
+export declare class DyNTS_McpTool_Params {
+    /** The operation this tool runs. */
+    readonly operation: DyFM_Operation_Settings<unknown, unknown[], unknown>;
+    /** The tool name without the server prefix; default: the operation name (`<domain>.<action>`). */
+    readonly tool: string;
+    /** The tool description for the agent; default: the operation description. */
+    readonly description: string;
+    /** How the tool is advertised; default: `default`. */
+    readonly exposure: DyNTS_McpToolExposure_Type;
+    /** The input schema; default: generated from the operation (`DyFM_OperationSchema_Util.inputSchema`). */
+    readonly inputSchema: DyFM_Operation_JsonSchema;
+    /** A heavy tool is serialized and shed under memory pressure (DMCP-013); default: `false`. */
+    readonly isHeavy: boolean;
+    /** Source location of the construction, for debugging a misconfigured tool. */
+    readonly stackLocation: string;
+    /**
+     * Maps the operation result to the agent-facing tool output (HP-DOPL MP-3.3, DMCP-011, D-8) — e.g. an entity to
+     * `{ ref, etag, summary }`. May be async and may use the caller context (`ctx.issuer`) for lookups; missing = the
+     * operation result goes out unchanged. REST is never affected: the mapper runs only on the MCP path.
+     * Method syntax on purpose: a typed mapper stays assignable under `strictFunctionTypes`.
+     */
+    outputMapper?(result: unknown, ctx: DyFM_Operation_Context): unknown;
+    /**
+     * Validates the settings and applies the defaults.
+     * @param set - the tool settings; throws a coded `DyFM_Error` when invalid
+     */
+    constructor(set: {
+        operation: DyFM_Operation_Settings<unknown, unknown[], unknown>;
+        tool?: string;
+        description?: string;
+        exposure?: DyNTS_McpToolExposure_Type;
+        inputSchema?: DyFM_Operation_JsonSchema;
+        isHeavy?: boolean;
+        outputMapper?(result: unknown, ctx: DyFM_Operation_Context): unknown;
+        stackLocation?: string;
+    });
+    /**
+     * The tool output of an operation result: the `outputMapper` result, or the operation result unchanged.
+     * @param result - the operation result
+     * @param ctx - the context of the call
+     * @throws the mapper's coded `DyFM_Error` unchanged · 500 `DyNTS-MTP-MAP` for any other mapper failure
+     */
+    mapOutput(result: unknown, ctx: DyFM_Operation_Context): Promise<unknown>;
+    /**
+     * The advertised tool name: the server prefix (`mcp_settings.toolPrefix`) + the tool name.
+     * @param settings - the MCP settings (default: `DyNTS_global_settings.mcp_settings`)
+     * @throws `DyNTS-MTP-PFX` when the prefixed name is not a valid tool name
+     */
+    getToolName(settings?: DyNTS_Mcp_Settings | null): string;
+    /**
+     * Whether the tool appears in `tools/list`: never for `none`; on a read-only server only for `read-only`.
+     * @param settings - the MCP settings (default: `DyNTS_global_settings.mcp_settings`)
+     */
+    isAdvertised(settings?: DyNTS_Mcp_Settings | null): boolean;
+    /** Builds the construction error with a stable error code and the construction location. */
+    private static invalid;
+}
+//# sourceMappingURL=mcp-tool-params.control-model.d.ts.map

package/build/_modules/mcp/_models/control-models/mcp-tool-params.control-model.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mcp-tool-params.control-model.d.ts","sourceRoot":"","sources":["../../../../../src/_modules/mcp/_models/control-models/mcp-tool-params.control-model.ts"],"names":[],"mappings":"AAAA,OAAO,EAC0C,sBAAsB,EAAE,yBAAyB,EAChG,uBAAuB,EACxB,MAAM,uBAAuB,CAAC;AAG/B,OAAO,EAAE,0BAA0B,EAAE,MAAM,0CAA0C,CAAC;AACtF,OAAO,EAAE,kBAAkB,EAAE,MAAM,sCAAsC,CAAC;AAM1E;;;;;;;;;;;;;;;;;;;GAmBG;AACH,qBAAa,oBAAoB;IAC/B,oCAAoC;IACpC,QAAQ,CAAC,SAAS,EAAE,uBAAuB,CAAC,OAAO,EAAE,OAAO,EAAE,EAAE,OAAO,CAAC,CAAC;IACzE,kGAAkG;IAClG,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,8EAA8E;IAC9E,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,sDAAsD;IACtD,QAAQ,CAAC,QAAQ,EAAE,0BAA0B,CAAC;IAC9C,yGAAyG;IACzG,QAAQ,CAAC,WAAW,EAAE,yBAAyB,CAAC;IAChD,8FAA8F;IAC9F,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC;IAC1B,+EAA+E;IAC/E,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAC;IAE/B;;;;;OAKG;IACH,YAAY,CAAC,CAAC,MAAM,EAAE,OAAO,EAAE,GAAG,EAAE,sBAAsB,GAAG,OAAO;IAEpE;;;OAGG;gBACS,GAAG,EAAE;QACf,SAAS,EAAE,uBAAuB,CAAC,OAAO,EAAE,OAAO,EAAE,EAAE,OAAO,CAAC,CAAC;QAChE,IAAI,CAAC,EAAE,MAAM,CAAC;QACd,WAAW,CAAC,EAAE,MAAM,CAAC;QACrB,QAAQ,CAAC,EAAE,0BAA0B,CAAC;QACtC,WAAW,CAAC,EAAE,yBAAyB,CAAC;QACxC,OAAO,CAAC,EAAE,OAAO,CAAC;QAClB,YAAY,CAAC,CAAC,MAAM,EAAE,OAAO,EAAE,GAAG,EAAE,sBAAsB,GAAG,OAAO,CAAC;QACrE,aAAa,CAAC,EAAE,MAAM,CAAC;KACxB;IAsED;;;;;OAKG;IACG,SAAS,CAAC,MAAM,EAAE,OAAO,EAAE,GAAG,EAAE,sBAAsB,GAAG,OAAO,CAAC,OAAO,CAAC;IAsB/E;;;;OAIG;IACH,WAAW,CAAC,QAAQ,GAAE,kBAAkB,GAAG,IAAyC,GAAG,MAAM;IAY7F;;;OAGG;IACH,YAAY,CAAC,QAAQ,GAAE,kBAAkB,GAAG,IAAyC,GAAG,OAAO;IAQ/F,4FAA4F;IAC5F,OAAO,CAAC,MAAM,CAAC,OAAO;CAQvB"}