@defai.digital/ax-cli 3.3.0 → 3.4.0

package/dist/sdk/index.js

@@ -0,0 +1,173 @@
+/**
+ * AX CLI SDK - Programmatic API for AX CLI
+ *
+ * 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.
+ *
+ * @example
+ * ```typescript
+ * import { createAgent, getSettingsManager } from '@defai.digital/ax-cli/sdk';
+ *
+ * // Initialize settings
+ * const settings = getSettingsManager();
+ * await settings.loadUserSettings();
+ *
+ * // Create agent
+ * const agent = await createAgent({
+ *   model: 'glm-4.6',
+ *   maxToolRounds: 50
+ * });
+ *
+ * // Listen to streaming responses
+ * agent.on('stream', (chunk) => {
+ *   console.log(chunk.content);
+ * });
+ *
+ * // Process messages
+ * const result = await agent.processUserMessage('List all TypeScript files');
+ * ```
+ *
+ * @packageDocumentation
+ */
+// ============================================================================
+// Core Agent Classes
+// ============================================================================
+export { LLMAgent } from '../agent/llm-agent.js';
+export { Subagent } from '../agent/subagent.js';
+export { SubagentOrchestrator } from '../agent/subagent-orchestrator.js';
+export { ContextManager } from '../agent/context-manager.js';
+// Internal imports for SDK functions
+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';
+// ============================================================================
+// LLM Client
+// ============================================================================
+export { LLMClient } from '../llm/client.js';
+export { SubagentRole, SubagentState, } from '../agent/subagent-types.js';
+// ============================================================================
+// Settings and Configuration
+// ============================================================================
+export { getSettingsManager } from '../utils/settings-manager.js';
+// ============================================================================
+// Utilities
+// ============================================================================
+export { createTokenCounter } from '../utils/token-counter.js';
+export { loadCustomInstructions } from '../utils/custom-instructions.js';
+export { buildSystemPrompt } from '../utils/prompt-builder.js';
+export { getUsageTracker } from '../utils/usage-tracker.js';
+export { extractErrorMessage, createErrorMessage, ErrorCategory } from '../utils/error-handler.js';
+// ============================================================================
+// MCP Integration
+// ============================================================================
+export { loadMCPConfig } from '../mcp/config.js';
+export { getMCPManager, initializeMCPServers } from '../llm/tools.js';
+// ============================================================================
+// Planning System
+// ============================================================================
+export { getTaskPlanner, isComplexRequest } from '../planner/index.js';
+// ============================================================================
+// Checkpoint System
+// ============================================================================
+export { getCheckpointManager } from '../checkpoint/index.js';
+// ============================================================================
+// Constants
+// ============================================================================
+export { GLM_MODELS, DEFAULT_MODEL, AGENT_CONFIG, PLANNER_CONFIG, } from '../constants.js';
+/**
+ * Create a new LLM Agent with configuration
+ *
+ * @param options - Agent configuration options
+ * @returns Configured LLM Agent instance
+ *
+ * @example
+ * ```typescript
+ * const agent = await createAgent({
+ *   model: 'glm-4.6',
+ *   maxToolRounds: 50
+ * });
+ *
+ * agent.on('stream', (chunk) => {
+ *   if (chunk.type === 'content') {
+ *     console.log(chunk.content);
+ *   }
+ * });
+ *
+ * const result = await agent.processUserMessage('Analyze this codebase');
+ * ```
+ */
+export async function createAgent(options = {}) {
+    const settingsManager = getSettingsManager();
+    // Load settings if not already loaded
+    try {
+        settingsManager.loadUserSettings();
+    }
+    catch {
+        // Settings may not exist yet, that's okay
+    }
+    // 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 agent = new LLMAgent(apiKey, baseURL, model, maxToolRounds);
+    return agent;
+}
+/**
+ * Create a specialized subagent for specific tasks
+ *
+ * @param role - The role/specialty of the subagent
+ * @param config - Optional configuration overrides
+ * @returns Configured Subagent instance
+ *
+ * @example
+ * ```typescript
+ * const testAgent = createSubagent(SubagentRole.TESTING, {
+ *   maxToolRounds: 20,
+ *   priority: 2
+ * });
+ *
+ * const result = await testAgent.execute({
+ *   id: 'task-1',
+ *   description: 'Write unit tests for auth module',
+ *   context: { files: ['src/auth.ts'] }
+ * });
+ * ```
+ */
+export function createSubagent(role, config) {
+    return new Subagent(role, config);
+}
+/**
+ * Initialize SDK with configuration
+ *
+ * @param config - SDK initialization configuration
+ *
+ * @example
+ * ```typescript
+ * await initializeSDK({
+ *   apiKey: 'your-api-key',
+ *   model: 'glm-4.6',
+ *   baseURL: 'https://api.example.com/v1'
+ * });
+ * ```
+ */
+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();
+    }
+}
+//# sourceMappingURL=index.js.map

package/dist/sdk/index.js.map

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

package/dist/sdk/types.d.ts

@@ -0,0 +1,53 @@
+/**
+ * AX CLI SDK - Type Definitions
+ *
+ * Consolidated type definitions for SDK consumers.
+ * All types are re-exported from core modules for convenience.
+ */
+export type { ChatEntry, StreamingChunk } from '../agent/llm-agent.js';
+export type { AgentState } from '../types/index.js';
+export { SubagentRole, SubagentState, type SubagentConfig, type SubagentTask, type SubagentResult, type SubagentStatus, } from '../agent/subagent-types.js';
+export type { LLMMessage, LLMTool, LLMToolCall, LLMResponse, SearchParameters, SearchOptions, } from '../llm/client.js';
+export type { ChatOptions, ThinkingConfig, SamplingConfig, GLM46StreamChunk, } from '../llm/types.js';
+export type { ToolResult, Tool, EditorCommand } from '../types/index.js';
+export type { UserSettings, ProjectSettings, } from '../schemas/settings-schemas.js';
+export type { MCPConfig } from '../mcp/config.js';
+export type { MCPServerConfig } from '../mcp/client.js';
+export type { TaskPlan, TaskPhase, PhaseResult, PlanResult, PhaseStatus, } from '../planner/types.js';
+export type { Checkpoint, CheckpointMetadata, CheckpointFilter, } from '../checkpoint/types.js';
+import type { StreamingChunk } from '../agent/llm-agent.js';
+import type { LLMToolCall } from '../llm/client.js';
+import type { ToolResult } from '../types/index.js';
+import type { SubagentState, SubagentResult } from '../agent/subagent-types.js';
+/**
+ * Events emitted by LLMAgent
+ */
+export interface AgentEvents {
+    /** Streaming content chunk */
+    stream: (chunk: StreamingChunk) => void;
+    /** Tool execution started */
+    tool_start: (toolCall: LLMToolCall) => void;
+    /** Tool execution completed */
+    tool_complete: (toolCall: LLMToolCall, result: ToolResult) => void;
+    /** Token count updated */
+    token_count: (count: number) => void;
+    /** Error occurred */
+    error: (error: Error) => void;
+    /** Agent status changed */
+    status: (status: 'idle' | 'processing' | 'waiting' | 'error') => void;
+}
+/**
+ * Events emitted by Subagent
+ */
+export interface SubagentEvents {
+    /** Subagent state changed */
+    state_change: (state: SubagentState) => void;
+    /** Progress updated (0-100) */
+    progress: (progress: number) => void;
+    /** Task started */
+    task_start: (taskId: string) => void;
+    /** Task completed */
+    task_complete: (result: SubagentResult) => void;
+    /** Subagent error */
+    error: (error: Error) => void;
+}

package/dist/sdk/types.js

@@ -0,0 +1,8 @@
+/**
+ * AX CLI SDK - Type Definitions
+ *
+ * Consolidated type definitions for SDK consumers.
+ * All types are re-exported from core modules for convenience.
+ */
+export { SubagentRole, SubagentState, } from '../agent/subagent-types.js';
+//# sourceMappingURL=types.js.map

package/dist/sdk/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/sdk/types.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AASH,OAAO,EACL,YAAY,EACZ,aAAa,GAKd,MAAM,4BAA4B,CAAC"}

package/dist/tools/analysis-tools/architecture-tool.d.ts

@@ -0,0 +1,46 @@
+/**
+ * Architecture Analysis Tool
+ *
+ * LLM tool for architecture analysis
+ */
+import type { ToolResult } from '../../types/index.js';
+export declare class ArchitectureTool {
+    private analyzer;
+    constructor();
+    /**
+     * Analyze project architecture
+     */
+    execute(args: {
+        projectPath?: string;
+        depth?: string;
+    }): Promise<ToolResult>;
+    /**
+     * Format analysis result for display
+     */
+    private formatOutput;
+    /**
+     * Get tool definition for LLM
+     */
+    getToolDefinition(): {
+        type: "function";
+        function: {
+            name: string;
+            description: string;
+            parameters: {
+                type: string;
+                properties: {
+                    projectPath: {
+                        type: string;
+                        description: string;
+                    };
+                    depth: {
+                        type: string;
+                        enum: string[];
+                        default: string;
+                        description: string;
+                    };
+                };
+            };
+        };
+    };
+}

package/dist/tools/analysis-tools/architecture-tool.js

@@ -0,0 +1,124 @@
+/**
+ * Architecture Analysis Tool
+ *
+ * LLM tool for architecture analysis
+ */
+import { ArchitectureAnalyzer } from '../../analyzers/architecture/index.js';
+export class ArchitectureTool {
+    analyzer;
+    constructor() {
+        this.analyzer = new ArchitectureAnalyzer();
+    }
+    /**
+     * Analyze project architecture
+     */
+    async execute(args) {
+        try {
+            // Use current directory if no path specified
+            const projectPath = args.projectPath || process.cwd();
+            // Validate depth parameter
+            const depth = args.depth === 'deep' ? 'deep' : 'quick';
+            // Run analysis
+            const result = await this.analyzer.analyzeProject(projectPath, depth);
+            // Format output
+            const output = this.formatOutput(result);
+            return {
+                success: true,
+                output,
+            };
+        }
+        catch (error) {
+            return {
+                success: false,
+                error: `Architecture analysis failed: ${error.message}`,
+            };
+        }
+    }
+    /**
+     * Format analysis result for display
+     */
+    formatOutput(result) {
+        const lines = [];
+        lines.push('# Architecture Analysis\n');
+        lines.push(`**Project**: ${result.projectPath}`);
+        lines.push(`**Score**: ${result.architectureScore}/100`);
+        lines.push(`**Duration**: ${result.durationMs}ms\n`);
+        // Summary
+        lines.push('## Summary\n');
+        lines.push(result.summary);
+        lines.push('');
+        // Detected Patterns
+        if (result.detectedPatterns.length > 0) {
+            lines.push('## Detected Patterns\n');
+            for (const pattern of result.detectedPatterns) {
+                lines.push(`### ${pattern.name}`);
+                lines.push(`- **Category**: ${pattern.category}`);
+                lines.push(`- **Confidence**: ${Math.round(pattern.confidence * 100)}%`);
+                lines.push(`- **Description**: ${pattern.description}`);
+                lines.push(`- **Locations**: ${pattern.locations.join(', ')}`);
+                lines.push('');
+            }
+        }
+        // Anti-Patterns
+        if (result.antiPatterns.length > 0) {
+            lines.push('## Anti-Patterns Found\n');
+            for (const antiPattern of result.antiPatterns) {
+                lines.push(`### ⚠️  ${antiPattern.name} (${antiPattern.severity})`);
+                lines.push(`- **Description**: ${antiPattern.description}`);
+                lines.push(`- **Impact**: ${antiPattern.impact}`);
+                lines.push(`- **Suggestion**: ${antiPattern.suggestion}`);
+                lines.push(`- **Locations**: ${antiPattern.locations.join(', ')}`);
+                lines.push('');
+            }
+        }
+        // Recommendations
+        if (result.recommendations.length > 0) {
+            lines.push('## Recommendations\n');
+            for (const rec of result.recommendations) {
+                lines.push(`### ${rec.title} (Priority: ${rec.priority})`);
+                lines.push(`**Description**: ${rec.description}\n`);
+                lines.push(`**Rationale**: ${rec.rationale}\n`);
+                lines.push(`**Estimated Effort**: ${rec.estimatedEffort}\n`);
+                if (rec.benefits.length > 0) {
+                    lines.push('**Benefits**:');
+                    for (const benefit of rec.benefits) {
+                        lines.push(`- ${benefit}`);
+                    }
+                    lines.push('');
+                }
+                if (rec.relatedPatterns.length > 0) {
+                    lines.push(`**Related Patterns**: ${rec.relatedPatterns.join(', ')}\n`);
+                }
+            }
+        }
+        return lines.join('\n');
+    }
+    /**
+     * Get tool definition for LLM
+     */
+    getToolDefinition() {
+        return {
+            type: 'function',
+            function: {
+                name: 'analyze_architecture',
+                description: 'Analyze project architecture to detect patterns, anti-patterns, and generate improvement recommendations',
+                parameters: {
+                    type: 'object',
+                    properties: {
+                        projectPath: {
+                            type: 'string',
+                            description: 'Path to project root directory (default: current directory)',
+                        },
+                        depth: {
+                            type: 'string',
+                            enum: ['quick', 'deep'],
+                            default: 'quick',
+                            description: 'Analysis depth: "quick" for pattern detection only, "deep" includes anti-pattern detection',
+                        },
+                    },
+                },
+            },
+        };
+    }
+}
+//# sourceMappingURL=architecture-tool.js.map

package/dist/tools/analysis-tools/architecture-tool.js.map

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

package/dist/tools/analysis-tools/validation-tool.d.ts

@@ -0,0 +1,51 @@
+/**
+ * Validation Tool
+ *
+ * LLM tool for best practice validation
+ */
+import type { ToolResult } from '../../types/index.js';
+export declare class ValidationTool {
+    private validator;
+    constructor();
+    /**
+     * Validate files
+     */
+    execute(args: {
+        path?: string;
+        pattern?: string;
+        rules?: Record<string, {
+            enabled: boolean;
+        }>;
+    }): Promise<ToolResult>;
+    /**
+     * Format validation result for display
+     */
+    private formatOutput;
+    /**
+     * Get tool definition for LLM
+     */
+    getToolDefinition(): {
+        type: "function";
+        function: {
+            name: string;
+            description: string;
+            parameters: {
+                type: string;
+                properties: {
+                    path: {
+                        type: string;
+                        description: string;
+                    };
+                    pattern: {
+                        type: string;
+                        description: string;
+                    };
+                    rules: {
+                        type: string;
+                        description: string;
+                    };
+                };
+            };
+        };
+    };
+}

package/dist/tools/analysis-tools/validation-tool.js

@@ -0,0 +1,121 @@
+/**
+ * Validation Tool
+ *
+ * LLM tool for best practice validation
+ */
+import { BestPracticeValidator } from '../../analyzers/best-practices/best-practice-validator.js';
+import { glob } from 'glob';
+export class ValidationTool {
+    validator;
+    constructor() {
+        this.validator = new BestPracticeValidator();
+    }
+    /**
+     * Validate files
+     */
+    async execute(args) {
+        try {
+            const targetPath = args.path || process.cwd();
+            const pattern = args.pattern || '**/*.{ts,tsx}';
+            // Find files to validate
+            const files = await glob(pattern, {
+                cwd: targetPath,
+                absolute: true,
+                ignore: [
+                    '**/node_modules/**',
+                    '**/dist/**',
+                    '**/build/**',
+                    '**/.git/**',
+                ],
+            });
+            if (files.length === 0) {
+                return {
+                    success: true,
+                    output: 'No files found matching pattern',
+                };
+            }
+            // Validate files
+            const options = {
+                rules: args.rules,
+            };
+            const result = await this.validator.validateBatch(files, options);
+            // Format output
+            const output = this.formatOutput(result);
+            return {
+                success: true,
+                output,
+            };
+        }
+        catch (error) {
+            return {
+                success: false,
+                error: `Validation failed: ${error.message}`,
+            };
+        }
+    }
+    /**
+     * Format validation result for display
+     */
+    formatOutput(result) {
+        const lines = [];
+        lines.push('# Best Practice Validation\n');
+        lines.push(`**Files Checked**: ${result.files.length}`);
+        lines.push(`**Total Violations**: ${result.totalViolations}`);
+        lines.push(`**Average Score**: ${result.averageScore}/100\n`);
+        // Summary by severity
+        lines.push('## Violations by Severity\n');
+        lines.push(`- **Critical**: ${result.criticalCount}`);
+        lines.push(`- **High**: ${result.highCount}\n`);
+        // Top violations
+        if (result.files.length > 0) {
+            lines.push('## Files with Most Violations\n');
+            const sortedFiles = result.files
+                .slice()
+                .sort((a, b) => b.violations.length - a.violations.length)
+                .slice(0, 5);
+            for (const file of sortedFiles) {
+                if (file.violations.length > 0) {
+                    lines.push(`### ${file.file} (${file.violations.length} violations)\n`);
+                    for (const violation of file.violations.slice(0, 3)) {
+                        lines.push(`- **Line ${violation.line}**: ${violation.message}`);
+                        if (violation.suggestion) {
+                            lines.push(`  *Suggestion*: ${violation.suggestion}`);
+                        }
+                    }
+                    lines.push('');
+                }
+            }
+        }
+        return lines.join('\n');
+    }
+    /**
+     * Get tool definition for LLM
+     */
+    getToolDefinition() {
+        return {
+            type: 'function',
+            function: {
+                name: 'validate_best_practices',
+                description: 'Validate TypeScript/JavaScript files against best practices and coding standards',
+                parameters: {
+                    type: 'object',
+                    properties: {
+                        path: {
+                            type: 'string',
+                            description: 'Path to directory or file to validate (default: current directory)',
+                        },
+                        pattern: {
+                            type: 'string',
+                            description: 'Glob pattern for files to validate (default: **/*.{ts,tsx})',
+                        },
+                        rules: {
+                            type: 'object',
+                            description: 'Rule configuration (e.g., {"no-any-type": {"enabled": false}})',
+                        },
+                    },
+                },
+            },
+        };
+    }
+}
+//# sourceMappingURL=validation-tool.js.map

package/dist/tools/analysis-tools/validation-tool.js.map

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

package/dist/tools/web-search/cache.d.ts

@@ -0,0 +1,62 @@
+/**
+ * Search Cache
+ * In-memory cache for web search results
+ */
+import type { WebSearchResult } from "./types.js";
+export interface CacheEntry {
+    query: string;
+    results: WebSearchResult[];
+    timestamp: number;
+    ttl: number;
+}
+export declare class SearchCache {
+    private cache;
+    private readonly DEFAULT_TTL;
+    private readonly MAX_KEYS;
+    constructor(ttl?: number, maxKeys?: number);
+    /**
+     * Generate cache key from query
+     */
+    private getCacheKey;
+    /**
+     * Get cached results for a query
+     */
+    get(query: string): WebSearchResult[] | null;
+    /**
+     * Cache search results for a query
+     */
+    set(query: string, results: WebSearchResult[], ttl?: number): void;
+    /**
+     * Check if query has cached results
+     */
+    has(query: string): boolean;
+    /**
+     * Clear specific query from cache
+     */
+    delete(query: string): void;
+    /**
+     * Clear all cached results
+     */
+    clear(): void;
+    /**
+     * Get cache statistics
+     */
+    getStats(): {
+        keys: number;
+        hits: number;
+        misses: number;
+        hitRate: number;
+    };
+    /**
+     * Get all cached queries (for debugging)
+     */
+    getCachedQueries(): string[];
+    /**
+     * Get cache entry with metadata
+     */
+    getEntry(query: string): CacheEntry | null;
+    /**
+     * Get TTL for a cached query
+     */
+    getTTL(query: string): number | undefined;
+}