npm - @futdevpro/nts-dynamo - Versions diffs - 1.15.293 → 1.15.294 - Mend

@futdevpro/nts-dynamo 1.15.293 → 1.15.294

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (26) hide show

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

	@@ -1 +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"}
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,qBAiInC,CAAC"}

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

@@ -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 CHANGED Viewed

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

@@ -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 CHANGED Viewed

	@@ -1 +1 @@
1	- {"version":3,"file":"global-settings.interface.d.ts","sourceRoot":"","sources":["../../../src/_models/interfaces/global-settings.interface.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,mBAAmB,EAAE,MAAM,kCAAkC,CAAC;AACvE,OAAO,EAAE,oBAAoB,EAAE,MAAM,mDAAmD,CAAC;AACzF,OAAO,EAAE,+BAA+B,EAAE,MAAM,yCAAyC,CAAC;AAC1F,OAAO,EAAE,0BAA0B,EAAE,MAAM,kCAAkC,CAAC;AAC9E,OAAO,EAAE,wBAAwB,EAAE,MAAM,iCAAiC,CAAC;AAC3E,OAAO,EAAE,8BAA8B,EAAE,MAAM,uCAAuC,CAAC;~~AAEvF~~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"}
1	+ {"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-tool-load.util.d.ts ADDED Viewed

@@ -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 ADDED Viewed

@@ -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 ADDED Viewed

@@ -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 ADDED Viewed

@@ -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-tool-exposure.type-enum.d.ts ADDED Viewed

@@ -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 ADDED Viewed

	@@ -0,0 +1 @@
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 ADDED Viewed

@@ -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 ADDED Viewed

	@@ -0,0 +1 @@
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 ADDED Viewed

@@ -0,0 +1,63 @@
+import { 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,
+ * });
+ * // 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;
+    /**
+     * 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;
+        stackLocation?: string;
+    });
+    /**
+     * 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 ADDED Viewed

@@ -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,yBAAyB,EAAE,uBAAuB,EAElG,MAAM,uBAAuB,CAAC;AAG/B,OAAO,EAAE,0BAA0B,EAAE,MAAM,0CAA0C,CAAC;AACtF,OAAO,EAAE,kBAAkB,EAAE,MAAM,sCAAsC,CAAC;AAM1E;;;;;;;;;;;;;;;;GAgBG;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;;;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,aAAa,CAAC,EAAE,MAAM,CAAC;KACxB;IA4DD;;;;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"}

package/build/_modules/mcp/_models/control-models/mcp-tool-params.control-model.js ADDED Viewed

@@ -0,0 +1,115 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.DyNTS_McpTool_Params = void 0;
+const fsm_dynamo_1 = require("@futdevpro/fsm-dynamo");
+const global_settings_const_1 = require("../../../../_collections/global-settings.const");
+const mcp_tool_exposure_type_enum_1 = require("../../_enums/mcp-tool-exposure.type-enum");
+/** MCP tool name characters (MCP specification: letters, digits, `_`, `-`, `.`; 1–128 characters). */
+const DyNTS_mcpToolName = /^[A-Za-z0-9_.-]{1,128}$/;
+/**
+ * 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,
+ * });
+ * // getNoteTool.getToolName() === 'notes.get' (or 'organizer.notes.get' with mcp_settings.toolPrefix)
+ * ```
+ */
+class DyNTS_McpTool_Params {
+    /** The operation this tool runs. */
+    operation;
+    /** The tool name without the server prefix; default: the operation name (`<domain>.<action>`). */
+    tool;
+    /** The tool description for the agent; default: the operation description. */
+    description;
+    /** How the tool is advertised; default: `default`. */
+    exposure;
+    /** The input schema; default: generated from the operation (`DyFM_OperationSchema_Util.inputSchema`). */
+    inputSchema;
+    /** A heavy tool is serialized and shed under memory pressure (DMCP-013); default: `false`. */
+    isHeavy;
+    /** Source location of the construction, for debugging a misconfigured tool. */
+    stackLocation;
+    /**
+     * Validates the settings and applies the defaults.
+     * @param set - the tool settings; throws a coded `DyFM_Error` when invalid
+     */
+    constructor(set) {
+        const stackLocation = set?.stackLocation ?? (0, fsm_dynamo_1.DyFM_getConstructionStackLocation)();
+        const operation = set?.operation;
+        // a plain object would skip the construction-time validation of the operation
+        if (typeof operation?.name !== 'string' || !operation?.expose) {
+            throw DyNTS_McpTool_Params.invalid('DyNTS-MTP-OPR', 'operation must be a constructed DyFM_Operation_Settings', stackLocation);
+        }
+        const label = operation.name;
+        if (operation.expose.mcp === false) {
+            throw DyNTS_McpTool_Params.invalid('DyNTS-MTP-EXP', `operation "${label}" is not exposed on MCP (expose.mcp: false)`, stackLocation);
+        }
+        if (typeof operation.run !== 'function') {
+            throw DyNTS_McpTool_Params.invalid('DyNTS-MTP-RUN', `operation "${label}" has no run implementation, so it can not be a tool`, stackLocation);
+        }
+        const tool = set.tool ?? operation.name;
+        if (typeof tool !== 'string' || !DyNTS_mcpToolName.test(tool)) {
+            throw DyNTS_McpTool_Params.invalid('DyNTS-MTP-NAM', `tool name must be 1-128 letters, digits, "_", "-" or "." (got: ${JSON.stringify(tool)})`, stackLocation);
+        }
+        const exposure = set.exposure ?? mcp_tool_exposure_type_enum_1.DyNTS_McpToolExposure_Type.default;
+        if (!Object.values(mcp_tool_exposure_type_enum_1.DyNTS_McpToolExposure_Type).includes(exposure)) {
+            throw DyNTS_McpTool_Params.invalid('DyNTS-MTP-EXV', `unknown exposure ${JSON.stringify(exposure)} (tool "${tool}")`, stackLocation);
+        }
+        // an MCP tool input is always a JSON object (the arguments of tools/call)
+        if (set.inputSchema !== undefined && set.inputSchema?.type !== 'object') {
+            throw DyNTS_McpTool_Params.invalid('DyNTS-MTP-SCH', `inputSchema override must be an object schema (tool "${tool}")`, stackLocation);
+        }
+        if (set.isHeavy !== undefined && typeof set.isHeavy !== 'boolean') {
+            throw DyNTS_McpTool_Params.invalid('DyNTS-MTP-HVY', `isHeavy must be a boolean (tool "${tool}")`, stackLocation);
+        }
+        this.operation = operation;
+        this.tool = tool;
+        this.description = set.description ?? operation.description;
+        this.exposure = exposure;
+        this.inputSchema = set.inputSchema ?? fsm_dynamo_1.DyFM_OperationSchema_Util.inputSchema(operation);
+        this.isHeavy = set.isHeavy === true;
+        this.stackLocation = stackLocation;
+    }
+    /**
+     * 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 = global_settings_const_1.DyNTS_global_settings.mcp_settings) {
+        const name = `${settings?.toolPrefix ?? ''}${this.tool}`;
+        if (!DyNTS_mcpToolName.test(name)) {
+            throw DyNTS_McpTool_Params.invalid('DyNTS-MTP-PFX', `the prefixed tool name is invalid: ${JSON.stringify(name)}`, this.stackLocation);
+        }
+        return name;
+    }
+    /**
+     * 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 = global_settings_const_1.DyNTS_global_settings.mcp_settings) {
+        if (this.exposure === mcp_tool_exposure_type_enum_1.DyNTS_McpToolExposure_Type.none) {
+            return false;
+        }
+        return settings?.readOnly === true ? this.exposure === mcp_tool_exposure_type_enum_1.DyNTS_McpToolExposure_Type.readOnly : true;
+    }
+    /** Builds the construction error with a stable error code and the construction location. */
+    static invalid(code, reason, stackLocation) {
+        return new fsm_dynamo_1.DyFM_Error({
+            status: 500,
+            errorCode: `${global_settings_const_1.DyNTS_global_settings.systemShortCodeName}|${code}`,
+            message: `DyNTS_McpTool_Params construction failed: ${reason}`,
+            additionalContent: { stackLocation: stackLocation },
+        });
+    }
+}
+exports.DyNTS_McpTool_Params = DyNTS_McpTool_Params;
+//# sourceMappingURL=mcp-tool-params.control-model.js.map

package/build/_modules/mcp/_models/control-models/mcp-tool-params.control-model.js.map ADDED Viewed

@@ -0,0 +1 @@

+ {"version":3,"file":"mcp-tool-params.control-model.js","sourceRoot":"","sources":["../../../../../src/_modules/mcp/_models/control-models/mcp-tool-params.control-model.ts"],"names":[],"mappings":"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"}

package/build/_modules/mcp/_models/interfaces/mcp-settings.interface.d.ts ADDED Viewed

@@ -0,0 +1,15 @@
+/**
+ * Server-wide MCP defaults (`DyNTS_global_settings.mcp_settings`, HP-DOPL MP-3.2). `null` (the default) means every
+ * field below takes its documented default.
+ */
+export interface DyNTS_Mcp_Settings {
+    /** Prepended to every generated tool name (e.g. `organizer.` → `organizer.notes.get`); default: none. */
+    toolPrefix?: string;
+    /** A read-only MCP server advertises only `read-only` tools; default: `false`. */
+    readOnly?: boolean;
+    /** How many HEAVY tool calls may run at once (DMCP-013 serialization); default: `1`. */
+    heavyToolConcurrency?: number;
+    /** Reject a HEAVY tool call with 503 while the memory guard reports critical pressure (DMCP-013); default: `true`. */
+    shedHeavyToolsUnderMemoryPressure?: boolean;
+}
+//# sourceMappingURL=mcp-settings.interface.d.ts.map

package/build/_modules/mcp/_models/interfaces/mcp-settings.interface.d.ts.map ADDED Viewed

@@ -0,0 +1 @@

+ {"version":3,"file":"mcp-settings.interface.d.ts","sourceRoot":"","sources":["../../../../../src/_modules/mcp/_models/interfaces/mcp-settings.interface.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,MAAM,WAAW,kBAAkB;IACjC,yGAAyG;IACzG,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,kFAAkF;IAClF,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,wFAAwF;IACxF,oBAAoB,CAAC,EAAE,MAAM,CAAC;IAC9B,sHAAsH;IACtH,iCAAiC,CAAC,EAAE,OAAO,CAAC;CAC7C"}

package/build/_modules/mcp/_models/interfaces/mcp-settings.interface.js ADDED Viewed

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=mcp-settings.interface.js.map

package/build/_modules/mcp/_models/interfaces/mcp-settings.interface.js.map ADDED Viewed

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

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

@@ -1,4 +1,8 @@
+export * from './_enums/mcp-tool-exposure.type-enum';
 export * from './_models/interfaces/dynts-mcp.interface';
+export * from './_models/interfaces/mcp-settings.interface';
+export * from './_models/control-models/mcp-tool-params.control-model';
+export * from './_collections/mcp-tool-load.util';
 export * from './_services/dynts-mcp.adapter';
 export * from './_services/mcp-server.service-base';
 //# sourceMappingURL=index.d.ts.map

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

	@@ -1 +1 @@
1	- {"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/_modules/mcp/index.ts"],"names":[],"mappings":"AAQA,cAAc,0CAA0C,CAAC;~~AAGzD~~,cAAc,+BAA+B,CAAC;AAC9C,cAAc,qCAAqC,CAAC"}
1	+ {"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/_modules/mcp/index.ts"],"names":[],"mappings":"AAQA,cAAc,sCAAsC,CAAC;AAGrD,cAAc,0CAA0C,CAAC;AACzD,cAAc,6CAA6C,CAAC;AAG5D,cAAc,wDAAwD,CAAC;AAGvE,cAAc,mCAAmC,CAAC;AAGlD,cAAc,+BAA+B,CAAC;AAC9C,cAAc,qCAAqC,CAAC"}

package/build/_modules/mcp/index.js CHANGED Viewed

@@ -5,8 +5,15 @@
 // 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");
+// ENUMS
+tslib_1.__exportStar(require("./_enums/mcp-tool-exposure.type-enum"), exports);
 // INTERFACES
 tslib_1.__exportStar(require("./_models/interfaces/dynts-mcp.interface"), exports);
+tslib_1.__exportStar(require("./_models/interfaces/mcp-settings.interface"), exports);
+// CONTROL MODELS
+tslib_1.__exportStar(require("./_models/control-models/mcp-tool-params.control-model"), exports);
+// COLLECTIONS
+tslib_1.__exportStar(require("./_collections/mcp-tool-load.util"), exports);
 // SERVICES
 tslib_1.__exportStar(require("./_services/dynts-mcp.adapter"), exports);
 tslib_1.__exportStar(require("./_services/mcp-server.service-base"), exports);

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

	@@ -1 +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,aAAa;AACb,mFAAyD;~~AAEzD~~,WAAW;AACX,wEAA8C;AAC9C,8EAAoD"}
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,+EAAqD;AAErD,aAAa;AACb,mFAAyD;AACzD,sFAA4D;AAE5D,iBAAiB;AACjB,iGAAuE;AAEvE,cAAc;AACd,4EAAkD;AAElD,WAAW;AACX,wEAA8C;AAC9C,8EAAoD"}

package/package.json CHANGED Viewed

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