@mcp-abap-adt/core 6.4.1 → 6.5.0

package/CHANGELOG.md

@@ -2,6 +2,23 @@
 
 ## [Unreleased]
 
+## [6.5.0] - 2026-04-24
+
+### Added
+- `EmbeddableMcpServer` accepts optional `readOnlyDedupStrategy: IReadOnlyDedupStrategy` to hide duplicate `Read<X>` readonly handlers when another group (HighLevel / LowLevel / Compact) contributes an equivalent. Ships two implementations: `NoDedupStrategy` (default — no behavior change for existing consumers) and `ReadVsGetDedupStrategy` (hides `Read<X>` when `Get<X>` is exposed). Consumers can also plug custom strategies for role-based rules. Exported from `@mcp-abap-adt/core/handlers` and `@mcp-abap-adt/core/server`.
+- CLI launcher validates `--exposition` — `compact` must be exposed alone, `high` and `low` are mutually exclusive. Fails fast at startup with a clear error on misconfiguration.
+- Diagnostic scripts `scripts/read-fm.ts` and `scripts/probe-fm.ts` for reproducing function-module endpoint quirks against an arbitrary env file.
+
+### Changed
+- CLI launcher opts into `ReadVsGetDedupStrategy` by default, so running the shipped server no longer exposes duplicate pairs like `ReadFunctionModule` + `GetFunctionModule` when both `readonly` and `high` are enabled.
+
+### Fixed
+- `ReadFunctionModule` / `GetFunctionModule`: ADT resolves function modules by name regardless of the group segment in the URL, so passing a wrong group silently returned the correct FM's source and echoed the wrong group back in the response. Both handlers now read metadata first, verify the owning group via `<adtcore:containerRef/>`, and reject mismatches with an explicit error (`Function module X belongs to group Y, not Z.`). The response now echoes the real group from metadata rather than the input.
+
+### Backward compatibility
+- `EmbeddableMcpServer` default dedup is `NoDedupStrategy` — existing consumers see no change in exposed tool sets until they explicitly pass a strategy.
+- Invalid `--exposition` combinations previously silently produced duplicate-tool errors at runtime or exposed overlapping handlers; they now fail at startup with an explicit message.
+
 ## [6.4.1] - 2026-04-21
 
 ### Fixed

package/dist/handlers/function_module/high/handleGetFunctionModule.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"handleGetFunctionModule.d.ts","sourceRoot":"","sources":["../../../../src/handlers/function_module/high/handleGetFunctionModule.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAGH,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,kCAAkC,CAAC;AAOvE,eAAO,MAAM,eAAe;;;;;;;;;;;;;;;;;;;;;;;;CA2BlB,CAAC;AAEX,UAAU,qBAAqB;IAC7B,oBAAoB,EAAE,MAAM,CAAC;IAC7B,mBAAmB,EAAE,MAAM,CAAC;IAC5B,OAAO,CAAC,EAAE,QAAQ,GAAG,UAAU,CAAC;CACjC;AAED;;;;GAIG;AACH,wBAAsB,uBAAuB,CAC3C,OAAO,EAAE,cAAc,EACvB,IAAI,EAAE,qBAAqB;;;;;;GAwF5B"}
+{"version":3,"file":"handleGetFunctionModule.d.ts","sourceRoot":"","sources":["../../../../src/handlers/function_module/high/handleGetFunctionModule.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAGH,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,kCAAkC,CAAC;AAQvE,eAAO,MAAM,eAAe;;;;;;;;;;;;;;;;;;;;;;;;CA2BlB,CAAC;AAEX,UAAU,qBAAqB;IAC7B,oBAAoB,EAAE,MAAM,CAAC;IAC7B,mBAAmB,EAAE,MAAM,CAAC;IAC5B,OAAO,CAAC,EAAE,QAAQ,GAAG,UAAU,CAAC;CACjC;AAED;;;;GAIG;AACH,wBAAsB,uBAAuB,CAC3C,OAAO,EAAE,cAAc,EACvB,IAAI,EAAE,qBAAqB;;;;;;GAwG5B"}

package/dist/handlers/function_module/high/handleGetFunctionModule.js

@@ -10,6 +10,7 @@ exports.TOOL_DEFINITION = void 0;
 exports.handleGetFunctionModule = handleGetFunctionModule;
 const clients_1 = require("../../../lib/clients");
 const utils_1 = require("../../../lib/utils");
+const parseContainerGroup_1 = require("../shared/parseContainerGroup");
 exports.TOOL_DEFINITION = {
     name: 'GetFunctionModule',
     available_in: ['onprem', 'cloud', 'legacy'],
@@ -53,9 +54,18 @@ async function handleGetFunctionModule(context, args) {
         const functionGroupName = function_group_name.toUpperCase();
         logger?.info(`Reading function module ${functionModuleName} in ${functionGroupName}, version: ${version}`);
         try {
-            // Read function module using AdtClient
             const functionModuleObject = client.getFunctionModule();
-            const readResult = await functionModuleObject.read({ functionModuleName, functionGroupName }, version);
+            // Verify ownership first — ADT resolves FM by name regardless of group
+            // segment in URL, so we reject mismatches before returning source.
+            const metaResult = await functionModuleObject.readMetadata({
+                functionModuleName,
+                functionGroupName,
+            });
+            const metadataXml = typeof metaResult?.metadataResult?.data === 'string'
+                ? metaResult.metadataResult.data
+                : null;
+            const realGroup = (0, parseContainerGroup_1.assertFunctionGroupMatches)(metadataXml, functionGroupName, functionModuleName);
+            const readResult = await functionModuleObject.read({ functionModuleName, functionGroupName: realGroup }, version);
             if (!readResult || !readResult.readResult) {
                 throw new Error(`FunctionModule ${functionModuleName} not found`);
             }
@@ -73,12 +83,12 @@ async function handleGetFunctionModule(context, args) {
                     functionModuleData = String(readResult.readResult.data);
                 }
             }
-            logger?.info(`✅ GetFunctionModule completed successfully: ${functionModuleName}`);
+            logger?.info(`GetFunctionModule completed successfully: ${functionModuleName} in ${realGroup}`);
             return (0, utils_1.return_response)({
                 data: JSON.stringify({
                     success: true,
                     function_module_name: functionModuleName,
-                    function_group_name: functionGroupName,
+                    function_group_name: realGroup,
                     version,
                     function_module_data: functionModuleData,
                     status: readResult.readResult.status,

package/dist/handlers/function_module/high/handleGetFunctionModule.js.map

@@ -1 +1 @@
-{"version":3,"file":"handleGetFunctionModule.js","sourceRoot":"","sources":["../../../../src/handlers/function_module/high/handleGetFunctionModule.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"handleGetFunctionModule.js","sourceRoot":"","sources":["../../../../src/handlers/function_module/high/handleGetFunctionModule.ts"],"names":[],"mappings":"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"}

package/dist/handlers/function_module/readonly/handleReadFunctionModule.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"handleReadFunctionModule.d.ts","sourceRoot":"","sources":["../../../../src/handlers/function_module/readonly/handleReadFunctionModule.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,kCAAkC,CAAC;AAOvE,eAAO,MAAM,eAAe;;;;;;;;;;;;;;;;;;;;;;;;CA0BlB,CAAC;AAEX,wBAAsB,wBAAwB,CAC5C,OAAO,EAAE,cAAc,EACvB,IAAI,EAAE;IACJ,oBAAoB,EAAE,MAAM,CAAC;IAC7B,mBAAmB,EAAE,MAAM,CAAC;IAC5B,OAAO,CAAC,EAAE,QAAQ,GAAG,UAAU,CAAC;CACjC;;;;;;GAwEF"}
+{"version":3,"file":"handleReadFunctionModule.d.ts","sourceRoot":"","sources":["../../../../src/handlers/function_module/readonly/handleReadFunctionModule.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,kCAAkC,CAAC;AAQvE,eAAO,MAAM,eAAe;;;;;;;;;;;;;;;;;;;;;;;;CA0BlB,CAAC;AAEX,wBAAsB,wBAAwB,CAC5C,OAAO,EAAE,cAAc,EACvB,IAAI,EAAE;IACJ,oBAAoB,EAAE,MAAM,CAAC;IAC7B,mBAAmB,EAAE,MAAM,CAAC;IAC5B,OAAO,CAAC,EAAE,QAAQ,GAAG,UAAU,CAAC;CACjC;;;;;;GAmFF"}

package/dist/handlers/function_module/readonly/handleReadFunctionModule.js

@@ -4,6 +4,7 @@ exports.TOOL_DEFINITION = void 0;
 exports.handleReadFunctionModule = handleReadFunctionModule;
 const clients_1 = require("../../../lib/clients");
 const utils_1 = require("../../../lib/utils");
+const parseContainerGroup_1 = require("../shared/parseContainerGroup");
 exports.TOOL_DEFINITION = {
     name: 'ReadFunctionModule',
     available_in: ['onprem', 'cloud', 'legacy'],
@@ -39,19 +40,9 @@ async function handleReadFunctionModule(context, args) {
         const functionModuleName = function_module_name.toUpperCase();
         const functionGroupName = function_group_name.toUpperCase();
         const obj = client.getFunctionModule();
-        let source_code = null;
-        try {
-            const readResult = await obj.read({ functionModuleName, functionGroupName }, version);
-            if (readResult?.readResult?.data) {
-                source_code =
-                    typeof readResult.readResult.data === 'string'
-                        ? readResult.readResult.data
-                        : safeStringify(readResult.readResult.data);
-            }
-        }
-        catch (e) {
-            logger?.warn(`Could not read source for ${functionModuleName}: ${e?.message}`);
-        }
+        // Read metadata FIRST — the ADT backend resolves FM by name regardless of
+        // the group segment in the URL, so we must verify ownership from metadata
+        // (<adtcore:containerRef/>) before trusting any source payload.
         let metadata = null;
         try {
             const metaResult = await obj.readMetadata({
@@ -66,13 +57,27 @@ async function handleReadFunctionModule(context, args) {
             }
         }
         catch (e) {
-            logger?.warn(`Could not read metadata for ${functionModuleName}: ${e?.message}`);
+            return (0, utils_1.return_error)(new Error(`Could not read metadata for ${functionModuleName} in group ${functionGroupName}: ${e?.message ?? e}`));
+        }
+        const realGroup = (0, parseContainerGroup_1.assertFunctionGroupMatches)(metadata, functionGroupName, functionModuleName);
+        let source_code = null;
+        try {
+            const readResult = await obj.read({ functionModuleName, functionGroupName: realGroup }, version);
+            if (readResult?.readResult?.data) {
+                source_code =
+                    typeof readResult.readResult.data === 'string'
+                        ? readResult.readResult.data
+                        : safeStringify(readResult.readResult.data);
+            }
+        }
+        catch (e) {
+            logger?.warn(`Could not read source for ${functionModuleName}: ${e?.message}`);
         }
         return (0, utils_1.return_response)({
             data: JSON.stringify({
                 success: true,
                 function_module_name: functionModuleName,
-                function_group_name: functionGroupName,
+                function_group_name: realGroup,
                 version,
                 source_code,
                 metadata,

package/dist/handlers/function_module/readonly/handleReadFunctionModule.js.map

@@ -1 +1 @@
-{"version":3,"file":"handleReadFunctionModule.js","sourceRoot":"","sources":["../../../../src/handlers/function_module/readonly/handleReadFunctionModule.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"handleReadFunctionModule.js","sourceRoot":"","sources":["../../../../src/handlers/function_module/readonly/handleReadFunctionModule.ts"],"names":[],"mappings":"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"}

package/dist/handlers/function_module/shared/parseContainerGroup.d.ts

@@ -0,0 +1,25 @@
+/**
+ * Parse the owning function group from ADT function module metadata XML.
+ *
+ * The relevant element is:
+ *   <adtcore:containerRef
+ *      adtcore:uri="/sap/bc/adt/functions/groups/sxpt"
+ *      adtcore:type="FUGR/F"
+ *      adtcore:name="SXPT" .../>
+ *
+ * The ADT backend resolves function modules by name alone and happily returns
+ * source/metadata even when the group segment of the URL is wrong. The only
+ * reliable indicator of the real owning group is the `containerRef` element
+ * above. Callers compare it with the caller-supplied group to reject
+ * mismatched inputs instead of silently returning code from a different
+ * group than requested.
+ */
+export declare function parseContainerGroupName(metadataXml: string | null | undefined): string | null;
+/**
+ * Validate that the FM belongs to the expected group and return the real
+ * group name from metadata. Throws when the metadata does not contain a
+ * `containerRef` (so we never return unverified source) or when the real
+ * group does not match the expected one (case-insensitive).
+ */
+export declare function assertFunctionGroupMatches(metadataXml: string | null | undefined, expectedGroupName: string, functionModuleName: string): string;
+//# sourceMappingURL=parseContainerGroup.d.ts.map

package/dist/handlers/function_module/shared/parseContainerGroup.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"parseContainerGroup.d.ts","sourceRoot":"","sources":["../../../../src/handlers/function_module/shared/parseContainerGroup.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,uBAAuB,CACrC,WAAW,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,GACrC,MAAM,GAAG,IAAI,CAWf;AAED;;;;;GAKG;AACH,wBAAgB,0BAA0B,CACxC,WAAW,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,EACtC,iBAAiB,EAAE,MAAM,EACzB,kBAAkB,EAAE,MAAM,GACzB,MAAM,CAaR"}

package/dist/handlers/function_module/shared/parseContainerGroup.js

@@ -0,0 +1,47 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.parseContainerGroupName = parseContainerGroupName;
+exports.assertFunctionGroupMatches = assertFunctionGroupMatches;
+/**
+ * Parse the owning function group from ADT function module metadata XML.
+ *
+ * The relevant element is:
+ *   <adtcore:containerRef
+ *      adtcore:uri="/sap/bc/adt/functions/groups/sxpt"
+ *      adtcore:type="FUGR/F"
+ *      adtcore:name="SXPT" .../>
+ *
+ * The ADT backend resolves function modules by name alone and happily returns
+ * source/metadata even when the group segment of the URL is wrong. The only
+ * reliable indicator of the real owning group is the `containerRef` element
+ * above. Callers compare it with the caller-supplied group to reject
+ * mismatched inputs instead of silently returning code from a different
+ * group than requested.
+ */
+function parseContainerGroupName(metadataXml) {
+    if (!metadataXml)
+        return null;
+    const match = metadataXml.match(/<adtcore:containerRef\b[^>]*\badtcore:type="FUGR\/F"[^>]*\badtcore:name="([^"]+)"/);
+    if (match)
+        return match[1];
+    // Attribute order is not guaranteed — try with name before type.
+    const alt = metadataXml.match(/<adtcore:containerRef\b[^>]*\badtcore:name="([^"]+)"[^>]*\badtcore:type="FUGR\/F"/);
+    return alt ? alt[1] : null;
+}
+/**
+ * Validate that the FM belongs to the expected group and return the real
+ * group name from metadata. Throws when the metadata does not contain a
+ * `containerRef` (so we never return unverified source) or when the real
+ * group does not match the expected one (case-insensitive).
+ */
+function assertFunctionGroupMatches(metadataXml, expectedGroupName, functionModuleName) {
+    const real = parseContainerGroupName(metadataXml);
+    if (!real) {
+        throw new Error(`Could not determine owning function group for ${functionModuleName} from ADT metadata. Refusing to return unverified source.`);
+    }
+    if (real.toUpperCase() !== expectedGroupName.toUpperCase()) {
+        throw new Error(`Function module ${functionModuleName} belongs to group ${real}, not ${expectedGroupName}.`);
+    }
+    return real;
+}
+//# sourceMappingURL=parseContainerGroup.js.map

package/dist/handlers/function_module/shared/parseContainerGroup.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"parseContainerGroup.js","sourceRoot":"","sources":["../../../../src/handlers/function_module/shared/parseContainerGroup.ts"],"names":[],"mappings":";;AAgBA,0DAaC;AAQD,gEAiBC;AAtDD;;;;;;;;;;;;;;;GAeG;AACH,SAAgB,uBAAuB,CACrC,WAAsC;IAEtC,IAAI,CAAC,WAAW;QAAE,OAAO,IAAI,CAAC;IAC9B,MAAM,KAAK,GAAG,WAAW,CAAC,KAAK,CAC7B,mFAAmF,CACpF,CAAC;IACF,IAAI,KAAK;QAAE,OAAO,KAAK,CAAC,CAAC,CAAC,CAAC;IAC3B,iEAAiE;IACjE,MAAM,GAAG,GAAG,WAAW,CAAC,KAAK,CAC3B,mFAAmF,CACpF,CAAC;IACF,OAAO,GAAG,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC;AAC7B,CAAC;AAED;;;;;GAKG;AACH,SAAgB,0BAA0B,CACxC,WAAsC,EACtC,iBAAyB,EACzB,kBAA0B;IAE1B,MAAM,IAAI,GAAG,uBAAuB,CAAC,WAAW,CAAC,CAAC;IAClD,IAAI,CAAC,IAAI,EAAE,CAAC;QACV,MAAM,IAAI,KAAK,CACb,iDAAiD,kBAAkB,2DAA2D,CAC/H,CAAC;IACJ,CAAC;IACD,IAAI,IAAI,CAAC,WAAW,EAAE,KAAK,iBAAiB,CAAC,WAAW,EAAE,EAAE,CAAC;QAC3D,MAAM,IAAI,KAAK,CACb,mBAAmB,kBAAkB,qBAAqB,IAAI,SAAS,iBAAiB,GAAG,CAC5F,CAAC;IACJ,CAAC;IACD,OAAO,IAAI,CAAC;AACd,CAAC"}

package/dist/lib/config/validateExposition.d.ts

@@ -0,0 +1,10 @@
+import type { HandlerSet } from './IServerConfig.js';
+/**
+ * Validates an exposition array and throws on disallowed combinations.
+ *
+ * Rules:
+ * - `compact` is exposed only by itself. It cannot be combined with any other set.
+ * - `high` and `low` are mutually exclusive.
+ */
+export declare function validateExposition(exposition: readonly HandlerSet[]): void;
+//# sourceMappingURL=validateExposition.d.ts.map

package/dist/lib/config/validateExposition.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"validateExposition.d.ts","sourceRoot":"","sources":["../../../src/lib/config/validateExposition.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,oBAAoB,CAAC;AAErD;;;;;;GAMG;AACH,wBAAgB,kBAAkB,CAAC,UAAU,EAAE,SAAS,UAAU,EAAE,GAAG,IAAI,CAe1E"}

package/dist/lib/config/validateExposition.js

@@ -0,0 +1,21 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.validateExposition = validateExposition;
+/**
+ * Validates an exposition array and throws on disallowed combinations.
+ *
+ * Rules:
+ * - `compact` is exposed only by itself. It cannot be combined with any other set.
+ * - `high` and `low` are mutually exclusive.
+ */
+function validateExposition(exposition) {
+    const set = new Set(exposition);
+    if (set.has('compact') && set.size > 1) {
+        const others = [...set].filter((s) => s !== 'compact').join(', ');
+        throw new Error(`Invalid exposition: 'compact' must be exposed alone, but also found: ${others}`);
+    }
+    if (set.has('high') && set.has('low')) {
+        throw new Error(`Invalid exposition: 'high' and 'low' are mutually exclusive`);
+    }
+}
+//# sourceMappingURL=validateExposition.js.map

package/dist/lib/config/validateExposition.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"validateExposition.js","sourceRoot":"","sources":["../../../src/lib/config/validateExposition.ts"],"names":[],"mappings":";;AASA,gDAeC;AAtBD;;;;;;GAMG;AACH,SAAgB,kBAAkB,CAAC,UAAiC;IAClE,MAAM,GAAG,GAAG,IAAI,GAAG,CAAC,UAAU,CAAC,CAAC;IAEhC,IAAI,GAAG,CAAC,GAAG,CAAC,SAAS,CAAC,IAAI,GAAG,CAAC,IAAI,GAAG,CAAC,EAAE,CAAC;QACvC,MAAM,MAAM,GAAG,CAAC,GAAG,GAAG,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,KAAK,SAAS,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QAClE,MAAM,IAAI,KAAK,CACb,wEAAwE,MAAM,EAAE,CACjF,CAAC;IACJ,CAAC;IAED,IAAI,GAAG,CAAC,GAAG,CAAC,MAAM,CAAC,IAAI,GAAG,CAAC,GAAG,CAAC,KAAK,CAAC,EAAE,CAAC;QACtC,MAAM,IAAI,KAAK,CACb,6DAA6D,CAC9D,CAAC;IACJ,CAAC;AACH,CAAC"}

package/dist/lib/handlers/groups/ReadOnlyHandlersGroup.d.ts

@@ -1,14 +1,25 @@
 import { BaseHandlerGroup } from '../base/BaseHandlerGroup.js';
-import type { HandlerEntry } from '../interfaces.js';
+import type { HandlerContext, HandlerEntry } from '../interfaces.js';
+import { type IReadOnlyDedupStrategy } from './strategies/index.js';
 /**
  * Handler group for all readonly (read-only) handlers.
  * Contains handlers that only read data without modifying the ABAP system.
+ *
+ * When other groups (HighLevel / LowLevel / Compact) are also exposed, some
+ * readonly handlers semantically duplicate tools from those groups
+ * (e.g. ReadFunctionModule vs GetFunctionModule). The group hides such
+ * duplicates based on the injected override strategy and the set of tool
+ * names contributed by the other groups.
  */
 export declare class ReadOnlyHandlersGroup extends BaseHandlerGroup {
     protected groupName: string;
+    private readonly overridingToolNames;
+    private readonly dedupStrategy;
+    constructor(context: HandlerContext, overridingToolNames?: ReadonlySet<string>, dedupStrategy?: IReadOnlyDedupStrategy);
     /**
-     * Gets all readonly handler entries
+     * Gets all readonly handler entries, filtered by the dedup strategy.
      */
     getHandlers(): HandlerEntry[];
+    private getAllEntries;
 }
 //# sourceMappingURL=ReadOnlyHandlersGroup.d.ts.map

package/dist/lib/handlers/groups/ReadOnlyHandlersGroup.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"ReadOnlyHandlersGroup.d.ts","sourceRoot":"","sources":["../../../../src/lib/handlers/groups/ReadOnlyHandlersGroup.ts"],"names":[],"mappings":"AAwGA,OAAO,EAAE,gBAAgB,EAAE,MAAM,6BAA6B,CAAC;AAC/D,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,kBAAkB,CAAC;AAErD;;;GAGG;AACH,qBAAa,qBAAsB,SAAQ,gBAAgB;IACzD,SAAS,CAAC,SAAS,SAAsB;IAEzC;;OAEG;IACH,WAAW,IAAI,YAAY,EAAE;CAgH9B"}
+{"version":3,"file":"ReadOnlyHandlersGroup.d.ts","sourceRoot":"","sources":["../../../../src/lib/handlers/groups/ReadOnlyHandlersGroup.ts"],"names":[],"mappings":"AAwGA,OAAO,EAAE,gBAAgB,EAAE,MAAM,6BAA6B,CAAC;AAC/D,OAAO,KAAK,EAAE,cAAc,EAAE,YAAY,EAAE,MAAM,kBAAkB,CAAC;AACrE,OAAO,EACL,KAAK,sBAAsB,EAE5B,MAAM,uBAAuB,CAAC;AAE/B;;;;;;;;;GASG;AACH,qBAAa,qBAAsB,SAAQ,gBAAgB;IACzD,SAAS,CAAC,SAAS,SAAsB;IACzC,OAAO,CAAC,QAAQ,CAAC,mBAAmB,CAAsB;IAC1D,OAAO,CAAC,QAAQ,CAAC,aAAa,CAAyB;gBAGrD,OAAO,EAAE,cAAc,EACvB,mBAAmB,GAAE,WAAW,CAAC,MAAM,CAAa,EACpD,aAAa,GAAE,sBAA8C;IAO/D;;OAEG;IACH,WAAW,IAAI,YAAY,EAAE;IAM7B,OAAO,CAAC,aAAa;CAgHtB"}

package/dist/lib/handlers/groups/ReadOnlyHandlersGroup.js

@@ -28,16 +28,33 @@ const handleGetTransport_1 = require("../../../handlers/transport/readonly/handl
 const handleListTransports_1 = require("../../../handlers/transport/readonly/handleListTransports");
 const handleReadView_1 = require("../../../handlers/view/readonly/handleReadView");
 const BaseHandlerGroup_js_1 = require("../base/BaseHandlerGroup.js");
+const index_js_1 = require("./strategies/index.js");
 /**
  * Handler group for all readonly (read-only) handlers.
  * Contains handlers that only read data without modifying the ABAP system.
+ *
+ * When other groups (HighLevel / LowLevel / Compact) are also exposed, some
+ * readonly handlers semantically duplicate tools from those groups
+ * (e.g. ReadFunctionModule vs GetFunctionModule). The group hides such
+ * duplicates based on the injected override strategy and the set of tool
+ * names contributed by the other groups.
  */
 class ReadOnlyHandlersGroup extends BaseHandlerGroup_js_1.BaseHandlerGroup {
     groupName = 'ReadOnlyHandlers';
+    overridingToolNames;
+    dedupStrategy;
+    constructor(context, overridingToolNames = new Set(), dedupStrategy = new index_js_1.NoDedupStrategy()) {
+        super(context);
+        this.overridingToolNames = overridingToolNames;
+        this.dedupStrategy = dedupStrategy;
+    }
     /**
-     * Gets all readonly handler entries
+     * Gets all readonly handler entries, filtered by the dedup strategy.
      */
     getHandlers() {
+        return this.getAllEntries().filter((e) => !this.dedupStrategy.shouldExclude(e, this.overridingToolNames));
+    }
+    getAllEntries() {
         return [
             // Existing readonly handlers
             {

package/dist/lib/handlers/groups/ReadOnlyHandlersGroup.js.map

@@ -1 +1 @@
-{"version":3,"file":"ReadOnlyHandlersGroup.js","sourceRoot":"","sources":["../../../../src/lib/handlers/groups/ReadOnlyHandlersGroup.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"ReadOnlyHandlersGroup.js","sourceRoot":"","sources":["../../../../src/lib/handlers/groups/ReadOnlyHandlersGroup.ts"],"names":[],"mappings":";;;AAAA,8HAGqF;AACrF,0IAG6F;AAC7F,sFAG0D;AAC1D,yGAGuE;AACvE,yFAG4D;AAC5D,8GAGyE;AACzE,8GAGyE;AACzE,wGAGsE;AACtE,+GAG2E;AAC3E,kHAG6E;AAC7E,0FAG6D;AAC7D,oGAGkE;AAClE,kGAGkE;AAClE,2HAGmF;AACnF,0GAGqE;AACrE,4FAG8D;AAC9D,oGAGkE;AAClE,4FAG8D;AAC9D,kHAG6E;AAC7E,2HAGmF;AACnF,kGAGkE;AAClE,oGAGiE;AACjE,sFAG0D;AAC1D,gGAGiE;AACjE,oGAGmE;AACnE,mFAGwD;AACxD,qEAA+D;AAE/D,oDAG+B;AAE/B;;;;;;;;;GASG;AACH,MAAa,qBAAsB,SAAQ,sCAAgB;IAC/C,SAAS,GAAG,kBAAkB,CAAC;IACxB,mBAAmB,CAAsB;IACzC,aAAa,CAAyB;IAEvD,YACE,OAAuB,EACvB,sBAA2C,IAAI,GAAG,EAAE,EACpD,gBAAwC,IAAI,0BAAe,EAAE;QAE7D,KAAK,CAAC,OAAO,CAAC,CAAC;QACf,IAAI,CAAC,mBAAmB,GAAG,mBAAmB,CAAC;QAC/C,IAAI,CAAC,aAAa,GAAG,aAAa,CAAC;IACrC,CAAC;IAED;;OAEG;IACH,WAAW;QACT,OAAO,IAAI,CAAC,aAAa,EAAE,CAAC,MAAM,CAChC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,IAAI,CAAC,aAAa,CAAC,aAAa,CAAC,CAAC,EAAE,IAAI,CAAC,mBAAmB,CAAC,CACtE,CAAC;IACJ,CAAC;IAEO,aAAa;QACnB,OAAO;YACL,6BAA6B;YAC7B;gBACE,cAAc,EAAE,wCAAqB;gBACrC,OAAO,EAAE,CAAC,IAAS,EAAE,EAAE,CAAC,IAAA,+CAAsB,EAAC,IAAI,CAAC,OAAO,EAAE,IAAI,CAAC;aACnE;YACD;gBACE,cAAc,EAAE,0CAAuB;gBACvC,OAAO,EAAE,CAAC,IAAS,EAAE,EAAE,CAAC,IAAA,mDAAwB,EAAC,IAAI,CAAC,OAAO,EAAE,IAAI,CAAC;aACrE;YACD;gBACE,cAAc,EAAE,kCAAe;gBAC/B,OAAO,EAAE,CAAC,IAAS,EAAE,EAAE,CAAC,IAAA,mCAAgB,EAAC,IAAI,CAAC,OAAO,EAAE,IAAI,CAAC;aAC7D;YACD;gBACE,cAAc,EAAE,uCAAoB;gBACpC,OAAO,EAAE,CAAC,IAAS,EAAE,EAAE,CAAC,IAAA,6CAAqB,EAAC,IAAI,CAAC,OAAO,EAAE,IAAI,CAAC;aAClE;YACD;gBACE,cAAc,EAAE,uCAAoB;gBACpC,OAAO,EAAE,CAAC,IAAS,EAAE,EAAE,CAAC,IAAA,6CAAqB,EAAC,IAAI,CAAC,OAAO,EAAE,IAAI,CAAC;aAClE;YACD;gBACE,cAAc,EAAE,0CAAuB;gBACvC,OAAO,EAAE,CAAC,IAAS,EAAE,EAAE,CAAC,IAAA,mDAAwB,EAAC,IAAI,CAAC,OAAO,EAAE,IAAI,CAAC;aACrE;YACD;gBACE,cAAc,EAAE,0CAAuB;gBACvC,OAAO,EAAE,CAAC,IAAS,EAAE,EAAE,CAAC,IAAA,mDAAwB,EAAC,IAAI,CAAC,OAAO,EAAE,IAAI,CAAC;aACrE;YACD;gBACE,cAAc,EAAE,oCAAiB;gBACjC,OAAO,EAAE,CAAC,IAAS,EAAE,EAAE,CAAC,IAAA,uCAAkB,EAAC,IAAI,CAAC,OAAO,EAAE,IAAI,CAAC;aAC/D;YACD;gBACE,cAAc,EAAE,sCAAmB;gBACnC,OAAO,EAAE,CAAC,IAAS,EAAE,EAAE,CAAC,IAAA,2CAAoB,EAAC,IAAI,CAAC,OAAO,EAAE,IAAI,CAAC;aACjE;YACD;gBACE,cAAc,EAAE,uCAAoB;gBACpC,OAAO,EAAE,CAAC,IAAS,EAAE,EAAE,CAAC,IAAA,6CAAqB,EAAC,IAAI,CAAC,OAAO,EAAE,IAAI,CAAC;aAClE;YACD,yCAAyC;YACzC;gBACE,cAAc,EAAE,iCAAc;gBAC9B,OAAO,EAAE,CAAC,IAAS,EAAE,EAAE,CAAC,IAAA,iCAAe,EAAC,IAAI,CAAC,OAAO,EAAE,IAAI,CAAC;aAC5D;YACD;gBACE,cAAc,EAAE,qCAAkB;gBAClC,OAAO,EAAE,CAAC,IAAS,EAAE,EAAE,CAAC,IAAA,yCAAmB,EAAC,IAAI,CAAC,OAAO,EAAE,IAAI,CAAC;aAChE;YACD;gBACE,cAAc,EAAE,mCAAgB;gBAChC,OAAO,EAAE,CAAC,IAAS,EAAE,EAAE,CAAC,IAAA,qCAAiB,EAAC,IAAI,CAAC,OAAO,EAAE,IAAI,CAAC;aAC9D;YACD;gBACE,cAAc,EAAE,iCAAc;gBAC9B,OAAO,EAAE,CAAC,IAAS,EAAE,EAAE,CAAC,IAAA,iCAAe,EAAC,IAAI,CAAC,OAAO,EAAE,IAAI,CAAC;aAC5D;YACD;gBACE,cAAc,EAAE,qCAAkB;gBAClC,OAAO,EAAE,CAAC,IAAS,EAAE,EAAE,CAAC,IAAA,yCAAmB,EAAC,IAAI,CAAC,OAAO,EAAE,IAAI,CAAC;aAChE;YACD;gBACE,cAAc,EAAE,gCAAa;gBAC7B,OAAO,EAAE,CAAC,IAAS,EAAE,EAAE,CAAC,IAAA,+BAAc,EAAC,IAAI,CAAC,OAAO,EAAE,IAAI,CAAC;aAC3D;YACD;gBACE,cAAc,EAAE,kCAAe;gBAC/B,OAAO,EAAE,CAAC,IAAS,EAAE,EAAE,CAAC,IAAA,mCAAgB,EAAC,IAAI,CAAC,OAAO,EAAE,IAAI,CAAC;aAC7D;YACD;gBACE,cAAc,EAAE,uCAAoB;gBACpC,OAAO,EAAE,CAAC,IAAS,EAAE,EAAE,CAAC,IAAA,6CAAqB,EAAC,IAAI,CAAC,OAAO,EAAE,IAAI,CAAC;aAClE;YACD;gBACE,cAAc,EAAE,0CAAuB;gBACvC,OAAO,EAAE,CAAC,IAAS,EAAE,EAAE,CAAC,IAAA,mDAAwB,EAAC,IAAI,CAAC,OAAO,EAAE,IAAI,CAAC;aACrE;YACD;gBACE,cAAc,EAAE,yCAAsB;gBACtC,OAAO,EAAE,CAAC,IAAS,EAAE,EAAE,CAAC,IAAA,iDAAuB,EAAC,IAAI,CAAC,OAAO,EAAE,IAAI,CAAC;aACpE;YACD;gBACE,cAAc,EAAE,mCAAgB;gBAChC,OAAO,EAAE,CAAC,IAAS,EAAE,EAAE,CAAC,IAAA,qCAAiB,EAAC,IAAI,CAAC,OAAO,EAAE,IAAI,CAAC;aAC9D;YACD;gBACE,cAAc,EAAE,6CAA0B;gBAC1C,OAAO,EAAE,CAAC,IAAS,EAAE,EAAE,CAAC,IAAA,yDAA2B,EAAC,IAAI,CAAC,OAAO,EAAE,IAAI,CAAC;aACxE;YACD;gBACE,cAAc,EAAE,6CAA0B;gBAC1C,OAAO,EAAE,CAAC,IAAS,EAAE,EAAE,CAAC,IAAA,yDAA2B,EAAC,IAAI,CAAC,OAAO,EAAE,IAAI,CAAC;aACxE;YACD;gBACE,cAAc,EAAE,8CAA2B;gBAC3C,OAAO,EAAE,CAAC,IAAS,EAAE,EAAE,CACrB,IAAA,2DAA4B,EAAC,IAAI,CAAC,OAAO,EAAE,IAAI,CAAC;aACnD;YACD;gBACE,cAAc,EAAE,kDAA+B;gBAC/C,OAAO,EAAE,CAAC,IAAS,EAAE,EAAE,CACrB,IAAA,mEAAgC,EAAC,IAAI,CAAC,OAAO,EAAE,IAAI,CAAC;aACvD;YACD;gBACE,cAAc,EAAE,0CAAuB;gBACvC,OAAO,EAAE,CAAC,IAAS,EAAE,EAAE,CAAC,IAAA,mDAAwB,EAAC,IAAI,CAAC,OAAO,EAAE,IAAI,CAAC;aACrE;SACF,CAAC;IACJ,CAAC;CACF;AAxID,sDAwIC"}

package/dist/lib/handlers/groups/index.d.ts

@@ -11,4 +11,5 @@ export { LowLevelHandlersGroup } from './LowLevelHandlersGroup.js';
 export { ReadOnlyHandlersGroup } from './ReadOnlyHandlersGroup.js';
 export { SearchHandlersGroup } from './SearchHandlersGroup.js';
 export { SystemHandlersGroup } from './SystemHandlersGroup.js';
+export { type IReadOnlyDedupStrategy, NoDedupStrategy, ReadVsGetDedupStrategy, } from './strategies/index.js';
 //# sourceMappingURL=index.d.ts.map

package/dist/lib/handlers/groups/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/lib/handlers/groups/index.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EAAE,oBAAoB,EAAE,MAAM,2BAA2B,CAAC;AACjE,OAAO,EAAE,sBAAsB,EAAE,MAAM,6BAA6B,CAAC;AACrE,OAAO,EAAE,qBAAqB,EAAE,MAAM,4BAA4B,CAAC;AACnE,OAAO,EAAE,qBAAqB,EAAE,MAAM,4BAA4B,CAAC;AACnE,OAAO,EAAE,mBAAmB,EAAE,MAAM,0BAA0B,CAAC;AAC/D,OAAO,EAAE,mBAAmB,EAAE,MAAM,0BAA0B,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/lib/handlers/groups/index.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EAAE,oBAAoB,EAAE,MAAM,2BAA2B,CAAC;AACjE,OAAO,EAAE,sBAAsB,EAAE,MAAM,6BAA6B,CAAC;AACrE,OAAO,EAAE,qBAAqB,EAAE,MAAM,4BAA4B,CAAC;AACnE,OAAO,EAAE,qBAAqB,EAAE,MAAM,4BAA4B,CAAC;AACnE,OAAO,EAAE,mBAAmB,EAAE,MAAM,0BAA0B,CAAC;AAC/D,OAAO,EAAE,mBAAmB,EAAE,MAAM,0BAA0B,CAAC;AAC/D,OAAO,EACL,KAAK,sBAAsB,EAC3B,eAAe,EACf,sBAAsB,GACvB,MAAM,uBAAuB,CAAC"}

package/dist/lib/handlers/groups/index.js

@@ -7,7 +7,7 @@
  * to use different sets of handlers.
  */
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.SystemHandlersGroup = exports.SearchHandlersGroup = exports.ReadOnlyHandlersGroup = exports.LowLevelHandlersGroup = exports.HighLevelHandlersGroup = exports.CompactHandlersGroup = void 0;
+exports.ReadVsGetDedupStrategy = exports.NoDedupStrategy = exports.SystemHandlersGroup = exports.SearchHandlersGroup = exports.ReadOnlyHandlersGroup = exports.LowLevelHandlersGroup = exports.HighLevelHandlersGroup = exports.CompactHandlersGroup = void 0;
 var CompactHandlersGroup_js_1 = require("./CompactHandlersGroup.js");
 Object.defineProperty(exports, "CompactHandlersGroup", { enumerable: true, get: function () { return CompactHandlersGroup_js_1.CompactHandlersGroup; } });
 var HighLevelHandlersGroup_js_1 = require("./HighLevelHandlersGroup.js");
@@ -20,4 +20,7 @@ var SearchHandlersGroup_js_1 = require("./SearchHandlersGroup.js");
 Object.defineProperty(exports, "SearchHandlersGroup", { enumerable: true, get: function () { return SearchHandlersGroup_js_1.SearchHandlersGroup; } });
 var SystemHandlersGroup_js_1 = require("./SystemHandlersGroup.js");
 Object.defineProperty(exports, "SystemHandlersGroup", { enumerable: true, get: function () { return SystemHandlersGroup_js_1.SystemHandlersGroup; } });
+var index_js_1 = require("./strategies/index.js");
+Object.defineProperty(exports, "NoDedupStrategy", { enumerable: true, get: function () { return index_js_1.NoDedupStrategy; } });
+Object.defineProperty(exports, "ReadVsGetDedupStrategy", { enumerable: true, get: function () { return index_js_1.ReadVsGetDedupStrategy; } });
 //# sourceMappingURL=index.js.map

package/dist/lib/handlers/groups/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/lib/handlers/groups/index.ts"],"names":[],"mappings":";AAAA;;;;;;GAMG;;;AAEH,qEAAiE;AAAxD,+HAAA,oBAAoB,OAAA;AAC7B,yEAAqE;AAA5D,mIAAA,sBAAsB,OAAA;AAC/B,uEAAmE;AAA1D,iIAAA,qBAAqB,OAAA;AAC9B,uEAAmE;AAA1D,iIAAA,qBAAqB,OAAA;AAC9B,mEAA+D;AAAtD,6HAAA,mBAAmB,OAAA;AAC5B,mEAA+D;AAAtD,6HAAA,mBAAmB,OAAA"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/lib/handlers/groups/index.ts"],"names":[],"mappings":";AAAA;;;;;;GAMG;;;AAEH,qEAAiE;AAAxD,+HAAA,oBAAoB,OAAA;AAC7B,yEAAqE;AAA5D,mIAAA,sBAAsB,OAAA;AAC/B,uEAAmE;AAA1D,iIAAA,qBAAqB,OAAA;AAC9B,uEAAmE;AAA1D,iIAAA,qBAAqB,OAAA;AAC9B,mEAA+D;AAAtD,6HAAA,mBAAmB,OAAA;AAC5B,mEAA+D;AAAtD,6HAAA,mBAAmB,OAAA;AAC5B,kDAI+B;AAF7B,2GAAA,eAAe,OAAA;AACf,kHAAA,sBAAsB,OAAA"}

package/dist/lib/handlers/groups/strategies/IReadOnlyDedupStrategy.d.ts

@@ -0,0 +1,15 @@
+import type { HandlerEntry } from '../../interfaces.js';
+/**
+ * Strategy that decides whether a readonly handler entry should be deduped
+ * (excluded) from the ReadOnly group when overriding handler groups
+ * (high / low / compact) are also exposed.
+ */
+export interface IReadOnlyDedupStrategy {
+    /**
+     * @param entry readonly handler entry being considered
+     * @param overridingToolNames tool names contributed by non-readonly groups
+     * @returns true if the entry should be excluded from the readonly group
+     */
+    shouldExclude(entry: HandlerEntry, overridingToolNames: ReadonlySet<string>): boolean;
+}
+//# sourceMappingURL=IReadOnlyDedupStrategy.d.ts.map

package/dist/lib/handlers/groups/strategies/IReadOnlyDedupStrategy.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"IReadOnlyDedupStrategy.d.ts","sourceRoot":"","sources":["../../../../../src/lib/handlers/groups/strategies/IReadOnlyDedupStrategy.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AAExD;;;;GAIG;AACH,MAAM,WAAW,sBAAsB;IACrC;;;;OAIG;IACH,aAAa,CACX,KAAK,EAAE,YAAY,EACnB,mBAAmB,EAAE,WAAW,CAAC,MAAM,CAAC,GACvC,OAAO,CAAC;CACZ"}

package/dist/lib/handlers/groups/strategies/IReadOnlyDedupStrategy.js

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

package/dist/lib/handlers/groups/strategies/IReadOnlyDedupStrategy.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"IReadOnlyDedupStrategy.js","sourceRoot":"","sources":["../../../../../src/lib/handlers/groups/strategies/IReadOnlyDedupStrategy.ts"],"names":[],"mappings":""}

package/dist/lib/handlers/groups/strategies/NoDedupStrategy.d.ts

@@ -0,0 +1,10 @@
+import type { HandlerEntry } from '../../interfaces.js';
+import type { IReadOnlyDedupStrategy } from './IReadOnlyDedupStrategy.js';
+/**
+ * Null strategy — never excludes anything. Useful when the caller wants to
+ * expose the readonly group as-is regardless of other groups present.
+ */
+export declare class NoDedupStrategy implements IReadOnlyDedupStrategy {
+    shouldExclude(_entry: HandlerEntry, _overridingToolNames: ReadonlySet<string>): boolean;
+}
+//# sourceMappingURL=NoDedupStrategy.d.ts.map

package/dist/lib/handlers/groups/strategies/NoDedupStrategy.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"NoDedupStrategy.d.ts","sourceRoot":"","sources":["../../../../../src/lib/handlers/groups/strategies/NoDedupStrategy.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AACxD,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,6BAA6B,CAAC;AAE1E;;;GAGG;AACH,qBAAa,eAAgB,YAAW,sBAAsB;IAC5D,aAAa,CACX,MAAM,EAAE,YAAY,EACpB,oBAAoB,EAAE,WAAW,CAAC,MAAM,CAAC,GACxC,OAAO;CAGX"}

package/dist/lib/handlers/groups/strategies/NoDedupStrategy.js

@@ -0,0 +1,14 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.NoDedupStrategy = void 0;
+/**
+ * Null strategy — never excludes anything. Useful when the caller wants to
+ * expose the readonly group as-is regardless of other groups present.
+ */
+class NoDedupStrategy {
+    shouldExclude(_entry, _overridingToolNames) {
+        return false;
+    }
+}
+exports.NoDedupStrategy = NoDedupStrategy;
+//# sourceMappingURL=NoDedupStrategy.js.map

package/dist/lib/handlers/groups/strategies/NoDedupStrategy.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"NoDedupStrategy.js","sourceRoot":"","sources":["../../../../../src/lib/handlers/groups/strategies/NoDedupStrategy.ts"],"names":[],"mappings":";;;AAGA;;;GAGG;AACH,MAAa,eAAe;IAC1B,aAAa,CACX,MAAoB,EACpB,oBAAyC;QAEzC,OAAO,KAAK,CAAC;IACf,CAAC;CACF;AAPD,0CAOC"}

package/dist/lib/handlers/groups/strategies/ReadVsGetDedupStrategy.d.ts

@@ -0,0 +1,14 @@
+import type { HandlerEntry } from '../../interfaces.js';
+import type { IReadOnlyDedupStrategy } from './IReadOnlyDedupStrategy.js';
+/**
+ * Excludes a readonly `Read<X>` handler when a corresponding `Get<X>` handler
+ * is contributed by another group (HighLevel) or when the HighLevel/LowLevel
+ * groups otherwise provide a semantic replacement.
+ *
+ * Standalone `Get*` / `List*` readonly handlers (e.g. GetEnhancements,
+ * ListTransports) are never excluded — they have no pair in other groups.
+ */
+export declare class ReadVsGetDedupStrategy implements IReadOnlyDedupStrategy {
+    shouldExclude(entry: HandlerEntry, overridingToolNames: ReadonlySet<string>): boolean;
+}
+//# sourceMappingURL=ReadVsGetDedupStrategy.d.ts.map

package/dist/lib/handlers/groups/strategies/ReadVsGetDedupStrategy.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ReadVsGetDedupStrategy.d.ts","sourceRoot":"","sources":["../../../../../src/lib/handlers/groups/strategies/ReadVsGetDedupStrategy.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AACxD,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,6BAA6B,CAAC;AAE1E;;;;;;;GAOG;AACH,qBAAa,sBAAuB,YAAW,sBAAsB;IACnE,aAAa,CACX,KAAK,EAAE,YAAY,EACnB,mBAAmB,EAAE,WAAW,CAAC,MAAM,CAAC,GACvC,OAAO;CAMX"}

package/dist/lib/handlers/groups/strategies/ReadVsGetDedupStrategy.js

@@ -0,0 +1,22 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ReadVsGetDedupStrategy = void 0;
+/**
+ * Excludes a readonly `Read<X>` handler when a corresponding `Get<X>` handler
+ * is contributed by another group (HighLevel) or when the HighLevel/LowLevel
+ * groups otherwise provide a semantic replacement.
+ *
+ * Standalone `Get*` / `List*` readonly handlers (e.g. GetEnhancements,
+ * ListTransports) are never excluded — they have no pair in other groups.
+ */
+class ReadVsGetDedupStrategy {
+    shouldExclude(entry, overridingToolNames) {
+        const name = entry.toolDefinition.name;
+        if (!name.startsWith('Read'))
+            return false;
+        const getName = 'Get' + name.slice('Read'.length);
+        return overridingToolNames.has(getName);
+    }
+}
+exports.ReadVsGetDedupStrategy = ReadVsGetDedupStrategy;
+//# sourceMappingURL=ReadVsGetDedupStrategy.js.map

package/dist/lib/handlers/groups/strategies/ReadVsGetDedupStrategy.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ReadVsGetDedupStrategy.js","sourceRoot":"","sources":["../../../../../src/lib/handlers/groups/strategies/ReadVsGetDedupStrategy.ts"],"names":[],"mappings":";;;AAGA;;;;;;;GAOG;AACH,MAAa,sBAAsB;IACjC,aAAa,CACX,KAAmB,EACnB,mBAAwC;QAExC,MAAM,IAAI,GAAG,KAAK,CAAC,cAAc,CAAC,IAAI,CAAC;QACvC,IAAI,CAAC,IAAI,CAAC,UAAU,CAAC,MAAM,CAAC;YAAE,OAAO,KAAK,CAAC;QAC3C,MAAM,OAAO,GAAG,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC;QAClD,OAAO,mBAAmB,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC;IAC1C,CAAC;CACF;AAVD,wDAUC"}

package/dist/lib/handlers/groups/strategies/index.d.ts

@@ -0,0 +1,4 @@
+export type { IReadOnlyDedupStrategy } from './IReadOnlyDedupStrategy.js';
+export { NoDedupStrategy } from './NoDedupStrategy.js';
+export { ReadVsGetDedupStrategy } from './ReadVsGetDedupStrategy.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/lib/handlers/groups/strategies/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../src/lib/handlers/groups/strategies/index.ts"],"names":[],"mappings":"AAAA,YAAY,EAAE,sBAAsB,EAAE,MAAM,6BAA6B,CAAC;AAC1E,OAAO,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAC;AACvD,OAAO,EAAE,sBAAsB,EAAE,MAAM,6BAA6B,CAAC"}

package/dist/lib/handlers/groups/strategies/index.js

@@ -0,0 +1,8 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ReadVsGetDedupStrategy = exports.NoDedupStrategy = void 0;
+var NoDedupStrategy_js_1 = require("./NoDedupStrategy.js");
+Object.defineProperty(exports, "NoDedupStrategy", { enumerable: true, get: function () { return NoDedupStrategy_js_1.NoDedupStrategy; } });
+var ReadVsGetDedupStrategy_js_1 = require("./ReadVsGetDedupStrategy.js");
+Object.defineProperty(exports, "ReadVsGetDedupStrategy", { enumerable: true, get: function () { return ReadVsGetDedupStrategy_js_1.ReadVsGetDedupStrategy; } });
+//# sourceMappingURL=index.js.map

package/dist/lib/handlers/groups/strategies/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../../src/lib/handlers/groups/strategies/index.ts"],"names":[],"mappings":";;;AACA,2DAAuD;AAA9C,qHAAA,eAAe,OAAA;AACxB,yEAAqE;AAA5D,mIAAA,sBAAsB,OAAA"}

package/dist/server/EmbeddableMcpServer.d.ts

@@ -1,5 +1,6 @@
 import type { AbapConnection } from '@mcp-abap-adt/connection';
 import type { Logger } from '@mcp-abap-adt/logger';
+import type { IReadOnlyDedupStrategy } from '../lib/handlers/groups/strategies/index.js';
 import type { IHandlersRegistry, SapEnvironment } from '../lib/handlers/interfaces.js';
 import type { IAdtSystemContext } from '../lib/systemContext.js';
 import { BaseMcpServer } from './BaseMcpServer.js';
@@ -49,6 +50,17 @@ export interface EmbeddableMcpServerOptions {
      * mutating `process.env.SAP_SYSTEM_TYPE` per instance is not safe.
      */
     systemType?: SapEnvironment;
+    /**
+     * Optional strategy that decides which readonly handlers to dedup (hide)
+     * when overriding groups (high / low / compact) are also exposed.
+     *
+     * Default: no dedup — readonly handlers are exposed verbatim, preserving
+     * prior behavior for existing consumers. Pass `new ReadVsGetDedupStrategy()`
+     * (exported from this package) to hide `Read<X>` when a corresponding
+     * `Get<X>` is contributed by another group, or supply a custom
+     * implementation for bespoke role-based rules.
+     */
+    readOnlyDedupStrategy?: IReadOnlyDedupStrategy;
 }
 /**
  * Embeddable MCP Server for integration with external applications

package/dist/server/EmbeddableMcpServer.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"EmbeddableMcpServer.d.ts","sourceRoot":"","sources":["../../src/server/EmbeddableMcpServer.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,0BAA0B,CAAC;AAC/D,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,sBAAsB,CAAC;AASnD,OAAO,KAAK,EAEV,iBAAiB,EACjB,cAAc,EACf,MAAM,+BAA+B,CAAC;AAEvC,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,yBAAyB,CAAC;AAEjE,OAAO,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AAInD;;GAEG;AACH,MAAM,WAAW,0BAA0B;IACzC;;;OAGG;IACH,UAAU,EAAE,cAAc,CAAC;IAE3B;;;OAGG;IACH,MAAM,CAAC,EAAE,MAAM,CAAC;IAEhB;;;OAGG;IACH,gBAAgB,CAAC,EAAE,iBAAiB,CAAC;IAErC;;;OAGG;IACH,UAAU,CAAC,EAAE,CACT,UAAU,GACV,MAAM,GACN,KAAK,GACL,SAAS,GACT,QAAQ,GACR,QAAQ,CACX,EAAE,CAAC;IAEJ;;;OAGG;IACH,OAAO,CAAC,EAAE,MAAM,CAAC;IAEjB;;;;OAIG;IACH,aAAa,CAAC,EAAE,OAAO,CAAC,iBAAiB,CAAC,CAAC;IAE3C;;;;;;;;;OASG;IACH,UAAU,CAAC,EAAE,cAAc,CAAC;CAC7B;AAED;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,qBAAa,mBAAoB,SAAQ,aAAa;IACpD,OAAO,CAAC,QAAQ,CAAC,kBAAkB,CAAiB;gBAExC,OAAO,EAAE,0BAA0B;IAyB/C;;;OAGG;cACa,aAAa,IAAI,OAAO,CAAC,cAAc,CAAC;IAIxD;;OAEG;IACH,OAAO,CAAC,qBAAqB;CAyC9B"}
+{"version":3,"file":"EmbeddableMcpServer.d.ts","sourceRoot":"","sources":["../../src/server/EmbeddableMcpServer.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,0BAA0B,CAAC;AAC/D,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,sBAAsB,CAAC;AASnD,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,4CAA4C,CAAC;AACzF,OAAO,KAAK,EAEV,iBAAiB,EACjB,cAAc,EACf,MAAM,+BAA+B,CAAC;AAEvC,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,yBAAyB,CAAC;AAEjE,OAAO,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AAInD;;GAEG;AACH,MAAM,WAAW,0BAA0B;IACzC;;;OAGG;IACH,UAAU,EAAE,cAAc,CAAC;IAE3B;;;OAGG;IACH,MAAM,CAAC,EAAE,MAAM,CAAC;IAEhB;;;OAGG;IACH,gBAAgB,CAAC,EAAE,iBAAiB,CAAC;IAErC;;;OAGG;IACH,UAAU,CAAC,EAAE,CACT,UAAU,GACV,MAAM,GACN,KAAK,GACL,SAAS,GACT,QAAQ,GACR,QAAQ,CACX,EAAE,CAAC;IAEJ;;;OAGG;IACH,OAAO,CAAC,EAAE,MAAM,CAAC;IAEjB;;;;OAIG;IACH,aAAa,CAAC,EAAE,OAAO,CAAC,iBAAiB,CAAC,CAAC;IAE3C;;;;;;;;;OASG;IACH,UAAU,CAAC,EAAE,cAAc,CAAC;IAE5B;;;;;;;;;OASG;IACH,qBAAqB,CAAC,EAAE,sBAAsB,CAAC;CAChD;AAED;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,qBAAa,mBAAoB,SAAQ,aAAa;IACpD,OAAO,CAAC,QAAQ,CAAC,kBAAkB,CAAiB;gBAExC,OAAO,EAAE,0BAA0B;IA0B/C;;;OAGG;cACa,aAAa,IAAI,OAAO,CAAC,cAAc,CAAC;IAIxD;;OAEG;IACH,OAAO,CAAC,qBAAqB;CA6D9B"}