@defai.digital/ax-cli 3.6.2 → 3.7.2

package/dist/sdk/testing.js

@@ -0,0 +1,291 @@
+/**
+ * Testing utilities for AX CLI SDK
+ *
+ * This module provides mock implementations and test helpers to make
+ * it easy to test code that uses the AX CLI SDK.
+ *
+ * @packageDocumentation
+ */
+import { EventEmitter } from 'events';
+/**
+ * Mock agent for testing
+ *
+ * Implements the same interface as LLMAgent but with predictable,
+ * controllable behavior for testing.
+ *
+ * @example
+ * ```typescript
+ * import { MockAgent } from '@defai.digital/ax-cli/sdk/testing';
+ *
+ * test('my integration', async () => {
+ *   const agent = new MockAgent({
+ *     responses: ['First response', 'Second response']
+ *   });
+ *
+ *   const result = await agent.processUserMessage('Hello');
+ *   expect(result[0].content).toBe('First response');
+ * });
+ * ```
+ */
+export class MockAgent extends EventEmitter {
+    responses;
+    currentResponseIndex = 0;
+    history = [];
+    disposed = false;
+    /**
+     * Create a new mock agent
+     *
+     * @param options - Configuration for mock behavior
+     */
+    constructor(options = {}) {
+        super();
+        this.responses = options.responses || ['Mock response'];
+    }
+    /**
+     * Process a user message (mock implementation)
+     *
+     * Returns the next predefined response and adds it to history.
+     * Cycles through responses if called more times than responses available.
+     *
+     * @param message - User message (stored in history)
+     * @returns Mock chat history
+     */
+    async processUserMessage(message) {
+        this.checkDisposed();
+        // Add user message to history
+        const userEntry = {
+            type: 'user',
+            content: message,
+            timestamp: new Date(),
+        };
+        this.history.push(userEntry);
+        // Get next response (cycle through)
+        const response = this.responses[this.currentResponseIndex % this.responses.length];
+        this.currentResponseIndex++;
+        // Add assistant response to history
+        const assistantEntry = {
+            type: 'assistant',
+            content: response,
+            timestamp: new Date(),
+        };
+        this.history.push(assistantEntry);
+        // Emit stream event for compatibility
+        this.emit('stream', {
+            type: 'content',
+            content: response,
+        });
+        this.emit('stream', {
+            type: 'done',
+        });
+        return [...this.history];
+    }
+    /**
+     * Process user message with streaming (mock implementation)
+     *
+     * Yields mock stream chunks for the response.
+     */
+    async *processUserMessageStream(message) {
+        this.checkDisposed();
+        // Add user message to history
+        const userEntry = {
+            type: 'user',
+            content: message,
+            timestamp: new Date(),
+        };
+        this.history.push(userEntry);
+        // Get next response
+        const response = this.responses[this.currentResponseIndex % this.responses.length];
+        this.currentResponseIndex++;
+        // Stream the response character by character (for realistic testing)
+        const words = response.split(' ');
+        for (const word of words) {
+            yield {
+                type: 'content',
+                content: word + ' ',
+            };
+        }
+        // Add assistant response to history
+        const assistantEntry = {
+            type: 'assistant',
+            content: response,
+            timestamp: new Date(),
+        };
+        this.history.push(assistantEntry);
+        yield {
+            type: 'done',
+        };
+    }
+    /**
+     * Get chat history (mock implementation)
+     */
+    getChatHistory() {
+        this.checkDisposed();
+        return [...this.history];
+    }
+    /**
+     * Execute bash command (mock implementation)
+     *
+     * Always returns success with predefined output.
+     */
+    async executeBashCommand(command) {
+        this.checkDisposed();
+        return {
+            success: true,
+            output: `Mock output for command: ${command}`,
+        };
+    }
+    /**
+     * Get current directory (mock implementation)
+     */
+    getCurrentDirectory() {
+        this.checkDisposed();
+        return '/mock/directory';
+    }
+    /**
+     * Create checkpoint (mock implementation)
+     */
+    async createCheckpoint(_description) {
+        this.checkDisposed();
+        return `mock-checkpoint-${Date.now()}`;
+    }
+    /**
+     * Rewind conversation (mock implementation)
+     */
+    async rewindConversation(_checkpointId) {
+        this.checkDisposed();
+        this.history = [];
+        return { success: true };
+    }
+    /**
+     * Check if bash is executing (mock implementation)
+     */
+    isBashExecuting() {
+        this.checkDisposed();
+        return false;
+    }
+    /**
+     * Dispose of mock agent
+     */
+    async dispose() {
+        if (this.disposed)
+            return;
+        this.disposed = true;
+        this.removeAllListeners();
+        this.history = [];
+        this.responses = [];
+    }
+    /**
+     * Reset mock agent state
+     *
+     * Clears history and resets response index.
+     * Useful for reusing the same mock across multiple tests.
+     */
+    reset() {
+        this.history = [];
+        this.currentResponseIndex = 0;
+    }
+    /**
+     * Set new responses
+     *
+     * @param responses - New responses to use
+     */
+    setResponses(responses) {
+        this.responses = responses;
+        this.currentResponseIndex = 0;
+    }
+    /**
+     * Get number of messages processed
+     */
+    getMessageCount() {
+        return this.history.filter(entry => entry.type === 'user').length;
+    }
+    checkDisposed() {
+        if (this.disposed) {
+            throw new Error('MockAgent has been disposed and cannot be used');
+        }
+    }
+}
+/**
+ * Create a mock agent with predefined responses
+ *
+ * Convenience function for creating mock agents.
+ *
+ * @param responses - Predefined responses (optional)
+ * @returns Mock agent instance
+ *
+ * @example
+ * ```typescript
+ * import { createMockAgent } from '@defai.digital/ax-cli/sdk/testing';
+ *
+ * const agent = createMockAgent(['Hello!', 'How can I help?']);
+ * const result = await agent.processUserMessage('Hi');
+ * expect(result[0].content).toBe('Hello!');
+ * ```
+ */
+export function createMockAgent(responses) {
+    return new MockAgent({ responses });
+}
+/**
+ * Mock settings manager for testing
+ *
+ * Allows tests to control what settings are returned without
+ * needing actual config files.
+ *
+ * @example
+ * ```typescript
+ * import { MockSettingsManager } from '@defai.digital/ax-cli/sdk/testing';
+ *
+ * const settings = new MockSettingsManager({
+ *   apiKey: 'test-key',
+ *   baseURL: 'https://test.api.com',
+ *   model: 'glm-4.6'
+ * });
+ * ```
+ */
+export class MockSettingsManager {
+    settings;
+    constructor(settings = {}) {
+        this.settings = settings;
+    }
+    loadUserSettings() {
+        // No-op for mock
+    }
+    loadProjectSettings() {
+        // No-op for mock
+    }
+    getApiKey() {
+        return this.settings.apiKey;
+    }
+    getBaseURL() {
+        return this.settings.baseURL;
+    }
+    getCurrentModel() {
+        return this.settings.model || 'glm-4.6';
+    }
+    updateUserSetting(key, value) {
+        this.settings[key] = value;
+    }
+    saveUserSettings() {
+        // No-op for mock
+    }
+}
+/**
+ * Create a mock settings manager
+ *
+ * @param settings - Settings to return
+ * @returns Mock settings manager
+ *
+ * @example
+ * ```typescript
+ * import { createMockSettings } from '@defai.digital/ax-cli/sdk/testing';
+ *
+ * const settings = createMockSettings({
+ *   apiKey: 'test-key',
+ *   model: 'glm-4.6'
+ * });
+ * ```
+ */
+export function createMockSettings(settings) {
+    return new MockSettingsManager(settings);
+}
+//# sourceMappingURL=testing.js.map

package/dist/sdk/testing.js.map

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

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"}