@futdevpro/nts-dynamo 1.15.293 → 1.15.296

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

@@ -0,0 +1,150 @@
+"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,
+ *   // 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)
+ * ```
+ */
+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);
+        }
+        if (set.outputMapper !== undefined && typeof set.outputMapper !== 'function') {
+            throw DyNTS_McpTool_Params.invalid('DyNTS-MTP-OMP', `outputMapper must be a function (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;
+        if (set.outputMapper) {
+            this.outputMapper = set.outputMapper;
+        }
+    }
+    /**
+     * 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
+     */
+    async mapOutput(result, ctx) {
+        if (!this.outputMapper) {
+            return result;
+        }
+        try {
+            return await this.outputMapper(result, ctx);
+        }
+        catch (error) {
+            if (error instanceof fsm_dynamo_1.DyFM_Error) {
+                throw error;
+            }
+            throw new fsm_dynamo_1.DyFM_Error({
+                status: 500,
+                errorCode: `${global_settings_const_1.DyNTS_global_settings.systemShortCodeName}|DyNTS-MTP-MAP`,
+                message: `the outputMapper of tool "${this.tool}" failed: ${error?.message}`,
+                error: error,
+                additionalContent: { tool: this.tool, requestId: ctx?.requestId, stackLocation: this.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

@@ -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/errors/mcp-conflict.error.d.ts

@@ -0,0 +1,7 @@
+import { DyNTS_McpErrorCode_Type } from '../../_enums/mcp-error-code.type-enum';
+import { DyNTS_Mcp_ErrorBase } from './mcp.error-base';
+/** JSON-RPC -32001 Conflict — optimistic concurrency (etag / If-Match mismatch). (HP-DOPL MP-3.6, lifted from the organizer.) */
+export declare class DyNTS_Mcp_ConflictError extends DyNTS_Mcp_ErrorBase {
+    readonly code: DyNTS_McpErrorCode_Type;
+}
+//# sourceMappingURL=mcp-conflict.error.d.ts.map

package/build/_modules/mcp/_models/errors/mcp-conflict.error.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mcp-conflict.error.d.ts","sourceRoot":"","sources":["../../../../../src/_modules/mcp/_models/errors/mcp-conflict.error.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,uBAAuB,EAAE,MAAM,uCAAuC,CAAC;AAEhF,OAAO,EAAE,mBAAmB,EAAE,MAAM,kBAAkB,CAAC;AAGvD,iIAAiI;AACjI,qBAAa,uBAAwB,SAAQ,mBAAmB;IAC9D,QAAQ,CAAC,IAAI,EAAE,uBAAuB,CAAoC;CAC3E"}

package/build/_modules/mcp/_models/errors/mcp-conflict.error.js

@@ -0,0 +1,11 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.DyNTS_Mcp_ConflictError = void 0;
+const mcp_error_code_type_enum_1 = require("../../_enums/mcp-error-code.type-enum");
+const mcp_error_base_1 = require("./mcp.error-base");
+/** JSON-RPC -32001 Conflict — optimistic concurrency (etag / If-Match mismatch). (HP-DOPL MP-3.6, lifted from the organizer.) */
+class DyNTS_Mcp_ConflictError extends mcp_error_base_1.DyNTS_Mcp_ErrorBase {
+    code = mcp_error_code_type_enum_1.DyNTS_McpErrorCode_Type.conflict;
+}
+exports.DyNTS_Mcp_ConflictError = DyNTS_Mcp_ConflictError;
+//# sourceMappingURL=mcp-conflict.error.js.map

package/build/_modules/mcp/_models/errors/mcp-conflict.error.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"mcp-conflict.error.js","sourceRoot":"","sources":["../../../../../src/_modules/mcp/_models/errors/mcp-conflict.error.ts"],"names":[],"mappings":";;;AAAA,oFAAgF;AAEhF,qDAAuD;AAGvD,iIAAiI;AACjI,MAAa,uBAAwB,SAAQ,oCAAmB;IACrD,IAAI,GAA4B,kDAAuB,CAAC,QAAQ,CAAC;CAC3E;AAFD,0DAEC"}

package/build/_modules/mcp/_models/errors/mcp-forbidden.error.d.ts

@@ -0,0 +1,7 @@
+import { DyNTS_McpErrorCode_Type } from '../../_enums/mcp-error-code.type-enum';
+import { DyNTS_Mcp_ErrorBase } from './mcp.error-base';
+/** JSON-RPC -32002 Forbidden — not allowed for the caller (protected or locked entity, missing scope). (HP-DOPL MP-3.6, lifted from the organizer.) */
+export declare class DyNTS_Mcp_ForbiddenError extends DyNTS_Mcp_ErrorBase {
+    readonly code: DyNTS_McpErrorCode_Type;
+}
+//# sourceMappingURL=mcp-forbidden.error.d.ts.map

package/build/_modules/mcp/_models/errors/mcp-forbidden.error.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mcp-forbidden.error.d.ts","sourceRoot":"","sources":["../../../../../src/_modules/mcp/_models/errors/mcp-forbidden.error.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,uBAAuB,EAAE,MAAM,uCAAuC,CAAC;AAEhF,OAAO,EAAE,mBAAmB,EAAE,MAAM,kBAAkB,CAAC;AAGvD,uJAAuJ;AACvJ,qBAAa,wBAAyB,SAAQ,mBAAmB;IAC/D,QAAQ,CAAC,IAAI,EAAE,uBAAuB,CAAqC;CAC5E"}

package/build/_modules/mcp/_models/errors/mcp-forbidden.error.js

@@ -0,0 +1,11 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.DyNTS_Mcp_ForbiddenError = void 0;
+const mcp_error_code_type_enum_1 = require("../../_enums/mcp-error-code.type-enum");
+const mcp_error_base_1 = require("./mcp.error-base");
+/** JSON-RPC -32002 Forbidden — not allowed for the caller (protected or locked entity, missing scope). (HP-DOPL MP-3.6, lifted from the organizer.) */
+class DyNTS_Mcp_ForbiddenError extends mcp_error_base_1.DyNTS_Mcp_ErrorBase {
+    code = mcp_error_code_type_enum_1.DyNTS_McpErrorCode_Type.forbidden;
+}
+exports.DyNTS_Mcp_ForbiddenError = DyNTS_Mcp_ForbiddenError;
+//# sourceMappingURL=mcp-forbidden.error.js.map

package/build/_modules/mcp/_models/errors/mcp-forbidden.error.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"mcp-forbidden.error.js","sourceRoot":"","sources":["../../../../../src/_modules/mcp/_models/errors/mcp-forbidden.error.ts"],"names":[],"mappings":";;;AAAA,oFAAgF;AAEhF,qDAAuD;AAGvD,uJAAuJ;AACvJ,MAAa,wBAAyB,SAAQ,oCAAmB;IACtD,IAAI,GAA4B,kDAAuB,CAAC,SAAS,CAAC;CAC5E;AAFD,4DAEC"}

package/build/_modules/mcp/_models/errors/mcp-internal.error.d.ts

@@ -0,0 +1,7 @@
+import { DyNTS_McpErrorCode_Type } from '../../_enums/mcp-error-code.type-enum';
+import { DyNTS_Mcp_ErrorBase } from './mcp.error-base';
+/** JSON-RPC -32603 Internal error — the message must stay generic; details go to the server log. (HP-DOPL MP-3.6, lifted from the organizer.) */
+export declare class DyNTS_Mcp_InternalError extends DyNTS_Mcp_ErrorBase {
+    readonly code: DyNTS_McpErrorCode_Type;
+}
+//# sourceMappingURL=mcp-internal.error.d.ts.map

package/build/_modules/mcp/_models/errors/mcp-internal.error.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mcp-internal.error.d.ts","sourceRoot":"","sources":["../../../../../src/_modules/mcp/_models/errors/mcp-internal.error.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,uBAAuB,EAAE,MAAM,uCAAuC,CAAC;AAEhF,OAAO,EAAE,mBAAmB,EAAE,MAAM,kBAAkB,CAAC;AAGvD,iJAAiJ;AACjJ,qBAAa,uBAAwB,SAAQ,mBAAmB;IAC9D,QAAQ,CAAC,IAAI,EAAE,uBAAuB,CAAoC;CAC3E"}

package/build/_modules/mcp/_models/errors/mcp-internal.error.js

@@ -0,0 +1,11 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.DyNTS_Mcp_InternalError = void 0;
+const mcp_error_code_type_enum_1 = require("../../_enums/mcp-error-code.type-enum");
+const mcp_error_base_1 = require("./mcp.error-base");
+/** JSON-RPC -32603 Internal error — the message must stay generic; details go to the server log. (HP-DOPL MP-3.6, lifted from the organizer.) */
+class DyNTS_Mcp_InternalError extends mcp_error_base_1.DyNTS_Mcp_ErrorBase {
+    code = mcp_error_code_type_enum_1.DyNTS_McpErrorCode_Type.internal;
+}
+exports.DyNTS_Mcp_InternalError = DyNTS_Mcp_InternalError;
+//# sourceMappingURL=mcp-internal.error.js.map

package/build/_modules/mcp/_models/errors/mcp-internal.error.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"mcp-internal.error.js","sourceRoot":"","sources":["../../../../../src/_modules/mcp/_models/errors/mcp-internal.error.ts"],"names":[],"mappings":";;;AAAA,oFAAgF;AAEhF,qDAAuD;AAGvD,iJAAiJ;AACjJ,MAAa,uBAAwB,SAAQ,oCAAmB;IACrD,IAAI,GAA4B,kDAAuB,CAAC,QAAQ,CAAC;CAC3E;AAFD,0DAEC"}

package/build/_modules/mcp/_models/errors/mcp-invalid-params.error.d.ts

@@ -0,0 +1,7 @@
+import { DyNTS_McpErrorCode_Type } from '../../_enums/mcp-error-code.type-enum';
+import { DyNTS_Mcp_ErrorBase } from './mcp.error-base';
+/** JSON-RPC -32602 Invalid params — a missing or malformed input, or a missing entity. (HP-DOPL MP-3.6, lifted from the organizer.) */
+export declare class DyNTS_Mcp_InvalidParamsError extends DyNTS_Mcp_ErrorBase {
+    readonly code: DyNTS_McpErrorCode_Type;
+}
+//# sourceMappingURL=mcp-invalid-params.error.d.ts.map

package/build/_modules/mcp/_models/errors/mcp-invalid-params.error.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mcp-invalid-params.error.d.ts","sourceRoot":"","sources":["../../../../../src/_modules/mcp/_models/errors/mcp-invalid-params.error.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,uBAAuB,EAAE,MAAM,uCAAuC,CAAC;AAEhF,OAAO,EAAE,mBAAmB,EAAE,MAAM,kBAAkB,CAAC;AAGvD,uIAAuI;AACvI,qBAAa,4BAA6B,SAAQ,mBAAmB;IACnE,QAAQ,CAAC,IAAI,EAAE,uBAAuB,CAAyC;CAChF"}

package/build/_modules/mcp/_models/errors/mcp-invalid-params.error.js

@@ -0,0 +1,11 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.DyNTS_Mcp_InvalidParamsError = void 0;
+const mcp_error_code_type_enum_1 = require("../../_enums/mcp-error-code.type-enum");
+const mcp_error_base_1 = require("./mcp.error-base");
+/** JSON-RPC -32602 Invalid params — a missing or malformed input, or a missing entity. (HP-DOPL MP-3.6, lifted from the organizer.) */
+class DyNTS_Mcp_InvalidParamsError extends mcp_error_base_1.DyNTS_Mcp_ErrorBase {
+    code = mcp_error_code_type_enum_1.DyNTS_McpErrorCode_Type.invalidParams;
+}
+exports.DyNTS_Mcp_InvalidParamsError = DyNTS_Mcp_InvalidParamsError;
+//# sourceMappingURL=mcp-invalid-params.error.js.map

package/build/_modules/mcp/_models/errors/mcp-invalid-params.error.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"mcp-invalid-params.error.js","sourceRoot":"","sources":["../../../../../src/_modules/mcp/_models/errors/mcp-invalid-params.error.ts"],"names":[],"mappings":";;;AAAA,oFAAgF;AAEhF,qDAAuD;AAGvD,uIAAuI;AACvI,MAAa,4BAA6B,SAAQ,oCAAmB;IAC1D,IAAI,GAA4B,kDAAuB,CAAC,aAAa,CAAC;CAChF;AAFD,oEAEC"}

package/build/_modules/mcp/_models/errors/mcp-method-not-found.error.d.ts

@@ -0,0 +1,7 @@
+import { DyNTS_McpErrorCode_Type } from '../../_enums/mcp-error-code.type-enum';
+import { DyNTS_Mcp_ErrorBase } from './mcp.error-base';
+/** JSON-RPC -32601 Method not found — an unknown tool / method (`data.validMethods` lists the valid ones). (HP-DOPL MP-3.6, lifted from the organizer.) */
+export declare class DyNTS_Mcp_MethodNotFoundError extends DyNTS_Mcp_ErrorBase {
+    readonly code: DyNTS_McpErrorCode_Type;
+}
+//# sourceMappingURL=mcp-method-not-found.error.d.ts.map

package/build/_modules/mcp/_models/errors/mcp-method-not-found.error.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mcp-method-not-found.error.d.ts","sourceRoot":"","sources":["../../../../../src/_modules/mcp/_models/errors/mcp-method-not-found.error.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,uBAAuB,EAAE,MAAM,uCAAuC,CAAC;AAEhF,OAAO,EAAE,mBAAmB,EAAE,MAAM,kBAAkB,CAAC;AAGvD,2JAA2J;AAC3J,qBAAa,6BAA8B,SAAQ,mBAAmB;IACpE,QAAQ,CAAC,IAAI,EAAE,uBAAuB,CAA0C;CACjF"}

package/build/_modules/mcp/_models/errors/mcp-method-not-found.error.js

@@ -0,0 +1,11 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.DyNTS_Mcp_MethodNotFoundError = void 0;
+const mcp_error_code_type_enum_1 = require("../../_enums/mcp-error-code.type-enum");
+const mcp_error_base_1 = require("./mcp.error-base");
+/** JSON-RPC -32601 Method not found — an unknown tool / method (`data.validMethods` lists the valid ones). (HP-DOPL MP-3.6, lifted from the organizer.) */
+class DyNTS_Mcp_MethodNotFoundError extends mcp_error_base_1.DyNTS_Mcp_ErrorBase {
+    code = mcp_error_code_type_enum_1.DyNTS_McpErrorCode_Type.methodNotFound;
+}
+exports.DyNTS_Mcp_MethodNotFoundError = DyNTS_Mcp_MethodNotFoundError;
+//# sourceMappingURL=mcp-method-not-found.error.js.map

package/build/_modules/mcp/_models/errors/mcp-method-not-found.error.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"mcp-method-not-found.error.js","sourceRoot":"","sources":["../../../../../src/_modules/mcp/_models/errors/mcp-method-not-found.error.ts"],"names":[],"mappings":";;;AAAA,oFAAgF;AAEhF,qDAAuD;AAGvD,2JAA2J;AAC3J,MAAa,6BAA8B,SAAQ,oCAAmB;IAC3D,IAAI,GAA4B,kDAAuB,CAAC,cAAc,CAAC;CACjF;AAFD,sEAEC"}

package/build/_modules/mcp/_models/errors/mcp.error-base.d.ts

@@ -0,0 +1,21 @@
+import { DyNTS_McpErrorCode_Type } from '../../_enums/mcp-error-code.type-enum';
+import { DyNTS_Mcp_ErrorData } from '../interfaces/mcp-error-data.interface';
+/**
+ * Base of the MCP errors (HP-DOPL MP-3.6, DMCP-006) — lifted from the organizer `Mcp_*Error` classes: an `Error` with a
+ * JSON-RPC `code` and an optional structured `data`. The message and the data are sent to the caller as they are, so
+ * they must be written for the caller (see `DyNTS_McpError_Util`).
+ */
+export declare abstract class DyNTS_Mcp_ErrorBase extends Error {
+    /** The JSON-RPC error code. */
+    abstract readonly code: DyNTS_McpErrorCode_Type;
+    /** Structured, caller-safe details. */
+    readonly data?: DyNTS_Mcp_ErrorData;
+    /**
+     * @param message - a caller-safe message
+     * @param options.data - structured, caller-safe details
+     */
+    constructor(message: string, options?: {
+        data?: DyNTS_Mcp_ErrorData;
+    });
+}
+//# sourceMappingURL=mcp.error-base.d.ts.map

package/build/_modules/mcp/_models/errors/mcp.error-base.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mcp.error-base.d.ts","sourceRoot":"","sources":["../../../../../src/_modules/mcp/_models/errors/mcp.error-base.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,uBAAuB,EAAE,MAAM,uCAAuC,CAAC;AAChF,OAAO,EAAE,mBAAmB,EAAE,MAAM,wCAAwC,CAAC;AAG7E;;;;GAIG;AACH,8BAAsB,mBAAoB,SAAQ,KAAK;IACrD,+BAA+B;IAC/B,QAAQ,CAAC,QAAQ,CAAC,IAAI,EAAE,uBAAuB,CAAC;IAChD,uCAAuC;IACvC,QAAQ,CAAC,IAAI,CAAC,EAAE,mBAAmB,CAAC;IAEpC;;;OAGG;gBACS,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE;QAAE,IAAI,CAAC,EAAE,mBAAmB,CAAA;KAAE;CAQtE"}

package/build/_modules/mcp/_models/errors/mcp.error-base.js

@@ -0,0 +1,25 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.DyNTS_Mcp_ErrorBase = void 0;
+/**
+ * Base of the MCP errors (HP-DOPL MP-3.6, DMCP-006) — lifted from the organizer `Mcp_*Error` classes: an `Error` with a
+ * JSON-RPC `code` and an optional structured `data`. The message and the data are sent to the caller as they are, so
+ * they must be written for the caller (see `DyNTS_McpError_Util`).
+ */
+class DyNTS_Mcp_ErrorBase extends Error {
+    /** Structured, caller-safe details. */
+    data;
+    /**
+     * @param message - a caller-safe message
+     * @param options.data - structured, caller-safe details
+     */
+    constructor(message, options) {
+        super(message);
+        this.name = new.target.name;
+        if (options?.data !== undefined) {
+            this.data = options.data;
+        }
+    }
+}
+exports.DyNTS_Mcp_ErrorBase = DyNTS_Mcp_ErrorBase;
+//# sourceMappingURL=mcp.error-base.js.map

package/build/_modules/mcp/_models/errors/mcp.error-base.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"mcp.error-base.js","sourceRoot":"","sources":["../../../../../src/_modules/mcp/_models/errors/mcp.error-base.ts"],"names":[],"mappings":";;;AAIA;;;;GAIG;AACH,MAAsB,mBAAoB,SAAQ,KAAK;IAGrD,uCAAuC;IAC9B,IAAI,CAAuB;IAEpC;;;OAGG;IACH,YAAY,OAAe,EAAE,OAAwC;QACnE,KAAK,CAAC,OAAO,CAAC,CAAC;QACf,IAAI,CAAC,IAAI,GAAG,GAAG,CAAC,MAAM,CAAC,IAAI,CAAC;QAE5B,IAAI,OAAO,EAAE,IAAI,KAAK,SAAS,EAAE,CAAC;YAChC,IAAI,CAAC,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC;QAC3B,CAAC;IACH,CAAC;CACF;AAlBD,kDAkBC"}

package/build/_modules/mcp/_models/interfaces/mcp-error-data.interface.d.ts

@@ -0,0 +1,32 @@
+import { DyNTS_Mcp_ValidationErrorItem } from './mcp-validation-error-item.interface';
+/**
+ * The structured `error.data` of every MCP error (HP-DOPL MP-3.6, DMCP-006; lifted from the organizer `MCP_ErrorData`) —
+ * detailed, helpful data for the agent. ⚠️ Never put an internal error message here: only text meant for the caller.
+ */
+export interface DyNTS_Mcp_ErrorData {
+    /** Short technical summary, safe for the caller. */
+    message: string;
+    /** Human-readable text that may be shown to a user. */
+    userMessage?: string;
+    /** The called JSON-RPC method / tool. */
+    method?: string;
+    /** Correct usage of the method. */
+    usage?: string;
+    /** The invalid parameter (e.g. `ref`, `title`, `ifMatch`). */
+    field?: string;
+    /** What the caller sent — only a safe excerpt, never the whole body. */
+    received?: unknown;
+    /** The expected format or rule. */
+    expected?: string;
+    /** A concrete suggestion. */
+    suggestion?: string;
+    /** The internal error code (e.g. of a `DyFM_Error`) — a diagnostic handle, holds no secret. */
+    errorCode?: string;
+    /** Several invalid fields at once. */
+    validationErrors?: DyNTS_Mcp_ValidationErrorItem[];
+    /** The request id, when the error belongs to a request. */
+    requestId?: string;
+    /** Method not found: the valid method names. */
+    validMethods?: string[];
+}
+//# sourceMappingURL=mcp-error-data.interface.d.ts.map

package/build/_modules/mcp/_models/interfaces/mcp-error-data.interface.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mcp-error-data.interface.d.ts","sourceRoot":"","sources":["../../../../../src/_modules/mcp/_models/interfaces/mcp-error-data.interface.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,6BAA6B,EAAE,MAAM,uCAAuC,CAAC;AAGtF;;;GAGG;AACH,MAAM,WAAW,mBAAmB;IAClC,oDAAoD;IACpD,OAAO,EAAE,MAAM,CAAC;IAChB,uDAAuD;IACvD,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,yCAAyC;IACzC,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,mCAAmC;IACnC,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,8DAA8D;IAC9D,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,wEAAwE;IACxE,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,mCAAmC;IACnC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,6BAA6B;IAC7B,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,+FAA+F;IAC/F,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,sCAAsC;IACtC,gBAAgB,CAAC,EAAE,6BAA6B,EAAE,CAAC;IACnD,2DAA2D;IAC3D,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,gDAAgD;IAChD,YAAY,CAAC,EAAE,MAAM,EAAE,CAAC;CACzB"}

package/build/_modules/mcp/_models/interfaces/mcp-error-data.interface.js

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

package/build/_modules/mcp/_models/interfaces/mcp-error-data.interface.js.map

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

package/build/_modules/mcp/_models/interfaces/mcp-json-rpc-error.interface.d.ts

@@ -0,0 +1,12 @@
+import { DyNTS_McpErrorCode_Type } from '../../_enums/mcp-error-code.type-enum';
+import { DyNTS_Mcp_ErrorData } from './mcp-error-data.interface';
+/** A JSON-RPC error object of the MCP layer (`{ code, message, data }`, HP-DOPL MP-3.6). */
+export interface DyNTS_Mcp_JsonRpcError {
+    /** The JSON-RPC error code. */
+    code: DyNTS_McpErrorCode_Type;
+    /** A caller-safe message — never an internal error message. */
+    message: string;
+    /** Structured, caller-safe details. */
+    data: DyNTS_Mcp_ErrorData;
+}
+//# sourceMappingURL=mcp-json-rpc-error.interface.d.ts.map

package/build/_modules/mcp/_models/interfaces/mcp-json-rpc-error.interface.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mcp-json-rpc-error.interface.d.ts","sourceRoot":"","sources":["../../../../../src/_modules/mcp/_models/interfaces/mcp-json-rpc-error.interface.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,uBAAuB,EAAE,MAAM,uCAAuC,CAAC;AAEhF,OAAO,EAAE,mBAAmB,EAAE,MAAM,4BAA4B,CAAC;AAGjE,4FAA4F;AAC5F,MAAM,WAAW,sBAAsB;IACrC,+BAA+B;IAC/B,IAAI,EAAE,uBAAuB,CAAC;IAC9B,+DAA+D;IAC/D,OAAO,EAAE,MAAM,CAAC;IAChB,uCAAuC;IACvC,IAAI,EAAE,mBAAmB,CAAC;CAC3B"}

package/build/_modules/mcp/_models/interfaces/mcp-json-rpc-error.interface.js

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

package/build/_modules/mcp/_models/interfaces/mcp-json-rpc-error.interface.js.map

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

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

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

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

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

@@ -0,0 +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/_models/interfaces/mcp-validation-error-item.interface.d.ts

@@ -0,0 +1,8 @@
+/** One invalid field of an MCP call (e.g. `ref`, `ifMatch`) — an item of `DyNTS_Mcp_ErrorData.validationErrors`. */
+export interface DyNTS_Mcp_ValidationErrorItem {
+    /** The field name. */
+    field: string;
+    /** What is wrong with it. */
+    message: string;
+}
+//# sourceMappingURL=mcp-validation-error-item.interface.d.ts.map

package/build/_modules/mcp/_models/interfaces/mcp-validation-error-item.interface.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mcp-validation-error-item.interface.d.ts","sourceRoot":"","sources":["../../../../../src/_modules/mcp/_models/interfaces/mcp-validation-error-item.interface.ts"],"names":[],"mappings":"AAAA,oHAAoH;AACpH,MAAM,WAAW,6BAA6B;IAC5C,sBAAsB;IACtB,KAAK,EAAE,MAAM,CAAC;IACd,6BAA6B;IAC7B,OAAO,EAAE,MAAM,CAAC;CACjB"}

package/build/_modules/mcp/_models/interfaces/mcp-validation-error-item.interface.js

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

package/build/_modules/mcp/_models/interfaces/mcp-validation-error-item.interface.js.map

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

package/build/_modules/mcp/_services/dynts-mcp.adapter.d.ts

@@ -62,10 +62,12 @@ export declare class DyNTS_Mcp_Adapter {
     private installHandlers;
     /** Egy sikeres (vagy strukturált-hiba) handler-outcome → `CallToolResult` (text-JSON content). */
     private toCallResult;
-    /** Egy hiba → `CallToolResult { isError:true }` strukturált hiba-payload-dal (soha nem néma). */
+    /**
+     * An error → `CallToolResult { isError:true }` with a CALLER-SAFE payload (HP-DOPL MP-3.6): `{ ok:false, error:{ code,
+     * message, errorCode?, data } }` from `DyNTS_McpError_Util` — an internal error message is never sent
+     * (lifted organizer leak fix `TD-20260817-003`); the detail belongs in the server log.
+     */
     private errorResult;
-    /** Egy hiba ember-olvasható üzenete (DyFM_Error → message; Error → message; egyéb → fallback). */
-    private describeError;
     /** JSON-stringify (a transport text-content payload-ja); szerializálás-hiba → strukturált hiba. */
     private stringify;
 }

package/build/_modules/mcp/_services/dynts-mcp.adapter.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"dynts-mcp.adapter.d.ts","sourceRoot":"","sources":["../../../../src/_modules/mcp/_services/dynts-mcp.adapter.ts"],"names":[],"mappings":"AAiBA,OAAO,EACL,oBAAoB,EACpB,oBAAoB,EACpB,wBAAwB,EAEzB,MAAM,2CAA2C,CAAC;AAanD;;;;;;;;;;;;;;;;;;GAkBG;AACH,qBAAa,iBAAiB;IAE5B,6FAA6F;IAC7F,OAAO,CAAC,MAAM,CAAC,SAAS,CAetB;IAEF,yGAAyG;IACzG,OAAO,CAAC,MAAM,CAAuB;IAErC,6DAA6D;IAC7D,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAuB;IAElD,uFAAuF;IACvF,OAAO,CAAC,QAAQ,CAAC,KAAK,CACwB;gBAElC,GAAG,EAAE,oBAAoB;IAKrC;;;SAGK;IACE,YAAY,CAAC,UAAU,EAAE,wBAAwB,GAAG,IAAI;IAI/D,8EAA8E;IACvE,sBAAsB,IAAI,MAAM,EAAE;IAIzC;;;SAGK;IACQ,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC;IAOxC,qEAAqE;IACxD,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAOnC;;;;SAIK;IACQ,gBAAgB,CAAC,GAAG,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,SAAS,CAAC,EAAE,OAAO,CAAA;KAAE,GAAG,OAAO,CAAC,oBAAoB,CAAC;IAoBxG;;;OAGG;mBACkB,OAAO;IAO5B,gEAAgE;IAChE,OAAO,CAAC,SAAS;IAYjB,kFAAkF;IAClF,OAAO,CAAC,eAAe;IAwBvB,kGAAkG;IAClG,OAAO,CAAC,YAAY;IAOpB,iGAAiG;IACjG,OAAO,CAAC,WAAW;IASnB,kGAAkG;IAClG,OAAO,CAAC,aAAa;IAYrB,mGAAmG;IACnG,OAAO,CAAC,SAAS;CAOlB"}
+{"version":3,"file":"dynts-mcp.adapter.d.ts","sourceRoot":"","sources":["../../../../src/_modules/mcp/_services/dynts-mcp.adapter.ts"],"names":[],"mappings":"AAkBA,OAAO,EACL,oBAAoB,EACpB,oBAAoB,EACpB,wBAAwB,EAEzB,MAAM,2CAA2C,CAAC;AAanD;;;;;;;;;;;;;;;;;;GAkBG;AACH,qBAAa,iBAAiB;IAE5B,6FAA6F;IAC7F,OAAO,CAAC,MAAM,CAAC,SAAS,CAetB;IAEF,yGAAyG;IACzG,OAAO,CAAC,MAAM,CAAuB;IAErC,6DAA6D;IAC7D,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAuB;IAElD,uFAAuF;IACvF,OAAO,CAAC,QAAQ,CAAC,KAAK,CACwB;gBAElC,GAAG,EAAE,oBAAoB;IAKrC;;;SAGK;IACE,YAAY,CAAC,UAAU,EAAE,wBAAwB,GAAG,IAAI;IAI/D,8EAA8E;IACvE,sBAAsB,IAAI,MAAM,EAAE;IAIzC;;;SAGK;IACQ,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC;IAOxC,qEAAqE;IACxD,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAOnC;;;;SAIK;IACQ,gBAAgB,CAAC,GAAG,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,SAAS,CAAC,EAAE,OAAO,CAAA;KAAE,GAAG,OAAO,CAAC,oBAAoB,CAAC;IAsBxG;;;OAGG;mBACkB,OAAO;IAO5B,gEAAgE;IAChE,OAAO,CAAC,SAAS;IAYjB,kFAAkF;IAClF,OAAO,CAAC,eAAe;IAwBvB,kGAAkG;IAClG,OAAO,CAAC,YAAY;IAOpB;;;;OAIG;IACH,OAAO,CAAC,WAAW;IAiBnB,mGAAmG;IACnG,OAAO,CAAC,SAAS;CAOlB"}

package/build/_modules/mcp/_services/dynts-mcp.adapter.js

@@ -35,8 +35,9 @@ var __importStar = (this && this.__importStar) || (function () {
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.DyNTS_Mcp_Adapter = void 0;
 /* eslint-enable @futdevpro/dynamo/no-js-import */
-const fsm_dynamo_1 = require("@futdevpro/fsm-dynamo");
 const optional_peer_util_1 = require("../../../_collections/optional-peer.util");
+const mcp_error_util_1 = require("../_collections/mcp-error.util");
+const mcp_method_not_found_error_1 = require("../_models/errors/mcp-method-not-found.error");
 /** The supported version range of the optional MCP SDK peer (kept in sync with `peerDependencies`). */
 const DyNTS_mcpSdkRange = '~1.29.0';
 /**
@@ -120,15 +121,15 @@ class DyNTS_Mcp_Adapter {
     async dispatchToolCall(set) {
         const definition = this.tools.get(set.name);
         if (!definition) {
-            return this.errorResult(`Unknown tool: '${set.name}'. Advertised tools: `
-                + `${this.getAdvertisedToolNames().join(', ')}.`);
+            // the tool names are ours, so listing them is safe and helps the agent pick the right one
+            return this.errorResult(new mcp_method_not_found_error_1.DyNTS_Mcp_MethodNotFoundError(`Unknown tool: '${set.name}'. Advertised tools: ${this.getAdvertisedToolNames().join(', ')}.`), set.name);
         }
         try {
             const outcome = await definition.handler(set.arguments);
             return this.toCallResult(outcome);
         }
         catch (error) {
-            return this.errorResult(this.describeError(error), error);
+            return this.errorResult(error, set.name);
         }
     }
     // =========================================================================
@@ -180,24 +181,26 @@ class DyNTS_Mcp_Adapter {
             isError: outcome.isError === true,
         };
     }
-    /** Egy hiba → `CallToolResult { isError:true }` strukturált hiba-payload-dal (soha nem néma). */
-    errorResult(message, error) {
-        const errorCode = error instanceof fsm_dynamo_1.DyFM_Error
-            ? fsm_dynamo_1.DyFM_Error.getErrorCode(error)
-            : undefined;
-        const payload = { ok: false, error: { errorCode: errorCode, message: message } };
+    /**
+     * An error → `CallToolResult { isError:true }` with a CALLER-SAFE payload (HP-DOPL MP-3.6): `{ ok:false, error:{ code,
+     * message, errorCode?, data } }` from `DyNTS_McpError_Util` — an internal error message is never sent
+     * (lifted organizer leak fix `TD-20260817-003`); the detail belongs in the server log.
+     */
+    errorResult(error, method) {
+        const jsonRpcError = mcp_error_util_1.DyNTS_McpError_Util.toJsonRpcError({
+            error: error, method: method, validMethods: this.getAdvertisedToolNames(),
+        });
+        const payload = {
+            ok: false,
+            error: {
+                code: jsonRpcError.code,
+                message: jsonRpcError.message,
+                errorCode: jsonRpcError.data.errorCode,
+                data: jsonRpcError.data,
+            },
+        };
         return { content: [{ type: 'text', text: this.stringify(payload) }], isError: true };
     }
-    /** Egy hiba ember-olvasható üzenete (DyFM_Error → message; Error → message; egyéb → fallback). */
-    describeError(error) {
-        if (error instanceof fsm_dynamo_1.DyFM_Error) {
-            return fsm_dynamo_1.DyFM_Error.getErrorMessage(error) || 'Unknown DyFM error.';
-        }
-        if (error instanceof Error) {
-            return error.message;
-        }
-        return 'Unknown error during tool execution.';
-    }
     /** JSON-stringify (a transport text-content payload-ja); szerializálás-hiba → strukturált hiba. */
     stringify(data) {
         try {