@mcp-abap-adt/core 1.4.3 → 2.0.0

package/CHANGELOG.md

@@ -2,6 +2,42 @@
 
 ## [Unreleased]
 
+## [2.0.0] - 2025-12-30
+### Added
+- **EmbeddableMcpServer**: New server class for external integration (e.g., cloud-llm-hub)
+  - Accepts injected `AbapConnection` from consumer
+  - Extends `BaseMcpServer` with proper handler registration
+  - Configurable exposition levels: `readonly`, `high`, `low`, `system`, `search`
+  - Export via `@mcp-abap-adt/core/server`
+
+### Changed
+- **HandlerExporter**: Now serves only as registry factory
+  - Use `createRegistry()` to get `IHandlersRegistry` for custom scenarios
+  - `getHandlerEntries()` and `getToolNames()` still available for inspection
+
+### Removed
+- **BREAKING**: `HandlerExporter.registerOnServer()` method removed
+  - Had bug with handler signature (passed context twice)
+  - Replace with `EmbeddableMcpServer` for cleaner architecture
+
+### Migration Guide
+```typescript
+// Before (v1.x - broken)
+import { HandlerExporter } from '@mcp-abap-adt/core/handlers';
+const exporter = new HandlerExporter({ includeReadOnly: true, includeHighLevel: true });
+const mcpServer = new McpServer({ name: 'mcp-abap-adt', version: '1.0.0' });
+exporter.registerOnServer(mcpServer, () => connection, logger);
+
+// After (v2.x)
+import { EmbeddableMcpServer } from '@mcp-abap-adt/core/server';
+const server = new EmbeddableMcpServer({
+  connection,
+  logger,
+  exposition: ['readonly', 'high'],
+});
+await server.connect(transport);
+```
+
 ## [1.4.3] - 2025-12-29
 ### Documentation
 - **CLI Help**: Extended `--help` output with comprehensive environment variables documentation

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

@@ -1,6 +1,4 @@
-import type { AbapConnection } from '@mcp-abap-adt/connection';
 import type { Logger } from '@mcp-abap-adt/logger';
-import type { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
 import type { HandlerEntry, IHandlersRegistry } from './interfaces.js';
 /**
  * Options for creating handler exporter
@@ -38,21 +36,27 @@ export interface HandlerExporterOptions {
     includeSearch?: boolean;
 }
 /**
- * Handler Exporter - exports MCP handlers for use in external servers
+ * Handler Exporter - factory for creating handlers registry
  *
- * This class provides a simple way to register ABAP ADT handlers on any McpServer instance.
- * It's designed for integration with external servers (like cloud-llm-hub) that manage
- * their own connection lifecycle.
+ * This class provides a way to create handlers registry with configurable
+ * exposition levels. Use with EmbeddableMcpServer for external integration.
  *
  * Usage:
  * ```typescript
- * import { HandlerExporter } from '@fr0ster/mcp-abap-adt';
+ * import { HandlerExporter, EmbeddableMcpServer } from '@mcp-abap-adt/core';
  *
- * // Create exporter
- * const exporter = new HandlerExporter();
+ * // Create exporter with specific handlers
+ * const exporter = new HandlerExporter({
+ *   includeReadOnly: true,
+ *   includeHighLevel: true,
+ *   includeLowLevel: false,
+ * });
  *
- * // Register on your McpServer with connection provider
- * exporter.registerOnServer(mcpServer, () => getConnection());
+ * // Use with EmbeddableMcpServer
+ * const server = new EmbeddableMcpServer({
+ *   connection: myConnection,
+ *   handlersRegistry: exporter.createRegistry(),
+ * });
  * ```
  */
 export declare class HandlerExporter {
@@ -69,20 +73,9 @@ export declare class HandlerExporter {
      */
     getToolNames(): string[];
     /**
-     * Create handlers registry for use with v2 servers
+     * Create handlers registry for use with EmbeddableMcpServer or BaseMcpServer
      */
     createRegistry(): IHandlersRegistry;
-    /**
-     * Register all handlers on an McpServer instance
-     *
-     * @param server - McpServer instance to register handlers on
-     * @param connectionProvider - Function that returns AbapConnection for each request
-     * @param logger - Optional logger (defaults to constructor logger)
-     *
-     * The connectionProvider is called for each handler invocation, allowing
-     * per-request connection management (e.g., different JWT tokens per request)
-     */
-    registerOnServer(server: McpServer, connectionProvider: () => AbapConnection | Promise<AbapConnection>, logger?: Logger): void;
 }
 /**
  * Create default handler exporter with all handler groups

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

@@ -1 +1 @@
-{"version":3,"file":"HandlerExporter.d.ts","sourceRoot":"","sources":["../../../src/lib/handlers/HandlerExporter.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,0BAA0B,CAAC;AAC/D,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,sBAAsB,CAAC;AAEnD,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAOzE,OAAO,KAAK,EACV,YAAY,EAEZ,iBAAiB,EAClB,MAAM,iBAAiB,CAAC;AAGzB;;GAEG;AACH,MAAM,WAAW,sBAAsB;IACrC;;;OAGG;IACH,MAAM,CAAC,EAAE,MAAM,CAAC;IAEhB;;;OAGG;IACH,eAAe,CAAC,EAAE,OAAO,CAAC;IAE1B;;;OAGG;IACH,gBAAgB,CAAC,EAAE,OAAO,CAAC;IAE3B;;;OAGG;IACH,eAAe,CAAC,EAAE,OAAO,CAAC;IAE1B;;;OAGG;IACH,aAAa,CAAC,EAAE,OAAO,CAAC;IAExB;;;OAGG;IACH,aAAa,CAAC,EAAE,OAAO,CAAC;CACzB;AAED;;;;;;;;;;;;;;;;;GAiBG;AACH,qBAAa,eAAe;IAC1B,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAS;IAChC,OAAO,CAAC,QAAQ,CAAC,aAAa,CAAkB;gBAEpC,OAAO,CAAC,EAAE,sBAAsB;IA8B5C;;;OAGG;IACH,iBAAiB,IAAI,YAAY,EAAE;IAQnC;;OAEG;IACH,YAAY,IAAI,MAAM,EAAE;IAIxB;;OAEG;IACH,cAAc,IAAI,iBAAiB;IAInC;;;;;;;;;OASG;IACH,gBAAgB,CACd,MAAM,EAAE,SAAS,EACjB,kBAAkB,EAAE,MAAM,cAAc,GAAG,OAAO,CAAC,cAAc,CAAC,EAClE,MAAM,CAAC,EAAE,MAAM,GACd,IAAI;CAmER;AAED;;GAEG;AACH,wBAAgB,4BAA4B,CAAC,MAAM,CAAC,EAAE,MAAM,GAAG,eAAe,CAE7E"}
+{"version":3,"file":"HandlerExporter.d.ts","sourceRoot":"","sources":["../../../src/lib/handlers/HandlerExporter.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,sBAAsB,CAAC;AAQnD,OAAO,KAAK,EACV,YAAY,EAEZ,iBAAiB,EAClB,MAAM,iBAAiB,CAAC;AAGzB;;GAEG;AACH,MAAM,WAAW,sBAAsB;IACrC;;;OAGG;IACH,MAAM,CAAC,EAAE,MAAM,CAAC;IAEhB;;;OAGG;IACH,eAAe,CAAC,EAAE,OAAO,CAAC;IAE1B;;;OAGG;IACH,gBAAgB,CAAC,EAAE,OAAO,CAAC;IAE3B;;;OAGG;IACH,eAAe,CAAC,EAAE,OAAO,CAAC;IAE1B;;;OAGG;IACH,aAAa,CAAC,EAAE,OAAO,CAAC;IAExB;;;OAGG;IACH,aAAa,CAAC,EAAE,OAAO,CAAC;CACzB;AAED;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,qBAAa,eAAe;IAC1B,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAS;IAChC,OAAO,CAAC,QAAQ,CAAC,aAAa,CAAkB;gBAEpC,OAAO,CAAC,EAAE,sBAAsB;IA8B5C;;;OAGG;IACH,iBAAiB,IAAI,YAAY,EAAE;IAQnC;;OAEG;IACH,YAAY,IAAI,MAAM,EAAE;IAIxB;;OAEG;IACH,cAAc,IAAI,iBAAiB;CAGpC;AAED;;GAEG;AACH,wBAAgB,4BAA4B,CAAC,MAAM,CAAC,EAAE,MAAM,GAAG,eAAe,CAE7E"}

package/dist/lib/handlers/HandlerExporter.js

@@ -10,21 +10,27 @@ const SearchHandlersGroup_js_1 = require("./groups/SearchHandlersGroup.js");
 const SystemHandlersGroup_js_1 = require("./groups/SystemHandlersGroup.js");
 const CompositeHandlersRegistry_js_1 = require("./registry/CompositeHandlersRegistry.js");
 /**
- * Handler Exporter - exports MCP handlers for use in external servers
+ * Handler Exporter - factory for creating handlers registry
  *
- * This class provides a simple way to register ABAP ADT handlers on any McpServer instance.
- * It's designed for integration with external servers (like cloud-llm-hub) that manage
- * their own connection lifecycle.
+ * This class provides a way to create handlers registry with configurable
+ * exposition levels. Use with EmbeddableMcpServer for external integration.
  *
  * Usage:
  * ```typescript
- * import { HandlerExporter } from '@fr0ster/mcp-abap-adt';
+ * import { HandlerExporter, EmbeddableMcpServer } from '@mcp-abap-adt/core';
  *
- * // Create exporter
- * const exporter = new HandlerExporter();
+ * // Create exporter with specific handlers
+ * const exporter = new HandlerExporter({
+ *   includeReadOnly: true,
+ *   includeHighLevel: true,
+ *   includeLowLevel: false,
+ * });
  *
- * // Register on your McpServer with connection provider
- * exporter.registerOnServer(mcpServer, () => getConnection());
+ * // Use with EmbeddableMcpServer
+ * const server = new EmbeddableMcpServer({
+ *   connection: myConnection,
+ *   handlersRegistry: exporter.createRegistry(),
+ * });
  * ```
  */
 class HandlerExporter {
@@ -33,7 +39,7 @@ class HandlerExporter {
     constructor(options) {
         this.logger = options?.logger ?? logger_1.defaultLogger;
         // Create dummy context for group instantiation
-        // Real context will be provided per-request via registerOnServer
+        // Real context is provided by BaseMcpServer.registerHandlers() via getConnection()
         const dummyContext = {
             connection: null,
             logger: this.logger,
@@ -74,71 +80,11 @@ class HandlerExporter {
         return this.getHandlerEntries().map((e) => e.toolDefinition.name);
     }
     /**
-     * Create handlers registry for use with v2 servers
+     * Create handlers registry for use with EmbeddableMcpServer or BaseMcpServer
      */
     createRegistry() {
         return new CompositeHandlersRegistry_js_1.CompositeHandlersRegistry(this.handlerGroups);
     }
-    /**
-     * Register all handlers on an McpServer instance
-     *
-     * @param server - McpServer instance to register handlers on
-     * @param connectionProvider - Function that returns AbapConnection for each request
-     * @param logger - Optional logger (defaults to constructor logger)
-     *
-     * The connectionProvider is called for each handler invocation, allowing
-     * per-request connection management (e.g., different JWT tokens per request)
-     */
-    registerOnServer(server, connectionProvider, logger) {
-        const log = logger ?? this.logger;
-        for (const group of this.handlerGroups) {
-            const handlers = group.getHandlers();
-            for (const entry of handlers) {
-                // Wrap handler to inject connection from provider
-                const wrappedHandler = async (args) => {
-                    const connection = await connectionProvider();
-                    const context = {
-                        connection,
-                        logger: log,
-                    };
-                    const result = await entry.handler(context, args);
-                    // Handle errors: if handler returns isError, throw McpError
-                    if (result?.isError) {
-                        const { ErrorCode, McpError } = await import('@modelcontextprotocol/sdk/types.js');
-                        const errorText = (result.content || [])
-                            .map((item) => {
-                            if (item?.type === 'json' && item.json !== undefined) {
-                                return JSON.stringify(item.json);
-                            }
-                            return item?.text || String(item);
-                        })
-                            .join('\n') || 'Unknown error';
-                        throw new McpError(ErrorCode.InternalError, errorText);
-                    }
-                    // Normalize content: SDK expects text/image/audio/resource, convert custom json to text
-                    const content = (result?.content || []).map((item) => {
-                        if (item?.type === 'json' && item.json !== undefined) {
-                            return {
-                                type: 'text',
-                                text: JSON.stringify(item.json),
-                            };
-                        }
-                        return {
-                            type: 'text',
-                            text: item?.text || String(item || ''),
-                        };
-                    });
-                    return { content };
-                };
-                // Register tool on server
-                server.registerTool(entry.toolDefinition.name, {
-                    description: entry.toolDefinition.description,
-                    inputSchema: entry.toolDefinition.inputSchema,
-                }, wrappedHandler);
-            }
-        }
-        log.info?.(`[HandlerExporter] Registered ${this.getToolNames().length} tools on server`);
-    }
 }
 exports.HandlerExporter = HandlerExporter;
 /**

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

@@ -1 +1 @@
-{"version":3,"file":"HandlerExporter.js","sourceRoot":"","sources":["../../../src/lib/handlers/HandlerExporter.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"HandlerExporter.js","sourceRoot":"","sources":["../../../src/lib/handlers/HandlerExporter.ts"],"names":[],"mappings":";;;AAgJA,oEAEC;AAjJD,iDAAqD;AAErD,kFAA4E;AAC5E,gFAA0E;AAC1E,gFAA0E;AAC1E,4EAAsE;AACtE,4EAAsE;AAMtE,0FAAoF;AA2CpF;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,MAAa,eAAe;IACT,MAAM,CAAS;IACf,aAAa,CAAkB;IAEhD,YAAY,OAAgC;QAC1C,IAAI,CAAC,MAAM,GAAG,OAAO,EAAE,MAAM,IAAI,sBAAa,CAAC;QAE/C,+CAA+C;QAC/C,mFAAmF;QACnF,MAAM,YAAY,GAAmB;YACnC,UAAU,EAAE,IAAW;YACvB,MAAM,EAAE,IAAI,CAAC,MAAM;SACpB,CAAC;QAEF,wCAAwC;QACxC,IAAI,CAAC,aAAa,GAAG,EAAE,CAAC;QAExB,IAAI,OAAO,EAAE,eAAe,KAAK,KAAK,EAAE,CAAC;YACvC,IAAI,CAAC,aAAa,CAAC,IAAI,CAAC,IAAI,gDAAqB,CAAC,YAAY,CAAC,CAAC,CAAC;QACnE,CAAC;QACD,IAAI,OAAO,EAAE,gBAAgB,KAAK,KAAK,EAAE,CAAC;YACxC,IAAI,CAAC,aAAa,CAAC,IAAI,CAAC,IAAI,kDAAsB,CAAC,YAAY,CAAC,CAAC,CAAC;QACpE,CAAC;QACD,IAAI,OAAO,EAAE,eAAe,KAAK,KAAK,EAAE,CAAC;YACvC,IAAI,CAAC,aAAa,CAAC,IAAI,CAAC,IAAI,gDAAqB,CAAC,YAAY,CAAC,CAAC,CAAC;QACnE,CAAC;QACD,IAAI,OAAO,EAAE,aAAa,KAAK,KAAK,EAAE,CAAC;YACrC,IAAI,CAAC,aAAa,CAAC,IAAI,CAAC,IAAI,4CAAmB,CAAC,YAAY,CAAC,CAAC,CAAC;QACjE,CAAC;QACD,IAAI,OAAO,EAAE,aAAa,KAAK,KAAK,EAAE,CAAC;YACrC,IAAI,CAAC,aAAa,CAAC,IAAI,CAAC,IAAI,4CAAmB,CAAC,YAAY,CAAC,CAAC,CAAC;QACjE,CAAC;IACH,CAAC;IAED;;;OAGG;IACH,iBAAiB;QACf,MAAM,OAAO,GAAmB,EAAE,CAAC;QACnC,KAAK,MAAM,KAAK,IAAI,IAAI,CAAC,aAAa,EAAE,CAAC;YACvC,OAAO,CAAC,IAAI,CAAC,GAAG,KAAK,CAAC,WAAW,EAAE,CAAC,CAAC;QACvC,CAAC;QACD,OAAO,OAAO,CAAC;IACjB,CAAC;IAED;;OAEG;IACH,YAAY;QACV,OAAO,IAAI,CAAC,iBAAiB,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,cAAc,CAAC,IAAI,CAAC,CAAC;IACpE,CAAC;IAED;;OAEG;IACH,cAAc;QACZ,OAAO,IAAI,wDAAyB,CAAC,IAAI,CAAC,aAAa,CAAC,CAAC;IAC3D,CAAC;CACF;AA3DD,0CA2DC;AAED;;GAEG;AACH,SAAgB,4BAA4B,CAAC,MAAe;IAC1D,OAAO,IAAI,eAAe,CAAC,EAAE,MAAM,EAAE,CAAC,CAAC;AACzC,CAAC"}

package/dist/server/EmbeddableMcpServer.d.ts

@@ -0,0 +1,72 @@
+import type { AbapConnection } from '@mcp-abap-adt/connection';
+import { type Logger } from '@mcp-abap-adt/logger';
+import type { IHandlersRegistry } from '../lib/handlers/interfaces.js';
+import { BaseMcpServer } from './BaseMcpServer.js';
+/**
+ * Options for EmbeddableMcpServer
+ */
+export interface EmbeddableMcpServerOptions {
+    /**
+     * ABAP connection to use for all handler calls
+     * Injected from consumer (e.g., CloudSdkAbapConnection in cloud-llm-hub)
+     */
+    connection: AbapConnection;
+    /**
+     * Logger instance
+     * @default defaultLogger
+     */
+    logger?: Logger;
+    /**
+     * Handlers registry to use
+     * If not provided, default registry is created based on exposition option
+     */
+    handlersRegistry?: IHandlersRegistry;
+    /**
+     * Exposition levels to include when creating default registry
+     * @default ['readonly', 'high']
+     */
+    exposition?: ('readonly' | 'high' | 'low' | 'system' | 'search')[];
+    /**
+     * Server version
+     * @default from package.json or '1.0.0'
+     */
+    version?: string;
+}
+/**
+ * Embeddable MCP Server for integration with external applications
+ *
+ * This server is designed for consumers like cloud-llm-hub that:
+ * - Have their own connection management (e.g., BTP destinations, Cloud SDK)
+ * - Create new server instance per request (SSE/HTTP mode)
+ * - Need to inject connection from outside
+ *
+ * Usage:
+ * ```typescript
+ * // Create connection (consumer's own implementation)
+ * const connection = new CloudSdkAbapConnection(config);
+ *
+ * // Create embeddable server with injected connection
+ * const server = new EmbeddableMcpServer({
+ *   connection,
+ *   logger: myLogger,
+ *   exposition: ['readonly', 'high'],
+ * });
+ *
+ * // Connect transport and handle request
+ * await server.connect(transport);
+ * ```
+ */
+export declare class EmbeddableMcpServer extends BaseMcpServer {
+    private readonly injectedConnection;
+    constructor(options: EmbeddableMcpServerOptions);
+    /**
+     * Returns the injected connection
+     * Called by BaseMcpServer.registerHandlers() wrapper lambdas
+     */
+    protected getConnection(): Promise<AbapConnection>;
+    /**
+     * Creates default handlers registry based on exposition levels
+     */
+    private createDefaultRegistry;
+}
+//# sourceMappingURL=EmbeddableMcpServer.d.ts.map

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

@@ -0,0 +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,EAAiB,KAAK,MAAM,EAAE,MAAM,sBAAsB,CAAC;AAOlE,OAAO,KAAK,EAEV,iBAAiB,EAClB,MAAM,+BAA+B,CAAC;AAEvC,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,CAAC,UAAU,GAAG,MAAM,GAAG,KAAK,GAAG,QAAQ,GAAG,QAAQ,CAAC,EAAE,CAAC;IAEnE;;;OAGG;IACH,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,qBAAa,mBAAoB,SAAQ,aAAa;IACpD,OAAO,CAAC,QAAQ,CAAC,kBAAkB,CAAiB;gBAExC,OAAO,EAAE,0BAA0B;IAoB/C;;;OAGG;cACa,aAAa,IAAI,OAAO,CAAC,cAAc,CAAC;IAIxD;;OAEG;IACH,OAAO,CAAC,qBAAqB;CA+B9B"}

package/dist/server/EmbeddableMcpServer.js

@@ -0,0 +1,88 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.EmbeddableMcpServer = void 0;
+const logger_1 = require("@mcp-abap-adt/logger");
+const HighLevelHandlersGroup_js_1 = require("../lib/handlers/groups/HighLevelHandlersGroup.js");
+const LowLevelHandlersGroup_js_1 = require("../lib/handlers/groups/LowLevelHandlersGroup.js");
+const ReadOnlyHandlersGroup_js_1 = require("../lib/handlers/groups/ReadOnlyHandlersGroup.js");
+const SearchHandlersGroup_js_1 = require("../lib/handlers/groups/SearchHandlersGroup.js");
+const SystemHandlersGroup_js_1 = require("../lib/handlers/groups/SystemHandlersGroup.js");
+const CompositeHandlersRegistry_js_1 = require("../lib/handlers/registry/CompositeHandlersRegistry.js");
+const BaseMcpServer_js_1 = require("./BaseMcpServer.js");
+const DEFAULT_VERSION = process.env.npm_package_version ?? '1.0.0';
+/**
+ * Embeddable MCP Server for integration with external applications
+ *
+ * This server is designed for consumers like cloud-llm-hub that:
+ * - Have their own connection management (e.g., BTP destinations, Cloud SDK)
+ * - Create new server instance per request (SSE/HTTP mode)
+ * - Need to inject connection from outside
+ *
+ * Usage:
+ * ```typescript
+ * // Create connection (consumer's own implementation)
+ * const connection = new CloudSdkAbapConnection(config);
+ *
+ * // Create embeddable server with injected connection
+ * const server = new EmbeddableMcpServer({
+ *   connection,
+ *   logger: myLogger,
+ *   exposition: ['readonly', 'high'],
+ * });
+ *
+ * // Connect transport and handle request
+ * await server.connect(transport);
+ * ```
+ */
+class EmbeddableMcpServer extends BaseMcpServer_js_1.BaseMcpServer {
+    injectedConnection;
+    constructor(options) {
+        super({
+            name: 'mcp-abap-adt',
+            version: options.version ?? DEFAULT_VERSION,
+            logger: options.logger ?? logger_1.defaultLogger,
+        });
+        this.injectedConnection = options.connection;
+        // Use provided registry or create default based on exposition
+        const registry = options.handlersRegistry ??
+            this.createDefaultRegistry(options.exposition ?? ['readonly', 'high'], options.logger);
+        this.registerHandlers(registry);
+    }
+    /**
+     * Returns the injected connection
+     * Called by BaseMcpServer.registerHandlers() wrapper lambdas
+     */
+    async getConnection() {
+        return this.injectedConnection;
+    }
+    /**
+     * Creates default handlers registry based on exposition levels
+     */
+    createDefaultRegistry(exposition, logger) {
+        // Dummy context - not actually used because BaseMcpServer.registerHandlers()
+        // creates wrapper lambdas that call getConnection() for fresh context
+        const dummyContext = {
+            connection: null,
+            logger: logger ?? logger_1.defaultLogger,
+        };
+        const groups = [];
+        if (exposition.includes('readonly')) {
+            groups.push(new ReadOnlyHandlersGroup_js_1.ReadOnlyHandlersGroup(dummyContext));
+        }
+        if (exposition.includes('high')) {
+            groups.push(new HighLevelHandlersGroup_js_1.HighLevelHandlersGroup(dummyContext));
+        }
+        if (exposition.includes('low')) {
+            groups.push(new LowLevelHandlersGroup_js_1.LowLevelHandlersGroup(dummyContext));
+        }
+        if (exposition.includes('system')) {
+            groups.push(new SystemHandlersGroup_js_1.SystemHandlersGroup(dummyContext));
+        }
+        if (exposition.includes('search')) {
+            groups.push(new SearchHandlersGroup_js_1.SearchHandlersGroup(dummyContext));
+        }
+        return new CompositeHandlersRegistry_js_1.CompositeHandlersRegistry(groups);
+    }
+}
+exports.EmbeddableMcpServer = EmbeddableMcpServer;
+//# sourceMappingURL=EmbeddableMcpServer.js.map

package/dist/server/EmbeddableMcpServer.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"EmbeddableMcpServer.js","sourceRoot":"","sources":["../../src/server/EmbeddableMcpServer.ts"],"names":[],"mappings":";;;AACA,iDAAkE;AAElE,gGAA0F;AAC1F,8FAAwF;AACxF,8FAAwF;AACxF,0FAAoF;AACpF,0FAAoF;AAKpF,wGAAkG;AAClG,yDAAmD;AAEnD,MAAM,eAAe,GAAG,OAAO,CAAC,GAAG,CAAC,mBAAmB,IAAI,OAAO,CAAC;AAqCnE;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,MAAa,mBAAoB,SAAQ,gCAAa;IACnC,kBAAkB,CAAiB;IAEpD,YAAY,OAAmC;QAC7C,KAAK,CAAC;YACJ,IAAI,EAAE,cAAc;YACpB,OAAO,EAAE,OAAO,CAAC,OAAO,IAAI,eAAe;YAC3C,MAAM,EAAE,OAAO,CAAC,MAAM,IAAI,sBAAa;SACxC,CAAC,CAAC;QAEH,IAAI,CAAC,kBAAkB,GAAG,OAAO,CAAC,UAAU,CAAC;QAE7C,8DAA8D;QAC9D,MAAM,QAAQ,GACZ,OAAO,CAAC,gBAAgB;YACxB,IAAI,CAAC,qBAAqB,CACxB,OAAO,CAAC,UAAU,IAAI,CAAC,UAAU,EAAE,MAAM,CAAC,EAC1C,OAAO,CAAC,MAAM,CACf,CAAC;QAEJ,IAAI,CAAC,gBAAgB,CAAC,QAAQ,CAAC,CAAC;IAClC,CAAC;IAED;;;OAGG;IACO,KAAK,CAAC,aAAa;QAC3B,OAAO,IAAI,CAAC,kBAAkB,CAAC;IACjC,CAAC;IAED;;OAEG;IACK,qBAAqB,CAC3B,UAAiE,EACjE,MAAe;QAEf,6EAA6E;QAC7E,sEAAsE;QACtE,MAAM,YAAY,GAAmB;YACnC,UAAU,EAAE,IAAW;YACvB,MAAM,EAAE,MAAM,IAAI,sBAAa;SAChC,CAAC;QAEF,MAAM,MAAM,GAAoB,EAAE,CAAC;QAEnC,IAAI,UAAU,CAAC,QAAQ,CAAC,UAAU,CAAC,EAAE,CAAC;YACpC,MAAM,CAAC,IAAI,CAAC,IAAI,gDAAqB,CAAC,YAAY,CAAC,CAAC,CAAC;QACvD,CAAC;QACD,IAAI,UAAU,CAAC,QAAQ,CAAC,MAAM,CAAC,EAAE,CAAC;YAChC,MAAM,CAAC,IAAI,CAAC,IAAI,kDAAsB,CAAC,YAAY,CAAC,CAAC,CAAC;QACxD,CAAC;QACD,IAAI,UAAU,CAAC,QAAQ,CAAC,KAAK,CAAC,EAAE,CAAC;YAC/B,MAAM,CAAC,IAAI,CAAC,IAAI,gDAAqB,CAAC,YAAY,CAAC,CAAC,CAAC;QACvD,CAAC;QACD,IAAI,UAAU,CAAC,QAAQ,CAAC,QAAQ,CAAC,EAAE,CAAC;YAClC,MAAM,CAAC,IAAI,CAAC,IAAI,4CAAmB,CAAC,YAAY,CAAC,CAAC,CAAC;QACrD,CAAC;QACD,IAAI,UAAU,CAAC,QAAQ,CAAC,QAAQ,CAAC,EAAE,CAAC;YAClC,MAAM,CAAC,IAAI,CAAC,IAAI,4CAAmB,CAAC,YAAY,CAAC,CAAC,CAAC;QACrD,CAAC;QAED,OAAO,IAAI,wDAAyB,CAAC,MAAM,CAAC,CAAC;IAC/C,CAAC;CACF;AAjED,kDAiEC"}

package/dist/server/index.d.ts

@@ -1,4 +1,5 @@
 export * from './BaseMcpServer.js';
+export * from './EmbeddableMcpServer.js';
 export * from './IHttpApplication.js';
 export * from './SseServer.js';
 export * from './StdioServer.js';

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/server/index.ts"],"names":[],"mappings":"AAAA,cAAc,oBAAoB,CAAC;AACnC,cAAc,uBAAuB,CAAC;AACtC,cAAc,gBAAgB,CAAC;AAC/B,cAAc,kBAAkB,CAAC;AACjC,cAAc,2BAA2B,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/server/index.ts"],"names":[],"mappings":"AAAA,cAAc,oBAAoB,CAAC;AACnC,cAAc,0BAA0B,CAAC;AACzC,cAAc,uBAAuB,CAAC;AACtC,cAAc,gBAAgB,CAAC;AAC/B,cAAc,kBAAkB,CAAC;AACjC,cAAc,2BAA2B,CAAC"}

package/dist/server/index.js

@@ -15,6 +15,7 @@ var __exportStar = (this && this.__exportStar) || function(m, exports) {
 };
 Object.defineProperty(exports, "__esModule", { value: true });
 __exportStar(require("./BaseMcpServer.js"), exports);
+__exportStar(require("./EmbeddableMcpServer.js"), exports);
 __exportStar(require("./IHttpApplication.js"), exports);
 __exportStar(require("./SseServer.js"), exports);
 __exportStar(require("./StdioServer.js"), exports);

package/dist/server/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/server/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,qDAAmC;AACnC,wDAAsC;AACtC,iDAA+B;AAC/B,mDAAiC;AACjC,4DAA0C"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/server/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,qDAAmC;AACnC,2DAAyC;AACzC,wDAAsC;AACtC,iDAA+B;AAC/B,mDAAiC;AACjC,4DAA0C"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@mcp-abap-adt/core",
-  "version": "1.4.3",
+  "version": "2.0.0",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",
   "exports": {