@mcp-abap-adt/core 2.1.3 → 2.1.6

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

@@ -0,0 +1,13 @@
+/**
+ * Handler groups exports
+ *
+ * Handler groups allow splitting handlers into logical groups for flexible composition.
+ * Each group can be injected independently, allowing different server configurations
+ * to use different sets of handlers.
+ */
+export { ReadOnlyHandlersGroup } from "./ReadOnlyHandlersGroup.js";
+export { HighLevelHandlersGroup } from "./HighLevelHandlersGroup.js";
+export { LowLevelHandlersGroup } from "./LowLevelHandlersGroup.js";
+export { SystemHandlersGroup } from "./SystemHandlersGroup.js";
+export { SearchHandlersGroup } from "./SearchHandlersGroup.js";
+//# sourceMappingURL=index.d.ts.map

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

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

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

@@ -0,0 +1,21 @@
+"use strict";
+/**
+ * Handler groups exports
+ *
+ * Handler groups allow splitting handlers into logical groups for flexible composition.
+ * Each group can be injected independently, allowing different server configurations
+ * to use different sets of handlers.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.SearchHandlersGroup = exports.SystemHandlersGroup = exports.LowLevelHandlersGroup = exports.HighLevelHandlersGroup = exports.ReadOnlyHandlersGroup = void 0;
+var ReadOnlyHandlersGroup_js_1 = require("./ReadOnlyHandlersGroup.js");
+Object.defineProperty(exports, "ReadOnlyHandlersGroup", { enumerable: true, get: function () { return ReadOnlyHandlersGroup_js_1.ReadOnlyHandlersGroup; } });
+var HighLevelHandlersGroup_js_1 = require("./HighLevelHandlersGroup.js");
+Object.defineProperty(exports, "HighLevelHandlersGroup", { enumerable: true, get: function () { return HighLevelHandlersGroup_js_1.HighLevelHandlersGroup; } });
+var LowLevelHandlersGroup_js_1 = require("./LowLevelHandlersGroup.js");
+Object.defineProperty(exports, "LowLevelHandlersGroup", { enumerable: true, get: function () { return LowLevelHandlersGroup_js_1.LowLevelHandlersGroup; } });
+var SystemHandlersGroup_js_1 = require("./SystemHandlersGroup.js");
+Object.defineProperty(exports, "SystemHandlersGroup", { enumerable: true, get: function () { return SystemHandlersGroup_js_1.SystemHandlersGroup; } });
+var SearchHandlersGroup_js_1 = require("./SearchHandlersGroup.js");
+Object.defineProperty(exports, "SearchHandlersGroup", { enumerable: true, get: function () { return SearchHandlersGroup_js_1.SearchHandlersGroup; } });
+//# sourceMappingURL=index.js.map

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

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

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

@@ -0,0 +1,14 @@
+/**
+ * Handlers module exports
+ *
+ * This module provides:
+ * - Interfaces for handler groups and registries
+ * - Base classes for creating handler groups
+ * - Composite registry that supports Dependency Injection of handler groups
+ * - Concrete handler group implementations
+ */
+export * from "./interfaces.js";
+export { BaseHandlerGroup } from "./base/BaseHandlerGroup.js";
+export { CompositeHandlersRegistry } from "./registry/CompositeHandlersRegistry.js";
+export * from "./groups/index.js";
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/lib/handlers/handlers/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAGH,cAAc,iBAAiB,CAAC;AAGhC,OAAO,EAAE,gBAAgB,EAAE,MAAM,4BAA4B,CAAC;AAG9D,OAAO,EAAE,yBAAyB,EAAE,MAAM,yCAAyC,CAAC;AAGpF,cAAc,mBAAmB,CAAC"}

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

@@ -0,0 +1,37 @@
+"use strict";
+/**
+ * Handlers module exports
+ *
+ * This module provides:
+ * - Interfaces for handler groups and registries
+ * - Base classes for creating handler groups
+ * - Composite registry that supports Dependency Injection of handler groups
+ * - Concrete handler group implementations
+ */
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.CompositeHandlersRegistry = exports.BaseHandlerGroup = void 0;
+// Interfaces
+__exportStar(require("./interfaces.js"), exports);
+// Base classes
+var BaseHandlerGroup_js_1 = require("./base/BaseHandlerGroup.js");
+Object.defineProperty(exports, "BaseHandlerGroup", { enumerable: true, get: function () { return BaseHandlerGroup_js_1.BaseHandlerGroup; } });
+// Registry implementations
+var CompositeHandlersRegistry_js_1 = require("./registry/CompositeHandlersRegistry.js");
+Object.defineProperty(exports, "CompositeHandlersRegistry", { enumerable: true, get: function () { return CompositeHandlersRegistry_js_1.CompositeHandlersRegistry; } });
+// Handler groups
+__exportStar(require("./groups/index.js"), exports);
+//# sourceMappingURL=index.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/lib/handlers/handlers/index.ts"],"names":[],"mappings":";AAAA;;;;;;;;GAQG;;;;;;;;;;;;;;;;;AAEH,aAAa;AACb,kDAAgC;AAEhC,eAAe;AACf,kEAA8D;AAArD,uHAAA,gBAAgB,OAAA;AAEzB,2BAA2B;AAC3B,wFAAoF;AAA3E,yIAAA,yBAAyB,OAAA;AAElC,iBAAiB;AACjB,oDAAkC"}

package/dist/lib/handlers/handlers/interfaces.d.ts

@@ -0,0 +1,67 @@
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import type { HandlerContext } from "../../handlers/interfaces.js";
+/**
+ * Tool definition structure
+ */
+export interface ToolDefinition {
+    name: string;
+    description: string;
+    inputSchema: any;
+}
+/**
+ * Tool handler function type with context injection
+ * Context (containing connection and logger) is injected automatically by BaseMcpServer.registerHandlers()
+ * and is NOT part of MCP tool signature
+ */
+export type ToolHandler = (context: HandlerContext, args: any) => Promise<any>;
+/**
+ * Handler registration entry
+ */
+export interface HandlerEntry {
+    toolDefinition: ToolDefinition;
+    handler: ToolHandler;
+}
+/**
+ * Interface for a group of handlers
+ * Allows splitting handlers into logical groups (readonly, high-level, low-level, system, etc.)
+ */
+export interface IHandlerGroup {
+    /**
+     * Gets the name of the handler group (for identification and debugging)
+     */
+    getName(): string;
+    /**
+     * Gets all handler entries in this group
+     * @returns Array of handler entries (tool definition + handler function)
+     */
+    getHandlers(): HandlerEntry[];
+    /**
+     * Registers all handlers from this group on the MCP server
+     * @param server - McpServer instance for tool registration
+     */
+    registerHandlers(server: McpServer): void;
+}
+/**
+ * Interface for handlers registry
+ * Supports registration through handler groups via Dependency Injection
+ */
+export interface IHandlersRegistry {
+    /**
+     * Registers all tools on MCP server
+     * @param server - McpServer instance for tool registration
+     */
+    registerAllTools(server: McpServer): void;
+    /**
+     * Registers a single tool on server
+     * @param server - McpServer instance
+     * @param toolName - tool name
+     * @param toolDefinition - tool definition (name, description, inputSchema)
+     * @param handler - handler function
+     */
+    registerTool(server: McpServer, toolName: string, toolDefinition: ToolDefinition, handler: ToolHandler): void;
+    /**
+     * Gets list of registered tools
+     */
+    getRegisteredTools(): string[];
+}
+//# sourceMappingURL=interfaces.d.ts.map

package/dist/lib/handlers/handlers/interfaces.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"interfaces.d.ts","sourceRoot":"","sources":["../../../../src/lib/handlers/handlers/interfaces.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAEpE,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,8BAA8B,CAAC;AAEnE;;GAEG;AACH,MAAM,WAAW,cAAc;IAC7B,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,WAAW,EAAE,GAAG,CAAC;CAClB;AAED;;;;GAIG;AACH,MAAM,MAAM,WAAW,GAAG,CAAC,OAAO,EAAE,cAAc,EAAE,IAAI,EAAE,GAAG,KAAK,OAAO,CAAC,GAAG,CAAC,CAAC;AAE/E;;GAEG;AACH,MAAM,WAAW,YAAY;IAC3B,cAAc,EAAE,cAAc,CAAC;IAC/B,OAAO,EAAE,WAAW,CAAC;CACtB;AAED;;;GAGG;AACH,MAAM,WAAW,aAAa;IAC5B;;OAEG;IACH,OAAO,IAAI,MAAM,CAAC;IAElB;;;OAGG;IACH,WAAW,IAAI,YAAY,EAAE,CAAC;IAE9B;;;OAGG;IACH,gBAAgB,CAAC,MAAM,EAAE,SAAS,GAAG,IAAI,CAAC;CAC3C;AAED;;;GAGG;AACH,MAAM,WAAW,iBAAiB;IAChC;;;OAGG;IACH,gBAAgB,CAAC,MAAM,EAAE,SAAS,GAAG,IAAI,CAAC;IAE1C;;;;;;OAMG;IACH,YAAY,CACV,MAAM,EAAE,SAAS,EACjB,QAAQ,EAAE,MAAM,EAChB,cAAc,EAAE,cAAc,EAC9B,OAAO,EAAE,WAAW,GACnB,IAAI,CAAC;IAER;;OAEG;IACH,kBAAkB,IAAI,MAAM,EAAE,CAAC;CAChC"}

package/dist/lib/handlers/handlers/interfaces.js

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

package/dist/lib/handlers/handlers/interfaces.js.map

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

package/dist/lib/handlers/handlers/registry/CompositeHandlersRegistry.d.ts

@@ -0,0 +1,49 @@
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import { IHandlersRegistry, IHandlerGroup, ToolDefinition, ToolHandler } from "../interfaces.js";
+/**
+ * Composite handlers registry that accepts multiple handler groups via Dependency Injection
+ * Allows flexible composition of handler sets based on requirements
+ */
+export declare class CompositeHandlersRegistry implements IHandlersRegistry {
+    private registeredTools;
+    private handlerGroups;
+    private readonly failOnDuplicate;
+    /**
+     * Creates a composite registry with the specified handler groups
+     * @param handlerGroups - Array of handler groups to register
+     * @param failOnDuplicate - When true, throws on duplicate tool names (useful in dev)
+     */
+    constructor(handlerGroups?: IHandlerGroup[], failOnDuplicate?: boolean);
+    /**
+     * Adds a handler group to the registry
+     * @param group - Handler group to add
+     */
+    addHandlerGroup(group: IHandlerGroup): void;
+    /**
+     * Removes a handler group from the registry
+     * @param groupName - Name of the group to remove
+     */
+    removeHandlerGroup(groupName: string): void;
+    /**
+     * Gets all handler groups in this registry
+     */
+    getHandlerGroups(): IHandlerGroup[];
+    /**
+     * Registers all tools from all handler groups on MCP server
+     */
+    registerAllTools(server: McpServer): void;
+    /**
+     * Registers a single tool on server
+     * Note: This method is provided for compatibility, but it's recommended to use handler groups
+     */
+    registerTool(server: McpServer, toolName: string, toolDefinition: ToolDefinition, handler: ToolHandler): void;
+    /**
+     * Gets list of registered tools
+     */
+    getRegisteredTools(): string[];
+    /**
+     * Gets list of handler group names
+     */
+    getHandlerGroupNames(): string[];
+}
+//# sourceMappingURL=CompositeHandlersRegistry.d.ts.map

package/dist/lib/handlers/handlers/registry/CompositeHandlersRegistry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"CompositeHandlersRegistry.d.ts","sourceRoot":"","sources":["../../../../../src/lib/handlers/handlers/registry/CompositeHandlersRegistry.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AACpE,OAAO,EAAE,iBAAiB,EAAE,aAAa,EAAE,cAAc,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAEjG;;;GAGG;AACH,qBAAa,yBAA0B,YAAW,iBAAiB;IACjE,OAAO,CAAC,eAAe,CAA0B;IACjD,OAAO,CAAC,aAAa,CAAkB;IACvC,OAAO,CAAC,QAAQ,CAAC,eAAe,CAAU;IAE1C;;;;OAIG;gBACS,aAAa,GAAE,aAAa,EAAO,EAAE,eAAe,GAAE,OAAc;IAKhF;;;OAGG;IACH,eAAe,CAAC,KAAK,EAAE,aAAa,GAAG,IAAI;IAI3C;;;OAGG;IACH,kBAAkB,CAAC,SAAS,EAAE,MAAM,GAAG,IAAI;IAI3C;;OAEG;IACH,gBAAgB,IAAI,aAAa,EAAE;IAInC;;OAEG;IACH,gBAAgB,CAAC,MAAM,EAAE,SAAS,GAAG,IAAI;IAsBzC;;;OAGG;IACH,YAAY,CACV,MAAM,EAAE,SAAS,EACjB,QAAQ,EAAE,MAAM,EAChB,cAAc,EAAE,cAAc,EAC9B,OAAO,EAAE,WAAW,GACnB,IAAI;IAWP;;OAEG;IACH,kBAAkB,IAAI,MAAM,EAAE;IAI9B;;OAEG;IACH,oBAAoB,IAAI,MAAM,EAAE;CAGjC"}

package/dist/lib/handlers/handlers/registry/CompositeHandlersRegistry.js

@@ -0,0 +1,88 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.CompositeHandlersRegistry = void 0;
+/**
+ * Composite handlers registry that accepts multiple handler groups via Dependency Injection
+ * Allows flexible composition of handler sets based on requirements
+ */
+class CompositeHandlersRegistry {
+    registeredTools = new Set();
+    handlerGroups;
+    failOnDuplicate;
+    /**
+     * Creates a composite registry with the specified handler groups
+     * @param handlerGroups - Array of handler groups to register
+     * @param failOnDuplicate - When true, throws on duplicate tool names (useful in dev)
+     */
+    constructor(handlerGroups = [], failOnDuplicate = true) {
+        this.handlerGroups = handlerGroups;
+        this.failOnDuplicate = failOnDuplicate;
+    }
+    /**
+     * Adds a handler group to the registry
+     * @param group - Handler group to add
+     */
+    addHandlerGroup(group) {
+        this.handlerGroups.push(group);
+    }
+    /**
+     * Removes a handler group from the registry
+     * @param groupName - Name of the group to remove
+     */
+    removeHandlerGroup(groupName) {
+        this.handlerGroups = this.handlerGroups.filter(g => g.getName() !== groupName);
+    }
+    /**
+     * Gets all handler groups in this registry
+     */
+    getHandlerGroups() {
+        return [...this.handlerGroups];
+    }
+    /**
+     * Registers all tools from all handler groups on MCP server
+     */
+    registerAllTools(server) {
+        this.registeredTools.clear();
+        for (const group of this.handlerGroups) {
+            const handlers = group.getHandlers();
+            for (const entry of handlers) {
+                const name = entry.toolDefinition.name;
+                if (this.registeredTools.has(name)) {
+                    const msg = `Duplicate tool registration detected: "${name}" in group "${group.getName()}"`;
+                    if (this.failOnDuplicate) {
+                        throw new Error(msg);
+                    }
+                    // Skip duplicate if not failing
+                    continue;
+                }
+                this.registeredTools.add(name);
+            }
+            // Use group's own registration logic (preserves schema conversions)
+            group.registerHandlers(server);
+        }
+    }
+    /**
+     * Registers a single tool on server
+     * Note: This method is provided for compatibility, but it's recommended to use handler groups
+     */
+    registerTool(server, toolName, toolDefinition, handler) {
+        server.registerTool(toolName, {
+            description: toolDefinition.description,
+            inputSchema: toolDefinition.inputSchema,
+        }, handler);
+    }
+    /**
+     * Gets list of registered tools
+     */
+    getRegisteredTools() {
+        return Array.from(this.registeredTools);
+    }
+    /**
+     * Gets list of handler group names
+     */
+    getHandlerGroupNames() {
+        return this.handlerGroups.map(g => g.getName());
+    }
+}
+exports.CompositeHandlersRegistry = CompositeHandlersRegistry;
+//# sourceMappingURL=CompositeHandlersRegistry.js.map

package/dist/lib/handlers/handlers/registry/CompositeHandlersRegistry.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"CompositeHandlersRegistry.js","sourceRoot":"","sources":["../../../../../src/lib/handlers/handlers/registry/CompositeHandlersRegistry.ts"],"names":[],"mappings":";;;AAGA;;;GAGG;AACH,MAAa,yBAAyB;IAC5B,eAAe,GAAgB,IAAI,GAAG,EAAE,CAAC;IACzC,aAAa,CAAkB;IACtB,eAAe,CAAU;IAE1C;;;;OAIG;IACH,YAAY,gBAAiC,EAAE,EAAE,kBAA2B,IAAI;QAC9E,IAAI,CAAC,aAAa,GAAG,aAAa,CAAC;QACnC,IAAI,CAAC,eAAe,GAAG,eAAe,CAAC;IACzC,CAAC;IAED;;;OAGG;IACH,eAAe,CAAC,KAAoB;QAClC,IAAI,CAAC,aAAa,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;IACjC,CAAC;IAED;;;OAGG;IACH,kBAAkB,CAAC,SAAiB;QAClC,IAAI,CAAC,aAAa,GAAG,IAAI,CAAC,aAAa,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,OAAO,EAAE,KAAK,SAAS,CAAC,CAAC;IACjF,CAAC;IAED;;OAEG;IACH,gBAAgB;QACd,OAAO,CAAC,GAAG,IAAI,CAAC,aAAa,CAAC,CAAC;IACjC,CAAC;IAED;;OAEG;IACH,gBAAgB,CAAC,MAAiB;QAChC,IAAI,CAAC,eAAe,CAAC,KAAK,EAAE,CAAC;QAE7B,KAAK,MAAM,KAAK,IAAI,IAAI,CAAC,aAAa,EAAE,CAAC;YACvC,MAAM,QAAQ,GAAG,KAAK,CAAC,WAAW,EAAE,CAAC;YACrC,KAAK,MAAM,KAAK,IAAI,QAAQ,EAAE,CAAC;gBAC7B,MAAM,IAAI,GAAG,KAAK,CAAC,cAAc,CAAC,IAAI,CAAC;gBACvC,IAAI,IAAI,CAAC,eAAe,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC;oBACnC,MAAM,GAAG,GAAG,0CAA0C,IAAI,eAAe,KAAK,CAAC,OAAO,EAAE,GAAG,CAAC;oBAC5F,IAAI,IAAI,CAAC,eAAe,EAAE,CAAC;wBACzB,MAAM,IAAI,KAAK,CAAC,GAAG,CAAC,CAAC;oBACvB,CAAC;oBACD,gCAAgC;oBAChC,SAAS;gBACX,CAAC;gBACD,IAAI,CAAC,eAAe,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;YACjC,CAAC;YACD,oEAAoE;YACpE,KAAK,CAAC,gBAAgB,CAAC,MAAM,CAAC,CAAC;QACjC,CAAC;IACH,CAAC;IAED;;;OAGG;IACH,YAAY,CACV,MAAiB,EACjB,QAAgB,EAChB,cAA8B,EAC9B,OAAoB;QAEpB,MAAM,CAAC,YAAY,CACjB,QAAQ,EACR;YACE,WAAW,EAAE,cAAc,CAAC,WAAW;YACvC,WAAW,EAAE,cAAc,CAAC,WAAW;SACxC,EACD,OAAc,CACf,CAAC;IACJ,CAAC;IAED;;OAEG;IACH,kBAAkB;QAChB,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,eAAe,CAAC,CAAC;IAC1C,CAAC;IAED;;OAEG;IACH,oBAAoB;QAClB,OAAO,IAAI,CAAC,aAAa,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,OAAO,EAAE,CAAC,CAAC;IAClD,CAAC;CACF;AAhGD,8DAgGC"}

package/dist/lib/runtimeConfig.d.ts

@@ -0,0 +1,20 @@
+export declare function parseEnvArg(): string | undefined;
+export declare function parseAuthBrokerPathArg(): string | undefined;
+export declare function parseMcpDestinationArg(): string | undefined;
+export declare function getTransportType(): string | null;
+export declare function resolveEnvFromCwd(): string | undefined;
+export declare function buildRuntimeConfig(): {
+    useAuthBroker: boolean;
+    isTestEnv: boolean;
+    authBrokerPath: string | undefined;
+    defaultMcpDestination: string | undefined;
+    unsafe: boolean;
+    explicitTransportType: string | null;
+    transportType: string;
+    isHttp: boolean;
+    isSse: boolean;
+    isStdio: boolean;
+    isEnvMandatory: boolean;
+    envFilePath: string | undefined;
+};
+//# sourceMappingURL=runtimeConfig.d.ts.map

package/dist/lib/runtimeConfig.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"runtimeConfig.d.ts","sourceRoot":"","sources":["../../src/lib/runtimeConfig.ts"],"names":[],"mappings":"AAGA,wBAAgB,WAAW,IAAI,MAAM,GAAG,SAAS,CAqBhD;AAED,wBAAgB,sBAAsB,IAAI,MAAM,GAAG,SAAS,CAW3D;AAED,wBAAgB,sBAAsB,IAAI,MAAM,GAAG,SAAS,CAW3D;AAED,wBAAgB,gBAAgB,IAAI,MAAM,GAAG,IAAI,CAwBhD;AAED,wBAAgB,iBAAiB,IAAI,MAAM,GAAG,SAAS,CAGtD;AAED,wBAAgB,kBAAkB;;;;;;;;;;;;;EAsCjC"}

package/dist/lib/runtimeConfig.js

@@ -0,0 +1,130 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.parseEnvArg = parseEnvArg;
+exports.parseAuthBrokerPathArg = parseAuthBrokerPathArg;
+exports.parseMcpDestinationArg = parseMcpDestinationArg;
+exports.getTransportType = getTransportType;
+exports.resolveEnvFromCwd = resolveEnvFromCwd;
+exports.buildRuntimeConfig = buildRuntimeConfig;
+const fs_1 = __importDefault(require("fs"));
+const path_1 = __importDefault(require("path"));
+function parseEnvArg() {
+    const args = process.argv;
+    for (let i = 0; i < args.length; i++) {
+        const arg = args[i];
+        if (arg.startsWith("--env=")) {
+            const envPath = arg.slice("--env=".length);
+            if (envPath.length === 0)
+                continue;
+            if (envPath.startsWith(".\\") || envPath.startsWith("./")) {
+                return path_1.default.resolve(process.cwd(), envPath);
+            }
+            return envPath;
+        }
+        else if (arg === "--env" && i + 1 < args.length) {
+            const envPath = args[i + 1];
+            if (!envPath || envPath.startsWith("-"))
+                continue;
+            if (envPath.startsWith(".\\") || envPath.startsWith("./")) {
+                return path_1.default.resolve(process.cwd(), envPath);
+            }
+            return envPath;
+        }
+    }
+    return undefined;
+}
+function parseAuthBrokerPathArg() {
+    const args = process.argv;
+    for (let i = 0; i < args.length; i++) {
+        const arg = args[i];
+        if (arg.startsWith("--auth-broker-path=")) {
+            return arg.slice("--auth-broker-path=".length);
+        }
+        else if (arg === "--auth-broker-path" && i + 1 < args.length) {
+            return args[i + 1];
+        }
+    }
+    return undefined;
+}
+function parseMcpDestinationArg() {
+    const args = process.argv;
+    for (let i = 0; i < args.length; i++) {
+        const arg = args[i];
+        if (arg.startsWith("--mcp=")) {
+            return arg.slice("--mcp=".length);
+        }
+        else if (arg === "--mcp" && i + 1 < args.length) {
+            return args[i + 1];
+        }
+    }
+    return undefined;
+}
+function getTransportType() {
+    // First check command line arguments
+    const args = process.argv;
+    for (let i = 0; i < args.length; i++) {
+        const arg = args[i];
+        // Check for --transport=value format
+        if (arg.startsWith("--transport=")) {
+            return arg.slice("--transport=".length);
+        }
+        // Check for --transport value format
+        if (arg === "--transport" && i + 1 < args.length) {
+            return args[i + 1];
+        }
+    }
+    // Then check environment variable
+    if (process.env.MCP_TRANSPORT) {
+        return process.env.MCP_TRANSPORT;
+    }
+    // Auto-detect stdio mode when stdin is not a TTY (e.g., when run by inspector)
+    // Only if no explicit transport was set via argv or env
+    if (!process.stdin.isTTY) {
+        return "stdio";
+    }
+    return null;
+}
+function resolveEnvFromCwd() {
+    const cwdEnvPath = path_1.default.resolve(process.cwd(), ".env");
+    return fs_1.default.existsSync(cwdEnvPath) ? cwdEnvPath : undefined;
+}
+function buildRuntimeConfig() {
+    const useAuthBroker = process.argv.includes("--auth-broker") || process.env.MCP_USE_AUTH_BROKER === "true";
+    const isTestEnv = process.env.JEST_WORKER_ID !== undefined || process.env.NODE_ENV === "test";
+    const authBrokerPath = parseAuthBrokerPathArg();
+    const defaultMcpDestination = parseMcpDestinationArg();
+    const unsafe = process.argv.includes("--unsafe") || process.env.MCP_UNSAFE === "true";
+    const explicitTransportType = getTransportType();
+    // Check if transport was explicitly set (not auto-detected)
+    const hasExplicitTransportArg = process.argv.some((arg, i) => arg.startsWith("--transport=") || (arg === "--transport" && i + 1 < process.argv.length));
+    // If transport was auto-detected (not explicitly set), consider it as explicit for stdio mode
+    // This allows stdio mode to work when run by inspector without --transport=stdio argument
+    const isAutoDetectedStdio = explicitTransportType === "stdio" && !hasExplicitTransportArg && !process.env.MCP_TRANSPORT;
+    // Default transport is stdio (changed from streamable-http per user request)
+    const transportType = explicitTransportType || "stdio";
+    const isHttp = transportType === "http" || transportType === "streamable-http" || transportType === "server";
+    const isSse = transportType === "sse";
+    const isStdio = transportType === "stdio";
+    // For auto-detected stdio, treat it as explicit for env mandatory check
+    const effectiveExplicitTransportType = isAutoDetectedStdio ? "stdio" : explicitTransportType;
+    const isEnvMandatory = effectiveExplicitTransportType !== null && (isStdio || isSse) && !defaultMcpDestination && !useAuthBroker && !isTestEnv;
+    let envFilePath = parseEnvArg() ?? process.env.MCP_ENV_PATH;
+    return {
+        useAuthBroker,
+        isTestEnv,
+        authBrokerPath,
+        defaultMcpDestination,
+        unsafe,
+        explicitTransportType: effectiveExplicitTransportType,
+        transportType,
+        isHttp,
+        isSse,
+        isStdio,
+        isEnvMandatory,
+        envFilePath,
+    };
+}
+//# sourceMappingURL=runtimeConfig.js.map

package/dist/lib/runtimeConfig.js.map

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

package/dist/lib/servers/BaseMcpServer.d.ts

@@ -0,0 +1,56 @@
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import { AbapConnection } from "@mcp-abap-adt/connection";
+import { AuthBroker } from "@mcp-abap-adt/auth-broker";
+import { ConnectionContext } from "./ConnectionContext.js";
+import { IHandlersRegistry } from "./handlers/interfaces.js";
+import { type Logger } from "@mcp-abap-adt/logger";
+/**
+ * Base MCP Server class that extends SDK McpServer
+ * Manages connection context and provides connection injection for handlers
+ */
+export declare abstract class BaseMcpServer extends McpServer {
+    /**
+     * Logger used for handler context
+     */
+    protected readonly logger: Logger;
+    /**
+     * Connection context (set per request for SSE/HTTP, once for stdio)
+     */
+    protected connectionContext: ConnectionContext | null;
+    /**
+     * Auth broker for token and service key management
+     */
+    protected authBroker?: AuthBroker;
+    constructor(options: {
+        name: string;
+        version?: string;
+        logger?: Logger;
+    });
+    /**
+     * Sets connection context using auth broker
+     * For stdio: called once on startup
+     * For SSE/HTTP: called per-request
+     */
+    protected setConnectionContext(destination: string, authBroker: AuthBroker): Promise<void>;
+    /**
+     * Gets current connection context
+     */
+    protected getConnectionContext(): ConnectionContext | null;
+    /**
+     * Gets ABAP connection from connection context
+     * Creates connection using connectionParams from context
+     * Automatically refreshes token via AuthBroker if available (inside makeAdtRequest)
+     */
+    protected getConnection(): Promise<AbapConnection>;
+    /**
+     * Registers handlers from registry
+     * Wraps handlers to inject connection as first parameter
+     *
+     * Handler signature: (connection: AbapConnection, args: any) => Promise<any>
+     * Registered as: (args: any) => handler(getConnection(), args)
+     *
+     * This ensures connection is injected but NOT exposed in MCP tool signature
+     */
+    protected registerHandlers(handlersRegistry: IHandlersRegistry): void;
+}
+//# sourceMappingURL=BaseMcpServer.d.ts.map

package/dist/lib/servers/BaseMcpServer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"BaseMcpServer.d.ts","sourceRoot":"","sources":["../../../src/lib/servers/BaseMcpServer.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AACpE,OAAO,EAAE,cAAc,EAAwB,MAAM,0BAA0B,CAAC;AAChF,OAAO,EAAE,UAAU,EAAE,MAAM,2BAA2B,CAAC;AACvD,OAAO,EAAE,iBAAiB,EAAE,MAAM,wBAAwB,CAAC;AAC3D,OAAO,EAAE,iBAAiB,EAAE,MAAM,0BAA0B,CAAC;AAG7D,OAAO,EAAiB,KAAK,MAAM,EAAE,MAAM,sBAAsB,CAAC;AAGlE;;;GAGG;AACH,8BAAsB,aAAc,SAAQ,SAAS;IACnD;;OAEG;IACH,SAAS,CAAC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IAElC;;OAEG;IACH,SAAS,CAAC,iBAAiB,EAAE,iBAAiB,GAAG,IAAI,CAAQ;IAE7D;;OAEG;IACH,SAAS,CAAC,UAAU,CAAC,EAAE,UAAU,CAAC;gBAEtB,OAAO,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,OAAO,CAAC,EAAE,MAAM,CAAC;QAAC,MAAM,CAAC,EAAE,MAAM,CAAA;KAAE;IAKxE;;;;OAIG;cACa,oBAAoB,CAClC,WAAW,EAAE,MAAM,EACnB,UAAU,EAAE,UAAU,GACrB,OAAO,CAAC,IAAI,CAAC;IAoDhB;;OAEG;IACH,SAAS,CAAC,oBAAoB,IAAI,iBAAiB,GAAG,IAAI;IAI1D;;;;OAIG;cACa,aAAa,IAAI,OAAO,CAAC,cAAc,CAAC;IAcxD;;;;;;;;OAQG;IACH,SAAS,CAAC,gBAAgB,CAAC,gBAAgB,EAAE,iBAAiB,GAAG,IAAI;CAyFtE"}