@defai.digital/ax-cli 4.4.6 → 4.4.10

package/dist/sdk/unified-logger.d.ts

@@ -1,173 +0,0 @@
-/**
- * Unified Logger - Shared logging system for AX <-> ax-cli integration
- *
- * Provides centralized log aggregation across AutomatosX and ax-cli
- * for easier debugging and monitoring.
- */
-import { EventEmitter } from 'events';
-/**
- * Log levels (ordered by severity)
- */
-export declare enum LogLevel {
-    DEBUG = 0,
-    INFO = 1,
-    WARN = 2,
-    ERROR = 3
-}
-/**
- * Log source identifiers
- */
-export type LogSource = string;
-/**
- * Log entry structure
- */
-export interface LogEntry {
-    /** Timestamp (milliseconds since epoch) */
-    timestamp: number;
-    /** Log level */
-    level: LogLevel;
-    /** Source of the log (agent ID, system name, etc.) */
-    source: LogSource;
-    /** Log message */
-    message: string;
-    /** Optional structured data */
-    data?: Record<string, unknown>;
-    /** Optional error object */
-    error?: {
-        message: string;
-        stack?: string;
-        name?: string;
-    };
-}
-/**
- * Log filter options
- */
-export interface LogFilter {
-    /** Minimum log level to include */
-    minLevel?: LogLevel;
-    /** Filter by source (exact match or regex) */
-    source?: string | RegExp;
-    /** Filter by time range */
-    since?: number;
-    until?: number;
-}
-/**
- * Unified Logger - Centralized logging for AX and ax-cli
- */
-export declare class UnifiedLogger extends EventEmitter {
-    private static instance;
-    private logs;
-    private maxLogSize;
-    private minLevel;
-    private constructor();
-    /**
-     * Get the singleton instance
-     */
-    static getInstance(): UnifiedLogger;
-    /**
-     * Reset the singleton (for testing)
-     */
-    static reset(): void;
-    /**
-     * Set the minimum log level to record
-     */
-    setMinLevel(level: LogLevel): void;
-    /**
-     * Set maximum number of log entries to keep in memory
-     */
-    setMaxLogSize(size: number): void;
-    /**
-     * Log a message
-     */
-    log(level: LogLevel, source: LogSource, message: string, data?: Record<string, unknown>, error?: Error): void;
-    /**
-     * Log debug message
-     */
-    debug(source: LogSource, message: string, data?: Record<string, unknown>): void;
-    /**
-     * Log info message
-     */
-    info(source: LogSource, message: string, data?: Record<string, unknown>): void;
-    /**
-     * Log warning message
-     */
-    warn(source: LogSource, message: string, data?: Record<string, unknown>): void;
-    /**
-     * Log error message
-     */
-    error(source: LogSource, message: string, error?: Error, data?: Record<string, unknown>): void;
-    /**
-     * Trim logs to max size (keep most recent)
-     */
-    private trimLogs;
-    /**
-     * Get all logs (optionally filtered)
-     *
-     * Returns deep copies of log entries to prevent external mutation of internal state.
-     */
-    getLogs(filter?: LogFilter): LogEntry[];
-    /**
-     * Get recent logs (last N entries)
-     *
-     * @param count - Number of recent entries to return (must be positive)
-     * @param filter - Optional filter to apply before selecting recent entries
-     * @returns Array of recent log entries
-     */
-    getRecentLogs(count: number, filter?: LogFilter): LogEntry[];
-    /**
-     * Subscribe to all log events
-     */
-    onLog(callback: (entry: LogEntry) => void): () => void;
-    /**
-     * Subscribe to specific log level
-     */
-    onLevel(level: LogLevel, callback: (entry: LogEntry) => void): () => void;
-    /**
-     * Clear all logs
-     */
-    clear(): void;
-    /**
-     * Get statistics about logs
-     */
-    getStats(): {
-        total: number;
-        byLevel: Record<string, number>;
-        bySources: Record<string, number>;
-        oldestTimestamp?: number;
-        newestTimestamp?: number;
-    };
-    /**
-     * Format a log entry as a string
-     */
-    format(entry: LogEntry, options?: {
-        includeTimestamp?: boolean;
-        includeSource?: boolean;
-    }): string;
-    /**
-     * Export logs as JSON
-     */
-    exportJSON(filter?: LogFilter): string;
-    /**
-     * Export logs as plain text
-     */
-    exportText(filter?: LogFilter, options?: {
-        includeTimestamp?: boolean;
-        includeSource?: boolean;
-    }): string;
-    /**
-     * Clean up resources and remove all event listeners.
-     */
-    destroy(): void;
-}
-/**
- * Get the global unified logger instance
- */
-export declare function getUnifiedLogger(): UnifiedLogger;
-/**
- * Helper: Get log level from string
- */
-export declare function parseLogLevel(level: string): LogLevel;
-/**
- * Helper: Get log level name
- */
-export declare function getLogLevelName(level: LogLevel): string;

package/dist/sdk/unified-logger.js

@@ -1,327 +0,0 @@
-/**
- * Unified Logger - Shared logging system for AX <-> ax-cli integration
- *
- * Provides centralized log aggregation across AutomatosX and ax-cli
- * for easier debugging and monitoring.
- */
-import { EventEmitter } from 'events';
-/**
- * Log levels (ordered by severity)
- */
-export var LogLevel;
-(function (LogLevel) {
-    LogLevel[LogLevel["DEBUG"] = 0] = "DEBUG";
-    LogLevel[LogLevel["INFO"] = 1] = "INFO";
-    LogLevel[LogLevel["WARN"] = 2] = "WARN";
-    LogLevel[LogLevel["ERROR"] = 3] = "ERROR";
-})(LogLevel || (LogLevel = {}));
-/**
- * Unified Logger - Centralized logging for AX and ax-cli
- */
-export class UnifiedLogger extends EventEmitter {
-    static instance = null;
-    logs = [];
-    maxLogSize = 1000; // Keep last 1000 log entries
-    minLevel = LogLevel.DEBUG;
-    constructor() {
-        super();
-        // Allow many listeners (multiple subscribers)
-        this.setMaxListeners(50);
-    }
-    /**
-     * Get the singleton instance
-     */
-    static getInstance() {
-        if (!UnifiedLogger.instance) {
-            UnifiedLogger.instance = new UnifiedLogger();
-        }
-        return UnifiedLogger.instance;
-    }
-    /**
-     * Reset the singleton (for testing)
-     */
-    static reset() {
-        if (UnifiedLogger.instance) {
-            UnifiedLogger.instance.clear();
-            UnifiedLogger.instance.removeAllListeners();
-            UnifiedLogger.instance = null;
-        }
-    }
-    /**
-     * Set the minimum log level to record
-     */
-    setMinLevel(level) {
-        this.minLevel = level;
-    }
-    /**
-     * Set maximum number of log entries to keep in memory
-     */
-    setMaxLogSize(size) {
-        this.maxLogSize = Math.max(100, size); // Minimum 100 entries
-        this.trimLogs();
-    }
-    /**
-     * Log a message
-     */
-    log(level, source, message, data, error) {
-        // Skip if below minimum level
-        if (level < this.minLevel) {
-            return;
-        }
-        // BUG FIX: Deep clone data to prevent external mutation of stored log entries
-        // Without this, external code could modify the data object (including nested objects)
-        // after logging and corrupt the internal log state
-        // Using structuredClone for proper deep cloning (preferred over JSON.parse/stringify)
-        const entry = {
-            timestamp: Date.now(),
-            level,
-            source,
-            message,
-            data: data ? structuredClone(data) : undefined,
-            error: error ? {
-                message: error.message,
-                stack: error.stack,
-                name: error.name,
-            } : undefined,
-        };
-        // Trim logs BEFORE adding to prevent exceeding maxLogSize
-        // This ensures the array never grows beyond the limit
-        if (this.logs.length >= this.maxLogSize) {
-            // Remove oldest entries to make room (keep last maxLogSize - 1 entries)
-            this.logs = this.logs.slice(-(this.maxLogSize - 1));
-        }
-        // Add to logs
-        this.logs.push(entry);
-        // BUG FIX: Emit separate deep copies of the entry to each event channel
-        // The stored entry must not be shared with listeners, as listeners could
-        // mutate it (including nested objects) and corrupt internal state.
-        // Each emission gets its own deep copy.
-        const emitEntry = () => ({
-            ...entry,
-            data: entry.data ? structuredClone(entry.data) : undefined,
-            error: entry.error ? { ...entry.error } : undefined,
-        });
-        this.emit('log', emitEntry());
-        this.emit(LogLevel[level].toLowerCase(), emitEntry());
-    }
-    /**
-     * Log debug message
-     */
-    debug(source, message, data) {
-        this.log(LogLevel.DEBUG, source, message, data);
-    }
-    /**
-     * Log info message
-     */
-    info(source, message, data) {
-        this.log(LogLevel.INFO, source, message, data);
-    }
-    /**
-     * Log warning message
-     */
-    warn(source, message, data) {
-        this.log(LogLevel.WARN, source, message, data);
-    }
-    /**
-     * Log error message
-     */
-    error(source, message, error, data) {
-        this.log(LogLevel.ERROR, source, message, data, error);
-    }
-    /**
-     * Trim logs to max size (keep most recent)
-     */
-    trimLogs() {
-        if (this.logs.length > this.maxLogSize) {
-            this.logs = this.logs.slice(-this.maxLogSize);
-        }
-    }
-    /**
-     * Get all logs (optionally filtered)
-     *
-     * Returns deep copies of log entries to prevent external mutation of internal state.
-     */
-    getLogs(filter) {
-        let filtered = [...this.logs];
-        if (filter) {
-            if (filter.minLevel !== undefined) {
-                const minLevel = filter.minLevel;
-                filtered = filtered.filter(log => log.level >= minLevel);
-            }
-            if (filter.source) {
-                const source = filter.source;
-                if (typeof source === 'string') {
-                    filtered = filtered.filter(log => log.source === source);
-                }
-                else if (source instanceof RegExp) {
-                    // Reset lastIndex before each filter to avoid stateful behavior with global regexes
-                    // Global regexes maintain lastIndex state between test() calls which can cause flaky results
-                    filtered = filtered.filter(log => {
-                        source.lastIndex = 0;
-                        return source.test(log.source);
-                    });
-                }
-            }
-            if (filter.since !== undefined) {
-                const since = filter.since;
-                filtered = filtered.filter(log => log.timestamp >= since);
-            }
-            if (filter.until !== undefined) {
-                const until = filter.until;
-                filtered = filtered.filter(log => log.timestamp <= until);
-            }
-        }
-        // BUG FIX: Return deep copies to prevent external mutation of internal log entries
-        // Without this, external code could modify the returned entries (including nested objects)
-        // and corrupt internal state
-        return filtered.map(log => ({
-            ...log,
-            // Deep copy nested objects using structuredClone for proper deep cloning
-            data: log.data ? structuredClone(log.data) : undefined,
-            error: log.error ? { ...log.error } : undefined,
-        }));
-    }
-    /**
-     * Get recent logs (last N entries)
-     *
-     * @param count - Number of recent entries to return (must be positive)
-     * @param filter - Optional filter to apply before selecting recent entries
-     * @returns Array of recent log entries
-     */
-    getRecentLogs(count, filter) {
-        // Validate count is a positive integer
-        const validCount = typeof count === 'number' && isFinite(count) && count > 0
-            ? Math.floor(count)
-            : 0;
-        if (validCount === 0) {
-            return [];
-        }
-        const logs = this.getLogs(filter);
-        return logs.slice(-validCount);
-    }
-    /**
-     * Subscribe to all log events
-     */
-    onLog(callback) {
-        this.on('log', callback);
-        return () => this.off('log', callback);
-    }
-    /**
-     * Subscribe to specific log level
-     */
-    onLevel(level, callback) {
-        const eventName = LogLevel[level].toLowerCase();
-        this.on(eventName, callback);
-        return () => this.off(eventName, callback);
-    }
-    /**
-     * Clear all logs
-     */
-    clear() {
-        this.logs = [];
-    }
-    /**
-     * Get statistics about logs
-     */
-    getStats() {
-        const byLevel = {
-            DEBUG: 0,
-            INFO: 0,
-            WARN: 0,
-            ERROR: 0,
-        };
-        const bySources = {};
-        for (const log of this.logs) {
-            // Count by level
-            byLevel[LogLevel[log.level]]++;
-            // Count by source
-            bySources[log.source] = (bySources[log.source] || 0) + 1;
-        }
-        return {
-            total: this.logs.length,
-            byLevel,
-            bySources,
-            oldestTimestamp: this.logs.length > 0 ? this.logs[0].timestamp : undefined,
-            newestTimestamp: this.logs.length > 0 ? this.logs[this.logs.length - 1].timestamp : undefined,
-        };
-    }
-    /**
-     * Format a log entry as a string
-     */
-    format(entry, options = {}) {
-        const parts = [];
-        // Timestamp
-        if (options.includeTimestamp !== false) {
-            const date = new Date(entry.timestamp);
-            parts.push(`[${date.toISOString()}]`);
-        }
-        // Level
-        const levelName = LogLevel[entry.level].padEnd(5);
-        parts.push(`[${levelName}]`);
-        // Source
-        if (options.includeSource !== false) {
-            parts.push(`[${entry.source}]`);
-        }
-        // Message
-        parts.push(entry.message);
-        // Data
-        if (entry.data) {
-            parts.push(JSON.stringify(entry.data));
-        }
-        // Error
-        if (entry.error) {
-            parts.push(`Error: ${entry.error.message}`);
-            if (entry.error.stack) {
-                parts.push(`\n${entry.error.stack}`);
-            }
-        }
-        return parts.join(' ');
-    }
-    /**
-     * Export logs as JSON
-     */
-    exportJSON(filter) {
-        const logs = this.getLogs(filter);
-        return JSON.stringify(logs, null, 2);
-    }
-    /**
-     * Export logs as plain text
-     */
-    exportText(filter, options) {
-        const logs = this.getLogs(filter);
-        return logs.map(log => this.format(log, options)).join('\n');
-    }
-    /**
-     * Clean up resources and remove all event listeners.
-     */
-    destroy() {
-        this.removeAllListeners();
-    }
-}
-/**
- * Get the global unified logger instance
- */
-export function getUnifiedLogger() {
-    return UnifiedLogger.getInstance();
-}
-/**
- * Helper: Get log level from string
- */
-export function parseLogLevel(level) {
-    const normalized = level.toUpperCase();
-    switch (normalized) {
-        case 'DEBUG': return LogLevel.DEBUG;
-        case 'INFO': return LogLevel.INFO;
-        case 'WARN': return LogLevel.WARN;
-        case 'WARNING': return LogLevel.WARN;
-        case 'ERROR': return LogLevel.ERROR;
-        default: return LogLevel.INFO;
-    }
-}
-/**
- * Helper: Get log level name
- */
-export function getLogLevelName(level) {
-    return LogLevel[level];
-}
-//# sourceMappingURL=unified-logger.js.map

package/dist/sdk/unified-logger.js.map

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

package/dist/sdk/version.d.ts

@@ -1,163 +0,0 @@
-/**
- * SDK Version Information
- *
- * Provides version constants for the AX CLI SDK.
- * Useful for debugging, logging, and version compatibility checks.
- *
- * ## Version Strategy
- *
- * AX CLI uses **dual versioning** to avoid confusion:
- *
- * - **CLI Version** (e.g., 3.8.0): Changes frequently with CLI features, bug fixes, UI updates
- * - **SDK Version** (e.g., 1.2.0): Only changes when SDK API changes (stable)
- *
- * This allows the CLI to evolve rapidly without implying SDK breaking changes.
- *
- * @packageDocumentation
- */
-/**
- * CLI tool version (from package.json)
- *
- * This is the version of the AX CLI command-line tool.
- * Changes frequently with CLI features, commands, and UI improvements.
- *
- * **Use this for:**
- * - Reporting CLI version to users
- * - Checking CLI compatibility
- * - Debugging CLI-specific issues
- *
- * **IMPORTANT**: Keep this in sync with package.json version!
- * TODO: Consider reading from package.json at build time
- */
-export declare const CLI_VERSION = "4.1.15";
-/**
- * SDK library version (semantic versioning for API stability)
- *
- * This is the version of the programmatic SDK API.
- * Only changes when SDK API changes (follows semantic versioning strictly).
- *
- * **Versioning rules:**
- * - **Major (x.0.0)**: Breaking changes to SDK API
- * - **Minor (1.x.0)**: New SDK features, backward compatible
- * - **Patch (1.2.x)**: Bug fixes only
- *
- * **Use this for:**
- * - npm dependency management
- * - Checking SDK API compatibility
- * - Version locking in package.json
- *
- * **Version history:**
- * - 1.0.0: Initial SDK release (SDK best practices)
- * - 1.1.0: Progress reporting, unified logging
- * - 1.2.0: MCP v2 API, lifecycle hooks, tool registry
- * - 1.3.0: Z.AI MCP integration (web search, web reader, vision)
- * - 1.4.0: Multi-provider support (ProviderContext, createGLMAgent, createGrokAgent, file locking)
- */
-export declare const SDK_VERSION = "1.4.0";
-/**
- * SDK API version (integer for major version tracking)
- *
- * This is incremented only for breaking changes to the SDK API.
- * Patch and minor versions keep the same API_VERSION.
- *
- * **Use this for:**
- * - Quick compatibility checks
- * - API feature detection
- *
- * **Version history:**
- * - 1: Initial SDK release (v1.0.0+)
- * - 2: (Reserved for future breaking changes)
- */
-export declare const SDK_API_VERSION = 1;
-/**
- * Get CLI version string
- *
- * @returns CLI version string in format "v{version}"
- *
- * @example
- * ```typescript
- * import { getCLIVersion } from '@defai.digital/ax-cli/sdk';
- *
- * console.log('CLI:', getCLIVersion());
- * // Output: "CLI: v4.1.14"
- * ```
- */
-export declare function getCLIVersion(): string;
-/**
- * Get SDK version string
- *
- * @returns SDK version string in format "v{version}"
- *
- * @example
- * ```typescript
- * import { getSDKVersion } from '@defai.digital/ax-cli/sdk';
- *
- * console.log('Using SDK:', getSDKVersion());
- * // Output: "Using SDK: v1.4.0"
- * ```
- */
-export declare function getSDKVersion(): string;
-/**
- * Get full SDK info (recommended for debugging)
- *
- * @returns Object with complete version details
- *
- * @example
- * ```typescript
- * import { getSDKInfo } from '@defai.digital/ax-cli/sdk';
- *
- * const info = getSDKInfo();
- * console.log(info);
- * // Output: {
- * //   cliVersion: "4.1.14",
- * //   sdkVersion: "1.4.0",
- * //   apiVersion: 1,
- * //   cliVersionString: "v4.1.14",
- * //   sdkVersionString: "v1.4.0"
- * // }
- * ```
- */
-export declare function getSDKInfo(): {
-    /** CLI tool version (changes frequently) */
-    cliVersion: string;
-    /** SDK library version (stable) */
-    sdkVersion: string;
-    /** SDK API version (major version only) */
-    apiVersion: number;
-    /** CLI version with 'v' prefix */
-    cliVersionString: string;
-    /** SDK version with 'v' prefix */
-    sdkVersionString: string;
-};
-/**
- * Get version info formatted for display
- *
- * @returns Human-readable version string
- *
- * @example
- * ```typescript
- * import { getVersionString } from '@defai.digital/ax-cli/sdk';
- *
- * console.log(getVersionString());
- * // Output: "AX CLI v4.1.14 (SDK v1.4.0)"
- * ```
- */
-export declare function getVersionString(): string;
-/**
- * Check if SDK version is compatible with minimum required version
- *
- * @param minVersion - Minimum SDK version required (e.g., "1.1.0")
- * @returns True if current SDK version is >= minimum version
- *
- * @throws Error if minVersion is not a valid semantic version string
- *
- * @example
- * ```typescript
- * import { isSDKVersionCompatible } from '@defai.digital/ax-cli/sdk';
- *
- * if (!isSDKVersionCompatible('1.1.0')) {
- *   throw new Error('SDK v1.1.0+ required');
- * }
- * ```
- */
-export declare function isSDKVersionCompatible(minVersion: string): boolean;