@defai.digital/ax-cli 3.14.14 → 3.14.17

package/dist/agent/agent-executor.js

@@ -0,0 +1,185 @@
+/**
+ * Agent Executor - Executes tasks through AutomatosX agents
+ *
+ * Spawns `ax run <agent> "message"` and streams the output back.
+ *
+ * @module agent-executor
+ */
+import { spawn } from 'child_process';
+import { EventEmitter } from 'events';
+/**
+ * Executes a task through an AutomatosX agent
+ *
+ * @param options - Execution options
+ * @returns AsyncGenerator that yields execution chunks
+ */
+export async function* executeAgent(options) {
+    const { agent, task, cwd = process.cwd(), timeout = 600000, // 10 minutes default
+    env = {}, streaming = true, noMemory = false, } = options;
+    // Build command arguments
+    const args = ['run', agent, task];
+    if (streaming) {
+        args.push('--streaming');
+    }
+    if (noMemory) {
+        args.push('--no-memory');
+    }
+    // Create abort controller for timeout
+    const abortController = new AbortController();
+    const timeoutId = setTimeout(() => {
+        abortController.abort();
+    }, timeout);
+    let process_ = null;
+    let abortHandler = null;
+    try {
+        // Spawn ax process
+        process_ = spawn('ax', args, {
+            cwd,
+            env: { ...process.env, ...env },
+            stdio: ['pipe', 'pipe', 'pipe'],
+            shell: false,
+        });
+        // Handle process spawn error
+        if (!process_.stdout || !process_.stderr) {
+            throw new Error('Failed to create process streams');
+        }
+        // Create event emitter for async iteration
+        const emitter = new EventEmitter();
+        let buffer = '';
+        // Handle stdout
+        process_.stdout.on('data', (data) => {
+            const text = data.toString();
+            buffer += text;
+            // Emit complete lines
+            const lines = buffer.split('\n');
+            buffer = lines.pop() || '';
+            for (const line of lines) {
+                if (line.trim()) {
+                    emitter.emit('chunk', { type: 'output', content: line + '\n' });
+                }
+            }
+        });
+        // Handle stderr
+        process_.stderr.on('data', (data) => {
+            const text = data.toString();
+            // Filter out common noise from stderr
+            if (!text.includes('npm warn') && !text.includes('ExperimentalWarning')) {
+                emitter.emit('chunk', { type: 'error', content: text });
+            }
+        });
+        // Handle process close
+        process_.on('close', (code) => {
+            // Emit any remaining buffer content
+            if (buffer.trim()) {
+                emitter.emit('chunk', { type: 'output', content: buffer });
+            }
+            emitter.emit('chunk', { type: 'done', exitCode: code ?? 0 });
+            emitter.emit('done');
+        });
+        // Handle process error
+        process_.on('error', (err) => {
+            emitter.emit('chunk', { type: 'error', content: err.message });
+            emitter.emit('chunk', { type: 'done', exitCode: 1 });
+            emitter.emit('done');
+        });
+        // Handle abort signal
+        abortHandler = () => {
+            if (process_ && !process_.killed) {
+                process_.kill('SIGTERM');
+                emitter.emit('chunk', { type: 'error', content: 'Agent execution timed out' });
+                emitter.emit('chunk', { type: 'done', exitCode: 124 });
+                emitter.emit('done');
+            }
+        };
+        abortController.signal.addEventListener('abort', abortHandler);
+        // Yield chunks as they arrive
+        const chunkQueue = [];
+        let isDone = false;
+        let resolveWait = null;
+        emitter.on('chunk', (chunk) => {
+            chunkQueue.push(chunk);
+            if (resolveWait) {
+                resolveWait();
+                resolveWait = null;
+            }
+        });
+        emitter.on('done', () => {
+            isDone = true;
+            if (resolveWait) {
+                resolveWait();
+                resolveWait = null;
+            }
+        });
+        while (!isDone || chunkQueue.length > 0) {
+            if (chunkQueue.length > 0) {
+                yield chunkQueue.shift();
+            }
+            else if (!isDone) {
+                await new Promise((resolve) => {
+                    resolveWait = resolve;
+                });
+            }
+        }
+    }
+    finally {
+        clearTimeout(timeoutId);
+        // Clean up abort handler to prevent memory leak
+        if (abortHandler) {
+            abortController.signal.removeEventListener('abort', abortHandler);
+        }
+        if (process_ && !process_.killed) {
+            process_.kill('SIGTERM');
+        }
+    }
+}
+/**
+ * Executes a task through an AutomatosX agent and returns the full result
+ *
+ * @param options - Execution options
+ * @returns Promise with execution result
+ */
+export async function executeAgentSync(options) {
+    const startTime = Date.now();
+    let output = '';
+    let exitCode = 0;
+    for await (const chunk of executeAgent(options)) {
+        switch (chunk.type) {
+            case 'output':
+                output += chunk.content || '';
+                break;
+            case 'error':
+                output += chunk.content || '';
+                break;
+            case 'done':
+                exitCode = chunk.exitCode ?? 0;
+                break;
+        }
+    }
+    return {
+        success: exitCode === 0,
+        output: output.trim(),
+        exitCode,
+        duration: Date.now() - startTime,
+    };
+}
+/**
+ * Check if ax command is available (cross-platform)
+ */
+export async function isAxAvailable() {
+    return new Promise((resolve) => {
+        // Use 'where' on Windows, 'which' on Unix-like systems
+        const isWindows = process.platform === 'win32';
+        const command = isWindows ? 'where' : 'which';
+        const process_ = spawn(command, ['ax'], {
+            stdio: 'pipe',
+            shell: isWindows, // Windows needs shell for 'where'
+        });
+        process_.on('close', (code) => {
+            resolve(code === 0);
+        });
+        process_.on('error', () => {
+            resolve(false);
+        });
+    });
+}
+//# sourceMappingURL=agent-executor.js.map

package/dist/agent/agent-executor.js.map

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

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

@@ -0,0 +1,68 @@
+/**
+ * Agent-First Router - MVP Implementation
+ *
+ * Lightweight router that matches user input to AutomatosX agents.
+ * Pure functions, session-cached availability, keyword-based matching.
+ *
+ * @module agent-router
+ */
+import type { AgentFirstSettings } from '../schemas/settings-schemas.js';
+/**
+ * Result of agent routing decision
+ */
+export interface AgentRoutingResult {
+    /** Selected agent name, or null to use direct LLM */
+    agent: string | null;
+    /** System prefix to inject into conversation */
+    systemPrefix: string;
+    /** Transparency note shown in UI */
+    transparencyNote: string;
+    /** Confidence score (0-1) */
+    confidence: number;
+    /** Matched keywords that triggered the routing */
+    matchedKeywords: string[];
+}
+/**
+ * Configuration for agent routing
+ */
+export interface AgentRouterConfig {
+    /** Enable/disable agent-first mode */
+    enabled: boolean;
+    /** Default agent when no keyword match */
+    defaultAgent: string | null;
+    /** Minimum confidence threshold for auto-routing */
+    confidenceThreshold: number;
+    /** Agents to exclude from auto-selection */
+    excludedAgents: string[];
+}
+/**
+ * Check if AutomatosX agents are available (cached per session)
+ */
+export declare function checkAgentAvailability(): {
+    available: boolean;
+    agents: string[];
+};
+/**
+ * Reset availability cache (for testing or session reset)
+ */
+export declare function resetAgentAvailabilityCache(): void;
+/**
+ * Match user input to agent based on keywords
+ */
+export declare function matchAgentByKeywords(userInput: string, availableAgents: string[], excludedAgents?: string[]): AgentRoutingResult | null;
+/**
+ * Get default router config from settings
+ */
+export declare function getDefaultRouterConfig(settings?: AgentFirstSettings): AgentRouterConfig;
+/**
+ * Main routing function - determines which agent should handle the task
+ */
+export declare function routeToAgent(userInput: string, config: AgentRouterConfig): AgentRoutingResult;
+/**
+ * Get list of available agents for display
+ */
+export declare function getAvailableAgents(): string[];
+/**
+ * Check if a specific agent is available
+ */
+export declare function isAgentAvailable(agentName: string): boolean;

package/dist/agent/agent-router.js

@@ -0,0 +1,250 @@
+/**
+ * Agent-First Router - MVP Implementation
+ *
+ * Lightweight router that matches user input to AutomatosX agents.
+ * Pure functions, session-cached availability, keyword-based matching.
+ *
+ * @module agent-router
+ */
+import { existsSync, readdirSync } from 'fs';
+import { join } from 'path';
+// Session cache for availability (avoid repeated filesystem checks)
+let availabilityCache = null;
+const AVAILABILITY_CACHE_TTL = 60000; // 1 minute
+/**
+ * Keyword to agent mapping (ordered by specificity)
+ * High-confidence keywords that strongly indicate domain
+ */
+const AGENT_KEYWORD_RULES = [
+    // Security - highest priority (security concerns override domain)
+    {
+        agent: 'security',
+        keywords: /\b(security|vulnerab|cve|xss|csrf|injection|auth(?:entication|orization)|encrypt|owasp|pentest|threat|exploit)\b/i,
+        confidence: 0.9,
+        matchedTerms: ['security', 'vulnerability', 'cve', 'xss', 'csrf', 'injection', 'authentication', 'authorization', 'encryption', 'owasp', 'pentest', 'threat', 'exploit'],
+    },
+    // Quality/Testing
+    {
+        agent: 'quality',
+        keywords: /\b(test(?:ing)?|vitest|jest|cypress|playwright|coverage|qa|bug|regression|e2e|unit[\s-]?test|integration[\s-]?test|spec)\b/i,
+        confidence: 0.85,
+        matchedTerms: ['test', 'testing', 'vitest', 'jest', 'cypress', 'playwright', 'coverage', 'qa', 'bug', 'regression', 'e2e', 'unit test', 'integration test', 'spec'],
+    },
+    // DevOps
+    {
+        agent: 'devops',
+        keywords: /\b(docker|kubernetes|k8s|helm|terraform|ansible|ci[\s\/]?cd|github[\s-]?action|jenkins|deploy|infrastructure|aws|gcp|azure|nginx|load[\s-]?balanc)\b/i,
+        confidence: 0.85,
+        matchedTerms: ['docker', 'kubernetes', 'k8s', 'helm', 'terraform', 'ansible', 'ci/cd', 'github actions', 'jenkins', 'deploy', 'infrastructure', 'aws', 'gcp', 'azure', 'nginx', 'load balancer'],
+    },
+    // Backend - specific technologies
+    {
+        agent: 'backend',
+        keywords: /\b(api|rest(?:ful)?|graphql|grpc|database|postgresql|mysql|mongodb|redis|microservice|golang|rust|server[\s-]?side|endpoint|middleware|orm|prisma)\b/i,
+        confidence: 0.8,
+        matchedTerms: ['api', 'rest', 'restful', 'graphql', 'grpc', 'database', 'postgresql', 'mysql', 'mongodb', 'redis', 'microservice', 'golang', 'rust', 'server-side', 'endpoint', 'middleware', 'orm', 'prisma'],
+    },
+    // Frontend - specific technologies
+    {
+        agent: 'frontend',
+        keywords: /\b(react|vue|angular|svelte|next\.?js|nuxt|css|tailwind|component|ui[\s-]?component|dom|html|responsive|scss|sass|styled[\s-]?component|animation)\b/i,
+        confidence: 0.8,
+        matchedTerms: ['react', 'vue', 'angular', 'svelte', 'next.js', 'nuxt', 'css', 'tailwind', 'component', 'ui component', 'dom', 'html', 'responsive', 'scss', 'sass', 'styled-component', 'animation'],
+    },
+    // Mobile
+    {
+        agent: 'mobile',
+        keywords: /\b(ios|android|swift|kotlin|flutter|react[\s-]?native|mobile[\s-]?app|xcode|gradle|cocoapod|expo)\b/i,
+        confidence: 0.8,
+        matchedTerms: ['ios', 'android', 'swift', 'kotlin', 'flutter', 'react native', 'mobile app', 'xcode', 'gradle', 'cocoapod', 'expo'],
+    },
+    // Data
+    {
+        agent: 'data',
+        keywords: /\b(etl|data[\s-]?pipeline|analytics|sql|data[\s-]?model|warehouse|bigquery|spark|kafka|airflow|dbt)\b/i,
+        confidence: 0.75,
+        matchedTerms: ['etl', 'data pipeline', 'analytics', 'sql', 'data model', 'warehouse', 'bigquery', 'spark', 'kafka', 'airflow', 'dbt'],
+    },
+    // Architecture
+    {
+        agent: 'architecture',
+        keywords: /\b(architect|system[\s-]?design|adr|scalab|microservice[\s-]?architect|event[\s-]?driven|domain[\s-]?driven|ddd|cqrs)\b/i,
+        confidence: 0.75,
+        matchedTerms: ['architecture', 'system design', 'adr', 'scalability', 'microservice architecture', 'event-driven', 'domain-driven', 'ddd', 'cqrs'],
+    },
+    // Product
+    {
+        agent: 'product',
+        keywords: /\b(prd|product[\s-]?requirement|user[\s-]?story|feature[\s-]?spec|roadmap|stakeholder|acceptance[\s-]?criteria)\b/i,
+        confidence: 0.7,
+        matchedTerms: ['prd', 'product requirement', 'user story', 'feature spec', 'roadmap', 'stakeholder', 'acceptance criteria'],
+    },
+    // Documentation/Writing
+    {
+        agent: 'writer',
+        keywords: /\b(document(?:ation)?|readme|changelog|technical[\s-]?writ|api[\s-]?doc|jsdoc|typedoc|wiki)\b/i,
+        confidence: 0.7,
+        matchedTerms: ['documentation', 'readme', 'changelog', 'technical writing', 'api doc', 'jsdoc', 'typedoc', 'wiki'],
+    },
+    // Design
+    {
+        agent: 'design',
+        keywords: /\b(figma|ui[\s\/]?ux|wireframe|mockup|prototype|design[\s-]?system|user[\s-]?experience|accessibility|a11y)\b/i,
+        confidence: 0.7,
+        matchedTerms: ['figma', 'ui/ux', 'wireframe', 'mockup', 'prototype', 'design system', 'user experience', 'accessibility', 'a11y'],
+    },
+    // Standards/Review (fallback for code-related queries)
+    {
+        agent: 'standard',
+        keywords: /\b(solid|design[\s-]?pattern|clean[\s-]?code|refactor|code[\s-]?review|best[\s-]?practice|lint|eslint|prettier|code[\s-]?quality)\b/i,
+        confidence: 0.65,
+        matchedTerms: ['solid', 'design pattern', 'clean code', 'refactor', 'code review', 'best practice', 'lint', 'eslint', 'prettier', 'code quality'],
+    },
+];
+/**
+ * Check if AutomatosX agents are available (cached per session)
+ */
+export function checkAgentAvailability() {
+    const now = Date.now();
+    // Return cached result if still valid
+    if (availabilityCache?.checked &&
+        (now - availabilityCache.timestamp) < AVAILABILITY_CACHE_TTL) {
+        return { available: availabilityCache.available, agents: availabilityCache.agents };
+    }
+    try {
+        const agentsDir = join(process.cwd(), '.automatosx', 'agents');
+        if (!existsSync(agentsDir)) {
+            availabilityCache = { checked: true, available: false, agents: [], timestamp: now };
+            return { available: false, agents: [] };
+        }
+        const agents = readdirSync(agentsDir)
+            .filter(f => f.endsWith('.yaml') || f.endsWith('.yml'))
+            .map(f => f.replace(/\.ya?ml$/, ''));
+        availabilityCache = {
+            checked: true,
+            available: agents.length > 0,
+            agents,
+            timestamp: now,
+        };
+        return { available: agents.length > 0, agents };
+    }
+    catch {
+        availabilityCache = { checked: true, available: false, agents: [], timestamp: now };
+        return { available: false, agents: [] };
+    }
+}
+/**
+ * Reset availability cache (for testing or session reset)
+ */
+export function resetAgentAvailabilityCache() {
+    availabilityCache = null;
+}
+/**
+ * Extract matched keywords from user input
+ */
+function extractMatchedKeywords(userInput, rule) {
+    const input = userInput.toLowerCase();
+    return rule.matchedTerms.filter(term => input.includes(term.toLowerCase()));
+}
+/**
+ * Match user input to agent based on keywords
+ */
+export function matchAgentByKeywords(userInput, availableAgents, excludedAgents = []) {
+    for (const rule of AGENT_KEYWORD_RULES) {
+        // Skip excluded agents
+        if (excludedAgents.includes(rule.agent)) {
+            continue;
+        }
+        // Check if agent is available
+        if (!availableAgents.includes(rule.agent)) {
+            continue;
+        }
+        // Test for keyword match
+        if (rule.keywords.test(userInput)) {
+            const matchedKeywords = extractMatchedKeywords(userInput, rule);
+            return {
+                agent: rule.agent,
+                confidence: rule.confidence,
+                systemPrefix: `[Routed to ${rule.agent} agent for specialized assistance]`,
+                transparencyNote: `Agent: ${rule.agent}`,
+                matchedKeywords,
+            };
+        }
+    }
+    return null; // No confident match
+}
+/**
+ * Get default router config from settings
+ */
+export function getDefaultRouterConfig(settings) {
+    return {
+        enabled: settings?.enabled ?? true,
+        defaultAgent: settings?.defaultAgent ?? 'standard',
+        confidenceThreshold: settings?.confidenceThreshold ?? 0.6,
+        excludedAgents: settings?.excludedAgents ?? [],
+    };
+}
+/**
+ * Main routing function - determines which agent should handle the task
+ */
+export function routeToAgent(userInput, config) {
+    // Check if routing is enabled
+    if (!config.enabled) {
+        return {
+            agent: null,
+            systemPrefix: '',
+            transparencyNote: '',
+            confidence: 0,
+            matchedKeywords: [],
+        };
+    }
+    // Check agent availability
+    const { available, agents } = checkAgentAvailability();
+    if (!available || agents.length === 0) {
+        return {
+            agent: null,
+            systemPrefix: '',
+            transparencyNote: '',
+            confidence: 0,
+            matchedKeywords: [],
+        };
+    }
+    // Try to match agent by keywords
+    const match = matchAgentByKeywords(userInput, agents, config.excludedAgents);
+    if (match && match.confidence >= config.confidenceThreshold) {
+        return match;
+    }
+    // Use default agent if configured and available
+    if (config.defaultAgent && agents.includes(config.defaultAgent)) {
+        return {
+            agent: config.defaultAgent,
+            confidence: 0.5,
+            systemPrefix: `[Using ${config.defaultAgent} agent]`,
+            transparencyNote: `Agent: ${config.defaultAgent}`,
+            matchedKeywords: [],
+        };
+    }
+    // No match, use direct LLM
+    return {
+        agent: null,
+        systemPrefix: '',
+        transparencyNote: '',
+        confidence: 0,
+        matchedKeywords: [],
+    };
+}
+/**
+ * Get list of available agents for display
+ */
+export function getAvailableAgents() {
+    const { agents } = checkAgentAvailability();
+    return agents;
+}
+/**
+ * Check if a specific agent is available
+ */
+export function isAgentAvailable(agentName) {
+    const { agents } = checkAgentAvailability();
+    return agents.includes(agentName);
+}
+//# sourceMappingURL=agent-router.js.map

package/dist/agent/agent-router.js.map

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

package/dist/analyzers/ast/tree-sitter-parser.d.ts

@@ -0,0 +1,134 @@
+/**
+ * Tree-sitter Parser
+ *
+ * Base class for tree-sitter based language parsers.
+ * Uses WebAssembly (WASM) for cross-platform compatibility.
+ *
+ * Supports: Python, Rust, Go, TypeScript, JavaScript, HTML, CSS, and 30+ more languages
+ */
+import { Tree } from 'web-tree-sitter';
+import { BaseLanguageParser, type SupportedLanguage } from './language-parser.js';
+import type { FileASTInfo } from './types.js';
+/**
+ * Tree-sitter based language parser
+ */
+export declare class TreeSitterParser extends BaseLanguageParser {
+    readonly language: SupportedLanguage;
+    private treeSitterLanguage;
+    private parser;
+    private loadedLanguage;
+    constructor(language: SupportedLanguage, treeSitterLanguage?: string);
+    private mapLanguageToTreeSitter;
+    /**
+     * Ensure parser is initialized
+     */
+    private ensureInitialized;
+    parseFile(filePath: string): Promise<FileASTInfo>;
+    parseContent(content: string, filePath?: string): Promise<FileASTInfo>;
+    /**
+     * Extract functions from AST
+     */
+    private extractFunctions;
+    /**
+     * Get node types that represent functions for this language
+     */
+    private getFunctionNodeTypes;
+    /**
+     * Extract function info from a function node
+     */
+    private extractFunctionInfo;
+    /**
+     * Extract function name
+     */
+    private extractFunctionName;
+    /**
+     * Extract parameters from function
+     */
+    private extractParameters;
+    /**
+     * Check if node is a parameter
+     */
+    private isParameterNode;
+    /**
+     * Extract parameter info
+     */
+    private extractParameterInfo;
+    /**
+     * Extract return type
+     */
+    private extractReturnType;
+    /**
+     * Check if function is async
+     */
+    private isAsyncFunction;
+    /**
+     * Check if function is exported
+     */
+    private isExportedFunction;
+    /**
+     * Calculate cyclomatic complexity
+     */
+    private calculateComplexity;
+    /**
+     * Extract classes from AST
+     */
+    private extractClasses;
+    /**
+     * Get node types that represent classes
+     */
+    private getClassNodeTypes;
+    /**
+     * Extract class info
+     */
+    private extractClassInfo;
+    /**
+     * Check if class is exported
+     */
+    private isExportedClass;
+    /**
+     * Extract methods from class
+     */
+    private extractMethods;
+    /**
+     * Get method visibility
+     */
+    private getVisibility;
+    /**
+     * Check if method is static
+     */
+    private isStatic;
+    /**
+     * Extract properties from class
+     */
+    private extractProperties;
+    /**
+     * Extract imports from AST
+     */
+    private extractImports;
+    /**
+     * Get import node types for this language
+     */
+    private getImportNodeTypes;
+    /**
+     * Extract import info
+     */
+    private extractImportInfo;
+    /**
+     * Extract exports from AST
+     */
+    private extractExports;
+    /**
+     * Get the raw syntax tree (for advanced usage)
+     */
+    getTree(content: string): Promise<Tree | null>;
+    dispose(): void;
+}
+/**
+ * Create a parser for a specific language
+ */
+export declare function createTreeSitterParser(language: SupportedLanguage): TreeSitterParser;
+/**
+ * Supported tree-sitter languages (beyond our core 5)
+ */
+export declare const TREE_SITTER_LANGUAGES: readonly ["bash", "c", "cpp", "c_sharp", "css", "dart", "elixir", "elm", "go", "html", "java", "javascript", "json", "kotlin", "lua", "objc", "ocaml", "php", "python", "ruby", "rust", "scala", "solidity", "swift", "toml", "tsx", "typescript", "vue", "yaml", "zig"];
+export type TreeSitterLanguage = typeof TREE_SITTER_LANGUAGES[number];