@mcp-abap-adt/core 4.8.1 → 4.8.2

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/lib/handlers/index.ts"],"names":[],"mappings":";AAAA;;;;;;;;;GASG;;;;;;;;;;;;;;;;;AAEH,eAAe;AACf,kEAA8D;AAArD,uHAAA,gBAAgB,OAAA;AACzB,iBAAiB;AACjB,oDAAkC;AAElC,mDAAmD;AACnD,2DAG8B;AAF5B,kIAAA,4BAA4B,OAAA;AAC5B,qHAAA,eAAe,OAAA;AAEjB,aAAa;AACb,kDAAgC;AAChC,2BAA2B;AAC3B,wFAAoF;AAA3E,yIAAA,yBAAyB,OAAA"}

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

@@ -0,0 +1,80 @@
+import type { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+import type { HandlerContext } from '../../handlers/interfaces.js';
+export type { HandlerContext };
+/**
+ * Tool definition structure
+ */
+/**
+ * SAP environment types for tool availability filtering.
+ * - 'cloud'  — BTP ABAP Environment (jwt auth)
+ * - 'onprem' — Modern on-premise (BASIS >= 7.50)
+ * - 'legacy' — Legacy on-premise (BASIS < 7.50)
+ */
+export type SapEnvironment = 'cloud' | 'onprem' | 'legacy';
+export interface ToolDefinition {
+    name: string;
+    description: string;
+    inputSchema: any;
+    /**
+     * SAP environments where this tool is available.
+     * If omitted, the tool is available in all environments.
+     */
+    available_in?: readonly SapEnvironment[];
+}
+/**
+ * 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/src/lib/handlers/interfaces.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"interfaces.d.ts","sourceRoot":"","sources":["../../../../src/lib/handlers/interfaces.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AACzE,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,8BAA8B,CAAC;AAGnE,YAAY,EAAE,cAAc,EAAE,CAAC;AAE/B;;GAEG;AACH;;;;;GAKG;AACH,MAAM,MAAM,cAAc,GAAG,OAAO,GAAG,QAAQ,GAAG,QAAQ,CAAC;AAE3D,MAAM,WAAW,cAAc;IAC7B,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,WAAW,EAAE,GAAG,CAAC;IACjB;;;OAGG;IACH,YAAY,CAAC,EAAE,SAAS,cAAc,EAAE,CAAC;CAC1C;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/src/lib/handlers/interfaces.js

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

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

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

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

@@ -0,0 +1,49 @@
+import type { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+import type { IHandlerGroup, IHandlersRegistry, 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/src/lib/handlers/registry/CompositeHandlersRegistry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"CompositeHandlersRegistry.d.ts","sourceRoot":"","sources":["../../../../../src/lib/handlers/registry/CompositeHandlersRegistry.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AACzE,OAAO,KAAK,EACV,aAAa,EACb,iBAAiB,EACjB,cAAc,EACd,WAAW,EACZ,MAAM,kBAAkB,CAAC;AAE1B;;;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;gBAED,aAAa,GAAE,aAAa,EAAO,EACnC,eAAe,GAAE,OAAc;IAMjC;;;OAGG;IACH,eAAe,CAAC,KAAK,EAAE,aAAa,GAAG,IAAI;IAI3C;;;OAGG;IACH,kBAAkB,CAAC,SAAS,EAAE,MAAM,GAAG,IAAI;IAM3C;;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/src/lib/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/src/lib/handlers/registry/CompositeHandlersRegistry.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"CompositeHandlersRegistry.js","sourceRoot":"","sources":["../../../../../src/lib/handlers/registry/CompositeHandlersRegistry.ts"],"names":[],"mappings":";;;AAQA;;;GAGG;AACH,MAAa,yBAAyB;IAC5B,eAAe,GAAgB,IAAI,GAAG,EAAE,CAAC;IACzC,aAAa,CAAkB;IACtB,eAAe,CAAU;IAE1C;;;;OAIG;IACH,YACE,gBAAiC,EAAE,EACnC,kBAA2B,IAAI;QAE/B,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,CAC5C,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,OAAO,EAAE,KAAK,SAAS,CACjC,CAAC;IACJ,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,EAAE,CAAC,CAAC,CAAC,OAAO,EAAE,CAAC,CAAC;IACpD,CAAC;CACF;AArGD,8DAqGC"}

package/dist/src/lib/handlers/utils/schemaUtils.d.ts

@@ -0,0 +1,6 @@
+/**
+ * Converts JSON Schema to Zod schema object (not z.object(), but object with Zod fields)
+ * SDK expects inputSchema to be an object with Zod schemas as values, not z.object()
+ */
+export declare function jsonSchemaToZod(jsonSchema: any): any;
+//# sourceMappingURL=schemaUtils.d.ts.map

package/dist/src/lib/handlers/utils/schemaUtils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"schemaUtils.d.ts","sourceRoot":"","sources":["../../../../../src/lib/handlers/utils/schemaUtils.ts"],"names":[],"mappings":"AAEA;;;GAGG;AACH,wBAAgB,eAAe,CAAC,UAAU,EAAE,GAAG,GAAG,GAAG,CA8LpD"}

package/dist/src/lib/handlers/utils/schemaUtils.js

@@ -0,0 +1,215 @@
+"use strict";
+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 __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.jsonSchemaToZod = jsonSchemaToZod;
+const z = __importStar(require("zod"));
+/**
+ * Converts JSON Schema to Zod schema object (not z.object(), but object with Zod fields)
+ * SDK expects inputSchema to be an object with Zod schemas as values, not z.object()
+ */
+function jsonSchemaToZod(jsonSchema) {
+    // If already a Zod schema object (object with Zod fields), return as-is
+    if (jsonSchema &&
+        typeof jsonSchema === 'object' &&
+        !jsonSchema.type &&
+        !jsonSchema.properties) {
+        // Check if it looks like a Zod schema object (has Zod types as values)
+        const firstValue = Object.values(jsonSchema)[0];
+        if (firstValue &&
+            (firstValue.def ||
+                firstValue._def ||
+                typeof firstValue.parse === 'function')) {
+            return jsonSchema;
+        }
+    }
+    // If it's a JSON Schema object
+    if (jsonSchema &&
+        typeof jsonSchema === 'object' &&
+        jsonSchema.type === 'object' &&
+        jsonSchema.properties) {
+        const zodShape = {};
+        const required = jsonSchema.required || [];
+        for (const [key, prop] of Object.entries(jsonSchema.properties)) {
+            const propSchema = prop;
+            let zodType;
+            if (propSchema.type === 'string') {
+                if (propSchema.enum &&
+                    Array.isArray(propSchema.enum) &&
+                    propSchema.enum.length > 0) {
+                    // Use z.enum() for enum values (requires at least 1 element, but z.enum needs 2+)
+                    if (propSchema.enum.length === 1) {
+                        zodType = z.literal(propSchema.enum[0]);
+                    }
+                    else {
+                        zodType = z.enum(propSchema.enum);
+                    }
+                }
+                else {
+                    zodType = z.string();
+                }
+            }
+            else if (propSchema.type === 'number' ||
+                propSchema.type === 'integer') {
+                zodType = z.number();
+            }
+            else if (propSchema.type === 'boolean') {
+                zodType = z.boolean();
+            }
+            else if (propSchema.type === 'array') {
+                const items = propSchema.items;
+                if (items?.type === 'string') {
+                    zodType = z.array(z.string());
+                }
+                else if (items?.type === 'number' || items?.type === 'integer') {
+                    zodType = z.array(z.number());
+                }
+                else if (items?.type === 'boolean') {
+                    zodType = z.array(z.boolean());
+                }
+                else if (items?.type === 'object' && items.properties) {
+                    // For nested objects in arrays, create object schema
+                    const nestedShape = {};
+                    const nestedRequired = items.required || [];
+                    for (const [nestedKey, nestedProp] of Object.entries(items.properties)) {
+                        const nestedPropSchema = nestedProp;
+                        let nestedZodType;
+                        if (nestedPropSchema.type === 'string') {
+                            if (nestedPropSchema.enum &&
+                                Array.isArray(nestedPropSchema.enum) &&
+                                nestedPropSchema.enum.length > 0) {
+                                if (nestedPropSchema.enum.length === 1) {
+                                    nestedZodType = z.literal(nestedPropSchema.enum[0]);
+                                }
+                                else {
+                                    nestedZodType = z.enum(nestedPropSchema.enum);
+                                }
+                            }
+                            else {
+                                nestedZodType = z.string();
+                            }
+                        }
+                        else if (nestedPropSchema.type === 'number' ||
+                            nestedPropSchema.type === 'integer') {
+                            nestedZodType = z.number();
+                        }
+                        else if (nestedPropSchema.type === 'boolean') {
+                            nestedZodType = z.boolean();
+                        }
+                        else {
+                            nestedZodType = z.any();
+                        }
+                        if (nestedPropSchema.default !== undefined) {
+                            nestedZodType = nestedZodType.default(nestedPropSchema.default);
+                        }
+                        if (!nestedRequired.includes(nestedKey)) {
+                            nestedZodType = nestedZodType.optional();
+                        }
+                        if (nestedPropSchema.description) {
+                            nestedZodType = nestedZodType.describe(nestedPropSchema.description);
+                        }
+                        nestedShape[nestedKey] = nestedZodType;
+                    }
+                    zodType = z.array(z.object(nestedShape));
+                }
+                else {
+                    zodType = z.array(z.any());
+                }
+            }
+            else if (propSchema.type === 'object' && propSchema.properties) {
+                // For nested objects, create object schema
+                const nestedShape = {};
+                const nestedRequired = propSchema.required || [];
+                for (const [nestedKey, nestedProp] of Object.entries(propSchema.properties)) {
+                    const nestedPropSchema = nestedProp;
+                    let nestedZodType;
+                    if (nestedPropSchema.type === 'string') {
+                        if (nestedPropSchema.enum && Array.isArray(nestedPropSchema.enum)) {
+                            nestedZodType = z.enum(nestedPropSchema.enum);
+                        }
+                        else {
+                            nestedZodType = z.string();
+                        }
+                    }
+                    else if (nestedPropSchema.type === 'number' ||
+                        nestedPropSchema.type === 'integer') {
+                        nestedZodType = z.number();
+                    }
+                    else if (nestedPropSchema.type === 'boolean') {
+                        nestedZodType = z.boolean();
+                    }
+                    else {
+                        nestedZodType = z.any();
+                    }
+                    if (nestedPropSchema.default !== undefined) {
+                        nestedZodType = nestedZodType.default(nestedPropSchema.default);
+                    }
+                    if (!nestedRequired.includes(nestedKey)) {
+                        nestedZodType = nestedZodType.optional();
+                    }
+                    if (nestedPropSchema.description) {
+                        nestedZodType = nestedZodType.describe(nestedPropSchema.description);
+                    }
+                    nestedShape[nestedKey] = nestedZodType;
+                }
+                zodType = z.object(nestedShape);
+            }
+            else {
+                zodType = z.any();
+            }
+            // Add default value if present (before optional)
+            if (propSchema.default !== undefined) {
+                zodType = zodType.default(propSchema.default);
+            }
+            // Make optional if not in required array (must be after default, before describe)
+            if (!required.includes(key)) {
+                zodType = zodType.optional();
+            }
+            // Add description if present (after optional)
+            if (propSchema.description) {
+                zodType = zodType.describe(propSchema.description);
+            }
+            zodShape[key] = zodType;
+        }
+        // Return object with Zod fields, not z.object()
+        return zodShape;
+    }
+    // Fallback: if it's already a Zod schema object, return as-is
+    if (jsonSchema && typeof jsonSchema === 'object' && !jsonSchema.type) {
+        return jsonSchema;
+    }
+    // Fallback: return empty object for unknown schemas
+    return {};
+}
+//# sourceMappingURL=schemaUtils.js.map

package/dist/src/lib/handlers/utils/schemaUtils.js.map

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

package/dist/src/lib/logger.d.ts

@@ -0,0 +1,28 @@
+/**
+ * Logger module for MCP-compatible logging
+ *
+ * This file provides logging utilities that work both in regular console mode
+ * and with the MCP Inspector. It avoids direct console.log calls which can
+ * interfere with MCP's JSON-RPC communication.
+ */
+export declare const logger: {
+    info: (message: string, data?: any) => void;
+    warn: (message: string, data?: any) => void;
+    error: (message: string, data?: any) => void;
+    debug: (message: string, data?: any) => void;
+    tlsConfig: (rejectUnauthorized: boolean) => void;
+    csrfToken: (type: "fetch" | "success" | "error" | "retry", message: string, data?: any) => void;
+};
+export declare const handlerLogger: {
+    info: (handlerName: string, step: string, message: string, data?: any) => void;
+    warn: (handlerName: string, step: string, message: string, data?: any) => void;
+    error: (handlerName: string, step: string, message: string, data?: any) => void;
+    debug: (handlerName: string, step: string, message: string, data?: any) => void;
+};
+export declare const connectionManagerLogger: {
+    debug: (message: string, data?: any) => void;
+    info: (message: string, data?: any) => void;
+    warn: (message: string, data?: any) => void;
+    error: (message: string, data?: any) => void;
+};
+//# sourceMappingURL=logger.d.ts.map

package/dist/src/lib/logger.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"logger.d.ts","sourceRoot":"","sources":["../../../src/lib/logger.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAmMH,eAAO,MAAM,MAAM;oBApHA,MAAM,SAAS,GAAG;oBAAlB,MAAM,SAAS,GAAG;qBAAlB,MAAM,SAAS,GAAG;qBAAlB,MAAM,SAAS,GAAG;oCA2HH,OAAO;sBA4B/B,OAAO,GAAG,SAAS,GAAG,OAAO,GAAG,OAAO,WACpC,MAAM,SACR,GAAG;CAuBb,CAAC;AA6CF,eAAO,MAAM,aAAa;wBACJ,MAAM,QAAQ,MAAM,WAAW,MAAM,SAAS,GAAG;wBAGjD,MAAM,QAAQ,MAAM,WAAW,MAAM,SAAS,GAAG;yBAGhD,MAAM,QAAQ,MAAM,WAAW,MAAM,SAAS,GAAG;yBAGjD,MAAM,QAAQ,MAAM,WAAW,MAAM,SAAS,GAAG;CAGvE,CAAC;AAyCF,eAAO,MAAM,uBAAuB;qBACjB,MAAM,SAAS,GAAG;oBAGnB,MAAM,SAAS,GAAG;oBAGlB,MAAM,SAAS,GAAG;qBAGjB,MAAM,SAAS,GAAG;CAGpC,CAAC"}