@alcyone-labs/arg-parser 2.3.0 → 2.4.0

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

@@ -1 +1 @@
-{"version":3,"file":"mcp-integration.d.ts","sourceRoot":"","sources":["../../src/mcp/mcp-integration.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAe,UAAU,EAAE,MAAM,KAAK,CAAC;AAEnD,OAAO,EAAE,aAAa,EAAE,MAAM,uBAAuB,CAAC;AACtD,OAAO,KAAK,EACV,KAAK,EAEL,aAAa,EACb,WAAW,EACZ,MAAM,eAAe,CAAC;AASvB;;GAEG;AACH,MAAM,WAAW,WAAW;IAC1B,OAAO,EAAE,KAAK,CAAC;QACb,IAAI,EAAE,MAAM,CAAC;QACb,IAAI,EAAE,MAAM,CAAC;KACd,CAAC,CAAC;IACH,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,iBAAiB,CAAC,EAAE,GAAG,CAAC;CACzB;AAED;;GAEG;AACH,wBAAgB,wBAAwB,CAAC,IAAI,EAAE,GAAG,GAAG,WAAW,CAS/D;AAED;;GAEG;AACH,wBAAgB,sBAAsB,CAAC,KAAK,EAAE,MAAM,GAAG,KAAK,GAAG,WAAW,CAazE;AAED;;GAEG;AACH,wBAAgB,+BAA+B,CAAC,IAAI,EAAE,KAAK,GAAG,aAAa,GAAG;IAC5E,QAAQ,EAAE,GAAG,CAAC;IACd,UAAU,EAAE,OAAO,CAAC;CACrB,CAkCA;AAED;;GAEG;AACH,wBAAgB,wBAAwB,CACtC,KAAK,EAAE,SAAS,CAAC,KAAK,GAAG,aAAa,CAAC,EAAE,GACxC;IACD,IAAI,EAAE,QAAQ,CAAC;IACf,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;IAChC,QAAQ,EAAE,MAAM,EAAE,CAAC;CACpB,CAuBA;AAED;;GAEG;AACH,wBAAgB,uBAAuB,CACrC,KAAK,EAAE,SAAS,CAAC,KAAK,GAAG,aAAa,CAAC,EAAE,GACxC,UAAU,CAcZ;AAED;;GAEG;AACH,MAAM,WAAW,sBAAsB;IACrC,OAAO,EAAE,OAAO,CAAC;IACjB,IAAI,CAAC,EAAE,GAAG,CAAC;IACX,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED;;GAEG;AACH,wBAAgB,yBAAyB,CACvC,WAAW,EAAE,GAAG,GACf,sBAAsB,CA+DxB;AAGD,MAAM,WAAW,iBAAiB;IAChC,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,WAAW,EAAE,UAAU,CAAC;IACxB,YAAY,CAAC,EAAE,UAAU,CAAC;IAC1B,OAAO,EAAE,CAAC,IAAI,EAAE,GAAG,KAAK,OAAO,CAAC,GAAG,CAAC,CAAC;IACrC,iBAAiB,CAAC,EAAE,CAAC,IAAI,EAAE,GAAG,KAAK,OAAO,CAAC,sBAAsB,CAAC,CAAC;CACpE;AAsID,MAAM,WAAW,uBAAuB;IACtC,eAAe,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,UAAU,CAAC,CAAC;IAC7C,mBAAmB,CAAC,EAAE,UAAU,CAAC;IACjC,uFAAuF;IACvF,wBAAwB,CAAC,EACrB,OAAO,GACP,MAAM,cAAc,eAAe,EAAE,oBAAoB,CAAC;IAC9D,gBAAgB,CAAC,EAAE,CAAC,WAAW,EAAE,MAAM,EAAE,EAAE,OAAO,CAAC,EAAE,MAAM,KAAK,MAAM,CAAC;IACvE,kBAAkB,CAAC,EAAE,OAAO,CAAC;IAC7B,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,cAAc,CAAC,EAAE,MAAM,CAAC;CACzB;AAED,UAAU,wBAAwB;IAChC,aAAa,CAAC,EAAE,MAAM,EAAE,CAAC;IACzB,MAAM,CAAC,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAC;QAAC,OAAO,CAAC,EAAE,GAAG,CAAA;KAAE,CAAC;IAC1D,eAAe,CAAC,EAAE,GAAG,CAAC;CACvB;AACD,MAAM,MAAM,qBAAqB,GAAG,WAAW,CAAC,aAAa,EAAE,CAAC,GAC9D,wBAAwB,CAAC;AAE3B,wBAAgB,6BAA6B,CAC3C,UAAU,EAAE,aAAa,EACzB,OAAO,CAAC,EAAE,uBAAuB,GAChC,iBAAiB,EAAE,CAgzBrB"}
+{"version":3,"file":"mcp-integration.d.ts","sourceRoot":"","sources":["../../src/mcp/mcp-integration.ts"],"names":[],"mappings":"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"}

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

@@ -0,0 +1,163 @@
+/**
+ * MCP Lifecycle Events System
+ *
+ * This module provides lifecycle event hooks for MCP servers, allowing applications
+ * to perform initialization, cleanup, and other lifecycle-related operations at
+ * specific points in the MCP protocol flow.
+ */
+/**
+ * Base context interface shared by all lifecycle events
+ */
+export interface McpLifecycleBaseContext {
+    /** Get a parsed flag value by name */
+    getFlag(name: string): any;
+    /** MCP logger instance for this context */
+    logger: any;
+    /** Server information */
+    serverInfo: {
+        name: string;
+        version: string;
+        description?: string;
+    };
+}
+/**
+ * Context provided during the MCP initialize request
+ * This is called when a client sends the "initialize" request
+ */
+export interface McpInitializeContext extends McpLifecycleBaseContext {
+    /** Client information from the initialize request */
+    clientInfo: {
+        name: string;
+        version: string;
+        title?: string;
+    };
+    /** Protocol version being used */
+    protocolVersion: string;
+    /** Client capabilities */
+    clientCapabilities: Record<string, any>;
+}
+/**
+ * Context provided after the MCP initialized notification
+ * This is called when a client sends the "initialized" notification
+ */
+export interface McpInitializedContext extends McpLifecycleBaseContext {
+    /** Client information from the previous initialize request */
+    clientInfo: {
+        name: string;
+        version: string;
+        title?: string;
+    };
+    /** Protocol version being used */
+    protocolVersion: string;
+}
+/**
+ * Context provided during server shutdown
+ * This is called when the MCP server is being shut down
+ */
+export interface McpShutdownContext extends McpLifecycleBaseContext {
+    /** Reason for shutdown */
+    reason: "client_disconnect" | "server_shutdown" | "error" | "signal";
+    /** Optional error if shutdown was due to an error */
+    error?: Error;
+}
+/**
+ * Lifecycle event handlers interface
+ */
+export interface McpLifecycleEvents {
+    /**
+     * Called when a client sends an "initialize" request
+     * This is the first lifecycle event and is ideal for:
+     * - Database connection setup
+     * - Resource initialization
+     * - Configuration validation
+     * - Authentication setup
+     */
+    onInitialize?: (context: McpInitializeContext) => Promise<void>;
+    /**
+     * Called when a client sends an "initialized" notification
+     * This indicates the client is ready for normal operations
+     * This is ideal for:
+     * - Final setup steps
+     * - Background task initialization
+     * - Health checks
+     */
+    onInitialized?: (context: McpInitializedContext) => Promise<void>;
+    /**
+     * Called when the MCP server is shutting down
+     * This is ideal for:
+     * - Database connection cleanup
+     * - Resource disposal
+     * - Graceful shutdown procedures
+     */
+    onShutdown?: (context: McpShutdownContext) => Promise<void>;
+}
+/**
+ * Internal state tracking for lifecycle events
+ */
+export interface McpLifecycleState {
+    /** Whether the initialize event has been called */
+    initialized: boolean;
+    /** Whether the initialized event has been called */
+    ready: boolean;
+    /** Whether shutdown has been initiated */
+    shuttingDown: boolean;
+    /** Stored client info from initialize */
+    clientInfo?: {
+        name: string;
+        version: string;
+        title?: string;
+    };
+    /** Protocol version being used */
+    protocolVersion?: string;
+    /** Client capabilities */
+    clientCapabilities?: Record<string, any>;
+}
+/**
+ * Lifecycle manager class for handling MCP lifecycle events
+ */
+export declare class McpLifecycleManager {
+    private events;
+    private logger;
+    private serverInfo;
+    private argParser?;
+    private state;
+    private parsedArgs;
+    constructor(events: McpLifecycleEvents, logger: any, serverInfo: {
+        name: string;
+        version: string;
+        description?: string;
+    }, argParser?: any | undefined);
+    /**
+     * Set the parsed arguments for flag access
+     */
+    setParsedArgs(parsedArgs: any): void;
+    /**
+     * Get a flag value from parsed arguments or environment variables
+     */
+    private getFlag;
+    /**
+     * Handle the initialize request
+     */
+    handleInitialize(clientInfo: {
+        name: string;
+        version: string;
+        title?: string;
+    }, protocolVersion: string, clientCapabilities: Record<string, any>): Promise<void>;
+    /**
+     * Handle the initialized notification
+     */
+    handleInitialized(): Promise<void>;
+    /**
+     * Handle server shutdown
+     */
+    handleShutdown(reason: "client_disconnect" | "server_shutdown" | "error" | "signal", error?: Error): Promise<void>;
+    /**
+     * Get current lifecycle state
+     */
+    getState(): Readonly<McpLifecycleState>;
+    /**
+     * Check if the server is ready for operations
+     */
+    isReady(): boolean;
+}
+//# sourceMappingURL=mcp-lifecycle.d.ts.map

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

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

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

@@ -0,0 +1,20 @@
+/**
+ * Utilities for MCP (Model Context Protocol) compatibility
+ */
+/**
+ * Sanitizes a tool name to comply with MCP naming requirements.
+ * MCP tool names must match the pattern: ^[a-zA-Z0-9_-]{1,64}$
+ *
+ * @param name The original tool name
+ * @returns A sanitized tool name that complies with MCP requirements
+ */
+export declare function sanitizeMcpToolName(name: string): string;
+/**
+ * Validates if a tool name complies with MCP naming requirements.
+ * MCP tool names must match the pattern: ^[a-zA-Z0-9_-]{1,64}$
+ *
+ * @param name The tool name to validate
+ * @returns True if the name is valid, false otherwise
+ */
+export declare function isValidMcpToolName(name: string): boolean;
+//# sourceMappingURL=mcp-utils.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"mcp-utils.d.ts","sourceRoot":"","sources":["../../src/mcp/mcp-utils.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH;;;;;;GAMG;AACH,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAmBxD;AAED;;;;;;GAMG;AACH,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAOxD"}

package/dist/mcp/zod-compatibility.d.ts

@@ -0,0 +1,74 @@
+/**
+ * Zod v3/v4 compatibility layer for MCP SDK integration
+ *
+ * The MCP SDK currently expects Zod v3 "raw shape" types for input schemas,
+ * but this project uses Zod v4. This module provides compatibility functions
+ * to convert Zod v4 schemas to formats that the MCP SDK can understand.
+ */
+import { type ZodObject, type ZodRawShape, type ZodTypeAny } from "zod";
+/**
+ * Type representing a Zod v3 compatible raw shape
+ */
+type ZodV3CompatibleShape = Record<string, ZodTypeAny>;
+/**
+ * Type representing what the MCP SDK expects for tool registration
+ */
+interface McpSdkCompatibleSchema {
+    shape?: ZodV3CompatibleShape;
+    _def?: any;
+    _zod?: any;
+    parse?: (input: any) => any;
+    safeParse?: (input: any) => any;
+}
+/**
+ * Converts a Zod v4 schema to a format compatible with the MCP SDK's expectations
+ * for Zod v3 raw shape types.
+ *
+ * @param zodSchema - The Zod v4 schema to convert
+ * @returns A schema format compatible with MCP SDK
+ */
+export declare function convertToMcpCompatibleSchema(zodSchema: ZodTypeAny): McpSdkCompatibleSchema;
+/**
+ * Creates an empty schema compatible with MCP SDK for tools with no parameters
+ */
+export declare function createEmptyMcpSchema(): McpSdkCompatibleSchema;
+/**
+ * Extracts the raw shape from a Zod v4 object schema in a way that's
+ * compatible with what MCP SDK expects from Zod v3.
+ *
+ * @param zodObjectSchema - A Zod object schema
+ * @returns The raw shape or empty object if extraction fails
+ */
+export declare function extractRawShape(zodObjectSchema: ZodObject<ZodRawShape>): ZodV3CompatibleShape;
+/**
+ * Checks if a schema is a Zod object schema
+ */
+export declare function isZodObjectSchema(schema: any): schema is ZodObject<ZodRawShape>;
+/**
+ * Converts Zod v4 schemas to the specific format expected by MCP SDK tool registration.
+ * This function handles the conversion for the server.registerTool() call.
+ *
+ * @param zodSchema - The Zod v4 schema to convert
+ * @returns A schema format that MCP SDK can work with
+ */
+export declare function prepareMcpToolSchema(zodSchema: ZodTypeAny): any;
+/**
+ * Simple approach: Create a clean copy of Zod schema without v4-specific properties
+ * This is a non-recursive version to avoid infinite loops
+ */
+export declare function createCleanZodSchema(zodSchema: ZodTypeAny): any;
+/**
+ * Convert a Zod schema to a JSON Schema object that the MCP SDK expects
+ * This is the correct approach - the MCP SDK expects JSON Schema, not Zod schemas
+ */
+export declare function zodToJsonSchema(zodSchema: ZodTypeAny): any;
+/**
+ * Debug function to log schema structure for troubleshooting
+ */
+export declare function debugSchemaStructure(schema: any, label?: string): void;
+/**
+ * Validates that a schema is compatible with MCP SDK expectations
+ */
+export declare function validateMcpSchemaCompatibility(schema: any): boolean;
+export {};
+//# sourceMappingURL=zod-compatibility.d.ts.map

package/dist/mcp/zod-compatibility.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"zod-compatibility.d.ts","sourceRoot":"","sources":["../../src/mcp/zod-compatibility.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EAAK,KAAK,SAAS,EAAE,KAAK,WAAW,EAAE,KAAK,UAAU,EAAE,MAAM,KAAK,CAAC;AAE3E;;GAEG;AACH,KAAK,oBAAoB,GAAG,MAAM,CAAC,MAAM,EAAE,UAAU,CAAC,CAAC;AAEvD;;GAEG;AACH,UAAU,sBAAsB;IAC9B,KAAK,CAAC,EAAE,oBAAoB,CAAC;IAC7B,IAAI,CAAC,EAAE,GAAG,CAAC;IACX,IAAI,CAAC,EAAE,GAAG,CAAC;IACX,KAAK,CAAC,EAAE,CAAC,KAAK,EAAE,GAAG,KAAK,GAAG,CAAC;IAC5B,SAAS,CAAC,EAAE,CAAC,KAAK,EAAE,GAAG,KAAK,GAAG,CAAC;CACjC;AAED;;;;;;GAMG;AACH,wBAAgB,4BAA4B,CAC1C,SAAS,EAAE,UAAU,GACpB,sBAAsB,CAwDxB;AAED;;GAEG;AACH,wBAAgB,oBAAoB,IAAI,sBAAsB,CAG7D;AAED;;;;;;GAMG;AACH,wBAAgB,eAAe,CAC7B,eAAe,EAAE,SAAS,CAAC,WAAW,CAAC,GACtC,oBAAoB,CA6CtB;AAED;;GAEG;AACH,wBAAgB,iBAAiB,CAC/B,MAAM,EAAE,GAAG,GACV,MAAM,IAAI,SAAS,CAAC,WAAW,CAAC,CAWlC;AAED;;;;;;GAMG;AACH,wBAAgB,oBAAoB,CAAC,SAAS,EAAE,UAAU,GAAG,GAAG,CA6G/D;AAED;;;GAGG;AACH,wBAAgB,oBAAoB,CAAC,SAAS,EAAE,UAAU,GAAG,GAAG,CA6C/D;AAED;;;GAGG;AACH,wBAAgB,eAAe,CAAC,SAAS,EAAE,UAAU,GAAG,GAAG,CA4D1D;AAED;;GAEG;AACH,wBAAgB,oBAAoB,CAClC,MAAM,EAAE,GAAG,EACX,KAAK,GAAE,MAAiB,GACvB,IAAI,CAgBN;AAED;;GAEG;AACH,wBAAgB,8BAA8B,CAAC,MAAM,EAAE,GAAG,GAAG,OAAO,CAiCnE"}

package/dist/utils/debug-utils.d.ts

@@ -0,0 +1,40 @@
+/**
+ * Debug utility for conditional logging based on environment variables
+ *
+ * This utility provides clean debug logging without scattered conditional statements.
+ * Debug output is controlled by the DEBUG environment variable.
+ */
+/**
+ * Debug logger that only outputs when DEBUG environment variable is set
+ */
+export declare const debug: {
+    /**
+     * Log a debug message to stderr (only when DEBUG=true)
+     */
+    log: (...args: any[]) => void;
+    /**
+     * Log an error debug message to stderr (only when DEBUG=true)
+     */
+    error: (...args: any[]) => void;
+    /**
+     * Log a warning debug message to stderr (only when DEBUG=true)
+     */
+    warn: (...args: any[]) => void;
+    /**
+     * Log an info debug message to stderr (only when DEBUG=true)
+     */
+    info: (...args: any[]) => void;
+    /**
+     * Log a debug message with a custom prefix (only when DEBUG=true)
+     */
+    prefixed: (prefix: string, ...args: any[]) => void;
+    /**
+     * Check if debug mode is currently enabled
+     */
+    readonly enabled: boolean;
+};
+/**
+ * Default export for convenience
+ */
+export default debug;
+//# sourceMappingURL=debug-utils.d.ts.map

package/dist/utils/debug-utils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"debug-utils.d.ts","sourceRoot":"","sources":["../../src/utils/debug-utils.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAeH;;GAEG;AACH,eAAO,MAAM,KAAK;IAChB;;OAEG;mBACY,GAAG,EAAE,KAAG,IAAI;IAM3B;;OAEG;qBACc,GAAG,EAAE,KAAG,IAAI;IAM7B;;OAEG;oBACa,GAAG,EAAE,KAAG,IAAI;IAM5B;;OAEG;oBACa,GAAG,EAAE,KAAG,IAAI;IAM5B;;OAEG;uBACgB,MAAM,WAAW,GAAG,EAAE,KAAG,IAAI;IAMhD;;OAEG;sBACY,OAAO;CAGvB,CAAC;AAEF;;GAEG;AACH,eAAe,KAAK,CAAC"}

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@alcyone-labs/arg-parser",
-  "version": "2.3.0",
-  "description": "A robust, type-safe command line argument parser with plugin architecture, dependency injection, Claude Desktop compliant MCP integration, autonomous DXT builds, and zero-dependency core functionality.",
+  "version": "2.4.0",
+  "description": "A robust, type-safe command line argument parser with plugin architecture, dependency injection, Claude Desktop compliant MCP integration, autonomous DXT builds, automatic CLI to MCP support.",
   "type": "module",
   "main": "dist/index.cjs",
   "module": "dist/index.mjs",
@@ -52,24 +52,25 @@
   },
   "dependencies": {
     "@alcyone-labs/simple-chalk": "^1.0.1",
-    "@alcyone-labs/simple-mcp-logger": "^1.1.0",
+    "@alcyone-labs/simple-mcp-logger": "^1.2.1",
+    "@modelcontextprotocol/sdk": "github:Alcyone-Labs/mcp-typescript-sdk#dist",
+    "get-tsconfig": "^4.10.1",
     "magic-regexp": "^0.10.0",
-    "zod": "^3.25.76"
+    "zod": "^4.0.10"
   },
   "optionalDependencies": {
-    "@modelcontextprotocol/sdk": "^1.15.1",
     "dotenv": "^16.6.1",
     "express": "^5.1.0",
     "js-yaml": "^4.1.0",
     "smol-toml": "^1.4.1",
-    "tsdown": "^0.12.9"
+    "tsdown": "^0.13.0"
   },
   "devDependencies": {
     "@ianvs/prettier-plugin-sort-imports": "^4.5.1",
     "@types/adm-zip": "^0.5.7",
     "@types/express": "^5.0.3",
     "@types/js-yaml": "^4.0.9",
-    "@types/node": "^22.16.3",
+    "@types/node": "^22.16.5",
     "cross-env": "^7.0.3",
     "madge": "^8.0.0",
     "prettier": "^3.6.2",