@hazeljs/agent 0.2.0-alpha.1

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

@@ -0,0 +1,54 @@
+/**
+ * Tool Registry
+ * Central registry for all tools in the system
+ */
+import { ToolMetadata, ToolDefinition } from '../types/tool.types';
+import { LLMToolDefinition } from '../types/llm.types';
+/**
+ * Tool Registry - manages tool registration and lookup
+ */
+export declare class ToolRegistry {
+    private tools;
+    private agentTools;
+    /**
+     * Register tools from an agent instance
+     */
+    registerAgentTools(agentName: string, agentInstance: unknown): void;
+    /**
+     * Get tool metadata by name
+     */
+    getTool(toolName: string): ToolMetadata | undefined;
+    /**
+     * Get all tools for an agent
+     */
+    getAgentTools(agentName: string): ToolMetadata[];
+    /**
+     * Get all registered tools
+     */
+    getAllTools(): ToolMetadata[];
+    /**
+     * Check if a tool is registered
+     */
+    hasTool(toolName: string): boolean;
+    /**
+     * Get tool definitions for LLM (OpenAI function calling format)
+     */
+    getToolDefinitions(agentName: string): ToolDefinition[];
+    /**
+     * Unregister all tools for an agent
+     */
+    unregisterAgentTools(agentName: string): void;
+    /**
+     * Clear all tools
+     */
+    clear(): void;
+    /**
+     * Get tool count
+     */
+    get count(): number;
+    /**
+     * Convert tool definitions to LLM format (OpenAI function calling)
+     */
+    getToolDefinitionsForLLM(agentName: string): LLMToolDefinition[];
+}
+//# sourceMappingURL=tool.registry.d.ts.map

package/dist/registry/tool.registry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tool.registry.d.ts","sourceRoot":"","sources":["../../src/registry/tool.registry.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,YAAY,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AACnE,OAAO,EAAE,iBAAiB,EAAE,MAAM,oBAAoB,CAAC;AAGvD;;GAEG;AACH,qBAAa,YAAY;IACvB,OAAO,CAAC,KAAK,CAAwC;IACrD,OAAO,CAAC,UAAU,CAAuC;IAEzD;;OAEG;IACH,kBAAkB,CAAC,SAAS,EAAE,MAAM,EAAE,aAAa,EAAE,OAAO,GAAG,IAAI;IAuCnE;;OAEG;IACH,OAAO,CAAC,QAAQ,EAAE,MAAM,GAAG,YAAY,GAAG,SAAS;IAInD;;OAEG;IACH,aAAa,CAAC,SAAS,EAAE,MAAM,GAAG,YAAY,EAAE;IAWhD;;OAEG;IACH,WAAW,IAAI,YAAY,EAAE;IAI7B;;OAEG;IACH,OAAO,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO;IAIlC;;OAEG;IACH,kBAAkB,CAAC,SAAS,EAAE,MAAM,GAAG,cAAc,EAAE;IA2CvD;;OAEG;IACH,oBAAoB,CAAC,SAAS,EAAE,MAAM,GAAG,IAAI;IAU7C;;OAEG;IACH,KAAK,IAAI,IAAI;IAKb;;OAEG;IACH,IAAI,KAAK,IAAI,MAAM,CAElB;IAED;;OAEG;IACH,wBAAwB,CAAC,SAAS,EAAE,MAAM,GAAG,iBAAiB,EAAE;CAYjE"}

package/dist/registry/tool.registry.js

@@ -0,0 +1,153 @@
+"use strict";
+/**
+ * Tool Registry
+ * Central registry for all tools in the system
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ToolRegistry = void 0;
+const tool_decorator_1 = require("../decorators/tool.decorator");
+/**
+ * Tool Registry - manages tool registration and lookup
+ */
+class ToolRegistry {
+    constructor() {
+        this.tools = new Map();
+        this.agentTools = new Map();
+    }
+    /**
+     * Register tools from an agent instance
+     */
+    registerAgentTools(agentName, agentInstance) {
+        // eslint-disable-next-line @typescript-eslint/no-explicit-any
+        const agentClass = agentInstance.constructor;
+        const toolNames = (0, tool_decorator_1.getAgentTools)(agentClass);
+        if (toolNames.length === 0) {
+            return;
+        }
+        const agentToolSet = new Set();
+        for (const toolName of toolNames) {
+            const metadata = (0, tool_decorator_1.getToolMetadata)(agentInstance, toolName);
+            if (!metadata) {
+                // Tool metadata not found, skip
+                continue;
+            }
+            const fullToolName = `${agentName}.${toolName}`;
+            if (this.tools.has(fullToolName)) {
+                // Tool already registered, skip
+                continue;
+            }
+            // Update metadata to use the actual instance instead of prototype
+            const instanceMetadata = {
+                ...metadata,
+                target: agentInstance,
+            };
+            this.tools.set(fullToolName, instanceMetadata);
+            agentToolSet.add(fullToolName);
+        }
+        this.agentTools.set(agentName, agentToolSet);
+    }
+    /**
+     * Get tool metadata by name
+     */
+    getTool(toolName) {
+        return this.tools.get(toolName);
+    }
+    /**
+     * Get all tools for an agent
+     */
+    getAgentTools(agentName) {
+        const toolNames = this.agentTools.get(agentName);
+        if (!toolNames) {
+            return [];
+        }
+        return Array.from(toolNames)
+            .map((name) => this.tools.get(name))
+            .filter((tool) => tool !== undefined);
+    }
+    /**
+     * Get all registered tools
+     */
+    getAllTools() {
+        return Array.from(this.tools.values());
+    }
+    /**
+     * Check if a tool is registered
+     */
+    hasTool(toolName) {
+        return this.tools.has(toolName);
+    }
+    /**
+     * Get tool definitions for LLM (OpenAI function calling format)
+     */
+    getToolDefinitions(agentName) {
+        const tools = this.getAgentTools(agentName);
+        return tools.map((tool) => {
+            const properties = {};
+            const required = [];
+            if (tool.parameters) {
+                for (const param of tool.parameters) {
+                    properties[param.name] = {
+                        type: param.type,
+                        description: param.description,
+                    };
+                    if (param.enum) {
+                        properties[param.name].enum = param.enum;
+                    }
+                    if (param.required) {
+                        required.push(param.name);
+                    }
+                }
+            }
+            return {
+                name: tool.name,
+                description: tool.description,
+                parameters: {
+                    type: 'object',
+                    properties,
+                    required,
+                },
+            };
+        });
+    }
+    /**
+     * Unregister all tools for an agent
+     */
+    unregisterAgentTools(agentName) {
+        const toolNames = this.agentTools.get(agentName);
+        if (toolNames) {
+            for (const toolName of toolNames) {
+                this.tools.delete(toolName);
+            }
+            this.agentTools.delete(agentName);
+        }
+    }
+    /**
+     * Clear all tools
+     */
+    clear() {
+        this.tools.clear();
+        this.agentTools.clear();
+    }
+    /**
+     * Get tool count
+     */
+    get count() {
+        return this.tools.size;
+    }
+    /**
+     * Convert tool definitions to LLM format (OpenAI function calling)
+     */
+    getToolDefinitionsForLLM(agentName) {
+        const tools = this.getToolDefinitions(agentName);
+        return tools.map((tool) => ({
+            type: 'function',
+            function: {
+                name: tool.name,
+                description: tool.description,
+                parameters: tool.parameters,
+            },
+        }));
+    }
+}
+exports.ToolRegistry = ToolRegistry;
+//# sourceMappingURL=tool.registry.js.map

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

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

package/dist/runtime/agent.runtime.d.ts

@@ -0,0 +1,218 @@
+/**
+ * Agent Runtime
+ * Main runtime for managing agent lifecycle and execution
+ */
+import { IAgentStateManager } from '../state/agent-state.interface';
+import { AgentExecutionOptions, AgentExecutionResult, AgentContext, IGuardrailsService } from '../types/agent.types';
+import { AgentEventType } from '../types/event.types';
+import { LLMProvider } from '../types/llm.types';
+import { RAGService } from '../types/rag.types';
+import { MemoryManager } from '@hazeljs/rag';
+import { LogLevel } from '../utils/logger';
+import { HealthCheckResult } from '../utils/health-check';
+import { AgentGraph } from '../graph/agent-graph';
+import { SupervisorAgent } from '../supervisor/supervisor';
+import { SupervisorConfig } from '../graph/agent-graph.types';
+/**
+ * Agent Runtime Configuration
+ */
+export interface AgentRuntimeConfig {
+    stateManager?: IAgentStateManager;
+    memoryManager?: MemoryManager;
+    ragService?: RAGService;
+    llmProvider?: LLMProvider;
+    guardrailsService?: IGuardrailsService;
+    defaultMaxSteps?: number;
+    defaultTimeout?: number;
+    enableObservability?: boolean;
+    rateLimitPerMinute?: number;
+    enableMetrics?: boolean;
+    logLevel?: LogLevel;
+    enableRetry?: boolean;
+    enableCircuitBreaker?: boolean;
+}
+/**
+ * Agent Runtime
+ * Central runtime for agent execution and lifecycle management
+ */
+export declare class AgentRuntime {
+    private agentRegistry;
+    private toolRegistry;
+    private stateManager;
+    private contextBuilder;
+    private toolExecutor;
+    private agentExecutor;
+    private eventEmitter;
+    private config;
+    private rateLimiter?;
+    private metrics?;
+    private logger;
+    private retryHandler?;
+    private circuitBreaker?;
+    private healthChecker;
+    constructor(config?: AgentRuntimeConfig);
+    /**
+     * Register an agent class
+     */
+    registerAgent(agentClass: new (...args: unknown[]) => unknown): void;
+    /**
+     * Register an agent instance.
+     * Also patches any @Delegate-decorated methods so they call the target agent
+     * via this runtime rather than executing the original (stub) method body.
+     */
+    registerAgentInstance(agentName: string, instance: unknown): void;
+    /**
+     * Replace @Delegate stub methods on an agent instance with real runtime calls.
+     * Called automatically by registerAgentInstance().
+     */
+    private patchDelegateMethods;
+    /**
+     * Execute an agent
+     */
+    execute(agentName: string, input: string, options?: AgentExecutionOptions): Promise<AgentExecutionResult>;
+    /**
+     * Execute with retry and circuit breaker protection
+     */
+    private executeWithProtection;
+    /**
+     * Resume a paused execution
+     */
+    resume(executionId: string, input?: string): Promise<AgentExecutionResult>;
+    /**
+     * Get execution context
+     */
+    getContext(executionId: string): Promise<AgentContext | undefined>;
+    /**
+     * Subscribe to agent events
+     */
+    on(type: AgentEventType, handler: (event: unknown) => void): void;
+    /**
+     * Subscribe to all agent events
+     */
+    onAny(handler: (event: unknown) => void): void;
+    /**
+     * Unsubscribe from events
+     */
+    off(type: AgentEventType, handler: (event: unknown) => void): void;
+    /**
+     * Get all registered agents
+     */
+    getAgents(): string[];
+    /**
+     * Get agent metadata
+     */
+    getAgentMetadata(agentName: string): import('../types/agent.types').AgentMetadata | undefined;
+    /**
+     * Get health check status
+     */
+    healthCheck(): Promise<HealthCheckResult>;
+    /**
+     * Get metrics
+     */
+    getMetrics(): import('../utils/metrics').AgentMetrics | undefined;
+    /**
+     * Get metrics summary
+     */
+    getMetricsSummary(): string;
+    /**
+     * Reset metrics
+     */
+    resetMetrics(): void;
+    /**
+     * Get rate limiter status
+     */
+    getRateLimiterStatus(): {
+        enabled: boolean;
+        availableTokens?: number;
+    };
+    /**
+     * Get circuit breaker status
+     */
+    getCircuitBreakerStatus(): {
+        enabled: boolean;
+        state?: string;
+        failureCount?: number;
+        successCount?: number;
+    };
+    /**
+     * Reset circuit breaker
+     */
+    resetCircuitBreaker(): void;
+    /**
+     * Get agent tools
+     */
+    getAgentTools(agentName: string): import('../types/tool.types').ToolMetadata[];
+    /**
+     * Approve a tool execution
+     */
+    approveToolExecution(requestId: string, approvedBy: string): void;
+    /**
+     * Reject a tool execution
+     */
+    rejectToolExecution(requestId: string): void;
+    /**
+     * Get pending tool approvals
+     */
+    getPendingApprovals(): import('../types/tool.types').ToolApprovalRequest[];
+    /**
+     * Create a new `AgentGraph` builder for this runtime.
+     *
+     * @param graphId A unique identifier for the graph (used in logs/events).
+     *
+     * @example
+     * ```ts
+     * const graph = runtime.createGraph('research-pipeline')
+     *   .addNode('researcher', { type: 'agent', agentName: 'ResearchAgent' })
+     *   .addNode('writer',     { type: 'agent', agentName: 'WriterAgent' })
+     *   .addEdge('researcher', 'writer')
+     *   .addEdge('writer', '__end__')
+     *   .setEntryPoint('researcher')
+     *   .compile();
+     *
+     * const result = await graph.execute('Write an article about LLMs');
+     * ```
+     */
+    createGraph(graphId: string): AgentGraph;
+    /**
+     * Create a `SupervisorAgent` that orchestrates a team of worker agents.
+     *
+     * Requires an LLM provider to be configured on the runtime.
+     *
+     * @example
+     * ```ts
+     * const supervisor = runtime.createSupervisor({
+     *   name: 'project-manager',
+     *   workers: ['ResearchAgent', 'CoderAgent', 'WriterAgent'],
+     *   maxRounds: 6,
+     * });
+     *
+     * const result = await supervisor.run('Build a REST API for a todo app');
+     * console.log(result.response);
+     * ```
+     */
+    createSupervisor(config: SupervisorConfig): SupervisorAgent;
+    /**
+     * Dynamically spawn a new agent execution and return its result.
+     * Useful inside @Tool methods when one agent needs to call another.
+     *
+     * @example
+     * ```ts
+     * @Tool({ description: 'Research and summarize a topic' })
+     * async researchAndSummarize(topic: string) {
+     *   const research = await this.runtime.spawn('ResearchAgent', topic);
+     *   const summary  = await this.runtime.spawn('SummaryAgent', research.response ?? '');
+     *   return summary.response;
+     * }
+     * ```
+     */
+    spawn(agentName: string, input: string, options?: AgentExecutionOptions): Promise<AgentExecutionResult>;
+    /**
+     * Shutdown the runtime
+     */
+    shutdown(): Promise<void>;
+    /**
+     * Generate a session ID
+     */
+    private generateSessionId;
+}
+//# sourceMappingURL=agent.runtime.d.ts.map

package/dist/runtime/agent.runtime.d.ts.map

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

package/dist/runtime/agent.runtime.extensions.d.ts

@@ -0,0 +1,49 @@
+/**
+ * Agent Runtime Extensions
+ * Additional methods for health checks, metrics, and monitoring
+ */
+import { AgentRuntime } from './agent.runtime';
+import { HealthCheckResult } from '../utils/health-check';
+import { AgentMetrics } from '../utils/metrics';
+/**
+ * Extended methods for AgentRuntime
+ */
+export declare class AgentRuntimeExtensions {
+    /**
+     * Get health check status
+     */
+    static getHealthCheck(runtime: AgentRuntime): Promise<HealthCheckResult>;
+    /**
+     * Get metrics summary
+     */
+    static getMetrics(runtime: AgentRuntime): AgentMetrics | null;
+    /**
+     * Get metrics summary as string
+     */
+    static getMetricsSummary(runtime: AgentRuntime): string;
+    /**
+     * Reset metrics
+     */
+    static resetMetrics(runtime: AgentRuntime): void;
+    /**
+     * Get rate limiter status
+     */
+    static getRateLimiterStatus(runtime: AgentRuntime): {
+        enabled: boolean;
+        availableTokens?: number;
+    };
+    /**
+     * Get circuit breaker status
+     */
+    static getCircuitBreakerStatus(runtime: AgentRuntime): {
+        enabled: boolean;
+        state?: string;
+        failureCount?: number;
+        successCount?: number;
+    };
+    /**
+     * Reset circuit breaker
+     */
+    static resetCircuitBreaker(runtime: AgentRuntime): void;
+}
+//# sourceMappingURL=agent.runtime.extensions.d.ts.map

package/dist/runtime/agent.runtime.extensions.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"agent.runtime.extensions.d.ts","sourceRoot":"","sources":["../../src/runtime/agent.runtime.extensions.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAC;AAC/C,OAAO,EAAE,iBAAiB,EAAE,MAAM,uBAAuB,CAAC;AAC1D,OAAO,EAAE,YAAY,EAAE,MAAM,kBAAkB,CAAC;AAEhD;;GAEG;AACH,qBAAa,sBAAsB;IACjC;;OAEG;WACU,cAAc,CAAC,OAAO,EAAE,YAAY,GAAG,OAAO,CAAC,iBAAiB,CAAC;IAmB9E;;OAEG;IACH,MAAM,CAAC,UAAU,CAAC,OAAO,EAAE,YAAY,GAAG,YAAY,GAAG,IAAI;IAM7D;;OAEG;IACH,MAAM,CAAC,iBAAiB,CAAC,OAAO,EAAE,YAAY,GAAG,MAAM;IAMvD;;OAEG;IACH,MAAM,CAAC,YAAY,CAAC,OAAO,EAAE,YAAY,GAAG,IAAI;IAQhD;;OAEG;IACH,MAAM,CAAC,oBAAoB,CAAC,OAAO,EAAE,YAAY,GAAG;QAClD,OAAO,EAAE,OAAO,CAAC;QACjB,eAAe,CAAC,EAAE,MAAM,CAAC;KAC1B;IASD;;OAEG;IACH,MAAM,CAAC,uBAAuB,CAAC,OAAO,EAAE,YAAY,GAAG;QACrD,OAAO,EAAE,OAAO,CAAC;QACjB,KAAK,CAAC,EAAE,MAAM,CAAC;QACf,YAAY,CAAC,EAAE,MAAM,CAAC;QACtB,YAAY,CAAC,EAAE,MAAM,CAAC;KACvB;IAWD;;OAEG;IACH,MAAM,CAAC,mBAAmB,CAAC,OAAO,EAAE,YAAY,GAAG,IAAI;CAOxD"}

package/dist/runtime/agent.runtime.extensions.js

@@ -0,0 +1,93 @@
+"use strict";
+/**
+ * Agent Runtime Extensions
+ * Additional methods for health checks, metrics, and monitoring
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.AgentRuntimeExtensions = void 0;
+/**
+ * Extended methods for AgentRuntime
+ */
+class AgentRuntimeExtensions {
+    /**
+     * Get health check status
+     */
+    static async getHealthCheck(runtime) {
+        // eslint-disable-next-line @typescript-eslint/no-explicit-any
+        const healthChecker = runtime.healthChecker;
+        // eslint-disable-next-line @typescript-eslint/no-explicit-any
+        const metrics = runtime.metrics;
+        // eslint-disable-next-line @typescript-eslint/no-explicit-any
+        const config = runtime.config;
+        const metricsData = metrics
+            ? {
+                totalExecutions: metrics.getMetrics().executions.total,
+                successRate: metrics.getMetrics().executions.successRate,
+                averageLatency: metrics.getMetrics().performance.averageDuration,
+            }
+            : undefined;
+        return healthChecker.check(config.llmProvider, config.ragService, metricsData);
+    }
+    /**
+     * Get metrics summary
+     */
+    static getMetrics(runtime) {
+        // eslint-disable-next-line @typescript-eslint/no-explicit-any
+        const metrics = runtime.metrics;
+        return metrics ? metrics.getMetrics() : null;
+    }
+    /**
+     * Get metrics summary as string
+     */
+    static getMetricsSummary(runtime) {
+        // eslint-disable-next-line @typescript-eslint/no-explicit-any
+        const metrics = runtime.metrics;
+        return metrics ? metrics.getSummary() : 'Metrics not enabled';
+    }
+    /**
+     * Reset metrics
+     */
+    static resetMetrics(runtime) {
+        // eslint-disable-next-line @typescript-eslint/no-explicit-any
+        const metrics = runtime.metrics;
+        if (metrics) {
+            metrics.reset();
+        }
+    }
+    /**
+     * Get rate limiter status
+     */
+    static getRateLimiterStatus(runtime) {
+        // eslint-disable-next-line @typescript-eslint/no-explicit-any
+        const rateLimiter = runtime.rateLimiter;
+        return {
+            enabled: !!rateLimiter,
+            availableTokens: rateLimiter?.getAvailableTokens(),
+        };
+    }
+    /**
+     * Get circuit breaker status
+     */
+    static getCircuitBreakerStatus(runtime) {
+        // eslint-disable-next-line @typescript-eslint/no-explicit-any
+        const circuitBreaker = runtime.circuitBreaker;
+        return {
+            enabled: !!circuitBreaker,
+            state: circuitBreaker?.getState(),
+            failureCount: circuitBreaker?.getFailureCount(),
+            successCount: circuitBreaker?.getSuccessCount(),
+        };
+    }
+    /**
+     * Reset circuit breaker
+     */
+    static resetCircuitBreaker(runtime) {
+        // eslint-disable-next-line @typescript-eslint/no-explicit-any
+        const circuitBreaker = runtime.circuitBreaker;
+        if (circuitBreaker) {
+            circuitBreaker.reset();
+        }
+    }
+}
+exports.AgentRuntimeExtensions = AgentRuntimeExtensions;
+//# sourceMappingURL=agent.runtime.extensions.js.map

package/dist/runtime/agent.runtime.extensions.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"agent.runtime.extensions.js","sourceRoot":"","sources":["../../src/runtime/agent.runtime.extensions.ts"],"names":[],"mappings":";AAAA;;;GAGG;;;AAMH;;GAEG;AACH,MAAa,sBAAsB;IACjC;;OAEG;IACH,MAAM,CAAC,KAAK,CAAC,cAAc,CAAC,OAAqB;QAC/C,8DAA8D;QAC9D,MAAM,aAAa,GAAI,OAAe,CAAC,aAAa,CAAC;QACrD,8DAA8D;QAC9D,MAAM,OAAO,GAAI,OAAe,CAAC,OAAO,CAAC;QACzC,8DAA8D;QAC9D,MAAM,MAAM,GAAI,OAAe,CAAC,MAAM,CAAC;QAEvC,MAAM,WAAW,GAAG,OAAO;YACzB,CAAC,CAAC;gBACE,eAAe,EAAE,OAAO,CAAC,UAAU,EAAE,CAAC,UAAU,CAAC,KAAK;gBACtD,WAAW,EAAE,OAAO,CAAC,UAAU,EAAE,CAAC,UAAU,CAAC,WAAW;gBACxD,cAAc,EAAE,OAAO,CAAC,UAAU,EAAE,CAAC,WAAW,CAAC,eAAe;aACjE;YACH,CAAC,CAAC,SAAS,CAAC;QAEd,OAAO,aAAa,CAAC,KAAK,CAAC,MAAM,CAAC,WAAW,EAAE,MAAM,CAAC,UAAU,EAAE,WAAW,CAAC,CAAC;IACjF,CAAC;IAED;;OAEG;IACH,MAAM,CAAC,UAAU,CAAC,OAAqB;QACrC,8DAA8D;QAC9D,MAAM,OAAO,GAAI,OAAe,CAAC,OAAO,CAAC;QACzC,OAAO,OAAO,CAAC,CAAC,CAAC,OAAO,CAAC,UAAU,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC;IAC/C,CAAC;IAED;;OAEG;IACH,MAAM,CAAC,iBAAiB,CAAC,OAAqB;QAC5C,8DAA8D;QAC9D,MAAM,OAAO,GAAI,OAAe,CAAC,OAAO,CAAC;QACzC,OAAO,OAAO,CAAC,CAAC,CAAC,OAAO,CAAC,UAAU,EAAE,CAAC,CAAC,CAAC,qBAAqB,CAAC;IAChE,CAAC;IAED;;OAEG;IACH,MAAM,CAAC,YAAY,CAAC,OAAqB;QACvC,8DAA8D;QAC9D,MAAM,OAAO,GAAI,OAAe,CAAC,OAAO,CAAC;QACzC,IAAI,OAAO,EAAE,CAAC;YACZ,OAAO,CAAC,KAAK,EAAE,CAAC;QAClB,CAAC;IACH,CAAC;IAED;;OAEG;IACH,MAAM,CAAC,oBAAoB,CAAC,OAAqB;QAI/C,8DAA8D;QAC9D,MAAM,WAAW,GAAI,OAAe,CAAC,WAAW,CAAC;QACjD,OAAO;YACL,OAAO,EAAE,CAAC,CAAC,WAAW;YACtB,eAAe,EAAE,WAAW,EAAE,kBAAkB,EAAE;SACnD,CAAC;IACJ,CAAC;IAED;;OAEG;IACH,MAAM,CAAC,uBAAuB,CAAC,OAAqB;QAMlD,8DAA8D;QAC9D,MAAM,cAAc,GAAI,OAAe,CAAC,cAAc,CAAC;QACvD,OAAO;YACL,OAAO,EAAE,CAAC,CAAC,cAAc;YACzB,KAAK,EAAE,cAAc,EAAE,QAAQ,EAAE;YACjC,YAAY,EAAE,cAAc,EAAE,eAAe,EAAE;YAC/C,YAAY,EAAE,cAAc,EAAE,eAAe,EAAE;SAChD,CAAC;IACJ,CAAC;IAED;;OAEG;IACH,MAAM,CAAC,mBAAmB,CAAC,OAAqB;QAC9C,8DAA8D;QAC9D,MAAM,cAAc,GAAI,OAAe,CAAC,cAAc,CAAC;QACvD,IAAI,cAAc,EAAE,CAAC;YACnB,cAAc,CAAC,KAAK,EAAE,CAAC;QACzB,CAAC;IACH,CAAC;CACF;AAhGD,wDAgGC"}