@alcyone-labs/arg-parser 2.14.2 → 3.0.0

package/dist/core/ArgParserBase.d.ts

@@ -1,319 +0,0 @@
-import { type Logger } from "@alcyone-labs/simple-mcp-logger";
-import { McpNotificationsManager, type McpChangeType } from "../mcp/mcp-notifications.js";
-import { McpPromptsManager, type McpPromptConfig } from "../mcp/mcp-prompts.js";
-import { McpResourcesManager, type McpResourceConfig } from "../mcp/mcp-resources.js";
-import type { IArgParser, IFlag, IHandlerContext, IPromptableFlag, ISubCommand, ParseResult, ProcessedFlag, PromptWhen, TParsedArgs, TFlagInheritance } 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;
-    /**
-     * 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.
-     */
-    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?: TFlagInheritance;
-    /**
-     * If true, when no handler is provided for a command (root or sub-command),
-     * the help message will be automatically displayed.
-     * @default false
-     */
-    triggerAutoHelpIfNoHandler?: boolean;
-    /**
-     * Optional logger instance to use.
-     * If not provided, a default one will be created.
-     */
-    logger?: Logger;
-    /**
-     * When to trigger interactive prompts for this command.
-     * - `"interactive-flag"` (default): Prompts shown only when `--interactive` or `-i` flag is present
-     * - `"missing"`: Prompts shown when any promptable flag is missing a value
-     * - `"always"`: Always show prompts (overrides CLI args for promptable flags)
-     *
-     * @default "interactive-flag"
-     *
-     * @example
-     * ```typescript
-     * const cli = new ArgParser({
-     *   appName: "my-cli",
-     *   promptWhen: "interactive-flag",
-     *   handler: async (ctx) => {
-     *     if (ctx.isInteractive) {
-     *       console.log("Interactive mode:", ctx.promptAnswers);
-     *     }
-     *   }
-     * });
-     * ```
-     */
-    promptWhen?: import("./types").PromptWhen;
-    /**
-     * Called when user cancels (Ctrl+C) during interactive prompts.
-     * If not provided, exits gracefully with code 0.
-     */
-    onCancel?: (ctx: import("./types").IHandlerContext) => void | Promise<void>;
-}
-export 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;
-    /**
-     * When true (default), automatically awaits async handlers before returning.
-     * When false, returns immediately with _asyncHandlerPromise for manual handling.
-     * @default true
-     */
-    deep?: boolean;
-    /**
-     * When true, indicates this is being called from MCP mode
-     * @default false
-     * @internal
-     */
-    isMcp?: boolean;
-    /**
-     * Internal: when true, this parse call is only for dynamic flag preloading for help
-     * Suppresses side effects and handler execution
-     * @internal
-     */
-    dynamicHelpPreload?: boolean;
-    /**
-     * When true, automatically executes the CLI if the script is being run directly (not imported).
-     * When false, disables auto-execution detection even if importMetaUrl is provided.
-     * Uses robust detection that works across different environments and sandboxes.
-     * Only takes effect when importMetaUrl is also provided.
-     * @default true (when importMetaUrl is provided)
-     */
-    autoExecute?: boolean;
-    /**
-     * The import.meta.url from the calling script, required for reliable auto-execution detection.
-     * Only used when autoExecute is true.
-     */
-    importMetaUrl?: string;
-}
-type TParsedArgsWithRouting<T = any> = T & {
-    $commandChain?: string[];
-    handlerToExecute?: {
-        handler: Function;
-        context: IHandlerContext;
-    };
-};
-export declare class ArgParserBase<THandlerReturn = any> implements IArgParser<THandlerReturn> {
-    #private;
-    constructor(options?: IArgParserParams<THandlerReturn>, initialFlags?: readonly IFlag[]);
-    get flags(): ProcessedFlag[];
-    get flagNames(): string[];
-    getAppName(): string | undefined;
-    getAppCommandName(): string | undefined;
-    /**
-     * Access to the logger
-     */
-    get logger(): Logger;
-    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>;
-    /**
-     * Sets the promptWhen setting for this parser.
-     * Used internally to propagate promptWhen from parent to sub-parser.
-     * @param promptWhen - The promptWhen value
-     */
-    setPromptWhen(promptWhen: PromptWhen): this;
-    /**
-     * Sets the onCancel callback for this parser.
-     * Used internally to propagate onCancel from parent to sub-parser.
-     * @param onCancel - The onCancel callback
-     */
-    setOnCancel(onCancel: (ctx: IHandlerContext) => void | Promise<void>): this;
-    private _addToOutput;
-    addFlags(flags: readonly IFlag[]): this;
-    addFlag(flag: IFlag): this;
-    /**
-     * Collects all flags that have interactive prompt configuration.
-     * These flags can participate in interactive mode.
-     *
-     * @returns Array of promptable flags with their names
-     */
-    getPromptableFlags(): Array<{
-        flag: IPromptableFlag;
-        name: string;
-    }>;
-    /**
-     * Gets the promptWhen setting for this parser.
-     * @returns The promptWhen value
-     */
-    getPromptWhen(): PromptWhen;
-    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;
-    /**
-     * Detects if the current script is being executed directly (not imported)
-     * Uses a robust method that works across different environments and sandboxes
-     * @param importMetaUrl The import.meta.url from the calling script (optional)
-     * @returns true if the script is being executed directly, false if imported
-     */
-    private static isExecutedDirectly;
-    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`.
-     */
-    private _parseRecursive;
-    helpText(): string;
-    getSubCommand(name: string): ISubCommand | undefined;
-    hasFlag(name: string): boolean;
-    /**
-     * Get flag definition by name
-     * @param name Flag name
-     * @returns Flag definition or undefined if not found
-     */
-    getFlagDefinition(name: string): ProcessedFlag | undefined;
-    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;
-}
-/**
- * A reusable handler that simply displays help.
- * Can be used as a default handler for subcommands that act as containers.
- */
-export declare const autoHelpHandler: (ctx: IHandlerContext) => Promise<void>;
-export {};
-//# sourceMappingURL=ArgParserBase.d.ts.map

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

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

package/dist/core/dxt-path-resolver.d.ts

@@ -1,100 +0,0 @@
-/**
- * Context information for path resolution
- */
-export interface IPathContext {
-    /** Whether the code is running in a DXT environment */
-    isDxt: boolean;
-    /** DXT extension directory (when running in DXT) */
-    extensionDir?: string;
-    /** User's home directory */
-    userHome?: string;
-    /** Current working directory */
-    cwd?: string;
-    /** Entry point directory */
-    entryDir?: string;
-}
-/**
- * Configuration for DXT variable substitution
- */
-export interface IDxtVariableConfig {
-    /** Custom variable values to override defaults */
-    customVariables?: Record<string, string>;
-    /** Whether to allow undefined variables (default: false) */
-    allowUndefined?: boolean;
-}
-/**
- * DXT-aware path resolver with context detection and variable substitution
- */
-export declare class DxtPathResolver {
-    private static _cachedContext;
-    /**
-     * Detects the current execution context
-     * @param forceRefresh - Force refresh of cached context
-     * @returns Path context information
-     */
-    static detectContext(forceRefresh?: boolean): IPathContext;
-    /**
-     * Checks if the current environment is a DXT environment
-     * @returns True if running in DXT, false otherwise
-     */
-    static isDxtEnvironment(): boolean;
-    /**
-     * Detects the DXT extension directory
-     * @returns DXT extension directory path or undefined
-     */
-    private static detectDxtExtensionDir;
-    /**
-     * Resolves a path with DXT variable substitution
-     * @param inputPath - Path that may contain DXT variables
-     * @param context - Optional context (will be detected if not provided)
-     * @param config - Optional configuration for variable substitution
-     * @returns Resolved absolute path
-     */
-    static resolvePath(inputPath: string, context?: IPathContext, config?: IDxtVariableConfig): string;
-    /**
-     * Substitutes DXT variables in a path string
-     * @param inputPath - Path containing variables like ${HOME}, ${__dirname}, etc.
-     * @param context - Path context
-     * @param config - Variable substitution configuration
-     * @returns Path with variables substituted
-     */
-    static substituteVariables(inputPath: string, context: IPathContext, config?: IDxtVariableConfig): string;
-    /**
-     * Creates a path for user data storage
-     * @param filename - Name of the file or subdirectory
-     * @param context - Optional context (will be detected if not provided)
-     * @returns Absolute path for user data
-     */
-    static createUserDataPath(filename: string, context?: IPathContext): string;
-    /**
-     * Creates a path for temporary files
-     * @param filename - Name of the temporary file
-     * @param context - Optional context (will be detected if not provided)
-     * @returns Absolute path for temporary file
-     */
-    static createTempPath(filename: string, context?: IPathContext): string;
-    /**
-     * Creates a path for configuration files
-     * @param filename - Name of the configuration file
-     * @param context - Optional context (will be detected if not provided)
-     * @returns Absolute path for configuration file
-     */
-    static createConfigPath(filename: string, context?: IPathContext): string;
-    /**
-     * Gets the application name for directory creation
-     * @param context - Path context
-     * @returns Application name or default
-     */
-    private static getAppName;
-    /**
-     * Ensures a directory exists, creating it if necessary
-     * @param dirPath - Directory path to ensure
-     * @returns True if directory exists or was created successfully
-     */
-    static ensureDirectory(dirPath: string): boolean;
-    /**
-     * Clears the cached context (useful for testing)
-     */
-    static clearCache(): void;
-}
-//# sourceMappingURL=dxt-path-resolver.d.ts.map

package/dist/core/dxt-path-resolver.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"dxt-path-resolver.d.ts","sourceRoot":"","sources":["../../src/core/dxt-path-resolver.ts"],"names":[],"mappings":"AAKA;;GAEG;AACH,MAAM,WAAW,YAAY;IAC3B,uDAAuD;IACvD,KAAK,EAAE,OAAO,CAAC;IACf,oDAAoD;IACpD,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,4BAA4B;IAC5B,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,gCAAgC;IAChC,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,4BAA4B;IAC5B,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED;;GAEG;AACH,MAAM,WAAW,kBAAkB;IACjC,kDAAkD;IAClD,eAAe,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACzC,4DAA4D;IAC5D,cAAc,CAAC,EAAE,OAAO,CAAC;CAC1B;AAED;;GAEG;AACH,qBAAa,eAAe;IAC1B,OAAO,CAAC,MAAM,CAAC,cAAc,CAA6B;IAE1D;;;;OAIG;WACW,aAAa,CAAC,YAAY,UAAQ,GAAG,YAAY;IA6B/D;;;OAGG;WACW,gBAAgB,IAAI,OAAO;IAwCzC;;;OAGG;IACH,OAAO,CAAC,MAAM,CAAC,qBAAqB;IA8BpC;;;;;;OAMG;WACW,WAAW,CACvB,SAAS,EAAE,MAAM,EACjB,OAAO,CAAC,EAAE,YAAY,EACtB,MAAM,CAAC,EAAE,kBAAkB,GAC1B,MAAM;IAmBT;;;;;;OAMG;WACW,mBAAmB,CAC/B,SAAS,EAAE,MAAM,EACjB,OAAO,EAAE,YAAY,EACrB,MAAM,CAAC,EAAE,kBAAkB,GAC1B,MAAM;IAyDT;;;;;OAKG;WACW,kBAAkB,CAAC,QAAQ,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,YAAY,GAAG,MAAM;IAgBlF;;;;;OAKG;WACW,cAAc,CAAC,QAAQ,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,YAAY,GAAG,MAAM;IAc9E;;;;;OAKG;WACW,gBAAgB,CAAC,QAAQ,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,YAAY,GAAG,MAAM;IAgBhF;;;;OAIG;IACH,OAAO,CAAC,MAAM,CAAC,UAAU;IAkBzB;;;;OAIG;WACW,eAAe,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO;IAYvD;;OAEG;WACW,UAAU,IAAI,IAAI;CAGjC"}

package/dist/dxt/DxtGenerator-testUtils.d.ts

@@ -1,22 +0,0 @@
-import type { ParseResult } from "../core/types";
-/**
- * Test utilities for DxtGenerator
- * Contains methods that are only used during testing
- */
-export declare class DxtGeneratorTestUtils {
-    private argParserInstance;
-    private extractMcpServerInfo;
-    private handleExit;
-    constructor(argParserInstance: any, extractMcpServerInfo: () => any, handleExit: (exitCode: number, message?: string, type?: ParseResult["type"], data?: any) => ParseResult | never);
-    /**
-     * Handles DXT generation in test mode by creating mock DXT package structure
-     * This method creates simplified mock files for testing purposes
-     */
-    handleTestModeDxtGeneration(processArgs: string[], buildDxtIndex: number): Promise<ParseResult>;
-    /**
-     * Checks if the current environment is in test mode
-     * Used to determine whether to use test utilities or production code
-     */
-    static isTestMode(): boolean;
-}
-//# sourceMappingURL=DxtGenerator-testUtils.d.ts.map

package/dist/dxt/DxtGenerator-testUtils.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"DxtGenerator-testUtils.d.ts","sourceRoot":"","sources":["../../src/dxt/DxtGenerator-testUtils.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AAEjD;;;GAGG;AACH,qBAAa,qBAAqB;IAChC,OAAO,CAAC,iBAAiB,CAAM;IAC/B,OAAO,CAAC,oBAAoB,CAAY;IACxC,OAAO,CAAC,UAAU,CAKO;gBAGvB,iBAAiB,EAAE,GAAG,EACtB,oBAAoB,EAAE,MAAM,GAAG,EAC/B,UAAU,EAAE,CACV,QAAQ,EAAE,MAAM,EAChB,OAAO,CAAC,EAAE,MAAM,EAChB,IAAI,CAAC,EAAE,WAAW,CAAC,MAAM,CAAC,EAC1B,IAAI,CAAC,EAAE,GAAG,KACP,WAAW,GAAG,KAAK;IAO1B;;;OAGG;IACU,2BAA2B,CACtC,WAAW,EAAE,MAAM,EAAE,EACrB,aAAa,EAAE,MAAM,GACpB,OAAO,CAAC,WAAW,CAAC;IA+EvB;;;OAGG;WACW,UAAU,IAAI,OAAO;CAQpC"}

package/dist/dxt/DxtGenerator.d.ts

@@ -1,120 +0,0 @@
-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>;
-    /**
-     * Extracts server information from MCP configuration
-     * Now supports both withMcp() configuration and legacy addMcpSubCommand()
-     */
-    private extractMcpServerInfo;
-    private generateMcpToolsForDxt;
-    /**
-     * Maps ArgParser flag types to DXT user config types
-     */
-    /**
-     * 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;
-    /**
-     * Builds a complete DXT package using TSDown CLI for autonomous execution
-     */
-    private buildDxtWithTsdown;
-    /**
-     * Checks if a module ID is a Node.js built-in
-     */
-    isNodeBuiltin(id: string): boolean;
-    /**
-     * Determines if a module should be treated as external based on bundling configuration.
-     * This logic is shared between external and noExternal configurations.
-     *
-     * @param id - The module identifier (e.g., 'lodash', '@types/node', './utils')
-     * @param importer - The file path that is importing this module (undefined for entry points)
-     * @param withNodeModules - Whether to include node_modules in the bundle
-     * @returns true if the module should be external (not bundled), false if it should be bundled
-     *
-     * Logic flow:
-     * 1. Node built-ins (fs, path, etc.) are always external
-     * 2. If no importer (entry point), always bundle
-     * 3. If withNodeModules is false, bundle everything except Node built-ins
-     * 4. If withNodeModules is true:
-     *    - If importer is from node_modules, make external
-     *    - If module resolves to a project file (via TS paths or regular paths), bundle it
-     *    - Otherwise, make external (likely npm package)
-     *
-     * @example
-     * // Node built-in - always external
-     * shouldModuleBeExternal('fs', './src/main.ts', true) // returns true
-     *
-     * // Project file via TS paths or regular paths - bundle it
-     * shouldModuleBeExternal('@/utils', './src/main.ts', true) // returns false
-     *
-     * // NPM package - external when withNodeModules=true
-     * shouldModuleBeExternal('lodash', './src/main.ts', true) // returns true
-     */
-    private shouldModuleBeExternal;
-    /**
-     * Checks if a package ID exists in the local node_modules folder.
-     * Only checks the folder or parent folder that contains the nearest package.json file.
-     * Returns false if no package.json file is found after 3 parent directory traversals.
-     *
-     * Alternative approach using require.resolve():
-     * ```ts
-     * public isNodeModulesPackageWithResolve(packageId: string): boolean {
-     *   try {
-     *     require.resolve(packageId);
-     *     return true;
-     *   } catch {
-     *     return false;
-     *   }
-     * }
-     * ```
-     *
-     * Filesystem approach is preferred for bundler context because:
-     * - Faster (no module resolution overhead)
-     * - No side effects during build
-     * - Predictable behavior in build vs runtime contexts
-     */
-    isNodeModulesPackage(packageId: string): boolean;
-    /**
-     * Get the path to the .dxtignore template file
-     */
-    private getDxtIgnoreTemplatePath;
-    /**
-     * Sets up DXT package files (manifest.json) in the output directory
-     */
-    private setupDxtPackageFiles;
-    /**
-     * Detects the actual output filename generated by TSDown
-     */
-    private detectTsdownOutputFile;
-    private findProjectRoot;
-    /**
-     * Validate dxtOptions for common mistakes and security issues
-     * @param flag The flag with dxtOptions to validate
-     * @param envVar The environment variable name for context
-     */
-    private validateDxtOptions;
-    /**
-     * Generate environment variables and user configuration from ArgParser flags
-     * @returns Object containing envVars and userConfig
-     */
-    generateEnvAndUserConfig(): {
-        envVars: Record<string, string>;
-        userConfig: Record<string, any>;
-    };
-    private resolveModulePath;
-}
-//# sourceMappingURL=DxtGenerator.d.ts.map

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

@@ -1 +0,0 @@
-{"version":3,"file":"DxtGenerator.d.ts","sourceRoot":"","sources":["../../src/dxt/DxtGenerator.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AAOjD;;;GAGG;AACH,qBAAa,YAAY;IACvB,OAAO,CAAC,iBAAiB,CAAM;gBAEnB,iBAAiB,EAAE,GAAG;IAIlC;;OAEG;IACH,OAAO,CAAC,WAAW;IA0BnB;;OAEG;IACU,kBAAkB,CAC7B,WAAW,EAAE,MAAM,EAAE,EACrB,aAAa,EAAE,MAAM,GACpB,OAAO,CAAC,OAAO,GAAG,WAAW,CAAC;IAsHjC;;;OAGG;IACH,OAAO,CAAC,oBAAoB;IAgC5B,OAAO,CAAC,sBAAsB;IAkF9B;;OAEG;IACH;;;OAGG;YACW,eAAe;IAoI7B;;OAEG;YACW,kBAAkB;IAyQhC;;OAEG;IACI,aAAa,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO;IA4CzC;;;;;;;;;;;;;;;;;;;;;;;;;;;OA2BG;IACH,OAAO,CAAC,sBAAsB;IAkC9B;;;;;;;;;;;;;;;;;;;;;OAqBG;IACI,oBAAoB,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO;IAsCvD;;OAEG;IACH,OAAO,CAAC,wBAAwB;IA+ChC;;OAEG;YACW,oBAAoB;IAkJlC;;OAEG;IACH,OAAO,CAAC,sBAAsB;IA2H9B,OAAO,CAAC,eAAe;IAyBvB;;;;OAIG;IACH,OAAO,CAAC,kBAAkB;IAuD1B;;;OAGG;IACI,wBAAwB,IAAI;QACjC,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;QAChC,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;KACjC;IAqLD,OAAO,CAAC,iBAAiB;CA0L1B"}

package/dist/mcp/ArgParserMcp.d.ts

@@ -1,21 +0,0 @@
-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/mcp/ArgParserMcp.d.ts.map

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