ted-mosby 1.0.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 Dakota Kim
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,238 @@
+# Ted Mosby
+
+> "Kids, I'm going to tell you an incredible story... the story of your codebase architecture."
+
+An AI-powered CLI tool that generates comprehensive architectural documentation wikis for code repositories with source code traceability.
+
+**Built with [buildanagentworkshop.com](https://buildanagentworkshop.com)**
+
+---
+
+## What is Ted Mosby?
+
+Ted Mosby is an AI agent that reads your codebase and automatically generates professional architectural documentation. Unlike generic documentation tools, every concept in the generated wiki links directly to the source code (`file:line` references), making it easy to navigate from documentation to implementation.
+
+### Generated Documentation Includes:
+
+- **Architecture Overview** - High-level system design with Mermaid diagrams
+- **Module Documentation** - Per-component breakdowns with source traceability
+- **Data Flow Documentation** - How data moves through your system
+- **Getting Started Guides** - Onboarding documentation for new developers
+- **Glossary** - Key concepts and terminology
+
+---
+
+## Installation
+
+```bash
+npm install -g ted-mosby
+```
+
+## Prerequisites
+
+- **Node.js** >= 18.0.0
+- **Anthropic API key** - Get one at [console.anthropic.com](https://console.anthropic.com)
+
+---
+
+## Quick Start
+
+### 1. Set your API key
+
+```bash
+export ANTHROPIC_API_KEY=your-api-key-here
+```
+
+Or create a `.env` file in your project:
+```bash
+echo "ANTHROPIC_API_KEY=your-api-key-here" > .env
+```
+
+### 2. Generate documentation
+
+```bash
+# For a local project
+ted-mosby generate -r ./my-project
+
+# For a GitHub repository
+ted-mosby generate -r https://github.com/user/repo
+```
+
+### 3. View the results
+
+Open the generated `wiki/README.md` to explore your architectural documentation.
+
+---
+
+## Usage
+
+### Basic Commands
+
+```bash
+# Generate wiki for current directory
+ted-mosby generate -r .
+
+# Generate wiki for a specific directory
+ted-mosby generate -r /path/to/project
+
+# Generate wiki from a GitHub URL
+ted-mosby generate -r https://github.com/user/repo
+
+# Specify output directory
+ted-mosby generate -r ./my-project -o ./docs/architecture
+
+# Focus on a specific subdirectory
+ted-mosby generate -r ./my-project -p src/core
+
+# Verbose output (see what the agent is doing)
+ted-mosby generate -r ./my-project -v
+
+# Estimate time/cost before running (dry run)
+ted-mosby generate -r ./my-project -e
+```
+
+### All Options
+
+| Option | Description | Default |
+|--------|-------------|---------|
+| `-r, --repo <path/url>` | Repository path or GitHub URL (required) | - |
+| `-o, --output <dir>` | Output directory for wiki | `./wiki` |
+| `-c, --config <file>` | Path to wiki.json config file | - |
+| `-t, --token <token>` | GitHub token for private repos | - |
+| `-m, --model <model>` | Claude model to use | `claude-sonnet-4-20250514` |
+| `-p, --path <path>` | Focus on specific directory | - |
+| `-f, --force` | Force regeneration (ignore cache) | - |
+| `-v, --verbose` | Show detailed progress | - |
+| `-e, --estimate` | Estimate time/cost (dry run) | - |
+
+---
+
+## What to Expect
+
+When you run Ted Mosby:
+
+1. **Repository Analysis** - The agent scans your codebase structure
+2. **Semantic Indexing** - Creates embeddings for intelligent code search
+3. **Architecture Discovery** - Identifies patterns, components, and relationships
+4. **Documentation Generation** - Writes markdown pages with diagrams
+5. **Source Linking** - Every concept links to specific file:line references
+
+### Typical Runtime
+
+| Codebase Size | Approximate Time |
+|---------------|------------------|
+| Small (<50 files) | 1-2 minutes |
+| Medium (50-200 files) | 2-5 minutes |
+| Large (200+ files) | 5-10 minutes |
+
+Use `--estimate` to get a cost/time estimate before running.
+
+---
+
+## Example Output
+
+The generated wiki structure:
+
+```
+wiki/
+├── README.md                    # Navigation entry point
+├── architecture/
+│   ├── overview.md              # System architecture + diagrams
+│   └── data-flow.md             # Data flow documentation
+├── components/
+│   └── {module}/
+│       └── index.md             # Per-module documentation
+├── guides/
+│   └── getting-started.md       # Quick start guide
+└── glossary.md                  # Concept index
+```
+
+### Source Traceability Example
+
+Every architectural concept includes clickable source references:
+
+```markdown
+## Authentication Flow
+
+The authentication system uses JWT tokens for stateless auth.
+
+**Source:** [`src/auth/jwt-provider.ts:23-67`](../../../src/auth/jwt-provider.ts#L23-L67)
+
+```typescript
+export class JwtProvider {
+  async generateToken(user: User): Promise<string> {
+    // Token generation logic...
+  }
+}
+```
+```
+
+---
+
+## Configuration (Optional)
+
+Create a `wiki.json` file in your project root to customize generation:
+
+```json
+{
+  "repo_notes": [
+    { "content": "Focus on the src/core directory for main logic" }
+  ],
+  "pages": [
+    { "title": "Architecture Overview", "purpose": "High-level design", "parent": null },
+    { "title": "Authentication", "parent": "Architecture Overview" }
+  ],
+  "exclude_patterns": ["**/*.test.ts", "**/__mocks__/**"],
+  "output": {
+    "format": "markdown",
+    "diagrams": true
+  }
+}
+```
+
+---
+
+## How It Works
+
+Ted Mosby is built with:
+
+- **[Claude Agent SDK](https://github.com/anthropics/claude-agent-sdk)** - Orchestrates the AI agent workflow
+- **RAG (Retrieval Augmented Generation)** - Semantic code search using embeddings
+- **[Model Context Protocol (MCP)](https://modelcontextprotocol.io)** - Tool integration for file operations
+- **Mermaid** - Architecture diagram generation
+
+---
+
+## Development
+
+```bash
+# Clone the repo
+git clone https://github.com/your-username/ted-mosby.git
+cd ted-mosby
+
+# Install dependencies
+npm install
+
+# Build
+npm run build
+
+# Run locally
+npm start -- generate -r ./my-project
+
+# Watch mode for development
+npm run dev
+```
+
+---
+
+## Built With
+
+This project was created using the [Claude Agent SDK](https://github.com/anthropics/claude-agent-sdk) at the **Build an Agent Workshop**.
+
+**Learn to build your own AI agents at [buildanagentworkshop.com](https://buildanagentworkshop.com)**
+
+---
+
+## License
+
+MIT

package/dist/agent.d.ts

@@ -0,0 +1,37 @@
+import { PermissionManager, type PermissionPolicy } from './permissions.js';
+import { type ClaudeConfig } from './claude-config.js';
+export interface DevelopmentAgentAgentConfig {
+    verbose?: boolean;
+    apiKey?: string;
+    permissionManager?: PermissionManager;
+    permissions?: PermissionPolicy;
+    auditPath?: string;
+    workingDir?: string;
+}
+export declare class DevelopmentAgentAgent {
+    private config;
+    private permissionManager;
+    private fileOps;
+    private commandRunner;
+    private customServer;
+    private mcpConfigManager;
+    private claudeConfig;
+    private sessionId?;
+    constructor(config?: DevelopmentAgentAgentConfig);
+    /**
+     * Get loaded Claude Code configuration
+     */
+    getClaudeConfig(): ClaudeConfig;
+    private loadExternalMcpServers;
+    query(userQuery: string, history?: Array<{
+        role: string;
+        content: string;
+    }>): AsyncGenerator<import("@anthropic-ai/claude-agent-sdk").SDKMessage, void, unknown>;
+    private createToolServer;
+    private buildSystemPrompt;
+    readFile(filePath: string): Promise<string>;
+    writeFile(filePath: string, content: string): Promise<void>;
+    findFiles(pattern: string): Promise<string[]>;
+    runCommand(command: string): Promise<void>;
+}
+//# sourceMappingURL=agent.d.ts.map

package/dist/agent.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"agent.d.ts","sourceRoot":"","sources":["../src/agent.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,iBAAiB,EAAE,KAAK,gBAAgB,EAAE,MAAM,kBAAkB,CAAC;AAE5E,OAAO,EAA2C,KAAK,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAEhG,MAAM,WAAW,2BAA2B;IAC1C,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,iBAAiB,CAAC,EAAE,iBAAiB,CAAC;IACtC,WAAW,CAAC,EAAE,gBAAgB,CAAC;IAC/B,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED,qBAAa,qBAAqB;IAChC,OAAO,CAAC,MAAM,CAA8B;IAC5C,OAAO,CAAC,iBAAiB,CAAoB;IAC7C,OAAO,CAAC,OAAO,CAAiB;IAChC,OAAO,CAAC,aAAa,CAAgB;IACrC,OAAO,CAAC,YAAY,CAAwC;IAC5D,OAAO,CAAC,gBAAgB,CAAmB;IAC3C,OAAO,CAAC,YAAY,CAAe;IACnC,OAAO,CAAC,SAAS,CAAC,CAAS;gBAEf,MAAM,GAAE,2BAAgC;IAyBpD;;OAEG;IACH,eAAe,IAAI,YAAY;YAIjB,sBAAsB;IA4C7B,KAAK,CAAC,SAAS,EAAE,MAAM,EAAE,OAAO,GAAE,KAAK,CAAC;QAAC,IAAI,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAC,CAAM;IAuDpF,OAAO,CAAC,gBAAgB;IAyFxB,OAAO,CAAC,iBAAiB;IAuDnB,QAAQ,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IAI3C,SAAS,CAAC,QAAQ,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAI3D,SAAS,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC;IAK7C,UAAU,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;CAIjD"}

package/dist/agent.js

@@ -0,0 +1,247 @@
+import { query, tool, createSdkMcpServer } from '@anthropic-ai/claude-agent-sdk';
+import { z } from 'zod';
+import { FileOperations } from './tools/file-operations.js';
+import { CommandRunner } from './tools/command-runner.js';
+import { PermissionManager } from './permissions.js';
+import { MCPConfigManager } from './mcp-config.js';
+import { loadClaudeConfig, formatSkillsForPrompt } from './claude-config.js';
+export class DevelopmentAgentAgent {
+    config;
+    permissionManager;
+    fileOps;
+    commandRunner;
+    customServer;
+    mcpConfigManager;
+    claudeConfig;
+    sessionId;
+    constructor(config = {}) {
+        this.config = config;
+        if (config.apiKey) {
+            process.env.ANTHROPIC_API_KEY = config.apiKey;
+        }
+        if (!process.env.ANTHROPIC_API_KEY) {
+            throw new Error('Anthropic API key is required. Set it via config.apiKey or ANTHROPIC_API_KEY environment variable.');
+        }
+        this.permissionManager = config.permissionManager || new PermissionManager({ policy: config.permissions, auditPath: config.auditPath });
+        this.fileOps = new FileOperations(this.permissionManager);
+        this.commandRunner = new CommandRunner(this.permissionManager);
+        // Create SDK MCP server with custom tools
+        this.customServer = this.createToolServer();
+        // Initialize MCP config manager
+        this.mcpConfigManager = new MCPConfigManager();
+        // Load Claude Code configuration (CLAUDE.md, skills, commands)
+        this.claudeConfig = loadClaudeConfig(config.workingDir || process.cwd());
+    }
+    /**
+     * Get loaded Claude Code configuration
+     */
+    getClaudeConfig() {
+        return this.claudeConfig;
+    }
+    async loadExternalMcpServers() {
+        await this.mcpConfigManager.load();
+        const servers = {};
+        for (const [name, config] of Object.entries(this.mcpConfigManager.getEnabledServers())) {
+            const resolved = this.mcpConfigManager.resolveEnvVariables(config);
+            switch (resolved.type) {
+                case 'stdio':
+                    servers[name] = {
+                        command: resolved.command,
+                        args: resolved.args || [],
+                        env: resolved.env || {}
+                    };
+                    break;
+                case 'sse':
+                    servers[name] = {
+                        type: 'sse',
+                        url: resolved.url,
+                        headers: resolved.headers || {}
+                    };
+                    break;
+                case 'http':
+                    servers[name] = {
+                        type: 'http',
+                        url: resolved.url,
+                        headers: resolved.headers || {}
+                    };
+                    break;
+                case 'sdk':
+                    try {
+                        // For SDK servers, pass the module directly
+                        const mod = await import(resolved.serverModule);
+                        servers[name] = mod.default || mod;
+                    }
+                    catch (err) {
+                        console.warn(`Warning: Could not load SDK MCP server '${name}': ${err}`);
+                    }
+                    break;
+            }
+        }
+        return servers;
+    }
+    async *query(userQuery, history = []) {
+        const systemPrompt = this.buildSystemPrompt();
+        // Load external MCP servers from .mcp.json
+        const externalMcpServers = await this.loadExternalMcpServers();
+        const options = {
+            model: 'claude-sonnet-4-20250514',
+            cwd: process.cwd(),
+            systemPrompt,
+            mcpServers: {
+                // Pass SDK server directly
+                'custom-tools': this.customServer,
+                ...externalMcpServers
+            },
+            // Enable built-in web search and fetch tools from Claude Agent SDK
+            allowedTools: ['WebSearch', 'WebFetch'],
+            permissionMode: 'default',
+            includePartialMessages: true,
+            canUseTool: async (toolName, input) => {
+                // Permission check happens in tool execution
+                return { behavior: 'allow', updatedInput: input };
+            }
+        };
+        // Resume previous session if we have one
+        if (this.sessionId) {
+            options.resume = this.sessionId;
+        }
+        // If history provided and no active session, prepend conversation context to prompt
+        let effectivePrompt = userQuery;
+        if (history.length > 0 && !this.sessionId) {
+            const contextLines = history.map(h => `${h.role === 'user' ? 'User' : 'Assistant'}: ${h.content}`).join('\n\n');
+            effectivePrompt = `Previous conversation:\n${contextLines}\n\nUser: ${userQuery}`;
+        }
+        const queryResult = query({
+            prompt: effectivePrompt,
+            options
+        });
+        // Stream messages and capture session ID
+        for await (const message of queryResult) {
+            // Capture session ID from system init message for future queries
+            if (message.type === 'system' && message.subtype === 'init') {
+                this.sessionId = message.session_id;
+            }
+            yield message;
+        }
+    }
+    createToolServer() {
+        const tools = [];
+        // File operation tools
+        tools.push(tool('read_file', 'Read the contents of a file', {
+            filePath: z.string().describe('Path to the file to read')
+        }, async (args) => {
+            const content = await this.fileOps.readFile(args.filePath);
+            return {
+                content: [{
+                        type: 'text',
+                        text: content
+                    }]
+            };
+        }));
+        tools.push(tool('write_file', 'Write content to a file (creates or overwrites)', {
+            filePath: z.string().describe('Path to the file to write'),
+            content: z.string().describe('Content to write to the file')
+        }, async (args) => {
+            await this.fileOps.writeFile(args.filePath, args.content);
+            return {
+                content: [{
+                        type: 'text',
+                        text: `Successfully wrote to ${args.filePath}`
+                    }]
+            };
+        }));
+        tools.push(tool('find_files', 'Find files matching a glob pattern', {
+            pattern: z.string().describe('Glob pattern to match files (e.g., "**/*.ts")')
+        }, async (args) => {
+            const files = await this.fileOps.findFiles(args.pattern);
+            return {
+                content: [{
+                        type: 'text',
+                        text: files.join('\n')
+                    }]
+            };
+        }));
+        // Command execution tools
+        tools.push(tool('run_command', 'Execute a shell command', {
+            command: z.string().describe('Command to execute')
+        }, async (args) => {
+            const result = await this.commandRunner.execute(args.command);
+            return {
+                content: [{
+                        type: 'text',
+                        text: this.commandRunner.formatResult(result)
+                    }]
+            };
+        }));
+        return createSdkMcpServer({
+            name: 'custom-tools',
+            version: '1.0.0',
+            tools
+        });
+    }
+    buildSystemPrompt() {
+        // Build memory section from CLAUDE.md if available
+        const memorySection = this.claudeConfig.memory
+            ? `## Project Context (from CLAUDE.md):
+${this.claudeConfig.memory}
+
+`
+            : '';
+        // Build skills section if any skills are loaded
+        const skillsSection = this.claudeConfig.skills.length > 0
+            ? `## Available Skills:
+${formatSkillsForPrompt(this.claudeConfig.skills)}
+
+When the user asks you to use a skill (e.g., "run the api-design skill" or "use code-review"), apply the skill's instructions to the current context. Skills provide specialized expertise and workflows.
+
+`
+            : '';
+        // Build subagents section if any are loaded
+        const subagentsSection = this.claudeConfig.subagents.length > 0
+            ? '## Available Subagents:\n' + this.claudeConfig.subagents.map(a => '- **' + a.name + '**: ' + a.description).join('\n') + '\n\nYou can delegate specialized tasks to these subagents when appropriate.\n\n'
+            : '';
+        // Build commands info if any are loaded
+        const commandsSection = this.claudeConfig.commands.length > 0
+            ? '## Slash Commands:\nThe user can invoke these commands with /command-name:\n' + this.claudeConfig.commands.map(c => '- **/' + c.name + '**: ' + (c.description || 'No description')).join('\n') + '\n\n'
+            : '';
+        return `You are Development Agent, a specialized AI assistant for development.
+
+${memorySection}A comprehensive development assistant that can read, write, and modify code files, execute build commands, manage git repositories, and help with debugging and optimization.
+
+## Your Capabilities:
+- **Read File**: Read contents of any file in the project
+- **Find Files**: Search for files using glob patterns
+- **Search in Files**: Search for text content across files
+- **Write File**: Create new files with specified content
+- **Edit File**: Modify existing files with find-and-replace
+- **Git Operations**: Git commands for version control
+- **Run Command**: Execute shell commands and scripts
+- **Web Search**: Search the web for information
+- **Web Fetch**: Fetch and analyze web page content
+- **Database Query**: Query SQL databases
+- **API Client**: Make HTTP requests to external APIs
+
+${skillsSection}${subagentsSection}${commandsSection}## Instructions:
+- Provide helpful, accurate, and actionable assistance
+- Use your available tools when appropriate
+- Be thorough and explain your reasoning
+
+Always be helpful, accurate, and focused on development tasks.`;
+    }
+    // File operation helpers
+    async readFile(filePath) {
+        return this.fileOps.readFile(filePath);
+    }
+    async writeFile(filePath, content) {
+        return this.fileOps.writeFile(filePath, content);
+    }
+    async findFiles(pattern) {
+        return this.fileOps.findFiles(pattern);
+    }
+    // Command execution helpers
+    async runCommand(command) {
+        const result = await this.commandRunner.execute(command);
+        console.log(this.commandRunner.formatResult(result));
+    }
+}
+//# sourceMappingURL=agent.js.map

package/dist/agent.js.map

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

package/dist/claude-config.d.ts

@@ -0,0 +1,58 @@
+/**
+ * Claude Config Loader
+ *
+ * Loads Claude Code configuration files at runtime:
+ * - CLAUDE.md (project memory/context)
+ * - .claude/skills/*.md (model-invoked skills)
+ * - .claude/commands/*.md (slash commands)
+ * - .claude/agents/*.md (subagents)
+ */
+export interface SkillDefinition {
+    name: string;
+    description: string;
+    tools: string[];
+    instructions: string;
+    filePath: string;
+}
+export interface CommandDefinition {
+    name: string;
+    description?: string;
+    template: string;
+    filePath: string;
+}
+export interface SubagentDefinition {
+    name: string;
+    description: string;
+    tools: string[];
+    model: string;
+    permissionMode?: string;
+    systemPrompt: string;
+    filePath: string;
+}
+export interface ClaudeConfig {
+    memory: string | null;
+    skills: SkillDefinition[];
+    commands: CommandDefinition[];
+    subagents: SubagentDefinition[];
+}
+/**
+ * Load all Claude Code configuration from the working directory
+ */
+export declare function loadClaudeConfig(workingDir?: string): ClaudeConfig;
+/**
+ * Format skills as a system prompt section
+ */
+export declare function formatSkillsForPrompt(skills: SkillDefinition[]): string;
+/**
+ * Format commands for display/autocomplete
+ */
+export declare function formatCommandsForDisplay(commands: CommandDefinition[]): string[];
+/**
+ * Get a specific command by name
+ */
+export declare function getCommand(commands: CommandDefinition[], name: string): CommandDefinition | undefined;
+/**
+ * Expand a command template with arguments
+ */
+export declare function expandCommand(command: CommandDefinition, args: string): string;
+//# sourceMappingURL=claude-config.d.ts.map

package/dist/claude-config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"claude-config.d.ts","sourceRoot":"","sources":["../src/claude-config.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAKH,MAAM,WAAW,eAAe;IAC9B,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,KAAK,EAAE,MAAM,EAAE,CAAC;IAChB,YAAY,EAAE,MAAM,CAAC;IACrB,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,WAAW,iBAAiB;IAChC,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,WAAW,kBAAkB;IACjC,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,KAAK,EAAE,MAAM,EAAE,CAAC;IAChB,KAAK,EAAE,MAAM,CAAC;IACd,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,YAAY,EAAE,MAAM,CAAC;IACrB,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,WAAW,YAAY;IAC3B,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;IACtB,MAAM,EAAE,eAAe,EAAE,CAAC;IAC1B,QAAQ,EAAE,iBAAiB,EAAE,CAAC;IAC9B,SAAS,EAAE,kBAAkB,EAAE,CAAC;CACjC;AA4BD;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,UAAU,GAAE,MAAsB,GAAG,YAAY,CAkGjF;AAED;;GAEG;AACH,wBAAgB,qBAAqB,CAAC,MAAM,EAAE,eAAe,EAAE,GAAG,MAAM,CAavE;AAED;;GAEG;AACH,wBAAgB,wBAAwB,CAAC,QAAQ,EAAE,iBAAiB,EAAE,GAAG,MAAM,EAAE,CAEhF;AAED;;GAEG;AACH,wBAAgB,UAAU,CAAC,QAAQ,EAAE,iBAAiB,EAAE,EAAE,IAAI,EAAE,MAAM,GAAG,iBAAiB,GAAG,SAAS,CAErG;AAED;;GAEG;AACH,wBAAgB,aAAa,CAAC,OAAO,EAAE,iBAAiB,EAAE,IAAI,EAAE,MAAM,GAAG,MAAM,CAa9E"}