claudecto 0.1.0

package/dist/services/agents.js

@@ -0,0 +1,405 @@
+/**
+ * Agents service - reads and manages custom agents from ~/.claude/agents/
+ * Custom agents are subagents that Claude can delegate tasks to.
+ */
+import path from 'node:path';
+import { parse as parseYaml } from 'yaml';
+export class AgentsService {
+    claudeDir;
+    constructor(claudeDir) {
+        this.claudeDir = claudeDir;
+    }
+    /**
+     * Get the agents directory path
+     */
+    get agentsDir() {
+        return path.join(this.claudeDir.root, 'agents');
+    }
+    /**
+     * List all agents (user-level from ~/.claude/agents/)
+     */
+    async listAgents() {
+        const agents = [];
+        try {
+            const fs = await import('node:fs/promises');
+            const agentsDir = this.agentsDir;
+            // Check if agents directory exists
+            try {
+                await fs.access(agentsDir);
+            }
+            catch {
+                return agents; // Directory doesn't exist yet
+            }
+            const entries = await fs.readdir(agentsDir, { withFileTypes: true });
+            for (const entry of entries) {
+                if (entry.isDirectory()) {
+                    const agentPath = path.join(agentsDir, entry.name, 'AGENT.md');
+                    try {
+                        await fs.access(agentPath);
+                        const agent = await this.parseAgent(agentPath, 'user');
+                        if (agent) {
+                            agents.push(agent);
+                        }
+                    }
+                    catch {
+                        // AGENT.md doesn't exist in this directory, skip
+                    }
+                }
+            }
+        }
+        catch {
+            // Agents directory doesn't exist yet
+        }
+        // Sort by name
+        agents.sort((a, b) => a.name.localeCompare(b.name));
+        return agents;
+    }
+    /**
+     * Get a specific agent by path
+     */
+    async getAgent(agentPath) {
+        const fullPath = path.join(this.agentsDir, agentPath, 'AGENT.md');
+        if (!(await this.claudeDir.fileExists(fullPath))) {
+            return null;
+        }
+        return this.parseAgent(fullPath, 'user');
+    }
+    /**
+     * Create a new agent
+     */
+    async createAgent(name, content) {
+        const validation = this.validateAgent(content);
+        if (!validation.valid) {
+            return { success: false, error: validation.errors.join(', ') };
+        }
+        const agentDir = path.join(this.agentsDir, name);
+        const agentFile = path.join(agentDir, 'AGENT.md');
+        try {
+            const fs = await import('node:fs/promises');
+            // Ensure agents directory exists
+            await fs.mkdir(this.agentsDir, { recursive: true });
+            // Create agent directory
+            await fs.mkdir(agentDir, { recursive: true });
+            // Write agent file
+            await fs.writeFile(agentFile, content, 'utf-8');
+            return { success: true };
+        }
+        catch (e) {
+            return { success: false, error: String(e) };
+        }
+    }
+    /**
+     * Update an existing agent
+     */
+    async updateAgent(agentPath, content) {
+        const validation = this.validateAgent(content);
+        if (!validation.valid) {
+            return { success: false, error: validation.errors.join(', ') };
+        }
+        const fullPath = path.join(this.agentsDir, agentPath, 'AGENT.md');
+        if (!(await this.claudeDir.fileExists(fullPath))) {
+            return { success: false, error: 'Agent not found' };
+        }
+        try {
+            const fs = await import('node:fs/promises');
+            await fs.writeFile(fullPath, content, 'utf-8');
+            return { success: true };
+        }
+        catch (e) {
+            return { success: false, error: String(e) };
+        }
+    }
+    /**
+     * Delete an agent
+     */
+    async deleteAgent(agentPath) {
+        const fullPath = path.join(this.agentsDir, agentPath, 'AGENT.md');
+        if (!(await this.claudeDir.fileExists(fullPath))) {
+            return { success: false, error: 'Agent not found' };
+        }
+        try {
+            const fs = await import('node:fs/promises');
+            await fs.rm(path.dirname(fullPath), { recursive: true });
+            return { success: true };
+        }
+        catch (e) {
+            return { success: false, error: String(e) };
+        }
+    }
+    /**
+     * Validate agent content
+     */
+    validateAgent(content) {
+        const errors = [];
+        // Check frontmatter exists
+        if (!content.startsWith('---')) {
+            errors.push('Missing YAML frontmatter (must start with ---)');
+            return { valid: false, errors };
+        }
+        // Find end of frontmatter
+        const endIndex = content.indexOf('---', 3);
+        if (endIndex === -1) {
+            errors.push('Unclosed frontmatter (missing closing ---)');
+            return { valid: false, errors };
+        }
+        const frontmatterStr = content.slice(3, endIndex).trim();
+        try {
+            const frontmatter = parseYaml(frontmatterStr);
+            // Validate name if present
+            if (frontmatter.name) {
+                if (!/^[a-z0-9-]+$/.test(frontmatter.name)) {
+                    errors.push('name must contain only lowercase letters, numbers, and hyphens');
+                }
+                if (frontmatter.name.length > 64) {
+                    errors.push('name must be 64 characters or less');
+                }
+            }
+            // Validate context if present
+            if (frontmatter.context && frontmatter.context !== 'fork') {
+                errors.push('context must be "fork" if specified');
+            }
+            // Validate user-invocable is boolean
+            if (frontmatter['user-invocable'] !== undefined &&
+                typeof frontmatter['user-invocable'] !== 'boolean') {
+                errors.push('user-invocable must be a boolean');
+            }
+            // Validate disable-model-invocation is boolean
+            if (frontmatter['disable-model-invocation'] !== undefined &&
+                typeof frontmatter['disable-model-invocation'] !== 'boolean') {
+                errors.push('disable-model-invocation must be a boolean');
+            }
+        }
+        catch (e) {
+            errors.push(`Invalid YAML: ${e}`);
+        }
+        // Check markdown content exists
+        const markdownContent = content.slice(endIndex + 3).trim();
+        if (!markdownContent) {
+            errors.push('Agent must have markdown content after frontmatter');
+        }
+        return { valid: errors.length === 0, errors };
+    }
+    /**
+     * Get agent template
+     */
+    getAgentTemplate(templateId) {
+        const templates = {
+            default: `---
+name: my-agent
+description: A custom agent for specific tasks
+# Optional fields:
+# allowed-tools: Read, Grep, Glob, Edit  # Tools agent can use
+# model: claude-sonnet-4-20250514        # Model to use
+# context: fork                          # Run as subagent
+# user-invocable: true                   # Allow manual invocation
+---
+
+# My Agent
+
+Instructions for this agent when invoked.
+
+## Purpose
+
+Describe what this agent does and when it should be used.
+
+## Guidelines
+
+- Follow these specific guidelines
+- Use appropriate tools for the task
+- Report back with clear summaries
+`,
+            'code-reviewer': `---
+name: code-reviewer
+description: Reviews code for bugs, security issues, and best practices
+allowed-tools: Read, Grep, Glob
+context: fork
+---
+
+# Code Reviewer Agent
+
+You are an expert code reviewer. Analyze code for:
+
+## Review Criteria
+
+1. **Bugs & Errors**: Look for logic errors, edge cases, null checks
+2. **Security**: Check for vulnerabilities, injection risks, auth issues
+3. **Performance**: Identify inefficient code, memory leaks, N+1 queries
+4. **Best Practices**: Verify coding standards, naming conventions
+5. **Maintainability**: Assess readability, modularity, documentation
+
+## Output Format
+
+Provide a structured review with:
+- 🔴 Critical issues (must fix)
+- 🟡 Warnings (should fix)
+- 🟢 Suggestions (nice to have)
+`,
+            'test-writer': `---
+name: test-writer
+description: Generates comprehensive unit and integration tests
+allowed-tools: Read, Grep, Glob, Write, Edit
+context: fork
+---
+
+# Test Writer Agent
+
+You are an expert test engineer. Generate comprehensive tests for code.
+
+## Testing Strategy
+
+1. **Unit Tests**: Test individual functions/methods in isolation
+2. **Edge Cases**: Cover boundary conditions and error paths
+3. **Integration Tests**: Test component interactions
+4. **Mocking**: Use appropriate mocks for external dependencies
+
+## Guidelines
+
+- Follow the existing test patterns in the codebase
+- Aim for high coverage of critical paths
+- Write clear test descriptions
+- Include setup and teardown as needed
+`,
+            'docs-generator': `---
+name: docs-generator
+description: Creates documentation, comments, and README files
+allowed-tools: Read, Grep, Glob, Write, Edit
+context: fork
+---
+
+# Documentation Generator Agent
+
+You are a technical writer. Generate clear, comprehensive documentation.
+
+## Documentation Types
+
+1. **Code Comments**: Add JSDoc/docstrings to functions
+2. **README Files**: Create project/feature READMEs
+3. **API Documentation**: Document endpoints and parameters
+4. **Architecture Docs**: Explain system design decisions
+
+## Style Guidelines
+
+- Write for developers of varying experience levels
+- Include code examples where helpful
+- Keep explanations concise but complete
+- Use consistent formatting
+`,
+            'security-auditor': `---
+name: security-auditor
+description: Scans code for security vulnerabilities
+allowed-tools: Read, Grep, Glob
+context: fork
+---
+
+# Security Auditor Agent
+
+You are a security expert. Audit code for vulnerabilities.
+
+## Security Checks
+
+1. **Injection**: SQL, XSS, command injection
+2. **Authentication**: Weak auth, session issues
+3. **Authorization**: Access control, privilege escalation
+4. **Data Exposure**: Sensitive data leaks, logging issues
+5. **Dependencies**: Known vulnerable packages
+6. **Configuration**: Hardcoded secrets, insecure defaults
+
+## Severity Levels
+
+- 🔴 CRITICAL: Immediate exploitation risk
+- 🟠 HIGH: Significant security risk
+- 🟡 MEDIUM: Moderate risk, should address
+- 🔵 LOW: Minor issues, best practice
+`,
+            'refactorer': `---
+name: refactorer
+description: Suggests and applies code refactoring improvements
+allowed-tools: Read, Grep, Glob, Edit
+context: fork
+---
+
+# Refactoring Agent
+
+You are a refactoring expert. Improve code quality without changing behavior.
+
+## Refactoring Focus
+
+1. **DRY**: Eliminate code duplication
+2. **SOLID**: Apply SOLID principles
+3. **Naming**: Improve variable/function names
+4. **Structure**: Simplify complex functions
+5. **Patterns**: Apply appropriate design patterns
+
+## Guidelines
+
+- Make incremental, testable changes
+- Preserve existing behavior
+- Document the reasoning for changes
+- Consider backwards compatibility
+`,
+        };
+        return templates[templateId || 'default'] || templates.default;
+    }
+    /**
+     * Get all available template IDs with descriptions
+     */
+    getAgentTemplates() {
+        return [
+            { id: 'default', name: 'Basic Agent', description: 'A minimal agent template to start from' },
+            { id: 'code-reviewer', name: 'Code Reviewer', description: 'Reviews code for bugs, security, and best practices' },
+            { id: 'test-writer', name: 'Test Writer', description: 'Generates unit and integration tests' },
+            { id: 'docs-generator', name: 'Docs Generator', description: 'Creates documentation and comments' },
+            { id: 'security-auditor', name: 'Security Auditor', description: 'Scans code for security vulnerabilities' },
+            { id: 'refactorer', name: 'Refactorer', description: 'Suggests and applies code refactoring' },
+        ];
+    }
+    /**
+     * Parse an AGENT.md file into an Agent object
+     */
+    async parseAgent(filePath, scope) {
+        try {
+            const fs = await import('node:fs/promises');
+            const content = await fs.readFile(filePath, 'utf-8');
+            const validation = this.validateAgent(content);
+            // Extract frontmatter
+            const endIndex = content.indexOf('---', 3);
+            const frontmatterStr = content.slice(3, endIndex).trim();
+            let frontmatter = {};
+            try {
+                frontmatter = parseYaml(frontmatterStr) || {};
+            }
+            catch {
+                // Keep empty frontmatter
+            }
+            // Get name from frontmatter or directory name
+            const dirName = path.basename(path.dirname(filePath));
+            const name = frontmatter.name || dirName;
+            // Get description from frontmatter or first paragraph
+            let description = frontmatter.description || '';
+            if (!description) {
+                const markdownContent = content.slice(endIndex + 3).trim();
+                const lines = markdownContent.split('\n');
+                for (const line of lines) {
+                    if (line.trim() && !line.startsWith('#')) {
+                        description = line.trim().slice(0, 200);
+                        break;
+                    }
+                }
+            }
+            return {
+                name,
+                path: dirName,
+                scope,
+                frontmatter,
+                content,
+                description,
+                isValid: validation.valid,
+                errors: validation.errors,
+            };
+        }
+        catch {
+            return null;
+        }
+    }
+}
+//# sourceMappingURL=agents.js.map

package/dist/services/agents.js.map

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

package/dist/services/analytics.d.ts

@@ -0,0 +1,145 @@
+/**
+ * Analytics service - Real token usage and cost tracking from JSONL session data
+ */
+import { ClaudeDir } from './claude-dir.js';
+export declare const MODEL_PRICING: Record<string, {
+    input: number;
+    output: number;
+    cacheWrite: number;
+    cacheRead: number;
+}>;
+export interface TokenUsage {
+    inputTokens: number;
+    outputTokens: number;
+    cacheCreationTokens: number;
+    cacheReadTokens: number;
+    totalTokens: number;
+}
+export interface CostBreakdown {
+    inputCost: number;
+    outputCost: number;
+    cacheWriteCost: number;
+    cacheReadCost: number;
+    totalCost: number;
+}
+export interface ModelUsage {
+    model: string;
+    tokens: TokenUsage;
+    cost: CostBreakdown;
+    messageCount: number;
+}
+export interface ToolUsageStats {
+    toolName: string;
+    count: number;
+    successCount: number;
+    failureCount: number;
+    avgDuration?: number;
+}
+export interface DetailedToolCall {
+    toolName: string;
+    timestamp: string;
+    sessionId: string;
+    projectPath: string;
+    input: Record<string, unknown>;
+    filePath?: string;
+    command?: string;
+    pattern?: string;
+}
+export interface FileAccessStats {
+    filePath: string;
+    readCount: number;
+    editCount: number;
+    writeCount: number;
+    lastAccessed: string;
+    sessions: string[];
+}
+export interface CommandStats {
+    command: string;
+    count: number;
+    lastUsed: string;
+}
+export interface ToolAnalytics {
+    toolUsage: ToolUsageStats[];
+    fileAccess: FileAccessStats[];
+    commandPatterns: CommandStats[];
+    toolUsageByDay: {
+        date: string;
+        tools: Record<string, number>;
+    }[];
+    toolUsageByProject: {
+        projectName: string;
+        tools: Record<string, number>;
+    }[];
+    mostUsedFiles: FileAccessStats[];
+    mostUsedCommands: CommandStats[];
+    toolDistribution: {
+        toolName: string;
+        percentage: number;
+        count: number;
+    }[];
+}
+export interface SessionAnalytics {
+    sessionId: string;
+    projectPath: string;
+    projectName: string;
+    startedAt: string;
+    endedAt: string;
+    durationMinutes: number;
+    tokens: TokenUsage;
+    cost: CostBreakdown;
+    modelUsage: ModelUsage[];
+    toolUsage: ToolUsageStats[];
+    messageCount: number;
+    userMessageCount: number;
+    assistantMessageCount: number;
+    turnCount: number;
+}
+export interface ProjectAnalytics {
+    projectPath: string;
+    projectName: string;
+    sessionCount: number;
+    totalTokens: TokenUsage;
+    totalCost: CostBreakdown;
+    modelUsage: ModelUsage[];
+    toolUsage: ToolUsageStats[];
+    avgSessionDuration: number;
+    totalDurationMinutes: number;
+    firstSession: string;
+    lastSession: string;
+}
+export interface GlobalAnalytics {
+    totalTokens: TokenUsage;
+    totalCost: CostBreakdown;
+    modelUsage: ModelUsage[];
+    toolUsage: ToolUsageStats[];
+    projectCount: number;
+    sessionCount: number;
+    totalDurationMinutes: number;
+    avgCostPerSession: number;
+    avgCostPerDay: number;
+    dailyCosts: {
+        date: string;
+        cost: number;
+        tokens: number;
+    }[];
+}
+export interface DailyAnalytics {
+    date: string;
+    tokens: TokenUsage;
+    cost: CostBreakdown;
+    sessionCount: number;
+    modelUsage: ModelUsage[];
+    toolUsage: ToolUsageStats[];
+}
+export declare class AnalyticsService {
+    private claudeDir;
+    constructor(claudeDir: ClaudeDir);
+    private getPricing;
+    private calculateCost;
+    getSessionAnalytics(filePath: string, projectDir: string): Promise<SessionAnalytics | null>;
+    getProjectAnalytics(projectDir: string): Promise<ProjectAnalytics | null>;
+    getGlobalAnalytics(days?: number): Promise<GlobalAnalytics>;
+    getDailyAnalytics(days?: number): Promise<DailyAnalytics[]>;
+    getToolAnalytics(days?: number): Promise<ToolAnalytics>;
+}
+//# sourceMappingURL=analytics.d.ts.map

package/dist/services/analytics.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"analytics.d.ts","sourceRoot":"","sources":["../../src/services/analytics.ts"],"names":[],"mappings":"AAAA;;GAEG;AAIH,OAAO,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAM5C,eAAO,MAAM,aAAa,EAAE,MAAM,CAAC,MAAM,EAAE;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAC;IAAC,UAAU,EAAE,MAAM,CAAC;IAAC,SAAS,EAAE,MAAM,CAAA;CAAE,CAgBlH,CAAC;AASF,MAAM,WAAW,UAAU;IACzB,WAAW,EAAE,MAAM,CAAC;IACpB,YAAY,EAAE,MAAM,CAAC;IACrB,mBAAmB,EAAE,MAAM,CAAC;IAC5B,eAAe,EAAE,MAAM,CAAC;IACxB,WAAW,EAAE,MAAM,CAAC;CACrB;AAED,MAAM,WAAW,aAAa;IAC5B,SAAS,EAAE,MAAM,CAAC;IAClB,UAAU,EAAE,MAAM,CAAC;IACnB,cAAc,EAAE,MAAM,CAAC;IACvB,aAAa,EAAE,MAAM,CAAC;IACtB,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,UAAU;IACzB,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,UAAU,CAAC;IACnB,IAAI,EAAE,aAAa,CAAC;IACpB,YAAY,EAAE,MAAM,CAAC;CACtB;AAED,MAAM,WAAW,cAAc;IAC7B,QAAQ,EAAE,MAAM,CAAC;IACjB,KAAK,EAAE,MAAM,CAAC;IACd,YAAY,EAAE,MAAM,CAAC;IACrB,YAAY,EAAE,MAAM,CAAC;IACrB,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,EAAE,MAAM,CAAC;IACjB,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;IAClB,WAAW,EAAE,MAAM,CAAC;IACpB,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAE/B,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,WAAW,eAAe;IAC9B,QAAQ,EAAE,MAAM,CAAC;IACjB,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;IAClB,UAAU,EAAE,MAAM,CAAC;IACnB,YAAY,EAAE,MAAM,CAAC;IACrB,QAAQ,EAAE,MAAM,EAAE,CAAC;CACpB;AAED,MAAM,WAAW,YAAY;IAC3B,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,WAAW,aAAa;IAC5B,SAAS,EAAE,cAAc,EAAE,CAAC;IAC5B,UAAU,EAAE,eAAe,EAAE,CAAC;IAC9B,eAAe,EAAE,YAAY,EAAE,CAAC;IAChC,cAAc,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;KAAE,EAAE,CAAC;IAClE,kBAAkB,EAAE;QAAE,WAAW,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;KAAE,EAAE,CAAC;IAC7E,aAAa,EAAE,eAAe,EAAE,CAAC;IACjC,gBAAgB,EAAE,YAAY,EAAE,CAAC;IACjC,gBAAgB,EAAE;QAAE,QAAQ,EAAE,MAAM,CAAC;QAAC,UAAU,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,EAAE,CAAC;CAC7E;AAED,MAAM,WAAW,gBAAgB;IAC/B,SAAS,EAAE,MAAM,CAAC;IAClB,WAAW,EAAE,MAAM,CAAC;IACpB,WAAW,EAAE,MAAM,CAAC;IACpB,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,EAAE,MAAM,CAAC;IAChB,eAAe,EAAE,MAAM,CAAC;IACxB,MAAM,EAAE,UAAU,CAAC;IACnB,IAAI,EAAE,aAAa,CAAC;IACpB,UAAU,EAAE,UAAU,EAAE,CAAC;IACzB,SAAS,EAAE,cAAc,EAAE,CAAC;IAC5B,YAAY,EAAE,MAAM,CAAC;IACrB,gBAAgB,EAAE,MAAM,CAAC;IACzB,qBAAqB,EAAE,MAAM,CAAC;IAC9B,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,gBAAgB;IAC/B,WAAW,EAAE,MAAM,CAAC;IACpB,WAAW,EAAE,MAAM,CAAC;IACpB,YAAY,EAAE,MAAM,CAAC;IACrB,WAAW,EAAE,UAAU,CAAC;IACxB,SAAS,EAAE,aAAa,CAAC;IACzB,UAAU,EAAE,UAAU,EAAE,CAAC;IACzB,SAAS,EAAE,cAAc,EAAE,CAAC;IAC5B,kBAAkB,EAAE,MAAM,CAAC;IAC3B,oBAAoB,EAAE,MAAM,CAAC;IAC7B,YAAY,EAAE,MAAM,CAAC;IACrB,WAAW,EAAE,MAAM,CAAC;CACrB;AAED,MAAM,WAAW,eAAe;IAC9B,WAAW,EAAE,UAAU,CAAC;IACxB,SAAS,EAAE,aAAa,CAAC;IACzB,UAAU,EAAE,UAAU,EAAE,CAAC;IACzB,SAAS,EAAE,cAAc,EAAE,CAAC;IAC5B,YAAY,EAAE,MAAM,CAAC;IACrB,YAAY,EAAE,MAAM,CAAC;IACrB,oBAAoB,EAAE,MAAM,CAAC;IAC7B,iBAAiB,EAAE,MAAM,CAAC;IAC1B,aAAa,EAAE,MAAM,CAAC;IACtB,UAAU,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE,EAAE,CAAC;CAC9D;AAED,MAAM,WAAW,cAAc;IAC7B,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,UAAU,CAAC;IACnB,IAAI,EAAE,aAAa,CAAC;IACpB,YAAY,EAAE,MAAM,CAAC;IACrB,UAAU,EAAE,UAAU,EAAE,CAAC;IACzB,SAAS,EAAE,cAAc,EAAE,CAAC;CAC7B;AAMD,qBAAa,gBAAgB;IAC3B,OAAO,CAAC,SAAS,CAAY;gBAEjB,SAAS,EAAE,SAAS;IAQhC,OAAO,CAAC,UAAU;IAwBlB,OAAO,CAAC,aAAa;IAqBf,mBAAmB,CAAC,QAAQ,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,gBAAgB,GAAG,IAAI,CAAC;IAoJ3F,mBAAmB,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,gBAAgB,GAAG,IAAI,CAAC;IA4GzE,kBAAkB,CAAC,IAAI,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,eAAe,CAAC;IAwI3D,iBAAiB,CAAC,IAAI,GAAE,MAAW,GAAG,OAAO,CAAC,cAAc,EAAE,CAAC;IAoD/D,gBAAgB,CAAC,IAAI,GAAE,MAAW,GAAG,OAAO,CAAC,aAAa,CAAC;CAiKlE"}