@weavelogic/knowledge-graph-agent 0.6.0 → 0.7.1

package/dist/agents/documenter-agent.d.ts

@@ -0,0 +1,298 @@
+/**
+ * Documenter Agent
+ *
+ * Specialized agent for documentation generation, including API docs,
+ * user guides, architecture documentation, and changelog generation.
+ * Extends BaseAgent with documentation-specific capabilities.
+ *
+ * @module agents/documenter-agent
+ */
+import { BaseAgent } from './base-agent.js';
+import { AgentType, type AgentTask, type AgentResult, type AgentConfig } from './types.js';
+/**
+ * Documenter agent configuration
+ */
+export interface DocumenterAgentConfig extends AgentConfig {
+    type: AgentType.DOCUMENTER;
+    /** Default documentation format */
+    defaultFormat?: 'markdown' | 'openapi' | 'typedoc';
+    /** Template directory for documentation */
+    templateDir?: string;
+    /** Git repository path for changelog generation */
+    gitPath?: string;
+}
+/**
+ * Documentation output format
+ */
+export type DocumentationFormat = 'markdown' | 'openapi' | 'typedoc';
+/**
+ * Documentation result
+ */
+export interface DocumentationResult {
+    /** Output format */
+    format: DocumentationFormat;
+    /** Generated content */
+    content: string;
+    /** Generated files */
+    files: Array<{
+        path: string;
+        content: string;
+    }>;
+    /** Coverage metrics */
+    coverage: {
+        /** Number of documented items */
+        documented: number;
+        /** Total items */
+        total: number;
+        /** Coverage percentage */
+        percentage: number;
+    };
+}
+/**
+ * User guide result
+ */
+export interface UserGuideResult {
+    /** Guide title */
+    title: string;
+    /** Guide sections */
+    sections: Array<{
+        heading: string;
+        content: string;
+        examples?: string[];
+    }>;
+    /** Table of contents */
+    toc: string;
+}
+/**
+ * System information for architecture documentation
+ */
+export interface SystemInfo {
+    /** System name */
+    name: string;
+    /** System description */
+    description?: string;
+    /** Source directories to analyze */
+    sourceDirs: string[];
+    /** Entry points */
+    entryPoints?: string[];
+    /** Architecture pattern (e.g., 'layered', 'microservices', 'monolith') */
+    pattern?: string;
+}
+/**
+ * Architecture documentation result
+ */
+export interface ArchitectureDocResult {
+    /** Architecture overview */
+    overview: string;
+    /** Generated diagrams */
+    diagrams: Array<{
+        type: 'component' | 'sequence' | 'class' | 'deployment';
+        content: string;
+    }>;
+    /** Component descriptions */
+    components: Array<{
+        name: string;
+        description: string;
+        dependencies: string[];
+        apis: string[];
+    }>;
+}
+/**
+ * Changelog result
+ */
+export interface ChangelogResult {
+    /** Version string */
+    version: string;
+    /** Release date */
+    date: string;
+    /** Changelog sections */
+    sections: {
+        added: string[];
+        changed: string[];
+        deprecated: string[];
+        removed: string[];
+        fixed: string[];
+        security: string[];
+    };
+    /** Rendered markdown */
+    markdown: string;
+}
+/**
+ * Parsed JSDoc/TSDoc comment
+ */
+export interface ParsedDocComment {
+    /** Description */
+    description: string;
+    /** Parameter docs */
+    params: Array<{
+        name: string;
+        type?: string;
+        description: string;
+    }>;
+    /** Return documentation */
+    returns?: {
+        type?: string;
+        description: string;
+    };
+    /** Example code */
+    examples: string[];
+    /** Tags (deprecated, throws, etc.) */
+    tags: Record<string, string>;
+}
+/**
+ * Documented item from source
+ */
+export interface DocumentedItem {
+    /** Item name */
+    name: string;
+    /** Item kind */
+    kind: 'class' | 'function' | 'interface' | 'type' | 'variable' | 'method' | 'property';
+    /** File path */
+    file: string;
+    /** Line number */
+    line: number;
+    /** Documentation comment */
+    doc?: ParsedDocComment;
+    /** Whether exported */
+    exported: boolean;
+    /** Signature */
+    signature?: string;
+}
+/**
+ * Git commit for changelog
+ */
+export interface GitCommit {
+    /** Commit hash */
+    hash: string;
+    /** Commit message */
+    message: string;
+    /** Commit author */
+    author: string;
+    /** Commit date */
+    date: Date;
+    /** Conventional commit type */
+    type?: string;
+    /** Conventional commit scope */
+    scope?: string;
+    /** Whether breaking change */
+    breaking?: boolean;
+}
+/**
+ * Documenter task type
+ */
+export type DocumenterTaskType = 'api_docs' | 'user_guide' | 'architecture' | 'changelog' | 'format';
+/**
+ * Documenter Agent
+ *
+ * Capabilities:
+ * - API documentation generation (markdown, OpenAPI, TypeDoc)
+ * - User guide creation with examples
+ * - Architecture documentation with diagrams
+ * - Changelog generation from git commits
+ * - Documentation formatting and linting
+ *
+ * @example
+ * ```typescript
+ * const documenter = new DocumenterAgent({
+ *   name: 'documenter-agent',
+ *   type: AgentType.DOCUMENTER,
+ * });
+ *
+ * const result = await documenter.execute({
+ *   id: 'task-1',
+ *   description: 'Generate API documentation',
+ *   priority: TaskPriority.MEDIUM,
+ *   input: {
+ *     parameters: { taskType: 'api_docs' },
+ *     data: {
+ *       files: ['src/index.ts'],
+ *       format: 'markdown'
+ *     }
+ *   },
+ *   createdAt: new Date()
+ * });
+ * ```
+ */
+export declare class DocumenterAgent extends BaseAgent {
+    /** Agent type identifier */
+    readonly type = AgentType.DOCUMENTER;
+    /** Agent capabilities */
+    readonly capabilities: string[];
+    /** File patterns for TypeScript/JavaScript */
+    private readonly codePatterns;
+    /** Conventional commit types */
+    private readonly commitTypes;
+    constructor(config: Partial<DocumenterAgentConfig> & {
+        name: string;
+    });
+    /**
+     * Execute documenter task
+     */
+    protected executeTask(task: AgentTask): Promise<AgentResult>;
+    /**
+     * Generate API documentation from source files
+     */
+    generateApiDocs(files: string[], format?: DocumentationFormat): Promise<DocumentationResult>;
+    /**
+     * Create user guide for a feature
+     */
+    createUserGuide(feature: string, codebase: string[]): Promise<UserGuideResult>;
+    /**
+     * Document system architecture
+     */
+    documentArchitecture(system: SystemInfo): Promise<ArchitectureDocResult>;
+    /**
+     * Generate changelog from git commits
+     */
+    generateChangelog(fromTag: string, toTag: string): Promise<ChangelogResult>;
+    /**
+     * Format documentation content
+     */
+    formatDocumentation(content: string, style?: string): Promise<string>;
+    private handleApiDocsTask;
+    private handleUserGuideTask;
+    private handleArchitectureTask;
+    private handleChangelogTask;
+    private handleFormatTask;
+    private parseSourceFile;
+    private findDocComment;
+    private parseDocComment;
+    private extractSignature;
+    private generateMarkdownDocs;
+    private generateOpenApiDocs;
+    private generateTypeDocConfig;
+    private findRelevantItems;
+    private extractExamples;
+    private extractTestBody;
+    private generateIntroduction;
+    private generateGettingStarted;
+    private generateUsageGuide;
+    private generateApiReference;
+    private generateTableOfContents;
+    private renderUserGuide;
+    private analyzeDirectory;
+    private extractExports;
+    private extractImports;
+    private inferDescription;
+    private generateArchitectureOverview;
+    private describePattern;
+    private generateComponentDiagram;
+    private generateClassDiagram;
+    private generateDeploymentDiagram;
+    private renderArchitectureDoc;
+    private getCommitsBetweenTags;
+    private parseConventionalCommit;
+    private generateChangelogMarkdown;
+    private formatDefaultMarkdown;
+    private formatGitHubMarkdown;
+    private formatDocusaurusMarkdown;
+    private formatObsidianMarkdown;
+    private fixMarkdownIssues;
+    private ensureConsistentHeaders;
+    private formatCodeBlocks;
+    private toKebabCase;
+    private toMermaidId;
+    private formatFeatureTitle;
+    private formatDiagramTitle;
+}
+//# sourceMappingURL=documenter-agent.d.ts.map

package/dist/agents/documenter-agent.d.ts.map

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

package/dist/agents/index.d.ts

@@ -6,7 +6,7 @@
  *
  * @module agents
  */
-export { AgentType, AgentStatus, TaskPriority, MessageType, type AgentConfig, type ResearcherAgentConfig, type CoderAgentConfig, type TesterAgentConfig, type AnalystAgentConfig, type ArchitectAgentConfig, type SpecializedAgentConfig, type TaskInput, type AgentTask, type AgentResult, type AgentError, type ExecutionMetrics, type ResultArtifact, type AgentMessage, type TaskRequestMessage, type TaskResponseMessage, type StatusMessage, type ErrorMessage, type CoordinationMessage, type AgentMessageUnion, type AgentState, type AgentFactory, type AgentInstance, type AgentCapability, type AgentHealthCheck, createMessageId, createTaskId, createAgentId, } from './types.js';
+export { AgentType, AgentStatus, TaskPriority, MessageType, type AgentConfig, type ResearcherAgentConfig, type CoderAgentConfig, type TesterAgentConfig, type AnalystAgentConfig, type ArchitectAgentConfig, type PlannerAgentConfig, type SpecializedAgentConfig, type TaskInput, type AgentTask, type AgentResult, type AgentError, type ExecutionMetrics, type ResultArtifact, type AgentMessage, type TaskRequestMessage, type TaskResponseMessage, type StatusMessage, type ErrorMessage, type CoordinationMessage, type AgentMessageUnion, type AgentState, type AgentFactory, type AgentInstance, type AgentCapability, type AgentHealthCheck, createMessageId, createTaskId, createAgentId, } from './types.js';
 export { AgentRegistry, getRegistry, createRegistry, setDefaultRegistry, registerDefaultAgents, type RegistryOptions, type SpawnOptions, } from './registry.js';
 export { BaseAgent, createTask, isAgentResult, isAgentError, } from './base-agent.js';
 export { RulesEngine, createRulesEngine, createRule, createConditionalRule, createFileChangeLogRule, createGraphUpdateNotificationRule, createAgentCompletionRule, type RuleTrigger, type RulePriority, type RuleExecutionStatus, type RuleContext, type RuleCondition, type RuleAction, type AgentRule, type RuleExecutionLog, type RuleStatistics, type EngineStatistics, type RulesEngineConfig, } from './rules-engine.js';
@@ -15,4 +15,14 @@ export { CoderAgent } from './coder-agent.js';
 export { TesterAgent } from './tester-agent.js';
 export { AnalystAgent } from './analyst-agent.js';
 export { ArchitectAgent } from './architect-agent.js';
+export { OptimizerAgent } from './optimizer-agent.js';
+export { ReviewerAgent } from './reviewer-agent.js';
+export type { OptimizerAgentConfig, ImpactLevel, OptimizationImprovement, OptimizationResult, MemoryAllocation, MemoryProfile, MemoryOptimizationSuggestion, MemoryOptimizationResult, QueryOptimizationResult, CachingLayer, CachingStrategy, BenchmarkMeasurement, BenchmarkResult, SystemArchitecture, OptimizerTaskType, } from './optimizer-agent.js';
+export { CoordinatorAgent, createCoordinatorAgent, createWorkflow, createWorkflowStep, type TaskAssignmentStatus, type DistributionStrategy, type WorkflowStep, type WorkflowDefinition, type TaskAssignment, type StepResult, type WorkflowResult, type ProgressReport, type AgentRequirement, type DelegateTask, type CoordinatorAgentConfig, type CoordinatorTaskType, } from './coordinator-agent.js';
+export type { ReviewerAgentConfig, ReviewContext, ReviewSeverity, ReviewCategory, ReviewIssue, CodeReviewResult, SecurityVulnerability, SecurityAuditResult, PerformanceIssue, PerformanceAnalysisResult, BestPracticesResult, ReviewAction, } from './reviewer-agent.js';
+export { DocumenterAgent } from './documenter-agent.js';
+export type { DocumenterAgentConfig, DocumentationFormat, DocumentationResult, UserGuideResult, SystemInfo, ArchitectureDocResult, ChangelogResult, ParsedDocComment, DocumentedItem, GitCommit, DocumenterTaskType, } from './documenter-agent.js';
+export { PlannerAgent } from './planner-agent.js';
+export type { PlannerPriority, DependencyType, RiskProbability, RiskImpact, EffortEstimate, Subtask, TaskDecomposition, DependencyNode, DependencyEdge, DependencyGraph, AgentInfo, ResourceAssignment, ResourceAllocation, Milestone, Phase, TimelineEstimate, Risk, RiskAssessment, ExecutionPlan, PlannerTaskType, } from './planner-agent.js';
+export { applyTrajectoryMixin, TrajectoryWrapper, createTrajectoryWrapper, hasTrajectoryCapability, type TrajectoryCapable, type TrajectoryMixinConfig, } from './mixins/index.js';
 //# sourceMappingURL=index.d.ts.map

package/dist/agents/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/agents/index.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAGH,OAAO,EAEL,SAAS,EACT,WAAW,EACX,YAAY,EACZ,WAAW,EAGX,KAAK,WAAW,EAChB,KAAK,qBAAqB,EAC1B,KAAK,gBAAgB,EACrB,KAAK,iBAAiB,EACtB,KAAK,kBAAkB,EACvB,KAAK,oBAAoB,EACzB,KAAK,sBAAsB,EAG3B,KAAK,SAAS,EACd,KAAK,SAAS,EAGd,KAAK,WAAW,EAChB,KAAK,UAAU,EACf,KAAK,gBAAgB,EACrB,KAAK,cAAc,EAGnB,KAAK,YAAY,EACjB,KAAK,kBAAkB,EACvB,KAAK,mBAAmB,EACxB,KAAK,aAAa,EAClB,KAAK,YAAY,EACjB,KAAK,mBAAmB,EACxB,KAAK,iBAAiB,EAGtB,KAAK,UAAU,EAGf,KAAK,YAAY,EACjB,KAAK,aAAa,EAGlB,KAAK,eAAe,EACpB,KAAK,gBAAgB,EAGrB,eAAe,EACf,YAAY,EACZ,aAAa,GACd,MAAM,YAAY,CAAC;AAGpB,OAAO,EACL,aAAa,EACb,WAAW,EACX,cAAc,EACd,kBAAkB,EAClB,qBAAqB,EACrB,KAAK,eAAe,EACpB,KAAK,YAAY,GAClB,MAAM,eAAe,CAAC;AAGvB,OAAO,EACL,SAAS,EACT,UAAU,EACV,aAAa,EACb,YAAY,GACb,MAAM,iBAAiB,CAAC;AAGzB,OAAO,EACL,WAAW,EACX,iBAAiB,EACjB,UAAU,EACV,qBAAqB,EACrB,uBAAuB,EACvB,iCAAiC,EACjC,yBAAyB,EACzB,KAAK,WAAW,EAChB,KAAK,YAAY,EACjB,KAAK,mBAAmB,EACxB,KAAK,WAAW,EAChB,KAAK,aAAa,EAClB,KAAK,UAAU,EACf,KAAK,SAAS,EACd,KAAK,gBAAgB,EACrB,KAAK,cAAc,EACnB,KAAK,gBAAgB,EACrB,KAAK,iBAAiB,GACvB,MAAM,mBAAmB,CAAC;AAG3B,OAAO,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AACxD,OAAO,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAC9C,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAChD,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAClD,OAAO,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/agents/index.ts"],"names":[],"mappings":"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"}

package/dist/agents/index.js

@@ -7,6 +7,10 @@ import { CoderAgent } from "./coder-agent.js";
 import { TesterAgent } from "./tester-agent.js";
 import { AnalystAgent } from "./analyst-agent.js";
 import { ArchitectAgent } from "./architect-agent.js";
+import "fs/promises";
+import "path";
+import "../utils/logger.js";
+import "events";
 export {
   AgentRegistry,
   AgentStatus,

package/dist/agents/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sources":[],"sourcesContent":[],"names":[],"mappings":";;;;;;;;;"}
+{"version":3,"file":"index.js","sources":[],"sourcesContent":[],"names":[],"mappings":";;;;;;;;;;;;;"}

package/dist/agents/mixins/index.d.ts

@@ -0,0 +1,9 @@
+/**
+ * Agent Mixins Index
+ *
+ * Exports all agent mixins for extending agent capabilities.
+ *
+ * @module agents/mixins
+ */
+export { applyTrajectoryMixin, TrajectoryWrapper, createTrajectoryWrapper, hasTrajectoryCapability, type TrajectoryCapable, type TrajectoryMixinConfig, } from './trajectory-mixin.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/agents/mixins/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/agents/mixins/index.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EACL,oBAAoB,EACpB,iBAAiB,EACjB,uBAAuB,EACvB,uBAAuB,EACvB,KAAK,iBAAiB,EACtB,KAAK,qBAAqB,GAC3B,MAAM,uBAAuB,CAAC"}

package/dist/agents/mixins/trajectory-mixin.d.ts

@@ -0,0 +1,112 @@
+/**
+ * Trajectory Mixin for Agents
+ *
+ * Provides trajectory tracking capabilities to agents via mixin pattern.
+ * This allows any agent to track task execution trajectories for learning
+ * and verdict judgment purposes.
+ *
+ * @module agents/mixins/trajectory-mixin
+ */
+import { TrajectoryTracker } from '../../learning/services/trajectory-tracker.js';
+import type { TrajectoryStep } from '../../integrations/agentic-flow/adapters/reasoning-bank-adapter.js';
+/**
+ * Constructor type for mixin pattern
+ */
+type Constructor<T = object> = new (...args: any[]) => T;
+/**
+ * Interface for trajectory mixin capabilities
+ */
+export interface TrajectoryCapable {
+    /** The trajectory tracker instance */
+    trajectoryTracker: TrajectoryTracker | null;
+    /** Current active trajectory ID */
+    currentTrajectoryId: string | null;
+    /** Set the trajectory tracker */
+    setTrajectoryTracker(tracker: TrajectoryTracker): void;
+    /** Start tracking a task trajectory */
+    startTaskTrajectory(taskId: string, metadata?: Record<string, unknown>): void;
+    /** Record a step in the current trajectory */
+    recordTrajectoryStep(action: string, observation: string, confidence?: number, metadata?: Record<string, unknown>): void;
+    /** Complete the current trajectory */
+    completeTaskTrajectory(outcome: 'success' | 'failure' | 'partial', metadata?: Record<string, unknown>): Promise<string | null>;
+    /** Abort the current trajectory */
+    abortTaskTrajectory(reason: string): void;
+    /** Check if trajectory tracking is active */
+    isTrackingTrajectory(): boolean;
+    /** Get current trajectory progress */
+    getTrajectoryProgress(): {
+        stepCount: number;
+        duration: number;
+        lastStep?: TrajectoryStep;
+    } | null;
+}
+/**
+ * Configuration for trajectory mixin
+ */
+export interface TrajectoryMixinConfig {
+    /** Auto-start trajectory on task execution */
+    autoStartOnTask: boolean;
+    /** Auto-complete trajectory after task */
+    autoCompleteOnTask: boolean;
+    /** Default metadata to include with trajectories */
+    defaultMetadata?: Record<string, unknown>;
+}
+/**
+ * Apply trajectory tracking capabilities to an agent class
+ *
+ * @example
+ * ```typescript
+ * class ResearchAgent extends applyTrajectoryMixin(BaseAgent) {
+ *   async executeTask(task: AgentTask): Promise<AgentResult> {
+ *     // Trajectory tracking is automatic if autoStartOnTask is true
+ *     // Or manually record steps:
+ *     this.recordTrajectoryStep('research', 'Found 10 relevant sources');
+ *     this.recordTrajectoryStep('analyze', 'Synthesized findings');
+ *
+ *     return this.formatOutput(results);
+ *   }
+ * }
+ * ```
+ *
+ * @param Base - The base class to extend
+ * @param config - Optional mixin configuration
+ * @returns A class with trajectory tracking capabilities
+ */
+export declare function applyTrajectoryMixin<TBase extends Constructor>(Base: TBase, config?: Partial<TrajectoryMixinConfig>): TBase & Constructor<TrajectoryCapable>;
+/**
+ * Standalone trajectory wrapper for objects that cannot use mixins
+ *
+ * @example
+ * ```typescript
+ * const wrapper = new TrajectoryWrapper(tracker);
+ * wrapper.startTrajectory('task-123', { agentType: 'coder' });
+ * wrapper.recordStep('analyze', 'Found 5 issues');
+ * await wrapper.complete('success');
+ * ```
+ */
+export declare class TrajectoryWrapper implements TrajectoryCapable {
+    trajectoryTracker: TrajectoryTracker | null;
+    currentTrajectoryId: string | null;
+    constructor(tracker?: TrajectoryTracker | null);
+    setTrajectoryTracker(tracker: TrajectoryTracker): void;
+    startTaskTrajectory(taskId: string, metadata?: Record<string, unknown>): void;
+    recordTrajectoryStep(action: string, observation: string, confidence?: number, metadata?: Record<string, unknown>): void;
+    completeTaskTrajectory(outcome: 'success' | 'failure' | 'partial', metadata?: Record<string, unknown>): Promise<string | null>;
+    abortTaskTrajectory(reason: string): void;
+    isTrackingTrajectory(): boolean;
+    getTrajectoryProgress(): {
+        stepCount: number;
+        duration: number;
+        lastStep?: TrajectoryStep;
+    } | null;
+}
+/**
+ * Create a trajectory wrapper instance
+ */
+export declare function createTrajectoryWrapper(tracker?: TrajectoryTracker | null): TrajectoryWrapper;
+/**
+ * Check if an object has trajectory capabilities
+ */
+export declare function hasTrajectoryCapability(obj: unknown): obj is TrajectoryCapable;
+export {};
+//# sourceMappingURL=trajectory-mixin.d.ts.map

package/dist/agents/mixins/trajectory-mixin.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"trajectory-mixin.d.ts","sourceRoot":"","sources":["../../../src/agents/mixins/trajectory-mixin.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,EACL,iBAAiB,EAElB,MAAM,+CAA+C,CAAC;AACvD,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,oEAAoE,CAAC;AAMzG;;GAEG;AAEH,KAAK,WAAW,CAAC,CAAC,GAAG,MAAM,IAAI,KAAK,GAAG,IAAI,EAAE,GAAG,EAAE,KAAK,CAAC,CAAC;AAEzD;;GAEG;AACH,MAAM,WAAW,iBAAiB;IAChC,sCAAsC;IACtC,iBAAiB,EAAE,iBAAiB,GAAG,IAAI,CAAC;IAE5C,mCAAmC;IACnC,mBAAmB,EAAE,MAAM,GAAG,IAAI,CAAC;IAEnC,iCAAiC;IACjC,oBAAoB,CAAC,OAAO,EAAE,iBAAiB,GAAG,IAAI,CAAC;IAEvD,uCAAuC;IACvC,mBAAmB,CAAC,MAAM,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,CAAC;IAE9E,8CAA8C;IAC9C,oBAAoB,CAClB,MAAM,EAAE,MAAM,EACd,WAAW,EAAE,MAAM,EACnB,UAAU,CAAC,EAAE,MAAM,EACnB,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GACjC,IAAI,CAAC;IAER,sCAAsC;IACtC,sBAAsB,CACpB,OAAO,EAAE,SAAS,GAAG,SAAS,GAAG,SAAS,EAC1C,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GACjC,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAAC;IAE1B,mCAAmC;IACnC,mBAAmB,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;IAE1C,6CAA6C;IAC7C,oBAAoB,IAAI,OAAO,CAAC;IAEhC,sCAAsC;IACtC,qBAAqB,IAAI;QACvB,SAAS,EAAE,MAAM,CAAC;QAClB,QAAQ,EAAE,MAAM,CAAC;QACjB,QAAQ,CAAC,EAAE,cAAc,CAAC;KAC3B,GAAG,IAAI,CAAC;CACV;AAED;;GAEG;AACH,MAAM,WAAW,qBAAqB;IACpC,8CAA8C;IAC9C,eAAe,EAAE,OAAO,CAAC;IAEzB,0CAA0C;IAC1C,kBAAkB,EAAE,OAAO,CAAC;IAE5B,oDAAoD;IACpD,eAAe,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CAC3C;AAWD;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,wBAAgB,oBAAoB,CAAC,KAAK,SAAS,WAAW,EAC5D,IAAI,EAAE,KAAK,EACX,MAAM,GAAE,OAAO,CAAC,qBAAqB,CAAM,GAC1C,KAAK,GAAG,WAAW,CAAC,iBAAiB,CAAC,CA0JxC;AAMD;;;;;;;;;;GAUG;AACH,qBAAa,iBAAkB,YAAW,iBAAiB;IACzD,iBAAiB,EAAE,iBAAiB,GAAG,IAAI,CAAC;IAC5C,mBAAmB,EAAE,MAAM,GAAG,IAAI,CAAQ;gBAE9B,OAAO,GAAE,iBAAiB,GAAG,IAAW;IAIpD,oBAAoB,CAAC,OAAO,EAAE,iBAAiB,GAAG,IAAI;IAItD,mBAAmB,CACjB,MAAM,EAAE,MAAM,EACd,QAAQ,GAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAM,GACrC,IAAI;IAWP,oBAAoB,CAClB,MAAM,EAAE,MAAM,EACd,WAAW,EAAE,MAAM,EACnB,UAAU,CAAC,EAAE,MAAM,EACnB,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GACjC,IAAI;IAaD,sBAAsB,CAC1B,OAAO,EAAE,SAAS,GAAG,SAAS,GAAG,SAAS,EAC1C,QAAQ,GAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAM,GACrC,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC;IAezB,mBAAmB,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI;IASzC,oBAAoB,IAAI,OAAO;IAI/B,qBAAqB,IAAI;QACvB,SAAS,EAAE,MAAM,CAAC;QAClB,QAAQ,EAAE,MAAM,CAAC;QACjB,QAAQ,CAAC,EAAE,cAAc,CAAC;KAC3B,GAAG,IAAI;CAOT;AAMD;;GAEG;AACH,wBAAgB,uBAAuB,CACrC,OAAO,CAAC,EAAE,iBAAiB,GAAG,IAAI,GACjC,iBAAiB,CAEnB;AAED;;GAEG;AACH,wBAAgB,uBAAuB,CAAC,GAAG,EAAE,OAAO,GAAG,GAAG,IAAI,iBAAiB,CAU9E"}