@mcp-abap-adt/core 4.7.1 → 4.8.2

package/dist/src/server/BaseMcpServer.js

@@ -0,0 +1,378 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.BaseMcpServer = void 0;
+const node_module_1 = require("node:module");
+const connection_1 = require("@mcp-abap-adt/connection");
+const mcp_js_1 = require("@modelcontextprotocol/sdk/server/mcp.js");
+const CompositeHandlersRegistry_js_1 = require("../lib/handlers/registry/CompositeHandlersRegistry.js");
+const schemaUtils_js_1 = require("../lib/handlers/utils/schemaUtils.js");
+const systemContext_js_1 = require("../lib/systemContext.js");
+const utils_js_1 = require("../lib/utils.js");
+/**
+ * Base MCP Server class that extends SDK McpServer
+ * Manages connection context and provides connection injection for handlers
+ */
+class BaseMcpServer extends mcp_js_1.McpServer {
+    /**
+     * Logger used for handler context
+     */
+    logger;
+    /**
+     * Connection context (set per request for SSE/HTTP, once for stdio)
+     */
+    connectionContext = null;
+    /**
+     * Auth broker for token and service key management
+     */
+    authBroker;
+    /**
+     * Cached connection for stdio mode (created once, reused for all requests)
+     */
+    cachedConnection = null;
+    constructor(options) {
+        super({ name: options.name, version: options.version ?? '1.0.0' });
+        this.logger = options.logger ?? getDefaultLogger();
+    }
+    /**
+     * Sets connection context using auth broker
+     * For stdio: called once on startup
+     * For SSE/HTTP: called per-request
+     */
+    async setConnectionContext(destination, authBroker) {
+        this.authBroker = authBroker;
+        // Register broker so destination-aware connections can refresh tokens
+        (0, utils_js_1.registerAuthBroker)(destination, authBroker);
+        this.logger.debug(`[BaseMcpServer] Getting connection config for destination: ${destination}`);
+        // Get connection parameters from broker
+        // AuthBroker.getConnectionConfig() automatically checks session store first, then service key store
+        const connectionConfig = await authBroker.getConnectionConfig(destination);
+        this.logger.debug(`[BaseMcpServer] Connection config result:`, {
+            found: !!connectionConfig,
+            destination,
+            hasServiceUrl: !!connectionConfig?.serviceUrl,
+        });
+        if (!connectionConfig) {
+            throw new Error(`Connection config not found for destination: ${destination}`);
+        }
+        // Try to get fresh token from broker
+        // If broker can't refresh (no UAA credentials), use existing token from connectionConfig
+        let freshToken;
+        let tokenError;
+        try {
+            freshToken = await authBroker.getToken(destination);
+        }
+        catch (error) {
+            // Broker can't provide/refresh token (e.g., no UAA credentials for .env-only setup)
+            // Use existing token from connectionConfig - user is responsible for token management
+            this.logger.debug(`Broker can't refresh token, using existing token from session: ${error instanceof Error ? error.message : String(error)}`);
+            tokenError = error;
+            freshToken = connectionConfig.authorizationToken;
+        }
+        const tokenToUse = freshToken || connectionConfig.authorizationToken || '';
+        // Determine auth type from connection config
+        const authType = connectionConfig.authType ||
+            (connectionConfig.username && connectionConfig.password
+                ? 'basic'
+                : 'jwt');
+        if (authType === 'jwt' && !tokenToUse) {
+            const reason = tokenError instanceof Error ? tokenError.message : String(tokenError);
+            throw new Error(`JWT token is missing for destination "${destination}". ${reason ? `Token provider error: ${reason}. ` : ''}Provide a valid session token (or refresh token) for this destination, or use --env-path with SAP_JWT_TOKEN.`);
+        }
+        // Connection type from env (http or rfc) — not stored in broker/session
+        const connectionType = process.env.SAP_CONNECTION_TYPE?.trim().toLowerCase() === 'rfc'
+            ? 'rfc'
+            : undefined;
+        // Resolve masterSystem/responsible early so handlers get proper context
+        // Create a temporary connection to call getSystemInformation
+        let masterSystem;
+        let responsible;
+        try {
+            const tempParams = authType === 'jwt'
+                ? {
+                    url: connectionConfig.serviceUrl || '',
+                    authType: 'jwt',
+                    jwtToken: tokenToUse,
+                    client: connectionConfig.sapClient || '',
+                }
+                : {
+                    url: connectionConfig.serviceUrl || '',
+                    authType: 'basic',
+                    username: connectionConfig.username || '',
+                    password: connectionConfig.password || '',
+                    client: connectionConfig.sapClient || '',
+                };
+            const tempConn = (0, connection_1.createAbapConnection)(tempParams);
+            const systemCtx = await (0, systemContext_js_1.resolveSystemContext)(tempConn);
+            masterSystem = systemCtx.masterSystem;
+            responsible = systemCtx.responsible;
+            // Use client from system info as fallback when not in .env (cloud systems)
+            if (!connectionConfig.sapClient && systemCtx.client) {
+                connectionConfig.sapClient = systemCtx.client;
+            }
+            this.logger.debug(`[BaseMcpServer] Resolved systemContext: masterSystem=${masterSystem}, responsible=${responsible}, client=${systemCtx.client || '(none)'}`);
+        }
+        catch (error) {
+            this.logger.debug(`[BaseMcpServer] Could not resolve systemContext: ${error instanceof Error ? error.message : String(error)}`);
+        }
+        this.connectionContext = {
+            sessionId: destination,
+            connectionParams: authType === 'basic'
+                ? {
+                    url: connectionConfig.serviceUrl || '',
+                    authType: 'basic',
+                    username: connectionConfig.username || '',
+                    password: connectionConfig.password || '',
+                    client: connectionConfig.sapClient || '',
+                    ...(connectionType && { connectionType }),
+                }
+                : {
+                    url: connectionConfig.serviceUrl || '',
+                    authType: 'jwt',
+                    jwtToken: tokenToUse, // broker keeps it fresh
+                    client: connectionConfig.sapClient || '',
+                },
+            metadata: {
+                destination,
+                masterSystem,
+                responsible,
+            },
+        };
+    }
+    /**
+     * Sets connection context from HTTP headers (direct SAP connection, no broker)
+     * Used when x-sap-url + auth headers are provided
+     */
+    setConnectionContextFromHeaders(headers) {
+        const getHeader = (name) => {
+            const value = headers[name] ?? headers[name.toUpperCase()];
+            return Array.isArray(value) ? value[0] : value;
+        };
+        const url = getHeader('x-sap-url');
+        const jwtToken = getHeader('x-sap-jwt-token');
+        const username = getHeader('x-sap-login');
+        const password = getHeader('x-sap-password');
+        const client = getHeader('x-sap-client') || '';
+        const masterSystem = getHeader('x-sap-master-system');
+        const responsible = getHeader('x-sap-responsible');
+        if (!url) {
+            throw new Error('x-sap-url header is required for direct SAP connection');
+        }
+        const metadata = {};
+        if (masterSystem)
+            metadata.masterSystem = masterSystem;
+        if (responsible)
+            metadata.responsible = responsible;
+        if (jwtToken) {
+            // JWT auth
+            this.connectionContext = {
+                sessionId: 'direct-jwt',
+                connectionParams: {
+                    url,
+                    authType: 'jwt',
+                    jwtToken,
+                    client,
+                },
+                metadata,
+            };
+        }
+        else if (username && password) {
+            // Basic auth
+            this.connectionContext = {
+                sessionId: 'direct-basic',
+                connectionParams: {
+                    url,
+                    authType: 'basic',
+                    username,
+                    password,
+                    client,
+                },
+                metadata,
+            };
+        }
+        else {
+            throw new Error('Either x-sap-jwt-token or x-sap-login+x-sap-password headers are required');
+        }
+    }
+    /**
+     * Gets current connection context
+     */
+    getConnectionContext() {
+        return this.connectionContext;
+    }
+    /**
+     * Gets ABAP connection from connection context
+     * Creates connection using connectionParams from context
+     * Automatically refreshes token via AuthBroker if available (inside makeAdtRequest)
+     * For stdio mode: caches connection and reuses it for all requests (like v1)
+     * For SSE/HTTP: creates new connection per request
+     */
+    async getConnection() {
+        if (!this.connectionContext?.connectionParams) {
+            throw new Error('Connection context not set. Call setConnectionContext() first.');
+        }
+        const destination = this.connectionContext.metadata?.destination;
+        const sessionId = this.connectionContext.sessionId;
+        // For stdio mode: cache connection and reuse it (like v1)
+        // This prevents creating new connection on each request, which would trigger browser auth
+        // Check if we have cached connection with same sessionId (stdio uses destination as sessionId)
+        if (destination && this.cachedConnection && sessionId === destination) {
+            // Reuse cached connection for stdio mode
+            return this.cachedConnection;
+        }
+        // For non-stdio connections, reset system context cache so each request
+        // resolves fresh (different requests may target different systems)
+        const isStdio = destination && sessionId === destination;
+        if (!isStdio) {
+            (0, systemContext_js_1.resetSystemContextCache)();
+        }
+        // Create tokenRefresher from AuthBroker for automatic JWT token refresh on 401
+        let tokenRefresher;
+        if (destination &&
+            this.authBroker &&
+            this.connectionContext.connectionParams.authType === 'jwt' &&
+            typeof this.authBroker.createTokenRefresher === 'function') {
+            tokenRefresher = this.authBroker.createTokenRefresher(destination);
+        }
+        const connection = (0, connection_1.createAbapConnection)(this.connectionContext.connectionParams, undefined, undefined, tokenRefresher);
+        // Establish session (CSRF token + cookies) before first request.
+        // RFC needs this for the stateful session; HTTP needs it because some SAP systems
+        // reject the very first request (403) when no session cookie is present.
+        if (typeof connection.connect === 'function') {
+            await connection.connect();
+        }
+        // Build overrides from metadata (HTTP headers)
+        const metadata = this.connectionContext?.metadata || {};
+        const masterSystem = metadata.masterSystem;
+        const responsible = metadata.responsible;
+        const overrides = masterSystem || responsible ? { masterSystem, responsible } : undefined;
+        // Resolve system context (masterSystem/responsible) once per connection
+        await (0, systemContext_js_1.resolveSystemContext)(connection, overrides);
+        // Cache connection for stdio mode (when sessionId === destination, it's stdio)
+        // SSE/HTTP modes use different sessionId per request, so caching won't interfere
+        if (destination && sessionId === destination) {
+            this.cachedConnection = connection;
+        }
+        return connection;
+    }
+    /**
+     * 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
+     */
+    registerHandlers(handlersRegistry) {
+        // Get handler groups from registry
+        if (handlersRegistry instanceof CompositeHandlersRegistry_js_1.CompositeHandlersRegistry) {
+            const groups = handlersRegistry.getHandlerGroups();
+            for (const group of groups) {
+                const handlers = group.getHandlers();
+                for (const entry of handlers) {
+                    const wrappedHandler = async (args) => {
+                        // Get connection from context (this.connectionContext)
+                        // Token will be automatically refreshed via AuthBroker if needed
+                        const context = {
+                            connection: await this.getConnection(),
+                            logger: this.logger,
+                        };
+                        // If handler expects context+args (preferred), pass both.
+                        // Otherwise, update group context and call with args only for backward compatibility.
+                        // NOTE: Always await the handler result to ensure we get the resolved value for normalization
+                        let handlerPromise;
+                        if (entry.handler.length >= 2) {
+                            handlerPromise = entry.handler(context, args);
+                        }
+                        else {
+                            try {
+                                const contextAwareGroup = group;
+                                if (typeof contextAwareGroup.setContext === 'function') {
+                                    contextAwareGroup.setContext(context);
+                                }
+                                else {
+                                    contextAwareGroup.context = context;
+                                }
+                            }
+                            catch {
+                                // ignore if group doesn't expose context setter
+                            }
+                            handlerPromise = entry.handler(args);
+                        }
+                        const result = await handlerPromise;
+                        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 !== undefined
+                                    ? String(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),
+                                };
+                            }
+                            // Ensure all items have proper text type structure
+                            return {
+                                type: 'text',
+                                text: item?.text !== undefined
+                                    ? String(item.text)
+                                    : String(item || ''),
+                            };
+                        });
+                        return { content };
+                    };
+                    // Convert JSON Schema to Zod if needed, otherwise pass as-is
+                    const zodSchema = entry.toolDefinition.inputSchema &&
+                        typeof entry.toolDefinition.inputSchema === 'object' &&
+                        entry.toolDefinition.inputSchema.type === 'object' &&
+                        entry.toolDefinition.inputSchema.properties
+                        ? (0, schemaUtils_js_1.jsonSchemaToZod)(entry.toolDefinition.inputSchema)
+                        : entry.toolDefinition.inputSchema;
+                    // Skip tools not available in the current SAP environment
+                    const availableIn = entry.toolDefinition.available_in;
+                    if (availableIn && availableIn.length > 0) {
+                        const envType = process.env.SAP_SYSTEM_TYPE?.toLowerCase();
+                        const currentEnv = envType === 'legacy'
+                            ? 'legacy'
+                            : envType === 'onprem'
+                                ? 'onprem'
+                                : 'cloud';
+                        if (!availableIn.includes(currentEnv)) {
+                            this.logger.debug(`[BaseMcpServer] Skipping tool ${entry.toolDefinition.name}: available_in=${JSON.stringify(availableIn)}, currentEnv=${currentEnv}, SAP_SYSTEM_TYPE=${envType || '(not set, default: cloud)'}`);
+                            continue;
+                        }
+                    }
+                    // Register wrapped handler via SDK registerTool
+                    // Note: connection is NOT part of MCP tool signature
+                    this.registerTool(entry.toolDefinition.name, {
+                        description: entry.toolDefinition.description,
+                        inputSchema: zodSchema,
+                    }, wrappedHandler);
+                }
+            }
+        }
+        else {
+            // Fallback: use registerAllTools directly (handlers won't have connection injected)
+            // This should not happen in normal flow
+            handlersRegistry.registerAllTools(this);
+        }
+    }
+}
+exports.BaseMcpServer = BaseMcpServer;
+function getDefaultLogger() {
+    const require = (0, node_module_1.createRequire)(__filename);
+    const mod = require('@mcp-abap-adt/logger');
+    return mod.defaultLogger ?? new mod.DefaultLogger();
+}
+//# sourceMappingURL=BaseMcpServer.js.map

package/dist/src/server/BaseMcpServer.js.map

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

package/dist/src/server/ConnectionContext.d.ts

@@ -0,0 +1,20 @@
+import type { SapConfig } from '@mcp-abap-adt/connection';
+/**
+ * Connection context for MCP server
+ * Contains connection parameters and session information
+ */
+export interface ConnectionContext {
+    /**
+     * Connection parameters (SAP URL, auth, client)
+     */
+    connectionParams: SapConfig;
+    /**
+     * Session ID for this connection context
+     */
+    sessionId: string;
+    /**
+     * Optional metadata for additional context information
+     */
+    metadata?: Record<string, any>;
+}
+//# sourceMappingURL=ConnectionContext.d.ts.map

package/dist/src/server/ConnectionContext.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ConnectionContext.d.ts","sourceRoot":"","sources":["../../../src/server/ConnectionContext.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,0BAA0B,CAAC;AAE1D;;;GAGG;AACH,MAAM,WAAW,iBAAiB;IAChC;;OAEG;IACH,gBAAgB,EAAE,SAAS,CAAC;IAE5B;;OAEG;IACH,SAAS,EAAE,MAAM,CAAC;IAElB;;OAEG;IACH,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;CAChC"}

package/dist/src/server/ConnectionContext.js

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

package/dist/src/server/ConnectionContext.js.map

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

package/dist/src/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' | 'compact' | '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/src/server/EmbeddableMcpServer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"EmbeddableMcpServer.d.ts","sourceRoot":"","sources":["../../../src/server/EmbeddableMcpServer.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,0BAA0B,CAAC;AAC/D,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,sBAAsB,CAAC;AAQnD,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,CACT,UAAU,GACV,MAAM,GACN,KAAK,GACL,SAAS,GACT,QAAQ,GACR,QAAQ,CACX,EAAE,CAAC;IAEJ;;;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;CAyC9B"}

package/dist/src/server/EmbeddableMcpServer.js

@@ -0,0 +1,97 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.EmbeddableMcpServer = void 0;
+const node_module_1 = require("node:module");
+const CompactHandlersGroup_js_1 = require("../lib/handlers/groups/CompactHandlersGroup.js");
+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,
+        });
+        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 ?? getDefaultLogger(),
+        };
+        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('compact')) {
+            groups.push(new CompactHandlersGroup_js_1.CompactHandlersGroup(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;
+function getDefaultLogger() {
+    const require = (0, node_module_1.createRequire)(__filename);
+    const mod = require('@mcp-abap-adt/logger');
+    return mod.defaultLogger ?? new mod.DefaultLogger();
+}
+//# sourceMappingURL=EmbeddableMcpServer.js.map

package/dist/src/server/EmbeddableMcpServer.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"EmbeddableMcpServer.js","sourceRoot":"","sources":["../../../src/server/EmbeddableMcpServer.ts"],"names":[],"mappings":";;;AAAA,6CAA4C;AAI5C,4FAAsF;AACtF,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;AA4CnE;;;;;;;;;;;;;;;;;;;;;;;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;SACvB,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,UAOG,EACH,MAAe;QAEf,6EAA6E;QAC7E,sEAAsE;QACtE,MAAM,YAAY,GAAmB;YACnC,UAAU,EAAE,IAAiC;YAC7C,MAAM,EAAE,MAAM,IAAI,gBAAgB,EAAE;SACrC,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,SAAS,CAAC,EAAE,CAAC;YACnC,MAAM,CAAC,IAAI,CAAC,IAAI,8CAAoB,CAAC,YAAY,CAAC,CAAC,CAAC;QACtD,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;AA3ED,kDA2EC;AAED,SAAS,gBAAgB;IACvB,MAAM,OAAO,GAAG,IAAA,2BAAa,EAAC,UAAU,CAAC,CAAC;IAC1C,MAAM,GAAG,GAAG,OAAO,CAAC,sBAAsB,CAAC,CAAC;IAC5C,OAAO,GAAG,CAAC,aAAa,IAAI,IAAI,GAAG,CAAC,aAAa,EAAE,CAAC;AACtD,CAAC"}

package/dist/src/server/IHttpApplication.d.ts

@@ -0,0 +1,42 @@
+import type { NextFunction, Request, Response } from 'express';
+/**
+ * Handler function type for HTTP routes
+ */
+export type RouteHandler = (req: Request, res: Response, next?: NextFunction) => void | Promise<void>;
+/**
+ * Interface for Express-like HTTP application
+ * Allows injection of external HTTP server into v2 MCP servers
+ *
+ * This enables integration with existing Express/CDS/CAP servers
+ * without creating a separate HTTP server instance
+ */
+export interface IHttpApplication {
+    /**
+     * Register GET route handler
+     */
+    get(path: string, handler: RouteHandler): void;
+    /**
+     * Register POST route handler
+     */
+    post(path: string, handler: RouteHandler): void;
+    /**
+     * Register handler for all HTTP methods
+     */
+    all(path: string, handler: RouteHandler): void;
+    /**
+     * Register middleware (optional - not all apps support this)
+     */
+    use?(path: string | RouteHandler, handler?: RouteHandler): void;
+}
+/**
+ * Options for route registration on external app
+ */
+export interface RouteRegistrationOptions {
+    /**
+     * Whether to add express.json() middleware for the routes
+     * Set to false if the external app already has JSON parsing middleware
+     * @default true for standalone, false for external app
+     */
+    addJsonMiddleware?: boolean;
+}
+//# sourceMappingURL=IHttpApplication.d.ts.map

package/dist/src/server/IHttpApplication.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"IHttpApplication.d.ts","sourceRoot":"","sources":["../../../src/server/IHttpApplication.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,OAAO,EAAE,QAAQ,EAAE,MAAM,SAAS,CAAC;AAE/D;;GAEG;AACH,MAAM,MAAM,YAAY,GAAG,CACzB,GAAG,EAAE,OAAO,EACZ,GAAG,EAAE,QAAQ,EACb,IAAI,CAAC,EAAE,YAAY,KAChB,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;AAE1B;;;;;;GAMG;AACH,MAAM,WAAW,gBAAgB;IAC/B;;OAEG;IACH,GAAG,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,YAAY,GAAG,IAAI,CAAC;IAE/C;;OAEG;IACH,IAAI,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,YAAY,GAAG,IAAI,CAAC;IAEhD;;OAEG;IACH,GAAG,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,YAAY,GAAG,IAAI,CAAC;IAE/C;;OAEG;IACH,GAAG,CAAC,CAAC,IAAI,EAAE,MAAM,GAAG,YAAY,EAAE,OAAO,CAAC,EAAE,YAAY,GAAG,IAAI,CAAC;CACjE;AAED;;GAEG;AACH,MAAM,WAAW,wBAAwB;IACvC;;;;OAIG;IACH,iBAAiB,CAAC,EAAE,OAAO,CAAC;CAC7B"}