@alcyone-labs/arg-parser 1.2.0 → 2.1.0

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@alcyone-labs/arg-parser",
-  "version": "1.2.0",
-  "description": "A robust, type-safe command line argument parser with automatic type inference, validation, help generation and complex sub-command support, now with built-in MCP, DXT and fuzzy testing support.",
+  "version": "2.1.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.",
   "type": "module",
   "main": "dist/index.cjs",
   "module": "dist/index.mjs",
@@ -26,6 +26,7 @@
     "dist/index.min.mjs.map",
     "dist/src/**/*.d.ts",
     "dist/src/**/*.d.ts.map",
+    "dist/assets/**/*",
     "README.md",
     "LICENSE"
   ],
@@ -44,29 +45,32 @@
   ],
   "author": "Nicolas Embleton <nicolas.embleton@gmail.com>",
   "license": "MIT",
+  "engines": {
+    "node": ">=18.0.0"
+  },
   "dependencies": {
-    "@iarna/toml": "^2.2.5",
-    "adm-zip": "^0.5.16",
-    "chalk": "^5.4.1",
-    "dotenv": "^16.5.0",
-    "js-yaml": "^4.1.0",
+    "@alcyone-labs/simple-chalk": "^1.0.1",
+    "@alcyone-labs/simple-mcp-logger": "^1.1.0",
     "magic-regexp": "^0.10.0",
-    "node-fetch": "^3.3.2",
-    "zod": "^3.25.67"
+    "zod": "^3.25.76"
   },
   "optionalDependencies": {
-    "@modelcontextprotocol/sdk": "^1.13.1",
-    "express": "^5.1.0"
+    "@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"
   },
   "devDependencies": {
-    "@ianvs/prettier-plugin-sort-imports": "^4.4.2",
+    "@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.15.33",
+    "@types/node": "^22.16.3",
     "cross-env": "^7.0.3",
     "madge": "^8.0.0",
-    "prettier": "^3.6.1",
+    "prettier": "^3.6.2",
     "ts-node": "^10.9.2",
     "typescript": "^5.8.3",
     "vite": "^6.3.5",
@@ -79,7 +83,8 @@
     "build:cjs": "cross-env VITE_BUILD_FORMAT=cjs vite build",
     "build:esm": "cross-env VITE_BUILD_FORMAT=es VITE_MINIFY_BUILD=false vite build",
     "build:min": "cross-env VITE_BUILD_FORMAT=es VITE_MINIFY_BUILD=true vite build",
-    "build": "pnpm clean && pnpm run build:types && pnpm run build:cjs && pnpm run build:esm && pnpm run build:min",
+    "build": "pnpm clean && pnpm run build:types && pnpm run build:cjs && pnpm run build:esm && pnpm run build:min && pnpm run build:assets",
+    "build:assets": "mkdir -p dist/assets && cp docs/MCP/icons/logo_1_small.jpg dist/assets/ && cp tsdown.dxt.config.ts dist/assets/ && cp .dxtignore.template dist/assets/",
     "build:watch": "tsc --watch",
     "build:examples": "tsc --project tsconfig.examples.json",
     "test:watch": "vitest",
@@ -88,13 +93,26 @@
     "test:mcp": "bun tests/mcp/integration/run-integration-tests.ts",
     "test:mcp:verbose": "bun tests/mcp/integration/run-integration-tests.ts --verbose",
     "test:mcp:e2e": "bun tests/mcp/integration/run-integration-tests.ts --suite end-to-end",
-    "test:mcp:compliance": "bun tests/mcp/integration/run-integration-tests.ts --suite protocol-compliance",
+    "test:mcp:protocol": "bun tests/mcp/integration/run-integration-tests.ts --suite protocol-compliance",
     "test:mcp:performance": "bun tests/mcp/integration/run-integration-tests.ts --suite performance",
     "test:mcp:canny": "bun tests/mcp/integration/run-integration-tests.ts --suite canny-cli",
+    "test:mcp:compliance": "vitest run tests/mcp/compliance/",
+    "test:mcp:dxt": "vitest run tests/mcp/compliance/dxt-compliance.test.ts",
     "format": "prettier . --write",
     "check:cir-dep": "madge ./ -c --ts-config tsconfig.dev.json",
     "check:types": "tsc --project ./tsconfig.dev.json --noEmit",
     "build:checks": "pnpm check:cir-dep && pnpm check:types",
-    "test:built": "node test-built-library.mjs"
+    "test:built": "node test-built-library.mjs",
+    "test:post-publish": "node scripts/post-publish-validation.mjs",
+    "test:post-publish:mcp": "node scripts/post-publish-mcp-validation.mjs",
+    "test:post-publish:all": "pnpm test:post-publish && pnpm test:post-publish:mcp",
+    "validate:v2": "node scripts/validate-v2.mjs",
+    "tsdown:dxt": "tsdown -c tsdown.dxt.config.ts",
+    "dxt:validate": "npx @anthropic-ai/dxt validate",
+    "dxt:info": "npx @anthropic-ai/dxt info",
+    "dxt:sign": "npx @anthropic-ai/dxt sign --self-signed",
+    "dxt:pack": "npx @anthropic-ai/dxt pack",
+    "dxt:unpack": "npx @anthropic-ai/dxt unpack",
+    "dxt:verify": "npx @anthropic-ai/dxt verify"
   }
 }

package/dist/src/ArgParser.d.ts

@@ -1,148 +0,0 @@
-import { ArgParserBase } from "./ArgParserBase";
-import type { GenerateMcpToolsOptions, IMcpToolStructure } from "./mcp-integration";
-/**
- * Configuration for a single MCP transport
- */
-export type McpTransportConfig = {
-    type: "stdio" | "sse" | "streamable-http";
-    port?: number;
-    host?: string;
-    path?: string;
-    sessionIdGenerator?: () => string;
-};
-/**
- * Configuration options for MCP sub-command
- */
-export type McpSubCommandOptions = {
-    /** Preset transport configurations to use when no CLI flags are provided */
-    defaultTransports?: McpTransportConfig[];
-    /** Single preset transport configuration (alternative to defaultTransports) */
-    defaultTransport?: McpTransportConfig;
-};
-/**
- * ArgParser with Model Context Protocol (MCP) integration capabilities.
- *
- * This class adds MCP server functionality on top of the standard ArgParser,
- * allowing CLI tools to be easily exposed as MCP tools with minimal boilerplate.
- *
- * @example
- * ```typescript
- * const parser = new ArgParser({
- *   appName: "My CLI",
- *   appCommandName: "my-cli",
- *   handler: async (ctx) => ({ result: "success" })
- * })
- *   .addFlags([...])
- *   .addMcpSubCommand("serve", {
- *     name: "my-cli-mcp-server",
- *     version: "1.0.0"
- *   });
- * ```
- */
-export declare class ArgParser<THandlerReturn = any> extends ArgParserBase<THandlerReturn> {
-    #private;
-    /**
-     * Generate MCP tools from this ArgParser instance
-     * @param options Optional configuration for MCP tool generation
-     * @returns Array of MCP tool structures ready for server registration
-     */
-    toMcpTools(options?: GenerateMcpToolsOptions): IMcpToolStructure[];
-    /**
-     * Create an MCP server with tools generated from this ArgParser
-     * @param serverInfo Server configuration
-     * @param toolOptions Optional MCP tool generation options
-     * @returns Configured MCP server instance
-     */
-    createMcpServer(serverInfo: {
-        name: string;
-        version: string;
-        description?: string;
-    }, toolOptions?: GenerateMcpToolsOptions): Promise<any>;
-    /**
-     * Start an MCP server using stdio transport
-     * @param serverInfo Server configuration
-     * @param toolOptions Optional MCP tool generation options
-     * @returns Promise that resolves when server is connected
-     */
-    startMcpServer(serverInfo: {
-        name: string;
-        version: string;
-        description?: string;
-    }, toolOptions?: GenerateMcpToolsOptions): Promise<void>;
-    /**
-     * Start an MCP server with multiple transport types simultaneously
-     * @param serverInfo Server configuration
-     * @param transports Array of transport configurations
-     * @param toolOptions Optional MCP tool generation options
-     * @returns Promise that resolves when all servers are started
-     */
-    startMcpServerWithMultipleTransports(serverInfo: {
-        name: string;
-        version: string;
-        description?: string;
-    }, transports: Array<{
-        type: "stdio" | "sse" | "streamable-http";
-        port?: number;
-        host?: string;
-        path?: string;
-        sessionIdGenerator?: () => string;
-    }>, toolOptions?: GenerateMcpToolsOptions): Promise<void>;
-    /**
-     * Start an MCP server with a specific transport type
-     * @param serverInfo Server configuration
-     * @param transportType Type of transport to use
-     * @param transportOptions Transport-specific options
-     * @param toolOptions Optional MCP tool generation options
-     * @returns Promise that resolves when server is connected
-     */
-    startMcpServerWithTransport(serverInfo: {
-        name: string;
-        version: string;
-        description?: string;
-    }, transportType: "stdio" | "sse" | "streamable-http", transportOptions?: {
-        port?: number;
-        host?: string;
-        path?: string;
-        sessionIdGenerator?: () => string;
-    }, toolOptions?: GenerateMcpToolsOptions): Promise<void>;
-    parse(processArgs: string[], options?: any): any;
-    /**
-     * Async version of parse for when async handlers are detected
-     */
-    parseAsync(processArgs: string[], options?: any): Promise<any>;
-    /**
-     * Add an MCP sub-command that starts an MCP server exposing this parser's functionality
-     * @param subCommandName Name of the sub-command (default: "mcp-server")
-     * @param serverInfo Server configuration
-     * @param options Optional configuration including preset transports and tool options
-     * @returns This ArgParserWithMcp instance for chaining
-     */
-    addMcpSubCommand(subCommandName: string | undefined, serverInfo: {
-        name: string;
-        version: string;
-        description?: string;
-    }, options?: McpSubCommandOptions & {
-        toolOptions?: GenerateMcpToolsOptions;
-    }): this;
-    /**
-     * Add an MCP sub-command that starts an MCP server exposing this parser's functionality
-     * @param subCommandName Name of the sub-command (default: "mcp-server")
-     * @param serverInfo Server configuration
-     * @param toolOptions Optional MCP tool generation options (backward compatibility)
-     * @returns This ArgParserWithMcp instance for chaining
-     * @deprecated Use the options parameter instead for better configurability
-     */
-    addMcpSubCommand(subCommandName: string | undefined, serverInfo: {
-        name: string;
-        version: string;
-        description?: string;
-    }, toolOptions?: GenerateMcpToolsOptions): this;
-    /**
-     * Factory method to create an ArgParser instance with MCP capabilities
-     * This provides a clean API for users who want MCP functionality from the start
-     * Automatically sets handleErrors: false for MCP compatibility
-     */
-    static withMcp<T = any>(options?: ConstructorParameters<typeof ArgParserBase>[0], initialFlags?: ConstructorParameters<typeof ArgParserBase>[1]): ArgParser<T>;
-    static fromArgParser<T = any>(parser: ArgParserBase<T>): ArgParser<T>;
-}
-//# sourceMappingURL=ArgParser.d.ts.map

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

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

package/dist/src/ArgParserBase.d.ts

@@ -1,125 +0,0 @@
-import type { IFlag, IHandlerContext, ISubCommand, ProcessedFlag, TParsedArgs } from "./types";
-export declare class ArgParserError extends Error {
-    cmdChain: string[];
-    commandChain: string[];
-    constructor(message: string, cmdChain?: string[]);
-}
-export interface IArgParserParams<THandlerReturn = any> {
-    /**
-     * This is the display name of the app, used in help text
-     */
-    appName?: string;
-    subCommands?: ISubCommand[];
-    handler?: (ctx: IHandlerContext<any, any>) => THandlerReturn | Promise<THandlerReturn>;
-    /**
-     * Add an extra new line between each flag group,
-     * makes the text more readable but uses more space
-     *
-     * Default: true
-     */
-    extraNewLine?: boolean;
-    /**
-     * Wraps the line at width, if shorter, wrapping will be more
-     * aggressive. Wrapping is based on words.
-     *
-     * Default: 50
-     * Minimum: 30
-     */
-    wrapAtWidth?: number;
-    /**
-     * Controls the placing of right text on the screen.
-     * The higher the value, the more to the right the text will be.
-     *
-     * Default: 30
-     * Minimum: 20
-     */
-    blankSpaceWidth?: number;
-    /**
-     * Character to display next to the flag to express mandatory fields.
-     *
-     * Default: *
-     */
-    mandatoryCharacter?: string;
-    /**
-     * Throw an error if a flag is added more than once
-     * @default false
-     */
-    throwForDuplicateFlags?: boolean;
-    description?: string;
-    /**
-     * Automatically handle ArgParserErrors by printing a formatted message
-     * and exiting. Set to false to catch ArgParserError manually.
-     * @default true
-     */
-    handleErrors?: boolean;
-    /**
-     * The command name to display in help suggestions (e.g., 'dabl').
-     * If not provided, it falls back to guessing from the script path.
-     */
-    appCommandName?: string;
-    /**
-     * If true, when this parser is added as a sub-command, it will inherit
-     * flags from its direct parent *unless* a flag with the same name
-     * already exists in this parser. Child flags take precedence.
-     * @default false
-     */
-    inheritParentFlags?: boolean;
-}
-interface IParseOptions {
-    /**
-     * When true, skips help flag processing (doesn't exit or show help)
-     * @default false
-     */
-    skipHelpHandling?: boolean;
-    /**
-     * When true, skips the execution of any command handlers.
-     * @default false
-     */
-    skipHandlers?: boolean;
-}
-type TParsedArgsWithRouting<T = any> = T & {
-    $commandChain?: string[];
-    handlerToExecute?: {
-        handler: Function;
-        context: IHandlerContext;
-    };
-};
-export declare class ArgParserBase<THandlerReturn = any> {
-    #private;
-    constructor(options?: IArgParserParams<THandlerReturn>, initialFlags?: readonly IFlag[]);
-    get flags(): ProcessedFlag[];
-    get flagNames(): string[];
-    getAppName(): string | undefined;
-    getAppCommandName(): string | undefined;
-    getSubCommandName(): string;
-    getDescription(): string | undefined;
-    getHandler(): ((ctx: IHandlerContext) => void) | undefined;
-    getSubCommands(): Map<string, ISubCommand>;
-    private _addToOutput;
-    addFlags(flags: readonly IFlag[]): this;
-    addFlag(flag: IFlag): this;
-    addSubCommand(subCommandConfig: ISubCommand): this;
-    /**
-     * Sets the handler function for this specific parser instance.
-     * This handler will be executed if this parser is the final one
-     * in the command chain and `executeHandlers` is enabled on the root parser.
-     *
-     * @param handler - The function to execute.
-     * @returns The ArgParser instance for chaining.
-     */
-    setHandler(handler: (ctx: IHandlerContext<any, any>) => THandlerReturn | Promise<THandlerReturn>): this;
-    printAll(filePath?: string): void;
-    parse(processArgs: string[], options?: IParseOptions): TParsedArgsWithRouting<any>;
-    /**
-     * Recursive helper for parsing arguments and handling sub-commands.
-     * This method assumes the global help check has already been performed in `parse`.
-     */
-    private _parseRecursive;
-    helpText(): string;
-    getSubCommand(name: string): ISubCommand | undefined;
-    hasFlag(name: string): boolean;
-    getCommandChain(): string[];
-    getLastParseResult(): TParsedArgs<ProcessedFlag[]>;
-}
-export {};
-//# sourceMappingURL=ArgParserBase.d.ts.map

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

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

package/dist/src/FlagManager.d.ts

@@ -1,16 +0,0 @@
-import type { IFlag, ProcessedFlag } from "./types";
-export declare class FlagManager {
-    #private;
-    constructor(options?: {
-        throwForDuplicateFlags?: boolean;
-    }, initialFlags?: readonly IFlag[]);
-    static _safeFlag(flag: IFlag): ProcessedFlag;
-    addFlag(flag: IFlag): this;
-    _setProcessedFlagForInheritance(processedFlag: ProcessedFlag): this;
-    addFlags(flags: readonly IFlag[]): this;
-    hasFlag(name: string): boolean;
-    getFlag(name: string): ProcessedFlag | undefined;
-    get flags(): ProcessedFlag[];
-    get flagNames(): string[];
-}
-//# sourceMappingURL=FlagManager.d.ts.map

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

@@ -1 +0,0 @@
-{"version":3,"file":"FlagManager.d.ts","sourceRoot":"","sources":["../../src/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/fuzzy-test-cli.d.ts

@@ -1,5 +0,0 @@
-#!/usr/bin/env node
-import { ArgParser } from "./ArgParser";
-declare const fuzzyTestCli: ArgParser<void>;
-export { fuzzyTestCli };
-//# sourceMappingURL=fuzzy-test-cli.d.ts.map

package/dist/src/fuzzy-test-cli.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"fuzzy-test-cli.d.ts","sourceRoot":"","sources":["../../src/fuzzy-test-cli.ts"],"names":[],"mappings":";AAEA,OAAO,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AAgBxC,QAAA,MAAM,YAAY,iBAmEhB,CAAC;AAkPH,OAAO,EAAE,YAAY,EAAE,CAAC"}

package/dist/src/fuzzy-tester.d.ts

@@ -1,101 +0,0 @@
-import type { ArgParserBase } from "./ArgParserBase";
-export interface FuzzyTestOptions {
-    /** Maximum depth for command path exploration */
-    maxDepth?: number;
-    /** Number of random test cases to generate per command path */
-    randomTestCases?: number;
-    /** Include performance timing in results */
-    includePerformance?: boolean;
-    /** Test invalid combinations to verify error handling */
-    testErrorCases?: boolean;
-    /** Verbose output for debugging */
-    verbose?: boolean;
-}
-export interface TestResult {
-    commandPath: string[];
-    args: string[];
-    success: boolean;
-    error?: string;
-    executionTime?: number;
-    parsedResult?: any;
-}
-export interface FuzzyTestReport {
-    totalTests: number;
-    successfulTests: number;
-    failedTests: number;
-    commandPaths: string[][];
-    results: TestResult[];
-    summary: {
-        coverageByPath: Record<string, {
-            total: number;
-            passed: number;
-        }>;
-        errorTypes: Record<string, number>;
-    };
-}
-export declare class ArgParserFuzzyTester {
-    private parser;
-    private options;
-    constructor(parser: ArgParserBase, options?: FuzzyTestOptions);
-    /**
-     * Run comprehensive fuzzy testing on the ArgParser instance
-     */
-    runFuzzyTest(): Promise<FuzzyTestReport>;
-    /**
-     * Discover all possible command paths in the parser
-     */
-    private discoverCommandPaths;
-    /**
-     * Recursively discover subcommand paths
-     */
-    private discoverSubCommandPaths;
-    /**
-     * Get subcommands from a parser instance
-     */
-    private getSubCommands;
-    /**
-     * Get flags from a parser instance
-     */
-    private getFlags;
-    /**
-     * Test a specific command path with various flag combinations
-     */
-    private testCommandPath;
-    /**
-     * Get the parser instance for a specific command path
-     */
-    private getParserForPath;
-    /**
-     * Generate valid flag combinations for testing
-     */
-    private generateValidFlagCombinations;
-    /**
-     * Generate random flag combination
-     */
-    private generateRandomFlagCombination;
-    /**
-     * Generate error test cases
-     */
-    private generateErrorCases;
-    /**
-     * Generate arguments for a specific flag
-     */
-    private generateFlagArgs;
-    /**
-     * Generate values for a flag based on its type and constraints
-     */
-    private generateFlagValues;
-    /**
-     * Generate a single value for a flag
-     */
-    private generateSingleFlagValue;
-    /**
-     * Execute a single test case
-     */
-    private executeTest;
-    /**
-     * Generate comprehensive test report
-     */
-    private generateReport;
-}
-//# sourceMappingURL=fuzzy-tester.d.ts.map

package/dist/src/fuzzy-tester.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"fuzzy-tester.d.ts","sourceRoot":"","sources":["../../src/fuzzy-tester.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAGrD,MAAM,WAAW,gBAAgB;IAC/B,iDAAiD;IACjD,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,+DAA+D;IAC/D,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,4CAA4C;IAC5C,kBAAkB,CAAC,EAAE,OAAO,CAAC;IAC7B,yDAAyD;IACzD,cAAc,CAAC,EAAE,OAAO,CAAC;IACzB,mCAAmC;IACnC,OAAO,CAAC,EAAE,OAAO,CAAC;CACnB;AAED,MAAM,WAAW,UAAU;IACzB,WAAW,EAAE,MAAM,EAAE,CAAC;IACtB,IAAI,EAAE,MAAM,EAAE,CAAC;IACf,OAAO,EAAE,OAAO,CAAC;IACjB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,YAAY,CAAC,EAAE,GAAG,CAAC;CACpB;AAED,MAAM,WAAW,eAAe;IAC9B,UAAU,EAAE,MAAM,CAAC;IACnB,eAAe,EAAE,MAAM,CAAC;IACxB,WAAW,EAAE,MAAM,CAAC;IACpB,YAAY,EAAE,MAAM,EAAE,EAAE,CAAC;IACzB,OAAO,EAAE,UAAU,EAAE,CAAC;IACtB,OAAO,EAAE;QACP,cAAc,EAAE,MAAM,CAAC,MAAM,EAAE;YAAE,KAAK,EAAE,MAAM,CAAC;YAAC,MAAM,EAAE,MAAM,CAAA;SAAE,CAAC,CAAC;QAClE,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;KACpC,CAAC;CACH;AAED,qBAAa,oBAAoB;IAC/B,OAAO,CAAC,MAAM,CAAgB;IAC9B,OAAO,CAAC,OAAO,CAA6B;gBAEhC,MAAM,EAAE,aAAa,EAAE,OAAO,GAAE,gBAAqB;IAWjE;;OAEG;IACG,YAAY,IAAI,OAAO,CAAC,eAAe,CAAC;IAiB9C;;OAEG;IACH,OAAO,CAAC,oBAAoB;IAY5B;;OAEG;IACH,OAAO,CAAC,uBAAuB;IAmB/B;;OAEG;IACH,OAAO,CAAC,cAAc;IAItB;;OAEG;IACH,OAAO,CAAC,QAAQ;IAIhB;;OAEG;YACW,eAAe;IAsC7B;;OAEG;IACH,OAAO,CAAC,gBAAgB;IAexB;;OAEG;IACH,OAAO,CAAC,6BAA6B;IAqDrC;;OAEG;IACH,OAAO,CAAC,6BAA6B;IAerC;;OAEG;IACH,OAAO,CAAC,kBAAkB;IAoB1B;;OAEG;IACH,OAAO,CAAC,gBAAgB;IAsBxB;;OAEG;IACH,OAAO,CAAC,kBAAkB;IAa1B;;OAEG;IACH,OAAO,CAAC,uBAAuB;IAsC/B;;OAEG;YACW,WAAW;IA0CzB;;OAEG;IACH,OAAO,CAAC,cAAc;CAuCvB"}

package/dist/src/index.d.ts

@@ -1,7 +0,0 @@
-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";
-//# sourceMappingURL=index.d.ts.map

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

@@ -1 +0,0 @@
-{"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"}

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

@@ -1,31 +0,0 @@
-import type { ZodTypeAny } from "zod";
-import { ArgParserBase } from "./ArgParserBase";
-import type { ProcessedFlag, TParsedArgs } from "./";
-export interface IMcpToolStructure {
-    name: string;
-    description?: string;
-    inputSchema: ZodTypeAny;
-    outputSchema?: ZodTypeAny;
-    execute: (args: any) => Promise<any>;
-}
-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-integration.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"mcp-integration.d.ts","sourceRoot":"","sources":["../../src/mcp-integration.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAe,UAAU,EAAE,MAAM,KAAK,CAAC;AACnD,OAAO,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAChD,OAAO,KAAK,EAA0B,aAAa,EAAE,WAAW,EAAE,MAAM,IAAI,CAAC;AAK7E,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;CACtC;AAqID,MAAM,WAAW,uBAAuB;IACtC,eAAe,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,UAAU,CAAC,CAAC;IAC7C,mBAAmB,CAAC,EAAE,UAAU,CAAC;IACjC,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,CAmerB"}