@defai.digital/ax-cli 4.4.7 → 4.4.11

package/dist/agent/index.js

@@ -1,145 +0,0 @@
-import { TextEditorTool, BashTool } from '../tools/index.js';
-export class Agent {
-    textEditor;
-    bash;
-    state;
-    constructor() {
-        this.textEditor = new TextEditorTool();
-        this.bash = new BashTool();
-        this.state = {
-            currentDirectory: process.cwd(),
-            editHistory: [],
-            tools: []
-        };
-    }
-    async processCommand(input) {
-        const trimmedInput = input.trim();
-        if (trimmedInput.startsWith('view ')) {
-            const args = this.parseViewCommand(trimmedInput);
-            return this.textEditor.view(args.path, args.range);
-        }
-        if (trimmedInput.startsWith('str_replace ')) {
-            const args = this.parseStrReplaceCommand(trimmedInput);
-            if (!args) {
-                return { success: false, error: 'Invalid str_replace command format' };
-            }
-            return this.textEditor.strReplace(args.path, args.oldStr, args.newStr);
-        }
-        if (trimmedInput.startsWith('create ')) {
-            const args = this.parseCreateCommand(trimmedInput);
-            if (!args) {
-                return { success: false, error: 'Invalid create command format' };
-            }
-            return this.textEditor.create(args.path, args.content);
-        }
-        if (trimmedInput.startsWith('insert ')) {
-            const args = this.parseInsertCommand(trimmedInput);
-            if (!args) {
-                return { success: false, error: 'Invalid insert command format' };
-            }
-            return this.textEditor.insert(args.path, args.line, args.content);
-        }
-        if (trimmedInput === 'undo_edit') {
-            return this.textEditor.undoEdit();
-        }
-        if (trimmedInput.startsWith('bash ') || trimmedInput.startsWith('$ ')) {
-            const command = trimmedInput.startsWith('bash ')
-                ? trimmedInput.substring(5)
-                : trimmedInput.substring(2);
-            return this.bash.execute(command);
-        }
-        if (trimmedInput === 'pwd') {
-            return {
-                success: true,
-                output: this.bash.getCurrentDirectory()
-            };
-        }
-        if (trimmedInput === 'history') {
-            const history = this.textEditor.getEditHistory();
-            return {
-                success: true,
-                output: history.length > 0
-                    ? JSON.stringify(history, null, 2)
-                    : 'No edit history'
-            };
-        }
-        if (trimmedInput === 'help') {
-            return this.getHelp();
-        }
-        return this.bash.execute(trimmedInput);
-    }
-    parseViewCommand(input) {
-        const parts = input.split(' ');
-        if (parts.length < 2) {
-            throw new Error('View command requires a file path');
-        }
-        const path = parts[1];
-        if (parts.length > 2) {
-            const rangePart = parts[2];
-            if (rangePart.includes('-')) {
-                const splitParts = rangePart.split('-').map(Number);
-                // Ensure we have exactly 2 parts for valid range
-                if (splitParts.length === 2) {
-                    const [start, end] = splitParts;
-                    if (!isNaN(start) && !isNaN(end) && start > 0 && end >= start) {
-                        return { path, range: [start, end] };
-                    }
-                }
-            }
-        }
-        return { path };
-    }
-    parseStrReplaceCommand(input) {
-        const match = input.match(/str_replace\s+(\S+)\s+"([^"]+)"\s+"([^"]*)"/);
-        if (!match)
-            return null;
-        return {
-            path: match[1],
-            oldStr: match[2],
-            newStr: match[3]
-        };
-    }
-    parseCreateCommand(input) {
-        const match = input.match(/create\s+(\S+)\s+"([^"]*)"/);
-        if (!match)
-            return null;
-        return {
-            path: match[1],
-            content: match[2]
-        };
-    }
-    parseInsertCommand(input) {
-        const match = input.match(/insert\s+(\S+)\s+(\d+)\s+"([^"]*)"/);
-        if (!match)
-            return null;
-        return {
-            path: match[1],
-            line: parseInt(match[2], 10),
-            content: match[3]
-        };
-    }
-    getHelp() {
-        return {
-            success: true,
-            output: `Available commands:
-  view <path> [start-end]     - View file contents or directory
-  str_replace <path> "old" "new" - Replace text in file
-  create <path> "content"     - Create new file with content
-  insert <path> <line> "text" - Insert text at specific line
-  undo_edit                   - Undo last edit operation
-  bash <command>              - Execute bash command
-  $ <command>                 - Execute bash command (shorthand)
-  pwd                         - Show current directory
-  history                     - Show edit history
-  help                        - Show this help message`
-        };
-    }
-    getCurrentState() {
-        return {
-            ...this.state,
-            currentDirectory: this.bash.getCurrentDirectory(),
-            editHistory: this.textEditor.getEditHistory()
-        };
-    }
-}
-//# sourceMappingURL=index.js.map

package/dist/agent/index.js.map

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

package/dist/agent/llm-agent.d.ts

@@ -1,368 +0,0 @@
-import type { SamplingConfig, ThinkingConfig, MessageContentPart } from "../llm/types.js";
-import { ToolResult } from "../types/index.js";
-import { EventEmitter } from "events";
-import { CheckpointManager } from "../checkpoint/index.js";
-import { SubagentOrchestrator } from "./subagent-orchestrator.js";
-import { TaskPlan } from "../planner/index.js";
-import type { ChatEntry as CoreChatEntry, StreamingChunk as CoreStreamingChunk, AccumulatedMessage as CoreAccumulatedMessage } from "./core/index.js";
-export type ChatEntry = CoreChatEntry;
-export type StreamingChunk = CoreStreamingChunk;
-export type AccumulatedMessage = CoreAccumulatedMessage;
-export declare class LLMAgent extends EventEmitter {
-    private llmClient;
-    private toolExecutor;
-    private streamHandler;
-    private planExecutor;
-    private chatHistory;
-    private messages;
-    private tokenCounter;
-    private contextManager;
-    private abortController;
-    private maxToolRounds;
-    private toolCallIndexMap;
-    private toolCallArgsCache;
-    private checkpointManager;
-    private subagentOrchestrator;
-    private taskPlanner;
-    private currentPlan;
-    private planningEnabled;
-    /** Sampling configuration for deterministic/reproducible mode */
-    private samplingConfig;
-    /** Thinking/reasoning mode configuration */
-    private thinkingConfig;
-    /** Track if auto-thinking was enabled for current message (for UI indicator) */
-    private autoThinkingEnabled;
-    /** User's explicit thinking preference (undefined = auto, true/false = explicit) */
-    private userThinkingPreference;
-    /** Stored reference to context overflow listener for proper cleanup */
-    private contextOverflowListener;
-    /** Track if agent has been disposed */
-    private disposed;
-    /** Tool approval system for VSCode integration */
-    private requireToolApproval;
-    private toolApprovalCallbacks;
-    /** BUG FIX: Track approval timeouts for cleanup to prevent memory leaks */
-    private toolApprovalTimeouts;
-    /** BUG FIX: Track resolved state to prevent double-resolution race condition */
-    private toolApprovalResolved;
-    /** BUG FIX: Track cleanup timeouts for toolApprovalResolved to clear on dispose */
-    private toolApprovalCleanupTimeouts;
-    constructor(apiKey: string, baseURL?: string, model?: string, maxToolRounds?: number);
-    /**
-     * Run an async task in background with proper error handling
-     * Centralizes the common pattern of background initialization
-     */
-    private runBackgroundTask;
-    private initializeCheckpointManager;
-    private initializeMCP;
-    /**
-     * Update the system prompt to include MCP tools after they're initialized
-     * This ensures the LLM knows about available MCP capabilities (web search, etc.)
-     */
-    private updateSystemPromptWithMCPTools;
-    /**
-     * Build chat options with sampling and thinking configuration included
-     * Merges provided options with the agent's configurations
-     */
-    private buildChatOptions;
-    /**
-     * Check if current messages contain multimodal (image) content
-     * Used to auto-switch to vision model
-     */
-    private hasMultimodalContent;
-    /**
-     * Set sampling configuration for this agent session
-     * @param config Sampling configuration to apply
-     */
-    setSamplingConfig(config: SamplingConfig | undefined): void;
-    /**
-     * Set thinking/reasoning mode configuration for this agent session
-     * @param config Thinking configuration to apply (enabled/disabled)
-     * @param isUserExplicit Whether this is an explicit user preference (vs auto-detection)
-     */
-    setThinkingConfig(config: ThinkingConfig | undefined, isUserExplicit?: boolean): void;
-    /**
-     * Get current thinking configuration
-     */
-    getThinkingConfig(): ThinkingConfig | undefined;
-    /**
-     * Check if auto-thinking was enabled for the current message
-     * Used by UI to show indicator when thinking was auto-activated
-     */
-    isAutoThinkingEnabled(): boolean;
-    /**
-     * Get current sampling configuration
-     */
-    getSamplingConfig(): SamplingConfig | undefined;
-    /**
-     * Apply auto-thinking mode detection for a user message
-     * Only activates if user hasn't explicitly set a preference
-     *
-     * @param message User's message text
-     * @returns true if thinking mode was auto-enabled, false otherwise
-     */
-    private applyAutoThinking;
-    /**
-     * Enable or disable tool approval requirement
-     * When enabled, text_editor operations will emit 'tool:approval_required' events
-     * and wait for approval before executing
-     *
-     * This is used by VSCode extension to show diff previews
-     *
-     * @param enabled - Whether to require approval for text_editor operations
-     */
-    setRequireToolApproval(enabled: boolean): void;
-    /**
-     * Approve or reject a pending tool call
-     * Called by external integrations (e.g., VSCode extension) in response to
-     * 'tool:approval_required' events
-     *
-     * @param toolCallId - The ID of the tool call to approve/reject
-     * @param approved - true to execute the tool, false to reject it
-     */
-    approveToolCall(toolCallId: string, approved: boolean): void;
-    /**
-     * Wait for external approval of a tool call
-     * Emits 'tool:approval_required' event and waits for approveToolCall() to be called
-     *
-     * @param toolCall - The tool call awaiting approval
-     * @returns Promise<boolean> - true if approved, false if rejected or timeout
-     */
-    private waitForToolApproval;
-    /**
-     * Handle context overflow by generating a summary
-     * Called when context manager is about to prune messages
-     */
-    private handleContextOverflow;
-    /**
-     * Apply context pruning to both messages and chatHistory
-     * BUGFIX: Prevents chatHistory from growing unbounded
-     */
-    private applyContextPruning;
-    /**
-     * Check if agent is running in deterministic mode
-     */
-    isDeterministicMode(): boolean;
-    /**
-     * Parse tool call arguments with caching for loop detection
-     * Returns cached result if available, otherwise parses and caches
-     * Used specifically for isRepetitiveToolCall to avoid redundant parsing
-     */
-    private parseToolArgumentsCached;
-    /**
-     * Detect if a tool call is repetitive (likely causing a loop)
-     * Uses the intelligent LoopDetector which provides:
-     * - Tool-specific thresholds (file ops get higher limits)
-     * - Progress-based detection (tracks success/failure)
-     * - Cycle pattern detection (A→B→A→B loops)
-     */
-    private isRepetitiveToolCall;
-    /** Last loop detection result for error messages */
-    private lastLoopResult?;
-    /**
-     * Reset the tool call tracking (called at start of new user message)
-     */
-    private resetToolCallTracking;
-    /**
-     * Generate a helpful warning message when a loop is detected
-     * Uses the lastLoopResult for context-aware suggestions
-     *
-     * Note: Messages are designed to be professional and actionable,
-     * avoiding alarming language like "infinite loop" which can confuse users.
-     */
-    private getLoopWarningMessage;
-    /**
-     * Check if a request should trigger multi-phase planning
-     */
-    private shouldCreatePlan;
-    /**
-     * Get the current plan if any
-     */
-    getCurrentPlan(): TaskPlan | null;
-    /**
-     * Generate and execute a plan for a complex request
-     * Uses TodoWrite for Claude Code-style seamless progress display
-     */
-    processWithPlanning(message: string): AsyncGenerator<StreamingChunk, void, unknown>;
-    /**
-     * Internal streaming processor (used when planning falls back)
-     * Executes the core message processing loop without planning
-     */
-    private processUserMessageStreamInternal;
-    processUserMessage(message: string): Promise<ChatEntry[]>;
-    /**
-     * Prepare user message and apply context management
-     * Returns the calculated input tokens
-     *
-     * Supports both text-only and multimodal (with images) messages.
-     */
-    private prepareUserMessageForStreaming;
-    /**
-     * Extract display text from multimodal message content
-     * Used for chat history display (excludes binary image data)
-     */
-    private extractDisplayContent;
-    /**
-     * Extract text content from message for analysis purposes
-     * Used by planning and complexity detection
-     */
-    private getTextContentFromMessage;
-    /**
-     * Yield context warnings if needed
-     */
-    private yieldContextWarnings;
-    /**
-     * Check if operation was cancelled
-     */
-    private isCancelled;
-    /**
-     * Yield cancellation message
-     */
-    private yieldCancellation;
-    /**
-     * Load tools with error handling
-     * Returns tools array, logs error if loading fails
-     */
-    private loadToolsSafely;
-    /**
-     * Format tool result content for display or message
-     * Centralizes the common pattern of formatting success/error output
-     *
-     * @param result - Tool execution result
-     * @param defaultSuccess - Default message if success but no output (default: "Success")
-     * @param defaultError - Default message if error but no error message (default: "Error occurred")
-     * @returns Formatted content string
-     */
-    private formatToolResultContent;
-    /**
-     * Add assistant message to history and conversation
-     */
-    private addAssistantMessage;
-    /**
-     * Execute tool calls and yield results
-     */
-    private executeToolCalls;
-    processUserMessageStream(message: string | MessageContentPart[]): AsyncGenerator<StreamingChunk, void, unknown>;
-    /**
-     * Execute a tool call using the ToolExecutor
-     * Handles tool approval for VSCode integration before delegation
-     */
-    private executeTool;
-    getChatHistory(): ChatEntry[];
-    getCurrentDirectory(): string;
-    executeBashCommand(command: string): Promise<ToolResult>;
-    /**
-     * Check if a bash command is currently executing
-     */
-    isBashExecuting(): boolean;
-    /**
-     * Move currently running bash command to background
-     * Returns task ID if successful, null otherwise
-     */
-    moveBashToBackground(): string | null;
-    getCurrentModel(): string;
-    setModel(model: string): void;
-    abortCurrentOperation(): void;
-    /**
-     * Get current context window usage percentage
-     * Returns a number between 0-100
-     */
-    getContextPercentage(): number;
-    /**
-     * Create a checkpoint of current state
-     */
-    createCheckpoint(description?: string): Promise<string>;
-    /**
-     * Rewind conversation to a checkpoint
-     */
-    rewindConversation(checkpointId: string): Promise<{
-        success: boolean;
-        error?: string;
-    }>;
-    /**
-     * Get checkpoint manager instance
-     */
-    getCheckpointManager(): CheckpointManager;
-    /**
-     * Get subagent orchestrator instance
-     */
-    getSubagentOrchestrator(): SubagentOrchestrator;
-    /**
-     * Spawn a specialized subagent for a specific task
-     * This is a user-facing method that simplifies subagent usage
-     *
-     * @param role - The role/specialization of the subagent
-     * @param description - Task description
-     * @param context - Optional additional context
-     * @returns The result of the subagent execution
-     */
-    spawnSubagent(role: string, description: string, context?: {
-        files?: string[];
-        additionalContext?: string;
-    }): Promise<{
-        success: boolean;
-        output: string;
-        filesModified?: string[];
-        filesCreated?: string[];
-        error?: string;
-    }>;
-    /**
-     * Execute multiple tasks in parallel using subagents
-     * This automatically handles dependency resolution and parallel execution
-     *
-     * @param tasks - Array of tasks with role and description
-     * @returns Array of results from all tasks
-     */
-    executeParallelTasks(tasks: Array<{
-        role: string;
-        description: string;
-        dependencies?: string[];
-        id?: string;
-    }>): Promise<Array<{
-        taskId: string;
-        success: boolean;
-        output: string;
-        filesModified?: string[];
-        filesCreated?: string[];
-        error?: string;
-    }>>;
-    /**
-     * Check if agent has been disposed
-     * @internal
-     */
-    private checkDisposed;
-    /**
-     * Dispose of resources and remove event listeners
-     *
-     * This method should be called when the agent is no longer needed to prevent
-     * memory leaks and properly close all connections.
-     *
-     * After calling dispose(), the agent cannot be used anymore. Any method calls
-     * will throw an AGENT_DISPOSED error.
-     *
-     * Cleans up:
-     * - Event listeners
-     * - In-memory caches (tool calls, arguments)
-     * - Token counter and context manager
-     * - Aborts in-flight requests
-     * - Terminates subagents
-     * - Clears conversation history
-     *
-     * @example
-     * ```typescript
-     * const agent = await createAgent();
-     * try {
-     *   await agent.processUserMessage('task');
-     * } finally {
-     *   agent.dispose();  // Always cleanup
-     * }
-     * ```
-     */
-    dispose(): void;
-    /**
-     * Clean up resources and remove all event listeners.
-     * @deprecated Use dispose() instead for complete cleanup.
-     * This method now delegates to dispose() for backwards compatibility.
-     */
-    destroy(): void;
-}