@ibm/ibmi-mcp-server 0.1.0

package/dist/services/supabase/supabaseClient.js

@@ -0,0 +1,68 @@
+/**
+ * @fileoverview Initializes and exports a singleton Supabase client instance.
+ * This module ensures that the Supabase client is initialized once and shared
+ * across the application, using credentials from the central configuration.
+ * It handles both the standard client and the admin client (using the service role key).
+ *
+ * @module src/services/supabase/supabaseClient
+ */
+import { createClient } from "@supabase/supabase-js";
+import { config } from "../../config/index.js";
+import { JsonRpcErrorCode, McpError } from "../../types-global/errors.js";
+import { logger, requestContextService } from "../../utils/index.js";
+let supabase = null;
+let supabaseAdmin = null;
+const initializeSupabase = () => {
+    const context = requestContextService.createRequestContext({
+        operation: "initializeSupabase",
+    });
+    if (config.supabase?.url && config.supabase?.anonKey) {
+        if (!supabase) {
+            supabase = createClient(config.supabase.url, config.supabase.anonKey, {
+                auth: {
+                    persistSession: false,
+                    autoRefreshToken: false,
+                },
+            });
+            logger.info(context, "Supabase client initialized.");
+        }
+        if (!supabaseAdmin && config.supabase.serviceRoleKey) {
+            supabaseAdmin = createClient(config.supabase.url, config.supabase.serviceRoleKey, {
+                auth: {
+                    persistSession: false,
+                    autoRefreshToken: false,
+                },
+            });
+            logger.info(context, "Supabase admin client initialized.");
+        }
+    }
+    else {
+        logger.warning(context, "Supabase URL or anon key is missing. Supabase clients not initialized.");
+    }
+};
+// Initialize on load
+initializeSupabase();
+/**
+ * Returns the singleton Supabase client instance.
+ * Throws an McpError if the client is not initialized.
+ * @returns The Supabase client.
+ */
+export const getSupabaseClient = () => {
+    if (!supabase) {
+        throw new McpError(JsonRpcErrorCode.ServiceUnavailable, "Supabase client has not been initialized. Please check your SUPABASE_URL and SUPABASE_ANON_KEY environment variables.");
+    }
+    return supabase;
+};
+/**
+ * Returns the singleton Supabase admin client instance.
+ * This client uses the service role key and bypasses RLS.
+ * Throws an McpError if the admin client is not initialized.
+ * @returns The Supabase admin client.
+ */
+export const getSupabaseAdminClient = () => {
+    if (!supabaseAdmin) {
+        throw new McpError(JsonRpcErrorCode.ServiceUnavailable, "Supabase admin client has not been initialized. Please check your SUPABASE_SERVICE_ROLE_KEY environment variable.");
+    }
+    return supabaseAdmin;
+};
+//# sourceMappingURL=supabaseClient.js.map

package/dist/services/supabase/supabaseClient.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"supabaseClient.js","sourceRoot":"","sources":["../../../src/services/supabase/supabaseClient.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,EAAE,YAAY,EAAkB,MAAM,uBAAuB,CAAC;AACrE,OAAO,EAAE,MAAM,EAAE,MAAM,mBAAmB,CAAC;AAC3C,OAAO,EAAE,gBAAgB,EAAE,QAAQ,EAAE,MAAM,0BAA0B,CAAC;AACtE,OAAO,EAAE,MAAM,EAAE,qBAAqB,EAAE,MAAM,kBAAkB,CAAC;AAMjE,IAAI,QAAQ,GAAoC,IAAI,CAAC;AACrD,IAAI,aAAa,GAAoC,IAAI,CAAC;AAE1D,MAAM,kBAAkB,GAAG,GAAG,EAAE;IAC9B,MAAM,OAAO,GAAG,qBAAqB,CAAC,oBAAoB,CAAC;QACzD,SAAS,EAAE,oBAAoB;KAChC,CAAC,CAAC;IAEH,IAAI,MAAM,CAAC,QAAQ,EAAE,GAAG,IAAI,MAAM,CAAC,QAAQ,EAAE,OAAO,EAAE,CAAC;QACrD,IAAI,CAAC,QAAQ,EAAE,CAAC;YACd,QAAQ,GAAG,YAAY,CACrB,MAAM,CAAC,QAAQ,CAAC,GAAG,EACnB,MAAM,CAAC,QAAQ,CAAC,OAAO,EACvB;gBACE,IAAI,EAAE;oBACJ,cAAc,EAAE,KAAK;oBACrB,gBAAgB,EAAE,KAAK;iBACxB;aACF,CACF,CAAC;YACF,MAAM,CAAC,IAAI,CAAC,OAAO,EAAE,8BAA8B,CAAC,CAAC;QACvD,CAAC;QAED,IAAI,CAAC,aAAa,IAAI,MAAM,CAAC,QAAQ,CAAC,cAAc,EAAE,CAAC;YACrD,aAAa,GAAG,YAAY,CAC1B,MAAM,CAAC,QAAQ,CAAC,GAAG,EACnB,MAAM,CAAC,QAAQ,CAAC,cAAc,EAC9B;gBACE,IAAI,EAAE;oBACJ,cAAc,EAAE,KAAK;oBACrB,gBAAgB,EAAE,KAAK;iBACxB;aACF,CACF,CAAC;YACF,MAAM,CAAC,IAAI,CAAC,OAAO,EAAE,oCAAoC,CAAC,CAAC;QAC7D,CAAC;IACH,CAAC;SAAM,CAAC;QACN,MAAM,CAAC,OAAO,CACZ,OAAO,EACP,wEAAwE,CACzE,CAAC;IACJ,CAAC;AACH,CAAC,CAAC;AAEF,qBAAqB;AACrB,kBAAkB,EAAE,CAAC;AAErB;;;;GAIG;AACH,MAAM,CAAC,MAAM,iBAAiB,GAAG,GAA6B,EAAE;IAC9D,IAAI,CAAC,QAAQ,EAAE,CAAC;QACd,MAAM,IAAI,QAAQ,CAChB,gBAAgB,CAAC,kBAAkB,EACnC,uHAAuH,CACxH,CAAC;IACJ,CAAC;IACD,OAAO,QAAQ,CAAC;AAClB,CAAC,CAAC;AAEF;;;;;GAKG;AACH,MAAM,CAAC,MAAM,sBAAsB,GAAG,GAA6B,EAAE;IACnE,IAAI,CAAC,aAAa,EAAE,CAAC;QACnB,MAAM,IAAI,QAAQ,CAChB,gBAAgB,CAAC,kBAAkB,EACnC,mHAAmH,CACpH,CAAC;IACJ,CAAC;IACD,OAAO,aAAa,CAAC;AACvB,CAAC,CAAC"}

package/dist/storage/duckdbExample.d.ts

@@ -0,0 +1,8 @@
+/**
+ * @fileoverview Example script to demonstrate usage of the DuckDBService.
+ * Creates a sample database, table, inserts data, queries it, and logs results.
+ * Database files will be stored in the './duckdata/' directory.
+ * @module storage/duckdbExample
+ */
+export {};
+//# sourceMappingURL=duckdbExample.d.ts.map

package/dist/storage/duckdbExample.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"duckdbExample.d.ts","sourceRoot":"","sources":["../../src/storage/duckdbExample.ts"],"names":[],"mappings":"AAAA;;;;;GAKG"}

package/dist/storage/duckdbExample.js

@@ -0,0 +1,197 @@
+/**
+ * @fileoverview Example script to demonstrate usage of the DuckDBService.
+ * Creates a sample database, table, inserts data, queries it, and logs results.
+ * Database files will be stored in the './duckdata/' directory.
+ * @module storage/duckdbExample
+ */
+import * as fs from "fs";
+import * as path from "path";
+import { DuckDBService } from "../services/duck-db/duckDBService.js";
+import { JsonRpcErrorCode } from "../types-global/errors.js";
+import { ErrorHandler, idGenerator, // Added idGenerator import
+logger, requestContextService, } from "../utils/index.js";
+const DUCKDB_DATA_DIR = path.resolve(process.cwd(), "duckdata");
+const DUCKDB_FILE_PATH = path.join(DUCKDB_DATA_DIR, "example.db");
+/**
+ * Ensures that the directory for storing DuckDB files exists.
+ * @param {RequestContext} context - The request context for logging.
+ */
+function ensureDataDirectoryExists(context) {
+    if (!fs.existsSync(DUCKDB_DATA_DIR)) {
+        logger.info(context, `Data directory ${DUCKDB_DATA_DIR} does not exist. Creating...`);
+        try {
+            fs.mkdirSync(DUCKDB_DATA_DIR, { recursive: true });
+            logger.info(context, `Data directory ${DUCKDB_DATA_DIR} created.`);
+        }
+        catch (error) {
+            logger.error({
+                error: error,
+                ...context,
+            }, `Failed to create data directory ${DUCKDB_DATA_DIR}`);
+            // Re-throw as a critical error if directory creation fails
+            throw new Error(`Could not create DuckDB data directory: ${error instanceof Error ? error.message : String(error)}`);
+        }
+    }
+    else {
+        logger.debug(context, `Data directory ${DUCKDB_DATA_DIR} already exists.`);
+    }
+    // Ensure a fresh database file for the example by deleting it if it exists.
+    // This allows launchConfig settings like custom_user_agent to be applied on each run.
+    if (fs.existsSync(DUCKDB_FILE_PATH)) {
+        logger.info(context, `Existing DuckDB file ${DUCKDB_FILE_PATH} found. Deleting for a fresh example run...`);
+        try {
+            fs.unlinkSync(DUCKDB_FILE_PATH);
+            logger.info(context, `Successfully deleted ${DUCKDB_FILE_PATH}.`);
+        }
+        catch (error) {
+            logger.error({ error: error, ...context }, `Failed to delete existing DuckDB file ${DUCKDB_FILE_PATH}`);
+            // Re-throw as a critical error if deletion fails, as it will likely cause subsequent errors
+            throw new Error(`Could not delete existing DuckDB file: ${error instanceof Error ? error.message : String(error)}`);
+        }
+    }
+}
+async function runDuckDBExample() {
+    const operation = "runDuckDBExample";
+    const context = requestContextService.createRequestContext({ operation });
+    logger.notice(context, "Starting DuckDB example script...");
+    ensureDataDirectoryExists(context);
+    const service = new DuckDBService();
+    const config = {
+        dbPath: DUCKDB_FILE_PATH,
+        extensions: ["json"], // Example: include an extension
+        launchConfig: { custom_user_agent: "DuckDBExampleScript/1.0" },
+    };
+    try {
+        logger.info(context, `Initializing DuckDBService with path: ${config.dbPath}`);
+        await service.initialize(config);
+        logger.info(context, "DuckDBService initialized.");
+        // Create a table
+        const createTableSql = `
+      CREATE TABLE IF NOT EXISTS users (
+        id VARCHAR(6) PRIMARY KEY,
+        name VARCHAR NOT NULL,
+        email VARCHAR,
+        createdAt TIMESTAMP DEFAULT current_timestamp
+      );
+    `;
+        logger.info({
+            ...context,
+            sql: createTableSql,
+        }, "Creating 'users' table...");
+        await service.run(createTableSql);
+        logger.info(context, "'users' table created or already exists.");
+        // Insert data
+        const usersToInsert = [
+            { name: "Alice Wonderland", email: "alice@example.com" },
+            { name: "Bob The Builder", email: "bob@example.com" },
+            { name: "Charlie Chaplin", email: "charlie@example.com" },
+        ].map((user) => ({
+            id: idGenerator.generateRandomString(6), // Generate 6-digit alphanumeric ID directly
+            ...user,
+        }));
+        logger.info({
+            ...context,
+            users: usersToInsert.length,
+        }, "Inserting data into 'users' table...");
+        for (const user of usersToInsert) {
+            // Check if user already exists to prevent primary key constraint errors on re-runs
+            const existingUser = await service.query("SELECT id FROM users WHERE id = ?", [user.id]);
+            if (existingUser.rowCount === 0) {
+                await service.run("INSERT INTO users (id, name, email) VALUES (?, ?, ?)", [user.id, user.name, user.email]);
+                logger.debug(context, `Inserted user with ID: ${user.id}`);
+            }
+            else {
+                logger.debug(context, `User with ID: ${user.id} already exists. Skipping insertion.`);
+            }
+        }
+        logger.info(context, "Data insertion complete.");
+        // Query data
+        const querySql = "SELECT id, name, email, createdAt FROM users ORDER BY id;";
+        logger.info({ ...context, sql: querySql }, "Querying 'users' table...");
+        const result = await service.query(querySql);
+        logger.notice({
+            ...context,
+            rowCount: result.rowCount,
+            columnNames: result.columnNames,
+        }, "Query Results:");
+        result.rows.forEach((row, index) => {
+            logger.info({ ...context, rowData: row }, `Row ${index + 1}:`);
+        });
+        // Example of using an extension function (json)
+        // Use the ID of the first inserted user for the query
+        if (usersToInsert.length > 0) {
+            const firstUser = usersToInsert[0];
+            if (!firstUser) {
+                logger.warning(context, "Could not get the first user for JSON query example.");
+                return;
+            }
+            const firstUserId = firstUser.id;
+            const jsonQuerySql = "SELECT json_object('id', id, 'name', name, 'email', email) AS user_json FROM users WHERE id = ?;"; // Added email to json_object
+            logger.info({
+                ...context,
+                sql: jsonQuerySql,
+                userId: firstUserId,
+            }, "Querying with JSON extension function for a specific user...");
+            const jsonResult = await service.query(jsonQuerySql, [firstUserId]);
+            if (jsonResult.rowCount > 0) {
+                logger.info({
+                    ...context,
+                    jsonData: jsonResult.rows[0],
+                }, "JSON Query Result:");
+            }
+            else {
+                logger.warning(context, `Could not find user with ID ${firstUserId} for JSON query example.`); // Changed warn to warning
+            }
+        }
+        else {
+            logger.info(context, "Skipping JSON query example as no users were inserted.");
+        }
+    }
+    catch (error) {
+        // ErrorHandler.tryCatch is used within the service, so errors should be McpError
+        // If an error occurs outside service calls (e.g. directory creation), it might be a standard Error
+        logger.error({
+            error: error,
+            ...context,
+            isMcpError: error instanceof Object && "errorCode" in error, // Basic check
+        }, "An error occurred in the DuckDB example script");
+    }
+    finally {
+        logger.info(context, "Closing DuckDBService...");
+        // Wrap close in its own tryCatch as it might also throw
+        try {
+            await service.close();
+            logger.info(context, "DuckDBService closed.");
+        }
+        catch (closeError) {
+            logger.error({
+                error: closeError,
+                ...context,
+            }, "Failed to close DuckDBService");
+        }
+    }
+    logger.notice(context, "DuckDB example script finished.");
+}
+// Self-executing async function
+(async () => {
+    // Setup a global error handler for unhandled rejections or exceptions
+    // specific to this script's execution context.
+    const scriptContext = requestContextService.createRequestContext({
+        operation: "DuckDBExampleScript.main",
+    });
+    try {
+        await ErrorHandler.tryCatch(runDuckDBExample, {
+            operation: "runDuckDBExample.mainExecution",
+            context: scriptContext,
+            errorCode: JsonRpcErrorCode.InternalError, // Changed from SCRIPT_EXECUTION_ERROR
+            critical: true, // If the main example fails, it's critical for the script
+        });
+    }
+    catch (e) {
+        // This catch is for errors that ErrorHandler.tryCatch itself might rethrow
+        // or if ErrorHandler is bypassed.
+        logger.crit({ error: e, ...scriptContext }, "Unhandled critical error in DuckDB example script execution.");
+        process.exit(1); // Exit with error code
+    }
+})();
+//# sourceMappingURL=duckdbExample.js.map

package/dist/storage/duckdbExample.js.map

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

package/dist/types-global/errors.d.ts

@@ -0,0 +1,101 @@
+/**
+ * @fileoverview Defines standardized error codes, a custom error class, and related schemas
+ * for handling errors within the Model Context Protocol (MCP) server and its components.
+ * This module provides a structured way to represent and communicate errors, ensuring
+ * consistency and clarity for both server-side operations and client-side error handling.
+ * @module src/types-global/errors
+ */
+import { z } from "zod";
+/**
+ * Defines JSON-RPC 2.0 error codes, including standard and implementation-defined codes.
+ * @see https://www.jsonrpc.org/specification#error_object
+ */
+export declare enum JsonRpcErrorCode {
+    ParseError = -32700,
+    InvalidRequest = -32600,
+    MethodNotFound = -32601,
+    InvalidParams = -32602,
+    InternalError = -32603,
+    ServiceUnavailable = -32000,
+    NotFound = -32001,
+    Conflict = -32002,
+    RateLimited = -32003,
+    Timeout = -32004,
+    Forbidden = -32005,
+    Unauthorized = -32006,
+    ValidationError = -32007,
+    ConfigurationError = -32008,
+    InitializationFailed = -32009,
+    DatabaseError = -32010,
+    UnknownError = -32099
+}
+/**
+ * Custom error class for MCP-specific errors, extending the built-in `Error` class.
+ * It standardizes error reporting by encapsulating a `JsonRpcErrorCode`, a descriptive
+ * human-readable message, and optional structured details for more context.
+ *
+ * This class is central to error handling within the MCP framework, allowing for
+ * consistent error creation and propagation.
+ */
+export declare class McpError extends Error {
+    /**
+     * The standardized error code from {@link JsonRpcErrorCode}.
+     */
+    code: JsonRpcErrorCode;
+    /**
+     * Optional additional details or context about the error.
+     * This can be any structured data that helps in understanding or debugging the error.
+     */
+    readonly details?: Record<string, unknown>;
+    /**
+     * Creates an instance of McpError.
+     *
+     * @param code - The standardized error code that categorizes the error.
+     * @param message - A human-readable description of the error.
+     * @param details - Optional. A record containing additional structured details about the error.
+     */
+    constructor(code: JsonRpcErrorCode, message: string, details?: Record<string, unknown>, options?: {
+        cause?: unknown;
+    });
+}
+/**
+ * Zod schema for validating error objects. This schema can be used for:
+ * - Validating error structures when parsing error responses from external services.
+ * - Ensuring consistency when creating or handling error objects internally.
+ * - Generating TypeScript types for error objects.
+ *
+ * The schema enforces the presence of a `code` (from {@link JsonRpcErrorCode}) and a `message`,
+ * and allows for optional `details`.
+ */
+export declare const ErrorSchema: z.ZodObject<{
+    /**
+     * The error code, corresponding to one of the {@link JsonRpcErrorCode} enum values.
+     * This field is required and helps in programmatically identifying the error type.
+     */
+    code: z.ZodNativeEnum<typeof JsonRpcErrorCode>;
+    /**
+     * A human-readable, descriptive message explaining the error.
+     * This field is required and provides context to developers or users.
+     */
+    message: z.ZodString;
+    /**
+     * Optional. A record containing additional structured details or context about the error.
+     * This can include things like invalid field names, specific values that caused issues, or other relevant data.
+     */
+    details: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+}, "strip", z.ZodTypeAny, {
+    code: JsonRpcErrorCode;
+    message: string;
+    details?: Record<string, unknown> | undefined;
+}, {
+    code: JsonRpcErrorCode;
+    message: string;
+    details?: Record<string, unknown> | undefined;
+}>;
+/**
+ * TypeScript type inferred from the {@link ErrorSchema}.
+ * This type represents the structure of a validated error object, commonly used
+ * for error responses or when passing error information within the application.
+ */
+export type ErrorResponse = z.infer<typeof ErrorSchema>;
+//# sourceMappingURL=errors.d.ts.map

package/dist/types-global/errors.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../../src/types-global/errors.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB;;;GAGG;AACH,oBAAY,gBAAgB;IAE1B,UAAU,SAAS;IACnB,cAAc,SAAS;IACvB,cAAc,SAAS;IACvB,aAAa,SAAS;IACtB,aAAa,SAAS;IAGtB,kBAAkB,SAAS;IAC3B,QAAQ,SAAS;IACjB,QAAQ,SAAS;IACjB,WAAW,SAAS;IACpB,OAAO,SAAS;IAChB,SAAS,SAAS;IAClB,YAAY,SAAS;IACrB,eAAe,SAAS;IACxB,kBAAkB,SAAS;IAC3B,oBAAoB,SAAS;IAC7B,aAAa,SAAS;IACtB,YAAY,SAAS;CACtB;AAED;;;;;;;GAOG;AACH,qBAAa,QAAS,SAAQ,KAAK;IACjC;;OAEG;IACI,IAAI,EAAE,gBAAgB,CAAC;IAE9B;;;OAGG;IACH,SAAgB,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAElD;;;;;;OAMG;gBAED,IAAI,EAAE,gBAAgB,EACtB,OAAO,EAAE,MAAM,EACf,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EACjC,OAAO,CAAC,EAAE;QAAE,KAAK,CAAC,EAAE,OAAO,CAAA;KAAE;CAgBhC;AAED;;;;;;;;GAQG;AACH,eAAO,MAAM,WAAW;IAEpB;;;OAGG;;IAIH;;;OAGG;;IAKH;;;OAGG;;;;;;;;;;EAUJ,CAAC;AAEJ;;;;GAIG;AACH,MAAM,MAAM,aAAa,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,WAAW,CAAC,CAAC"}

package/dist/types-global/errors.js

@@ -0,0 +1,109 @@
+/**
+ * @fileoverview Defines standardized error codes, a custom error class, and related schemas
+ * for handling errors within the Model Context Protocol (MCP) server and its components.
+ * This module provides a structured way to represent and communicate errors, ensuring
+ * consistency and clarity for both server-side operations and client-side error handling.
+ * @module src/types-global/errors
+ */
+import { z } from "zod";
+/**
+ * Defines JSON-RPC 2.0 error codes, including standard and implementation-defined codes.
+ * @see https://www.jsonrpc.org/specification#error_object
+ */
+export var JsonRpcErrorCode;
+(function (JsonRpcErrorCode) {
+    // Standard JSON-RPC 2.0 Errors
+    JsonRpcErrorCode[JsonRpcErrorCode["ParseError"] = -32700] = "ParseError";
+    JsonRpcErrorCode[JsonRpcErrorCode["InvalidRequest"] = -32600] = "InvalidRequest";
+    JsonRpcErrorCode[JsonRpcErrorCode["MethodNotFound"] = -32601] = "MethodNotFound";
+    JsonRpcErrorCode[JsonRpcErrorCode["InvalidParams"] = -32602] = "InvalidParams";
+    JsonRpcErrorCode[JsonRpcErrorCode["InternalError"] = -32603] = "InternalError";
+    // Implementation-defined server-errors (-32000 to -32099)
+    JsonRpcErrorCode[JsonRpcErrorCode["ServiceUnavailable"] = -32000] = "ServiceUnavailable";
+    JsonRpcErrorCode[JsonRpcErrorCode["NotFound"] = -32001] = "NotFound";
+    JsonRpcErrorCode[JsonRpcErrorCode["Conflict"] = -32002] = "Conflict";
+    JsonRpcErrorCode[JsonRpcErrorCode["RateLimited"] = -32003] = "RateLimited";
+    JsonRpcErrorCode[JsonRpcErrorCode["Timeout"] = -32004] = "Timeout";
+    JsonRpcErrorCode[JsonRpcErrorCode["Forbidden"] = -32005] = "Forbidden";
+    JsonRpcErrorCode[JsonRpcErrorCode["Unauthorized"] = -32006] = "Unauthorized";
+    JsonRpcErrorCode[JsonRpcErrorCode["ValidationError"] = -32007] = "ValidationError";
+    JsonRpcErrorCode[JsonRpcErrorCode["ConfigurationError"] = -32008] = "ConfigurationError";
+    JsonRpcErrorCode[JsonRpcErrorCode["InitializationFailed"] = -32009] = "InitializationFailed";
+    JsonRpcErrorCode[JsonRpcErrorCode["DatabaseError"] = -32010] = "DatabaseError";
+    JsonRpcErrorCode[JsonRpcErrorCode["UnknownError"] = -32099] = "UnknownError";
+})(JsonRpcErrorCode || (JsonRpcErrorCode = {}));
+/**
+ * Custom error class for MCP-specific errors, extending the built-in `Error` class.
+ * It standardizes error reporting by encapsulating a `JsonRpcErrorCode`, a descriptive
+ * human-readable message, and optional structured details for more context.
+ *
+ * This class is central to error handling within the MCP framework, allowing for
+ * consistent error creation and propagation.
+ */
+export class McpError extends Error {
+    /**
+     * The standardized error code from {@link JsonRpcErrorCode}.
+     */
+    code;
+    /**
+     * Optional additional details or context about the error.
+     * This can be any structured data that helps in understanding or debugging the error.
+     */
+    details;
+    /**
+     * Creates an instance of McpError.
+     *
+     * @param code - The standardized error code that categorizes the error.
+     * @param message - A human-readable description of the error.
+     * @param details - Optional. A record containing additional structured details about the error.
+     */
+    constructor(code, message, details, options) {
+        super(message, options);
+        this.code = code;
+        this.details = details;
+        this.name = "McpError";
+        // Maintain a proper prototype chain.
+        Object.setPrototypeOf(this, McpError.prototype);
+        // Capture the stack trace, excluding the constructor call from it, if available.
+        if (Error.captureStackTrace) {
+            Error.captureStackTrace(this, McpError);
+        }
+    }
+}
+/**
+ * Zod schema for validating error objects. This schema can be used for:
+ * - Validating error structures when parsing error responses from external services.
+ * - Ensuring consistency when creating or handling error objects internally.
+ * - Generating TypeScript types for error objects.
+ *
+ * The schema enforces the presence of a `code` (from {@link JsonRpcErrorCode}) and a `message`,
+ * and allows for optional `details`.
+ */
+export const ErrorSchema = z
+    .object({
+    /**
+     * The error code, corresponding to one of the {@link JsonRpcErrorCode} enum values.
+     * This field is required and helps in programmatically identifying the error type.
+     */
+    code: z
+        .nativeEnum(JsonRpcErrorCode)
+        .describe("Standardized error code from JsonRpcErrorCode enum"),
+    /**
+     * A human-readable, descriptive message explaining the error.
+     * This field is required and provides context to developers or users.
+     */
+    message: z
+        .string()
+        .min(1, "Error message cannot be empty.")
+        .describe("Detailed human-readable error message"),
+    /**
+     * Optional. A record containing additional structured details or context about the error.
+     * This can include things like invalid field names, specific values that caused issues, or other relevant data.
+     */
+    details: z
+        .record(z.unknown())
+        .optional()
+        .describe("Optional structured details providing more context about the error"),
+})
+    .describe("Schema for validating structured error objects, ensuring consistency in error reporting.");
+//# sourceMappingURL=errors.js.map

package/dist/types-global/errors.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.js","sourceRoot":"","sources":["../../src/types-global/errors.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB;;;GAGG;AACH,MAAM,CAAN,IAAY,gBAqBX;AArBD,WAAY,gBAAgB;IAC1B,+BAA+B;IAC/B,wEAAmB,CAAA;IACnB,gFAAuB,CAAA;IACvB,gFAAuB,CAAA;IACvB,8EAAsB,CAAA;IACtB,8EAAsB,CAAA;IAEtB,0DAA0D;IAC1D,wFAA2B,CAAA;IAC3B,oEAAiB,CAAA;IACjB,oEAAiB,CAAA;IACjB,0EAAoB,CAAA;IACpB,kEAAgB,CAAA;IAChB,sEAAkB,CAAA;IAClB,4EAAqB,CAAA;IACrB,kFAAwB,CAAA;IACxB,wFAA2B,CAAA;IAC3B,4FAA6B,CAAA;IAC7B,8EAAsB,CAAA;IACtB,4EAAqB,CAAA;AACvB,CAAC,EArBW,gBAAgB,KAAhB,gBAAgB,QAqB3B;AAED;;;;;;;GAOG;AACH,MAAM,OAAO,QAAS,SAAQ,KAAK;IACjC;;OAEG;IACI,IAAI,CAAmB;IAE9B;;;OAGG;IACa,OAAO,CAA2B;IAElD;;;;;;OAMG;IACH,YACE,IAAsB,EACtB,OAAe,EACf,OAAiC,EACjC,OAA6B;QAE7B,KAAK,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC;QAExB,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC;QACjB,IAAI,CAAC,OAAO,GAAG,OAAO,CAAC;QACvB,IAAI,CAAC,IAAI,GAAG,UAAU,CAAC;QAEvB,qCAAqC;QACrC,MAAM,CAAC,cAAc,CAAC,IAAI,EAAE,QAAQ,CAAC,SAAS,CAAC,CAAC;QAEhD,iFAAiF;QACjF,IAAI,KAAK,CAAC,iBAAiB,EAAE,CAAC;YAC5B,KAAK,CAAC,iBAAiB,CAAC,IAAI,EAAE,QAAQ,CAAC,CAAC;QAC1C,CAAC;IACH,CAAC;CACF;AAED;;;;;;;;GAQG;AACH,MAAM,CAAC,MAAM,WAAW,GAAG,CAAC;KACzB,MAAM,CAAC;IACN;;;OAGG;IACH,IAAI,EAAE,CAAC;SACJ,UAAU,CAAC,gBAAgB,CAAC;SAC5B,QAAQ,CAAC,oDAAoD,CAAC;IACjE;;;OAGG;IACH,OAAO,EAAE,CAAC;SACP,MAAM,EAAE;SACR,GAAG,CAAC,CAAC,EAAE,gCAAgC,CAAC;SACxC,QAAQ,CAAC,uCAAuC,CAAC;IACpD;;;OAGG;IACH,OAAO,EAAE,CAAC;SACP,MAAM,CAAC,CAAC,CAAC,OAAO,EAAE,CAAC;SACnB,QAAQ,EAAE;SACV,QAAQ,CACP,oEAAoE,CACrE;CACJ,CAAC;KACD,QAAQ,CACP,0FAA0F,CAC3F,CAAC"}

package/dist/utils/formatting/index.d.ts

@@ -0,0 +1,10 @@
+/**
+ * @fileoverview Barrel file for formatting utility modules.
+ * This file re-exports utilities for building structured output formats including
+ * markdown, tables, diffs, and tree structures.
+ * @module utils/formatting
+ */
+export { MarkdownBuilder, markdown } from "./markdownBuilder.js";
+export { tableFormatter, TableFormatter, type TableFormatterOptions, type TableStyle, type Alignment, type TableFormattingResult, } from "./tableFormatter.js";
+export { getColumnAlignment, formatColumnHeader, buildColumnAlignmentMap, } from "./sqlFormattingUtils.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/utils/formatting/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/utils/formatting/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,eAAe,EAAE,QAAQ,EAAE,MAAM,sBAAsB,CAAC;AACjE,OAAO,EACL,cAAc,EACd,cAAc,EACd,KAAK,qBAAqB,EAC1B,KAAK,UAAU,EACf,KAAK,SAAS,EACd,KAAK,qBAAqB,GAC3B,MAAM,qBAAqB,CAAC;AAC7B,OAAO,EACL,kBAAkB,EAClB,kBAAkB,EAClB,uBAAuB,GACxB,MAAM,yBAAyB,CAAC"}

package/dist/utils/formatting/index.js

@@ -0,0 +1,10 @@
+/**
+ * @fileoverview Barrel file for formatting utility modules.
+ * This file re-exports utilities for building structured output formats including
+ * markdown, tables, diffs, and tree structures.
+ * @module utils/formatting
+ */
+export { MarkdownBuilder, markdown } from "./markdownBuilder.js";
+export { tableFormatter, TableFormatter, } from "./tableFormatter.js";
+export { getColumnAlignment, formatColumnHeader, buildColumnAlignmentMap, } from "./sqlFormattingUtils.js";
+//# sourceMappingURL=index.js.map

package/dist/utils/formatting/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/utils/formatting/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,eAAe,EAAE,QAAQ,EAAE,MAAM,sBAAsB,CAAC;AACjE,OAAO,EACL,cAAc,EACd,cAAc,GAKf,MAAM,qBAAqB,CAAC;AAC7B,OAAO,EACL,kBAAkB,EAClB,kBAAkB,EAClB,uBAAuB,GACxB,MAAM,yBAAyB,CAAC"}