@defai.digital/ax-cli 3.8.6 → 3.8.8

package/dist/constants.d.ts

@@ -2,7 +2,11 @@
  * Application-wide constants
  * Now loaded from YAML configuration files for better maintainability
  */
+/** Configuration directory name */
+export declare const CONFIG_DIR_NAME = ".ax-cli";
 export declare const CONFIG_PATHS: {
+    /** Configuration directory name */
+    readonly DIR_NAME: ".ax-cli";
     /** User-level settings directory */
     readonly USER_DIR: string;
     /** User-level configuration file */
@@ -11,12 +15,16 @@ export declare const CONFIG_PATHS: {
     readonly PROJECT_DIR: string;
     /** Project-level settings file */
     readonly PROJECT_SETTINGS: string;
+    /** AutomatosX temporary files directory */
+    readonly AUTOMATOSX_TMP: string;
 };
 export declare const AGENT_CONFIG: {
     readonly MAX_TOOL_ROUNDS: number;
     readonly DEFAULT_TIMEOUT: number;
     readonly DEFAULT_MAX_TOKENS: number;
     readonly MAX_RECENT_TOOL_CALLS: number;
+    /** Maximum number of messages to keep in chat history */
+    readonly MAX_MESSAGES: number;
     readonly LOOP_DETECTION_THRESHOLD: number;
     readonly ENABLE_LOOP_DETECTION: boolean;
 };
@@ -80,6 +88,10 @@ export declare const TOKEN_CONFIG: {
 export declare const CACHE_CONFIG: {
     readonly DEFAULT_MAX_SIZE: number;
     readonly DEFAULT_TTL: number;
+    /** Max entries for tool call arguments cache */
+    readonly TOOL_ARGS_CACHE_MAX_SIZE: number;
+    /** Number of entries to remove when cache is full */
+    readonly TOOL_ARGS_CACHE_PRUNE_COUNT: number;
 };
 export declare const PERF_CONFIG: {
     readonly DEBOUNCE_DELAY: number;

package/dist/constants.js

@@ -9,16 +9,22 @@ import { loadModelsConfig, loadSettingsConfig, loadMessagesConfig, formatMessage
 const modelsYaml = loadModelsConfig();
 const settingsYaml = loadSettingsConfig();
 const messagesYaml = loadMessagesConfig();
+/** Configuration directory name */
+export const CONFIG_DIR_NAME = '.ax-cli';
 // Configuration Paths
 export const CONFIG_PATHS = {
+    /** Configuration directory name */
+    DIR_NAME: CONFIG_DIR_NAME,
     /** User-level settings directory */
-    USER_DIR: join(homedir(), '.ax-cli'),
+    USER_DIR: join(homedir(), CONFIG_DIR_NAME),
     /** User-level configuration file */
-    USER_CONFIG: join(homedir(), '.ax-cli', 'config.json'),
+    USER_CONFIG: join(homedir(), CONFIG_DIR_NAME, 'config.json'),
     /** Project-level settings directory */
-    PROJECT_DIR: join(process.cwd(), '.ax-cli'),
+    PROJECT_DIR: join(process.cwd(), CONFIG_DIR_NAME),
     /** Project-level settings file */
-    PROJECT_SETTINGS: join(process.cwd(), '.ax-cli', 'settings.json'),
+    PROJECT_SETTINGS: join(process.cwd(), CONFIG_DIR_NAME, 'settings.json'),
+    /** AutomatosX temporary files directory */
+    AUTOMATOSX_TMP: join(homedir(), 'automatosx', 'tmp'),
 };
 // Agent Configuration
 export const AGENT_CONFIG = {
@@ -26,6 +32,8 @@ export const AGENT_CONFIG = {
     DEFAULT_TIMEOUT: settingsYaml.agent.default_timeout,
     DEFAULT_MAX_TOKENS: settingsYaml.agent.default_max_tokens,
     MAX_RECENT_TOOL_CALLS: settingsYaml.agent.max_recent_tool_calls,
+    /** Maximum number of messages to keep in chat history */
+    MAX_MESSAGES: settingsYaml.agent.max_messages || 500,
     LOOP_DETECTION_THRESHOLD: settingsYaml.agent.loop_detection_threshold,
     ENABLE_LOOP_DETECTION: settingsYaml.agent.enable_loop_detection,
 };
@@ -113,6 +121,10 @@ export const TOKEN_CONFIG = {
 export const CACHE_CONFIG = {
     DEFAULT_MAX_SIZE: settingsYaml.cache.default_max_size,
     DEFAULT_TTL: settingsYaml.cache.default_ttl,
+    /** Max entries for tool call arguments cache */
+    TOOL_ARGS_CACHE_MAX_SIZE: settingsYaml.cache.tool_args_cache_max_size || 500,
+    /** Number of entries to remove when cache is full */
+    TOOL_ARGS_CACHE_PRUNE_COUNT: settingsYaml.cache.tool_args_cache_prune_count || 100,
 };
 // Performance Monitoring
 export const PERF_CONFIG = {

package/dist/constants.js.map

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

package/dist/hooks/hook-runner.d.ts

@@ -0,0 +1,138 @@
+/**
+ * Hook System (Phase 4)
+ *
+ * Based on Claude Code's hook architecture.
+ * Allows custom logic intercept points for tool execution.
+ *
+ * Hook Types:
+ * - PreToolUse: Before tool execution (validation, permission checks, logging)
+ * - PostToolUse: After tool execution (result transformation, analytics)
+ * - OnError: On tool failure (custom error handling, retry logic)
+ * - SessionStart: On session begin (setup, context loading)
+ * - SessionEnd: On session end (cleanup, reporting)
+ */
+import { EventEmitter } from 'events';
+import { LLMToolCall } from '../llm/client.js';
+import { ToolResult } from '../types/index.js';
+/**
+ * Hook execution timing
+ */
+export declare enum HookType {
+    PreToolUse = "pre_tool_use",
+    PostToolUse = "post_tool_use",
+    OnError = "on_error",
+    SessionStart = "session_start",
+    SessionEnd = "session_end"
+}
+/**
+ * Input passed to hook scripts (via stdin as JSON)
+ */
+export interface HookInput {
+    event: HookType;
+    tool: string;
+    args: Record<string, unknown>;
+    session: {
+        id: string;
+        startedAt: string;
+        messageCount: number;
+    };
+    result?: ToolResult;
+    error?: string;
+}
+/**
+ * Output expected from hook scripts (via stdout as JSON)
+ */
+export interface HookOutput {
+    action: 'continue' | 'block' | 'modify';
+    reason?: string;
+    modifiedArgs?: Record<string, unknown>;
+}
+/**
+ * Hook configuration
+ */
+interface HookDefinition {
+    name: string;
+    script: string;
+    tools: string[];
+    timeout?: number;
+    enabled?: boolean;
+}
+/**
+ * Hook configuration file structure
+ */
+interface HookConfig {
+    hooks: {
+        pre_tool_use?: HookDefinition[];
+        post_tool_use?: HookDefinition[];
+        on_error?: HookDefinition[];
+        session_start?: HookDefinition[];
+        session_end?: HookDefinition[];
+    };
+}
+/**
+ * Hook Runner
+ *
+ * Executes hooks at various points in tool execution lifecycle.
+ */
+export declare class HookRunner extends EventEmitter {
+    private config;
+    private configPath;
+    private sessionId;
+    private sessionStartedAt;
+    private messageCount;
+    /** Running hook processes for cleanup */
+    private runningProcesses;
+    constructor();
+    /**
+     * Initialize the hook runner (load config)
+     */
+    initialize(): Promise<void>;
+    /**
+     * Run pre-tool-use hooks
+     * Returns modified args or blocks execution
+     */
+    runPreToolUse(toolCall: LLMToolCall, args: Record<string, unknown>): Promise<HookOutput>;
+    /**
+     * Run post-tool-use hooks
+     */
+    runPostToolUse(toolCall: LLMToolCall, args: Record<string, unknown>, result: ToolResult): Promise<void>;
+    /**
+     * Run on-error hooks
+     */
+    runOnError(toolCall: LLMToolCall, args: Record<string, unknown>, error: string): Promise<HookOutput>;
+    /**
+     * Run session start hooks
+     */
+    private runSessionStartHooks;
+    /**
+     * Run session end hooks
+     */
+    runSessionEndHooks(): Promise<void>;
+    /**
+     * Increment message count (for session tracking)
+     */
+    incrementMessageCount(): void;
+    /**
+     * Get current hook configuration
+     */
+    getConfig(): HookConfig;
+    /**
+     * Reload configuration from file
+     */
+    reloadConfig(): Promise<void>;
+    /**
+     * Cleanup running processes
+     */
+    dispose(): Promise<void>;
+    private getHooksForType;
+    private shouldRunHook;
+    private executeHook;
+    private resolveScriptPath;
+    private getSessionInfo;
+    private generateSessionId;
+    private loadConfig;
+}
+export declare function getHookRunner(): HookRunner;
+export declare function initializeHookRunner(): Promise<HookRunner>;
+export declare function disposeHookRunner(): Promise<void>;
+export {};

package/dist/hooks/hook-runner.js

@@ -0,0 +1,429 @@
+/**
+ * Hook System (Phase 4)
+ *
+ * Based on Claude Code's hook architecture.
+ * Allows custom logic intercept points for tool execution.
+ *
+ * Hook Types:
+ * - PreToolUse: Before tool execution (validation, permission checks, logging)
+ * - PostToolUse: After tool execution (result transformation, analytics)
+ * - OnError: On tool failure (custom error handling, retry logic)
+ * - SessionStart: On session begin (setup, context loading)
+ * - SessionEnd: On session end (cleanup, reporting)
+ */
+import { EventEmitter } from 'events';
+import { spawn } from 'child_process';
+import { readFile, stat } from 'fs/promises';
+import { homedir } from 'os';
+import { join, dirname, resolve } from 'path';
+import * as yaml from 'js-yaml';
+import { extractErrorMessage } from '../utils/error-handler.js';
+import { CONFIG_DIR_NAME } from '../constants.js';
+/**
+ * Hook execution timing
+ */
+export var HookType;
+(function (HookType) {
+    HookType["PreToolUse"] = "pre_tool_use";
+    HookType["PostToolUse"] = "post_tool_use";
+    HookType["OnError"] = "on_error";
+    HookType["SessionStart"] = "session_start";
+    HookType["SessionEnd"] = "session_end";
+})(HookType || (HookType = {}));
+/**
+ * Default hook configuration
+ */
+const DEFAULT_CONFIG = {
+    hooks: {
+        pre_tool_use: [],
+        post_tool_use: [],
+        on_error: [],
+        session_start: [],
+        session_end: [],
+    },
+};
+/**
+ * Hook exit codes
+ */
+const EXIT_CODES = {
+    CONTINUE: 0, // Continue (approve)
+    ERROR: 1, // Error (log and continue)
+    BLOCK: 2, // Block execution
+};
+/**
+ * Hook Runner
+ *
+ * Executes hooks at various points in tool execution lifecycle.
+ */
+export class HookRunner extends EventEmitter {
+    config;
+    configPath;
+    sessionId;
+    sessionStartedAt;
+    messageCount = 0;
+    /** Running hook processes for cleanup */
+    runningProcesses = new Set();
+    constructor() {
+        super();
+        this.configPath = join(homedir(), CONFIG_DIR_NAME, 'hooks.yaml');
+        this.config = DEFAULT_CONFIG;
+        this.sessionId = this.generateSessionId();
+        this.sessionStartedAt = new Date().toISOString();
+    }
+    /**
+     * Initialize the hook runner (load config)
+     */
+    async initialize() {
+        try {
+            await this.loadConfig();
+        }
+        catch (error) {
+            // Use default config if loading fails
+            console.warn('Using default hook configuration');
+        }
+        // Run session start hooks
+        await this.runSessionStartHooks();
+    }
+    /**
+     * Run pre-tool-use hooks
+     * Returns modified args or blocks execution
+     */
+    async runPreToolUse(toolCall, args) {
+        const hooks = this.getHooksForType(HookType.PreToolUse);
+        let currentArgs = { ...args };
+        for (const hook of hooks) {
+            if (!this.shouldRunHook(hook, toolCall.function.name))
+                continue;
+            const input = {
+                event: HookType.PreToolUse,
+                tool: toolCall.function.name,
+                args: currentArgs,
+                session: this.getSessionInfo(),
+            };
+            try {
+                const result = await this.executeHook(hook, input);
+                if (result.action === 'block') {
+                    this.emit('hook:blocked', {
+                        hook: hook.name,
+                        tool: toolCall.function.name,
+                        reason: result.reason,
+                    });
+                    return result;
+                }
+                if (result.action === 'modify' && result.modifiedArgs) {
+                    currentArgs = result.modifiedArgs;
+                    this.emit('hook:modified', {
+                        hook: hook.name,
+                        tool: toolCall.function.name,
+                        originalArgs: args,
+                        modifiedArgs: currentArgs,
+                    });
+                }
+            }
+            catch (error) {
+                this.emit('hook:error', {
+                    hook: hook.name,
+                    tool: toolCall.function.name,
+                    error: extractErrorMessage(error),
+                });
+                // Continue on hook error (don't block tool execution)
+            }
+        }
+        return {
+            action: 'continue',
+            modifiedArgs: currentArgs,
+        };
+    }
+    /**
+     * Run post-tool-use hooks
+     */
+    async runPostToolUse(toolCall, args, result) {
+        const hooks = this.getHooksForType(HookType.PostToolUse);
+        for (const hook of hooks) {
+            if (!this.shouldRunHook(hook, toolCall.function.name))
+                continue;
+            const input = {
+                event: HookType.PostToolUse,
+                tool: toolCall.function.name,
+                args,
+                session: this.getSessionInfo(),
+                result,
+            };
+            try {
+                await this.executeHook(hook, input);
+            }
+            catch (error) {
+                this.emit('hook:error', {
+                    hook: hook.name,
+                    tool: toolCall.function.name,
+                    error: extractErrorMessage(error),
+                });
+            }
+        }
+    }
+    /**
+     * Run on-error hooks
+     */
+    async runOnError(toolCall, args, error) {
+        const hooks = this.getHooksForType(HookType.OnError);
+        for (const hook of hooks) {
+            if (!this.shouldRunHook(hook, toolCall.function.name))
+                continue;
+            const input = {
+                event: HookType.OnError,
+                tool: toolCall.function.name,
+                args,
+                session: this.getSessionInfo(),
+                error,
+            };
+            try {
+                const result = await this.executeHook(hook, input);
+                if (result.action === 'modify' && result.modifiedArgs) {
+                    // Hook wants to retry with modified args
+                    return result;
+                }
+            }
+            catch (hookError) {
+                this.emit('hook:error', {
+                    hook: hook.name,
+                    tool: toolCall.function.name,
+                    error: hookError instanceof Error ? hookError.message : String(hookError),
+                });
+            }
+        }
+        return { action: 'continue' };
+    }
+    /**
+     * Run session start hooks
+     */
+    async runSessionStartHooks() {
+        const hooks = this.getHooksForType(HookType.SessionStart);
+        for (const hook of hooks) {
+            const input = {
+                event: HookType.SessionStart,
+                tool: '',
+                args: {},
+                session: this.getSessionInfo(),
+            };
+            try {
+                await this.executeHook(hook, input);
+                this.emit('hook:session_start', { hook: hook.name });
+            }
+            catch (error) {
+                this.emit('hook:error', {
+                    hook: hook.name,
+                    error: extractErrorMessage(error),
+                });
+            }
+        }
+    }
+    /**
+     * Run session end hooks
+     */
+    async runSessionEndHooks() {
+        const hooks = this.getHooksForType(HookType.SessionEnd);
+        for (const hook of hooks) {
+            const input = {
+                event: HookType.SessionEnd,
+                tool: '',
+                args: {},
+                session: this.getSessionInfo(),
+            };
+            try {
+                await this.executeHook(hook, input);
+                this.emit('hook:session_end', { hook: hook.name });
+            }
+            catch (error) {
+                this.emit('hook:error', {
+                    hook: hook.name,
+                    error: extractErrorMessage(error),
+                });
+            }
+        }
+    }
+    /**
+     * Increment message count (for session tracking)
+     */
+    incrementMessageCount() {
+        this.messageCount++;
+    }
+    /**
+     * Get current hook configuration
+     */
+    getConfig() {
+        return { ...this.config };
+    }
+    /**
+     * Reload configuration from file
+     */
+    async reloadConfig() {
+        await this.loadConfig();
+        this.emit('hook:config_reloaded');
+    }
+    /**
+     * Cleanup running processes
+     */
+    async dispose() {
+        // Run session end hooks
+        await this.runSessionEndHooks();
+        // Kill any running processes
+        for (const proc of this.runningProcesses) {
+            try {
+                proc.kill('SIGTERM');
+            }
+            catch {
+                // Process may have already exited
+            }
+        }
+        this.runningProcesses.clear();
+    }
+    // ============================================================================
+    // Private Methods
+    // ============================================================================
+    getHooksForType(type) {
+        const hookKey = type;
+        const hooks = this.config.hooks[hookKey] || [];
+        return hooks.filter((h) => h.enabled !== false);
+    }
+    shouldRunHook(hook, toolName) {
+        if (!hook.tools || hook.tools.length === 0)
+            return true;
+        if (hook.tools.includes('*'))
+            return true;
+        return hook.tools.some((pattern) => {
+            if (pattern.endsWith('*')) {
+                return toolName.startsWith(pattern.slice(0, -1));
+            }
+            return toolName === pattern;
+        });
+    }
+    async executeHook(hook, input) {
+        const scriptPath = this.resolveScriptPath(hook.script);
+        const timeout = hook.timeout || 30000;
+        // Check if script exists
+        try {
+            await stat(scriptPath);
+        }
+        catch {
+            throw new Error(`Hook script not found: ${scriptPath}`);
+        }
+        return new Promise((resolve, reject) => {
+            const proc = spawn(scriptPath, [], {
+                stdio: ['pipe', 'pipe', 'pipe'],
+                timeout,
+                shell: true,
+            });
+            this.runningProcesses.add(proc);
+            let stdout = '';
+            let stderr = '';
+            proc.stdout?.on('data', (data) => {
+                stdout += data.toString();
+            });
+            proc.stderr?.on('data', (data) => {
+                stderr += data.toString();
+            });
+            proc.on('close', (code) => {
+                this.runningProcesses.delete(proc);
+                // Handle exit codes
+                if (code === EXIT_CODES.BLOCK) {
+                    resolve({
+                        action: 'block',
+                        reason: stderr || stdout || 'Blocked by hook',
+                    });
+                    return;
+                }
+                if (code === EXIT_CODES.ERROR) {
+                    // Log error but continue
+                    this.emit('hook:warning', {
+                        hook: hook.name,
+                        message: stderr || stdout || 'Hook returned error',
+                    });
+                    resolve({ action: 'continue' });
+                    return;
+                }
+                // Try to parse JSON output
+                try {
+                    if (stdout.trim()) {
+                        const output = JSON.parse(stdout.trim());
+                        resolve(output);
+                    }
+                    else {
+                        resolve({ action: 'continue' });
+                    }
+                }
+                catch {
+                    // Non-JSON output, treat as continue
+                    resolve({ action: 'continue' });
+                }
+            });
+            proc.on('error', (error) => {
+                this.runningProcesses.delete(proc);
+                reject(error);
+            });
+            // Send input via stdin
+            proc.stdin?.write(JSON.stringify(input));
+            proc.stdin?.end();
+        });
+    }
+    resolveScriptPath(script) {
+        // Expand ~ to home directory
+        if (script.startsWith('~')) {
+            return join(homedir(), script.slice(1));
+        }
+        // Resolve relative paths from config directory
+        if (!script.startsWith('/')) {
+            return resolve(dirname(this.configPath), script);
+        }
+        return script;
+    }
+    getSessionInfo() {
+        return {
+            id: this.sessionId,
+            startedAt: this.sessionStartedAt,
+            messageCount: this.messageCount,
+        };
+    }
+    generateSessionId() {
+        return `session-${Date.now()}-${Math.random().toString(36).substr(2, 9)}`;
+    }
+    async loadConfig() {
+        try {
+            const content = await readFile(this.configPath, 'utf-8');
+            const loaded = yaml.load(content);
+            if (loaded?.hooks) {
+                this.config = {
+                    hooks: {
+                        ...DEFAULT_CONFIG.hooks,
+                        ...loaded.hooks,
+                    },
+                };
+            }
+        }
+        catch (error) {
+            // File doesn't exist or is invalid, use defaults
+            this.config = DEFAULT_CONFIG;
+        }
+    }
+}
+/**
+ * Singleton instance
+ */
+let hookRunnerInstance = null;
+export function getHookRunner() {
+    if (!hookRunnerInstance) {
+        hookRunnerInstance = new HookRunner();
+    }
+    return hookRunnerInstance;
+}
+export async function initializeHookRunner() {
+    const runner = getHookRunner();
+    await runner.initialize();
+    return runner;
+}
+export async function disposeHookRunner() {
+    if (hookRunnerInstance) {
+        await hookRunnerInstance.dispose();
+        hookRunnerInstance = null;
+    }
+}
+//# sourceMappingURL=hook-runner.js.map