ted-mosby 1.0.0

package/dist/tools/file-operations.js

@@ -0,0 +1,119 @@
+import { readFile, writeFile, access, readdir, stat } from 'fs/promises';
+import { resolve } from 'path';
+import { glob } from 'glob';
+export class FileOperations {
+    permissionManager;
+    baseDir;
+    constructor(permissionManager, baseDir = process.cwd()) {
+        this.permissionManager = permissionManager;
+        this.baseDir = resolve(baseDir);
+    }
+    /**
+     * Validates that a path is within the allowed base directory.
+     * Prevents directory traversal attacks and access outside sandbox.
+     */
+    validatePath(filePath) {
+        const absolutePath = resolve(this.baseDir, filePath);
+        // Ensure path is within baseDir (prevent directory traversal)
+        if (!absolutePath.startsWith(this.baseDir + '/') && absolutePath !== this.baseDir) {
+            throw new Error(`Access denied: Path "${filePath}" is outside the allowed directory "${this.baseDir}"`);
+        }
+        return absolutePath;
+    }
+    async readFile(filePath) {
+        try {
+            const safePath = this.validatePath(filePath);
+            return await readFile(safePath, 'utf-8');
+        }
+        catch (error) {
+            if (error instanceof Error && error.message.startsWith('Access denied:')) {
+                throw error;
+            }
+            throw new Error(`Failed to read file ${filePath}: ${error instanceof Error ? error.message : String(error)}`);
+        }
+    }
+    async writeFile(filePath, content) {
+        // Validate path first (before permission check)
+        const safePath = this.validatePath(filePath);
+        // Request permission before writing
+        const permission = await this.permissionManager.requestPermission({
+            action: 'write_file',
+            resource: filePath,
+            details: `Writing ${content.length} characters`
+        });
+        if (!permission.allowed) {
+            throw new Error(`Permission denied: Cannot write to ${filePath}`);
+        }
+        try {
+            await writeFile(safePath, content, 'utf-8');
+        }
+        catch (error) {
+            throw new Error(`Failed to write file ${filePath}: ${error instanceof Error ? error.message : String(error)}`);
+        }
+    }
+    async fileExists(filePath) {
+        try {
+            const safePath = this.validatePath(filePath);
+            await access(safePath);
+            return true;
+        }
+        catch (error) {
+            if (error instanceof Error && error.message.startsWith('Access denied:')) {
+                throw error;
+            }
+            return false;
+        }
+    }
+    async listFiles(dirPath) {
+        try {
+            const safePath = this.validatePath(dirPath);
+            const entries = await readdir(safePath, { withFileTypes: true });
+            return entries
+                .filter(entry => entry.isFile())
+                .map(entry => entry.name);
+        }
+        catch (error) {
+            if (error instanceof Error && error.message.startsWith('Access denied:')) {
+                throw error;
+            }
+            throw new Error(`Failed to list files in ${dirPath}: ${error instanceof Error ? error.message : String(error)}`);
+        }
+    }
+    async findFiles(pattern, cwd) {
+        // Block directory traversal patterns
+        if (pattern.includes('..')) {
+            throw new Error('Access denied: Path traversal patterns (..) not allowed');
+        }
+        // Always use baseDir as root, ignore cwd parameter for security
+        try {
+            const results = await glob(pattern, {
+                cwd: this.baseDir,
+                absolute: true,
+                ignore: ['node_modules/**', '.git/**']
+            });
+            // Double-check all results are within baseDir
+            return results.filter(p => p.startsWith(this.baseDir + '/') || p === this.baseDir);
+        }
+        catch (error) {
+            throw new Error(`Failed to find files matching ${pattern}: ${error instanceof Error ? error.message : String(error)}`);
+        }
+    }
+    async getFileStats(filePath) {
+        try {
+            const safePath = this.validatePath(filePath);
+            const stats = await stat(safePath);
+            return {
+                size: stats.size,
+                modified: stats.mtime,
+                isDirectory: stats.isDirectory()
+            };
+        }
+        catch (error) {
+            if (error instanceof Error && error.message.startsWith('Access denied:')) {
+                throw error;
+            }
+            throw new Error(`Failed to get stats for ${filePath}: ${error instanceof Error ? error.message : String(error)}`);
+        }
+    }
+}
+//# sourceMappingURL=file-operations.js.map

package/dist/tools/file-operations.js.map

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

package/dist/tools/web-tools.d.ts

@@ -0,0 +1,17 @@
+import { PermissionManager } from '../permissions.js';
+export interface SearchResult {
+    title: string;
+    url: string;
+    snippet: string;
+}
+export declare class WebTools {
+    private readonly userAgent;
+    private permissionManager;
+    constructor(permissionManager: PermissionManager);
+    fetch(url: string): Promise<string>;
+    fetchText(url: string): Promise<string>;
+    search(query: string, maxResults?: number): Promise<string[]>;
+    extractLinks(html: string, baseUrl?: string): string[];
+    extractMetadata(html: string): Record<string, string>;
+}
+//# sourceMappingURL=web-tools.d.ts.map

package/dist/tools/web-tools.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"web-tools.d.ts","sourceRoot":"","sources":["../../src/tools/web-tools.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,iBAAiB,EAAE,MAAM,mBAAmB,CAAA;AAErD,MAAM,WAAW,YAAY;IAC3B,KAAK,EAAE,MAAM,CAAA;IACb,GAAG,EAAE,MAAM,CAAA;IACX,OAAO,EAAE,MAAM,CAAA;CAChB;AAED,qBAAa,QAAQ;IACnB,OAAO,CAAC,QAAQ,CAAC,SAAS,CAA8H;IACxJ,OAAO,CAAC,iBAAiB,CAAoB;gBAEjC,iBAAiB,EAAE,iBAAiB;IAI1C,KAAK,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IAyBnC,SAAS,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IAevC,MAAM,CAAC,KAAK,EAAE,MAAM,EAAE,UAAU,GAAE,MAAW,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC;IAyCvE,YAAY,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,GAAG,MAAM,EAAE;IAsBtD,eAAe,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC;CAuBtD"}

package/dist/tools/web-tools.js

@@ -0,0 +1,122 @@
+import axios from 'axios';
+import * as cheerio from 'cheerio';
+export class WebTools {
+    userAgent = 'Mozilla/5.0 (Macintosh; Intel Mac OS X 10_15_7) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/91.0.4472.124 Safari/537.36';
+    permissionManager;
+    constructor(permissionManager) {
+        this.permissionManager = permissionManager;
+    }
+    async fetch(url) {
+        // Request permission before making network request
+        const permission = await this.permissionManager.requestPermission({
+            action: 'network_request',
+            resource: url,
+            details: 'Fetching web page content'
+        });
+        if (!permission.allowed) {
+            throw new Error(`Permission denied: Cannot fetch ${url}`);
+        }
+        try {
+            const response = await axios.get(url, {
+                headers: {
+                    'User-Agent': this.userAgent
+                },
+                timeout: 10000
+            });
+            return response.data;
+        }
+        catch (error) {
+            throw new Error(`Failed to fetch ${url}: ${error instanceof Error ? error.message : String(error)}`);
+        }
+    }
+    async fetchText(url) {
+        try {
+            const html = await this.fetch(url);
+            const $ = cheerio.load(html);
+            // Remove script and style elements
+            $('script, style').remove();
+            // Get text content
+            return $('body').text().replace(/\s+/g, ' ').trim();
+        }
+        catch (error) {
+            throw new Error(`Failed to extract text from ${url}: ${error instanceof Error ? error.message : String(error)}`);
+        }
+    }
+    async search(query, maxResults = 10) {
+        try {
+            // Use DuckDuckGo HTML search (no API key required)
+            const searchUrl = `https://html.duckduckgo.com/html/?q=${encodeURIComponent(query)}`;
+            const response = await axios.get(searchUrl, {
+                headers: {
+                    'User-Agent': 'Mozilla/5.0 (compatible; ResearchBot/1.0)'
+                },
+                timeout: 10000
+            });
+            const $ = cheerio.load(response.data);
+            const results = [];
+            // Extract search results from DuckDuckGo HTML
+            $('.result').each((index, element) => {
+                if (index >= maxResults)
+                    return false;
+                const titleEl = $(element).find('.result__a');
+                const snippetEl = $(element).find('.result__snippet');
+                const url = titleEl.attr('href');
+                const title = titleEl.text().trim();
+                const snippet = snippetEl.text().trim();
+                if (title && snippet) {
+                    results.push(`**${title}**\n${snippet}\n${url || ''}`);
+                }
+            });
+            if (results.length === 0) {
+                return [`No results found for: "${query}"`];
+            }
+            return results;
+        }
+        catch (error) {
+            console.error('Web search failed:', error instanceof Error ? error.message : String(error));
+            return [`Search failed: ${error instanceof Error ? error.message : 'Unknown error'}. Try using web_fetch with a specific URL instead.`];
+        }
+    }
+    extractLinks(html, baseUrl) {
+        try {
+            const $ = cheerio.load(html);
+            const links = [];
+            $('a[href]').each((_, element) => {
+                const href = $(element).attr('href');
+                if (href) {
+                    if (baseUrl && href.startsWith('/')) {
+                        links.push(new URL(href, baseUrl).toString());
+                    }
+                    else if (href.startsWith('http')) {
+                        links.push(href);
+                    }
+                }
+            });
+            return links;
+        }
+        catch (error) {
+            throw new Error(`Failed to extract links: ${error instanceof Error ? error.message : String(error)}`);
+        }
+    }
+    extractMetadata(html) {
+        try {
+            const $ = cheerio.load(html);
+            const metadata = {};
+            // Extract title
+            metadata.title = $('title').text().trim();
+            // Extract meta tags
+            $('meta').each((_, element) => {
+                const name = $(element).attr('name') || $(element).attr('property');
+                const content = $(element).attr('content');
+                if (name && content) {
+                    metadata[name] = content;
+                }
+            });
+            return metadata;
+        }
+        catch (error) {
+            throw new Error(`Failed to extract metadata: ${error instanceof Error ? error.message : String(error)}`);
+        }
+    }
+}
+//# sourceMappingURL=web-tools.js.map

package/dist/tools/web-tools.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"web-tools.js","sourceRoot":"","sources":["../../src/tools/web-tools.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,MAAM,OAAO,CAAA;AACzB,OAAO,KAAK,OAAO,MAAM,SAAS,CAAA;AASlC,MAAM,OAAO,QAAQ;IACF,SAAS,GAAG,2HAA2H,CAAA;IAChJ,iBAAiB,CAAoB;IAE7C,YAAY,iBAAoC;QAC9C,IAAI,CAAC,iBAAiB,GAAG,iBAAiB,CAAC;IAC7C,CAAC;IAED,KAAK,CAAC,KAAK,CAAC,GAAW;QACrB,mDAAmD;QACnD,MAAM,UAAU,GAAG,MAAM,IAAI,CAAC,iBAAiB,CAAC,iBAAiB,CAAC;YAChE,MAAM,EAAE,iBAAiB;YACzB,QAAQ,EAAE,GAAG;YACb,OAAO,EAAE,2BAA2B;SACrC,CAAC,CAAC;QAEH,IAAI,CAAC,UAAU,CAAC,OAAO,EAAE,CAAC;YACxB,MAAM,IAAI,KAAK,CAAC,mCAAmC,GAAG,EAAE,CAAC,CAAC;QAC5D,CAAC;QAED,IAAI,CAAC;YACH,MAAM,QAAQ,GAAG,MAAM,KAAK,CAAC,GAAG,CAAC,GAAG,EAAE;gBACpC,OAAO,EAAE;oBACP,YAAY,EAAE,IAAI,CAAC,SAAS;iBAC7B;gBACD,OAAO,EAAE,KAAK;aACf,CAAC,CAAA;YACF,OAAO,QAAQ,CAAC,IAAI,CAAA;QACtB,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,MAAM,IAAI,KAAK,CAAC,mBAAmB,GAAG,KAAK,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,EAAE,CAAC,CAAA;QACtG,CAAC;IACH,CAAC;IAED,KAAK,CAAC,SAAS,CAAC,GAAW;QACzB,IAAI,CAAC;YACH,MAAM,IAAI,GAAG,MAAM,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAA;YAClC,MAAM,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,CAAA;YAE5B,mCAAmC;YACnC,CAAC,CAAC,eAAe,CAAC,CAAC,MAAM,EAAE,CAAA;YAE3B,mBAAmB;YACnB,OAAO,CAAC,CAAC,MAAM,CAAC,CAAC,IAAI,EAAE,CAAC,OAAO,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC,IAAI,EAAE,CAAA;QACrD,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,MAAM,IAAI,KAAK,CAAC,+BAA+B,GAAG,KAAK,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,EAAE,CAAC,CAAA;QAClH,CAAC;IACH,CAAC;IAED,KAAK,CAAC,MAAM,CAAC,KAAa,EAAE,aAAqB,EAAE;QACjD,IAAI,CAAC;YACH,mDAAmD;YACnD,MAAM,SAAS,GAAG,uCAAuC,kBAAkB,CAAC,KAAK,CAAC,EAAE,CAAA;YAEpF,MAAM,QAAQ,GAAG,MAAM,KAAK,CAAC,GAAG,CAAC,SAAS,EAAE;gBAC1C,OAAO,EAAE;oBACP,YAAY,EAAE,2CAA2C;iBAC1D;gBACD,OAAO,EAAE,KAAK;aACf,CAAC,CAAA;YAEF,MAAM,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAA;YACrC,MAAM,OAAO,GAAa,EAAE,CAAA;YAE5B,8CAA8C;YAC9C,CAAC,CAAC,SAAS,CAAC,CAAC,IAAI,CAAC,CAAC,KAAK,EAAE,OAAO,EAAE,EAAE;gBACnC,IAAI,KAAK,IAAI,UAAU;oBAAE,OAAO,KAAK,CAAA;gBAErC,MAAM,OAAO,GAAG,CAAC,CAAC,OAAO,CAAC,CAAC,IAAI,CAAC,YAAY,CAAC,CAAA;gBAC7C,MAAM,SAAS,GAAG,CAAC,CAAC,OAAO,CAAC,CAAC,IAAI,CAAC,kBAAkB,CAAC,CAAA;gBACrD,MAAM,GAAG,GAAG,OAAO,CAAC,IAAI,CAAC,MAAM,CAAC,CAAA;gBAChC,MAAM,KAAK,GAAG,OAAO,CAAC,IAAI,EAAE,CAAC,IAAI,EAAE,CAAA;gBACnC,MAAM,OAAO,GAAG,SAAS,CAAC,IAAI,EAAE,CAAC,IAAI,EAAE,CAAA;gBAEvC,IAAI,KAAK,IAAI,OAAO,EAAE,CAAC;oBACrB,OAAO,CAAC,IAAI,CAAC,KAAK,KAAK,OAAO,OAAO,KAAK,GAAG,IAAI,EAAE,EAAE,CAAC,CAAA;gBACxD,CAAC;YACH,CAAC,CAAC,CAAA;YAEF,IAAI,OAAO,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;gBACzB,OAAO,CAAC,0BAA0B,KAAK,GAAG,CAAC,CAAA;YAC7C,CAAC;YAED,OAAO,OAAO,CAAA;QAChB,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,OAAO,CAAC,KAAK,CAAC,oBAAoB,EAAE,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,CAAA;YAC3F,OAAO,CAAC,kBAAkB,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,eAAe,oDAAoD,CAAC,CAAA;QACzI,CAAC;IACH,CAAC;IAED,YAAY,CAAC,IAAY,EAAE,OAAgB;QACzC,IAAI,CAAC;YACH,MAAM,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,CAAA;YAC5B,MAAM,KAAK,GAAa,EAAE,CAAA;YAE1B,CAAC,CAAC,SAAS,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,OAAO,EAAE,EAAE;gBAC/B,MAAM,IAAI,GAAG,CAAC,CAAC,OAAO,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC,CAAA;gBACpC,IAAI,IAAI,EAAE,CAAC;oBACT,IAAI,OAAO,IAAI,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,EAAE,CAAC;wBACpC,KAAK,CAAC,IAAI,CAAC,IAAI,GAAG,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC,QAAQ,EAAE,CAAC,CAAA;oBAC/C,CAAC;yBAAM,IAAI,IAAI,CAAC,UAAU,CAAC,MAAM,CAAC,EAAE,CAAC;wBACnC,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAA;oBAClB,CAAC;gBACH,CAAC;YACH,CAAC,CAAC,CAAA;YAEF,OAAO,KAAK,CAAA;QACd,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,MAAM,IAAI,KAAK,CAAC,4BAA4B,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,EAAE,CAAC,CAAA;QACvG,CAAC;IACH,CAAC;IAED,eAAe,CAAC,IAAY;QAC1B,IAAI,CAAC;YACH,MAAM,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,CAAA;YAC5B,MAAM,QAAQ,GAA2B,EAAE,CAAA;YAE3C,gBAAgB;YAChB,QAAQ,CAAC,KAAK,GAAG,CAAC,CAAC,OAAO,CAAC,CAAC,IAAI,EAAE,CAAC,IAAI,EAAE,CAAA;YAEzC,oBAAoB;YACpB,CAAC,CAAC,MAAM,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,OAAO,EAAE,EAAE;gBAC5B,MAAM,IAAI,GAAG,CAAC,CAAC,OAAO,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,OAAO,CAAC,CAAC,IAAI,CAAC,UAAU,CAAC,CAAA;gBACnE,MAAM,OAAO,GAAG,CAAC,CAAC,OAAO,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC,CAAA;gBAE1C,IAAI,IAAI,IAAI,OAAO,EAAE,CAAC;oBACpB,QAAQ,CAAC,IAAI,CAAC,GAAG,OAAO,CAAA;gBAC1B,CAAC;YACH,CAAC,CAAC,CAAA;YAEF,OAAO,QAAQ,CAAA;QACjB,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,MAAM,IAAI,KAAK,CAAC,+BAA+B,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,EAAE,CAAC,CAAA;QAC1G,CAAC;IACH,CAAC;CACF"}

package/dist/wiki-agent.d.ts

@@ -0,0 +1,81 @@
+import { PermissionManager } from './permissions.js';
+export interface WikiGenerationOptions {
+    repoUrl: string;
+    outputDir: string;
+    configPath?: string;
+    accessToken?: string;
+    model?: string;
+    targetPath?: string;
+    forceRegenerate?: boolean;
+    verbose?: boolean;
+}
+export interface WikiAgentConfig {
+    verbose?: boolean;
+    apiKey?: string;
+    permissionManager?: PermissionManager;
+    workingDir?: string;
+}
+export interface ProgressEvent {
+    type: 'phase' | 'step' | 'file' | 'complete' | 'error';
+    message: string;
+    detail?: string;
+    progress?: number;
+}
+export interface GenerationEstimate {
+    files: number;
+    estimatedChunks: number;
+    estimatedTokens: number;
+    estimatedCost: {
+        input: number;
+        output: number;
+        total: number;
+    };
+    estimatedTime: {
+        indexingMinutes: number;
+        generationMinutes: number;
+        totalMinutes: number;
+    };
+    breakdown: {
+        byExtension: Record<string, number>;
+        largestFiles: Array<{
+            path: string;
+            size: number;
+        }>;
+    };
+}
+export declare class ArchitecturalWikiAgent {
+    private config;
+    private permissionManager;
+    private mcpConfigManager;
+    private customServer;
+    private ragSystem;
+    private repoPath;
+    private outputDir;
+    private sessionId?;
+    constructor(config?: WikiAgentConfig);
+    /**
+     * Generate wiki documentation for a repository
+     */
+    generateWiki(options: WikiGenerationOptions): AsyncGenerator<ProgressEvent | any>;
+    /**
+     * Estimate generation time and cost without making API calls
+     */
+    estimateGeneration(options: WikiGenerationOptions): Promise<GenerationEstimate>;
+    /**
+     * Clone or access repository
+     */
+    private prepareRepository;
+    /**
+     * Build agent options with MCP servers
+     */
+    private buildAgentOptions;
+    /**
+     * Build the generation prompt
+     */
+    private buildGenerationPrompt;
+    /**
+     * Create custom MCP tool server for wiki-specific operations
+     */
+    private createCustomToolServer;
+}
+//# sourceMappingURL=wiki-agent.d.ts.map

package/dist/wiki-agent.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"wiki-agent.d.ts","sourceRoot":"","sources":["../src/wiki-agent.ts"],"names":[],"mappings":"AAMA,OAAO,EAAE,iBAAiB,EAAE,MAAM,kBAAkB,CAAC;AAKrD,MAAM,WAAW,qBAAqB;IACpC,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE,MAAM,CAAC;IAClB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,eAAe,CAAC,EAAE,OAAO,CAAC;IAC1B,OAAO,CAAC,EAAE,OAAO,CAAC;CACnB;AAED,MAAM,WAAW,eAAe;IAC9B,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,iBAAiB,CAAC,EAAE,iBAAiB,CAAC;IACtC,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED,MAAM,WAAW,aAAa;IAC5B,IAAI,EAAE,OAAO,GAAG,MAAM,GAAG,MAAM,GAAG,UAAU,GAAG,OAAO,CAAC;IACvD,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,kBAAkB;IACjC,KAAK,EAAE,MAAM,CAAC;IACd,eAAe,EAAE,MAAM,CAAC;IACxB,eAAe,EAAE,MAAM,CAAC;IACxB,aAAa,EAAE;QACb,KAAK,EAAE,MAAM,CAAC;QACd,MAAM,EAAE,MAAM,CAAC;QACf,KAAK,EAAE,MAAM,CAAC;KACf,CAAC;IACF,aAAa,EAAE;QACb,eAAe,EAAE,MAAM,CAAC;QACxB,iBAAiB,EAAE,MAAM,CAAC;QAC1B,YAAY,EAAE,MAAM,CAAC;KACtB,CAAC;IACF,SAAS,EAAE;QACT,WAAW,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;QACpC,YAAY,EAAE,KAAK,CAAC;YAAE,IAAI,EAAE,MAAM,CAAC;YAAC,IAAI,EAAE,MAAM,CAAA;SAAE,CAAC,CAAC;KACrD,CAAC;CACH;AAED,qBAAa,sBAAsB;IACjC,OAAO,CAAC,MAAM,CAAkB;IAChC,OAAO,CAAC,iBAAiB,CAAoB;IAC7C,OAAO,CAAC,gBAAgB,CAAmB;IAC3C,OAAO,CAAC,YAAY,CAAwC;IAC5D,OAAO,CAAC,SAAS,CAA0B;IAC3C,OAAO,CAAC,QAAQ,CAAc;IAC9B,OAAO,CAAC,SAAS,CAAc;IAC/B,OAAO,CAAC,SAAS,CAAC,CAAS;gBAEf,MAAM,GAAE,eAAoB;IAgBxC;;OAEG;IACI,YAAY,CACjB,OAAO,EAAE,qBAAqB,GAC7B,cAAc,CAAC,aAAa,GAAG,GAAG,CAAC;IAgEtC;;OAEG;IACG,kBAAkB,CAAC,OAAO,EAAE,qBAAqB,GAAG,OAAO,CAAC,kBAAkB,CAAC;IA0GrF;;OAEG;YACW,iBAAiB;IAmC/B;;OAEG;IACH,OAAO,CAAC,iBAAiB;IAsCzB;;OAEG;IACH,OAAO,CAAC,qBAAqB;IAqB7B;;OAEG;IACH,OAAO,CAAC,sBAAsB;CAkV/B"}