@defai.digital/ax-cli 3.14.17 → 3.15.0

package/dist/mcp/progress.d.ts

@@ -0,0 +1,147 @@
+/**
+ * MCP Progress Notifications
+ *
+ * Handles progress tracking for long-running MCP operations.
+ * MCP Specification: notifications/progress
+ *
+ * @module mcp/progress
+ */
+import { EventEmitter } from 'events';
+/**
+ * Progress update from MCP server
+ */
+export interface ProgressUpdate {
+    /** Progress token identifying the operation */
+    token: string | number;
+    /** Progress value (0.0 - 1.0) */
+    progress: number;
+    /** Total number of items (optional) */
+    total?: number;
+    /** Current item number (optional) */
+    current?: number;
+    /** Status message (optional) */
+    message?: string;
+    /** Timestamp of this update */
+    timestamp: Date;
+}
+/**
+ * Progress callback function type
+ */
+export type ProgressCallback = (update: ProgressUpdate) => void;
+/**
+ * Progress tracker for MCP operations
+ *
+ * Manages progress tokens and dispatches progress updates to registered callbacks.
+ *
+ * @example
+ * ```typescript
+ * const tracker = new ProgressTracker();
+ * const token = tracker.createToken();
+ *
+ * tracker.onProgress(token, (update) => {
+ *   console.log(`Progress: ${Math.floor(update.progress * 100)}%`);
+ * });
+ *
+ * // When notification arrives from server:
+ * tracker.handleNotification({ progressToken: token, progress: 0.5 });
+ * ```
+ */
+export declare class ProgressTracker extends EventEmitter {
+    private callbacks;
+    private startTimes;
+    private lastUpdates;
+    /**
+     * Create a unique progress token
+     */
+    createToken(): string;
+    /**
+     * Register a progress callback for a token
+     *
+     * @param token - Progress token
+     * @param callback - Function to call on progress updates
+     */
+    onProgress(token: string | number, callback: ProgressCallback): void;
+    /**
+     * Handle a progress notification from the server
+     *
+     * @param params - Notification parameters
+     */
+    handleNotification(params: {
+        progressToken: string | number;
+        progress: number;
+        total?: number;
+        message?: string;
+    }): void;
+    /**
+     * Get elapsed time for a progress token
+     *
+     * @param token - Progress token
+     * @returns Elapsed time in milliseconds, or undefined if token not found
+     */
+    getElapsedTime(token: string | number): number | undefined;
+    /**
+     * Get the last progress update for a token
+     *
+     * @param token - Progress token
+     * @returns Last progress update, or undefined if none
+     */
+    getLastUpdate(token: string | number): ProgressUpdate | undefined;
+    /**
+     * Check if a token is being tracked
+     *
+     * @param token - Progress token
+     * @returns true if token is registered
+     */
+    isTracking(token: string | number): boolean;
+    /**
+     * Get all active progress tokens
+     *
+     * @returns Array of active tokens
+     */
+    getActiveTokens(): (string | number)[];
+    /**
+     * Cleanup a completed progress tracking
+     *
+     * @param token - Progress token to cleanup
+     */
+    cleanup(token: string | number): void;
+    /**
+     * Cleanup all progress tracking
+     */
+    cleanupAll(): void;
+    /**
+     * Estimate remaining time based on progress
+     *
+     * @param token - Progress token
+     * @returns Estimated remaining time in ms, or undefined if cannot estimate
+     */
+    estimateRemainingTime(token: string | number): number | undefined;
+}
+/**
+ * Format progress for display
+ *
+ * @param update - Progress update
+ * @param options - Formatting options
+ * @returns Formatted progress string
+ */
+export declare function formatProgress(update: ProgressUpdate, options?: {
+    width?: number;
+    showPercentage?: boolean;
+    showCount?: boolean;
+    showMessage?: boolean;
+}): string;
+/**
+ * Format elapsed time for display
+ *
+ * @param ms - Time in milliseconds
+ * @returns Formatted time string
+ */
+export declare function formatElapsedTime(ms: number): string;
+/**
+ * Get the singleton progress tracker instance
+ */
+export declare function getProgressTracker(): ProgressTracker;
+/**
+ * Reset the progress tracker (for testing)
+ */
+export declare function resetProgressTracker(): void;

package/dist/mcp/progress.js

@@ -0,0 +1,210 @@
+/**
+ * MCP Progress Notifications
+ *
+ * Handles progress tracking for long-running MCP operations.
+ * MCP Specification: notifications/progress
+ *
+ * @module mcp/progress
+ */
+import { randomUUID } from 'crypto';
+import { EventEmitter } from 'events';
+/**
+ * Progress tracker for MCP operations
+ *
+ * Manages progress tokens and dispatches progress updates to registered callbacks.
+ *
+ * @example
+ * ```typescript
+ * const tracker = new ProgressTracker();
+ * const token = tracker.createToken();
+ *
+ * tracker.onProgress(token, (update) => {
+ *   console.log(`Progress: ${Math.floor(update.progress * 100)}%`);
+ * });
+ *
+ * // When notification arrives from server:
+ * tracker.handleNotification({ progressToken: token, progress: 0.5 });
+ * ```
+ */
+export class ProgressTracker extends EventEmitter {
+    callbacks = new Map();
+    startTimes = new Map();
+    lastUpdates = new Map();
+    /**
+     * Create a unique progress token
+     */
+    createToken() {
+        return randomUUID();
+    }
+    /**
+     * Register a progress callback for a token
+     *
+     * @param token - Progress token
+     * @param callback - Function to call on progress updates
+     */
+    onProgress(token, callback) {
+        this.callbacks.set(token, callback);
+        this.startTimes.set(token, Date.now());
+    }
+    /**
+     * Handle a progress notification from the server
+     *
+     * @param params - Notification parameters
+     */
+    handleNotification(params) {
+        const callback = this.callbacks.get(params.progressToken);
+        const update = {
+            token: params.progressToken,
+            progress: Math.max(0, Math.min(1, params.progress)), // Clamp to 0-1
+            total: params.total,
+            current: params.total ? Math.floor(params.progress * params.total) : undefined,
+            message: params.message,
+            timestamp: new Date(),
+        };
+        // Store last update
+        this.lastUpdates.set(params.progressToken, update);
+        // Call registered callback
+        if (callback) {
+            callback(update);
+        }
+        // Emit event for global listeners
+        this.emit('progress', update);
+    }
+    /**
+     * Get elapsed time for a progress token
+     *
+     * @param token - Progress token
+     * @returns Elapsed time in milliseconds, or undefined if token not found
+     */
+    getElapsedTime(token) {
+        const start = this.startTimes.get(token);
+        return start ? Date.now() - start : undefined;
+    }
+    /**
+     * Get the last progress update for a token
+     *
+     * @param token - Progress token
+     * @returns Last progress update, or undefined if none
+     */
+    getLastUpdate(token) {
+        return this.lastUpdates.get(token);
+    }
+    /**
+     * Check if a token is being tracked
+     *
+     * @param token - Progress token
+     * @returns true if token is registered
+     */
+    isTracking(token) {
+        return this.callbacks.has(token);
+    }
+    /**
+     * Get all active progress tokens
+     *
+     * @returns Array of active tokens
+     */
+    getActiveTokens() {
+        return Array.from(this.callbacks.keys());
+    }
+    /**
+     * Cleanup a completed progress tracking
+     *
+     * @param token - Progress token to cleanup
+     */
+    cleanup(token) {
+        this.callbacks.delete(token);
+        this.startTimes.delete(token);
+        // Keep last update briefly for final status queries
+        setTimeout(() => {
+            this.lastUpdates.delete(token);
+        }, 5000);
+    }
+    /**
+     * Cleanup all progress tracking
+     */
+    cleanupAll() {
+        const tokens = this.getActiveTokens();
+        for (const token of tokens) {
+            this.cleanup(token);
+        }
+    }
+    /**
+     * Estimate remaining time based on progress
+     *
+     * @param token - Progress token
+     * @returns Estimated remaining time in ms, or undefined if cannot estimate
+     */
+    estimateRemainingTime(token) {
+        const elapsed = this.getElapsedTime(token);
+        const update = this.getLastUpdate(token);
+        if (!elapsed || !update || update.progress <= 0 || update.progress >= 1) {
+            return undefined;
+        }
+        const totalEstimate = elapsed / update.progress;
+        return Math.max(0, totalEstimate - elapsed);
+    }
+}
+/**
+ * Format progress for display
+ *
+ * @param update - Progress update
+ * @param options - Formatting options
+ * @returns Formatted progress string
+ */
+export function formatProgress(update, options = {}) {
+    const { width = 30, showPercentage = true, showCount = true, showMessage = true, } = options;
+    const percentage = Math.floor(update.progress * 100);
+    const filled = Math.floor(update.progress * width);
+    const empty = width - filled;
+    let result = `[${'█'.repeat(filled)}${'░'.repeat(empty)}]`;
+    if (showPercentage) {
+        result += ` ${percentage}%`;
+    }
+    if (showCount && update.total !== undefined && update.current !== undefined) {
+        result += ` (${update.current}/${update.total})`;
+    }
+    if (showMessage && update.message) {
+        result += `\n${update.message}`;
+    }
+    return result;
+}
+/**
+ * Format elapsed time for display
+ *
+ * @param ms - Time in milliseconds
+ * @returns Formatted time string
+ */
+export function formatElapsedTime(ms) {
+    if (ms < 1000) {
+        return `${ms}ms`;
+    }
+    const seconds = Math.floor(ms / 1000);
+    if (seconds < 60) {
+        return `${seconds}s`;
+    }
+    const minutes = Math.floor(seconds / 60);
+    const remainingSeconds = seconds % 60;
+    return `${minutes}m ${remainingSeconds}s`;
+}
+// Singleton instance
+let progressTracker = null;
+/**
+ * Get the singleton progress tracker instance
+ */
+export function getProgressTracker() {
+    if (!progressTracker) {
+        progressTracker = new ProgressTracker();
+    }
+    return progressTracker;
+}
+/**
+ * Reset the progress tracker (for testing)
+ */
+export function resetProgressTracker() {
+    if (progressTracker) {
+        progressTracker.cleanupAll();
+        progressTracker.removeAllListeners();
+    }
+    progressTracker = null;
+}
+//# sourceMappingURL=progress.js.map

package/dist/mcp/progress.js.map

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

package/dist/mcp/schema-validator.d.ts

@@ -0,0 +1,77 @@
+/**
+ * MCP Tool Output Schema Validation
+ *
+ * Validates tool outputs against their declared JSON schemas using Ajv.
+ * Uses the MCP SDK's AjvJsonSchemaValidator for consistency.
+ *
+ * MCP Specification: Tool Output Schemas (2025-06-18)
+ *
+ * @module mcp/schema-validator
+ */
+/**
+ * Schema validation result status
+ */
+export type SchemaValidationStatus = 'valid' | 'invalid' | 'no-schema';
+/**
+ * Schema validation result
+ */
+export interface SchemaValidationResult {
+    /** Validation status */
+    status: SchemaValidationStatus;
+    /** Validation errors (if status is 'invalid') */
+    errors?: string[];
+    /** The schema that was used for validation */
+    schema?: unknown;
+}
+/**
+ * Tool Output Schema Validator
+ *
+ * Validates MCP tool outputs against their declared JSON schemas.
+ *
+ * @example
+ * ```typescript
+ * const validator = new ToolOutputValidator();
+ *
+ * // Validate tool output
+ * const result = validator.validate(outputSchema, toolOutput);
+ *
+ * if (result.status === 'invalid') {
+ *   console.warn('Tool output validation failed:', result.errors);
+ * }
+ * ```
+ */
+export declare class ToolOutputValidator {
+    private validator;
+    constructor();
+    /**
+     * Validate tool output against schema
+     *
+     * @param schema - JSON schema to validate against (or undefined if no schema)
+     * @param output - Tool output to validate
+     * @returns Validation result
+     */
+    validate(schema: unknown, output: unknown): SchemaValidationResult;
+    /**
+     * Validate tool output content array
+     *
+     * MCP tool results return an array of content items.
+     * This method validates the extracted content.
+     *
+     * @param schema - JSON schema
+     * @param content - MCP tool result content array
+     * @returns Validation result
+     */
+    validateContent(schema: unknown, content: Array<{
+        type: string;
+        text?: string;
+        [key: string]: unknown;
+    }>): SchemaValidationResult;
+}
+/**
+ * Get the singleton validator instance
+ */
+export declare function getToolOutputValidator(): ToolOutputValidator;
+/**
+ * Reset the validator (for testing)
+ */
+export declare function resetToolOutputValidator(): void;

package/dist/mcp/schema-validator.js

@@ -0,0 +1,125 @@
+/**
+ * MCP Tool Output Schema Validation
+ *
+ * Validates tool outputs against their declared JSON schemas using Ajv.
+ * Uses the MCP SDK's AjvJsonSchemaValidator for consistency.
+ *
+ * MCP Specification: Tool Output Schemas (2025-06-18)
+ *
+ * @module mcp/schema-validator
+ */
+import { AjvJsonSchemaValidator } from '@modelcontextprotocol/sdk/validation/ajv';
+/**
+ * Tool Output Schema Validator
+ *
+ * Validates MCP tool outputs against their declared JSON schemas.
+ *
+ * @example
+ * ```typescript
+ * const validator = new ToolOutputValidator();
+ *
+ * // Validate tool output
+ * const result = validator.validate(outputSchema, toolOutput);
+ *
+ * if (result.status === 'invalid') {
+ *   console.warn('Tool output validation failed:', result.errors);
+ * }
+ * ```
+ */
+export class ToolOutputValidator {
+    validator;
+    constructor() {
+        this.validator = new AjvJsonSchemaValidator();
+    }
+    /**
+     * Validate tool output against schema
+     *
+     * @param schema - JSON schema to validate against (or undefined if no schema)
+     * @param output - Tool output to validate
+     * @returns Validation result
+     */
+    validate(schema, output) {
+        // No schema defined
+        if (schema === undefined || schema === null) {
+            return { status: 'no-schema' };
+        }
+        // Empty schema (matches anything)
+        if (typeof schema === 'object' && Object.keys(schema).length === 0) {
+            return { status: 'valid', schema };
+        }
+        try {
+            // Use the SDK's validator - getValidator returns a function
+            const validateFn = this.validator.getValidator(schema);
+            const result = validateFn(output);
+            if (result.valid) {
+                return { status: 'valid', schema };
+            }
+            // Extract error message
+            return {
+                status: 'invalid',
+                errors: result.errorMessage ? [result.errorMessage] : ['Validation failed'],
+                schema,
+            };
+        }
+        catch (error) {
+            // Schema compilation error
+            return {
+                status: 'invalid',
+                errors: [`Schema compilation error: ${error instanceof Error ? error.message : String(error)}`],
+                schema,
+            };
+        }
+    }
+    /**
+     * Validate tool output content array
+     *
+     * MCP tool results return an array of content items.
+     * This method validates the extracted content.
+     *
+     * @param schema - JSON schema
+     * @param content - MCP tool result content array
+     * @returns Validation result
+     */
+    validateContent(schema, content) {
+        if (schema === undefined || schema === null) {
+            return { status: 'no-schema' };
+        }
+        // Extract text content and try to parse as JSON
+        const textContent = content
+            .filter((item) => item.type === 'text' && item.text)
+            .map((item) => item.text)
+            .join('');
+        if (!textContent) {
+            // No text content to validate
+            return { status: 'valid', schema };
+        }
+        // Try to parse as JSON
+        let parsedOutput;
+        try {
+            parsedOutput = JSON.parse(textContent);
+        }
+        catch {
+            // Not JSON - validate as string if schema allows
+            parsedOutput = textContent;
+        }
+        return this.validate(schema, parsedOutput);
+    }
+}
+// Singleton instance
+let validatorInstance = null;
+/**
+ * Get the singleton validator instance
+ */
+export function getToolOutputValidator() {
+    if (!validatorInstance) {
+        validatorInstance = new ToolOutputValidator();
+    }
+    return validatorInstance;
+}
+/**
+ * Reset the validator (for testing)
+ */
+export function resetToolOutputValidator() {
+    validatorInstance = null;
+}
+//# sourceMappingURL=schema-validator.js.map

package/dist/mcp/schema-validator.js.map

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