@futdevpro/nts-dynamo 1.15.294 → 1.15.297

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":"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"}

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

@@ -0,0 +1,74 @@
+import { DyNTS_Mcp_Settings } from '../_models/interfaces/mcp-settings.interface';
+/**
+ * Opaque, agent-friendly entity references (HP-DOPL MP-3.7, DMCP-008) — lifted from the organizer `Mcp_Ref_Util`:
+ * `<system>:<namespace>:<id>` (e.g. `org:note:01H…`). The agent never builds an id path, it passes the ref back.
+ *
+ * Bedrock differences to the organizer original:
+ * - the system prefix is not hard-coded (`org`): it comes from `mcp_settings.refSystem` or the call;
+ * - the namespace is any consumer string (usually the consumer's own enum), so the bedrock knows no entity;
+ * - the `id` is everything after the second `:` (an id may contain `:`), exactly as in the organizer.
+ *
+ * ⭐ The etag of the same entity is `DyFM_OperationGuardrails_Util.buildEtag(entity.__v)` (fsm, MP-1.2) — the organizer
+ * `buildEtag` format, so both refs and etags stay compatible with the organizer MCP.
+ *
+ * @example
+ * ```ts
+ * DyNTS_global_settings.mcp_settings = { refSystem: 'org' };
+ * const ref: string = DyNTS_McpRef_Util.toRef({ namespace: 'note', id: note._id });   // 'org:note:01H…'
+ * const { id } = DyNTS_McpRef_Util.parseAndValidateRef({ ref: args.ref, namespace: 'note', method: 'notes.get' });
+ * ```
+ */
+export declare class DyNTS_McpRef_Util {
+    /**
+     * Builds the ref of an entity.
+     * @param set.namespace - the entity namespace (e.g. `note`)
+     * @param set.id - the entity id
+     * @param set.system - the system prefix (default: `mcp_settings.refSystem`)
+     * @throws 500 `DyNTS-MRF-CFG` when no system is configured or a segment/id is invalid
+     */
+    static toRef(set: {
+        namespace: string;
+        id: string;
+        system?: string;
+        settings?: DyNTS_Mcp_Settings | null;
+    }): string;
+    /**
+     * Splits a ref of the configured system; anything else is `null` (never throws).
+     * @param set.ref - the ref from the caller
+     * @param set.system - the system prefix (default: `mcp_settings.refSystem`)
+     */
+    static parseRef(set: {
+        ref: unknown;
+        system?: string;
+        settings?: DyNTS_Mcp_Settings | null;
+    }): {
+        system: string;
+        namespace: string;
+        id: string;
+    } | null;
+    /**
+     * Parses the ref and checks its namespace — the input guard of a tool that takes a ref.
+     * @param set.ref - the ref from the caller
+     * @param set.namespace - the accepted namespace(s)
+     * @param set.method - the tool name, for the error data
+     * @param set.field - the argument name (default: `ref`, e.g. `parentRef`)
+     * @throws `DyNTS_Mcp_InvalidParamsError` (-32602) with field / received / expected / suggestion data
+     */
+    static parseAndValidateRef(set: {
+        ref: unknown;
+        namespace: string | string[];
+        method: string;
+        field?: string;
+        system?: string;
+        settings?: DyNTS_Mcp_Settings | null;
+    }): {
+        system: string;
+        namespace: string;
+        id: string;
+    };
+    /** The system prefix of a call, validated. */
+    private static systemOf;
+    /** A server configuration error (not the caller's fault). */
+    private static configError;
+}
+//# sourceMappingURL=mcp-ref.util.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"mcp-ref.util.d.ts","sourceRoot":"","sources":["../../../../src/_modules/mcp/_collections/mcp-ref.util.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,kBAAkB,EAAE,MAAM,8CAA8C,CAAC;AAMlF;;;;;;;;;;;;;;;;;;GAkBG;AACH,qBAAa,iBAAiB;IAC5B;;;;;;OAMG;IACH,MAAM,CAAC,KAAK,CAAC,GAAG,EAAE;QAAE,SAAS,EAAE,MAAM,CAAC;QAAC,EAAE,EAAE,MAAM,CAAC;QAAC,MAAM,CAAC,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,EAAE,kBAAkB,GAAG,IAAI,CAAA;KAAE,GAAG,MAAM;IAanH;;;;OAIG;IACH,MAAM,CAAC,QAAQ,CAAC,GAAG,EAAE;QACnB,GAAG,EAAE,OAAO,CAAC;QACb,MAAM,CAAC,EAAE,MAAM,CAAC;QAChB,QAAQ,CAAC,EAAE,kBAAkB,GAAG,IAAI,CAAC;KACtC,GAAG;QAAE,MAAM,EAAE,MAAM,CAAC;QAAC,SAAS,EAAE,MAAM,CAAC;QAAC,EAAE,EAAE,MAAM,CAAA;KAAE,GAAG,IAAI;IAgB5D;;;;;;;OAOG;IACH,MAAM,CAAC,mBAAmB,CAAC,GAAG,EAAE;QAC9B,GAAG,EAAE,OAAO,CAAC;QACb,SAAS,EAAE,MAAM,GAAG,MAAM,EAAE,CAAC;QAC7B,MAAM,EAAE,MAAM,CAAC;QACf,KAAK,CAAC,EAAE,MAAM,CAAC;QACf,MAAM,CAAC,EAAE,MAAM,CAAC;QAChB,QAAQ,CAAC,EAAE,kBAAkB,GAAG,IAAI,CAAC;KACtC,GAAG;QAAE,MAAM,EAAE,MAAM,CAAC;QAAC,SAAS,EAAE,MAAM,CAAC;QAAC,EAAE,EAAE,MAAM,CAAA;KAAE;IAkCrD,8CAA8C;IAC9C,OAAO,CAAC,MAAM,CAAC,QAAQ;IAavB,6DAA6D;IAC7D,OAAO,CAAC,MAAM,CAAC,WAAW;CAO3B"}

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

@@ -0,0 +1,115 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.DyNTS_McpRef_Util = void 0;
+const fsm_dynamo_1 = require("@futdevpro/fsm-dynamo");
+const global_settings_const_1 = require("../../../_collections/global-settings.const");
+const mcp_invalid_params_error_1 = require("../_models/errors/mcp-invalid-params.error");
+/** A ref segment (system or namespace): starts with a letter, letters/digits/`_`/`-`, no `:`. */
+const DyNTS_mcpRefSegment = /^[A-Za-z][A-Za-z0-9_-]*$/;
+/**
+ * Opaque, agent-friendly entity references (HP-DOPL MP-3.7, DMCP-008) — lifted from the organizer `Mcp_Ref_Util`:
+ * `<system>:<namespace>:<id>` (e.g. `org:note:01H…`). The agent never builds an id path, it passes the ref back.
+ *
+ * Bedrock differences to the organizer original:
+ * - the system prefix is not hard-coded (`org`): it comes from `mcp_settings.refSystem` or the call;
+ * - the namespace is any consumer string (usually the consumer's own enum), so the bedrock knows no entity;
+ * - the `id` is everything after the second `:` (an id may contain `:`), exactly as in the organizer.
+ *
+ * ⭐ The etag of the same entity is `DyFM_OperationGuardrails_Util.buildEtag(entity.__v)` (fsm, MP-1.2) — the organizer
+ * `buildEtag` format, so both refs and etags stay compatible with the organizer MCP.
+ *
+ * @example
+ * ```ts
+ * DyNTS_global_settings.mcp_settings = { refSystem: 'org' };
+ * const ref: string = DyNTS_McpRef_Util.toRef({ namespace: 'note', id: note._id });   // 'org:note:01H…'
+ * const { id } = DyNTS_McpRef_Util.parseAndValidateRef({ ref: args.ref, namespace: 'note', method: 'notes.get' });
+ * ```
+ */
+class DyNTS_McpRef_Util {
+    /**
+     * Builds the ref of an entity.
+     * @param set.namespace - the entity namespace (e.g. `note`)
+     * @param set.id - the entity id
+     * @param set.system - the system prefix (default: `mcp_settings.refSystem`)
+     * @throws 500 `DyNTS-MRF-CFG` when no system is configured or a segment/id is invalid
+     */
+    static toRef(set) {
+        const system = DyNTS_McpRef_Util.systemOf(set.system, set.settings);
+        if (!DyNTS_mcpRefSegment.test(set.namespace ?? '') || typeof set.id !== 'string' || !set.id) {
+            throw DyNTS_McpRef_Util.configError(`a ref needs a namespace (letters, digits, "_", "-") and a non-empty id (got: ${JSON.stringify(set.namespace)}, ` +
+                `${JSON.stringify(set.id)})`);
+        }
+        return `${system}:${set.namespace}:${set.id}`;
+    }
+    /**
+     * Splits a ref of the configured system; anything else is `null` (never throws).
+     * @param set.ref - the ref from the caller
+     * @param set.system - the system prefix (default: `mcp_settings.refSystem`)
+     */
+    static parseRef(set) {
+        const system = DyNTS_McpRef_Util.systemOf(set.system, set.settings);
+        const prefix = `${system}:`;
+        if (typeof set.ref !== 'string' || !set.ref.startsWith(prefix)) {
+            return null;
+        }
+        const rest = set.ref.slice(prefix.length);
+        const colon = rest.indexOf(':');
+        const namespace = colon > 0 ? rest.slice(0, colon) : '';
+        const id = colon > 0 ? rest.slice(colon + 1) : '';
+        return DyNTS_mcpRefSegment.test(namespace) && id ? { system: system, namespace: namespace, id: id } : null;
+    }
+    /**
+     * Parses the ref and checks its namespace — the input guard of a tool that takes a ref.
+     * @param set.ref - the ref from the caller
+     * @param set.namespace - the accepted namespace(s)
+     * @param set.method - the tool name, for the error data
+     * @param set.field - the argument name (default: `ref`, e.g. `parentRef`)
+     * @throws `DyNTS_Mcp_InvalidParamsError` (-32602) with field / received / expected / suggestion data
+     */
+    static parseAndValidateRef(set) {
+        const system = DyNTS_McpRef_Util.systemOf(set.system, set.settings);
+        const accepted = Array.isArray(set.namespace) ? set.namespace : [set.namespace];
+        const field = set.field ?? 'ref';
+        const parsed = DyNTS_McpRef_Util.parseRef({ ref: set.ref, system: system });
+        const expected = `${field}: string, format ${system}:<namespace>:<id> (namespace: ${accepted.join(' | ')})`;
+        if (!parsed) {
+            throw new mcp_invalid_params_error_1.DyNTS_Mcp_InvalidParamsError(`Invalid ${field} format: ${String(set.ref)}`, {
+                data: {
+                    message: `Invalid ${field} format: ${String(set.ref)}`,
+                    userMessage: `The ${field} is not valid. A ref looks like ${system}:<namespace>:<id>.`,
+                    method: set.method, field: field, received: set.ref, expected: expected,
+                    suggestion: `Pass back a ${field} exactly as a previous tool result returned it.`,
+                },
+            });
+        }
+        if (!accepted.includes(parsed.namespace)) {
+            const message = `Invalid ${field} namespace: expected '${accepted.join("' or '")}' but got '${parsed.namespace}'`;
+            throw new mcp_invalid_params_error_1.DyNTS_Mcp_InvalidParamsError(message, {
+                data: {
+                    message: message, userMessage: message, method: set.method, field: field, received: set.ref, expected: expected,
+                    suggestion: `Use a ${field} of a ${accepted.join(' or ')} entity.`,
+                },
+            });
+        }
+        return parsed;
+    }
+    /** The system prefix of a call, validated. */
+    static systemOf(system, settings) {
+        const resolved = system ?? (settings === undefined ?
+            global_settings_const_1.DyNTS_global_settings.mcp_settings?.refSystem : settings?.refSystem);
+        if (!resolved || !DyNTS_mcpRefSegment.test(resolved)) {
+            throw DyNTS_McpRef_Util.configError(`the ref system is missing or invalid (got: ${JSON.stringify(resolved)}) - set mcp_settings.refSystem (e.g. 'org')`);
+        }
+        return resolved;
+    }
+    /** A server configuration error (not the caller's fault). */
+    static configError(message) {
+        return new fsm_dynamo_1.DyFM_Error({
+            status: 500,
+            errorCode: `${global_settings_const_1.DyNTS_global_settings.systemShortCodeName}|DyNTS-MRF-CFG`,
+            message: `DyNTS_McpRef_Util: ${message}`,
+        });
+    }
+}
+exports.DyNTS_McpRef_Util = DyNTS_McpRef_Util;
+//# sourceMappingURL=mcp-ref.util.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"mcp-ref.util.js","sourceRoot":"","sources":["../../../../src/_modules/mcp/_collections/mcp-ref.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/_models/control-models/mcp-tool-params.control-model.d.ts

@@ -1,4 +1,4 @@
-import { DyFM_Operation_JsonSchema, DyFM_Operation_Settings } from '@futdevpro/fsm-dynamo';
+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';
 /**
@@ -14,6 +14,9 @@ import { DyNTS_Mcp_Settings } from '../interfaces/mcp-settings.interface';
  * 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)
  * ```
@@ -33,6 +36,13 @@ export declare class DyNTS_McpTool_Params {
     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
@@ -44,8 +54,16 @@ export declare class DyNTS_McpTool_Params {
         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`)

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

@@ -1 +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"}
+{"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"}

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

@@ -19,6 +19,9 @@ const DyNTS_mcpToolName = /^[A-Za-z0-9_.-]{1,128}$/;
  * 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)
  * ```
@@ -71,6 +74,9 @@ class DyNTS_McpTool_Params {
         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;
@@ -78,6 +84,35 @@ class DyNTS_McpTool_Params {
         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.

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

@@ -1 +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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"}
+{"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

@@ -5,6 +5,8 @@
 export interface DyNTS_Mcp_Settings {
     /** Prepended to every generated tool name (e.g. `organizer.` → `organizer.notes.get`); default: none. */
     toolPrefix?: string;
+    /** The system prefix of entity refs (`<refSystem>:<namespace>:<id>`, e.g. `org`); required to use `DyNTS_McpRef_Util`. */
+    refSystem?: 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`. */

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

@@ -1 +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"}
+{"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,0HAA0H;IAC1H,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,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-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 {

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

@@ -1 +1 @@
-{"version":3,"file":"dynts-mcp.adapter.js","sourceRoot":"","sources":["../../../../src/_modules/mcp/_services/dynts-mcp.adapter.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"dynts-mcp.adapter.js","sourceRoot":"","sources":["../../../../src/_modules/mcp/_services/dynts-mcp.adapter.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAWA,kDAAkD;AAElD,iFAAmF;AACnF,mEAAqE;AACrE,6FAA6F;AAkB7F,uGAAuG;AACvG,MAAM,iBAAiB,GAAW,SAAS,CAAC;AAE5C;;;;;;;;;;;;;;;;;;GAkBG;AACH,MAAa,iBAAiB;IAE5B,6FAA6F;IACrF,MAAM,CAAC,SAAS,GAAwC,KAAK,IAAmC,EAAE;QACxG,mDAAmD;QACnD,MAAM,CAAE,YAAY,EAAE,WAAW,EAAE,WAAW,CAAE,GAAG,MAAM,OAAO,CAAC,GAAG,CAAC;8DAC5D,2CAA2C;8DAC3C,2CAA2C;8DAC3C,oCAAoC;SAC5C,CAAC,CAAC;QACH,kDAAkD;QAElD,OAAO;YACL,MAAM,EAAE,YAAY,CAAC,MAAM;YAC3B,oBAAoB,EAAE,WAAW,CAAC,oBAAoB;YACtD,qBAAqB,EAAE,WAAW,CAAC,qBAAqB;YACxD,sBAAsB,EAAE,WAAW,CAAC,sBAAsB;SAC3D,CAAC;IACJ,CAAC,CAAC;IAEF,yGAAyG;IACjG,MAAM,GAAkB,IAAI,CAAC;IAErC,6DAA6D;IAC5C,UAAU,CAAuB;IAElD,uFAAuF;IACtE,KAAK,GACpB,IAAI,GAAG,EAAoC,CAAC;IAE9C,YAAY,GAAyB;QACnC,gFAAgF;QAChF,IAAI,CAAC,UAAU,GAAG,EAAE,IAAI,EAAE,GAAG,CAAC,IAAI,EAAE,OAAO,EAAE,GAAG,CAAC,OAAO,EAAE,CAAC;IAC7D,CAAC;IAED;;;SAGK;IACE,YAAY,CAAC,UAAoC;QACtD,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,UAAU,CAAC,IAAI,EAAE,UAAU,CAAC,CAAC;IAC9C,CAAC;IAED,8EAA8E;IACvE,sBAAsB;QAC3B,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,EAAE,CAAC,CAAC;IACvC,CAAC;IAED;;;SAGK;IACE,KAAK,CAAC,UAAU;QACrB,MAAM,GAAG,GAAyB,MAAM,iBAAiB,CAAC,OAAO,EAAE,CAAC;QACpE,MAAM,SAAS,GAAyB,IAAI,GAAG,CAAC,oBAAoB,EAAE,CAAC;QAEvE,MAAM,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC;IAC/C,CAAC;IAED,qEAAqE;IAC9D,KAAK,CAAC,KAAK;QAChB,0EAA0E;QAC1E,IAAI,IAAI,CAAC,MAAM,EAAE,CAAC;YAChB,MAAM,IAAI,CAAC,MAAM,CAAC,KAAK,EAAE,CAAC;QAC5B,CAAC;IACH,CAAC;IAED;;;;SAIK;IACE,KAAK,CAAC,gBAAgB,CAAC,GAA0C;QACtE,MAAM,UAAU,GAAyC,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;QAElF,IAAI,CAAC,UAAU,EAAE,CAAC;YAChB,0FAA0F;YAC1F,OAAO,IAAI,CAAC,WAAW,CAAC,IAAI,0DAA6B,CACvD,kBAAkB,GAAG,CAAC,IAAI,wBAAwB,IAAI,CAAC,sBAAsB,EAAE,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,CAC9F,EAAE,GAAG,CAAC,IAAI,CAAC,CAAC;QACf,CAAC;QACD,IAAI,CAAC;YACH,MAAM,OAAO,GAA0B,MAAM,UAAU,CAAC,OAAO,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC;YAE/E,OAAO,IAAI,CAAC,YAAY,CAAC,OAAO,CAAC,CAAC;QACpC,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,OAAO,IAAI,CAAC,WAAW,CAAC,KAAK,EAAE,GAAG,CAAC,IAAI,CAAC,CAAC;QAC3C,CAAC;IACH,CAAC;IAED,4EAA4E;IAC5E,wDAAwD;IACxD,4EAA4E;IAE5E;;;OAGG;IACK,MAAM,CAAC,KAAK,CAAC,OAAO;QAC1B,OAAO,4CAAuB,CAAC,IAAI,CAAC;YAClC,WAAW,EAAE,2BAA2B,EAAE,KAAK,EAAE,iBAAiB,EAAE,OAAO,EAAE,mBAAmB;YAChG,QAAQ,EAAE,iBAAiB,CAAC,SAAS;SACtC,CAAC,CAAC;IACL,CAAC;IAED,gEAAgE;IACxD,SAAS,CAAC,GAAyB;QACzC,IAAI,CAAC,IAAI,CAAC,MAAM,EAAE,CAAC;YACjB,IAAI,CAAC,MAAM,GAAG,IAAI,GAAG,CAAC,MAAM,CAC1B,EAAE,IAAI,EAAE,IAAI,CAAC,UAAU,CAAC,IAAI,EAAE,OAAO,EAAE,IAAI,CAAC,UAAU,CAAC,OAAO,EAAE,EAChE,EAAE,YAAY,EAAE,EAAE,KAAK,EAAE,EAAE,EAAE,EAAE,CAChC,CAAC;YACF,IAAI,CAAC,eAAe,CAAC,IAAI,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;QACzC,CAAC;QAED,OAAO,IAAI,CAAC,MAAM,CAAC;IACrB,CAAC;IAED,kFAAkF;IAC1E,eAAe,CAAC,MAAc,EAAE,GAAyB;QAC/D,sEAAsE;QACtE,MAAM,CAAC,iBAAiB,CAAC,GAAG,CAAC,sBAAsB,EAAE,KAAK,IAAI,EAAE,CAAC,CAAC;YAChE,KAAK,EAAE,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,MAAM,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,UAAU,EAAE,EAAE,CAAC,CAAC;gBAC1D,IAAI,EAAE,UAAU,CAAC,IAAI;gBACrB,WAAW,EAAE,UAAU,CAAC,WAAW;gBACnC,WAAW,EAAE,UAAU,CAAC,WAAW;aACpC,CAAC,CAAC;SACJ,CAAC,CAAC,CAAC;QAEJ,gGAAgG;QAChG,+FAA+F;QAC/F,2EAA2E;QAC3E,MAAM,CAAC,iBAAiB,CAAC,GAAG,CAAC,qBAAqB,EAAE,KAAK,EAAE,OAAO,EAA2B,EAAE,CACvF,CAAC,MAAM,IAAI,CAAC,gBAAgB,CAAC;YAC3B,IAAI,EAAE,OAAO,CAAC,MAAM,CAAC,IAAI;YACzB,SAAS,EAAE,OAAO,CAAC,MAAM,CAAC,SAAS;SACpC,CAAC,CAAmB,CAAC,CAAC;IACjC,CAAC;IAED,4EAA4E;IAC5E,oFAAoF;IACpF,4EAA4E;IAE5E,kGAAkG;IAC1F,YAAY,CAAC,OAA8B;QACjD,OAAO;YACL,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,OAAO,CAAC,IAAI,CAAC,EAAE,CAAC;YAC/D,OAAO,EAAE,OAAO,CAAC,OAAO,KAAK,IAAI;SAClC,CAAC;IACJ,CAAC;IAED;;;;OAIG;IACK,WAAW,CAAC,KAAc,EAAE,MAAc;QAChD,MAAM,YAAY,GAA2B,oCAAmB,CAAC,cAAc,CAAC;YAC9E,KAAK,EAAE,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,YAAY,EAAE,IAAI,CAAC,sBAAsB,EAAE;SAC1E,CAAC,CAAC;QACH,MAAM,OAAO,GAAW;YACtB,EAAE,EAAE,KAAK;YACT,KAAK,EAAE;gBACL,IAAI,EAAE,YAAY,CAAC,IAAI;gBACvB,OAAO,EAAE,YAAY,CAAC,OAAO;gBAC7B,SAAS,EAAE,YAAY,CAAC,IAAI,CAAC,SAAS;gBACtC,IAAI,EAAE,YAAY,CAAC,IAAI;aACxB;SACF,CAAC;QAEF,OAAO,EAAE,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,OAAO,CAAC,EAAE,CAAC,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC;IACvF,CAAC;IAED,mGAAmG;IAC3F,SAAS,CAAC,IAAa;QAC7B,IAAI,CAAC;YACH,OAAO,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC;QAC9B,CAAC;QAAC,MAAM,CAAC;YACP,OAAO,IAAI,CAAC,SAAS,CAAC,EAAE,EAAE,EAAE,KAAK,EAAE,KAAK,EAAE,EAAE,OAAO,EAAE,wCAAwC,EAAE,EAAE,CAAC,CAAC;QACrG,CAAC;IACH,CAAC;;AApLH,8CAqLC"}

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

@@ -1,7 +1,19 @@
+export * from './_enums/mcp-error-code.type-enum';
 export * from './_enums/mcp-tool-exposure.type-enum';
 export * from './_models/interfaces/dynts-mcp.interface';
+export * from './_models/interfaces/mcp-error-data.interface';
+export * from './_models/interfaces/mcp-json-rpc-error.interface';
 export * from './_models/interfaces/mcp-settings.interface';
+export * from './_models/interfaces/mcp-validation-error-item.interface';
+export * from './_models/errors/mcp.error-base';
+export * from './_models/errors/mcp-conflict.error';
+export * from './_models/errors/mcp-forbidden.error';
+export * from './_models/errors/mcp-internal.error';
+export * from './_models/errors/mcp-invalid-params.error';
+export * from './_models/errors/mcp-method-not-found.error';
 export * from './_models/control-models/mcp-tool-params.control-model';
+export * from './_collections/mcp-error.util';
+export * from './_collections/mcp-ref.util';
 export * from './_collections/mcp-tool-load.util';
 export * from './_services/dynts-mcp.adapter';
 export * from './_services/mcp-server.service-base';

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

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

package/build/_modules/mcp/index.js

@@ -6,13 +6,26 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 const tslib_1 = require("tslib");
 // ENUMS
+tslib_1.__exportStar(require("./_enums/mcp-error-code.type-enum"), exports);
 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-error-data.interface"), exports);
+tslib_1.__exportStar(require("./_models/interfaces/mcp-json-rpc-error.interface"), exports);
 tslib_1.__exportStar(require("./_models/interfaces/mcp-settings.interface"), exports);
+tslib_1.__exportStar(require("./_models/interfaces/mcp-validation-error-item.interface"), exports);
+// ERRORS
+tslib_1.__exportStar(require("./_models/errors/mcp.error-base"), exports);
+tslib_1.__exportStar(require("./_models/errors/mcp-conflict.error"), exports);
+tslib_1.__exportStar(require("./_models/errors/mcp-forbidden.error"), exports);
+tslib_1.__exportStar(require("./_models/errors/mcp-internal.error"), exports);
+tslib_1.__exportStar(require("./_models/errors/mcp-invalid-params.error"), exports);
+tslib_1.__exportStar(require("./_models/errors/mcp-method-not-found.error"), exports);
 // CONTROL MODELS
 tslib_1.__exportStar(require("./_models/control-models/mcp-tool-params.control-model"), exports);
 // COLLECTIONS
+tslib_1.__exportStar(require("./_collections/mcp-error.util"), exports);
+tslib_1.__exportStar(require("./_collections/mcp-ref.util"), exports);
 tslib_1.__exportStar(require("./_collections/mcp-tool-load.util"), exports);
 // SERVICES
 tslib_1.__exportStar(require("./_services/dynts-mcp.adapter"), exports);

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

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

package/package.json

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