@ibm/ibmi-mcp-server 0.1.0

package/dist/mcp-server/constants.d.ts

@@ -0,0 +1,13 @@
+/**
+ * Global constants for MCP-related configuration and specification metadata.
+ */
+/**
+ * The MCP specification snapshot version used by this server.
+ * Keep in sync with documentation references and transport implementations.
+ */
+export declare const MCP_SPEC_VERSION: "2025-06-18";
+/** Base URL to the MCP specification directory for the selected version. */
+export declare const MCP_SPEC_URL_BASE: "https://github.com/modelcontextprotocol/modelcontextprotocol/blob/main/docs/specification";
+/** Convenience link to the stdio transport spec for the selected version. */
+export declare const MCP_STDIO_SPEC_URL: "https://github.com/modelcontextprotocol/modelcontextprotocol/blob/main/docs/specification/2025-06-18/basic/transports.mdx#stdio";
+//# sourceMappingURL=constants.d.ts.map

package/dist/mcp-server/constants.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"constants.d.ts","sourceRoot":"","sources":["../../src/mcp-server/constants.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH;;;GAGG;AACH,eAAO,MAAM,gBAAgB,EAAG,YAAqB,CAAC;AAEtD,4EAA4E;AAC5E,eAAO,MAAM,iBAAiB,EAC5B,2FAAoG,CAAC;AAEvG,6EAA6E;AAC7E,eAAO,MAAM,kBAAkB,mIACiD,CAAC"}

package/dist/mcp-server/constants.js

@@ -0,0 +1,13 @@
+/**
+ * Global constants for MCP-related configuration and specification metadata.
+ */
+/**
+ * The MCP specification snapshot version used by this server.
+ * Keep in sync with documentation references and transport implementations.
+ */
+export const MCP_SPEC_VERSION = "2025-06-18";
+/** Base URL to the MCP specification directory for the selected version. */
+export const MCP_SPEC_URL_BASE = "https://github.com/modelcontextprotocol/modelcontextprotocol/blob/main/docs/specification";
+/** Convenience link to the stdio transport spec for the selected version. */
+export const MCP_STDIO_SPEC_URL = `${MCP_SPEC_URL_BASE}/${MCP_SPEC_VERSION}/basic/transports.mdx#stdio`;
+//# sourceMappingURL=constants.js.map

package/dist/mcp-server/constants.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"constants.js","sourceRoot":"","sources":["../../src/mcp-server/constants.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH;;;GAGG;AACH,MAAM,CAAC,MAAM,gBAAgB,GAAG,YAAqB,CAAC;AAEtD,4EAA4E;AAC5E,MAAM,CAAC,MAAM,iBAAiB,GAC5B,2FAAoG,CAAC;AAEvG,6EAA6E;AAC7E,MAAM,CAAC,MAAM,kBAAkB,GAC7B,GAAG,iBAAiB,IAAI,gBAAgB,6BAAsC,CAAC"}

package/dist/mcp-server/logging/index.d.ts

@@ -0,0 +1,8 @@
+/**
+ * @fileoverview Barrel export for MCP logging protocol handlers.
+ * This module provides a centralized export point for all logging-related
+ * MCP protocol implementations.
+ * @module src/mcp-server/logging
+ */
+export { registerLoggingSetLevelHandler } from "./setLevelHandler.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/mcp-server/logging/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/mcp-server/logging/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,8BAA8B,EAAE,MAAM,sBAAsB,CAAC"}

package/dist/mcp-server/logging/index.js

@@ -0,0 +1,8 @@
+/**
+ * @fileoverview Barrel export for MCP logging protocol handlers.
+ * This module provides a centralized export point for all logging-related
+ * MCP protocol implementations.
+ * @module src/mcp-server/logging
+ */
+export { registerLoggingSetLevelHandler } from "./setLevelHandler.js";
+//# sourceMappingURL=index.js.map

package/dist/mcp-server/logging/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/mcp-server/logging/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,8BAA8B,EAAE,MAAM,sBAAsB,CAAC"}

package/dist/mcp-server/logging/setLevelHandler.d.ts

@@ -0,0 +1,38 @@
+/**
+ * @fileoverview Implements the MCP logging/setLevel request handler.
+ * This module enables MCP clients (like Claude Desktop, Inspector) to dynamically
+ * control the server's logging verbosity at runtime, per the MCP specification.
+ *
+ * MCP Specification Reference:
+ * - Logging: https://modelcontextprotocol.io/specification/2025-03-26/server/utilities/logging
+ *
+ * @module src/mcp-server/logging/setLevelHandler
+ * @see {@link https://github.com/modelcontextprotocol/inspector/issues/610} for context on this requirement
+ */
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+/**
+ * Registers the `logging/setLevel` request handler with the MCP server.
+ *
+ * This handler allows MCP clients to dynamically adjust the server's minimum
+ * log level. When a client sends a `logging/setLevel` request, the server will:
+ * 1. Validate the requested level (via Zod schema)
+ * 2. Update the internal logger's minimum level
+ * 3. Return an empty result to acknowledge the change
+ *
+ * Per the MCP specification, the server must respond with an empty result
+ * object upon successful configuration.
+ *
+ * Supported log levels (per RFC 5424 syslog severity):
+ * - debug, info, notice, warning, error, critical, alert, emergency
+ *
+ * @param server - The McpServer instance to attach the handler to
+ *
+ * @example
+ * ```typescript
+ * const server = new McpServer({ name: "my-server", version: "1.0.0" });
+ * registerLoggingSetLevelHandler(server);
+ * await server.connect(transport);
+ * ```
+ */
+export declare function registerLoggingSetLevelHandler(server: McpServer): void;
+//# sourceMappingURL=setLevelHandler.d.ts.map

package/dist/mcp-server/logging/setLevelHandler.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"setLevelHandler.d.ts","sourceRoot":"","sources":["../../../src/mcp-server/logging/setLevelHandler.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAMpE;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,wBAAgB,8BAA8B,CAAC,MAAM,EAAE,SAAS,GAAG,IAAI,CAwDtE"}

package/dist/mcp-server/logging/setLevelHandler.js

@@ -0,0 +1,83 @@
+/**
+ * @fileoverview Implements the MCP logging/setLevel request handler.
+ * This module enables MCP clients (like Claude Desktop, Inspector) to dynamically
+ * control the server's logging verbosity at runtime, per the MCP specification.
+ *
+ * MCP Specification Reference:
+ * - Logging: https://modelcontextprotocol.io/specification/2025-03-26/server/utilities/logging
+ *
+ * @module src/mcp-server/logging/setLevelHandler
+ * @see {@link https://github.com/modelcontextprotocol/inspector/issues/610} for context on this requirement
+ */
+import { SetLevelRequestSchema } from "@modelcontextprotocol/sdk/types.js";
+import { logger } from "../../utils/internal/logger.js";
+import { requestContextService } from "../../utils/index.js";
+/**
+ * Registers the `logging/setLevel` request handler with the MCP server.
+ *
+ * This handler allows MCP clients to dynamically adjust the server's minimum
+ * log level. When a client sends a `logging/setLevel` request, the server will:
+ * 1. Validate the requested level (via Zod schema)
+ * 2. Update the internal logger's minimum level
+ * 3. Return an empty result to acknowledge the change
+ *
+ * Per the MCP specification, the server must respond with an empty result
+ * object upon successful configuration.
+ *
+ * Supported log levels (per RFC 5424 syslog severity):
+ * - debug, info, notice, warning, error, critical, alert, emergency
+ *
+ * @param server - The McpServer instance to attach the handler to
+ *
+ * @example
+ * ```typescript
+ * const server = new McpServer({ name: "my-server", version: "1.0.0" });
+ * registerLoggingSetLevelHandler(server);
+ * await server.connect(transport);
+ * ```
+ */
+export function registerLoggingSetLevelHandler(server) {
+    const context = requestContextService.createRequestContext({
+        operation: "registerLoggingSetLevelHandler",
+    });
+    logger.debug(context, "Registering logging/setLevel request handler");
+    server.server.setRequestHandler(SetLevelRequestSchema, async (request) => {
+        const { level } = request.params;
+        const handlerContext = requestContextService.createRequestContext({
+            operation: "logging/setLevel",
+            previousLevel: logger.pino.level,
+            requestedLevel: level,
+        });
+        try {
+            // Map MCP log level to our internal logger
+            // The logger.setLevel method handles validation and mapping to Pino levels
+            logger.setLevel(level);
+            logger.info({
+                ...handlerContext,
+                previousLevel: handlerContext.previousLevel,
+                newLevel: level,
+            }, `Log level changed via MCP request`);
+            // Per MCP spec: "The server responds with an empty result,
+            // confirming the logging level has been set."
+            return {
+                _meta: {},
+            };
+        }
+        catch (error) {
+            // Log the error but still return a valid response
+            // The schema validation should catch invalid levels before we get here
+            logger.error({
+                ...handlerContext,
+                error: error instanceof Error ? error.message : String(error),
+                requestedLevel: level,
+            }, "Failed to set log level");
+            // Still return success - the logger will log the validation error
+            // This prevents clients from seeing failures for our internal issues
+            return {
+                _meta: {},
+            };
+        }
+    });
+    logger.debug(context, "logging/setLevel handler registered successfully");
+}
+//# sourceMappingURL=setLevelHandler.js.map

package/dist/mcp-server/logging/setLevelHandler.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"setLevelHandler.js","sourceRoot":"","sources":["../../../src/mcp-server/logging/setLevelHandler.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAGH,OAAO,EAAE,qBAAqB,EAAE,MAAM,oCAAoC,CAAC;AAC3E,OAAO,EAAE,MAAM,EAAE,MAAM,4BAA4B,CAAC;AAEpD,OAAO,EAAE,qBAAqB,EAAE,MAAM,kBAAkB,CAAC;AAEzD;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,MAAM,UAAU,8BAA8B,CAAC,MAAiB;IAC9D,MAAM,OAAO,GAAG,qBAAqB,CAAC,oBAAoB,CAAC;QACzD,SAAS,EAAE,gCAAgC;KAC5C,CAAC,CAAC;IAEH,MAAM,CAAC,KAAK,CAAC,OAAO,EAAE,8CAA8C,CAAC,CAAC;IAEtE,MAAM,CAAC,MAAM,CAAC,iBAAiB,CAAC,qBAAqB,EAAE,KAAK,EAAE,OAAO,EAAE,EAAE;QACvE,MAAM,EAAE,KAAK,EAAE,GAAG,OAAO,CAAC,MAAM,CAAC;QAEjC,MAAM,cAAc,GAAG,qBAAqB,CAAC,oBAAoB,CAAC;YAChE,SAAS,EAAE,kBAAkB;YAC7B,aAAa,EAAE,MAAM,CAAC,IAAI,CAAC,KAAK;YAChC,cAAc,EAAE,KAAK;SACtB,CAAC,CAAC;QAEH,IAAI,CAAC;YACH,2CAA2C;YAC3C,2EAA2E;YAC3E,MAAM,CAAC,QAAQ,CAAC,KAAoB,CAAC,CAAC;YAEtC,MAAM,CAAC,IAAI,CACT;gBACE,GAAG,cAAc;gBACjB,aAAa,EAAE,cAAc,CAAC,aAAa;gBAC3C,QAAQ,EAAE,KAAK;aAChB,EACD,mCAAmC,CACpC,CAAC;YAEF,2DAA2D;YAC3D,8CAA8C;YAC9C,OAAO;gBACL,KAAK,EAAE,EAAE;aACV,CAAC;QACJ,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,kDAAkD;YAClD,uEAAuE;YACvE,MAAM,CAAC,KAAK,CACV;gBACE,GAAG,cAAc;gBACjB,KAAK,EAAE,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC;gBAC7D,cAAc,EAAE,KAAK;aACtB,EACD,yBAAyB,CAC1B,CAAC;YAEF,kEAAkE;YAClE,qEAAqE;YACrE,OAAO;gBACL,KAAK,EAAE,EAAE;aACV,CAAC;QACJ,CAAC;IACH,CAAC,CAAC,CAAC;IAEH,MAAM,CAAC,KAAK,CAAC,OAAO,EAAE,kDAAkD,CAAC,CAAC;AAC5E,CAAC"}

package/dist/mcp-server/resources/echoResource/index.d.ts

@@ -0,0 +1,14 @@
+/**
+ * @fileoverview Barrel file for the `echo` resource.
+ * This file serves as the public interface for the echo resource module,
+ * primarily exporting the `registerEchoResource` function. This function is
+ * responsible for registering the echo resource, including its templates and handler,
+ * with an MCP server instance. This makes the resource accessible to clients
+ * via defined URI patterns.
+ *
+ * Consuming modules should import from this barrel file to access
+ * the echo resource's registration capabilities.
+ * @module src/mcp-server/resources/echoResource/index
+ */
+export { registerEchoResource } from "./registration.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/mcp-server/resources/echoResource/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/mcp-server/resources/echoResource/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,OAAO,EAAE,oBAAoB,EAAE,MAAM,mBAAmB,CAAC"}

package/dist/mcp-server/resources/echoResource/index.js

@@ -0,0 +1,14 @@
+/**
+ * @fileoverview Barrel file for the `echo` resource.
+ * This file serves as the public interface for the echo resource module,
+ * primarily exporting the `registerEchoResource` function. This function is
+ * responsible for registering the echo resource, including its templates and handler,
+ * with an MCP server instance. This makes the resource accessible to clients
+ * via defined URI patterns.
+ *
+ * Consuming modules should import from this barrel file to access
+ * the echo resource's registration capabilities.
+ * @module src/mcp-server/resources/echoResource/index
+ */
+export { registerEchoResource } from "./registration.js";
+//# sourceMappingURL=index.js.map

package/dist/mcp-server/resources/echoResource/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/mcp-server/resources/echoResource/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,OAAO,EAAE,oBAAoB,EAAE,MAAM,mBAAmB,CAAC"}

package/dist/mcp-server/resources/echoResource/logic.d.ts

@@ -0,0 +1,37 @@
+/**
+ * @fileoverview Defines the core logic, schemas, and types for the `echo` resource.
+ * @module src/mcp-server/resources/echoResource/logic
+ **/
+import { z } from "zod";
+import { type RequestContext } from "../../../utils/index.js";
+/**
+ * Zod schema defining expected query parameters for the echo resource.
+ */
+export declare const EchoResourceQuerySchema: z.ZodObject<{
+    message: z.ZodOptional<z.ZodString>;
+}, "strip", z.ZodTypeAny, {
+    message?: string | undefined;
+}, {
+    message?: string | undefined;
+}>;
+/**
+ * TypeScript type inferred from the {@link EchoResourceQuerySchema}.
+ */
+export type EchoResourceParams = z.infer<typeof EchoResourceQuerySchema>;
+/**
+ * Defines the structure of the JSON payload returned by the `processEchoResource` function.
+ */
+export interface EchoResourceResponsePayload {
+    message: string;
+    timestamp: string;
+    requestUri: string;
+}
+/**
+ * Processes the core logic for an echo resource request.
+ * @param uri - The full URL object of the incoming resource request.
+ * @param params - The validated query parameters for the request.
+ * @param context - The request context, used for logging and tracing the operation.
+ * @returns The data payload for the response.
+ */
+export declare function echoResourceLogic(uri: URL, params: EchoResourceParams, context: RequestContext): Promise<EchoResourceResponsePayload>;
+//# sourceMappingURL=logic.d.ts.map

package/dist/mcp-server/resources/echoResource/logic.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"logic.d.ts","sourceRoot":"","sources":["../../../../src/mcp-server/resources/echoResource/logic.ts"],"names":[],"mappings":"AAAA;;;IAGI;AAEJ,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAU,KAAK,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAE/D;;GAEG;AACH,eAAO,MAAM,uBAAuB;;;;;;EAOlC,CAAC;AAEH;;GAEG;AACH,MAAM,MAAM,kBAAkB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,uBAAuB,CAAC,CAAC;AAEzE;;GAEG;AACH,MAAM,WAAW,2BAA2B;IAC1C,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE,MAAM,CAAC;IAClB,UAAU,EAAE,MAAM,CAAC;CACpB;AAED;;;;;;GAMG;AACH,wBAAsB,iBAAiB,CACrC,GAAG,EAAE,GAAG,EACR,MAAM,EAAE,kBAAkB,EAC1B,OAAO,EAAE,cAAc,GACtB,OAAO,CAAC,2BAA2B,CAAC,CAiCtC"}

package/dist/mcp-server/resources/echoResource/logic.js

@@ -0,0 +1,46 @@
+/**
+ * @fileoverview Defines the core logic, schemas, and types for the `echo` resource.
+ * @module src/mcp-server/resources/echoResource/logic
+ **/
+import { z } from "zod";
+import { logger } from "../../../utils/index.js";
+/**
+ * Zod schema defining expected query parameters for the echo resource.
+ */
+export const EchoResourceQuerySchema = z.object({
+    message: z
+        .string()
+        .optional()
+        .describe("Optional message to echo back in the response. If not provided, a default may be used or derived from the path."),
+});
+/**
+ * Processes the core logic for an echo resource request.
+ * @param uri - The full URL object of the incoming resource request.
+ * @param params - The validated query parameters for the request.
+ * @param context - The request context, used for logging and tracing the operation.
+ * @returns The data payload for the response.
+ */
+export async function echoResourceLogic(uri, params, context) {
+    // The message can come from a query parameter or the path itself.
+    // For a URI like `echo://my-message?param=1`, `hostname` is `my-message`.
+    const messageFromPath = uri.hostname || uri.pathname.replace(/^\/+/g, "");
+    const messageToEcho = params.message || messageFromPath || "Default echo message";
+    logger.debug({
+        ...context,
+        resourceUri: uri.href,
+        extractedMessage: messageToEcho,
+    }, "Processing echo resource logic.");
+    const responsePayload = {
+        message: messageToEcho,
+        timestamp: new Date().toISOString(),
+        requestUri: uri.href,
+    };
+    logger.debug({
+        ...context,
+        responsePayloadSummary: {
+            messageLength: responsePayload.message.length,
+        },
+    }, "Echo resource processed successfully.");
+    return responsePayload;
+}
+//# sourceMappingURL=logic.js.map

package/dist/mcp-server/resources/echoResource/logic.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"logic.js","sourceRoot":"","sources":["../../../../src/mcp-server/resources/echoResource/logic.ts"],"names":[],"mappings":"AAAA;;;IAGI;AAEJ,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,MAAM,EAAuB,MAAM,kBAAkB,CAAC;AAE/D;;GAEG;AACH,MAAM,CAAC,MAAM,uBAAuB,GAAG,CAAC,CAAC,MAAM,CAAC;IAC9C,OAAO,EAAE,CAAC;SACP,MAAM,EAAE;SACR,QAAQ,EAAE;SACV,QAAQ,CACP,iHAAiH,CAClH;CACJ,CAAC,CAAC;AAgBH;;;;;;GAMG;AACH,MAAM,CAAC,KAAK,UAAU,iBAAiB,CACrC,GAAQ,EACR,MAA0B,EAC1B,OAAuB;IAEvB,kEAAkE;IAClE,0EAA0E;IAC1E,MAAM,eAAe,GAAG,GAAG,CAAC,QAAQ,IAAI,GAAG,CAAC,QAAQ,CAAC,OAAO,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC;IAC1E,MAAM,aAAa,GACjB,MAAM,CAAC,OAAO,IAAI,eAAe,IAAI,sBAAsB,CAAC;IAE9D,MAAM,CAAC,KAAK,CACV;QACE,GAAG,OAAO;QACV,WAAW,EAAE,GAAG,CAAC,IAAI;QACrB,gBAAgB,EAAE,aAAa;KAChC,EACD,iCAAiC,CAClC,CAAC;IAEF,MAAM,eAAe,GAAgC;QACnD,OAAO,EAAE,aAAa;QACtB,SAAS,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;QACnC,UAAU,EAAE,GAAG,CAAC,IAAI;KACrB,CAAC;IAEF,MAAM,CAAC,KAAK,CACV;QACE,GAAG,OAAO;QACV,sBAAsB,EAAE;YACtB,aAAa,EAAE,eAAe,CAAC,OAAO,CAAC,MAAM;SAC9C;KACF,EACD,uCAAuC,CACxC,CAAC;IAEF,OAAO,eAAe,CAAC;AACzB,CAAC"}

package/dist/mcp-server/resources/echoResource/registration.d.ts

@@ -0,0 +1,7 @@
+/**
+ * @fileoverview Handles the registration of the `echo` resource with an MCP server instance.
+ * @module src/mcp-server/resources/echoResource/registration.ts
+ **/
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+export declare const registerEchoResource: (server: McpServer) => Promise<void>;
+//# sourceMappingURL=registration.d.ts.map

package/dist/mcp-server/resources/echoResource/registration.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"registration.d.ts","sourceRoot":"","sources":["../../../../src/mcp-server/resources/echoResource/registration.ts"],"names":[],"mappings":"AAAA;;;IAGI;AAEJ,OAAO,EACL,SAAS,EAEV,MAAM,yCAAyC,CAAC;AA+BjD,eAAO,MAAM,oBAAoB,GAC/B,QAAQ,SAAS,KAChB,OAAO,CAAC,IAAI,CAoDd,CAAC"}

package/dist/mcp-server/resources/echoResource/registration.js

@@ -0,0 +1,51 @@
+/**
+ * @fileoverview Handles the registration of the `echo` resource with an MCP server instance.
+ * @module src/mcp-server/resources/echoResource/registration.ts
+ **/
+import { ResourceTemplate, } from "@modelcontextprotocol/sdk/server/mcp.js";
+import { JsonRpcErrorCode } from "../../../types-global/errors.js";
+import { ErrorHandler, requestContextService, } from "../../../utils/index.js";
+import { logOperationStart, logOperationSuccess, } from "../../../utils/internal/logging-helpers.js";
+import { createResourceHandler, } from "../../resources/utils/resource-utils.js";
+import { echoResourceLogic } from "./logic.js";
+const RESOURCE_NAME = "echo-resource";
+const responseFormatter = (result, uri) => ({
+    contents: [
+        {
+            uri: uri.href,
+            mimeType: "application/json",
+            text: JSON.stringify(result),
+        },
+    ],
+});
+export const registerEchoResource = async (server) => {
+    const registrationContext = requestContextService.createRequestContext({
+        operation: "RegisterResource",
+        resourceName: RESOURCE_NAME,
+    });
+    logOperationStart(registrationContext, `Registering resource: '${RESOURCE_NAME}'`);
+    await ErrorHandler.tryCatch(async () => {
+        const template = new ResourceTemplate("echo://{message}", {
+            list: async () => ({
+                resources: [
+                    {
+                        uri: "echo://hello",
+                        name: "Default Echo Message",
+                        description: "A simple echo resource example.",
+                    },
+                ],
+            }),
+        });
+        server.registerResource(RESOURCE_NAME, template, {
+            description: "A simple echo resource that returns a message.",
+            mimeType: "application/json",
+        }, createResourceHandler(RESOURCE_NAME, echoResourceLogic, responseFormatter));
+        logOperationSuccess(registrationContext, `Resource '${RESOURCE_NAME}' registered successfully.`);
+    }, {
+        operation: `RegisteringResource_${RESOURCE_NAME}`,
+        context: registrationContext,
+        errorCode: JsonRpcErrorCode.InitializationFailed,
+        critical: true,
+    });
+};
+//# sourceMappingURL=registration.js.map

package/dist/mcp-server/resources/echoResource/registration.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"registration.js","sourceRoot":"","sources":["../../../../src/mcp-server/resources/echoResource/registration.ts"],"names":[],"mappings":"AAAA;;;IAGI;AAEJ,OAAO,EAEL,gBAAgB,GACjB,MAAM,yCAAyC,CAAC;AACjD,OAAO,EAAE,gBAAgB,EAAE,MAAM,0BAA0B,CAAC;AAC5D,OAAO,EACL,YAAY,EAEZ,qBAAqB,GACtB,MAAM,kBAAkB,CAAC;AAC1B,OAAO,EACL,iBAAiB,EACjB,mBAAmB,GACpB,MAAM,qCAAqC,CAAC;AAC7C,OAAO,EACL,qBAAqB,GAEtB,MAAM,gDAAgD,CAAC;AACxD,OAAO,EAAE,iBAAiB,EAA+B,MAAM,YAAY,CAAC;AAE5E,MAAM,aAAa,GAAG,eAAe,CAAC;AAEtC,MAAM,iBAAiB,GAEnB,CAAC,MAAM,EAAE,GAAG,EAAE,EAAE,CAAC,CAAC;IACpB,QAAQ,EAAE;QACR;YACE,GAAG,EAAE,GAAG,CAAC,IAAI;YACb,QAAQ,EAAE,kBAAkB;YAC5B,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC;SAC7B;KACF;CACF,CAAC,CAAC;AAEH,MAAM,CAAC,MAAM,oBAAoB,GAAG,KAAK,EACvC,MAAiB,EACF,EAAE;IACjB,MAAM,mBAAmB,GACvB,qBAAqB,CAAC,oBAAoB,CAAC;QACzC,SAAS,EAAE,kBAAkB;QAC7B,YAAY,EAAE,aAAa;KAC5B,CAAC,CAAC;IAEL,iBAAiB,CACf,mBAAmB,EACnB,0BAA0B,aAAa,GAAG,CAC3C,CAAC;IAEF,MAAM,YAAY,CAAC,QAAQ,CACzB,KAAK,IAAI,EAAE;QACT,MAAM,QAAQ,GAAG,IAAI,gBAAgB,CAAC,kBAAkB,EAAE;YACxD,IAAI,EAAE,KAAK,IAAI,EAAE,CAAC,CAAC;gBACjB,SAAS,EAAE;oBACT;wBACE,GAAG,EAAE,cAAc;wBACnB,IAAI,EAAE,sBAAsB;wBAC5B,WAAW,EAAE,iCAAiC;qBAC/C;iBACF;aACF,CAAC;SACH,CAAC,CAAC;QAEH,MAAM,CAAC,gBAAgB,CACrB,aAAa,EACb,QAAQ,EACR;YACE,WAAW,EAAE,gDAAgD;YAC7D,QAAQ,EAAE,kBAAkB;SAC7B,EACD,qBAAqB,CACnB,aAAa,EACb,iBAAiB,EACjB,iBAAiB,CAClB,CACF,CAAC;QAEF,mBAAmB,CACjB,mBAAmB,EACnB,aAAa,aAAa,4BAA4B,CACvD,CAAC;IACJ,CAAC,EACD;QACE,SAAS,EAAE,uBAAuB,aAAa,EAAE;QACjD,OAAO,EAAE,mBAAmB;QAC5B,SAAS,EAAE,gBAAgB,CAAC,oBAAoB;QAChD,QAAQ,EAAE,IAAI;KACf,CACF,CAAC;AACJ,CAAC,CAAC"}

package/dist/mcp-server/resources/index.d.ts

@@ -0,0 +1,10 @@
+/**
+ * @fileoverview Centralized registration for all available MCP resources.
+ * This module imports all resource registration functions and exports a single
+ * function to register them all with the MCP server, simplifying server setup.
+ * @module src/mcp-server/resources/index
+ */
+import type { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+/** Registers all available resources with the MCP server. */
+export declare const registerAllResources: (server: McpServer) => Promise<void>;
+//# sourceMappingURL=index.d.ts.map

package/dist/mcp-server/resources/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/mcp-server/resources/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAQzE,6DAA6D;AAC7D,eAAO,MAAM,oBAAoB,GAC/B,QAAQ,SAAS,KAChB,OAAO,CAAC,IAAI,CAYd,CAAC"}

package/dist/mcp-server/resources/index.js

@@ -0,0 +1,19 @@
+/**
+ * @fileoverview Centralized registration for all available MCP resources.
+ * This module imports all resource registration functions and exports a single
+ * function to register them all with the MCP server, simplifying server setup.
+ * @module src/mcp-server/resources/index
+ */
+import { requestContextService } from "../../utils/index.js";
+import { logOperationStart, logOperationSuccess, } from "../../utils/internal/logging-helpers.js";
+import { registerToolsetsResource } from "../../ibmi-mcp-server/resources/toolsetsResource/index.js";
+/** Registers all available resources with the MCP server. */
+export const registerAllResources = async (server) => {
+    const context = requestContextService.createRequestContext({
+        operation: "registerAllResources",
+    });
+    logOperationStart(context, "Starting registration of all resources...");
+    await Promise.all([registerToolsetsResource(server)]);
+    logOperationSuccess(context, "All resources have been registered successfully.");
+};
+//# sourceMappingURL=index.js.map

package/dist/mcp-server/resources/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/mcp-server/resources/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAGH,OAAO,EAAE,qBAAqB,EAAE,MAAM,kBAAkB,CAAC;AACzD,OAAO,EACL,iBAAiB,EACjB,mBAAmB,GACpB,MAAM,qCAAqC,CAAC;AAC7C,OAAO,EAAE,wBAAwB,EAAE,MAAM,uDAAuD,CAAC;AAEjG,6DAA6D;AAC7D,MAAM,CAAC,MAAM,oBAAoB,GAAG,KAAK,EACvC,MAAiB,EACF,EAAE;IACjB,MAAM,OAAO,GAAG,qBAAqB,CAAC,oBAAoB,CAAC;QACzD,SAAS,EAAE,sBAAsB;KAClC,CAAC,CAAC;IACH,iBAAiB,CAAC,OAAO,EAAE,2CAA2C,CAAC,CAAC;IAExE,MAAM,OAAO,CAAC,GAAG,CAAC,CAAC,wBAAwB,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC;IAEtD,mBAAmB,CACjB,OAAO,EACP,kDAAkD,CACnD,CAAC;AACJ,CAAC,CAAC"}

package/dist/mcp-server/resources/utils/resource-utils.d.ts

@@ -0,0 +1,43 @@
+/**
+ * @fileoverview Provides a generic factory for creating MCP resource handlers.
+ * This utility centralizes common logic for context creation, performance measurement,
+ * error handling, and response formatting, reducing boilerplate in individual
+ * resource registration files.
+ * @module src/mcp-server/resources/utils/resource-utils
+ */
+import { ReadResourceResult } from "@modelcontextprotocol/sdk/types.js";
+import { RequestContext } from "../../../utils/index.js";
+/**
+ * Defines the function signature for a core resource logic implementation.
+ * @template TParams The type of the validated query parameters.
+ * @template TPayload The type of the successful output payload from the logic.
+ * @param uri The full URL object of the incoming resource request.
+ * @param params The validated query parameters for the request.
+ * @param context The request context for logging and tracing.
+ * @returns A promise that resolves with the resource's data payload.
+ */
+type ResourceLogicFn<TParams, TPayload> = (uri: URL, params: TParams, context: RequestContext) => Promise<TPayload>;
+/**
+ * Defines the function signature for formatting a successful resource logic result
+ * into the final structure expected by the MCP server.
+ * @template TPayload The type of the successful output from the logic.
+ * @param result The successful output from the resource's logic function.
+ * @param uri The original request URI.
+ * @returns The formatted resource response.
+ */
+export type ResourceResponseFormatter<TPayload> = (result: TPayload, uri: URL) => ReadResourceResult;
+/**
+ * Creates a standardized MCP resource handler.
+ * This factory wraps the core business logic with context creation, performance
+ * monitoring, and centralized error handling.
+ *
+ * @template TParams The type of the validated query parameters.
+ * @template TPayload The type of the successful output from the logic.
+ * @param resourceName The name of the resource, used for logging and metrics.
+ * @param logicFn The core business logic function for the resource.
+ * @param responseFormatter A function to format the successful output.
+ * @returns A complete MCP resource handler function.
+ */
+export declare function createResourceHandler<TParams, TPayload>(resourceName: string, logicFn: ResourceLogicFn<TParams, TPayload>, responseFormatter: ResourceResponseFormatter<TPayload>): (uri: URL, params: TParams, callContext: Record<string, unknown>) => Promise<ReadResourceResult>;
+export {};
+//# sourceMappingURL=resource-utils.d.ts.map

package/dist/mcp-server/resources/utils/resource-utils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"resource-utils.d.ts","sourceRoot":"","sources":["../../../../src/mcp-server/resources/utils/resource-utils.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EAAE,kBAAkB,EAAE,MAAM,oCAAoC,CAAC;AACxE,OAAO,EAIL,cAAc,EACf,MAAM,yBAAyB,CAAC;AAEjC;;;;;;;;GAQG;AACH,KAAK,eAAe,CAAC,OAAO,EAAE,QAAQ,IAAI,CACxC,GAAG,EAAE,GAAG,EACR,MAAM,EAAE,OAAO,EACf,OAAO,EAAE,cAAc,KACpB,OAAO,CAAC,QAAQ,CAAC,CAAC;AAEvB;;;;;;;GAOG;AACH,MAAM,MAAM,yBAAyB,CAAC,QAAQ,IAAI,CAChD,MAAM,EAAE,QAAQ,EAChB,GAAG,EAAE,GAAG,KACL,kBAAkB,CAAC;AAExB;;;;;;;;;;;GAWG;AACH,wBAAgB,qBAAqB,CAAC,OAAO,EAAE,QAAQ,EACrD,YAAY,EAAE,MAAM,EACpB,OAAO,EAAE,eAAe,CAAC,OAAO,EAAE,QAAQ,CAAC,EAC3C,iBAAiB,EAAE,yBAAyB,CAAC,QAAQ,CAAC,IAGpD,KAAK,GAAG,EACR,QAAQ,OAAO,EACf,aAAa,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KACnC,OAAO,CAAC,kBAAkB,CAAC,CAyB/B"}

package/dist/mcp-server/resources/utils/resource-utils.js

@@ -0,0 +1,44 @@
+/**
+ * @fileoverview Provides a generic factory for creating MCP resource handlers.
+ * This utility centralizes common logic for context creation, performance measurement,
+ * error handling, and response formatting, reducing boilerplate in individual
+ * resource registration files.
+ * @module src/mcp-server/resources/utils/resource-utils
+ */
+import { ErrorHandler, measureToolExecution, requestContextService, } from "../../../utils/index.js";
+/**
+ * Creates a standardized MCP resource handler.
+ * This factory wraps the core business logic with context creation, performance
+ * monitoring, and centralized error handling.
+ *
+ * @template TParams The type of the validated query parameters.
+ * @template TPayload The type of the successful output from the logic.
+ * @param resourceName The name of the resource, used for logging and metrics.
+ * @param logicFn The core business logic function for the resource.
+ * @param responseFormatter A function to format the successful output.
+ * @returns A complete MCP resource handler function.
+ */
+export function createResourceHandler(resourceName, logicFn, responseFormatter) {
+    return async (uri, params, callContext) => {
+        const handlerContext = requestContextService.createRequestContext({
+            parentContext: callContext,
+            operation: "HandleResourceRead",
+            resourceUri: uri.href,
+            inputParams: params,
+        });
+        try {
+            // Wrap the logic call with performance measurement
+            const result = await measureToolExecution(`resource:${resourceName}`, () => logicFn(uri, params, handlerContext), params);
+            return responseFormatter(result, uri);
+        }
+        catch (error) {
+            // Re-throw to be caught by the SDK's top-level error handler
+            throw ErrorHandler.handleError(error, {
+                operation: `resource:${resourceName}`,
+                context: handlerContext,
+                input: { uri: uri.href, params },
+            });
+        }
+    };
+}
+//# sourceMappingURL=resource-utils.js.map

package/dist/mcp-server/resources/utils/resource-utils.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"resource-utils.js","sourceRoot":"","sources":["../../../../src/mcp-server/resources/utils/resource-utils.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAGH,OAAO,EACL,YAAY,EACZ,oBAAoB,EACpB,qBAAqB,GAEtB,MAAM,yBAAyB,CAAC;AA8BjC;;;;;;;;;;;GAWG;AACH,MAAM,UAAU,qBAAqB,CACnC,YAAoB,EACpB,OAA2C,EAC3C,iBAAsD;IAEtD,OAAO,KAAK,EACV,GAAQ,EACR,MAAe,EACf,WAAoC,EACP,EAAE;QAC/B,MAAM,cAAc,GAAG,qBAAqB,CAAC,oBAAoB,CAAC;YAChE,aAAa,EAAE,WAAW;YAC1B,SAAS,EAAE,oBAAoB;YAC/B,WAAW,EAAE,GAAG,CAAC,IAAI;YACrB,WAAW,EAAE,MAAM;SACpB,CAAC,CAAC;QAEH,IAAI,CAAC;YACH,mDAAmD;YACnD,MAAM,MAAM,GAAG,MAAM,oBAAoB,CACvC,YAAY,YAAY,EAAE,EAC1B,GAAG,EAAE,CAAC,OAAO,CAAC,GAAG,EAAE,MAAM,EAAE,cAAc,CAAC,EAC1C,MAAM,CACP,CAAC;YACF,OAAO,iBAAiB,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;QACxC,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,6DAA6D;YAC7D,MAAM,YAAY,CAAC,WAAW,CAAC,KAAK,EAAE;gBACpC,SAAS,EAAE,YAAY,YAAY,EAAE;gBACrC,OAAO,EAAE,cAAc;gBACvB,KAAK,EAAE,EAAE,GAAG,EAAE,GAAG,CAAC,IAAI,EAAE,MAAM,EAAE;aACjC,CAAC,CAAC;QACL,CAAC;IACH,CAAC,CAAC;AACJ,CAAC"}

package/dist/mcp-server/server.d.ts

@@ -0,0 +1,23 @@
+/**
+ * @fileoverview Main entry point for the MCP (Model Context Protocol) server.
+ * This file orchestrates the server's lifecycle:
+ * 1. Initializes the core `McpServer` instance (from `@modelcontextprotocol/sdk`) with its identity and capabilities.
+ * 2. Registers available resources and tools, making them discoverable and usable by clients.
+ * 3. Selects and starts the appropriate communication transport (stdio or Streamable HTTP)
+ *    based on configuration.
+ * 4. Handles top-level error management during startup.
+ *
+ * MCP Specification References:
+ * - Lifecycle: https://github.com/modelcontextprotocol/modelcontextprotocol/blob/main/docs/specification/2025-03-26/basic/lifecycle.mdx
+ * - Overview (Capabilities): https://github.com/modelcontextprotocol/modelcontextprotocol/blob/main/docs/specification/2025-03-26/basic/index.mdx
+ * - Transports: https://github.com/modelcontextprotocol/modelcontextprotocol/blob/main/docs/specification/2025-03-26/basic/transports.mdx
+ * @module src/mcp-server/server
+ */
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import http from "http";
+/**
+ * Main application entry point. Initializes and starts the MCP server.
+ *
+ */
+export declare function initializeAndStartServer(): Promise<McpServer | http.Server>;
+//# sourceMappingURL=server.d.ts.map

package/dist/mcp-server/server.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"server.d.ts","sourceRoot":"","sources":["../../src/mcp-server/server.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAEH,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AACpE,OAAO,IAAI,MAAM,MAAM,CAAC;AAoGxB;;;GAGG;AACH,wBAAsB,wBAAwB,IAAI,OAAO,CACvD,SAAS,GAAG,IAAI,CAAC,MAAM,CACxB,CAsBA"}