@alcyone-labs/arg-parser 1.1.0 → 2.0.0

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

@@ -0,0 +1,132 @@
+/**
+ * MCP Prompts Management
+ *
+ * This module provides functionality for managing MCP prompts - server-side prompt templates
+ * that clients can discover and execute with custom parameters for dynamic text generation.
+ */
+import { ZodTypeAny } from "zod";
+/**
+ * Prompt message content types
+ */
+export interface McpPromptTextContent {
+    type: "text";
+    text: string;
+}
+export interface McpPromptImageContent {
+    type: "image";
+    data: string;
+    mimeType: string;
+}
+export type McpPromptContent = McpPromptTextContent | McpPromptImageContent;
+/**
+ * Prompt message structure
+ */
+export interface McpPromptMessage {
+    role: "user" | "assistant" | "system";
+    content: McpPromptContent;
+}
+/**
+ * Prompt response structure
+ */
+export interface McpPromptResponse {
+    description?: string;
+    messages: McpPromptMessage[];
+}
+/**
+ * Prompt handler function type
+ */
+export type McpPromptHandler = (args: any) => McpPromptResponse | Promise<McpPromptResponse>;
+/**
+ * Prompt configuration for registration
+ */
+export interface McpPromptConfig {
+    name: string;
+    title?: string;
+    description?: string;
+    argsSchema: ZodTypeAny;
+    handler: McpPromptHandler;
+}
+/**
+ * Internal prompt storage structure
+ */
+export interface McpPromptEntry {
+    config: McpPromptConfig;
+    registeredAt: Date;
+}
+/**
+ * MCP Prompts Manager
+ *
+ * Manages registration, storage, and execution of MCP prompts
+ */
+export declare class McpPromptsManager {
+    private prompts;
+    private changeListeners;
+    /**
+     * Register a new prompt
+     */
+    addPrompt(config: McpPromptConfig): void;
+    /**
+     * Remove a prompt by name
+     */
+    removePrompt(name: string): boolean;
+    /**
+     * Get all registered prompts
+     */
+    getPrompts(): McpPromptConfig[];
+    /**
+     * Get a specific prompt by name
+     */
+    getPrompt(name: string): McpPromptConfig | undefined;
+    /**
+     * Check if a prompt exists
+     */
+    hasPrompt(name: string): boolean;
+    /**
+     * Execute a prompt with given arguments
+     */
+    executePrompt(name: string, args: any): Promise<McpPromptResponse>;
+    /**
+     * Add change listener
+     */
+    onPromptsChange(listener: () => void): void;
+    /**
+     * Remove change listener
+     */
+    offPromptsChange(listener: () => void): void;
+    /**
+     * Clear all prompts
+     */
+    clear(): void;
+    /**
+     * Get prompt count
+     */
+    count(): number;
+    /**
+     * Validate prompt configuration
+     */
+    private validatePromptConfig;
+    /**
+     * Notify all listeners of changes
+     */
+    private notifyChange;
+}
+/**
+ * Helper function to create common prompt configurations
+ */
+/**
+ * Create a code review prompt
+ */
+export declare const createCodeReviewPrompt: () => McpPromptConfig;
+/**
+ * Create a text summarization prompt
+ */
+export declare const createSummarizationPrompt: () => McpPromptConfig;
+/**
+ * Create a translation prompt
+ */
+export declare const createTranslationPrompt: () => McpPromptConfig;
+/**
+ * Create a documentation prompt
+ */
+export declare const createDocumentationPrompt: () => McpPromptConfig;
+//# sourceMappingURL=mcp-prompts.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"mcp-prompts.d.ts","sourceRoot":"","sources":["../../../src/mcp/mcp-prompts.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAK,UAAU,EAAE,MAAM,KAAK,CAAC;AAEpC;;GAEG;AACH,MAAM,WAAW,oBAAoB;IACnC,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;CACd;AAED,MAAM,WAAW,qBAAqB;IACpC,IAAI,EAAE,OAAO,CAAC;IACd,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,MAAM,gBAAgB,GAAG,oBAAoB,GAAG,qBAAqB,CAAC;AAE5E;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC/B,IAAI,EAAE,MAAM,GAAG,WAAW,GAAG,QAAQ,CAAC;IACtC,OAAO,EAAE,gBAAgB,CAAC;CAC3B;AAED;;GAEG;AACH,MAAM,WAAW,iBAAiB;IAChC,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,QAAQ,EAAE,gBAAgB,EAAE,CAAC;CAC9B;AAED;;GAEG;AACH,MAAM,MAAM,gBAAgB,GAAG,CAAC,IAAI,EAAE,GAAG,KAAK,iBAAiB,GAAG,OAAO,CAAC,iBAAiB,CAAC,CAAC;AAE7F;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,UAAU,EAAE,UAAU,CAAC;IACvB,OAAO,EAAE,gBAAgB,CAAC;CAC3B;AAED;;GAEG;AACH,MAAM,WAAW,cAAc;IAC7B,MAAM,EAAE,eAAe,CAAC;IACxB,YAAY,EAAE,IAAI,CAAC;CACpB;AAED;;;;GAIG;AACH,qBAAa,iBAAiB;IAC5B,OAAO,CAAC,OAAO,CAAqC;IACpD,OAAO,CAAC,eAAe,CAAyB;IAEhD;;OAEG;IACH,SAAS,CAAC,MAAM,EAAE,eAAe,GAAG,IAAI;IAcxC;;OAEG;IACH,YAAY,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO;IAQnC;;OAEG;IACH,UAAU,IAAI,eAAe,EAAE;IAI/B;;OAEG;IACH,SAAS,CAAC,IAAI,EAAE,MAAM,GAAG,eAAe,GAAG,SAAS;IAIpD;;OAEG;IACH,SAAS,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO;IAIhC;;OAEG;IACG,aAAa,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,GAAG,GAAG,OAAO,CAAC,iBAAiB,CAAC;IAkBxE;;OAEG;IACH,eAAe,CAAC,QAAQ,EAAE,MAAM,IAAI,GAAG,IAAI;IAI3C;;OAEG;IACH,gBAAgB,CAAC,QAAQ,EAAE,MAAM,IAAI,GAAG,IAAI;IAI5C;;OAEG;IACH,KAAK,IAAI,IAAI;IAQb;;OAEG;IACH,KAAK,IAAI,MAAM;IAIf;;OAEG;IACH,OAAO,CAAC,oBAAoB;IAkB5B;;OAEG;IACH,OAAO,CAAC,YAAY;CASrB;AAED;;GAEG;AAEH;;GAEG;AACH,eAAO,MAAM,sBAAsB,QAAO,eAmBxC,CAAC;AAEH;;GAEG;AACH,eAAO,MAAM,yBAAyB,QAAO,eA6B3C,CAAC;AAEH;;GAEG;AACH,eAAO,MAAM,uBAAuB,QAAO,eAyBzC,CAAC;AAEH;;GAEG;AACH,eAAO,MAAM,yBAAyB,QAAO,eAyB3C,CAAC"}

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

@@ -0,0 +1,133 @@
+/**
+ * MCP Resources Management
+ *
+ * This module provides functionality for managing MCP resources - server-side data sources
+ * that clients can access using URI templates. Resources are similar to GET endpoints
+ * in a REST API and should provide data without significant computation or side effects.
+ */
+/**
+ * Resource response content item
+ */
+export interface McpResourceContent {
+    uri: string;
+    text?: string;
+    blob?: Uint8Array;
+    mimeType?: string;
+}
+/**
+ * Resource response structure
+ */
+export interface McpResourceResponse {
+    contents: McpResourceContent[];
+}
+/**
+ * Resource handler function type
+ */
+export type McpResourceHandler = (uri: URL, params: Record<string, string>) => Promise<McpResourceResponse>;
+/**
+ * Resource configuration for registration
+ */
+export interface McpResourceConfig {
+    name: string;
+    uriTemplate: string;
+    title?: string;
+    description?: string;
+    mimeType?: string;
+    handler: McpResourceHandler;
+}
+/**
+ * Internal resource storage structure
+ */
+export interface McpResourceEntry {
+    config: McpResourceConfig;
+    registeredAt: Date;
+}
+/**
+ * Resource template parser for URI patterns like "users://{userId}/profile"
+ */
+export declare class ResourceTemplateParser {
+    private pattern;
+    private paramNames;
+    constructor(template: string);
+    /**
+     * Parse a URI against this template and extract parameters
+     */
+    parse(uri: string): Record<string, string> | null;
+    /**
+     * Check if a URI matches this template
+     */
+    matches(uri: string): boolean;
+    /**
+     * Get the parameter names for this template
+     */
+    getParameterNames(): string[];
+}
+/**
+ * MCP Resources Manager
+ *
+ * Manages registration, storage, and retrieval of MCP resources
+ */
+export declare class McpResourcesManager {
+    private resources;
+    private changeListeners;
+    /**
+     * Register a new resource
+     */
+    addResource(config: McpResourceConfig): void;
+    /**
+     * Remove a resource by name
+     */
+    removeResource(name: string): boolean;
+    /**
+     * Get all registered resources
+     */
+    getResources(): McpResourceConfig[];
+    /**
+     * Get a specific resource by name
+     */
+    getResource(name: string): McpResourceConfig | undefined;
+    /**
+     * Check if a resource exists
+     */
+    hasResource(name: string): boolean;
+    /**
+     * Find resource that matches a URI
+     */
+    findResourceForUri(uri: string): {
+        config: McpResourceConfig;
+        params: Record<string, string>;
+    } | null;
+    /**
+     * Add change listener
+     */
+    onResourcesChange(listener: () => void): void;
+    /**
+     * Remove change listener
+     */
+    offResourcesChange(listener: () => void): void;
+    /**
+     * Clear all resources
+     */
+    clear(): void;
+    /**
+     * Get resource count
+     */
+    count(): number;
+    /**
+     * Validate resource configuration
+     */
+    private validateResourceConfig;
+    /**
+     * Notify all listeners of changes
+     */
+    private notifyChange;
+}
+/**
+ * Helper function to create common resource configurations
+ */
+export declare const createFileResource: (basePath?: string) => McpResourceConfig;
+/**
+ * Helper function to create JSON data resource
+ */
+export declare const createJsonResource: (name: string, data: any) => McpResourceConfig;
+//# sourceMappingURL=mcp-resources.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"mcp-resources.d.ts","sourceRoot":"","sources":["../../../src/mcp/mcp-resources.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAIH;;GAEG;AACH,MAAM,WAAW,kBAAkB;IACjC,GAAG,EAAE,MAAM,CAAC;IACZ,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,IAAI,CAAC,EAAE,UAAU,CAAC;IAClB,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED;;GAEG;AACH,MAAM,WAAW,mBAAmB;IAClC,QAAQ,EAAE,kBAAkB,EAAE,CAAC;CAChC;AAED;;GAEG;AACH,MAAM,MAAM,kBAAkB,GAAG,CAC/B,GAAG,EAAE,GAAG,EACR,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,KAC3B,OAAO,CAAC,mBAAmB,CAAC,CAAC;AAElC;;GAEG;AACH,MAAM,WAAW,iBAAiB;IAChC,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,OAAO,EAAE,kBAAkB,CAAC;CAC7B;AAED;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC/B,MAAM,EAAE,iBAAiB,CAAC;IAC1B,YAAY,EAAE,IAAI,CAAC;CACpB;AAED;;GAEG;AACH,qBAAa,sBAAsB;IACjC,OAAO,CAAC,OAAO,CAAS;IACxB,OAAO,CAAC,UAAU,CAAW;gBAEjB,QAAQ,EAAE,MAAM;IAU5B;;OAEG;IACH,KAAK,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,IAAI;IAWjD;;OAEG;IACH,OAAO,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO;IAI7B;;OAEG;IACH,iBAAiB,IAAI,MAAM,EAAE;CAG9B;AAED;;;;GAIG;AACH,qBAAa,mBAAmB;IAC9B,OAAO,CAAC,SAAS,CAAuC;IACxD,OAAO,CAAC,eAAe,CAAyB;IAEhD;;OAEG;IACH,WAAW,CAAC,MAAM,EAAE,iBAAiB,GAAG,IAAI;IAc5C;;OAEG;IACH,cAAc,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO;IAQrC;;OAEG;IACH,YAAY,IAAI,iBAAiB,EAAE;IAInC;;OAEG;IACH,WAAW,CAAC,IAAI,EAAE,MAAM,GAAG,iBAAiB,GAAG,SAAS;IAIxD;;OAEG;IACH,WAAW,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO;IAIlC;;OAEG;IACH,kBAAkB,CAAC,GAAG,EAAE,MAAM,GAAG;QAAE,MAAM,EAAE,iBAAiB,CAAC;QAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;KAAE,GAAG,IAAI;IAWrG;;OAEG;IACH,iBAAiB,CAAC,QAAQ,EAAE,MAAM,IAAI,GAAG,IAAI;IAI7C;;OAEG;IACH,kBAAkB,CAAC,QAAQ,EAAE,MAAM,IAAI,GAAG,IAAI;IAI9C;;OAEG;IACH,KAAK,IAAI,IAAI;IAQb;;OAEG;IACH,KAAK,IAAI,MAAM;IAIf;;OAEG;IACH,OAAO,CAAC,sBAAsB;IAyB9B;;OAEG;IACH,OAAO,CAAC,YAAY;CASrB;AAED;;GAEG;AACH,eAAO,MAAM,kBAAkB,GAAI,WAAU,MAAW,KAAG,iBAuBzD,CAAC;AAEH;;GAEG;AACH,eAAO,MAAM,kBAAkB,GAAI,MAAM,MAAM,EAAE,MAAM,GAAG,KAAG,iBAa3D,CAAC"}

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

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

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

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

package/dist/src/{fuzzy-tester.d.ts → testing/fuzzy-tester.d.ts}

@@ -1,4 +1,4 @@
-import type { ArgParserBase } from "./ArgParserBase";
+import type { ArgParserBase } from "../core/ArgParserBase";
 export interface FuzzyTestOptions {
     /** Maximum depth for command path exploration */
     maxDepth?: number;

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

@@ -0,0 +1 @@
+{"version":3,"file":"fuzzy-tester.d.ts","sourceRoot":"","sources":["../../../src/testing/fuzzy-tester.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,uBAAuB,CAAC;AAG3D,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/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@alcyone-labs/arg-parser",
-  "version": "1.1.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 and fuzzy testing support.",
+  "version": "2.0.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",
@@ -18,7 +18,15 @@
     "./package.json": "./package.json"
   },
   "files": [
-    "dist",
+    "dist/index.cjs",
+    "dist/index.cjs.map",
+    "dist/index.mjs",
+    "dist/index.mjs.map",
+    "dist/index.min.mjs",
+    "dist/index.min.mjs.map",
+    "dist/src/**/*.d.ts",
+    "dist/src/**/*.d.ts.map",
+    "dist/assets/**/*",
     "README.md",
     "LICENSE"
   ],
@@ -30,30 +38,39 @@
     "CLI",
     "Arg Parser",
     "CLI Commands",
-    "Sub-commands"
+    "Sub-commands",
+    "MCP",
+    "LLM Tool Calls",
+    "DXT"
   ],
   "author": "Nicolas Embleton <nicolas.embleton@gmail.com>",
   "license": "MIT",
+  "engines": {
+    "node": ">=18.0.0"
+  },
   "dependencies": {
-    "@iarna/toml": "^2.2.5",
-    "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.0.1",
     "magic-regexp": "^0.10.0",
-    "zod": "^3.25.67"
+    "zod": "^3.25.76"
   },
   "optionalDependencies": {
-    "@modelcontextprotocol/sdk": "^1.13.1",
-    "express": "^5.1.0"
+    "@modelcontextprotocol/sdk": "^1.15.1",
+    "express": "^5.1.0",
+    "smol-toml": "^1.4.1",
+    "dotenv": "^16.6.1",
+    "js-yaml": "^4.1.0",
+    "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",
@@ -61,20 +78,37 @@
     "vitest": "^3.2.4"
   },
   "scripts": {
-    "clean": "rm -rf dist",
+    "clean": "rm -rf dist dist-examples",
     "build:types": "tsc --project tsconfig.json --emitDeclarationOnly",
     "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",
     "test:run": "vitest run",
     "test:ui": "vitest --ui",
+    "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: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",
+    "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/examples/fuzzy-demo.d.ts

@@ -1,8 +0,0 @@
-#!/usr/bin/env bun
-import { ArgParser } from '../src/ArgParser';
-declare const demoParser: ArgParser<{
-    action: string;
-    processed: boolean;
-}>;
-export default demoParser;
-//# sourceMappingURL=fuzzy-demo.d.ts.map

package/dist/examples/fuzzy-demo.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"fuzzy-demo.d.ts","sourceRoot":"","sources":["../../examples/fuzzy-demo.ts"],"names":[],"mappings":";AAIA,OAAO,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAC;AAE7C,QAAA,MAAM,UAAU;;;EA8Cd,CAAC;AAwCH,eAAe,UAAU,CAAC"}

package/dist/examples/fuzzy-test-example.d.ts

@@ -1,8 +0,0 @@
-#!/usr/bin/env bun
-import { ArgParser } from "../src/ArgParser";
-declare const exampleParser: ArgParser<{
-    action: string;
-    args: any;
-}>;
-export default exampleParser;
-//# sourceMappingURL=fuzzy-test-example.d.ts.map

package/dist/examples/fuzzy-test-example.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"fuzzy-test-example.d.ts","sourceRoot":"","sources":["../../examples/fuzzy-test-example.ts"],"names":[],"mappings":";AAEA,OAAO,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAC;AAI7C,QAAA,MAAM,aAAa;;;EAsLjB,CAAC;AA+DH,eAAe,aAAa,CAAC"}

package/dist/examples/fzf-search-cli.d.ts

@@ -1,8 +0,0 @@
-#!/usr/bin/env bun
-export interface IFzfSearchResult {
-    files: string[];
-    error?: string;
-    commandExecuted?: string;
-    stderrOutput?: string;
-}
-//# sourceMappingURL=fzf-search-cli.d.ts.map

package/dist/examples/fzf-search-cli.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"fzf-search-cli.d.ts","sourceRoot":"","sources":["../../examples/fzf-search-cli.ts"],"names":[],"mappings":";AAUA,MAAM,WAAW,gBAAgB;IAC/B,KAAK,EAAE,MAAM,EAAE,CAAC;IAChB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB"}

package/dist/examples/getting-started.d.ts

@@ -1,27 +0,0 @@
-#!/usr/bin/env bun
-/**
- * Getting Started with ArgParser
- *
- * This is a complete, executable CLI that demonstrates the most common ArgParser patterns.
- * It's a file processing tool that showcases:
- * - Basic flags (string, number, boolean, array)
- * - Sub-commands with their own flags
- * - MCP server integration
- * - Modern best practices
- *
- * Usage:
- *   bun examples/getting-started.ts --input file.txt --output result.txt
- *   bun examples/getting-started.ts convert --input file.txt --format json
- *   bun examples/getting-started.ts serve  # Start MCP server
- *   bun examples/getting-started.ts --help
- */
-import { ArgParser } from "../src";
-declare const cli: ArgParser<{
-    success: boolean;
-    processed: any;
-    output: any;
-    format: any;
-    tags: any;
-}>;
-export default cli;
-//# sourceMappingURL=getting-started.d.ts.map

package/dist/examples/getting-started.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"getting-started.d.ts","sourceRoot":"","sources":["../../examples/getting-started.ts"],"names":[],"mappings":";AAEA;;;;;;;;;;;;;;;GAeG;AAEH,OAAO,EAAE,SAAS,EAAE,MAAM,QAAQ,CAAC;AAGnC,QAAA,MAAM,GAAG;;;;;;EAoKP,CAAC;AAGH,eAAe,GAAG,CAAC"}

package/dist/examples/mcp-preset-transports.d.ts

@@ -1,19 +0,0 @@
-#!/usr/bin/env bun
-/**
- * Example: MCP Preset Transport Configuration
- *
- * This example demonstrates how to configure preset MCP transports
- * that will be used when no CLI transport flags are provided.
- *
- * Usage:
- *   bun examples/mcp-preset-transports.ts --input "Hello World"
- *   bun examples/mcp-preset-transports.ts serve  # Uses preset transports
- *   bun examples/mcp-preset-transports.ts serve --transport sse --port 4000  # Overrides presets
- */
-import { ArgParser } from "../src";
-import type { McpTransportConfig } from "../src";
-declare const defaultTransports: McpTransportConfig[];
-declare const cli: ArgParser<any>;
-declare const cliWithSinglePreset: ArgParser<any>;
-export { cli, cliWithSinglePreset, defaultTransports };
-//# sourceMappingURL=mcp-preset-transports.d.ts.map

package/dist/examples/mcp-preset-transports.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"mcp-preset-transports.d.ts","sourceRoot":"","sources":["../../examples/mcp-preset-transports.ts"],"names":[],"mappings":";AACA;;;;;;;;;;GAUG;AAEH,OAAO,EAAE,SAAS,EAAE,MAAM,QAAQ,CAAC;AACnC,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,QAAQ,CAAC;AAGjD,QAAA,MAAM,iBAAiB,EAAE,kBAAkB,EAI1C,CAAC;AAGF,QAAA,MAAM,GAAG,gBA2EP,CAAC;AAGH,QAAA,MAAM,mBAAmB,gBAyBvB,CAAC;AAsBH,OAAO,EAAE,GAAG,EAAE,mBAAmB,EAAE,iBAAiB,EAAE,CAAC"}

package/dist/examples/simple-cli.d.ts

@@ -1,26 +0,0 @@
-#!/usr/bin/env bun
-/**
- * Simple CLI Example - demonstrates basic ArgParser usage
- *
- * This example shows how to create a simple CLI tool with:
- * - Basic flags with different types
- * - Mandatory and optional flags
- * - Default values
- * - Enum validation
- * - Help generation
- *
- * Usage:
- *   bun examples/simple-cli.ts --env production --port 8080 --verbose
- *   bun examples/simple-cli.ts --help
- */
-import { ArgParser } from "../src";
-declare const parser: ArgParser<{
-    success: boolean;
-    environment: any;
-    port: any;
-    verbose: any;
-    files: any;
-    output: any;
-}>;
-export default parser;
-//# sourceMappingURL=simple-cli.d.ts.map

package/dist/examples/simple-cli.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"simple-cli.d.ts","sourceRoot":"","sources":["../../examples/simple-cli.ts"],"names":[],"mappings":";AACA;;;;;;;;;;;;;GAaG;AACH,OAAO,EAAE,SAAS,EAAE,MAAM,QAAQ,CAAC;AAGnC,QAAA,MAAM,MAAM;;;;;;;EA6EV,CAAC;AAGH,eAAe,MAAM,CAAC"}

package/dist/examples/v1.1.0-showcase.d.ts

@@ -1,16 +0,0 @@
-#!/usr/bin/env bun
-/**
- * ArgParser v1.1.0 Feature Showcase - File Search & Processing Tool
- *
- * This example demonstrates all the new features in version 1.1.0 with REAL functionality:
- * 1. System flags (--s-*): --s-debug, --s-debug-print, --s-with-env, --s-save-to-env
- * 2. Environment variable loading from multiple file formats (.env, .yaml, .json, .toml)
- * 3. Configuration export to multiple file formats
- * 4. MCP server integration with multiple transport types
- * 5. Enhanced error handling and validation
- * 6. Real file search using fzf and file processing capabilities
- */
-import { ArgParser } from "../src";
-declare const cli: ArgParser<any>;
-export default cli;
-//# sourceMappingURL=v1.1.0-showcase.d.ts.map

package/dist/examples/v1.1.0-showcase.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"v1.1.0-showcase.d.ts","sourceRoot":"","sources":["../../examples/v1.1.0-showcase.ts"],"names":[],"mappings":";AAEA;;;;;;;;;;GAUG;AAEH,OAAO,EAAE,SAAS,EAAE,MAAM,QAAQ,CAAC;AA0HnC,QAAA,MAAM,GAAG,gBAoQP,CAAA;AAIF,eAAe,GAAG,CAAC"}

package/dist/examples/with-env-example.d.ts

@@ -1,3 +0,0 @@
-#!/usr/bin/env bun
-export {};
-//# sourceMappingURL=with-env-example.d.ts.map

package/dist/examples/with-env-example.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"with-env-example.d.ts","sourceRoot":"","sources":["../../examples/with-env-example.ts"],"names":[],"mappings":""}