@alcyone-labs/arg-parser 2.1.0 → 2.1.1

package/dist/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/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":"AAAA;;;;;GAKG;AAEH;;GAEG;AACH,MAAM,MAAM,aAAa,GAAG,OAAO,GAAG,WAAW,GAAG,SAAS,CAAC;AAE9D;;GAEG;AACH,MAAM,WAAW,cAAc;IAC7B,IAAI,EAAE,aAAa,CAAC;IACpB,SAAS,EAAE,IAAI,CAAC;IAChB,MAAM,EAAE,OAAO,GAAG,SAAS,GAAG,SAAS,CAAC;IACxC,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED;;GAEG;AACH,MAAM,MAAM,iBAAiB,GAAG,CAAC,KAAK,EAAE,cAAc,KAAK,IAAI,CAAC;AAEhE;;GAEG;AACH,MAAM,WAAW,qBAAqB;IACpC,QAAQ,EAAE,MAAM,CAAC;IACjB,aAAa,EAAE,GAAG,CAAC,aAAa,CAAC,CAAC;IAClC,UAAU,EAAE,GAAG,CAAC;CACjB;AAED;;;;GAIG;AACH,qBAAa,uBAAuB;IAClC,OAAO,CAAC,OAAO,CAA4C;IAC3D,OAAO,CAAC,eAAe,CAAgC;IACvD,OAAO,CAAC,aAAa,CAAwB;IAC7C,OAAO,CAAC,cAAc,CAAO;IAE7B;;OAEG;IACH,SAAS,CAAC,QAAQ,EAAE,MAAM,EAAE,UAAU,EAAE,GAAG,GAAG,IAAI;IAQlD;;OAEG;IACH,YAAY,CAAC,QAAQ,EAAE,MAAM,GAAG,IAAI;IAIpC;;OAEG;IACH,SAAS,CAAC,QAAQ,EAAE,MAAM,EAAE,IAAI,EAAE,aAAa,GAAG,IAAI;IAOtD;;OAEG;IACH,WAAW,CAAC,QAAQ,EAAE,MAAM,EAAE,IAAI,EAAE,aAAa,GAAG,IAAI;IAOxD;;OAEG;IACH,cAAc,CAAC,QAAQ,EAAE,MAAM,GAAG,IAAI;IAStC;;OAEG;IACH,kBAAkB,CAAC,QAAQ,EAAE,MAAM,GAAG,IAAI;IAO1C;;OAEG;IACH,sBAAsB,CAAC,QAAQ,EAAE,MAAM,GAAG,GAAG,CAAC,aAAa,CAAC,GAAG,SAAS;IAIxE;;OAEG;IACH,kBAAkB,CAAC,QAAQ,EAAE,MAAM,EAAE,IAAI,EAAE,aAAa,GAAG,OAAO;IAKlE;;OAEG;IACH,YAAY,CAAC,IAAI,EAAE,aAAa,EAAE,MAAM,EAAE,OAAO,GAAG,SAAS,GAAG,SAAS,EAAE,UAAU,CAAC,EAAE,MAAM,GAAG,IAAI;IA4BrG;;OAEG;IACH,iBAAiB,CAAC,QAAQ,EAAE,iBAAiB,GAAG,IAAI;IAIpD;;OAEG;IACH,oBAAoB,CAAC,QAAQ,EAAE,iBAAiB,GAAG,IAAI;IAIvD;;OAEG;IACH,gBAAgB,CAAC,KAAK,CAAC,EAAE,MAAM,GAAG,cAAc,EAAE;IAKlD;;OAEG;IACH,YAAY,IAAI,IAAI;IAIpB;;OAEG;IACH,cAAc,IAAI,MAAM;IAIxB;;OAEG;IACH,oBAAoB,IAAI,MAAM,CAAC,aAAa,EAAE,MAAM,CAAC;IAgBrD;;OAEG;IACH,OAAO,CAAC,wBAAwB;IAahC;;OAEG;IACH,OAAO,CAAC,YAAY;IASpB;;OAEG;IACH,iBAAiB,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI;IASrC;;OAEG;IACH,KAAK,IAAI,IAAI;CAKd;AAED;;GAEG;AAEH;;GAEG;AACH,wBAAgB,uBAAuB,CACrC,OAAO,EAAE,uBAAuB,EAChC,KAAK,GAAE,MAAY,GAClB,CAAC,IAAI,EAAE,aAAa,EAAE,MAAM,EAAE,OAAO,GAAG,SAAS,GAAG,SAAS,EAAE,UAAU,CAAC,EAAE,MAAM,KAAK,IAAI,CAoB7F;AAED;;GAEG;AACH,wBAAgB,sBAAsB,CACpC,KAAK,EAAE,aAAa,EAAE,EACtB,QAAQ,EAAE,iBAAiB,GAC1B,iBAAiB,CAMnB;AAED;;GAEG;AACH,wBAAgB,qBAAqB,CAAC,MAAM,GAAE,MAAgB,GAAG,iBAAiB,CAKjF;AAED;;GAEG;AACH,eAAO,MAAM,0BAA0B,yBAAgC,CAAC"}

package/dist/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/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/mcp/mcp-protocol-versions.d.ts

@@ -0,0 +1,150 @@
+/**
+ * MCP Protocol Version Configuration
+ *
+ * This module defines the supported MCP protocol versions and provides
+ * utilities for version negotiation according to the MCP specification.
+ *
+ * Version Negotiation Rules (per MCP specification):
+ * 1. If server supports the requested protocol version, it MUST respond with the same version
+ * 2. Otherwise, server MUST respond with another protocol version it supports
+ * 3. Server SHOULD respond with the latest version it supports
+ * 4. If client doesn't support the server's response version, it SHOULD disconnect
+ */
+/**
+ * Official MCP protocol versions in chronological order
+ * Based on the official MCP specification releases found in docs/MCP/modelcontextprotocol/docs/specification/
+ *
+ * According to versioning.mdx:
+ * - 2025-06-18 is the **current** protocol version
+ * - Previous versions are marked as **final** (complete, no changes)
+ * - Draft versions are in-progress specifications
+ */
+export declare const MCP_PROTOCOL_VERSIONS: readonly ["2024-11-05", "2025-03-26", "2025-06-18"];
+/**
+ * Draft protocol versions (in-progress specifications)
+ * These are not yet ready for production use
+ */
+export declare const MCP_DRAFT_VERSIONS: readonly ["draft"];
+/**
+ * All available protocol versions (stable + draft)
+ */
+export declare const ALL_MCP_VERSIONS: readonly ["2024-11-05", "2025-03-26", "2025-06-18", "draft"];
+/**
+ * Type for stable MCP protocol versions
+ */
+export type McpProtocolVersion = typeof MCP_PROTOCOL_VERSIONS[number];
+/**
+ * Type for draft MCP protocol versions
+ */
+export type McpDraftVersion = typeof MCP_DRAFT_VERSIONS[number];
+/**
+ * Type for all MCP protocol versions (stable + draft)
+ */
+export type McpAnyVersion = typeof ALL_MCP_VERSIONS[number];
+/**
+ * Current protocol version according to the official MCP specification
+ * This is marked as "current" in versioning.mdx and should be the preferred version
+ */
+export declare const CURRENT_MCP_PROTOCOL_VERSION: McpProtocolVersion;
+/**
+ * Default protocol version used by this implementation for backward compatibility
+ * We start with this version but can negotiate to newer versions
+ *
+ * Note: The official MCP SDK may support newer versions automatically.
+ * This constant represents our fallback/minimum version.
+ */
+export declare const DEFAULT_MCP_PROTOCOL_VERSION: McpProtocolVersion;
+/**
+ * Latest stable protocol version (highest version number from stable versions)
+ */
+export declare const LATEST_MCP_PROTOCOL_VERSION: McpProtocolVersion;
+/**
+ * Minimum supported protocol version (oldest stable version)
+ */
+export declare const MINIMUM_MCP_PROTOCOL_VERSION: McpProtocolVersion;
+/**
+ * Validates if a protocol version string follows the MCP format (YYYY-MM-DD or 'draft')
+ */
+export declare function isValidMcpVersionFormat(version: string): boolean;
+/**
+ * Checks if a protocol version is an official stable MCP version
+ */
+export declare function isOfficialMcpVersion(version: string): version is McpProtocolVersion;
+/**
+ * Checks if a protocol version is a draft MCP version
+ */
+export declare function isDraftMcpVersion(version: string): version is McpDraftVersion;
+/**
+ * Checks if a protocol version is any valid MCP version (stable or draft)
+ */
+export declare function isAnyMcpVersion(version: string): version is McpAnyVersion;
+/**
+ * Checks if a protocol version is supported by this implementation
+ * Note: The official MCP SDK may support additional versions automatically
+ */
+export declare function isSupportedByImplementation(version: string): boolean;
+/**
+ * Checks if a protocol version is recommended for production use
+ */
+export declare function isProductionReady(version: string): boolean;
+/**
+ * Performs version negotiation according to MCP specification
+ *
+ * @param requestedVersion The protocol version requested by the client
+ * @returns The protocol version the server should respond with
+ *
+ * According to MCP specification:
+ * - If server supports requested version → return SAME version (MUST)
+ * - If server doesn't support requested version → return different supported version (MUST)
+ * - Server SHOULD return latest version it supports
+ *
+ * Note: The actual MCP SDK may implement its own version negotiation.
+ */
+export declare function negotiateProtocolVersion(requestedVersion: string): McpAnyVersion;
+/**
+ * Gets comprehensive version compatibility information
+ */
+export declare function getVersionCompatibilityInfo(): {
+    stableVersions: ("2024-11-05" | "2025-03-26" | "2025-06-18")[];
+    currentVersion: "2024-11-05" | "2025-03-26" | "2025-06-18";
+    defaultVersion: "2024-11-05" | "2025-03-26" | "2025-06-18";
+    latestStableVersion: "2024-11-05" | "2025-03-26" | "2025-06-18";
+    minimumVersion: "2024-11-05" | "2025-03-26" | "2025-06-18";
+    draftVersions: "draft"[];
+    allSupportedVersions: ("2024-11-05" | "2025-03-26" | "2025-06-18" | "draft")[];
+    versionStatus: {
+        '2024-11-05': string;
+        '2025-03-26': string;
+        '2025-06-18': string;
+        draft: string;
+    };
+};
+/**
+ * Compares two MCP protocol versions
+ * Returns: -1 if v1 < v2, 0 if v1 === v2, 1 if v1 > v2
+ */
+export declare function compareVersions(v1: string, v2: string): number;
+/**
+ * Finds the highest version from a list of versions
+ */
+export declare function getHighestVersion(versions: string[]): string | null;
+/**
+ * Comprehensive test data for version negotiation testing
+ */
+export declare const VERSION_TEST_DATA: {
+    readonly stableVersions: readonly ["2024-11-05", "2025-03-26", "2025-06-18"];
+    readonly draftVersions: readonly ["draft"];
+    readonly allSupportedVersions: readonly ["2024-11-05", "2025-03-26", "2025-06-18", "draft"];
+    readonly unsupportedVersions: readonly ["2020-01-01", "2023-01-01", "2024-01-01", "2030-12-31", "2026-01-01"];
+    readonly malformedVersions: readonly ["", "invalid", "2024", "2024-13-01", "2024-01-32", "v2024-11-05", "2024.11.05", "24-11-05", "2024-11-5", "beta", "v1.0.0"];
+    readonly expectedNegotiations: {
+        readonly '2024-11-05': "2024-11-05";
+        readonly '2025-03-26': "2025-03-26";
+        readonly '2025-06-18': "2025-06-18";
+        readonly draft: "2025-06-18";
+        readonly '2020-01-01': "2025-06-18";
+        readonly '2030-12-31': "2025-06-18";
+        readonly invalid: "2025-06-18";
+    };
+};
+//# sourceMappingURL=mcp-protocol-versions.d.ts.map

package/dist/mcp/mcp-protocol-versions.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mcp-protocol-versions.d.ts","sourceRoot":"","sources":["../../src/mcp/mcp-protocol-versions.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH;;;;;;;;GAQG;AACH,eAAO,MAAM,qBAAqB,qDAIxB,CAAC;AAEX;;;GAGG;AACH,eAAO,MAAM,kBAAkB,oBAErB,CAAC;AAEX;;GAEG;AACH,eAAO,MAAM,gBAAgB,8DAA6D,CAAC;AAE3F;;GAEG;AACH,MAAM,MAAM,kBAAkB,GAAG,OAAO,qBAAqB,CAAC,MAAM,CAAC,CAAC;AAEtE;;GAEG;AACH,MAAM,MAAM,eAAe,GAAG,OAAO,kBAAkB,CAAC,MAAM,CAAC,CAAC;AAEhE;;GAEG;AACH,MAAM,MAAM,aAAa,GAAG,OAAO,gBAAgB,CAAC,MAAM,CAAC,CAAC;AAE5D;;;GAGG;AACH,eAAO,MAAM,4BAA4B,EAAE,kBAAiC,CAAC;AAE7E;;;;;;GAMG;AACH,eAAO,MAAM,4BAA4B,EAAE,kBAAiC,CAAC;AAE7E;;GAEG;AACH,eAAO,MAAM,2BAA2B,EAAE,kBACe,CAAC;AAE1D;;GAEG;AACH,eAAO,MAAM,4BAA4B,EAAE,kBAA6C,CAAC;AAEzF;;GAEG;AACH,wBAAgB,uBAAuB,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAEhE;AAED;;GAEG;AACH,wBAAgB,oBAAoB,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,IAAI,kBAAkB,CAEnF;AAED;;GAEG;AACH,wBAAgB,iBAAiB,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,IAAI,eAAe,CAE7E;AAED;;GAEG;AACH,wBAAgB,eAAe,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,IAAI,aAAa,CAEzE;AAED;;;GAGG;AACH,wBAAgB,2BAA2B,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAIpE;AAED;;GAEG;AACH,wBAAgB,iBAAiB,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAG1D;AAED;;;;;;;;;;;;GAYG;AACH,wBAAgB,wBAAwB,CAAC,gBAAgB,EAAE,MAAM,GAAG,aAAa,CAmBhF;AAED;;GAEG;AACH,wBAAgB,2BAA2B;;;;;;;;;;;;;;EAuB1C;AAED;;;GAGG;AACH,wBAAgB,eAAe,CAAC,EAAE,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,GAAG,MAAM,CAG9D;AAED;;GAEG;AACH,wBAAgB,iBAAiB,CAAC,QAAQ,EAAE,MAAM,EAAE,GAAG,MAAM,GAAG,IAAI,CAMnE;AAED;;GAEG;AACH,eAAO,MAAM,iBAAiB;;;;;;;;;;;;;;;CA4CpB,CAAC"}

package/dist/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/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/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/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/testing/fuzzy-tester.d.ts

@@ -0,0 +1,101 @@
+import type { ArgParserBase } from "../core/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