@ibm/ibmi-mcp-server 0.1.0

package/dist/ibmi-mcp-server/tools/executeSql/logic.js.map

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

package/dist/ibmi-mcp-server/tools/executeSql/registration.d.ts

@@ -0,0 +1,52 @@
+/**
+ * @fileoverview Handles registration and error handling for the `execute_sql` tool.
+ * This module acts as the "handler" layer, connecting the pure business logic to the
+ * MCP server and ensuring all outcomes (success or failure) are handled gracefully.
+ * @module src/mcp-server/tools/executeSql/registration
+ * @see {@link src/mcp-server/tools/executeSql/logic.ts} for the core business logic and schemas.
+ */
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+/**
+ * Configuration interface for the execute SQL tool
+ * This allows the tool to be enabled/disabled and configured via YAML
+ */
+export interface ExecuteSqlToolConfig {
+    /** Whether the tool is enabled */
+    enabled: boolean;
+    /** Tool description override */
+    description?: string;
+    /** Security configuration */
+    security?: {
+        /** Whether to enforce read-only mode (default: true) */
+        readOnly?: boolean;
+        /** Maximum query length (default: 10000) */
+        maxQueryLength?: number;
+        /** Additional forbidden keywords */
+        forbiddenKeywords?: string[];
+    };
+}
+/**
+ * Set the configuration for the execute SQL tool
+ * This is called by the YAML configuration system
+ * @param config - Tool configuration
+ */
+export declare function setExecuteSqlConfig(config: Partial<ExecuteSqlToolConfig>): void;
+/**
+ * Get the current configuration for the execute SQL tool
+ * @returns Current tool configuration
+ */
+export declare function getExecuteSqlConfig(): ExecuteSqlToolConfig;
+/**
+ * Check if the execute SQL tool is enabled
+ * @returns True if the tool is enabled
+ */
+export declare function isExecuteSqlEnabled(): boolean;
+/**
+ * Registers the 'execute_sql' tool and its handler with the provided MCP server instance.
+ * This function uses ErrorHandler.tryCatch to ensure that any failure during the
+ * registration process itself is caught and logged, preventing server startup failures.
+ *
+ * @param server - The MCP server instance to register the tool with.
+ */
+export declare const registerExecuteSqlTool: (server: McpServer) => Promise<void>;
+//# sourceMappingURL=registration.d.ts.map

package/dist/ibmi-mcp-server/tools/executeSql/registration.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"registration.d.ts","sourceRoot":"","sources":["../../../../src/ibmi-mcp-server/tools/executeSql/registration.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAmCpE;;;GAGG;AACH,MAAM,WAAW,oBAAoB;IACnC,kCAAkC;IAClC,OAAO,EAAE,OAAO,CAAC;IACjB,gCAAgC;IAChC,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,6BAA6B;IAC7B,QAAQ,CAAC,EAAE;QACT,wDAAwD;QACxD,QAAQ,CAAC,EAAE,OAAO,CAAC;QACnB,4CAA4C;QAC5C,cAAc,CAAC,EAAE,MAAM,CAAC;QACxB,oCAAoC;QACpC,iBAAiB,CAAC,EAAE,MAAM,EAAE,CAAC;KAC9B,CAAC;CACH;AAmBD;;;;GAIG;AACH,wBAAgB,mBAAmB,CACjC,MAAM,EAAE,OAAO,CAAC,oBAAoB,CAAC,GACpC,IAAI,CAoBN;AAED;;;GAGG;AACH,wBAAgB,mBAAmB,IAAI,oBAAoB,CAE1D;AAED;;;GAGG;AACH,wBAAgB,mBAAmB,IAAI,OAAO,CAE7C;AAED;;;;;;GAMG;AACH,eAAO,MAAM,sBAAsB,GACjC,QAAQ,SAAS,KAChB,OAAO,CAAC,IAAI,CAmGd,CAAC"}

package/dist/ibmi-mcp-server/tools/executeSql/registration.js

@@ -0,0 +1,161 @@
+/**
+ * @fileoverview Handles registration and error handling for the `execute_sql` tool.
+ * This module acts as the "handler" layer, connecting the pure business logic to the
+ * MCP server and ensuring all outcomes (success or failure) are handled gracefully.
+ * @module src/mcp-server/tools/executeSql/registration
+ * @see {@link src/mcp-server/tools/executeSql/logic.ts} for the core business logic and schemas.
+ */
+import { JsonRpcErrorCode } from "../../../types-global/errors.js";
+import { ErrorHandler, requestContextService } from "../../../utils/index.js";
+import { logOperationStart, logOperationSuccess, } from "../../../utils/internal/logging-helpers.js";
+import { measureToolExecution } from "../../../utils/internal/performance.js";
+import { getRequestContext } from "../../../utils/internal/asyncContext.js";
+import { ExecuteSqlInputSchema, executeSqlLogic, ExecuteSqlResponseSchema, } from "./logic.js";
+// The unique name for the tool, used for registration and identification.
+const TOOL_NAME = "execute_sql";
+// A concise description for the LLM. More detailed guidance should be in the
+// parameter descriptions within the Zod schema in `logic.ts`.
+const TOOL_DESCRIPTION = `Execute SQL statements against the IBM i database. Only SELECT and read-only operations are allowed for security.`;
+const responseFormatter = (result) => ({
+    structuredContent: result,
+    content: [
+        {
+            type: "text",
+            text: `SQL Query executed successfully. Returned ${result.rowCount} rows.\n\n${JSON.stringify(result.data, null, 2)}`,
+        },
+    ],
+});
+/**
+ * Default configuration for the execute SQL tool
+ */
+const DEFAULT_CONFIG = {
+    enabled: true,
+    security: {
+        readOnly: true,
+        maxQueryLength: 10000,
+        forbiddenKeywords: [],
+    },
+};
+/**
+ * Internal configuration storage
+ */
+let toolConfig = DEFAULT_CONFIG;
+/**
+ * Set the configuration for the execute SQL tool
+ * This is called by the YAML configuration system
+ * @param config - Tool configuration
+ */
+export function setExecuteSqlConfig(config) {
+    toolConfig = {
+        ...DEFAULT_CONFIG,
+        ...config,
+        security: {
+            ...DEFAULT_CONFIG.security,
+            ...config.security,
+        },
+    };
+    const context = requestContextService.createRequestContext({
+        operation: "ConfigUpdate",
+        toolName: TOOL_NAME,
+    });
+    logOperationSuccess(context, "Execute SQL tool configuration updated", {
+        enabled: toolConfig.enabled,
+        readOnly: toolConfig.security?.readOnly,
+        maxQueryLength: toolConfig.security?.maxQueryLength,
+    });
+}
+/**
+ * Get the current configuration for the execute SQL tool
+ * @returns Current tool configuration
+ */
+export function getExecuteSqlConfig() {
+    return toolConfig;
+}
+/**
+ * Check if the execute SQL tool is enabled
+ * @returns True if the tool is enabled
+ */
+export function isExecuteSqlEnabled() {
+    return toolConfig.enabled;
+}
+/**
+ * Registers the 'execute_sql' tool and its handler with the provided MCP server instance.
+ * This function uses ErrorHandler.tryCatch to ensure that any failure during the
+ * registration process itself is caught and logged, preventing server startup failures.
+ *
+ * @param server - The MCP server instance to register the tool with.
+ */
+export const registerExecuteSqlTool = async (server) => {
+    const registrationContext = requestContextService.createRequestContext({
+        operation: "RegisterTool",
+        toolName: TOOL_NAME,
+    });
+    logOperationStart(registrationContext, `Checking if tool should be registered: '${TOOL_NAME}'`, {
+        enabled: toolConfig.enabled,
+    });
+    // Only register if the tool is enabled
+    if (!toolConfig.enabled) {
+        logOperationSuccess(registrationContext, `Tool '${TOOL_NAME}' is disabled, skipping registration`);
+        return;
+    }
+    logOperationStart(registrationContext, `Registering tool: '${TOOL_NAME}'`);
+    await ErrorHandler.tryCatch(async () => {
+        const description = toolConfig.description || TOOL_DESCRIPTION;
+        server.registerTool(TOOL_NAME, {
+            title: "Execute SQL",
+            description,
+            inputSchema: ExecuteSqlInputSchema.shape,
+            outputSchema: ExecuteSqlResponseSchema.shape,
+            annotations: {
+                readOnlyHint: toolConfig.security?.readOnly, // Default to true for safety
+                destructiveHint: !(toolConfig.security?.readOnly ?? true), // Destructive if not read-only
+                openWorldHint: !(toolConfig.security?.readOnly ?? true), // Open world if not read-only
+            },
+            _meta: {
+                requiresAuth: true, // Requires database authentication
+            },
+        }, async (params, mcpContext) => {
+            try {
+                const result = await measureToolExecution(TOOL_NAME, () => executeSqlLogic(params), params);
+                return responseFormatter(result);
+            }
+            catch (error) {
+                const handlerContext = requestContextService.createRequestContext({
+                    parentContext: mcpContext,
+                    operation: `tool:${TOOL_NAME}`,
+                });
+                const handledError = ErrorHandler.handleError(error, {
+                    operation: `tool:${TOOL_NAME}`,
+                    context: getRequestContext() ?? handlerContext,
+                    input: params,
+                });
+                return {
+                    isError: true,
+                    content: [
+                        {
+                            type: "text",
+                            text: `SQL Error: ${handledError.message}`,
+                        },
+                    ],
+                    structuredContent: {
+                        // eslint-disable-next-line @typescript-eslint/no-explicit-any
+                        code: handledError.code,
+                        message: handledError.message,
+                        // eslint-disable-next-line @typescript-eslint/no-explicit-any
+                        details: handledError.details,
+                    },
+                };
+            }
+        });
+        logOperationSuccess(registrationContext, `Tool '${TOOL_NAME}' registered successfully.`, {
+            enabled: toolConfig.enabled,
+            readOnly: toolConfig.security?.readOnly,
+        });
+    }, {
+        operation: `RegisteringTool_${TOOL_NAME}`,
+        context: registrationContext,
+        errorCode: JsonRpcErrorCode.InitializationFailed,
+        critical: true, // A failure to register a tool is a critical startup error.
+    });
+};
+//# sourceMappingURL=registration.js.map

package/dist/ibmi-mcp-server/tools/executeSql/registration.js.map

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

package/dist/ibmi-mcp-server/tools/generateSql/index.d.ts

@@ -0,0 +1,13 @@
+/**
+ * @fileoverview Barrel file for the `generate_sql` tool.
+ * This file serves as the public interface for the generate SQL tool module,
+ * primarily exporting the `registerGenerateSqlTool` function. This function is
+ * responsible for registering the generate SQL tool with an MCP server instance,
+ * making it available for invocation by clients.
+ *
+ * Consuming modules should import from this barrel file to access
+ * the generate SQL tool's registration capabilities.
+ * @module src/mcp-server/tools/generateSql/index
+ */
+export { registerGenerateSqlTool } from "./registration.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/ibmi-mcp-server/tools/generateSql/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/ibmi-mcp-server/tools/generateSql/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,OAAO,EAAE,uBAAuB,EAAE,MAAM,mBAAmB,CAAC"}

package/dist/ibmi-mcp-server/tools/generateSql/index.js

@@ -0,0 +1,13 @@
+/**
+ * @fileoverview Barrel file for the `generate_sql` tool.
+ * This file serves as the public interface for the generate SQL tool module,
+ * primarily exporting the `registerGenerateSqlTool` function. This function is
+ * responsible for registering the generate SQL tool with an MCP server instance,
+ * making it available for invocation by clients.
+ *
+ * Consuming modules should import from this barrel file to access
+ * the generate SQL tool's registration capabilities.
+ * @module src/mcp-server/tools/generateSql/index
+ */
+export { registerGenerateSqlTool } from "./registration.js";
+//# sourceMappingURL=index.js.map

package/dist/ibmi-mcp-server/tools/generateSql/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/ibmi-mcp-server/tools/generateSql/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,OAAO,EAAE,uBAAuB,EAAE,MAAM,mBAAmB,CAAC"}

package/dist/ibmi-mcp-server/tools/generateSql/logic.d.ts

@@ -0,0 +1,64 @@
+/**
+ * @fileoverview Defines the core logic, schemas, and types for the `generate_sql` tool.
+ * This module is the single source of truth for the tool's data contracts (Zod schemas)
+ * and its pure business logic for generating SQL DDL statements from IBM i database objects.
+ * @module src/mcp-server/tools/generateSql/logic
+ * @see {@link src/mcp-server/tools/generateSql/registration.ts} for the handler and registration logic.
+ */
+import { z } from "zod";
+/**
+ * Zod schema defining the input parameters for the `generate_sql` tool.
+ */
+export declare const GenerateSqlInputSchema: z.ZodObject<{
+    object_name: z.ZodString;
+    object_library: z.ZodDefault<z.ZodString>;
+    object_type: z.ZodDefault<z.ZodEnum<["ALIAS", "CONSTRAINT", "FUNCTION", "INDEX", "MASK", "PERMISSION", "PROCEDURE", "SCHEMA", "SEQUENCE", "TABLE", "TRIGGER", "TYPE", "VARIABLE", "VIEW", "XSR"]>>;
+}, "strip", z.ZodTypeAny, {
+    object_name: string;
+    object_library: string;
+    object_type: "ALIAS" | "CONSTRAINT" | "FUNCTION" | "INDEX" | "MASK" | "PERMISSION" | "PROCEDURE" | "SCHEMA" | "SEQUENCE" | "TABLE" | "TRIGGER" | "TYPE" | "VARIABLE" | "VIEW" | "XSR";
+}, {
+    object_name: string;
+    object_library?: string | undefined;
+    object_type?: "ALIAS" | "CONSTRAINT" | "FUNCTION" | "INDEX" | "MASK" | "PERMISSION" | "PROCEDURE" | "SCHEMA" | "SEQUENCE" | "TABLE" | "TRIGGER" | "TYPE" | "VARIABLE" | "VIEW" | "XSR" | undefined;
+}>;
+/**
+ * Zod schema for the successful response of the `generate_sql` tool.
+ * Contains the generated DDL along with metadata about the source object.
+ */
+export declare const GenerateSqlOutputSchema: z.ZodObject<{
+    sql: z.ZodString;
+    object_name: z.ZodString;
+    object_library: z.ZodString;
+    object_type: z.ZodString;
+}, "strip", z.ZodTypeAny, {
+    object_name: string;
+    object_library: string;
+    object_type: string;
+    sql: string;
+}, {
+    object_name: string;
+    object_library: string;
+    object_type: string;
+    sql: string;
+}>;
+/**
+ * TypeScript type inferred from the input schema.
+ * Represents the validated parameters passed to the generate SQL logic.
+ */
+export type GenerateSqlInput = z.infer<typeof GenerateSqlInputSchema>;
+/**
+ * TypeScript type inferred from the output schema.
+ * Represents the structured response returned by the generate SQL logic.
+ */
+export type GenerateSqlOutput = z.infer<typeof GenerateSqlOutputSchema>;
+/**
+ * Processes the core logic for the `generate_sql` tool.
+ * This function calls the QSYS2.GENERATE_SQL procedure to generate DDL for IBM i database objects.
+ *
+ * @param params - The validated input parameters containing object details
+ * @returns A promise resolving with the generated SQL DDL
+ * @throws {McpError} If the SQL generation encounters an unrecoverable issue
+ */
+export declare function generateSqlLogic(params: GenerateSqlInput): Promise<GenerateSqlOutput>;
+//# sourceMappingURL=logic.d.ts.map

package/dist/ibmi-mcp-server/tools/generateSql/logic.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"logic.d.ts","sourceRoot":"","sources":["../../../../src/ibmi-mcp-server/tools/generateSql/logic.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AA6BxB;;GAEG;AACH,eAAO,MAAM,sBAAsB;;;;;;;;;;;;EAsBe,CAAC;AAEnD;;;GAGG;AACH,eAAO,MAAM,uBAAuB;;;;;;;;;;;;;;;EAkBc,CAAC;AAEnD;;;GAGG;AACH,MAAM,MAAM,gBAAgB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,sBAAsB,CAAC,CAAC;AAEtE;;;GAGG;AACH,MAAM,MAAM,iBAAiB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,uBAAuB,CAAC,CAAC;AAExE;;;;;;;GAOG;AACH,wBAAsB,gBAAgB,CACpC,MAAM,EAAE,gBAAgB,GACvB,OAAO,CAAC,iBAAiB,CAAC,CAuJ5B"}

package/dist/ibmi-mcp-server/tools/generateSql/logic.js

@@ -0,0 +1,190 @@
+/**
+ * @fileoverview Defines the core logic, schemas, and types for the `generate_sql` tool.
+ * This module is the single source of truth for the tool's data contracts (Zod schemas)
+ * and its pure business logic for generating SQL DDL statements from IBM i database objects.
+ * @module src/mcp-server/tools/generateSql/logic
+ * @see {@link src/mcp-server/tools/generateSql/registration.ts} for the handler and registration logic.
+ */
+import { z } from "zod";
+import { JsonRpcErrorCode, McpError } from "../../../types-global/errors.js";
+import { getRequestContext } from "../../../utils/index.js";
+import { logger } from "../../../utils/internal/logger.js";
+import { IBMiConnectionPool } from "../../services/connectionPool.js";
+/**
+ * Supported IBM i database object types for DDL generation.
+ * These correspond to the valid values for the DATABASE_OBJECT_TYPE parameter
+ * of the QSYS2.GENERATE_SQL stored procedure.
+ */
+const OBJECT_TYPES = [
+    "ALIAS",
+    "CONSTRAINT",
+    "FUNCTION",
+    "INDEX",
+    "MASK",
+    "PERMISSION",
+    "PROCEDURE",
+    "SCHEMA",
+    "SEQUENCE",
+    "TABLE",
+    "TRIGGER",
+    "TYPE",
+    "VARIABLE",
+    "VIEW",
+    "XSR",
+];
+/**
+ * Zod schema defining the input parameters for the `generate_sql` tool.
+ */
+export const GenerateSqlInputSchema = z
+    .object({
+    object_name: z
+        .string()
+        .min(1, "Object name cannot be empty.")
+        .max(128, "Object name cannot exceed 128 characters.")
+        .describe("The name of the IBM i database object to generate DDL for."),
+    object_library: z
+        .string()
+        .min(1, "Library name cannot be empty.")
+        .max(128, "Library name cannot exceed 128 characters.")
+        .default("QSYS2")
+        .describe("The library where the database object is located. Defaults to QSYS2."),
+    object_type: z
+        .enum(OBJECT_TYPES)
+        .default("TABLE")
+        .describe("The type of database object to generate DDL for. Valid types include TABLE, VIEW, INDEX, PROCEDURE, FUNCTION, etc."),
+})
+    .describe("Input schema for generating SQL DDL");
+/**
+ * Zod schema for the successful response of the `generate_sql` tool.
+ * Contains the generated DDL along with metadata about the source object.
+ */
+export const GenerateSqlOutputSchema = z
+    .object({
+    sql: z
+        .string()
+        .min(1, "Generated SQL cannot be empty.")
+        .describe("The generated DDL SQL statements for the specified database object."),
+    object_name: z
+        .string()
+        .describe("The name of the object the DDL was generated for."),
+    object_library: z
+        .string()
+        .describe("The library of the object the DDL was generated for."),
+    object_type: z
+        .string()
+        .describe("The type of the object the DDL was generated for."),
+})
+    .describe("Output schema for generated SQL DDL");
+/**
+ * Processes the core logic for the `generate_sql` tool.
+ * This function calls the QSYS2.GENERATE_SQL procedure to generate DDL for IBM i database objects.
+ *
+ * @param params - The validated input parameters containing object details
+ * @returns A promise resolving with the generated SQL DDL
+ * @throws {McpError} If the SQL generation encounters an unrecoverable issue
+ */
+export async function generateSqlLogic(params) {
+    const context = getRequestContext();
+    logger.debug({ ...context, toolInput: params }, "Processing generate SQL DDL logic.");
+    const sql = `CALL QSYS2.GENERATE_SQL(
+    DATABASE_OBJECT_NAME => ?,
+    DATABASE_OBJECT_LIBRARY_NAME => ?,
+    DATABASE_OBJECT_TYPE => ?,
+    CREATE_OR_REPLACE_OPTION => '1',
+    PRIVILEGES_OPTION => '0',
+    STATEMENT_FORMATTING_OPTION => '0',
+    SOURCE_STREAM_FILE_END_OF_LINE => 'LF',
+    SOURCE_STREAM_FILE_CCSID => 1208
+  )`;
+    const startTime = Date.now();
+    try {
+        // Execute the GENERATE_SQL procedure using pagination to get all results
+        const result = await IBMiConnectionPool.executeQueryWithPagination(sql, [params.object_name, params.object_library, params.object_type], context, 500);
+        const executionTime = Date.now() - startTime;
+        if (!result.success) {
+            throw new McpError(JsonRpcErrorCode.DatabaseError, "SQL DDL generation failed", {
+                objectName: params.object_name,
+                objectLibrary: params.object_library,
+                objectType: params.object_type,
+                sqlReturnCode: result.sql_rc,
+                executionTime,
+            });
+        }
+        // Process the result data to extract the generated DDL
+        let generatedSql = "";
+        if (result.data && Array.isArray(result.data)) {
+            logger.debug({
+                ...context,
+                totalRows: result.data.length,
+                firstRowKeys: result.data[0] ? Object.keys(result.data[0]) : [],
+            }, "Processing GENERATE_SQL result data.");
+            // Build the result string from the SRCDTA column
+            // Results are already in correct order from the paginated query
+            const resultStrings = [];
+            for (const res of result.data) {
+                if (res && typeof res === "object" && "SRCDTA" in res) {
+                    const srcData = res.SRCDTA;
+                    if (srcData && typeof srcData === "string") {
+                        resultStrings.push(srcData);
+                    }
+                }
+            }
+            generatedSql = resultStrings.join("\n");
+            logger.debug({
+                ...context,
+                processedRows: resultStrings.length,
+                totalDdlLength: generatedSql.length,
+                avgRowLength: resultStrings.length > 0
+                    ? Math.round(generatedSql.length / resultStrings.length)
+                    : 0,
+            }, "DDL extraction completed.");
+        }
+        if (!generatedSql || generatedSql.trim().length === 0) {
+            throw new McpError(JsonRpcErrorCode.DatabaseError, "No SQL DDL generated for the specified object", {
+                objectName: params.object_name,
+                objectLibrary: params.object_library,
+                objectType: params.object_type,
+                resultRowCount: result.data?.length || 0,
+            });
+        }
+        const response = {
+            sql: generatedSql.trim(),
+            object_name: params.object_name,
+            object_library: params.object_library,
+            object_type: params.object_type,
+        };
+        logger.debug({
+            ...context,
+            objectName: params.object_name,
+            objectLibrary: params.object_library,
+            objectType: params.object_type,
+            sqlLength: response.sql.length,
+            executionTime,
+            rowCount: result.data?.length || 0,
+        }, "SQL DDL generated successfully.");
+        return response;
+    }
+    catch (error) {
+        const executionTime = Date.now() - startTime;
+        logger.error({
+            ...context,
+            error: error instanceof Error ? error.message : String(error),
+            objectName: params.object_name,
+            objectLibrary: params.object_library,
+            objectType: params.object_type,
+            executionTime,
+        }, "SQL DDL generation failed.");
+        // Re-throw McpErrors as-is, wrap other errors
+        if (error instanceof McpError) {
+            throw error;
+        }
+        throw new McpError(JsonRpcErrorCode.DatabaseError, `SQL DDL generation failed: ${error instanceof Error ? error.message : String(error)}`, {
+            objectName: params.object_name,
+            objectLibrary: params.object_library,
+            objectType: params.object_type,
+            executionTime,
+            originalError: error instanceof Error ? error.name : "Unknown",
+        });
+    }
+}
+//# sourceMappingURL=logic.js.map

package/dist/ibmi-mcp-server/tools/generateSql/logic.js.map

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

package/dist/ibmi-mcp-server/tools/generateSql/registration.d.ts

@@ -0,0 +1,18 @@
+/**
+ * @fileoverview Handles registration and error handling for the `generate_sql` tool.
+ * This module acts as the "handler" layer, connecting the pure business logic to the
+ * MCP server and ensuring all outcomes (success or failure) are handled gracefully.
+ * @module src/mcp-server/tools/generateSql/registration
+ * @see {@link src/mcp-server/tools/generateSql/logic.ts} for the core business logic and schemas.
+ */
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+export declare const TOOL_NAME = "describe_sql_object";
+/**
+ * Registers the 'generate_sql' tool and its handler with the provided MCP server instance.
+ * This function uses ErrorHandler.tryCatch to ensure that any failure during the
+ * registration process itself is caught and logged, preventing server startup failures.
+ *
+ * @param server - The MCP server instance to register the tool with.
+ */
+export declare const registerGenerateSqlTool: (server: McpServer) => Promise<void>;
+//# sourceMappingURL=registration.d.ts.map

package/dist/ibmi-mcp-server/tools/generateSql/registration.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"registration.d.ts","sourceRoot":"","sources":["../../../../src/ibmi-mcp-server/tools/generateSql/registration.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAoBpE,eAAO,MAAM,SAAS,wBAAwB,CAAC;AAmB/C;;;;;;GAMG;AACH,eAAO,MAAM,uBAAuB,GAClC,QAAQ,SAAS,KAChB,OAAO,CAAC,IAAI,CA0Cd,CAAC"}

package/dist/ibmi-mcp-server/tools/generateSql/registration.js

@@ -0,0 +1,64 @@
+/**
+ * @fileoverview Handles registration and error handling for the `generate_sql` tool.
+ * This module acts as the "handler" layer, connecting the pure business logic to the
+ * MCP server and ensuring all outcomes (success or failure) are handled gracefully.
+ * @module src/mcp-server/tools/generateSql/registration
+ * @see {@link src/mcp-server/tools/generateSql/logic.ts} for the core business logic and schemas.
+ */
+import { JsonRpcErrorCode } from "../../../types-global/errors.js";
+import { ErrorHandler, requestContextService } from "../../../utils/index.js";
+import { ToolsetManager } from "../../utils/config/toolsetManager.js";
+import { logOperationStart, logOperationSuccess, } from "../../../utils/internal/logging-helpers.js";
+import { createToolHandler, } from "../../../mcp-server/tools/utils/tool-utils.js";
+import { GenerateSqlInputSchema, generateSqlLogic, GenerateSqlOutputSchema, } from "./logic.js";
+// The unique name for the tool, used for registration and identification.
+export const TOOL_NAME = "describe_sql_object";
+// A concise description for the LLM. More detailed guidance should be in the
+// parameter descriptions within the Zod schema in `logic.ts`.
+const TOOL_DESCRIPTION = "Describes IBM i database objects by generating their SQL DDL statements. Useful for understanding object structure and recreating objects.";
+const responseFormatter = (result) => ({
+    structuredContent: result,
+    content: [
+        {
+            type: "text",
+            text: `Successfully generated SQL DDL for ${result.object_type} '${result.object_name}' in library '${result.object_library}':\n\n${result.sql}`,
+        },
+    ],
+});
+/**
+ * Registers the 'generate_sql' tool and its handler with the provided MCP server instance.
+ * This function uses ErrorHandler.tryCatch to ensure that any failure during the
+ * registration process itself is caught and logged, preventing server startup failures.
+ *
+ * @param server - The MCP server instance to register the tool with.
+ */
+export const registerGenerateSqlTool = async (server) => {
+    const registrationContext = requestContextService.createRequestContext({
+        operation: "RegisterTool",
+        toolName: TOOL_NAME,
+    });
+    logOperationStart(registrationContext, `Registering tool: '${TOOL_NAME}'`);
+    await ErrorHandler.tryCatch(async () => {
+        // Get toolset metadata for global tool
+        const toolsetManager = ToolsetManager.getInstance();
+        const toolsetMetadata = toolsetManager.generateToolMetadata(TOOL_NAME);
+        server.registerTool(TOOL_NAME, {
+            title: "Generate SQL DDL",
+            description: TOOL_DESCRIPTION,
+            inputSchema: GenerateSqlInputSchema.shape,
+            outputSchema: GenerateSqlOutputSchema.shape,
+            annotations: {
+                readOnlyHint: false, // This tool generates DDL which could be used for schema changes
+                openWorldHint: false, // This tool interacts with the IBM i database system
+                ...toolsetMetadata, // Add toolset metadata for filtering
+            },
+        }, createToolHandler(TOOL_NAME, generateSqlLogic, responseFormatter));
+        logOperationSuccess(registrationContext, `Tool '${TOOL_NAME}' registered successfully.`);
+    }, {
+        operation: `RegisteringTool_${TOOL_NAME}`,
+        context: registrationContext,
+        errorCode: JsonRpcErrorCode.InitializationFailed,
+        critical: true, // A failure to register a tool is a critical startup error.
+    });
+};
+//# sourceMappingURL=registration.js.map

package/dist/ibmi-mcp-server/tools/generateSql/registration.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"registration.js","sourceRoot":"","sources":["../../../../src/ibmi-mcp-server/tools/generateSql/registration.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAGH,OAAO,EAAE,gBAAgB,EAAE,MAAM,iCAAiC,CAAC;AACnE,OAAO,EAAE,YAAY,EAAE,qBAAqB,EAAE,MAAM,yBAAyB,CAAC;AAC9E,OAAO,EAAE,cAAc,EAAE,MAAM,sCAAsC,CAAC;AACtE,OAAO,EACL,iBAAiB,EACjB,mBAAmB,GACpB,MAAM,4CAA4C,CAAC;AACpD,OAAO,EACL,iBAAiB,GAElB,MAAM,+CAA+C,CAAC;AACvD,OAAO,EACL,sBAAsB,EACtB,gBAAgB,EAEhB,uBAAuB,GACxB,MAAM,YAAY,CAAC;AAEpB,0EAA0E;AAC1E,MAAM,CAAC,MAAM,SAAS,GAAG,qBAAqB,CAAC;AAE/C,6EAA6E;AAC7E,8DAA8D;AAC9D,MAAM,gBAAgB,GACpB,4IAA4I,CAAC;AAE/I,MAAM,iBAAiB,GAAyC,CAC9D,MAAyB,EACzB,EAAE,CAAC,CAAC;IACJ,iBAAiB,EAAE,MAAM;IACzB,OAAO,EAAE;QACP;YACE,IAAI,EAAE,MAAM;YACZ,IAAI,EAAE,sCAAsC,MAAM,CAAC,WAAW,KAAK,MAAM,CAAC,WAAW,iBAAiB,MAAM,CAAC,cAAc,SAAS,MAAM,CAAC,GAAG,EAAE;SACjJ;KACF;CACF,CAAC,CAAC;AAEH;;;;;;GAMG;AACH,MAAM,CAAC,MAAM,uBAAuB,GAAG,KAAK,EAC1C,MAAiB,EACF,EAAE;IACjB,MAAM,mBAAmB,GAAG,qBAAqB,CAAC,oBAAoB,CAAC;QACrE,SAAS,EAAE,cAAc;QACzB,QAAQ,EAAE,SAAS;KACpB,CAAC,CAAC;IAEH,iBAAiB,CAAC,mBAAmB,EAAE,sBAAsB,SAAS,GAAG,CAAC,CAAC;IAE3E,MAAM,YAAY,CAAC,QAAQ,CACzB,KAAK,IAAI,EAAE;QACT,uCAAuC;QACvC,MAAM,cAAc,GAAG,cAAc,CAAC,WAAW,EAAE,CAAC;QACpD,MAAM,eAAe,GAAG,cAAc,CAAC,oBAAoB,CAAC,SAAS,CAAC,CAAC;QAEvE,MAAM,CAAC,YAAY,CACjB,SAAS,EACT;YACE,KAAK,EAAE,kBAAkB;YACzB,WAAW,EAAE,gBAAgB;YAC7B,WAAW,EAAE,sBAAsB,CAAC,KAAK;YACzC,YAAY,EAAE,uBAAuB,CAAC,KAAK;YAC3C,WAAW,EAAE;gBACX,YAAY,EAAE,KAAK,EAAE,iEAAiE;gBACtF,aAAa,EAAE,KAAK,EAAE,qDAAqD;gBAC3E,GAAG,eAAe,EAAE,qCAAqC;aAC1D;SACF,EACD,iBAAiB,CAAC,SAAS,EAAE,gBAAgB,EAAE,iBAAiB,CAAC,CAClE,CAAC;QAEF,mBAAmB,CACjB,mBAAmB,EACnB,SAAS,SAAS,4BAA4B,CAC/C,CAAC;IACJ,CAAC,EACD;QACE,SAAS,EAAE,mBAAmB,SAAS,EAAE;QACzC,OAAO,EAAE,mBAAmB;QAC5B,SAAS,EAAE,gBAAgB,CAAC,oBAAoB;QAChD,QAAQ,EAAE,IAAI,EAAE,4DAA4D;KAC7E,CACF,CAAC;AACJ,CAAC,CAAC"}