@ibm/ibmi-mcp-server 0.1.0

package/dist/ibmi-mcp-server/resources/toolsetsResource/logic.js

@@ -0,0 +1,145 @@
+/**
+ * @fileoverview Defines the core logic, schemas, and types for the `toolsets` resource.
+ * This module provides access to all available toolsets on the server, including
+ * their metadata, tool counts, and organization details.
+ * @module src/mcp-server/resources/toolsetsResource/logic
+ * @see {@link src/mcp-server/resources/toolsetsResource/registration.ts} for the handler and registration logic.
+ */
+import { z } from "zod";
+import { JsonRpcErrorCode, McpError } from "../../../types-global/errors.js";
+import { logger } from "../../../utils/index.js";
+import { ToolsetManager } from "../../utils/config/toolsetManager.js";
+// Zod schema for individual toolset information
+export const ToolsetInfoSchema = z.object({
+    name: z.string().describe("The name of the toolset"),
+    description: z.string().describe("A description of the toolset's purpose"),
+    tools: z.array(z.string()).describe("Array of tool names in this toolset"),
+    toolCount: z
+        .number()
+        .int()
+        .min(0)
+        .describe("Number of tools in this toolset"),
+});
+// Zod schema for toolsets resource parameters
+export const ToolsetsResourceParamsSchema = z.object({
+    toolsetName: z
+        .string()
+        .optional()
+        .describe("Optional toolset name to filter results"),
+});
+// Zod schema for the complete toolsets resource response
+export const ToolsetsResourceResponseSchema = z.object({
+    totalToolsets: z
+        .number()
+        .int()
+        .min(0)
+        .describe("Total number of toolsets available"),
+    totalTools: z
+        .number()
+        .int()
+        .min(0)
+        .describe("Total number of tools across all toolsets"),
+    toolsets: z
+        .array(ToolsetInfoSchema)
+        .describe("Array of toolset information objects"),
+    statistics: z
+        .object({
+        multiToolsetTools: z
+            .array(z.string())
+            .describe("Tools that belong to multiple toolsets"),
+        toolsetCounts: z
+            .record(z.number().int().min(0))
+            .describe("Map of toolset names to their tool counts"),
+    })
+        .describe("Additional statistics about toolset organization"),
+    timestamp: z
+        .string()
+        .datetime()
+        .describe("ISO 8601 timestamp when the data was retrieved"),
+});
+/**
+ * Processes the core logic for the `toolsets` resource.
+ * Retrieves toolset information from the ToolsetManager and formats it for MCP clients.
+ *
+ * @param uri - The resource URI, which may contain a specific toolset name
+ * @param params - The validated resource parameters
+ * @param context - The request context for logging and tracing
+ * @returns A promise resolving with the structured toolsets data
+ * @throws {McpError} If the toolset system is not initialized or toolset not found
+ */
+export async function toolsetsResourceLogic(uri, params, context) {
+    logger.debug({
+        ...context,
+        uri: uri.href,
+        params,
+    }, "Processing toolsets resource logic");
+    const toolsetManager = ToolsetManager.getInstance();
+    // Get toolset statistics
+    const stats = toolsetManager.getToolsetStats();
+    if (stats.totalToolsets === 0) {
+        throw new McpError(JsonRpcErrorCode.InitializationFailed, "No toolsets are currently available. The toolset system may not be initialized.", { totalToolsets: stats.totalToolsets });
+    }
+    // Extract toolset name from URI path if provided
+    const pathSegments = uri.pathname.split("/").filter(Boolean);
+    const toolsetNameFromUri = pathSegments.length > 0 ? pathSegments[0] : undefined;
+    const requestedToolset = params.toolsetName || toolsetNameFromUri;
+    let toolsetsToProcess = [];
+    if (requestedToolset) {
+        // Filter for specific toolset
+        const toolsetConfig = toolsetManager.getToolsetConfig(requestedToolset);
+        if (!toolsetConfig) {
+            throw new McpError(JsonRpcErrorCode.ValidationError, `Toolset '${requestedToolset}' not found`, {
+                requestedToolset,
+                availableToolsets: toolsetManager.getAllToolsetNames(),
+            });
+        }
+        toolsetsToProcess = [requestedToolset];
+        logger.debug(context, `Filtering for specific toolset: ${requestedToolset}`);
+    }
+    else {
+        // Get all toolsets
+        toolsetsToProcess = toolsetManager.getAllToolsetNames();
+        logger.debug(context, `Processing all ${toolsetsToProcess.length} toolsets`);
+    }
+    // Build toolset information array
+    const toolsets = [];
+    for (const toolsetName of toolsetsToProcess) {
+        const toolsetConfig = toolsetManager.getToolsetConfig(toolsetName);
+        if (!toolsetConfig) {
+            logger.warning(context, `Skipping missing toolset configuration: ${toolsetName}`);
+            continue;
+        }
+        const toolsInToolset = toolsetManager.getToolsInToolset(toolsetName);
+        const toolsetInfo = {
+            name: toolsetName,
+            description: toolsetConfig.description || `Tools for ${toolsetName}`,
+            tools: toolsInToolset,
+            toolCount: toolsInToolset.length,
+        };
+        toolsets.push(toolsetInfo);
+    }
+    // Sort toolsets by name for consistent ordering
+    toolsets.sort((a, b) => a.name.localeCompare(b.name));
+    const response = {
+        totalToolsets: requestedToolset ? toolsets.length : stats.totalToolsets,
+        totalTools: requestedToolset
+            ? toolsets.reduce((sum, ts) => sum + ts.toolCount, 0)
+            : stats.totalTools,
+        toolsets,
+        statistics: {
+            multiToolsetTools: stats.multiToolsetTools,
+            toolsetCounts: stats.toolsetCounts,
+        },
+        timestamp: new Date().toISOString(),
+    };
+    logger.debug({
+        ...context,
+        responseSummary: {
+            toolsetsReturned: toolsets.length,
+            totalToolsInResponse: toolsets.reduce((sum, ts) => sum + ts.toolCount, 0),
+            filteredByToolset: !!requestedToolset,
+        },
+    }, "Toolsets resource processed successfully");
+    return response;
+}
+//# sourceMappingURL=logic.js.map

package/dist/ibmi-mcp-server/resources/toolsetsResource/logic.js.map

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

package/dist/ibmi-mcp-server/resources/toolsetsResource/registration.d.ts

@@ -0,0 +1,16 @@
+/**
+ * @fileoverview Handles the registration of the `toolsets` resource with an MCP server instance.
+ * 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/resources/toolsetsResource/registration
+ * @see {@link src/mcp-server/resources/toolsetsResource/logic.ts} for the core business logic and schemas.
+ */
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+/**
+ * Registers the 'toolsets' resource and its handlers with the provided MCP server instance.
+ * This resource exposes all available toolsets on the server with their metadata and tool listings.
+ *
+ * @param server - The MCP server instance to register the resource with.
+ */
+export declare const registerToolsetsResource: (server: McpServer) => Promise<void>;
+//# sourceMappingURL=registration.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"registration.d.ts","sourceRoot":"","sources":["../../../../src/ibmi-mcp-server/resources/toolsetsResource/registration.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAYpE;;;;;GAKG;AACH,eAAO,MAAM,wBAAwB,GACnC,QAAQ,SAAS,KAChB,OAAO,CAAC,IAAI,CAyId,CAAC"}

package/dist/ibmi-mcp-server/resources/toolsetsResource/registration.js

@@ -0,0 +1,110 @@
+/**
+ * @fileoverview Handles the registration of the `toolsets` resource with an MCP server instance.
+ * 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/resources/toolsetsResource/registration
+ * @see {@link src/mcp-server/resources/toolsetsResource/logic.ts} for the core business logic and schemas.
+ */
+import { JsonRpcErrorCode } from "../../../types-global/errors.js";
+import { ErrorHandler, logger, requestContextService, } from "../../../utils/index.js";
+import { toolsetsResourceLogic } from "./logic.js";
+import { ToolsetManager } from "../../utils/config/toolsetManager.js";
+/**
+ * Registers the 'toolsets' resource and its handlers with the provided MCP server instance.
+ * This resource exposes all available toolsets on the server with their metadata and tool listings.
+ *
+ * @param server - The MCP server instance to register the resource with.
+ */
+export const registerToolsetsResource = async (server) => {
+    const resourceName = "toolsets-resource";
+    const registrationContext = requestContextService.createRequestContext({
+        operation: "RegisterResource",
+        resourceName: resourceName,
+    });
+    logger.info(registrationContext, `Registering resource: '${resourceName}'`);
+    await ErrorHandler.tryCatch(async () => {
+        // Register the main "all toolsets" resource
+        server.registerResource(`${resourceName}-all`, "toolsets://", {
+            description: "Complete catalog of all available toolsets and their tools",
+            mimeType: "application/json",
+        }, async (uri, callContext) => {
+            const sessionId = typeof callContext?.sessionId === "string"
+                ? callContext.sessionId
+                : undefined;
+            const handlerContext = requestContextService.createRequestContext({
+                parentContext: callContext,
+                operation: "HandleResourceRead",
+                resourceUri: uri.href,
+                sessionId,
+            });
+            try {
+                const result = await toolsetsResourceLogic(uri, {}, handlerContext);
+                return {
+                    contents: [
+                        {
+                            uri: uri.href,
+                            blob: Buffer.from(JSON.stringify(result, null, 2)).toString("base64"),
+                            mimeType: "application/json",
+                        },
+                    ],
+                };
+            }
+            catch (error) {
+                throw ErrorHandler.handleError(error, {
+                    operation: "toolsetsAllResourceReadHandler",
+                    context: handlerContext,
+                    input: { uri: uri.href },
+                });
+            }
+        });
+        // Register individual toolset resources
+        const toolsetManager = ToolsetManager.getInstance();
+        const allToolsetNames = toolsetManager.getAllToolsetNames();
+        for (const toolsetName of allToolsetNames) {
+            const toolsetConfig = toolsetManager.getToolsetConfig(toolsetName);
+            const toolsInToolset = toolsetManager.getToolsInToolset(toolsetName);
+            server.registerResource(`${resourceName}-${toolsetName}`, `toolsets://${toolsetName}`, {
+                description: toolsetConfig?.description
+                    ? `${toolsetConfig.description} (${toolsInToolset.length} tools)`
+                    : `${toolsetName} toolset with ${toolsInToolset.length} tools`,
+                mimeType: "application/json",
+            }, async (uri, callContext) => {
+                const sessionId = typeof callContext?.sessionId === "string"
+                    ? callContext.sessionId
+                    : undefined;
+                const handlerContext = requestContextService.createRequestContext({
+                    parentContext: callContext,
+                    operation: "HandleResourceRead",
+                    resourceUri: uri.href,
+                    sessionId,
+                });
+                try {
+                    const result = await toolsetsResourceLogic(uri, { toolsetName }, handlerContext);
+                    return {
+                        contents: [
+                            {
+                                uri: uri.href,
+                                blob: Buffer.from(JSON.stringify(result, null, 2)).toString("base64"),
+                                mimeType: "application/json",
+                            },
+                        ],
+                    };
+                }
+                catch (error) {
+                    throw ErrorHandler.handleError(error, {
+                        operation: `toolsetsResourceReadHandler_${toolsetName}`,
+                        context: handlerContext,
+                        input: { uri: uri.href, toolsetName },
+                    });
+                }
+            });
+        }
+        logger.info(registrationContext, `Resource '${resourceName}' registered successfully.`);
+    }, {
+        operation: `RegisteringResource_${resourceName}`,
+        context: registrationContext,
+        errorCode: JsonRpcErrorCode.InitializationFailed,
+        critical: true,
+    });
+};
+//# sourceMappingURL=registration.js.map

package/dist/ibmi-mcp-server/resources/toolsetsResource/registration.js.map

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

package/dist/ibmi-mcp-server/schemas/common.d.ts

@@ -0,0 +1,174 @@
+/**
+ * @fileoverview Common schema definitions and utilities
+ * Shared Zod schemas used across multiple modules in the IBM i MCP server
+ *
+ * @module src/ibmi-mcp-server/schemas/common
+ */
+import { z } from "zod";
+/**
+ * Response format options for SQL tools
+ */
+export declare const ResponseFormatSchema: z.ZodEnum<["json", "markdown"]>;
+/**
+ * Common metadata schema for extensible objects
+ */
+export declare const MetadataSchema: z.ZodRecord<z.ZodString, z.ZodUnknown>;
+/**
+ * Tool annotation hints schema for MCP client behavior
+ */
+export declare const ToolAnnotationsSchema: z.ZodObject<{
+    /**
+     * An optional human-readable name for the tool, optimized for UI display.
+     */
+    title: z.ZodOptional<z.ZodString>;
+    /**
+     * A hint indicating that the tool does not modify any state.
+     */
+    readOnlyHint: z.ZodOptional<z.ZodBoolean>;
+    /**
+     * A hint indicating that the tool may interact with external systems.
+     */
+    openWorldHint: z.ZodOptional<z.ZodBoolean>;
+    /**
+     * Indicates that the tool has no side effects when called multiple times.
+     */
+    idempotentHint: z.ZodOptional<z.ZodBoolean>;
+    /**
+     * Indicates that the tool may produce destructive side effects.
+     */
+    destructiveHint: z.ZodOptional<z.ZodBoolean>;
+    /**
+     * Domain classification for filtering and organization.
+     */
+    domain: z.ZodOptional<z.ZodString>;
+    /**
+     * Category classification for filtering and organization.
+     */
+    category: z.ZodOptional<z.ZodString>;
+    /**
+     * Toolsets that the tool belongs to.
+     */
+    toolsets: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+    /**
+     * Additional custom metadata.
+     */
+    customMetadata: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+}, "strip", z.ZodUnknown, z.objectOutputType<{
+    /**
+     * An optional human-readable name for the tool, optimized for UI display.
+     */
+    title: z.ZodOptional<z.ZodString>;
+    /**
+     * A hint indicating that the tool does not modify any state.
+     */
+    readOnlyHint: z.ZodOptional<z.ZodBoolean>;
+    /**
+     * A hint indicating that the tool may interact with external systems.
+     */
+    openWorldHint: z.ZodOptional<z.ZodBoolean>;
+    /**
+     * Indicates that the tool has no side effects when called multiple times.
+     */
+    idempotentHint: z.ZodOptional<z.ZodBoolean>;
+    /**
+     * Indicates that the tool may produce destructive side effects.
+     */
+    destructiveHint: z.ZodOptional<z.ZodBoolean>;
+    /**
+     * Domain classification for filtering and organization.
+     */
+    domain: z.ZodOptional<z.ZodString>;
+    /**
+     * Category classification for filtering and organization.
+     */
+    category: z.ZodOptional<z.ZodString>;
+    /**
+     * Toolsets that the tool belongs to.
+     */
+    toolsets: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+    /**
+     * Additional custom metadata.
+     */
+    customMetadata: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+}, z.ZodUnknown, "strip">, z.objectInputType<{
+    /**
+     * An optional human-readable name for the tool, optimized for UI display.
+     */
+    title: z.ZodOptional<z.ZodString>;
+    /**
+     * A hint indicating that the tool does not modify any state.
+     */
+    readOnlyHint: z.ZodOptional<z.ZodBoolean>;
+    /**
+     * A hint indicating that the tool may interact with external systems.
+     */
+    openWorldHint: z.ZodOptional<z.ZodBoolean>;
+    /**
+     * Indicates that the tool has no side effects when called multiple times.
+     */
+    idempotentHint: z.ZodOptional<z.ZodBoolean>;
+    /**
+     * Indicates that the tool may produce destructive side effects.
+     */
+    destructiveHint: z.ZodOptional<z.ZodBoolean>;
+    /**
+     * Domain classification for filtering and organization.
+     */
+    domain: z.ZodOptional<z.ZodString>;
+    /**
+     * Category classification for filtering and organization.
+     */
+    category: z.ZodOptional<z.ZodString>;
+    /**
+     * Toolsets that the tool belongs to.
+     */
+    toolsets: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+    /**
+     * Additional custom metadata.
+     */
+    customMetadata: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+}, z.ZodUnknown, "strip">>;
+/**
+ * Column definition schema for database result sets
+ */
+export declare const ColumnDefinitionSchema: z.ZodObject<{
+    name: z.ZodString;
+    type: z.ZodOptional<z.ZodString>;
+    label: z.ZodOptional<z.ZodString>;
+}, "strip", z.ZodTypeAny, {
+    name: string;
+    type?: string | undefined;
+    label?: string | undefined;
+}, {
+    name: string;
+    type?: string | undefined;
+    label?: string | undefined;
+}>;
+/**
+ * Base parameter constraint schemas for reuse
+ */
+export declare const ParameterConstraintsSchema: z.ZodObject<{
+    min: z.ZodOptional<z.ZodNumber>;
+    max: z.ZodOptional<z.ZodNumber>;
+    minLength: z.ZodOptional<z.ZodNumber>;
+    maxLength: z.ZodOptional<z.ZodNumber>;
+    pattern: z.ZodOptional<z.ZodString>;
+}, "strip", z.ZodTypeAny, {
+    pattern?: string | undefined;
+    min?: number | undefined;
+    max?: number | undefined;
+    minLength?: number | undefined;
+    maxLength?: number | undefined;
+}, {
+    pattern?: string | undefined;
+    min?: number | undefined;
+    max?: number | undefined;
+    minLength?: number | undefined;
+    maxLength?: number | undefined;
+}>;
+export type ResponseFormat = z.infer<typeof ResponseFormatSchema>;
+export type Metadata = z.infer<typeof MetadataSchema>;
+export type ToolAnnotations = z.infer<typeof ToolAnnotationsSchema>;
+export type ColumnDefinition = z.infer<typeof ColumnDefinitionSchema>;
+export type ParameterConstraints = z.infer<typeof ParameterConstraintsSchema>;
+//# sourceMappingURL=common.d.ts.map

package/dist/ibmi-mcp-server/schemas/common.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"common.d.ts","sourceRoot":"","sources":["../../../src/ibmi-mcp-server/schemas/common.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB;;GAEG;AACH,eAAO,MAAM,oBAAoB,iCAE/B,CAAC;AAEH;;GAEG;AACH,eAAO,MAAM,cAAc,wCAEiD,CAAC;AAE7E;;GAEG;AACH,eAAO,MAAM,qBAAqB;IAE9B;;OAEG;;IAKH;;OAEG;;IAKH;;OAEG;;IAOH;;OAEG;;IAOH;;OAEG;;IAOH;;OAEG;;IAKH;;OAEG;;IAKH;;OAEG;;IAKH;;OAEG;;;IAhEH;;OAEG;;IAKH;;OAEG;;IAKH;;OAEG;;IAOH;;OAEG;;IAOH;;OAEG;;IAOH;;OAEG;;IAKH;;OAEG;;IAKH;;OAEG;;IAKH;;OAEG;;;IAhEH;;OAEG;;IAKH;;OAEG;;IAKH;;OAEG;;IAOH;;OAEG;;IAOH;;OAEG;;IAOH;;OAEG;;IAKH;;OAEG;;IAKH;;OAEG;;IAKH;;OAEG;;0BAM4D,CAAC;AAEpE;;GAEG;AACH,eAAO,MAAM,sBAAsB;;;;;;;;;;;;EAMI,CAAC;AAExC;;GAEG;AACH,eAAO,MAAM,0BAA0B;;;;;;;;;;;;;;;;;;EAiBQ,CAAC;AAGhD,MAAM,MAAM,cAAc,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,oBAAoB,CAAC,CAAC;AAClE,MAAM,MAAM,QAAQ,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,cAAc,CAAC,CAAC;AACtD,MAAM,MAAM,eAAe,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,qBAAqB,CAAC,CAAC;AACpE,MAAM,MAAM,gBAAgB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,sBAAsB,CAAC,CAAC;AACtE,MAAM,MAAM,oBAAoB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,0BAA0B,CAAC,CAAC"}

package/dist/ibmi-mcp-server/schemas/common.js

@@ -0,0 +1,119 @@
+/**
+ * @fileoverview Common schema definitions and utilities
+ * Shared Zod schemas used across multiple modules in the IBM i MCP server
+ *
+ * @module src/ibmi-mcp-server/schemas/common
+ */
+import { z } from "zod";
+/**
+ * Response format options for SQL tools
+ */
+export const ResponseFormatSchema = z.enum(["json", "markdown"], {
+    description: "Response format for SQL tool output",
+});
+/**
+ * Common metadata schema for extensible objects
+ */
+export const MetadataSchema = z
+    .record(z.unknown())
+    .describe("Extensible metadata object for storing additional information");
+/**
+ * Tool annotation hints schema for MCP client behavior
+ */
+export const ToolAnnotationsSchema = z
+    .object({
+    /**
+     * An optional human-readable name for the tool, optimized for UI display.
+     */
+    title: z
+        .string()
+        .optional()
+        .describe("Human-readable tool title for UI display"),
+    /**
+     * A hint indicating that the tool does not modify any state.
+     */
+    readOnlyHint: z
+        .boolean()
+        .optional()
+        .describe("Indicates the tool performs read-only operations"),
+    /**
+     * A hint indicating that the tool may interact with external systems.
+     */
+    openWorldHint: z
+        .boolean()
+        .optional()
+        .describe("Indicates the tool interacts with external, unpredictable systems"),
+    /**
+     * Indicates that the tool has no side effects when called multiple times.
+     */
+    idempotentHint: z
+        .boolean()
+        .optional()
+        .describe("Indicates the tool produces consistent results for identical inputs"),
+    /**
+     * Indicates that the tool may produce destructive side effects.
+     */
+    destructiveHint: z
+        .boolean()
+        .optional()
+        .describe("Indicates the tool may perform destructive or irreversible operations"),
+    /**
+     * Domain classification for filtering and organization.
+     */
+    domain: z
+        .string()
+        .optional()
+        .describe("Domain classification for client-side filtering"),
+    /**
+     * Category classification for filtering and organization.
+     */
+    category: z
+        .string()
+        .optional()
+        .describe("Category classification for client-side filtering"),
+    /**
+     * Toolsets that the tool belongs to.
+     */
+    toolsets: z
+        .array(z.string())
+        .optional()
+        .describe("Toolset memberships for client-side grouping"),
+    /**
+     * Additional custom metadata.
+     */
+    customMetadata: MetadataSchema.optional().describe("Additional custom metadata for the tool"),
+})
+    .catchall(z.unknown())
+    .describe("Tool annotations providing hints about tool behavior");
+/**
+ * Column definition schema for database result sets
+ */
+export const ColumnDefinitionSchema = z
+    .object({
+    name: z.string().describe("Column name as returned by the database"),
+    type: z.string().optional().describe("Database reported data type"),
+    label: z.string().optional().describe("Human-friendly label if provided"),
+})
+    .describe("Database column metadata");
+/**
+ * Base parameter constraint schemas for reuse
+ */
+export const ParameterConstraintsSchema = z
+    .object({
+    min: z.number().optional().describe("Minimum value for numeric types"),
+    max: z.number().optional().describe("Maximum value for numeric types"),
+    minLength: z
+        .number()
+        .optional()
+        .describe("Minimum length for string/array types"),
+    maxLength: z
+        .number()
+        .optional()
+        .describe("Maximum length for string/array types"),
+    pattern: z
+        .string()
+        .optional()
+        .describe("Regex pattern for string validation"),
+})
+    .describe("Parameter validation constraints");
+//# sourceMappingURL=common.js.map

package/dist/ibmi-mcp-server/schemas/common.js.map

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