@defai.digital/ax-cli 3.6.2 → 3.7.2

package/dist/sdk/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/sdk/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA8BG;AAEH,+EAA+E;AAC/E,qBAAqB;AACrB,+EAA+E;AAE/E,OAAO,EAAE,QAAQ,EAAE,MAAM,uBAAuB,CAAC;AACjD,OAAO,EAAE,QAAQ,EAAE,MAAM,sBAAsB,CAAC;AAChD,OAAO,EAAE,oBAAoB,EAAE,MAAM,mCAAmC,CAAC;AACzE,OAAO,EAAE,cAAc,EAAE,MAAM,6BAA6B,CAAC;AAE7D,qCAAqC;AACrC,OAAO,EAAE,QAAQ,EAAE,MAAM,uBAAuB,CAAC;AACjD,OAAO,EAAE,QAAQ,EAAE,MAAM,sBAAsB,CAAC;AAChD,OAAO,EAAE,kBAAkB,EAAE,MAAM,8BAA8B,CAAC;AAClE,OAAO,EAAE,oBAAoB,EAAE,MAAM,iBAAiB,CAAC;AAEvD,+EAA+E;AAC/E,aAAa;AACb,+EAA+E;AAE/E,OAAO,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAC;AAwB7C,OAAO,EACL,YAAY,EACZ,aAAa,GAKd,MAAM,4BAA4B,CAAC;AAEpC,+EAA+E;AAC/E,6BAA6B;AAC7B,+EAA+E;AAE/E,OAAO,EAAE,kBAAkB,EAAE,MAAM,8BAA8B,CAAC;AAGlE,+EAA+E;AAC/E,YAAY;AACZ,+EAA+E;AAE/E,OAAO,EAAE,kBAAkB,EAAE,MAAM,2BAA2B,CAAC;AAG/D,OAAO,EAAE,sBAAsB,EAAE,MAAM,iCAAiC,CAAC;AACzE,OAAO,EAAE,iBAAiB,EAAE,MAAM,4BAA4B,CAAC;AAC/D,OAAO,EAAE,eAAe,EAAE,MAAM,2BAA2B,CAAC;AAC5D,OAAO,EAAE,mBAAmB,EAAE,kBAAkB,EAAE,aAAa,EAAE,MAAM,2BAA2B,CAAC;AAEnG,+EAA+E;AAC/E,kBAAkB;AAClB,+EAA+E;AAE/E,OAAO,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAC;AACjD,OAAO,EAAE,aAAa,EAAE,oBAAoB,EAAE,MAAM,iBAAiB,CAAC;AAItE,+EAA+E;AAC/E,kBAAkB;AAClB,+EAA+E;AAE/E,OAAO,EAAE,cAAc,EAAE,gBAAgB,EAAE,MAAM,qBAAqB,CAAC;AASvE,+EAA+E;AAC/E,oBAAoB;AACpB,+EAA+E;AAE/E,OAAO,EAAE,oBAAoB,EAAE,MAAM,wBAAwB,CAAC;AAG9D,+EAA+E;AAC/E,YAAY;AACZ,+EAA+E;AAE/E,OAAO,EACL,UAAU,EACV,aAAa,EACb,YAAY,EACZ,cAAc,GAEf,MAAM,iBAAiB,CAAC;AAoBzB;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,MAAM,CAAC,KAAK,UAAU,WAAW,CAAC,UAAwB,EAAE;IAC1D,MAAM,eAAe,GAAG,kBAAkB,EAAE,CAAC;IAE7C,sCAAsC;IACtC,IAAI,CAAC;QACH,eAAe,CAAC,gBAAgB,EAAE,CAAC;IACrC,CAAC;IAAC,MAAM,CAAC;QACP,0CAA0C;IAC5C,CAAC;IAED,8CAA8C;IAC9C,MAAM,MAAM,GAAG,OAAO,CAAC,MAAM,IAAI,eAAe,CAAC,SAAS,EAAE,IAAI,EAAE,CAAC;IACnE,MAAM,KAAK,GAAG,OAAO,CAAC,KAAK,IAAI,eAAe,CAAC,eAAe,EAAE,CAAC;IACjE,MAAM,OAAO,GAAG,OAAO,CAAC,OAAO,IAAI,eAAe,CAAC,UAAU,EAAE,CAAC;IAChE,MAAM,aAAa,GAAG,OAAO,CAAC,aAAa,CAAC;IAE5C,wBAAwB;IACxB,MAAM,KAAK,GAAG,IAAI,QAAQ,CACxB,MAAM,EACN,OAAO,EACP,KAAK,EACL,aAAa,CACd,CAAC;IAEF,OAAO,KAAK,CAAC;AACf,CAAC;AAED;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,MAAM,UAAU,cAAc,CAC5B,IAAuD,EACvD,MAAqE;IAErE,OAAO,IAAI,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC;AACpC,CAAC;AAED;;;;;;;;;;;;;GAaG;AACH,MAAM,CAAC,KAAK,UAAU,aAAa,CAAC,MAKnC;IACC,MAAM,eAAe,GAAG,kBAAkB,EAAE,CAAC;IAE7C,kBAAkB;IAClB,IAAI,MAAM,CAAC,MAAM,EAAE,CAAC;QAClB,eAAe,CAAC,iBAAiB,CAAC,QAAQ,EAAE,MAAM,CAAC,MAAM,CAAC,CAAC;IAC7D,CAAC;IACD,IAAI,MAAM,CAAC,KAAK,EAAE,CAAC;QACjB,eAAe,CAAC,iBAAiB,CAAC,cAAc,EAAE,MAAM,CAAC,KAAK,CAAC,CAAC;IAClE,CAAC;IACD,IAAI,MAAM,CAAC,OAAO,EAAE,CAAC;QACnB,eAAe,CAAC,iBAAiB,CAAC,SAAS,EAAE,MAAM,CAAC,OAAO,CAAC,CAAC;IAC/D,CAAC;IAED,qCAAqC;IACrC,IAAI,MAAM,CAAC,UAAU,EAAE,CAAC;QACtB,MAAM,oBAAoB,EAAE,CAAC;IAC/B,CAAC;AACH,CAAC"}
+{"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;

package/dist/sdk/progress-reporter.js

@@ -0,0 +1,178 @@
+/**
+ * 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 var ProgressEventType;
+(function (ProgressEventType) {
+    /** Agent started a new task */
+    ProgressEventType["TASK_START"] = "task_start";
+    /** Agent made progress on current task */
+    ProgressEventType["TASK_PROGRESS"] = "task_progress";
+    /** Agent completed a task */
+    ProgressEventType["TASK_COMPLETE"] = "task_complete";
+    /** Agent encountered an error */
+    ProgressEventType["TASK_ERROR"] = "task_error";
+    /** Tool execution started */
+    ProgressEventType["TOOL_START"] = "tool_start";
+    /** Tool execution completed */
+    ProgressEventType["TOOL_COMPLETE"] = "tool_complete";
+    /** General status update */
+    ProgressEventType["STATUS_UPDATE"] = "status_update";
+})(ProgressEventType || (ProgressEventType = {}));
+/**
+ * Progress Reporter - Singleton event emitter for progress tracking
+ */
+export class ProgressReporter extends EventEmitter {
+    static instance = null;
+    constructor() {
+        super();
+        // Allow more listeners (multiple agents can subscribe)
+        this.setMaxListeners(50);
+    }
+    /**
+     * Get the singleton instance
+     */
+    static getInstance() {
+        if (!ProgressReporter.instance) {
+            ProgressReporter.instance = new ProgressReporter();
+        }
+        return ProgressReporter.instance;
+    }
+    /**
+     * Reset the singleton (for testing)
+     */
+    static reset() {
+        if (ProgressReporter.instance) {
+            ProgressReporter.instance.removeAllListeners();
+            ProgressReporter.instance = null;
+        }
+    }
+    /**
+     * Report a progress event
+     */
+    report(event) {
+        const fullEvent = {
+            ...event,
+            timestamp: Date.now(),
+        };
+        this.emit('progress', fullEvent);
+        this.emit(event.type, fullEvent);
+    }
+    /**
+     * Report task start
+     */
+    taskStart(agentId, name, message) {
+        this.report({
+            type: ProgressEventType.TASK_START,
+            agentId,
+            name,
+            message,
+            progress: 0,
+        });
+    }
+    /**
+     * Report task progress
+     */
+    taskProgress(agentId, name, progress, message) {
+        this.report({
+            type: ProgressEventType.TASK_PROGRESS,
+            agentId,
+            name,
+            progress: Math.max(0, Math.min(100, progress)),
+            message,
+        });
+    }
+    /**
+     * Report task completion
+     */
+    taskComplete(agentId, name, message) {
+        this.report({
+            type: ProgressEventType.TASK_COMPLETE,
+            agentId,
+            name,
+            message,
+            progress: 100,
+        });
+    }
+    /**
+     * Report task error
+     */
+    taskError(agentId, name, error) {
+        this.report({
+            type: ProgressEventType.TASK_ERROR,
+            agentId,
+            name,
+            message: error,
+        });
+    }
+    /**
+     * Report tool execution start
+     */
+    toolStart(agentId, toolName, message) {
+        this.report({
+            type: ProgressEventType.TOOL_START,
+            agentId,
+            name: toolName,
+            message,
+        });
+    }
+    /**
+     * Report tool execution completion
+     */
+    toolComplete(agentId, toolName, message) {
+        this.report({
+            type: ProgressEventType.TOOL_COMPLETE,
+            agentId,
+            name: toolName,
+            message,
+        });
+    }
+    /**
+     * Report general status update
+     */
+    statusUpdate(agentId, message, metadata) {
+        this.report({
+            type: ProgressEventType.STATUS_UPDATE,
+            agentId,
+            name: 'status',
+            message,
+            metadata,
+        });
+    }
+    /**
+     * Subscribe to all progress events
+     */
+    onProgress(callback) {
+        this.on('progress', callback);
+        return () => this.off('progress', callback);
+    }
+    /**
+     * Subscribe to specific event type
+     */
+    onEvent(type, callback) {
+        this.on(type, callback);
+        return () => this.off(type, callback);
+    }
+    /**
+     * Get statistics about event emission
+     */
+    getStats() {
+        return {
+            listenerCount: this.listenerCount('progress'),
+            maxListeners: this.getMaxListeners(),
+        };
+    }
+}
+/**
+ * Get the global progress reporter instance
+ */
+export function getProgressReporter() {
+    return ProgressReporter.getInstance();
+}
+//# sourceMappingURL=progress-reporter.js.map

package/dist/sdk/progress-reporter.js.map

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

package/dist/sdk/testing.d.ts

@@ -0,0 +1,184 @@
+/**
+ * Testing utilities for AX CLI SDK
+ *
+ * This module provides mock implementations and test helpers to make
+ * it easy to test code that uses the AX CLI SDK.
+ *
+ * @packageDocumentation
+ */
+import { EventEmitter } from 'events';
+import type { ChatEntry, StreamingChunk } from '../agent/llm-agent.js';
+import type { ToolResult } from '../types/index.js';
+/**
+ * Mock agent for testing
+ *
+ * Implements the same interface as LLMAgent but with predictable,
+ * controllable behavior for testing.
+ *
+ * @example
+ * ```typescript
+ * import { MockAgent } from '@defai.digital/ax-cli/sdk/testing';
+ *
+ * test('my integration', async () => {
+ *   const agent = new MockAgent({
+ *     responses: ['First response', 'Second response']
+ *   });
+ *
+ *   const result = await agent.processUserMessage('Hello');
+ *   expect(result[0].content).toBe('First response');
+ * });
+ * ```
+ */
+export declare class MockAgent extends EventEmitter {
+    private responses;
+    private currentResponseIndex;
+    private history;
+    private disposed;
+    /**
+     * Create a new mock agent
+     *
+     * @param options - Configuration for mock behavior
+     */
+    constructor(options?: {
+        /** Predefined responses to return (cycles through) */
+        responses?: string[];
+    });
+    /**
+     * Process a user message (mock implementation)
+     *
+     * Returns the next predefined response and adds it to history.
+     * Cycles through responses if called more times than responses available.
+     *
+     * @param message - User message (stored in history)
+     * @returns Mock chat history
+     */
+    processUserMessage(message: string): Promise<ChatEntry[]>;
+    /**
+     * Process user message with streaming (mock implementation)
+     *
+     * Yields mock stream chunks for the response.
+     */
+    processUserMessageStream(message: string): AsyncGenerator<StreamingChunk>;
+    /**
+     * Get chat history (mock implementation)
+     */
+    getChatHistory(): ChatEntry[];
+    /**
+     * Execute bash command (mock implementation)
+     *
+     * Always returns success with predefined output.
+     */
+    executeBashCommand(command: string): Promise<ToolResult>;
+    /**
+     * Get current directory (mock implementation)
+     */
+    getCurrentDirectory(): string;
+    /**
+     * Create checkpoint (mock implementation)
+     */
+    createCheckpoint(_description?: string): Promise<string>;
+    /**
+     * Rewind conversation (mock implementation)
+     */
+    rewindConversation(_checkpointId: string): Promise<{
+        success: boolean;
+        error?: string;
+    }>;
+    /**
+     * Check if bash is executing (mock implementation)
+     */
+    isBashExecuting(): boolean;
+    /**
+     * Dispose of mock agent
+     */
+    dispose(): Promise<void>;
+    /**
+     * Reset mock agent state
+     *
+     * Clears history and resets response index.
+     * Useful for reusing the same mock across multiple tests.
+     */
+    reset(): void;
+    /**
+     * Set new responses
+     *
+     * @param responses - New responses to use
+     */
+    setResponses(responses: string[]): void;
+    /**
+     * Get number of messages processed
+     */
+    getMessageCount(): number;
+    private checkDisposed;
+}
+/**
+ * Create a mock agent with predefined responses
+ *
+ * Convenience function for creating mock agents.
+ *
+ * @param responses - Predefined responses (optional)
+ * @returns Mock agent instance
+ *
+ * @example
+ * ```typescript
+ * import { createMockAgent } from '@defai.digital/ax-cli/sdk/testing';
+ *
+ * const agent = createMockAgent(['Hello!', 'How can I help?']);
+ * const result = await agent.processUserMessage('Hi');
+ * expect(result[0].content).toBe('Hello!');
+ * ```
+ */
+export declare function createMockAgent(responses?: string[]): MockAgent;
+/**
+ * Mock settings manager for testing
+ *
+ * Allows tests to control what settings are returned without
+ * needing actual config files.
+ *
+ * @example
+ * ```typescript
+ * import { MockSettingsManager } from '@defai.digital/ax-cli/sdk/testing';
+ *
+ * const settings = new MockSettingsManager({
+ *   apiKey: 'test-key',
+ *   baseURL: 'https://test.api.com',
+ *   model: 'glm-4.6'
+ * });
+ * ```
+ */
+export declare class MockSettingsManager {
+    private settings;
+    constructor(settings?: {
+        apiKey?: string;
+        baseURL?: string;
+        model?: string;
+    });
+    loadUserSettings(): void;
+    loadProjectSettings(): void;
+    getApiKey(): string | undefined;
+    getBaseURL(): string | undefined;
+    getCurrentModel(): string;
+    updateUserSetting(key: string, value: unknown): void;
+    saveUserSettings(): void;
+}
+/**
+ * Create a mock settings manager
+ *
+ * @param settings - Settings to return
+ * @returns Mock settings manager
+ *
+ * @example
+ * ```typescript
+ * import { createMockSettings } from '@defai.digital/ax-cli/sdk/testing';
+ *
+ * const settings = createMockSettings({
+ *   apiKey: 'test-key',
+ *   model: 'glm-4.6'
+ * });
+ * ```
+ */
+export declare function createMockSettings(settings?: {
+    apiKey?: string;
+    baseURL?: string;
+    model?: string;
+}): MockSettingsManager;