@alcyone-labs/arg-parser 1.2.0 → 2.0.0

package/dist/src/{ArgParserBase.d.ts → core/ArgParserBase.d.ts}

@@ -1,4 +1,7 @@
-import type { IFlag, IHandlerContext, ISubCommand, ProcessedFlag, TParsedArgs } from "./types";
+import type { IFlag, IHandlerContext, ISubCommand, ProcessedFlag, TParsedArgs, ParseResult } from "./types";
+import { McpResourcesManager, McpResourceConfig } from "../mcp/mcp-resources.js";
+import { McpPromptsManager, McpPromptConfig } from "../mcp/mcp-prompts.js";
+import { McpNotificationsManager, McpChangeType } from "../mcp/mcp-notifications.js";
 export declare class ArgParserError extends Error {
     cmdChain: string[];
     commandChain: string[];
@@ -52,6 +55,13 @@ export interface IArgParserParams<THandlerReturn = any> {
      * @default true
      */
     handleErrors?: boolean;
+    /**
+     * Whether to automatically call process.exit() based on ParseResult.
+     * When true (default), maintains backward compatibility with CLI behavior.
+     * When false, returns ParseResult objects for programmatic use.
+     * @default true
+     */
+    autoExit?: boolean;
     /**
      * The command name to display in help suggestions (e.g., 'dabl').
      * If not provided, it falls back to guessing from the script path.
@@ -65,7 +75,7 @@ export interface IArgParserParams<THandlerReturn = any> {
      */
     inheritParentFlags?: boolean;
 }
-interface IParseOptions {
+export interface IParseOptions {
     /**
      * When true, skips help flag processing (doesn't exit or show help)
      * @default false
@@ -76,6 +86,12 @@ interface IParseOptions {
      * @default false
      */
     skipHandlers?: boolean;
+    /**
+     * When true (default), automatically awaits async handlers before returning.
+     * When false, returns immediately with _asyncHandlerPromise for manual handling.
+     * @default true
+     */
+    deep?: boolean;
 }
 type TParsedArgsWithRouting<T = any> = T & {
     $commandChain?: string[];
@@ -93,6 +109,12 @@ export declare class ArgParserBase<THandlerReturn = any> {
     getAppCommandName(): string | undefined;
     getSubCommandName(): string;
     getDescription(): string | undefined;
+    getAutoExit(): boolean;
+    /**
+     * Helper method to handle exit logic based on autoExit setting
+     * Returns a ParseResult instead of calling process.exit() when autoExit is false
+     */
+    private _handleExit;
     getHandler(): ((ctx: IHandlerContext) => void) | undefined;
     getSubCommands(): Map<string, ISubCommand>;
     private _addToOutput;
@@ -109,7 +131,14 @@ export declare class ArgParserBase<THandlerReturn = any> {
      */
     setHandler(handler: (ctx: IHandlerContext<any, any>) => THandlerReturn | Promise<THandlerReturn>): this;
     printAll(filePath?: string): void;
-    parse(processArgs: string[], options?: IParseOptions): TParsedArgsWithRouting<any>;
+    parse(processArgs: string[], options?: IParseOptions): Promise<TParsedArgsWithRouting<any> | ParseResult>;
+    /**
+     * Alias for parse() method for backward compatibility
+     * Since parse() is already async, this just calls parse()
+     *
+     * @deprecated Use parse() instead. This method will be removed in a future version.
+     */
+    parseAsync(processArgs: string[], options?: IParseOptions): Promise<TParsedArgsWithRouting<any> | ParseResult>;
     /**
      * Recursive helper for parsing arguments and handling sub-commands.
      * This method assumes the global help check has already been performed in `parse`.
@@ -120,6 +149,58 @@ export declare class ArgParserBase<THandlerReturn = any> {
     hasFlag(name: string): boolean;
     getCommandChain(): string[];
     getLastParseResult(): TParsedArgs<ProcessedFlag[]>;
+    /**
+     * Add an MCP resource to this parser
+     */
+    addMcpResource(config: McpResourceConfig): this;
+    /**
+     * Remove an MCP resource by name
+     */
+    removeMcpResource(name: string): this;
+    /**
+     * Get all registered MCP resources
+     */
+    getMcpResources(): McpResourceConfig[];
+    /**
+     * Add an MCP prompt to this parser
+     */
+    addMcpPrompt(config: McpPromptConfig): this;
+    /**
+     * Remove an MCP prompt by name
+     */
+    removeMcpPrompt(name: string): this;
+    /**
+     * Get all registered MCP prompts
+     */
+    getMcpPrompts(): McpPromptConfig[];
+    /**
+     * Add a change listener for MCP entities
+     */
+    onMcpChange(listener: (event: {
+        type: McpChangeType;
+        action: string;
+        entityName?: string;
+    }) => void): this;
+    /**
+     * Remove a change listener for MCP entities
+     */
+    offMcpChange(listener: (event: {
+        type: McpChangeType;
+        action: string;
+        entityName?: string;
+    }) => void): this;
+    /**
+     * Get the MCP notifications manager (for advanced usage)
+     */
+    getMcpNotificationsManager(): McpNotificationsManager;
+    /**
+     * Get the MCP resources manager (for advanced usage)
+     */
+    getMcpResourcesManager(): McpResourcesManager;
+    /**
+     * Get the MCP prompts manager (for advanced usage)
+     */
+    getMcpPromptsManager(): McpPromptsManager;
 }
 export {};
 //# sourceMappingURL=ArgParserBase.d.ts.map

package/dist/src/core/ArgParserBase.d.ts.map

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

package/dist/src/core/FlagManager.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"FlagManager.d.ts","sourceRoot":"","sources":["../../../src/core/FlagManager.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,KAAK,EAAE,aAAa,EAAE,MAAM,SAAS,CAAC;AAEpD,qBAAa,WAAW;;gBAKpB,OAAO,GAAE;QAAE,sBAAsB,CAAC,EAAE,OAAO,CAAA;KAAO,EAClD,YAAY,GAAE,SAAS,KAAK,EAAO;IAMrC,MAAM,CAAC,SAAS,CAAC,IAAI,EAAE,KAAK,GAAG,aAAa;IAwC5C,OAAO,CAAC,IAAI,EAAE,KAAK,GAAG,IAAI;IAoB1B,+BAA+B,CAAC,aAAa,EAAE,aAAa,GAAG,IAAI;IAQnE,QAAQ,CAAC,KAAK,EAAE,SAAS,KAAK,EAAE,GAAG,IAAI;IAOvC,OAAO,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO;IAI9B,OAAO,CAAC,IAAI,EAAE,MAAM,GAAG,aAAa,GAAG,SAAS;IAIhD,IAAI,KAAK,IAAI,aAAa,EAAE,CAE3B;IAED,IAAI,SAAS,IAAI,MAAM,EAAE,CAExB;CACF"}

package/dist/src/{types.d.ts → core/types.d.ts}

@@ -77,6 +77,8 @@ export type IFlag = IFlagCore & {
     default?: any;
     /** @alias mandatory */
     required?: boolean | ((parsedArgs: TParsedArgs<any>) => boolean);
+    /** Environment variables that should be set from this flag's value in DXT packages */
+    env?: string | string[];
 };
 /**
  * A more refined type for a flag after it has been fully processed by ArgParser,
@@ -155,6 +157,33 @@ export interface ISubCommand<TSubCommandFlags extends FlagsArray = FlagsArray, T
     /** MCP tool generation options for DXT generation */
     mcpToolOptions?: any;
 }
+/**
+ * Result of parsing operations that replaces process.exit() calls.
+ * Provides structured information about the parsing outcome.
+ */
+export interface ParseResult<T = any> {
+    /** Whether the parsing was successful */
+    success: boolean;
+    /** Exit code that would have been used with process.exit() */
+    exitCode: number;
+    /** The parsed data/result when successful */
+    data?: T;
+    /** Human-readable message about the result */
+    message?: string;
+    /** Whether the process should exit (for help, version, etc.) */
+    shouldExit?: boolean;
+    /** Type of result for better handling */
+    type?: 'success' | 'error' | 'help' | 'version' | 'debug';
+}
+/**
+ * Configuration options for ArgParser behavior
+ */
+export interface ArgParserOptions {
+    /** Whether to automatically call process.exit() based on ParseResult (default: true for backward compatibility) */
+    autoExit?: boolean;
+    /** Whether to handle errors by exiting or throwing (default: true for backward compatibility) */
+    handleErrors?: boolean;
+}
 /**
  * Type for the main handler of an ArgParser instance (root command or a command defined by an ArgParser).
  * @template TParserFlags Flags defined for this ArgParser instance.

package/dist/src/core/types.d.ts.map

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

package/dist/src/dxt/DxtGenerator.d.ts

@@ -0,0 +1,115 @@
+import type { ParseResult } from "../core/types";
+/**
+ * DxtGenerator handles the generation of DXT (Desktop Extension) packages
+ * for MCP servers created from ArgParser instances.
+ */
+export declare class DxtGenerator {
+    private argParserInstance;
+    constructor(argParserInstance: any);
+    /**
+     * Helper method to handle exit logic based on autoExit setting
+     */
+    private _handleExit;
+    /**
+     * Handles the --s-build-dxt system flag to generate DXT packages for MCP servers
+     */
+    handleBuildDxtFlag(processArgs: string[], buildDxtIndex: number): Promise<boolean | ParseResult>;
+    /**
+     * Handles DXT generation in test mode by creating mock DXT package structure
+     */
+    private handleTestModeDxtGeneration;
+    /**
+     * Generates a DXT package for the unified MCP server
+     * Now supports both withMcp() configuration and legacy addMcpSubCommand()
+     */
+    generateDxtPackage(mcpSubCommand?: any, outputDir?: string): Promise<void>;
+    /**
+     * Reads package.json to extract fallback information for DXT manifest
+     */
+    private readPackageJsonInfo;
+    /**
+     * Extracts server information from MCP configuration
+     * Now supports both withMcp() configuration and legacy addMcpSubCommand()
+     */
+    private extractMcpServerInfo;
+    private generateMcpToolsForDxt;
+    private createDxtManifest;
+    private validateDxtManifest;
+    private createServerScript;
+    private createDxtPackageJson;
+    /**
+     * Creates a .dxtignore file to exclude build artifacts and unnecessary files
+     */
+    private createDxtIgnore;
+    /**
+     * Creates a simple build script that uses TSDown bundling and Anthropic's dxt pack
+     */
+    private createSimpleBuildScript;
+    private createDxtReadme;
+    /**
+     * Maps ArgParser flag types to DXT user config types
+     */
+    private mapFlagTypeToUserConfigType;
+    /**
+     * Generates CLI arguments for DXT manifest based on ArgParser flags
+     */
+    private generateCliArgsForDxt;
+    /**
+     * Generates environment variables and user config for DXT manifest
+     */
+    private generateEnvAndUserConfig;
+    /**
+     * Generates a user-friendly title for user config fields
+     */
+    private generateUserConfigTitle;
+    /**
+     * Checks if a field should be marked as sensitive in user config
+     */
+    private isSensitiveField;
+    /**
+     * Adds the logo to the build folder if available
+     * @returns The filename of the logo that was added, or undefined if no logo was added
+     */
+    private addLogoToFolder;
+    /**
+     * Processes CLI source code to replace global console with MCP-compliant Logger
+     */
+    private processCliSourceForMcp;
+    /**
+     * Adds the original CLI source to the build folder for handler execution
+     */
+    private addOriginalCliToFolder;
+    /**
+     * Builds a complete DXT package using TSDown CLI for autonomous execution
+     */
+    private buildDxtWithTsdown;
+    /**
+     * Bundles the original CLI using TSDown for autonomous execution (legacy method)
+     */
+    private bundleOriginalCliWithTsdown;
+    /**
+     * Checks if a module ID is a Node.js built-in
+     */
+    private isNodeBuiltin;
+    /**
+     * Gets the TSDown configuration content as a string
+     */
+    private getTsdownConfigContent;
+    /**
+     * Gets the path to the .dxtignore template file in assets
+     */
+    private getDxtIgnoreTemplatePath;
+    /**
+     * Sets up DXT package files (manifest.json) in the dxt output directory
+     */
+    private setupDxtPackageFiles;
+    /**
+     * Maps ArgParser flag types to JSON Schema types
+     */
+    private mapFlagTypeToJsonSchema;
+    /**
+     * Manually copy logo since TSDown's copy option doesn't work programmatically
+     */
+    private copyLogoManually;
+}
+//# sourceMappingURL=DxtGenerator.d.ts.map

package/dist/src/dxt/DxtGenerator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"DxtGenerator.d.ts","sourceRoot":"","sources":["../../../src/dxt/DxtGenerator.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AAGjD;;;GAGG;AACH,qBAAa,YAAY;IACvB,OAAO,CAAC,iBAAiB,CAAM;gBAEnB,iBAAiB,EAAE,GAAG;IAIlC;;OAEG;IACH,OAAO,CAAC,WAAW;IAiBnB;;OAEG;IACU,kBAAkB,CAAC,WAAW,EAAE,MAAM,EAAE,EAAE,aAAa,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,GAAG,WAAW,CAAC;IAmC7G;;OAEG;YACW,2BAA2B;IA2EzC;;;OAGG;IACU,kBAAkB,CAAC,aAAa,CAAC,EAAE,GAAG,EAAE,SAAS,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IA0FvF;;OAEG;IACH,OAAO,CAAC,mBAAmB;IAoB3B;;;OAGG;IACH,OAAO,CAAC,oBAAoB;IA8B5B,OAAO,CAAC,sBAAsB;IA8D9B,OAAO,CAAC,iBAAiB;IAiFzB,OAAO,CAAC,mBAAmB;IAuC3B,OAAO,CAAC,kBAAkB;IAqC1B,OAAO,CAAC,oBAAoB;IA8D5B;;OAEG;IACH,OAAO,CAAC,eAAe;IA4CvB;;OAEG;IACH,OAAO,CAAC,uBAAuB;IAqF/B,OAAO,CAAC,eAAe;IAkGvB;;OAEG;IACH,OAAO,CAAC,2BAA2B;IAwBnC;;OAEG;IACH,OAAO,CAAC,qBAAqB;IAc7B;;OAEG;IACH,OAAO,CAAC,wBAAwB;IA8DhC;;OAEG;IACH,OAAO,CAAC,uBAAuB;IAO/B;;OAEG;IACH,OAAO,CAAC,gBAAgB;IAUxB;;;OAGG;YACW,eAAe;IAqF7B;;OAEG;IACH,OAAO,CAAC,sBAAsB;IA2D9B;;OAEG;IACH,OAAO,CAAC,sBAAsB;IAmJ9B;;OAEG;YACW,kBAAkB;IAuHhC;;OAEG;YACW,2BAA2B;IAiIzC;;OAEG;IACH,OAAO,CAAC,aAAa;IAarB;;OAEG;IACH,OAAO,CAAC,sBAAsB;IAyD9B;;OAEG;IACH,OAAO,CAAC,wBAAwB;IA4BhC;;OAEG;YACW,oBAAoB;IA4JlC;;OAEG;IACH,OAAO,CAAC,uBAAuB;IAsB/B;;OAEG;YACW,gBAAgB;CAgC/B"}

package/dist/src/index.d.ts

@@ -1,7 +1,11 @@
-export { ArgParserBase, ArgParserError } from "./ArgParserBase";
-export { ArgParser, type McpTransportConfig, type McpSubCommandOptions } from "./ArgParser";
-export { zodFlagSchema, type IFlagCore, type IFlag, type ProcessedFlagCore, type ProcessedFlag, type TParsedArgsTypeFromFlagDef, type FlagsArray, type ResolveType, type ExtractFlagType, type TParsedArgs, type IHandlerContext, type MainHandler, type ISubCommand, type ArgParserInstance, } from "./types";
-export { generateMcpToolsFromArgParser, type IMcpToolStructure, type GenerateMcpToolsOptions, type IParseExecutionResult, } from "./mcp-integration";
-export { ArgParserFuzzyTester } from "./fuzzy-tester";
-export type { FuzzyTestOptions, TestResult, FuzzyTestReport } from "./fuzzy-tester";
+export { ArgParserBase, ArgParserError, type IParseOptions } from "./core/ArgParserBase";
+export { ArgParser, type McpTransportConfig, type McpSubCommandOptions, type DxtServerInfo, type McpServerOptions, type WithMcpOptions, type McpToolConfig, type ToolConfig } from "./core/ArgParser";
+export { ArgParserMcp, createMcpArgParser } from "./mcp/ArgParserMcp";
+export { zodFlagSchema, type IFlagCore, type IFlag, type ProcessedFlagCore, type ProcessedFlag, type TParsedArgsTypeFromFlagDef, type FlagsArray, type ResolveType, type ExtractFlagType, type TParsedArgs, type IHandlerContext, type MainHandler, type ISubCommand, type ArgParserInstance, } from "./core/types";
+export { generateMcpToolsFromArgParser, type IMcpToolStructure, type GenerateMcpToolsOptions, type IParseExecutionResult, type SimplifiedToolResponse, extractSimplifiedResponse, convertFlagToJsonSchemaProperty, convertFlagsToJsonSchema, convertFlagsToZodSchema, createMcpSuccessResponse, createMcpErrorResponse, type McpResponse, } from "./mcp/mcp-integration";
+export { type IConfigPlugin, ConfigPlugin, JsonConfigPlugin, EnvConfigPlugin, ConfigPluginRegistry, globalConfigPluginRegistry, enableOptionalConfigPlugins, enableOptionalConfigPluginsAsync, enableConfigPlugins, TomlConfigPlugin, createTomlPlugin, createTomlPluginAsync, YamlConfigPlugin, createYamlPlugin, createYamlPluginAsync, } from "./config/plugins";
+export { ArgParserFuzzyTester } from "./testing/fuzzy-tester";
+export type { FuzzyTestOptions, TestResult, FuzzyTestReport } from "./testing/fuzzy-tester";
+export { default as SimpleChalk } from "@alcyone-labs/simple-chalk";
+export { Logger, logger, createMcpLogger, createCliLogger, type LogLevel, type LoggerConfig } from "@alcyone-labs/simple-mcp-logger";
 //# sourceMappingURL=index.d.ts.map

package/dist/src/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,cAAc,EAAE,MAAM,iBAAiB,CAAC;AAChE,OAAO,EACL,SAAS,EACT,KAAK,kBAAkB,EACvB,KAAK,oBAAoB,EAC1B,MAAM,aAAa,CAAC;AAErB,OAAO,EACL,aAAa,EACb,KAAK,SAAS,EACd,KAAK,KAAK,EACV,KAAK,iBAAiB,EACtB,KAAK,aAAa,EAClB,KAAK,0BAA0B,EAC/B,KAAK,UAAU,EACf,KAAK,WAAW,EAChB,KAAK,eAAe,EACpB,KAAK,WAAW,EAChB,KAAK,eAAe,EACpB,KAAK,WAAW,EAChB,KAAK,WAAW,EAChB,KAAK,iBAAiB,GACvB,MAAM,SAAS,CAAC;AAEjB,OAAO,EACL,6BAA6B,EAC7B,KAAK,iBAAiB,EACtB,KAAK,uBAAuB,EAC5B,KAAK,qBAAqB,GAC3B,MAAM,mBAAmB,CAAC;AAE3B,OAAO,EAAE,oBAAoB,EAAE,MAAM,gBAAgB,CAAC;AACtD,YAAY,EAAE,gBAAgB,EAAE,UAAU,EAAE,eAAe,EAAE,MAAM,gBAAgB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,cAAc,EAAE,KAAK,aAAa,EAAE,MAAM,sBAAsB,CAAC;AACzF,OAAO,EACL,SAAS,EACT,KAAK,kBAAkB,EACvB,KAAK,oBAAoB,EACzB,KAAK,aAAa,EAClB,KAAK,gBAAgB,EACrB,KAAK,cAAc,EACnB,KAAK,aAAa,EAClB,KAAK,UAAU,EAChB,MAAM,kBAAkB,CAAC;AAC1B,OAAO,EAAE,YAAY,EAAE,kBAAkB,EAAE,MAAM,oBAAoB,CAAC;AAEtE,OAAO,EACL,aAAa,EACb,KAAK,SAAS,EACd,KAAK,KAAK,EACV,KAAK,iBAAiB,EACtB,KAAK,aAAa,EAClB,KAAK,0BAA0B,EAC/B,KAAK,UAAU,EACf,KAAK,WAAW,EAChB,KAAK,eAAe,EACpB,KAAK,WAAW,EAChB,KAAK,eAAe,EACpB,KAAK,WAAW,EAChB,KAAK,WAAW,EAChB,KAAK,iBAAiB,GACvB,MAAM,cAAc,CAAC;AAEtB,OAAO,EACL,6BAA6B,EAC7B,KAAK,iBAAiB,EACtB,KAAK,uBAAuB,EAC5B,KAAK,qBAAqB,EAC1B,KAAK,sBAAsB,EAC3B,yBAAyB,EACzB,+BAA+B,EAC/B,wBAAwB,EACxB,uBAAuB,EACvB,wBAAwB,EACxB,sBAAsB,EACtB,KAAK,WAAW,GACjB,MAAM,uBAAuB,CAAC;AAG/B,OAAO,EACL,KAAK,aAAa,EAClB,YAAY,EACZ,gBAAgB,EAChB,eAAe,EACf,oBAAoB,EACpB,0BAA0B,EAC1B,2BAA2B,EAC3B,gCAAgC,EAChC,mBAAmB,EACnB,gBAAgB,EAChB,gBAAgB,EAChB,qBAAqB,EACrB,gBAAgB,EAChB,gBAAgB,EAChB,qBAAqB,GACtB,MAAM,kBAAkB,CAAC;AAE1B,OAAO,EAAE,oBAAoB,EAAE,MAAM,wBAAwB,CAAC;AAC9D,YAAY,EAAE,gBAAgB,EAAE,UAAU,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAC;AAG5F,OAAO,EAAE,OAAO,IAAI,WAAW,EAAE,MAAM,4BAA4B,CAAC;AAGpE,OAAO,EACL,MAAM,EACN,MAAM,EACN,eAAe,EACf,eAAe,EACf,KAAK,QAAQ,EACb,KAAK,YAAY,EAClB,MAAM,iCAAiC,CAAC"}

package/dist/src/mcp/ArgParserMcp.d.ts

@@ -0,0 +1,21 @@
+import { ArgParser } from "../core/ArgParser";
+import type { IArgParserParams } from "../core/ArgParserBase";
+import type { IFlag } from "../core/types";
+/**
+ * MCP-optimized ArgParser that excludes config file functionality
+ * This version doesn't load any config plugins, making it suitable for
+ * autonomous builds where TOML/YAML dependencies cause bundling issues.
+ */
+export declare class ArgParserMcp<THandlerReturn = any> extends ArgParser<THandlerReturn> {
+    constructor(params?: IArgParserParams<THandlerReturn>, initialFlags?: IFlag[]);
+    /**
+     * Override parse to skip config file processing
+     */
+    parse(processArgs: string[], options?: any): any;
+}
+/**
+ * Convenience function to create MCP-optimized ArgParser
+ * This is the recommended way to create ArgParser instances for MCP servers
+ */
+export declare function createMcpArgParser<THandlerReturn = any>(params?: IArgParserParams<THandlerReturn>, initialFlags?: IFlag[]): ArgParserMcp<THandlerReturn>;
+//# sourceMappingURL=ArgParserMcp.d.ts.map

package/dist/src/mcp/ArgParserMcp.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ArgParserMcp.d.ts","sourceRoot":"","sources":["../../../src/mcp/ArgParserMcp.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,mBAAmB,CAAC;AAC9C,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAC;AAC9D,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,eAAe,CAAC;AAE3C;;;;GAIG;AACH,qBAAa,YAAY,CAAC,cAAc,GAAG,GAAG,CAAE,SAAQ,SAAS,CAAC,cAAc,CAAC;gBACnE,MAAM,CAAC,EAAE,gBAAgB,CAAC,cAAc,CAAC,EAAE,YAAY,CAAC,EAAE,KAAK,EAAE;IAS7E;;OAEG;IACI,KAAK,CAAC,WAAW,EAAE,MAAM,EAAE,EAAE,OAAO,CAAC,EAAE,GAAG,GAAG,GAAG;CAUxD;AAED;;;GAGG;AACH,wBAAgB,kBAAkB,CAAC,cAAc,GAAG,GAAG,EACrD,MAAM,CAAC,EAAE,gBAAgB,CAAC,cAAc,CAAC,EACzC,YAAY,CAAC,EAAE,KAAK,EAAE,GACrB,YAAY,CAAC,cAAc,CAAC,CAE9B"}

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

@@ -0,0 +1,83 @@
+import type { ZodTypeAny } from "zod";
+import { ArgParserBase } from "../core/ArgParserBase";
+import type { IFlag, ProcessedFlag, TParsedArgs } from "../core/types";
+/**
+ * Standard MCP response format
+ */
+export interface McpResponse {
+    content: Array<{
+        type: "text";
+        text: string;
+    }>;
+    isError?: boolean;
+}
+/**
+ * Create a standardized MCP success response
+ */
+export declare function createMcpSuccessResponse(data: any): McpResponse;
+/**
+ * Create a standardized MCP error response
+ */
+export declare function createMcpErrorResponse(error: string | Error): McpResponse;
+/**
+ * Convert a single ArgParser flag to JSON Schema property
+ */
+export declare function convertFlagToJsonSchemaProperty(flag: IFlag | ProcessedFlag): {
+    property: any;
+    isRequired: boolean;
+};
+/**
+ * Convert ArgParser flags to MCP JSON Schema
+ */
+export declare function convertFlagsToJsonSchema(flags: readonly (IFlag | ProcessedFlag)[]): {
+    type: "object";
+    properties: Record<string, any>;
+    required: string[];
+};
+/**
+ * Convert ArgParser flags to Zod schema for MCP tools
+ */
+export declare function convertFlagsToZodSchema(flags: readonly (IFlag | ProcessedFlag)[]): ZodTypeAny;
+/**
+ * Simplified response format for testing and validation
+ */
+export interface SimplifiedToolResponse {
+    success: boolean;
+    data?: any;
+    error?: string;
+    message?: string;
+    exitCode?: number;
+}
+/**
+ * Extract simplified response from MCP protocol response
+ */
+export declare function extractSimplifiedResponse(mcpResponse: any): SimplifiedToolResponse;
+export interface IMcpToolStructure {
+    name: string;
+    description?: string;
+    inputSchema: ZodTypeAny;
+    outputSchema?: ZodTypeAny;
+    execute: (args: any) => Promise<any>;
+    executeForTesting?: (args: any) => Promise<SimplifiedToolResponse>;
+}
+export interface GenerateMcpToolsOptions {
+    outputSchemaMap?: Record<string, ZodTypeAny>;
+    defaultOutputSchema?: ZodTypeAny;
+    generateToolName?: (commandPath: string[], appName?: string) => string;
+    includeSubCommands?: boolean;
+    toolNamePrefix?: string;
+    toolNameSuffix?: string;
+}
+interface ISpecialParseResultProps {
+    $commandChain?: string[];
+    $error?: {
+        type: string;
+        message: string;
+        details?: any;
+    };
+    handlerResponse?: any;
+}
+export type IParseExecutionResult = TParsedArgs<ProcessedFlag[]> & ISpecialParseResultProps;
+export declare function generateMcpToolsFromArgParser(rootParser: ArgParserBase, options?: GenerateMcpToolsOptions): IMcpToolStructure[];
+export {};
+//# sourceMappingURL=mcp-integration.d.ts.map

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

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

package/dist/src/mcp/mcp-notifications.d.ts

@@ -0,0 +1,138 @@
+/**
+ * MCP Change Notifications System
+ *
+ * This module provides functionality for managing MCP change notifications,
+ * allowing clients to subscribe to changes in tools, resources, and prompts.
+ */
+/**
+ * Types of MCP entities that can change
+ */
+export type McpChangeType = 'tools' | 'resources' | 'prompts';
+/**
+ * Change notification event
+ */
+export interface McpChangeEvent {
+    type: McpChangeType;
+    timestamp: Date;
+    action: 'added' | 'removed' | 'updated';
+    entityName?: string;
+}
+/**
+ * Change listener function type
+ */
+export type McpChangeListener = (event: McpChangeEvent) => void;
+/**
+ * Client subscription information
+ */
+export interface McpClientSubscription {
+    clientId: string;
+    subscriptions: Set<McpChangeType>;
+    connection: any;
+}
+/**
+ * MCP Change Notifications Manager
+ *
+ * Manages client subscriptions and change notifications for MCP entities
+ */
+export declare class McpNotificationsManager {
+    private clients;
+    private globalListeners;
+    private changeHistory;
+    private maxHistorySize;
+    /**
+     * Add a client connection
+     */
+    addClient(clientId: string, connection: any): void;
+    /**
+     * Remove a client connection
+     */
+    removeClient(clientId: string): void;
+    /**
+     * Subscribe a client to changes of a specific type
+     */
+    subscribe(clientId: string, type: McpChangeType): void;
+    /**
+     * Unsubscribe a client from changes of a specific type
+     */
+    unsubscribe(clientId: string, type: McpChangeType): void;
+    /**
+     * Subscribe a client to all change types
+     */
+    subscribeToAll(clientId: string): void;
+    /**
+     * Unsubscribe a client from all change types
+     */
+    unsubscribeFromAll(clientId: string): void;
+    /**
+     * Get client subscription status
+     */
+    getClientSubscriptions(clientId: string): Set<McpChangeType> | undefined;
+    /**
+     * Check if a client is subscribed to a specific change type
+     */
+    isClientSubscribed(clientId: string, type: McpChangeType): boolean;
+    /**
+     * Notify all subscribed clients of a change
+     */
+    notifyChange(type: McpChangeType, action: 'added' | 'removed' | 'updated', entityName?: string): void;
+    /**
+     * Add a global change listener (not client-specific)
+     */
+    addGlobalListener(listener: McpChangeListener): void;
+    /**
+     * Remove a global change listener
+     */
+    removeGlobalListener(listener: McpChangeListener): void;
+    /**
+     * Get change history
+     */
+    getChangeHistory(limit?: number): McpChangeEvent[];
+    /**
+     * Clear change history
+     */
+    clearHistory(): void;
+    /**
+     * Get connected client count
+     */
+    getClientCount(): number;
+    /**
+     * Get subscription statistics
+     */
+    getSubscriptionStats(): Record<McpChangeType, number>;
+    /**
+     * Send notification to a specific client
+     */
+    private sendNotificationToClient;
+    /**
+     * Add event to change history
+     */
+    private addToHistory;
+    /**
+     * Set maximum history size
+     */
+    setMaxHistorySize(size: number): void;
+    /**
+     * Clear all subscriptions and clients
+     */
+    clear(): void;
+}
+/**
+ * Utility functions for working with change notifications
+ */
+/**
+ * Create a debounced change notifier to batch rapid changes
+ */
+export declare function createDebouncedNotifier(manager: McpNotificationsManager, delay?: number): (type: McpChangeType, action: 'added' | 'removed' | 'updated', entityName?: string) => void;
+/**
+ * Create a filtered change listener that only responds to specific types
+ */
+export declare function createFilteredListener(types: McpChangeType[], listener: McpChangeListener): McpChangeListener;
+/**
+ * Create a logging change listener for debugging
+ */
+export declare function createLoggingListener(prefix?: string): McpChangeListener;
+/**
+ * Default global notifications manager instance
+ */
+export declare const globalNotificationsManager: McpNotificationsManager;
+//# sourceMappingURL=mcp-notifications.d.ts.map

package/dist/src/mcp/mcp-notifications.d.ts.map

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