@alcyone-labs/arg-parser 2.14.1 → 3.0.0-beta.1

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

@@ -1,86 +0,0 @@
-import type { ZodTypeAny } from "zod";
-import { ArgParserBase } from "../core/ArgParserBase";
-import type { IFlag, ProcessedFlag, TParsedArgs } from "../core/types";
-/**
- * Standard MCP response format
- */
-export interface McpResponse {
-    content: Array<{
-        type: "text";
-        text: string;
-    }>;
-    isError?: boolean;
-    structuredContent?: any;
-}
-/**
- * Create a standardized MCP success response
- */
-export declare function createMcpSuccessResponse(data: any): McpResponse;
-/**
- * Create a standardized MCP error response
- */
-export declare function createMcpErrorResponse(error: string | Error): McpResponse;
-/**
- * Convert a single ArgParser flag to JSON Schema property
- */
-export declare function convertFlagToJsonSchemaProperty(flag: IFlag | ProcessedFlag): {
-    property: any;
-    isRequired: boolean;
-};
-/**
- * Convert ArgParser flags to MCP JSON Schema
- */
-export declare function convertFlagsToJsonSchema(flags: readonly (IFlag | ProcessedFlag)[]): {
-    type: "object";
-    properties: Record<string, any>;
-    required: string[];
-};
-/**
- * Convert ArgParser flags to Zod schema for MCP tools
- */
-export declare function convertFlagsToZodSchema(flags: readonly (IFlag | ProcessedFlag)[]): ZodTypeAny;
-/**
- * Simplified response format for testing and validation
- */
-export interface SimplifiedToolResponse {
-    success: boolean;
-    data?: any;
-    error?: string;
-    message?: string;
-    exitCode?: number;
-}
-/**
- * Extract simplified response from MCP protocol response
- */
-export declare function extractSimplifiedResponse(mcpResponse: any): SimplifiedToolResponse;
-export interface IMcpToolStructure {
-    name: string;
-    description?: string;
-    inputSchema: ZodTypeAny;
-    outputSchema?: ZodTypeAny;
-    execute: (args: any) => Promise<any>;
-    executeForTesting?: (args: any) => Promise<SimplifiedToolResponse>;
-}
-export interface GenerateMcpToolsOptions {
-    outputSchemaMap?: Record<string, ZodTypeAny>;
-    defaultOutputSchema?: ZodTypeAny;
-    /** Automatically generate output schemas for tools that don't have explicit schemas */
-    autoGenerateOutputSchema?: boolean | keyof typeof import("../core/types").OutputSchemaPatterns;
-    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/mcp/mcp-integration.d.ts.map

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

package/dist/mcp/mcp-lifecycle.d.ts

@@ -1,163 +0,0 @@
-/**
- * MCP Lifecycle Events System
- *
- * This module provides lifecycle event hooks for MCP servers, allowing applications
- * to perform initialization, cleanup, and other lifecycle-related operations at
- * specific points in the MCP protocol flow.
- */
-/**
- * Base context interface shared by all lifecycle events
- */
-export interface McpLifecycleBaseContext {
-    /** Get a parsed flag value by name */
-    getFlag(name: string): any;
-    /** MCP logger instance for this context */
-    logger: any;
-    /** Server information */
-    serverInfo: {
-        name: string;
-        version: string;
-        description?: string;
-    };
-}
-/**
- * Context provided during the MCP initialize request
- * This is called when a client sends the "initialize" request
- */
-export interface McpInitializeContext extends McpLifecycleBaseContext {
-    /** Client information from the initialize request */
-    clientInfo: {
-        name: string;
-        version: string;
-        title?: string;
-    };
-    /** Protocol version being used */
-    protocolVersion: string;
-    /** Client capabilities */
-    clientCapabilities: Record<string, any>;
-}
-/**
- * Context provided after the MCP initialized notification
- * This is called when a client sends the "initialized" notification
- */
-export interface McpInitializedContext extends McpLifecycleBaseContext {
-    /** Client information from the previous initialize request */
-    clientInfo: {
-        name: string;
-        version: string;
-        title?: string;
-    };
-    /** Protocol version being used */
-    protocolVersion: string;
-}
-/**
- * Context provided during server shutdown
- * This is called when the MCP server is being shut down
- */
-export interface McpShutdownContext extends McpLifecycleBaseContext {
-    /** Reason for shutdown */
-    reason: "client_disconnect" | "server_shutdown" | "error" | "signal";
-    /** Optional error if shutdown was due to an error */
-    error?: Error;
-}
-/**
- * Lifecycle event handlers interface
- */
-export interface McpLifecycleEvents {
-    /**
-     * Called when a client sends an "initialize" request
-     * This is the first lifecycle event and is ideal for:
-     * - Database connection setup
-     * - Resource initialization
-     * - Configuration validation
-     * - Authentication setup
-     */
-    onInitialize?: (context: McpInitializeContext) => Promise<void>;
-    /**
-     * Called when a client sends an "initialized" notification
-     * This indicates the client is ready for normal operations
-     * This is ideal for:
-     * - Final setup steps
-     * - Background task initialization
-     * - Health checks
-     */
-    onInitialized?: (context: McpInitializedContext) => Promise<void>;
-    /**
-     * Called when the MCP server is shutting down
-     * This is ideal for:
-     * - Database connection cleanup
-     * - Resource disposal
-     * - Graceful shutdown procedures
-     */
-    onShutdown?: (context: McpShutdownContext) => Promise<void>;
-}
-/**
- * Internal state tracking for lifecycle events
- */
-export interface McpLifecycleState {
-    /** Whether the initialize event has been called */
-    initialized: boolean;
-    /** Whether the initialized event has been called */
-    ready: boolean;
-    /** Whether shutdown has been initiated */
-    shuttingDown: boolean;
-    /** Stored client info from initialize */
-    clientInfo?: {
-        name: string;
-        version: string;
-        title?: string;
-    };
-    /** Protocol version being used */
-    protocolVersion?: string;
-    /** Client capabilities */
-    clientCapabilities?: Record<string, any>;
-}
-/**
- * Lifecycle manager class for handling MCP lifecycle events
- */
-export declare class McpLifecycleManager {
-    private events;
-    private logger;
-    private serverInfo;
-    private argParser?;
-    private state;
-    private parsedArgs;
-    constructor(events: McpLifecycleEvents, logger: any, serverInfo: {
-        name: string;
-        version: string;
-        description?: string;
-    }, argParser?: any | undefined);
-    /**
-     * Set the parsed arguments for flag access
-     */
-    setParsedArgs(parsedArgs: any): void;
-    /**
-     * Get a flag value from parsed arguments or environment variables
-     */
-    private getFlag;
-    /**
-     * Handle the initialize request
-     */
-    handleInitialize(clientInfo: {
-        name: string;
-        version: string;
-        title?: string;
-    }, protocolVersion: string, clientCapabilities: Record<string, any>): Promise<void>;
-    /**
-     * Handle the initialized notification
-     */
-    handleInitialized(): Promise<void>;
-    /**
-     * Handle server shutdown
-     */
-    handleShutdown(reason: "client_disconnect" | "server_shutdown" | "error" | "signal", error?: Error): Promise<void>;
-    /**
-     * Get current lifecycle state
-     */
-    getState(): Readonly<McpLifecycleState>;
-    /**
-     * Check if the server is ready for operations
-     */
-    isReady(): boolean;
-}
-//# sourceMappingURL=mcp-lifecycle.d.ts.map

package/dist/mcp/mcp-lifecycle.d.ts.map

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

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

@@ -1,132 +0,0 @@
-/**
- * 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

@@ -1 +0,0 @@
-{"version":3,"file":"mcp-notifications.d.ts","sourceRoot":"","sources":["../../src/mcp/mcp-notifications.ts"],"names":[],"mappings":"AAUA;;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,CACV,IAAI,EAAE,aAAa,EACnB,MAAM,EAAE,OAAO,GAAG,SAAS,GAAG,SAAS,EACvC,UAAU,CAAC,EAAE,MAAM,GAClB,IAAI;IA4BP;;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,CA2B7F;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,CAQjF;AAED;;GAEG;AACH,eAAO,MAAM,0BAA0B,yBAAgC,CAAC"}

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

@@ -1,132 +0,0 @@
-/**
- * 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 { type 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

@@ -1 +0,0 @@
-{"version":3,"file":"mcp-prompts.d.ts","sourceRoot":"","sources":["../../src/mcp/mcp-prompts.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAK,KAAK,UAAU,EAAE,MAAM,KAAK,CAAC;AAKzC;;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,eAwBxC,CAAC;AAEH;;GAEG;AACH,eAAO,MAAM,yBAAyB,QAAO,eAqC3C,CAAC;AAEH;;GAEG;AACH,eAAO,MAAM,uBAAuB,QAAO,eAgCzC,CAAC;AAEH;;GAEG;AACH,eAAO,MAAM,yBAAyB,QAAO,eA8B3C,CAAC"}

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

@@ -1,150 +0,0 @@
-/**
- * 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