@defai.digital/ax-cli 3.6.1 → 3.7.1

package/dist/sdk/tool-registry.d.ts

@@ -0,0 +1,163 @@
+/**
+ * Shared Tool Registry - Unified tool discovery for AX <-> ax-cli integration
+ *
+ * Allows AutomatosX agents to register custom tools that become available to ax-cli,
+ * and vice versa. Enables seamless tool sharing across both systems.
+ */
+import type { LLMTool } from '../llm/client.js';
+/**
+ * Tool execution context
+ */
+export interface ToolExecutionContext {
+    /** Source system that's executing the tool */
+    source: 'ax-cli' | 'automatosx';
+    /** Agent ID executing the tool */
+    agentId?: string;
+    /** Additional context data */
+    metadata?: Record<string, unknown>;
+}
+/**
+ * Tool executor function
+ */
+export type ToolExecutor = (args: Record<string, unknown>, context: ToolExecutionContext) => Promise<{
+    success: boolean;
+    output?: string;
+    error?: string;
+    data?: unknown;
+}>;
+/**
+ * Registered tool with execution handler
+ */
+export interface RegisteredTool {
+    /** Tool definition (OpenAI format) */
+    definition: LLMTool;
+    /** Execution handler */
+    executor: ToolExecutor;
+    /** Source system that registered this tool */
+    registeredBy: 'ax-cli' | 'automatosx';
+    /** Registration timestamp */
+    registeredAt: number;
+    /** Optional tags for categorization */
+    tags?: string[];
+}
+/**
+ * Tool registration options
+ */
+export interface ToolRegistrationOptions {
+    /** Tags for categorization */
+    tags?: string[];
+    /** Whether to allow overwriting existing tool */
+    allowOverwrite?: boolean;
+}
+/**
+ * Shared Tool Registry - Centralized tool management
+ */
+export declare class ToolRegistry {
+    private static instance;
+    private tools;
+    private toolsBySource;
+    private constructor();
+    /**
+     * Get the singleton instance
+     */
+    static getInstance(): ToolRegistry;
+    /**
+     * Reset the singleton (for testing)
+     */
+    static reset(): void;
+    /**
+     * Register a tool
+     */
+    registerTool(source: 'ax-cli' | 'automatosx', definition: LLMTool, executor: ToolExecutor, options?: ToolRegistrationOptions): void;
+    /**
+     * Unregister a tool
+     */
+    unregisterTool(toolName: string): boolean;
+    /**
+     * Get a registered tool
+     */
+    getTool(toolName: string): RegisteredTool | undefined;
+    /**
+     * Check if a tool is registered
+     */
+    hasTool(toolName: string): boolean;
+    /**
+     * Get all tool definitions (OpenAI format)
+     */
+    getAllToolDefinitions(): LLMTool[];
+    /**
+     * Get tool definitions from specific source
+     */
+    getToolDefinitionsBySource(source: 'ax-cli' | 'automatosx'): LLMTool[];
+    /**
+     * Get tool definitions by tag
+     */
+    getToolDefinitionsByTag(tag: string): LLMTool[];
+    /**
+     * Execute a tool
+     */
+    executeTool(toolName: string, args: Record<string, unknown>, context: ToolExecutionContext): Promise<{
+        success: boolean;
+        output?: string;
+        error?: string;
+        data?: unknown;
+    }>;
+    /**
+     * Get all registered tool names
+     */
+    getToolNames(): string[];
+    /**
+     * Get tool names by source
+     */
+    getToolNamesBySource(source: 'ax-cli' | 'automatosx'): string[];
+    /**
+     * Clear all tools (optionally filter by source)
+     */
+    clear(source?: 'ax-cli' | 'automatosx'): void;
+    /**
+     * Get registry statistics
+     */
+    getStats(): {
+        total: number;
+        bySource: Record<string, number>;
+        byTag: Record<string, number>;
+    };
+    /**
+     * Export registry as JSON (excluding executors)
+     */
+    exportDefinitions(): {
+        tools: Array<{
+            name: string;
+            definition: LLMTool;
+            registeredBy: string;
+            registeredAt: number;
+            tags?: string[];
+        }>;
+        stats: {
+            total: number;
+            bySource: Record<string, number>;
+            byTag: Record<string, number>;
+        };
+    };
+}
+/**
+ * Get the global tool registry instance
+ */
+export declare function getToolRegistry(): ToolRegistry;
+/**
+ * Helper: Register multiple tools at once
+ */
+export declare function registerTools(source: 'ax-cli' | 'automatosx', tools: Array<{
+    definition: LLMTool;
+    executor: ToolExecutor;
+    options?: ToolRegistrationOptions;
+}>): void;
+/**
+ * Helper: Create a simple tool executor from a function
+ */
+export declare function createToolExecutor<T extends Record<string, unknown>>(handler: (args: T) => Promise<{
+    success: boolean;
+    output?: string;
+    error?: string;
+    data?: unknown;
+}>): ToolExecutor;

package/dist/sdk/tool-registry.js

@@ -0,0 +1,218 @@
+/**
+ * Shared Tool Registry - Unified tool discovery for AX <-> ax-cli integration
+ *
+ * Allows AutomatosX agents to register custom tools that become available to ax-cli,
+ * and vice versa. Enables seamless tool sharing across both systems.
+ */
+/**
+ * Shared Tool Registry - Centralized tool management
+ */
+export class ToolRegistry {
+    static instance = null;
+    tools = new Map();
+    toolsBySource = new Map(); // source -> tool names
+    constructor() {
+        // Initialize source maps
+        this.toolsBySource.set('ax-cli', new Set());
+        this.toolsBySource.set('automatosx', new Set());
+    }
+    /**
+     * Get the singleton instance
+     */
+    static getInstance() {
+        if (!ToolRegistry.instance) {
+            ToolRegistry.instance = new ToolRegistry();
+        }
+        return ToolRegistry.instance;
+    }
+    /**
+     * Reset the singleton (for testing)
+     */
+    static reset() {
+        if (ToolRegistry.instance) {
+            ToolRegistry.instance.clear();
+            ToolRegistry.instance = null;
+        }
+    }
+    /**
+     * Register a tool
+     */
+    registerTool(source, definition, executor, options = {}) {
+        const toolName = definition.function.name;
+        // Check if tool already exists
+        if (this.tools.has(toolName) && !options.allowOverwrite) {
+            throw new Error(`Tool '${toolName}' is already registered. Use allowOverwrite: true to replace it.`);
+        }
+        const registeredTool = {
+            definition,
+            executor,
+            registeredBy: source,
+            registeredAt: Date.now(),
+            tags: options.tags,
+        };
+        this.tools.set(toolName, registeredTool);
+        this.toolsBySource.get(source).add(toolName);
+    }
+    /**
+     * Unregister a tool
+     */
+    unregisterTool(toolName) {
+        const tool = this.tools.get(toolName);
+        if (!tool) {
+            return false;
+        }
+        this.tools.delete(toolName);
+        this.toolsBySource.get(tool.registeredBy).delete(toolName);
+        return true;
+    }
+    /**
+     * Get a registered tool
+     */
+    getTool(toolName) {
+        return this.tools.get(toolName);
+    }
+    /**
+     * Check if a tool is registered
+     */
+    hasTool(toolName) {
+        return this.tools.has(toolName);
+    }
+    /**
+     * Get all tool definitions (OpenAI format)
+     */
+    getAllToolDefinitions() {
+        return Array.from(this.tools.values()).map(tool => tool.definition);
+    }
+    /**
+     * Get tool definitions from specific source
+     */
+    getToolDefinitionsBySource(source) {
+        const toolNames = this.toolsBySource.get(source) || new Set();
+        return Array.from(toolNames)
+            .map(name => this.tools.get(name))
+            .filter((tool) => tool !== undefined)
+            .map(tool => tool.definition);
+    }
+    /**
+     * Get tool definitions by tag
+     */
+    getToolDefinitionsByTag(tag) {
+        return Array.from(this.tools.values())
+            .filter(tool => tool.tags?.includes(tag))
+            .map(tool => tool.definition);
+    }
+    /**
+     * Execute a tool
+     */
+    async executeTool(toolName, args, context) {
+        const tool = this.tools.get(toolName);
+        if (!tool) {
+            return {
+                success: false,
+                error: `Tool '${toolName}' not found in registry`,
+            };
+        }
+        try {
+            const result = await tool.executor(args, context);
+            return result;
+        }
+        catch (error) {
+            return {
+                success: false,
+                error: error instanceof Error ? error.message : 'Unknown execution error',
+            };
+        }
+    }
+    /**
+     * Get all registered tool names
+     */
+    getToolNames() {
+        return Array.from(this.tools.keys());
+    }
+    /**
+     * Get tool names by source
+     */
+    getToolNamesBySource(source) {
+        return Array.from(this.toolsBySource.get(source) || []);
+    }
+    /**
+     * Clear all tools (optionally filter by source)
+     */
+    clear(source) {
+        if (source) {
+            // Clear only tools from specific source
+            const toolNames = Array.from(this.toolsBySource.get(source) || []);
+            for (const name of toolNames) {
+                this.tools.delete(name);
+            }
+            this.toolsBySource.get(source).clear();
+        }
+        else {
+            // Clear all tools
+            this.tools.clear();
+            this.toolsBySource.get('ax-cli').clear();
+            this.toolsBySource.get('automatosx').clear();
+        }
+    }
+    /**
+     * Get registry statistics
+     */
+    getStats() {
+        const byTag = {};
+        for (const tool of this.tools.values()) {
+            if (tool.tags) {
+                for (const tag of tool.tags) {
+                    byTag[tag] = (byTag[tag] || 0) + 1;
+                }
+            }
+        }
+        return {
+            total: this.tools.size,
+            bySource: {
+                'ax-cli': this.toolsBySource.get('ax-cli').size,
+                'automatosx': this.toolsBySource.get('automatosx').size,
+            },
+            byTag,
+        };
+    }
+    /**
+     * Export registry as JSON (excluding executors)
+     */
+    exportDefinitions() {
+        const tools = Array.from(this.tools.entries()).map(([name, tool]) => ({
+            name,
+            definition: tool.definition,
+            registeredBy: tool.registeredBy,
+            registeredAt: tool.registeredAt,
+            tags: tool.tags,
+        }));
+        return {
+            tools,
+            stats: this.getStats(),
+        };
+    }
+}
+/**
+ * Get the global tool registry instance
+ */
+export function getToolRegistry() {
+    return ToolRegistry.getInstance();
+}
+/**
+ * Helper: Register multiple tools at once
+ */
+export function registerTools(source, tools) {
+    const registry = getToolRegistry();
+    for (const { definition, executor, options } of tools) {
+        registry.registerTool(source, definition, executor, options);
+    }
+}
+/**
+ * Helper: Create a simple tool executor from a function
+ */
+export function createToolExecutor(handler) {
+    return async (args, _context) => {
+        return handler(args);
+    };
+}
+//# sourceMappingURL=tool-registry.js.map

package/dist/sdk/tool-registry.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tool-registry.js","sourceRoot":"","sources":["../../src/sdk/tool-registry.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAuDH;;GAEG;AACH,MAAM,OAAO,YAAY;IACf,MAAM,CAAC,QAAQ,GAAwB,IAAI,CAAC;IAE5C,KAAK,GAAgC,IAAI,GAAG,EAAE,CAAC;IAC/C,aAAa,GAA6B,IAAI,GAAG,EAAE,CAAC,CAAC,uBAAuB;IAEpF;QACE,yBAAyB;QACzB,IAAI,CAAC,aAAa,CAAC,GAAG,CAAC,QAAQ,EAAE,IAAI,GAAG,EAAE,CAAC,CAAC;QAC5C,IAAI,CAAC,aAAa,CAAC,GAAG,CAAC,YAAY,EAAE,IAAI,GAAG,EAAE,CAAC,CAAC;IAClD,CAAC;IAED;;OAEG;IACH,MAAM,CAAC,WAAW;QAChB,IAAI,CAAC,YAAY,CAAC,QAAQ,EAAE,CAAC;YAC3B,YAAY,CAAC,QAAQ,GAAG,IAAI,YAAY,EAAE,CAAC;QAC7C,CAAC;QACD,OAAO,YAAY,CAAC,QAAQ,CAAC;IAC/B,CAAC;IAED;;OAEG;IACH,MAAM,CAAC,KAAK;QACV,IAAI,YAAY,CAAC,QAAQ,EAAE,CAAC;YAC1B,YAAY,CAAC,QAAQ,CAAC,KAAK,EAAE,CAAC;YAC9B,YAAY,CAAC,QAAQ,GAAG,IAAI,CAAC;QAC/B,CAAC;IACH,CAAC;IAED;;OAEG;IACH,YAAY,CACV,MAA+B,EAC/B,UAAmB,EACnB,QAAsB,EACtB,UAAmC,EAAE;QAErC,MAAM,QAAQ,GAAG,UAAU,CAAC,QAAQ,CAAC,IAAI,CAAC;QAE1C,+BAA+B;QAC/B,IAAI,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,QAAQ,CAAC,IAAI,CAAC,OAAO,CAAC,cAAc,EAAE,CAAC;YACxD,MAAM,IAAI,KAAK,CACb,SAAS,QAAQ,kEAAkE,CACpF,CAAC;QACJ,CAAC;QAED,MAAM,cAAc,GAAmB;YACrC,UAAU;YACV,QAAQ;YACR,YAAY,EAAE,MAAM;YACpB,YAAY,EAAE,IAAI,CAAC,GAAG,EAAE;YACxB,IAAI,EAAE,OAAO,CAAC,IAAI;SACnB,CAAC;QAEF,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,QAAQ,EAAE,cAAc,CAAC,CAAC;QACzC,IAAI,CAAC,aAAa,CAAC,GAAG,CAAC,MAAM,CAAE,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC;IAChD,CAAC;IAED;;OAEG;IACH,cAAc,CAAC,QAAgB;QAC7B,MAAM,IAAI,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC;QACtC,IAAI,CAAC,IAAI,EAAE,CAAC;YACV,OAAO,KAAK,CAAC;QACf,CAAC;QAED,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC;QAC5B,IAAI,CAAC,aAAa,CAAC,GAAG,CAAC,IAAI,CAAC,YAAY,CAAE,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC;QAC5D,OAAO,IAAI,CAAC;IACd,CAAC;IAED;;OAEG;IACH,OAAO,CAAC,QAAgB;QACtB,OAAO,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC;IAClC,CAAC;IAED;;OAEG;IACH,OAAO,CAAC,QAAgB;QACtB,OAAO,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC;IAClC,CAAC;IAED;;OAEG;IACH,qBAAqB;QACnB,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,MAAM,EAAE,CAAC,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;IACtE,CAAC;IAED;;OAEG;IACH,0BAA0B,CAAC,MAA+B;QACxD,MAAM,SAAS,GAAG,IAAI,CAAC,aAAa,CAAC,GAAG,CAAC,MAAM,CAAC,IAAI,IAAI,GAAG,EAAE,CAAC;QAC9D,OAAO,KAAK,CAAC,IAAI,CAAC,SAAS,CAAC;aACzB,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;aACjC,MAAM,CAAC,CAAC,IAAI,EAA0B,EAAE,CAAC,IAAI,KAAK,SAAS,CAAC;aAC5D,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;IAClC,CAAC;IAED;;OAEG;IACH,uBAAuB,CAAC,GAAW;QACjC,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,MAAM,EAAE,CAAC;aACnC,MAAM,CAAC,IAAI,CAAC,EAAE,CAAC,IAAI,CAAC,IAAI,EAAE,QAAQ,CAAC,GAAG,CAAC,CAAC;aACxC,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;IAClC,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,WAAW,CACf,QAAgB,EAChB,IAA6B,EAC7B,OAA6B;QAO7B,MAAM,IAAI,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC;QAEtC,IAAI,CAAC,IAAI,EAAE,CAAC;YACV,OAAO;gBACL,OAAO,EAAE,KAAK;gBACd,KAAK,EAAE,SAAS,QAAQ,yBAAyB;aAClD,CAAC;QACJ,CAAC;QAED,IAAI,CAAC;YACH,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,QAAQ,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC;YAClD,OAAO,MAAM,CAAC;QAChB,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,OAAO;gBACL,OAAO,EAAE,KAAK;gBACd,KAAK,EAAE,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,yBAAyB;aAC1E,CAAC;QACJ,CAAC;IACH,CAAC;IAED;;OAEG;IACH,YAAY;QACV,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,EAAE,CAAC,CAAC;IACvC,CAAC;IAED;;OAEG;IACH,oBAAoB,CAAC,MAA+B;QAClD,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,aAAa,CAAC,GAAG,CAAC,MAAM,CAAC,IAAI,EAAE,CAAC,CAAC;IAC1D,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,MAAgC;QACpC,IAAI,MAAM,EAAE,CAAC;YACX,wCAAwC;YACxC,MAAM,SAAS,GAAG,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,aAAa,CAAC,GAAG,CAAC,MAAM,CAAC,IAAI,EAAE,CAAC,CAAC;YACnE,KAAK,MAAM,IAAI,IAAI,SAAS,EAAE,CAAC;gBAC7B,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;YAC1B,CAAC;YACD,IAAI,CAAC,aAAa,CAAC,GAAG,CAAC,MAAM,CAAE,CAAC,KAAK,EAAE,CAAC;QAC1C,CAAC;aAAM,CAAC;YACN,kBAAkB;YAClB,IAAI,CAAC,KAAK,CAAC,KAAK,EAAE,CAAC;YACnB,IAAI,CAAC,aAAa,CAAC,GAAG,CAAC,QAAQ,CAAE,CAAC,KAAK,EAAE,CAAC;YAC1C,IAAI,CAAC,aAAa,CAAC,GAAG,CAAC,YAAY,CAAE,CAAC,KAAK,EAAE,CAAC;QAChD,CAAC;IACH,CAAC;IAED;;OAEG;IACH,QAAQ;QAKN,MAAM,KAAK,GAA2B,EAAE,CAAC;QAEzC,KAAK,MAAM,IAAI,IAAI,IAAI,CAAC,KAAK,CAAC,MAAM,EAAE,EAAE,CAAC;YACvC,IAAI,IAAI,CAAC,IAAI,EAAE,CAAC;gBACd,KAAK,MAAM,GAAG,IAAI,IAAI,CAAC,IAAI,EAAE,CAAC;oBAC5B,KAAK,CAAC,GAAG,CAAC,GAAG,CAAC,KAAK,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC,GAAG,CAAC,CAAC;gBACrC,CAAC;YACH,CAAC;QACH,CAAC;QAED,OAAO;YACL,KAAK,EAAE,IAAI,CAAC,KAAK,CAAC,IAAI;YACtB,QAAQ,EAAE;gBACR,QAAQ,EAAE,IAAI,CAAC,aAAa,CAAC,GAAG,CAAC,QAAQ,CAAE,CAAC,IAAI;gBAChD,YAAY,EAAE,IAAI,CAAC,aAAa,CAAC,GAAG,CAAC,YAAY,CAAE,CAAC,IAAI;aACzD;YACD,KAAK;SACN,CAAC;IACJ,CAAC;IAED;;OAEG;IACH,iBAAiB;QAcf,MAAM,KAAK,GAAG,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,OAAO,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,EAAE,IAAI,CAAC,EAAE,EAAE,CAAC,CAAC;YACpE,IAAI;YACJ,UAAU,EAAE,IAAI,CAAC,UAAU;YAC3B,YAAY,EAAE,IAAI,CAAC,YAAY;YAC/B,YAAY,EAAE,IAAI,CAAC,YAAY;YAC/B,IAAI,EAAE,IAAI,CAAC,IAAI;SAChB,CAAC,CAAC,CAAC;QAEJ,OAAO;YACL,KAAK;YACL,KAAK,EAAE,IAAI,CAAC,QAAQ,EAAE;SACvB,CAAC;IACJ,CAAC;;AAGH;;GAEG;AACH,MAAM,UAAU,eAAe;IAC7B,OAAO,YAAY,CAAC,WAAW,EAAE,CAAC;AACpC,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,aAAa,CAC3B,MAA+B,EAC/B,KAIE;IAEF,MAAM,QAAQ,GAAG,eAAe,EAAE,CAAC;IACnC,KAAK,MAAM,EAAE,UAAU,EAAE,QAAQ,EAAE,OAAO,EAAE,IAAI,KAAK,EAAE,CAAC;QACtD,QAAQ,CAAC,YAAY,CAAC,MAAM,EAAE,UAAU,EAAE,QAAQ,EAAE,OAAO,CAAC,CAAC;IAC/D,CAAC;AACH,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,kBAAkB,CAChC,OAAoG;IAEpG,OAAO,KAAK,EAAE,IAA6B,EAAE,QAA8B,EAAE,EAAE;QAC7E,OAAO,OAAO,CAAC,IAAS,CAAC,CAAC;IAC5B,CAAC,CAAC;AACJ,CAAC"}

package/dist/sdk/unified-logger.d.ts

@@ -0,0 +1,163 @@
+/**
+ * Unified Logger - Shared logging system for AX <-> ax-cli integration
+ *
+ * Provides centralized log aggregation across AutomatosX and ax-cli
+ * for easier debugging and monitoring.
+ */
+import { EventEmitter } from 'events';
+/**
+ * Log levels (ordered by severity)
+ */
+export declare enum LogLevel {
+    DEBUG = 0,
+    INFO = 1,
+    WARN = 2,
+    ERROR = 3
+}
+/**
+ * Log source identifiers
+ */
+export type LogSource = string;
+/**
+ * Log entry structure
+ */
+export interface LogEntry {
+    /** Timestamp (milliseconds since epoch) */
+    timestamp: number;
+    /** Log level */
+    level: LogLevel;
+    /** Source of the log (agent ID, system name, etc.) */
+    source: LogSource;
+    /** Log message */
+    message: string;
+    /** Optional structured data */
+    data?: Record<string, unknown>;
+    /** Optional error object */
+    error?: {
+        message: string;
+        stack?: string;
+        name?: string;
+    };
+}
+/**
+ * Log filter options
+ */
+export interface LogFilter {
+    /** Minimum log level to include */
+    minLevel?: LogLevel;
+    /** Filter by source (exact match or regex) */
+    source?: string | RegExp;
+    /** Filter by time range */
+    since?: number;
+    until?: number;
+}
+/**
+ * Unified Logger - Centralized logging for AX and ax-cli
+ */
+export declare class UnifiedLogger extends EventEmitter {
+    private static instance;
+    private logs;
+    private maxLogSize;
+    private minLevel;
+    private constructor();
+    /**
+     * Get the singleton instance
+     */
+    static getInstance(): UnifiedLogger;
+    /**
+     * Reset the singleton (for testing)
+     */
+    static reset(): void;
+    /**
+     * Set the minimum log level to record
+     */
+    setMinLevel(level: LogLevel): void;
+    /**
+     * Set maximum number of log entries to keep in memory
+     */
+    setMaxLogSize(size: number): void;
+    /**
+     * Log a message
+     */
+    log(level: LogLevel, source: LogSource, message: string, data?: Record<string, unknown>, error?: Error): void;
+    /**
+     * Log debug message
+     */
+    debug(source: LogSource, message: string, data?: Record<string, unknown>): void;
+    /**
+     * Log info message
+     */
+    info(source: LogSource, message: string, data?: Record<string, unknown>): void;
+    /**
+     * Log warning message
+     */
+    warn(source: LogSource, message: string, data?: Record<string, unknown>): void;
+    /**
+     * Log error message
+     */
+    error(source: LogSource, message: string, error?: Error, data?: Record<string, unknown>): void;
+    /**
+     * Trim logs to max size (keep most recent)
+     */
+    private trimLogs;
+    /**
+     * Get all logs (optionally filtered)
+     */
+    getLogs(filter?: LogFilter): LogEntry[];
+    /**
+     * Get recent logs (last N entries)
+     */
+    getRecentLogs(count: number, filter?: LogFilter): LogEntry[];
+    /**
+     * Subscribe to all log events
+     */
+    onLog(callback: (entry: LogEntry) => void): () => void;
+    /**
+     * Subscribe to specific log level
+     */
+    onLevel(level: LogLevel, callback: (entry: LogEntry) => void): () => void;
+    /**
+     * Clear all logs
+     */
+    clear(): void;
+    /**
+     * Get statistics about logs
+     */
+    getStats(): {
+        total: number;
+        byLevel: Record<string, number>;
+        bySources: Record<string, number>;
+        oldestTimestamp?: number;
+        newestTimestamp?: number;
+    };
+    /**
+     * Format a log entry as a string
+     */
+    format(entry: LogEntry, options?: {
+        includeTimestamp?: boolean;
+        includeSource?: boolean;
+    }): string;
+    /**
+     * Export logs as JSON
+     */
+    exportJSON(filter?: LogFilter): string;
+    /**
+     * Export logs as plain text
+     */
+    exportText(filter?: LogFilter, options?: {
+        includeTimestamp?: boolean;
+        includeSource?: boolean;
+    }): string;
+}
+/**
+ * Get the global unified logger instance
+ */
+export declare function getUnifiedLogger(): UnifiedLogger;
+/**
+ * Helper: Get log level from string
+ */
+export declare function parseLogLevel(level: string): LogLevel;
+/**
+ * Helper: Get log level name
+ */
+export declare function getLogLevelName(level: LogLevel): string;