@defai.digital/ax-cli 3.7.2 → 3.8.1

package/dist/sdk/index.d.ts

@@ -88,10 +88,12 @@ 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 { ToolRegistry as InternalToolRegistry, type ToolDefinition, type ToolCategory } from '../tools/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 { CLI_VERSION, SDK_VERSION, SDK_API_VERSION, getCLIVersion, getSDKVersion, getSDKInfo, getVersionString, isSDKVersionCompatible, } from './version.js';
 export { SDKError, SDKErrorCode } from './errors.js';
-export { MockAgent, createMockAgent, MockSettingsManager, createMockSettings, } from './testing.js';
+export { MockAgent, createMockAgent, MockSettingsManager, createMockSettings, MockMCPServer, createMockMCPServer, waitForAgent, createMockToolResult, assertToolSuccess, assertToolFailure } from './testing.js';
+export type { MockMCPServerOptions } from './testing.js';
 /**
  * Agent configuration options for SDK users
  *
@@ -115,6 +117,82 @@ export interface AgentOptions {
      * @default false
      */
     debug?: boolean;
+    /**
+     * Enable automatic cleanup on process exit signals
+     *
+     * When enabled (default), the SDK automatically registers cleanup handlers for:
+     * - process.exit
+     * - SIGINT (Ctrl+C)
+     * - SIGTERM
+     * - SIGHUP
+     *
+     * Set to false if you want manual control over cleanup (useful for libraries,
+     * long-running services, or when you want to manage agent lifecycle yourself).
+     *
+     * @default true (backward compatible - cleanup enabled by default)
+     *
+     * @example
+     * ```typescript
+     * // Auto-cleanup enabled (default behavior)
+     * const agent = await createAgent();
+     *
+     * // Manual cleanup control
+     * const agent = await createAgent({ autoCleanup: false });
+     * // ... use agent ...
+     * await agent.dispose(); // Manual cleanup
+     * ```
+     */
+    autoCleanup?: boolean;
+    /**
+     * Lifecycle hook called before agent disposal
+     *
+     * This hook is called BEFORE the agent's dispose() method runs, allowing you to:
+     * - Save state or checkpoint data
+     * - Log metrics or analytics
+     * - Notify external systems
+     * - Perform custom cleanup
+     *
+     * Can be async (returns Promise<void>) or sync (returns void).
+     *
+     * @param None
+     * @returns void or Promise<void>
+     *
+     * @example
+     * ```typescript
+     * const agent = await createAgent({
+     *   onDispose: async () => {
+     *     console.log('Agent disposing, saving state...');
+     *     await saveAgentState(agent);
+     *   }
+     * });
+     * ```
+     */
+    onDispose?: () => void | Promise<void>;
+    /**
+     * Error handler called when agent encounters errors
+     *
+     * This hook is called whenever the agent encounters an error during:
+     * - Message processing
+     * - Tool execution
+     * - Stream handling
+     *
+     * Use this to implement custom error handling, logging, or recovery logic.
+     *
+     * @param error - The error that occurred
+     * @returns void
+     *
+     * @example
+     * ```typescript
+     * const agent = await createAgent({
+     *   onError: (error) => {
+     *     console.error('Agent error:', error);
+     *     metrics.incrementErrorCount();
+     *     errorLogger.log(error);
+     *   }
+     * });
+     * ```
+     */
+    onError?: (error: Error) => void;
 }
 /**
  * Create a new LLM Agent with configuration
@@ -190,6 +268,44 @@ 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;
+/**
+ * Remove auto-cleanup handlers from an agent
+ *
+ * Use this function to remove the automatic cleanup handlers registered by createAgent()
+ * when autoCleanup was enabled (default). This gives you manual control over when the
+ * agent is disposed.
+ *
+ * **Use Cases:**
+ * - Long-running services that manage agent lifecycle manually
+ * - Testing scenarios where you want precise control over cleanup
+ * - Library code that embeds agents
+ *
+ * **Note:** Only works if agent was created with autoCleanup: true (default).
+ * If autoCleanup was false, this function does nothing.
+ *
+ * @param agent - The agent instance created with createAgent()
+ *
+ * @example
+ * ```typescript
+ * // Create agent with auto-cleanup (default)
+ * const agent = await createAgent();
+ *
+ * // Later, take manual control
+ * removeCleanupHandlers(agent);
+ *
+ * // Now you must manually dispose
+ * await agent.dispose();
+ * ```
+ *
+ * @example
+ * ```typescript
+ * // For manual cleanup from the start, use autoCleanup: false
+ * const agent = await createAgent({ autoCleanup: false });
+ * // No need to call removeCleanupHandlers
+ * await agent.dispose(); // Manual cleanup
+ * ```
+ */
+export declare function removeCleanupHandlers(agent: LLMAgent): void;
 /**
  * Initialize SDK and MCP servers
  *

package/dist/sdk/index.js

@@ -111,17 +111,21 @@ export { ProgressReporter, getProgressReporter, ProgressEventType } from './prog
 // ============================================================================
 export { UnifiedLogger, getUnifiedLogger, LogLevel, parseLogLevel, getLogLevelName } from './unified-logger.js';
 // ============================================================================
-// Shared Tool Registry (Phase 3)
+// Shared Tool Registry (Phase 3 - AutomatosX Integration)
 // ============================================================================
 export { ToolRegistry, getToolRegistry, registerTools, createToolExecutor } from './tool-registry.js';
 // ============================================================================
+// Internal Tool Registry (Phase 2 - Task 5)
+// ============================================================================
+export { ToolRegistry as InternalToolRegistry } from '../tools/registry.js';
+// ============================================================================
 // Constants
 // ============================================================================
 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';
+export { CLI_VERSION, SDK_VERSION, SDK_API_VERSION, getCLIVersion, getSDKVersion, getSDKInfo, getVersionString, isSDKVersionCompatible, } from './version.js';
 // ============================================================================
 // SDK Errors (Phase 1: Best Practices)
 // ============================================================================
@@ -129,7 +133,7 @@ export { SDKError, SDKErrorCode } from './errors.js';
 // ============================================================================
 // Testing Utilities (Phase 1: Best Practices)
 // ============================================================================
-export { MockAgent, createMockAgent, MockSettingsManager, createMockSettings, } from './testing.js';
+export { MockAgent, createMockAgent, MockSettingsManager, createMockSettings, MockMCPServer, createMockMCPServer, waitForAgent, createMockToolResult, assertToolSuccess, assertToolFailure } from './testing.js';
 // ============================================================================
 // SDK Helper Functions
 // ============================================================================
@@ -140,6 +144,9 @@ export { MockAgent, createMockAgent, MockSettingsManager, createMockSettings, }
 const AgentOptionsSchema = z.object({
     maxToolRounds: z.number().int().min(1).max(1000).optional(),
     debug: z.boolean().optional(),
+    autoCleanup: z.boolean().optional(),
+    onDispose: z.function().args().returns(z.union([z.void(), z.promise(z.void())])).optional(),
+    onError: z.function().args(z.instanceof(Error)).returns(z.void()).optional(),
 }).strict();
 /**
  * Create a new LLM Agent with configuration
@@ -220,18 +227,32 @@ export async function createAgent(options = {}) {
     if (!baseURL) {
         throw new SDKError(SDKErrorCode.BASE_URL_MISSING, 'No base URL configured. Please run "ax-cli setup" to configure your API provider.');
     }
-    const maxToolRounds = validated.maxToolRounds;
+    // Apply defaults for optional values
+    const maxToolRounds = validated.maxToolRounds; // undefined is valid, LLMAgent uses 400 as default
     const debug = validated.debug ?? false;
+    const autoCleanup = validated.autoCleanup ?? true; // Default: true (backward compatible)
+    const onDispose = validated.onDispose;
+    const onError = validated.onError;
     // 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]   Auto cleanup:', autoCleanup);
         console.error('[AX SDK DEBUG]   API key configured:', !!apiKey);
+        console.error('[AX SDK DEBUG]   Lifecycle hooks:', {
+            onDispose: !!onDispose,
+            onError: !!onError
+        });
     }
     // Create agent instance with settings from ax-cli setup
     const agent = new LLMAgent(apiKey, baseURL, model, maxToolRounds);
+    // Store lifecycle hooks on agent
+    agent._sdkLifecycleHooks = {
+        onDispose,
+        onError
+    };
     // Enable debug mode on agent if requested
     if (debug) {
         // Add debug event listener
@@ -246,6 +267,76 @@ export async function createAgent(options = {}) {
         });
         console.error('[AX SDK DEBUG] Agent created successfully');
     }
+    // Phase 3: Add onError lifecycle hook integration
+    if (onError) {
+        // Wrap agent's processUserMessage to catch errors
+        const originalProcessUserMessage = agent.processUserMessage.bind(agent);
+        agent.processUserMessage = async (prompt) => {
+            try {
+                return await originalProcessUserMessage(prompt);
+            }
+            catch (error) {
+                if (error instanceof Error) {
+                    onError(error);
+                }
+                throw error; // Re-throw after calling hook
+            }
+        };
+        // Also listen to stream errors
+        agent.on('error', (error) => {
+            onError(error);
+        });
+    }
+    // Phase 3: Wrap dispose() to call onDispose hook
+    const originalDispose = agent.dispose.bind(agent);
+    agent.dispose = async () => {
+        try {
+            // Call onDispose hook BEFORE actual disposal
+            if (onDispose) {
+                if (debug) {
+                    console.error('[AX SDK DEBUG] Calling onDispose hook');
+                }
+                await onDispose();
+            }
+        }
+        catch (error) {
+            if (debug) {
+                console.error('[AX SDK DEBUG] Error in onDispose hook:', error);
+            }
+            // Continue with disposal even if hook fails
+        }
+        // Call original dispose
+        return await originalDispose();
+    };
+    // Phase 3: Auto-cleanup on process exit (OPTIONAL)
+    if (autoCleanup) {
+        const cleanupHandler = () => {
+            try {
+                if (debug) {
+                    console.error('[AX SDK DEBUG] Auto-cleanup: disposing agent on process exit');
+                }
+                agent.dispose();
+            }
+            catch (error) {
+                // Ignore errors during emergency cleanup
+                if (debug) {
+                    console.error('[AX SDK DEBUG] Error during auto-cleanup:', error);
+                }
+            }
+        };
+        // Register cleanup on various exit signals
+        process.once('exit', cleanupHandler);
+        process.once('SIGINT', cleanupHandler);
+        process.once('SIGTERM', cleanupHandler);
+        process.once('SIGHUP', cleanupHandler);
+        // Store cleanup handler reference for manual removal if needed
+        agent._sdkCleanupHandler = cleanupHandler;
+    }
+    else {
+        if (debug) {
+            console.error('[AX SDK DEBUG] Auto-cleanup disabled, manual cleanup required');
+        }
+    }
     return agent;
 }
 /**
@@ -272,6 +363,57 @@ export async function createAgent(options = {}) {
 export function createSubagent(role, config) {
     return new Subagent(role, config);
 }
+/**
+ * Remove auto-cleanup handlers from an agent
+ *
+ * Use this function to remove the automatic cleanup handlers registered by createAgent()
+ * when autoCleanup was enabled (default). This gives you manual control over when the
+ * agent is disposed.
+ *
+ * **Use Cases:**
+ * - Long-running services that manage agent lifecycle manually
+ * - Testing scenarios where you want precise control over cleanup
+ * - Library code that embeds agents
+ *
+ * **Note:** Only works if agent was created with autoCleanup: true (default).
+ * If autoCleanup was false, this function does nothing.
+ *
+ * @param agent - The agent instance created with createAgent()
+ *
+ * @example
+ * ```typescript
+ * // Create agent with auto-cleanup (default)
+ * const agent = await createAgent();
+ *
+ * // Later, take manual control
+ * removeCleanupHandlers(agent);
+ *
+ * // Now you must manually dispose
+ * await agent.dispose();
+ * ```
+ *
+ * @example
+ * ```typescript
+ * // For manual cleanup from the start, use autoCleanup: false
+ * const agent = await createAgent({ autoCleanup: false });
+ * // No need to call removeCleanupHandlers
+ * await agent.dispose(); // Manual cleanup
+ * ```
+ */
+export function removeCleanupHandlers(agent) {
+    const cleanupHandler = agent._sdkCleanupHandler;
+    if (!cleanupHandler) {
+        // No cleanup handlers registered (autoCleanup was false)
+        return;
+    }
+    // Remove all process event listeners
+    process.removeListener('exit', cleanupHandler);
+    process.removeListener('SIGINT', cleanupHandler);
+    process.removeListener('SIGTERM', cleanupHandler);
+    process.removeListener('SIGHUP', cleanupHandler);
+    // Clear the reference
+    delete agent._sdkCleanupHandler;
+}
 /**
  * Initialize SDK and MCP servers
  *

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/testing.d.ts

@@ -182,3 +182,185 @@ export declare function createMockSettings(settings?: {
     baseURL?: string;
     model?: string;
 }): MockSettingsManager;
+/**
+ * Mock MCP Server Options
+ */
+export interface MockMCPServerOptions {
+    name: string;
+    version?: string;
+    tools?: Array<{
+        name: string;
+        description: string;
+        inputSchema: {
+            type: 'object';
+            properties: Record<string, any>;
+            required?: string[];
+        };
+        handler: (args: any) => Promise<any>;
+    }>;
+    resources?: Array<{
+        uri: string;
+        name: string;
+        mimeType?: string;
+        handler: () => Promise<string>;
+    }>;
+    prompts?: Array<{
+        name: string;
+        description?: string;
+        handler: (args?: any) => Promise<any>;
+    }>;
+}
+/**
+ * Mock MCP Server for Testing
+ *
+ * Simplified MCP server that can be used in tests without needing
+ * real MCP server infrastructure.
+ *
+ * @example
+ * ```typescript
+ * import { createMockMCPServer } from '@defai.digital/ax-cli/sdk/testing';
+ *
+ * const mockServer = createMockMCPServer({
+ *   name: 'test-server',
+ *   tools: [{
+ *     name: 'test_tool',
+ *     description: 'A test tool',
+ *     inputSchema: {
+ *       type: 'object',
+ *       properties: { input: { type: 'string' } },
+ *       required: ['input']
+ *     },
+ *     handler: async (args) => ({ result: `Processed: ${args.input}` })
+ *   }]
+ * });
+ *
+ * await mockServer.connect();
+ * const tools = await mockServer.listTools();
+ * const result = await mockServer.callTool('test_tool', { input: 'test' });
+ * ```
+ */
+export declare class MockMCPServer {
+    private options;
+    private connected;
+    constructor(options: MockMCPServerOptions);
+    /**
+     * Connect the mock server
+     */
+    connect(): Promise<void>;
+    /**
+     * Disconnect the mock server
+     */
+    disconnect(): Promise<void>;
+    /**
+     * List available tools
+     */
+    listTools(): Promise<Array<{
+        name: string;
+        description: string;
+        inputSchema: any;
+    }>>;
+    /**
+     * Call a tool on the mock server
+     */
+    callTool(name: string, args: any): Promise<any>;
+    /**
+     * List available resources
+     */
+    listResources(): Promise<Array<{
+        uri: string;
+        name: string;
+        mimeType?: string;
+    }>>;
+    /**
+     * Read a resource from the mock server
+     */
+    readResource(uri: string): Promise<string>;
+    /**
+     * List available prompts
+     */
+    listPrompts(): Promise<Array<{
+        name: string;
+        description?: string;
+    }>>;
+    /**
+     * Execute a prompt
+     */
+    executePrompt(name: string, args?: any): Promise<any>;
+    /**
+     * Check if server is connected
+     */
+    isConnected(): boolean;
+    /**
+     * Get server info
+     */
+    getInfo(): {
+        name: string;
+        version: string;
+        toolCount: number;
+        resourceCount: number;
+        promptCount: number;
+    };
+}
+/**
+ * Create a mock MCP server for testing
+ *
+ * @example
+ * ```typescript
+ * const mockServer = createMockMCPServer({
+ *   name: 'test-server',
+ *   tools: [{
+ *     name: 'test_tool',
+ *     description: 'A test tool',
+ *     inputSchema: {
+ *       type: 'object',
+ *       properties: { input: { type: 'string' } },
+ *       required: ['input']
+ *     },
+ *     handler: async (args) => ({ result: `Processed: ${args.input}` })
+ *   }]
+ * });
+ *
+ * await mockServer.connect();
+ * const tools = await mockServer.listTools();
+ * const result = await mockServer.callTool('test_tool', { input: 'test' });
+ * ```
+ */
+export declare function createMockMCPServer(options: MockMCPServerOptions): MockMCPServer;
+/**
+ * Wait for agent to complete processing
+ *
+ * Useful in tests when you need to wait for async operations to complete.
+ *
+ * @example
+ * ```typescript
+ * const agent = await createAgent();
+ *
+ * agent.processUserMessage('Hello');
+ *
+ * // Wait for agent to finish
+ * await waitForAgent(agent, { timeout: 5000 });
+ *
+ * // Now agent is idle
+ * ```
+ */
+export declare function waitForAgent(_agent: any, options?: {
+    timeout?: number;
+}): Promise<void>;
+/**
+ * Create a mock tool result
+ */
+export declare function createMockToolResult(success: boolean, output?: string, error?: string): ToolResult;
+/**
+ * Assert tool result is successful
+ */
+export declare function assertToolSuccess(result: ToolResult): asserts result is ToolResult & {
+    success: true;
+    output: string;
+};
+/**
+ * Assert tool result is a failure
+ */
+export declare function assertToolFailure(result: ToolResult): asserts result is ToolResult & {
+    success: false;
+    error: string;
+};