@defai.digital/ax-cli 3.6.1 → 3.7.1

package/dist/sdk/index.d.ts

@@ -4,27 +4,51 @@
  * This SDK allows you to use AX CLI as a library instead of spawning CLI processes.
  * Perfect for integrations, VSCode extensions, and programmatic AI agent usage.
  *
+ * ## Quick Start
+ *
+ * 1. Run `ax-cli setup` to configure credentials (one-time setup)
+ * 2. Use the SDK in your code
+ *
  * @example
  * ```typescript
- * import { createAgent, getSettingsManager } from '@defai.digital/ax-cli/sdk';
- *
- * // Initialize settings
- * const settings = getSettingsManager();
- * await settings.loadUserSettings();
+ * import { createAgent, SDKError, SDKErrorCode } from '@defai.digital/ax-cli/sdk';
  *
- * // Create agent
+ * // Create agent (credentials from ax-cli setup)
  * const agent = await createAgent({
- *   model: 'glm-4.6',
- *   maxToolRounds: 50
+ *   maxToolRounds: 50  // Optional: 1-1000, default 400
  * });
  *
- * // Listen to streaming responses
- * agent.on('stream', (chunk) => {
- *   console.log(chunk.content);
- * });
+ * try {
+ *   // Listen to streaming responses
+ *   agent.on('stream', (chunk) => {
+ *     if (chunk.type === 'content') {
+ *       console.log(chunk.content);
+ *     }
+ *   });
+ *
+ *   // Process messages
+ *   const result = await agent.processUserMessage('List all TypeScript files');
+ *   console.log('Done!', result.length, 'messages');
+ * } catch (error) {
+ *   // Handle structured errors
+ *   if (SDKError.isSDKError(error)) {
+ *     if (error.code === SDKErrorCode.SETUP_NOT_RUN) {
+ *       console.error('Please run: ax-cli setup');
+ *     }
+ *   }
+ * } finally {
+ *   // Always cleanup resources
+ *   await agent.dispose();
+ * }
+ * ```
+ *
+ * ## Testing
+ *
+ * ```typescript
+ * import { createMockAgent } from '@defai.digital/ax-cli/sdk/testing';
  *
- * // Process messages
- * const result = await agent.processUserMessage('List all TypeScript files');
+ * const mockAgent = createMockAgent(['Response 1', 'Response 2']);
+ * const result = await mockAgent.processUserMessage('Test');
  * ```
  *
  * @packageDocumentation
@@ -50,47 +74,97 @@ export { buildSystemPrompt } from '../utils/prompt-builder.js';
 export { getUsageTracker } from '../utils/usage-tracker.js';
 export { extractErrorMessage, createErrorMessage, ErrorCategory } from '../utils/error-handler.js';
 export { loadMCPConfig } from '../mcp/config.js';
-export { getMCPManager, initializeMCPServers } from '../llm/tools.js';
+export { getMCPManager, initializeMCPServers, getMcpConnectionCount } from '../llm/tools.js';
 export type { MCPConfig } from '../mcp/config.js';
-export type { MCPServerConfig } from '../mcp/client.js';
+export type { MCPServerConfig, MCPTool } from '../mcp/client.js';
+export { MCPManager } from '../mcp/client.js';
 export { getTaskPlanner, isComplexRequest } from '../planner/index.js';
 export type { TaskPlanner, TaskPlan, TaskPhase, PhaseResult, PlanResult, } from '../planner/index.js';
 export { getCheckpointManager } from '../checkpoint/index.js';
 export type { CheckpointManager, Checkpoint } from '../checkpoint/index.js';
-export { GLM_MODELS, DEFAULT_MODEL, AGENT_CONFIG, PLANNER_CONFIG, type SupportedModel, } from '../constants.js';
+export { ContextStore, getContextStore, resetDefaultStore } from '../memory/context-store.js';
+export type { StoreResult } from '../memory/context-store.js';
+export type { ProjectMemory, CacheStats } from '../memory/types.js';
+export { ProgressReporter, getProgressReporter, ProgressEventType, type ProgressEvent } from './progress-reporter.js';
+export { UnifiedLogger, getUnifiedLogger, LogLevel, parseLogLevel, getLogLevelName, type LogEntry, type LogSource, type LogFilter } from './unified-logger.js';
+export { ToolRegistry, getToolRegistry, registerTools, createToolExecutor, type RegisteredTool, type ToolExecutor, type ToolExecutionContext, type ToolRegistrationOptions } from './tool-registry.js';
+export { GLM_MODELS, DEFAULT_MODEL, AGENT_CONFIG, PLANNER_CONFIG, VerbosityLevel, UI_CONFIG, type SupportedModel, } from '../constants.js';
+export { SDK_VERSION, SDK_API_VERSION, getSDKVersion, getSDKInfo, } from './version.js';
+export { SDKError, SDKErrorCode } from './errors.js';
+export { MockAgent, createMockAgent, MockSettingsManager, createMockSettings, } from './testing.js';
 /**
  * Agent configuration options for SDK users
+ *
+ * SECURITY: Credentials (apiKey, baseURL) must be configured via "ax-cli setup"
+ * and are NOT exposed through the SDK API to prevent security vulnerabilities.
  */
 export interface AgentOptions {
-    /** API key (optional, will use settings if not provided) */
-    apiKey?: string;
-    /** Model to use (optional, will use settings if not provided) */
-    model?: string;
-    /** Base URL for API (optional, will use settings if not provided) */
-    baseURL?: string;
-    /** Maximum number of tool execution rounds */
+    /** Maximum number of tool execution rounds (1-1000, default: 400) */
     maxToolRounds?: number;
+    /**
+     * Enable debug mode for verbose logging
+     *
+     * When enabled, the SDK will log detailed information about:
+     * - Agent initialization
+     * - Message processing
+     * - Tool executions
+     * - Errors and warnings
+     *
+     * Debug logs are written to stderr and prefixed with [AX SDK DEBUG].
+     *
+     * @default false
+     */
+    debug?: boolean;
 }
 /**
  * Create a new LLM Agent with configuration
  *
- * @param options - Agent configuration options
+ * SECURITY: All credentials (API key, base URL, model) must be configured
+ * via "ax-cli setup" command. This prevents security vulnerabilities where
+ * credentials could be exposed in code or logs.
+ *
+ * @param options - Agent configuration options (non-sensitive only)
  * @returns Configured LLM Agent instance
+ * @throws {SDKError} With code SETUP_NOT_RUN if ax-cli setup has not been run
+ * @throws {SDKError} With code API_KEY_MISSING if API key not configured
+ * @throws {SDKError} With code BASE_URL_MISSING if base URL not configured
+ * @throws {SDKError} With code VALIDATION_ERROR if options are invalid
  *
  * @example
  * ```typescript
+ * import { createAgent, SDKError, SDKErrorCode } from '@defai.digital/ax-cli/sdk';
+ *
+ * // First, user must run: ax-cli setup
+ * // Then use SDK with settings from setup:
+ *
  * const agent = await createAgent({
- *   model: 'glm-4.6',
- *   maxToolRounds: 50
+ *   maxToolRounds: 50  // Optional: 1-1000, default 400
  * });
  *
- * agent.on('stream', (chunk) => {
- *   if (chunk.type === 'content') {
- *     console.log(chunk.content);
+ * try {
+ *   agent.on('stream', (chunk) => {
+ *     if (chunk.type === 'content') {
+ *       console.log(chunk.content);
+ *     }
+ *   });
+ *
+ *   const result = await agent.processUserMessage('Analyze this codebase');
+ *   console.log(result);
+ * } catch (error) {
+ *   if (SDKError.isSDKError(error)) {
+ *     switch (error.code) {
+ *       case SDKErrorCode.SETUP_NOT_RUN:
+ *         console.error('Run ax-cli setup first');
+ *         break;
+ *       case SDKErrorCode.API_KEY_MISSING:
+ *         console.error('API key not configured');
+ *         break;
+ *     }
  *   }
- * });
- *
- * const result = await agent.processUserMessage('Analyze this codebase');
+ * } finally {
+ *   // Always cleanup resources
+ *   await agent.dispose();
+ * }
  * ```
  */
 export declare function createAgent(options?: AgentOptions): Promise<LLMAgent>;
@@ -117,22 +191,18 @@ export declare function createAgent(options?: AgentOptions): Promise<LLMAgent>;
  */
 export declare function createSubagent(role: import('../agent/subagent-types.js').SubagentRole, config?: Partial<import('../agent/subagent-types.js').SubagentConfig>): Subagent;
 /**
- * Initialize SDK with configuration
+ * Initialize SDK and MCP servers
  *
- * @param config - SDK initialization configuration
+ * SECURITY: This function does NOT accept credentials. All credentials must be
+ * configured via "ax-cli setup" command. This function only initializes MCP servers.
  *
  * @example
  * ```typescript
- * await initializeSDK({
- *   apiKey: 'your-api-key',
- *   model: 'glm-4.6',
- *   baseURL: 'https://api.example.com/v1'
- * });
+ * // Initialize MCP servers from ax-cli settings
+ * await initializeSDK();
  * ```
+ *
+ * @deprecated Most SDK users don't need to call this - createAgent() handles initialization.
+ * Only call this if you need to pre-initialize MCP servers.
  */
-export declare function initializeSDK(config: {
-    apiKey?: string;
-    model?: string;
-    baseURL?: string;
-    mcpServers?: Record<string, any>;
-}): Promise<void>;
+export declare function initializeSDK(): Promise<void>;

package/dist/sdk/index.js

@@ -4,27 +4,51 @@
  * This SDK allows you to use AX CLI as a library instead of spawning CLI processes.
  * Perfect for integrations, VSCode extensions, and programmatic AI agent usage.
  *
+ * ## Quick Start
+ *
+ * 1. Run `ax-cli setup` to configure credentials (one-time setup)
+ * 2. Use the SDK in your code
+ *
  * @example
  * ```typescript
- * import { createAgent, getSettingsManager } from '@defai.digital/ax-cli/sdk';
- *
- * // Initialize settings
- * const settings = getSettingsManager();
- * await settings.loadUserSettings();
+ * import { createAgent, SDKError, SDKErrorCode } from '@defai.digital/ax-cli/sdk';
  *
- * // Create agent
+ * // Create agent (credentials from ax-cli setup)
  * const agent = await createAgent({
- *   model: 'glm-4.6',
- *   maxToolRounds: 50
+ *   maxToolRounds: 50  // Optional: 1-1000, default 400
  * });
  *
- * // Listen to streaming responses
- * agent.on('stream', (chunk) => {
- *   console.log(chunk.content);
- * });
+ * try {
+ *   // Listen to streaming responses
+ *   agent.on('stream', (chunk) => {
+ *     if (chunk.type === 'content') {
+ *       console.log(chunk.content);
+ *     }
+ *   });
+ *
+ *   // Process messages
+ *   const result = await agent.processUserMessage('List all TypeScript files');
+ *   console.log('Done!', result.length, 'messages');
+ * } catch (error) {
+ *   // Handle structured errors
+ *   if (SDKError.isSDKError(error)) {
+ *     if (error.code === SDKErrorCode.SETUP_NOT_RUN) {
+ *       console.error('Please run: ax-cli setup');
+ *     }
+ *   }
+ * } finally {
+ *   // Always cleanup resources
+ *   await agent.dispose();
+ * }
+ * ```
+ *
+ * ## Testing
+ *
+ * ```typescript
+ * import { createMockAgent } from '@defai.digital/ax-cli/sdk/testing';
  *
- * // Process messages
- * const result = await agent.processUserMessage('List all TypeScript files');
+ * const mockAgent = createMockAgent(['Response 1', 'Response 2']);
+ * const result = await mockAgent.processUserMessage('Test');
  * ```
  *
  * @packageDocumentation
@@ -41,6 +65,8 @@ import { LLMAgent } from '../agent/llm-agent.js';
 import { Subagent } from '../agent/subagent.js';
 import { getSettingsManager } from '../utils/settings-manager.js';
 import { initializeMCPServers } from '../llm/tools.js';
+import { z } from 'zod';
+import { SDKError, SDKErrorCode } from './errors.js';
 // ============================================================================
 // LLM Client
 // ============================================================================
@@ -62,7 +88,8 @@ export { extractErrorMessage, createErrorMessage, ErrorCategory } from '../utils
 // MCP Integration
 // ============================================================================
 export { loadMCPConfig } from '../mcp/config.js';
-export { getMCPManager, initializeMCPServers } from '../llm/tools.js';
+export { getMCPManager, initializeMCPServers, getMcpConnectionCount } from '../llm/tools.js';
+export { MCPManager } from '../mcp/client.js';
 // ============================================================================
 // Planning System
 // ============================================================================
@@ -72,47 +99,153 @@ export { getTaskPlanner, isComplexRequest } from '../planner/index.js';
 // ============================================================================
 export { getCheckpointManager } from '../checkpoint/index.js';
 // ============================================================================
+// Memory and Context Cache
+// ============================================================================
+export { ContextStore, getContextStore, resetDefaultStore } from '../memory/context-store.js';
+// ============================================================================
+// Progress Reporting
+// ============================================================================
+export { ProgressReporter, getProgressReporter, ProgressEventType } from './progress-reporter.js';
+// ============================================================================
+// Unified Logging (Phase 3)
+// ============================================================================
+export { UnifiedLogger, getUnifiedLogger, LogLevel, parseLogLevel, getLogLevelName } from './unified-logger.js';
+// ============================================================================
+// Shared Tool Registry (Phase 3)
+// ============================================================================
+export { ToolRegistry, getToolRegistry, registerTools, createToolExecutor } from './tool-registry.js';
+// ============================================================================
 // Constants
 // ============================================================================
-export { GLM_MODELS, DEFAULT_MODEL, AGENT_CONFIG, PLANNER_CONFIG, } from '../constants.js';
+export { GLM_MODELS, DEFAULT_MODEL, AGENT_CONFIG, PLANNER_CONFIG, VerbosityLevel, UI_CONFIG, } from '../constants.js';
+// ============================================================================
+// SDK Version (Phase 1.5: Best Practices)
+// ============================================================================
+export { SDK_VERSION, SDK_API_VERSION, getSDKVersion, getSDKInfo, } from './version.js';
+// ============================================================================
+// SDK Errors (Phase 1: Best Practices)
+// ============================================================================
+export { SDKError, SDKErrorCode } from './errors.js';
+// ============================================================================
+// Testing Utilities (Phase 1: Best Practices)
+// ============================================================================
+export { MockAgent, createMockAgent, MockSettingsManager, createMockSettings, } from './testing.js';
+// ============================================================================
+// SDK Helper Functions
+// ============================================================================
+/**
+ * Validation schema for agent options
+ * @internal
+ */
+const AgentOptionsSchema = z.object({
+    maxToolRounds: z.number().int().min(1).max(1000).optional(),
+    debug: z.boolean().optional(),
+}).strict();
 /**
  * Create a new LLM Agent with configuration
  *
- * @param options - Agent configuration options
+ * SECURITY: All credentials (API key, base URL, model) must be configured
+ * via "ax-cli setup" command. This prevents security vulnerabilities where
+ * credentials could be exposed in code or logs.
+ *
+ * @param options - Agent configuration options (non-sensitive only)
  * @returns Configured LLM Agent instance
+ * @throws {SDKError} With code SETUP_NOT_RUN if ax-cli setup has not been run
+ * @throws {SDKError} With code API_KEY_MISSING if API key not configured
+ * @throws {SDKError} With code BASE_URL_MISSING if base URL not configured
+ * @throws {SDKError} With code VALIDATION_ERROR if options are invalid
  *
  * @example
  * ```typescript
+ * import { createAgent, SDKError, SDKErrorCode } from '@defai.digital/ax-cli/sdk';
+ *
+ * // First, user must run: ax-cli setup
+ * // Then use SDK with settings from setup:
+ *
  * const agent = await createAgent({
- *   model: 'glm-4.6',
- *   maxToolRounds: 50
+ *   maxToolRounds: 50  // Optional: 1-1000, default 400
  * });
  *
- * agent.on('stream', (chunk) => {
- *   if (chunk.type === 'content') {
- *     console.log(chunk.content);
- *   }
- * });
+ * try {
+ *   agent.on('stream', (chunk) => {
+ *     if (chunk.type === 'content') {
+ *       console.log(chunk.content);
+ *     }
+ *   });
  *
- * const result = await agent.processUserMessage('Analyze this codebase');
+ *   const result = await agent.processUserMessage('Analyze this codebase');
+ *   console.log(result);
+ * } catch (error) {
+ *   if (SDKError.isSDKError(error)) {
+ *     switch (error.code) {
+ *       case SDKErrorCode.SETUP_NOT_RUN:
+ *         console.error('Run ax-cli setup first');
+ *         break;
+ *       case SDKErrorCode.API_KEY_MISSING:
+ *         console.error('API key not configured');
+ *         break;
+ *     }
+ *   }
+ * } finally {
+ *   // Always cleanup resources
+ *   await agent.dispose();
+ * }
  * ```
  */
 export async function createAgent(options = {}) {
+    // Validate input options
+    let validated;
+    try {
+        validated = AgentOptionsSchema.parse(options);
+    }
+    catch (error) {
+        throw new SDKError(SDKErrorCode.VALIDATION_ERROR, `Invalid agent options: ${error instanceof Error ? error.message : 'Unknown validation error'}`, error instanceof Error ? error : undefined);
+    }
     const settingsManager = getSettingsManager();
-    // Load settings if not already loaded
+    // Load settings from ax-cli setup
     try {
         settingsManager.loadUserSettings();
     }
-    catch {
-        // Settings may not exist yet, that's okay
+    catch (error) {
+        throw new SDKError(SDKErrorCode.SETUP_NOT_RUN, 'ax-cli setup has not been run. Please run "ax-cli setup" to configure your API key, model, and base URL before using the SDK.', error instanceof Error ? error : undefined);
+    }
+    // Get configuration ONLY from settings (security requirement)
+    const apiKey = settingsManager.getApiKey();
+    const model = settingsManager.getCurrentModel();
+    const baseURL = settingsManager.getBaseURL();
+    // Validate required settings exist
+    if (!apiKey) {
+        throw new SDKError(SDKErrorCode.API_KEY_MISSING, 'No API key configured. Please run "ax-cli setup" to configure your credentials.');
+    }
+    if (!baseURL) {
+        throw new SDKError(SDKErrorCode.BASE_URL_MISSING, 'No base URL configured. Please run "ax-cli setup" to configure your API provider.');
     }
-    // Get configuration (use options or settings)
-    const apiKey = options.apiKey || settingsManager.getApiKey() || '';
-    const model = options.model || settingsManager.getCurrentModel();
-    const baseURL = options.baseURL || settingsManager.getBaseURL();
-    const maxToolRounds = options.maxToolRounds;
-    // Create agent instance
+    const maxToolRounds = validated.maxToolRounds;
+    const debug = validated.debug ?? false;
+    // Debug logging
+    if (debug) {
+        console.error('[AX SDK DEBUG] Creating agent with settings:');
+        console.error('[AX SDK DEBUG]   Model:', model);
+        console.error('[AX SDK DEBUG]   Base URL:', baseURL);
+        console.error('[AX SDK DEBUG]   Max tool rounds:', maxToolRounds ?? 400);
+        console.error('[AX SDK DEBUG]   API key configured:', !!apiKey);
+    }
+    // Create agent instance with settings from ax-cli setup
     const agent = new LLMAgent(apiKey, baseURL, model, maxToolRounds);
+    // Enable debug mode on agent if requested
+    if (debug) {
+        // Add debug event listener
+        agent.on('stream', (chunk) => {
+            if (chunk.type === 'tool_calls' && chunk.toolCalls) {
+                const toolNames = chunk.toolCalls.map((tc) => tc.function.name).join(', ');
+                console.error('[AX SDK DEBUG] Tool calls:', toolNames);
+            }
+            else if (chunk.type === 'tool_result' && chunk.toolResult) {
+                console.error('[AX SDK DEBUG] Tool result:', chunk.toolResult.success ? 'success' : 'failed');
+            }
+        });
+        console.error('[AX SDK DEBUG] Agent created successfully');
+    }
     return agent;
 }
 /**
@@ -140,34 +273,22 @@ export function createSubagent(role, config) {
     return new Subagent(role, config);
 }
 /**
- * Initialize SDK with configuration
+ * Initialize SDK and MCP servers
  *
- * @param config - SDK initialization configuration
+ * SECURITY: This function does NOT accept credentials. All credentials must be
+ * configured via "ax-cli setup" command. This function only initializes MCP servers.
  *
  * @example
  * ```typescript
- * await initializeSDK({
- *   apiKey: 'your-api-key',
- *   model: 'glm-4.6',
- *   baseURL: 'https://api.example.com/v1'
- * });
+ * // Initialize MCP servers from ax-cli settings
+ * await initializeSDK();
  * ```
+ *
+ * @deprecated Most SDK users don't need to call this - createAgent() handles initialization.
+ * Only call this if you need to pre-initialize MCP servers.
  */
-export async function initializeSDK(config) {
-    const settingsManager = getSettingsManager();
-    // Update settings
-    if (config.apiKey) {
-        settingsManager.updateUserSetting('apiKey', config.apiKey);
-    }
-    if (config.model) {
-        settingsManager.updateUserSetting('defaultModel', config.model);
-    }
-    if (config.baseURL) {
-        settingsManager.updateUserSetting('baseURL', config.baseURL);
-    }
-    // Initialize MCP servers if provided
-    if (config.mcpServers) {
-        await initializeMCPServers();
-    }
+export async function initializeSDK() {
+    // Initialize MCP servers from settings configured via ax-cli setup
+    await initializeMCPServers();
 }
 //# sourceMappingURL=index.js.map

package/dist/sdk/index.js.map

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

package/dist/sdk/progress-reporter.d.ts

@@ -0,0 +1,111 @@
+/**
+ * Progress Reporter - Shared event system for AX <-> ax-cli integration
+ *
+ * Allows AutomatosX agents to report progress to ax-cli UI in real-time.
+ * This creates a unified progress visibility system across both applications.
+ */
+import { EventEmitter } from 'events';
+/**
+ * Progress event types
+ */
+export declare enum ProgressEventType {
+    /** Agent started a new task */
+    TASK_START = "task_start",
+    /** Agent made progress on current task */
+    TASK_PROGRESS = "task_progress",
+    /** Agent completed a task */
+    TASK_COMPLETE = "task_complete",
+    /** Agent encountered an error */
+    TASK_ERROR = "task_error",
+    /** Tool execution started */
+    TOOL_START = "tool_start",
+    /** Tool execution completed */
+    TOOL_COMPLETE = "tool_complete",
+    /** General status update */
+    STATUS_UPDATE = "status_update"
+}
+/**
+ * Progress event data
+ */
+export interface ProgressEvent {
+    /** Event type */
+    type: ProgressEventType;
+    /** Agent identifier (e.g., "ax-agent-1", "ax-cli-main") */
+    agentId: string;
+    /** Task or tool name */
+    name: string;
+    /** Optional message */
+    message?: string;
+    /** Progress percentage (0-100) */
+    progress?: number;
+    /** Additional metadata */
+    metadata?: Record<string, unknown>;
+    /** Timestamp */
+    timestamp: number;
+}
+/**
+ * Progress Reporter - Singleton event emitter for progress tracking
+ */
+export declare class ProgressReporter extends EventEmitter {
+    private static instance;
+    private constructor();
+    /**
+     * Get the singleton instance
+     */
+    static getInstance(): ProgressReporter;
+    /**
+     * Reset the singleton (for testing)
+     */
+    static reset(): void;
+    /**
+     * Report a progress event
+     */
+    report(event: Omit<ProgressEvent, 'timestamp'>): void;
+    /**
+     * Report task start
+     */
+    taskStart(agentId: string, name: string, message?: string): void;
+    /**
+     * Report task progress
+     */
+    taskProgress(agentId: string, name: string, progress: number, message?: string): void;
+    /**
+     * Report task completion
+     */
+    taskComplete(agentId: string, name: string, message?: string): void;
+    /**
+     * Report task error
+     */
+    taskError(agentId: string, name: string, error: string): void;
+    /**
+     * Report tool execution start
+     */
+    toolStart(agentId: string, toolName: string, message?: string): void;
+    /**
+     * Report tool execution completion
+     */
+    toolComplete(agentId: string, toolName: string, message?: string): void;
+    /**
+     * Report general status update
+     */
+    statusUpdate(agentId: string, message: string, metadata?: Record<string, unknown>): void;
+    /**
+     * Subscribe to all progress events
+     */
+    onProgress(callback: (event: ProgressEvent) => void): () => void;
+    /**
+     * Subscribe to specific event type
+     */
+    onEvent(type: ProgressEventType, callback: (event: ProgressEvent) => void): () => void;
+    /**
+     * Get statistics about event emission
+     */
+    getStats(): {
+        listenerCount: number;
+        maxListeners: number;
+    };
+}
+/**
+ * Get the global progress reporter instance
+ */
+export declare function getProgressReporter(): ProgressReporter;