@mxf-dev/core 1.0.0

package/dist/types/Agent.d.ts

@@ -0,0 +1,95 @@
+/**
+ * Copyright 2024 Brad Anderson
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *     http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ *
+ * @author Brad Anderson <BradA1878@pm.me>
+ * @repository https://github.com/mxf-dev/mxf
+ * @documentation https://mxf-dev.github.io/mxf/
+ */
+/**
+ * Agent.ts
+ *
+ * Defines types and interfaces related to agents in the MXF.
+ * This is a central type definition file for agent-related types that can be
+ * imported by both server and client components.
+ */
+/**
+ * Agent identifier type
+ * This is a string that uniquely identifies an agent in the system
+ */
+export type AgentId = string;
+/**
+ * Agent capability type
+ * Represents a specific capability that an agent can provide
+ */
+export type AgentCapability = string;
+/**
+ * Agent status enum
+ * Represents the possible states of an agent
+ */
+export declare enum AgentStatusEnum {
+    OFFLINE = "offline",// Agent is not connected
+    CONNECTING = "connecting",// Agent is in the process of connecting
+    CONNECTED = "connected",// Agent is connected but not ready
+    READY = "ready",// Agent is connected and ready for tasks
+    BUSY = "busy",// Agent is currently performing a task
+    ERROR = "error",// Agent encountered an error
+    DEGRADED = "degraded"
+}
+/**
+ * Agent information interface
+ * Contains basic information about an agent
+ */
+export interface AgentInfo {
+    agentId: AgentId;
+    name: string;
+    description?: string;
+    capabilities: AgentCapability[];
+    status: AgentStatusEnum;
+    lastActive?: number;
+    metadata?: Record<string, any>;
+}
+/**
+ * Agent registration data
+ * Data required to register an agent with the system
+ */
+export interface AgentRegistrationData {
+    agentId: AgentId;
+    name: string;
+    description?: string;
+    capabilities?: AgentCapability[];
+    metadata?: Record<string, any>;
+}
+/**
+ * Agent connection data
+ * Data passed when an agent connects to the system
+ */
+export interface AgentConnectionData {
+    agentId: AgentId;
+    socketId: string;
+    capabilities?: AgentCapability[];
+    channelId?: string;
+    metadata?: Record<string, any>;
+}
+/**
+ * Agent update data
+ * Data used to update an agent's status or metadata
+ */
+export interface AgentUpdateData {
+    agentId: AgentId;
+    status?: AgentStatusEnum;
+    capabilities?: AgentCapability[];
+    metadata?: Record<string, any>;
+}
+//# sourceMappingURL=Agent.d.ts.map

package/dist/types/Agent.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Agent.d.ts","sourceRoot":"","sources":["../../src/types/Agent.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;GAkBG;AAEH;;;;;;GAMG;AAEH;;;GAGG;AACH,MAAM,MAAM,OAAO,GAAG,MAAM,CAAC;AAE7B;;;GAGG;AACH,MAAM,MAAM,eAAe,GAAG,MAAM,CAAC;AAErC;;;GAGG;AACH,oBAAY,eAAe;IACvB,OAAO,YAAY,CAAU,yBAAyB;IACtD,UAAU,eAAe,CAAI,wCAAwC;IACrE,SAAS,cAAc,CAAM,mCAAmC;IAChE,KAAK,UAAU,CAAc,yCAAyC;IACtE,IAAI,SAAS,CAAgB,uCAAuC;IACpE,KAAK,UAAU,CAAc,6BAA6B;IAC1D,QAAQ,aAAa;CACxB;AAED;;;GAGG;AACH,MAAM,WAAW,SAAS;IACtB,OAAO,EAAE,OAAO,CAAC;IACjB,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,YAAY,EAAE,eAAe,EAAE,CAAC;IAChC,MAAM,EAAE,eAAe,CAAC;IACxB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;CAClC;AAED;;;GAGG;AACH,MAAM,WAAW,qBAAqB;IAClC,OAAO,EAAE,OAAO,CAAC;IACjB,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,YAAY,CAAC,EAAE,eAAe,EAAE,CAAC;IACjC,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;CAClC;AAED;;;GAGG;AACH,MAAM,WAAW,mBAAmB;IAChC,OAAO,EAAE,OAAO,CAAC;IACjB,QAAQ,EAAE,MAAM,CAAC;IACjB,YAAY,CAAC,EAAE,eAAe,EAAE,CAAC;IACjC,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;CAClC;AAED;;;GAGG;AACH,MAAM,WAAW,eAAe;IAC5B,OAAO,EAAE,OAAO,CAAC;IACjB,MAAM,CAAC,EAAE,eAAe,CAAC;IACzB,YAAY,CAAC,EAAE,eAAe,EAAE,CAAC;IACjC,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;CAClC"}

package/dist/types/Agent.js

@@ -0,0 +1,34 @@
+/**
+ * Copyright 2024 Brad Anderson
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *     http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ *
+ * @author Brad Anderson <BradA1878@pm.me>
+ * @repository https://github.com/mxf-dev/mxf
+ * @documentation https://mxf-dev.github.io/mxf/
+ */
+/**
+ * Agent status enum
+ * Represents the possible states of an agent
+ */
+export var AgentStatusEnum;
+(function (AgentStatusEnum) {
+    AgentStatusEnum["OFFLINE"] = "offline";
+    AgentStatusEnum["CONNECTING"] = "connecting";
+    AgentStatusEnum["CONNECTED"] = "connected";
+    AgentStatusEnum["READY"] = "ready";
+    AgentStatusEnum["BUSY"] = "busy";
+    AgentStatusEnum["ERROR"] = "error";
+    AgentStatusEnum["DEGRADED"] = "degraded"; // Agent is operating in degraded mode
+})(AgentStatusEnum || (AgentStatusEnum = {}));
+//# sourceMappingURL=Agent.js.map

package/dist/types/Agent.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"Agent.js","sourceRoot":"","sources":["../../src/types/Agent.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;GAkBG;AAsBH;;;GAGG;AACH,MAAM,CAAN,IAAY,eAQX;AARD,WAAY,eAAe;IACvB,sCAAmB,CAAA;IACnB,4CAAyB,CAAA;IACzB,0CAAuB,CAAA;IACvB,kCAAe,CAAA;IACf,gCAAa,CAAA;IACb,kCAAe,CAAA;IACf,wCAAqB,CAAA,CAAQ,sCAAsC;AACvE,CAAC,EARW,eAAe,KAAf,eAAe,QAQ1B"}

package/dist/types/AgentPerformanceTypes.d.ts

@@ -0,0 +1,314 @@
+/**
+ * Copyright 2024 Brad Anderson
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *     http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ *
+ * @author Brad Anderson <BradA1878@pm.me>
+ * @repository https://github.com/mxf-dev/mxf
+ * @documentation https://mxf-dev.github.io/mxf/
+ */
+/**
+ * Agent Performance Types for Enhanced Agent Intelligence
+ * Phase 2: Agent Performance Tracking and Optimization
+ */
+import { AgentId } from './Agent.js';
+import { ChannelId } from './ChannelContext.js';
+/**
+ * ORPAR phase timing metrics
+ */
+export interface OrparTimingMetrics {
+    /** Average time spent in observation phase (ms) */
+    averageObservationTime: number;
+    /** Average time spent in reasoning phase (ms) */
+    averageReasoningTime: number;
+    /** Average time spent in planning phase (ms) */
+    averagePlanningTime: number;
+    /** Average time spent in action phase (ms) */
+    averageActionTime: number;
+    /** Average time spent in reflection phase (ms) */
+    averageReflectionTime: number;
+    /** Total average ORPAR cycle time (ms) */
+    averageTotalCycleTime: number;
+    /** Standard deviations for timing consistency analysis */
+    timingConsistency: {
+        observationStdDev: number;
+        reasoningStdDev: number;
+        planningStdDev: number;
+        actionStdDev: number;
+        reflectionStdDev: number;
+    };
+    /** Fastest and slowest times for optimization insights */
+    timingBounds: {
+        fastest: {
+            observation: number;
+            reasoning: number;
+            planning: number;
+            action: number;
+            reflection: number;
+            total: number;
+        };
+        slowest: {
+            observation: number;
+            reasoning: number;
+            planning: number;
+            action: number;
+            reflection: number;
+            total: number;
+        };
+    };
+    /** Number of ORPAR cycles recorded */
+    cycleCount: number;
+    /** Last updated timestamp */
+    lastUpdated: number;
+}
+/**
+ * Tool usage patterns and effectiveness metrics
+ */
+export interface ToolUsageMetrics {
+    /** Most frequently used tools */
+    mostUsedTools: string[];
+    /** Tool success rates (toolName -> success rate 0.0-1.0) */
+    toolSuccessRates: Record<string, number>;
+    /** Tool execution times (toolName -> average execution time ms) */
+    toolExecutionTimes: Record<string, number>;
+    /** Preferred tool categories */
+    preferredToolCategories: string[];
+    /** Tool usage frequency (toolName -> usage count) */
+    toolUsageFrequency: Record<string, number>;
+    /** Tool error rates (toolName -> error rate 0.0-1.0) */
+    toolErrorRates: Record<string, number>;
+    /** Tools used together (tool combinations) */
+    toolCombinations: Array<{
+        tools: string[];
+        frequency: number;
+        successRate: number;
+        averageExecutionTime: number;
+    }>;
+    /** Tool efficiency scores (toolName -> efficiency 0.0-1.0) */
+    toolEfficiencyScores: Record<string, number>;
+    /** Tool recommendation scores (toolName -> recommendation score 0.0-1.0) */
+    toolRecommendationScores: Record<string, number>;
+    /** Total tools used */
+    totalToolsUsed: number;
+    /** Unique tools used */
+    uniqueToolsUsed: number;
+    /** Last tool usage timestamp */
+    lastToolUsage: number;
+}
+/**
+ * Collaboration metrics within channel context
+ */
+export interface CollaborationMetrics {
+    /** Messages sent in channel */
+    messagesSentInChannel: number;
+    /** Messages received in channel */
+    messagesReceivedInChannel: number;
+    /** Coordination requests made */
+    coordinationRequestsMade: number;
+    /** Coordination requests received */
+    coordinationRequestsReceived: number;
+    /** Successful collaborations */
+    successfulCollaborations: number;
+    /** Failed collaboration attempts */
+    failedCollaborations: number;
+    /** Collaboration success rate (0.0-1.0) */
+    collaborationSuccessRate: number;
+    /** Average response time to coordination requests (ms) */
+    averageResponseTime: number;
+    /** Agents collaborated with most frequently */
+    frequentCollaborators: Array<{
+        agentId: AgentId;
+        collaborationCount: number;
+        successRate: number;
+        averageResponseTime: number;
+    }>;
+    /** Collaboration patterns */
+    collaborationPatterns: Array<{
+        pattern: string;
+        frequency: number;
+        successRate: number;
+        participants: AgentId[];
+    }>;
+    /** Communication effectiveness score (0.0-1.0) */
+    communicationEffectiveness: number;
+    /** Leadership activities (times agent initiated coordination) */
+    leadershipActivities: number;
+    /** Support activities (times agent helped others) */
+    supportActivities: number;
+    /** Last collaboration timestamp */
+    lastCollaboration: number;
+}
+/**
+ * Comprehensive agent performance metrics
+ */
+export interface AgentPerformanceMetrics {
+    /** Agent identifier */
+    agentId: AgentId;
+    /** Channel identifier - metrics are channel-scoped */
+    channelId: ChannelId;
+    /** ORPAR cycle timing metrics */
+    orparTiming: OrparTimingMetrics;
+    /** Tool usage patterns and effectiveness */
+    toolUsage: ToolUsageMetrics;
+    /** Collaboration effectiveness within channel */
+    collaboration: CollaborationMetrics;
+    /** Overall performance scores */
+    overallPerformance: {
+        /** Overall efficiency score (0.0-1.0) */
+        efficiency: number;
+        /** Overall effectiveness score (0.0-1.0) */
+        effectiveness: number;
+        /** Learning progression score (0.0-1.0) */
+        learningProgression: number;
+        /** Consistency score (0.0-1.0) */
+        consistency: number;
+        /** Innovation score (0.0-1.0) - trying new approaches */
+        innovation: number;
+        /** Reliability score (0.0-1.0) */
+        reliability: number;
+    };
+    /** Performance trends over time */
+    trends: {
+        /** Performance trend direction */
+        direction: 'improving' | 'stable' | 'declining';
+        /** Trend confidence (0.0-1.0) */
+        confidence: number;
+        /** Areas showing improvement */
+        improvingAreas: string[];
+        /** Areas needing attention */
+        concernAreas: string[];
+        /** Recommended optimizations */
+        recommendations: string[];
+    };
+    /** Benchmarking against channel average */
+    benchmark: {
+        /** Performance relative to channel average */
+        relativePerformance: {
+            efficiency: number;
+            speed: number;
+            accuracy: number;
+            collaboration: number;
+        };
+        /** Ranking within channel (1 = best) */
+        channelRanking: {
+            overall: number;
+            efficiency: number;
+            collaboration: number;
+            toolUsage: number;
+        };
+        /** Percentile scores (0-100) */
+        percentiles: {
+            overall: number;
+            efficiency: number;
+            speed: number;
+            collaboration: number;
+        };
+    };
+    /** Metrics collection metadata */
+    metadata: {
+        /** Number of data points collected */
+        dataPoints: number;
+        /** Date range of collected data */
+        dateRange: {
+            start: number;
+            end: number;
+        };
+        /** Last metrics update */
+        lastUpdated: number;
+        /** Metrics version for schema evolution */
+        version: string;
+        /** Collection confidence (0.0-1.0) */
+        confidence: number;
+    };
+}
+/**
+ * Performance optimization suggestion
+ */
+export interface PerformanceOptimizationSuggestion {
+    /** Optimization category */
+    category: 'timing' | 'tool_usage' | 'collaboration' | 'workflow' | 'general';
+    /** Optimization priority */
+    priority: 'low' | 'medium' | 'high' | 'critical';
+    /** Suggestion title */
+    title: string;
+    /** Detailed suggestion description */
+    description: string;
+    /** Expected impact */
+    expectedImpact: {
+        /** Improvement areas */
+        areas: string[];
+        /** Expected percentage improvement */
+        estimatedImprovement: number;
+        /** Confidence in estimate (0.0-1.0) */
+        confidence: number;
+    };
+    /** Implementation steps */
+    implementationSteps: string[];
+    /** Tools or patterns to use */
+    recommendedTools: string[];
+    /** Success metrics to track */
+    successMetrics: string[];
+    /** Potential risks */
+    risks: string[];
+    /** Time estimate for implementation */
+    timeEstimate: string;
+}
+/**
+ * Agent performance analysis result
+ */
+export interface AgentPerformanceAnalysis {
+    /** Agent being analyzed */
+    agentId: AgentId;
+    /** Channel context */
+    channelId: ChannelId;
+    /** Analysis timestamp */
+    analysisTimestamp: number;
+    /** Performance summary */
+    summary: {
+        /** Overall assessment */
+        overall: 'excellent' | 'good' | 'average' | 'needs_improvement' | 'poor';
+        /** Strength areas */
+        strengths: string[];
+        /** Improvement areas */
+        weaknesses: string[];
+        /** Key insights */
+        insights: string[];
+    };
+    /** Optimization suggestions */
+    optimizations: PerformanceOptimizationSuggestion[];
+    /** Comparison with previous analysis */
+    progressSinceLastAnalysis: {
+        /** Time since last analysis */
+        timeSinceLastAnalysis: number;
+        /** Changes in key metrics */
+        metricChanges: Record<string, number>;
+        /** Progress assessment */
+        progressAssessment: 'significant_improvement' | 'improvement' | 'stable' | 'decline' | 'significant_decline';
+        /** Completed recommendations from last analysis */
+        completedRecommendations: string[];
+    };
+    /** Analysis confidence (0.0-1.0) */
+    confidence: number;
+    /** Analysis metadata */
+    metadata: {
+        /** Analysis method used */
+        analysisMethod: string;
+        /** Data quality assessment */
+        dataQuality: 'excellent' | 'good' | 'fair' | 'poor';
+        /** Sample size */
+        sampleSize: number;
+        /** Analysis duration */
+        analysisDuration: number;
+    };
+}
+//# sourceMappingURL=AgentPerformanceTypes.d.ts.map

package/dist/types/AgentPerformanceTypes.d.ts.map

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

package/dist/types/AgentPerformanceTypes.js

@@ -0,0 +1,21 @@
+/**
+ * Copyright 2024 Brad Anderson
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *     http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ *
+ * @author Brad Anderson <BradA1878@pm.me>
+ * @repository https://github.com/mxf-dev/mxf
+ * @documentation https://mxf-dev.github.io/mxf/
+ */
+export {};
+//# sourceMappingURL=AgentPerformanceTypes.js.map

package/dist/types/AgentPerformanceTypes.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"AgentPerformanceTypes.js","sourceRoot":"","sources":["../../src/types/AgentPerformanceTypes.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;GAkBG"}

package/dist/types/AgentRegistry.d.ts

@@ -0,0 +1,89 @@
+/**
+ * Copyright 2024 Brad Anderson
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *     http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ *
+ * @author Brad Anderson <BradA1878@pm.me>
+ * @repository https://github.com/mxf-dev/mxf
+ * @documentation https://mxf-dev.github.io/mxf/
+ */
+/**
+ * Enhanced agent registry entry with name resolution support
+ */
+export interface AgentRegistryEntry {
+    agentId: string;
+    commonName: string;
+    aliases: string[];
+    role: string;
+    capabilities: string[];
+    metadata?: {
+        department?: string;
+        clearanceLevel?: string;
+        timezone?: string;
+        [key: string]: any;
+    };
+}
+/**
+ * Name resolution result with confidence scoring
+ */
+export interface NameResolutionResult {
+    agentId: string;
+    confidence: number;
+    matchType: 'exact' | 'alias' | 'fuzzy' | 'partial';
+    resolvedFrom: string;
+}
+/**
+ * Agent name resolver with sophisticated matching capabilities
+ */
+export declare class AgentNameResolver {
+    private registry;
+    private nameIndex;
+    private commonResolutions;
+    constructor();
+    /**
+     * Register an agent with all their names and aliases
+     */
+    registerAgent(entry: AgentRegistryEntry): void;
+    /**
+     * Resolve a name to an agent ID with confidence scoring
+     */
+    resolveNameToId(name: string, channelContext?: string[]): NameResolutionResult | null;
+    /**
+     * Precompute common name resolutions for a channel
+     */
+    precomputeCommonResolutions(channelAgentIds: string[]): Map<string, string>;
+    /**
+     * Get all agents in the registry
+     */
+    getAllAgents(): AgentRegistryEntry[];
+    /**
+     * Get agent by ID
+     */
+    getAgent(agentId: string): AgentRegistryEntry | null;
+    /**
+     * Clear the registry
+     */
+    clear(): void;
+    private indexName;
+    private normalizeName;
+    private indexCommonVariations;
+    private fuzzyMatch;
+    private partialMatch;
+    private calculateSimilarity;
+    private levenshteinDistance;
+    /**
+     * Build formatted registry for SystemLLM context
+     */
+    formatForSystemLLM(): string;
+}
+//# sourceMappingURL=AgentRegistry.d.ts.map

package/dist/types/AgentRegistry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"AgentRegistry.d.ts","sourceRoot":"","sources":["../../src/types/AgentRegistry.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;GAkBG;AAaH;;GAEG;AACH,MAAM,WAAW,kBAAkB;IAC/B,OAAO,EAAE,MAAM,CAAC;IAChB,UAAU,EAAE,MAAM,CAAC;IACnB,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,IAAI,EAAE,MAAM,CAAC;IACb,YAAY,EAAE,MAAM,EAAE,CAAC;IACvB,QAAQ,CAAC,EAAE;QACP,UAAU,CAAC,EAAE,MAAM,CAAC;QACpB,cAAc,CAAC,EAAE,MAAM,CAAC;QACxB,QAAQ,CAAC,EAAE,MAAM,CAAC;QAClB,CAAC,GAAG,EAAE,MAAM,GAAG,GAAG,CAAC;KACtB,CAAC;CACL;AAED;;GAEG;AACH,MAAM,WAAW,oBAAoB;IACjC,OAAO,EAAE,MAAM,CAAC;IAChB,UAAU,EAAE,MAAM,CAAC;IACnB,SAAS,EAAE,OAAO,GAAG,OAAO,GAAG,OAAO,GAAG,SAAS,CAAC;IACnD,YAAY,EAAE,MAAM,CAAC;CACxB;AAED;;GAEG;AACH,qBAAa,iBAAiB;IAC1B,OAAO,CAAC,QAAQ,CAA8C;IAC9D,OAAO,CAAC,SAAS,CAAkC;IACnD,OAAO,CAAC,iBAAiB,CAAkC;;IAK3D;;OAEG;IACH,aAAa,CAAC,KAAK,EAAE,kBAAkB,GAAG,IAAI;IAkB9C;;OAEG;IACH,eAAe,CAAC,IAAI,EAAE,MAAM,EAAE,cAAc,CAAC,EAAE,MAAM,EAAE,GAAG,oBAAoB,GAAG,IAAI;IAyCrF;;OAEG;IACH,2BAA2B,CAAC,eAAe,EAAE,MAAM,EAAE,GAAG,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC;IAiC3E;;OAEG;IACH,YAAY,IAAI,kBAAkB,EAAE;IAIpC;;OAEG;IACH,QAAQ,CAAC,OAAO,EAAE,MAAM,GAAG,kBAAkB,GAAG,IAAI;IAIpD;;OAEG;IACH,KAAK,IAAI,IAAI;IAQb,OAAO,CAAC,SAAS;IAIjB,OAAO,CAAC,aAAa;IAOrB,OAAO,CAAC,qBAAqB;IA0B7B,OAAO,CAAC,UAAU;IAyBlB,OAAO,CAAC,YAAY;IAcpB,OAAO,CAAC,mBAAmB;IAS3B,OAAO,CAAC,mBAAmB;IA4B3B;;OAEG;IACH,kBAAkB,IAAI,MAAM;CAO/B"}