@frase/mcp-server 0.1.0

package/CHANGELOG.md

@@ -0,0 +1,44 @@
+# Changelog
+
+All notable changes to this project will be documented in this file.
+
+The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),
+and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
+
+## [0.1.0] - 2026-02-01
+
+### Added
+
+#### Tools (38 total)
+- **Sites**: `list_sites`
+- **Briefs**: `list_briefs`, `create_brief`, `get_brief`
+- **Content**: `list_content`, `get_content`
+- **Research**: `list_research`, `start_research`
+- **Jobs**: `get_job_status`
+- **Audits**: `list_audits`, `start_audit`, `get_audit`, `export_audit`
+- **SERP**: `analyze_serp`, `analyze_competitors`, `get_search_intent`
+- **AI Visibility**: `get_ai_visibility`, `list_prompts`, `create_prompt`, `get_prompt`, `update_prompt`, `get_competitors`, `get_alerts`, `get_insights`
+- **Analytics**: `get_gsc_overview`, `get_gsc_queries`, `get_gsc_pages`, `get_content_gaps`
+- **Optimizations**: `list_optimizations`, `start_optimization`, `get_optimization`, `apply_optimization`, `get_optimization_insights`
+- **Webhooks**: `list_webhooks`, `create_webhook`, `get_webhook`, `update_webhook`, `delete_webhook`
+
+#### Resources
+- `frase://sites` - List all sites
+- `frase://sites/{id}` - Individual site details
+- `frase://content` - List all content
+- `frase://content/{id}` - Individual content with body
+- `frase://briefs` - List all briefs
+- `frase://briefs/{id}` - Individual brief with outline
+
+#### Prompts
+- `create_seo_article` - Full SEO article creation workflow
+- `optimize_content` - Content optimization workflow
+- `keyword_research` - Keyword research workflow
+- `competitor_analysis` - Competitor analysis workflow
+- `content_audit` - Site content audit workflow
+
+#### Features
+- API client with retry logic and exponential backoff
+- Response caching (60s for lists, 5min for resources)
+- Markdown-formatted responses for better readability
+- Debug mode via `FRASE_MCP_DEBUG` environment variable

package/README.md

@@ -0,0 +1,262 @@
+# @frase/mcp-server
+
+[![npm version](https://img.shields.io/npm/v/@frase/mcp-server.svg)](https://www.npmjs.com/package/@frase/mcp-server)
+[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
+
+Use Claude Desktop to interact with your Frase account. This MCP (Model Context Protocol) server exposes Frase's API as tools that Claude can use to help you with SEO content creation, research, and optimization.
+
+## What is MCP?
+
+[Model Context Protocol (MCP)](https://modelcontextprotocol.io/) is an open standard that allows AI assistants like Claude to securely connect to external tools and data sources. This server implements MCP to give Claude access to your Frase account.
+
+## Quick Start
+
+### 1. Get your API key
+
+Get your API key from [Frase Settings](https://app.frase.io/settings/api).
+
+### 2. Configure Claude Desktop
+
+Add this to your Claude Desktop config file:
+
+**macOS:** `~/Library/Application Support/Claude/claude_desktop_config.json`
+**Windows:** `%APPDATA%\Claude\claude_desktop_config.json`
+
+```json
+{
+  "mcpServers": {
+    "frase": {
+      "command": "npx",
+      "args": ["-y", "@frase/mcp-server"],
+      "env": {
+        "FRASE_API_KEY": "sk_live_your_api_key_here"
+      }
+    }
+  }
+}
+```
+
+### 3. Restart Claude Desktop
+
+After saving the config, restart Claude Desktop. You should see "frase" in the MCP servers list.
+
+## Available Tools
+
+### Sites
+- `list_sites` - List all sites in your account
+
+### Briefs
+- `list_briefs` - List content briefs with optional status filter
+- `create_brief` - Create a new brief (with optional auto-outline generation)
+- `get_brief` - Get brief details including outline and SERP data
+
+### Content
+- `list_content` - List content items with optional status filter
+- `get_content` - Get content details including full body text
+
+### Research
+- `list_research` - List research sessions
+- `start_research` - Start new AI-powered research on a topic
+
+### Jobs
+- `get_job_status` - Check status of async jobs (briefs, research, audits, etc.)
+
+### Audits
+- `list_audits` - List site audits
+- `start_audit` - Start a new site audit
+- `get_audit` - Get audit details with pages and issues
+- `export_audit` - Export audit data as CSV
+
+### SERP Analysis
+- `analyze_serp` - Analyze search engine results for a query
+- `analyze_competitors` - Analyze competitor content for a query
+- `get_search_intent` - Get search intent classification for a query
+
+### AI Visibility
+- `get_ai_visibility` - Get AI visibility metrics for a site
+- `list_prompts` - List monitored AI prompts
+- `create_prompt` - Create a new monitored prompt
+- `get_prompt` - Get prompt details with citations
+- `update_prompt` - Update a monitored prompt
+- `get_competitors` - Get AI visibility competitors
+- `get_alerts` - Get AI visibility alerts
+- `get_insights` - Get AI visibility insights
+
+### Analytics
+- `get_gsc_overview` - Get Google Search Console overview metrics
+- `get_gsc_queries` - Get top search queries from GSC
+- `get_gsc_pages` - Get top performing pages from GSC
+- `get_content_gaps` - Get content gap opportunities
+
+### Optimizations
+- `list_optimizations` - List optimization sessions
+- `start_optimization` - Start optimization analysis for content
+- `get_optimization` - Get optimization details with suggestions
+- `apply_optimization` - Apply optimization suggestions
+- `get_optimization_insights` - Get optimization insights
+
+### Webhooks
+- `list_webhooks` - List configured webhooks
+- `create_webhook` - Create a new webhook
+- `get_webhook` - Get webhook details
+- `update_webhook` - Update a webhook
+- `delete_webhook` - Delete a webhook
+
+## Example Conversations
+
+### List your sites
+```
+You: What sites do I have connected?
+Claude: [Uses list_sites tool]
+
+Here are your connected sites:
+
+| Name | Domain | GSC | Created |
+|------|--------|-----|---------|
+| Main Blog | example.com | ✅ | Jan 15, 2024 |
+| Product Site | product.example.com | ❌ | Feb 20, 2024 |
+```
+
+### Create a brief with auto-outline
+```
+You: Create a brief about React performance optimization
+Claude: [Uses create_brief with generate_outline=true]
+
+## Brief Created
+
+- **ID:** abc123
+- **Topic:** React performance optimization
+- **Status:** pending
+
+**Outline generation started.** Let me check the status...
+
+[Uses get_job_status]
+
+The outline is ready! Let me get the details...
+
+[Uses get_brief]
+
+## Brief: React performance optimization
+
+### Outline
+- Introduction to React Performance
+- Common Performance Bottlenecks
+- Optimization Techniques
+- Measuring Performance
+- ...
+```
+
+### Research a topic
+```
+You: Research best practices for Next.js SEO
+Claude: [Uses start_research]
+
+## Research Started
+
+- **ID:** xyz789
+- **Query:** best practices for Next.js SEO
+- **Status:** pending
+
+I'll check on the progress...
+```
+
+## MCP Resources
+
+Browse your Frase data directly in Claude Desktop:
+
+- `frase://sites` - List all your sites
+- `frase://sites/{id}` - View individual site details
+- `frase://content` - List all content items
+- `frase://content/{id}` - View content with full body
+- `frase://briefs` - List all briefs
+- `frase://briefs/{id}` - View brief with outline
+
+## MCP Prompts
+
+Pre-built workflows for common SEO tasks:
+
+| Prompt | Description |
+|--------|-------------|
+| `create_seo_article` | Full workflow: research, brief, outline, content generation |
+| `optimize_content` | Analyze content and apply optimization suggestions |
+| `keyword_research` | Research keywords, SERP analysis, and content opportunities |
+| `competitor_analysis` | Analyze competitor content and find gaps |
+| `content_audit` | Run site audit and prioritize improvements |
+
+## Configuration
+
+| Variable | Required | Description |
+|----------|----------|-------------|
+| `FRASE_API_KEY` | Yes | Your Frase API key |
+| `FRASE_API_URL` | No | Override API URL (default: `https://next.frase.io/api/v1`) |
+| `FRASE_MCP_DEBUG` | No | Enable debug logging (`true`/`false`) |
+
+## Development
+
+```bash
+# Install dependencies
+npm install
+
+# Run in development mode
+npm run dev
+
+# Build
+npm run build
+
+# Run tests
+npm test
+
+# Run integration tests (requires FRASE_TEST_API_KEY)
+npm run test:integration
+```
+
+## Troubleshooting
+
+### Server not appearing in Claude Desktop
+
+1. Verify your config file location:
+   - **macOS:** `~/Library/Application Support/Claude/claude_desktop_config.json`
+   - **Windows:** `%APPDATA%\Claude\claude_desktop_config.json`
+
+2. Check JSON syntax - use a validator if needed
+
+3. Restart Claude Desktop completely (quit and reopen)
+
+### Authentication errors
+
+- Verify your API key is correct
+- Ensure the key has not expired
+- Check that the key has the required permissions
+
+### Debug mode
+
+Enable debug logging to see detailed information:
+
+```json
+{
+  "mcpServers": {
+    "frase": {
+      "command": "npx",
+      "args": ["-y", "@frase/mcp-server"],
+      "env": {
+        "FRASE_API_KEY": "your_key",
+        "FRASE_MCP_DEBUG": "true"
+      }
+    }
+  }
+}
+```
+
+### Rate limiting
+
+The server automatically retries on rate limits with exponential backoff. If you're hitting limits frequently, consider spacing out your requests.
+
+## Support
+
+- [Frase Documentation](https://docs.frase.io)
+- [API Documentation](https://docs.frase.io/api)
+- [GitHub Issues](https://github.com/frase-io/frase/issues)
+
+## License
+
+MIT

package/dist/api-client.d.ts

@@ -0,0 +1,93 @@
+/**
+ * Frase API Client with retry logic and caching
+ */
+import type { Config } from "./config.js";
+/**
+ * API Error class
+ */
+export declare class FraseApiError extends Error {
+    readonly status: number;
+    readonly code: string;
+    readonly details?: unknown | undefined;
+    constructor(status: number, code: string, message: string, details?: unknown | undefined);
+    /**
+     * Check if this error is retryable
+     */
+    get isRetryable(): boolean;
+    /**
+     * Format error for display
+     */
+    toMarkdown(): string;
+}
+/**
+ * Paginated response structure
+ */
+export interface PaginatedResponse<T> {
+    data: T[];
+    pagination: {
+        page: number;
+        page_size: number;
+        total: number;
+        has_more: boolean;
+    };
+}
+/**
+ * API response structure
+ */
+export interface ApiResponse<T> {
+    data: T;
+    request_id: string;
+}
+/**
+ * Frase API Client
+ */
+export declare class FraseApiClient {
+    private config;
+    private cache;
+    constructor(config: Config);
+    /**
+     * Sleep for a specified duration
+     */
+    private sleep;
+    /**
+     * Calculate retry delay with exponential backoff
+     */
+    private getRetryDelay;
+    /**
+     * Make an HTTP request with retry logic
+     */
+    request<T>(method: string, path: string, options?: {
+        body?: unknown;
+        params?: Record<string, string | number | boolean | undefined>;
+        cacheTtl?: number;
+    }): Promise<T>;
+    /**
+     * GET request
+     */
+    get<T>(path: string, params?: Record<string, string | number | boolean | undefined>, cacheTtl?: number): Promise<T>;
+    /**
+     * POST request
+     */
+    post<T>(path: string, body: unknown): Promise<T>;
+    /**
+     * PUT request
+     */
+    put<T>(path: string, body: unknown): Promise<T>;
+    /**
+     * PATCH request
+     */
+    patch<T>(path: string, body: unknown): Promise<T>;
+    /**
+     * DELETE request
+     */
+    delete<T>(path: string): Promise<T>;
+    /**
+     * Clear all cached data
+     */
+    clearCache(): void;
+    /**
+     * Destroy the client (for graceful shutdown)
+     */
+    destroy(): void;
+}
+//# sourceMappingURL=api-client.d.ts.map

package/dist/api-client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"api-client.d.ts","sourceRoot":"","sources":["../src/api-client.ts"],"names":[],"mappings":"AAAA;;GAEG;AAGH,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AAa1C;;GAEG;AACH,qBAAa,aAAc,SAAQ,KAAK;aAEpB,MAAM,EAAE,MAAM;aACd,IAAI,EAAE,MAAM;aAEZ,OAAO,CAAC,EAAE,OAAO;gBAHjB,MAAM,EAAE,MAAM,EACd,IAAI,EAAE,MAAM,EAC5B,OAAO,EAAE,MAAM,EACC,OAAO,CAAC,EAAE,OAAO,YAAA;IAMnC;;OAEG;IACH,IAAI,WAAW,IAAI,OAAO,CAEzB;IAED;;OAEG;IACH,UAAU,IAAI,MAAM;CAWrB;AAED;;GAEG;AACH,MAAM,WAAW,iBAAiB,CAAC,CAAC;IAClC,IAAI,EAAE,CAAC,EAAE,CAAC;IACV,UAAU,EAAE;QACV,IAAI,EAAE,MAAM,CAAC;QACb,SAAS,EAAE,MAAM,CAAC;QAClB,KAAK,EAAE,MAAM,CAAC;QACd,QAAQ,EAAE,OAAO,CAAC;KACnB,CAAC;CACH;AAED;;GAEG;AACH,MAAM,WAAW,WAAW,CAAC,CAAC;IAC5B,IAAI,EAAE,CAAC,CAAC;IACR,UAAU,EAAE,MAAM,CAAC;CACpB;AAED;;GAEG;AACH,qBAAa,cAAc;IAGb,OAAO,CAAC,MAAM;IAF1B,OAAO,CAAC,KAAK,CAAgB;gBAET,MAAM,EAAE,MAAM;IAIlC;;OAEG;IACH,OAAO,CAAC,KAAK;IAIb;;OAEG;IACH,OAAO,CAAC,aAAa;IAarB;;OAEG;IACG,OAAO,CAAC,CAAC,EACb,MAAM,EAAE,MAAM,EACd,IAAI,EAAE,MAAM,EACZ,OAAO,CAAC,EAAE;QACR,IAAI,CAAC,EAAE,OAAO,CAAC;QACf,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,GAAG,OAAO,GAAG,SAAS,CAAC,CAAC;QAC/D,QAAQ,CAAC,EAAE,MAAM,CAAC;KACnB,GACA,OAAO,CAAC,CAAC,CAAC;IAiHb;;OAEG;IACH,GAAG,CAAC,CAAC,EACH,IAAI,EAAE,MAAM,EACZ,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,GAAG,OAAO,GAAG,SAAS,CAAC,EAC9D,QAAQ,CAAC,EAAE,MAAM,GAChB,OAAO,CAAC,CAAC,CAAC;IAIb;;OAEG;IACH,IAAI,CAAC,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,OAAO,GAAG,OAAO,CAAC,CAAC,CAAC;IAIhD;;OAEG;IACH,GAAG,CAAC,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,OAAO,GAAG,OAAO,CAAC,CAAC,CAAC;IAI/C;;OAEG;IACH,KAAK,CAAC,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,OAAO,GAAG,OAAO,CAAC,CAAC,CAAC;IAIjD;;OAEG;IACH,MAAM,CAAC,CAAC,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,CAAC,CAAC;IAInC;;OAEG;IACH,UAAU,IAAI,IAAI;IAIlB;;OAEG;IACH,OAAO,IAAI,IAAI;CAGhB"}

package/dist/api-client.js

@@ -0,0 +1,213 @@
+/**
+ * Frase API Client with retry logic and caching
+ */
+import { ResponseCache } from "./cache.js";
+import { debugLog } from "./config.js";
+/**
+ * Retry configuration
+ */
+const RETRY_CONFIG = {
+    maxRetries: 2,
+    baseDelayMs: 1000,
+    maxDelayMs: 10000,
+    retryableStatuses: [429, 500, 502, 503, 504],
+};
+/**
+ * API Error class
+ */
+export class FraseApiError extends Error {
+    status;
+    code;
+    details;
+    constructor(status, code, message, details) {
+        super(message);
+        this.status = status;
+        this.code = code;
+        this.details = details;
+        this.name = "FraseApiError";
+    }
+    /**
+     * Check if this error is retryable
+     */
+    get isRetryable() {
+        return RETRY_CONFIG.retryableStatuses.includes(this.status);
+    }
+    /**
+     * Format error for display
+     */
+    toMarkdown() {
+        let md = `**Error:** ${this.message}\n`;
+        md += `- Code: \`${this.code}\`\n`;
+        md += `- Status: ${this.status}\n`;
+        if (this.details) {
+            md += `- Details: ${JSON.stringify(this.details)}\n`;
+        }
+        return md;
+    }
+}
+/**
+ * Frase API Client
+ */
+export class FraseApiClient {
+    config;
+    cache;
+    constructor(config) {
+        this.config = config;
+        this.cache = new ResponseCache();
+    }
+    /**
+     * Sleep for a specified duration
+     */
+    sleep(ms) {
+        return new Promise((resolve) => setTimeout(resolve, ms));
+    }
+    /**
+     * Calculate retry delay with exponential backoff
+     */
+    getRetryDelay(attempt, retryAfter) {
+        if (retryAfter) {
+            const seconds = parseInt(retryAfter, 10);
+            if (!isNaN(seconds)) {
+                return Math.min(seconds * 1000, RETRY_CONFIG.maxDelayMs);
+            }
+        }
+        // Exponential backoff: 1s, 2s, 4s... capped at maxDelayMs
+        const delay = RETRY_CONFIG.baseDelayMs * Math.pow(2, attempt);
+        return Math.min(delay, RETRY_CONFIG.maxDelayMs);
+    }
+    /**
+     * Make an HTTP request with retry logic
+     */
+    async request(method, path, options) {
+        const { body, params, cacheTtl } = options || {};
+        // Build URL with query params
+        let url = `${this.config.apiUrl}${path}`;
+        if (params) {
+            const searchParams = new URLSearchParams();
+            for (const [key, value] of Object.entries(params)) {
+                if (value !== undefined) {
+                    searchParams.set(key, String(value));
+                }
+            }
+            const queryString = searchParams.toString();
+            if (queryString) {
+                url += `?${queryString}`;
+            }
+        }
+        // Check cache for GET requests
+        if (method === "GET" && cacheTtl) {
+            const cacheKey = ResponseCache.key(method, path, params);
+            const cached = this.cache.get(cacheKey);
+            if (cached) {
+                debugLog(this.config, `Cache hit: ${path}`);
+                return cached;
+            }
+        }
+        let lastError = null;
+        for (let attempt = 0; attempt <= RETRY_CONFIG.maxRetries; attempt++) {
+            try {
+                debugLog(this.config, `Request: ${method} ${path} (attempt ${attempt + 1})`);
+                const response = await fetch(url, {
+                    method,
+                    headers: {
+                        "Content-Type": "application/json",
+                        "X-API-KEY": this.config.apiKey,
+                        "User-Agent": "frase-mcp-server/0.1.0",
+                    },
+                    body: body ? JSON.stringify(body) : undefined,
+                });
+                if (!response.ok) {
+                    let errorData = {};
+                    try {
+                        errorData = await response.json();
+                    }
+                    catch {
+                        // Ignore JSON parse errors
+                    }
+                    const error = new FraseApiError(response.status, errorData.error?.code || `http_${response.status}`, errorData.error?.message || `HTTP ${response.status}`, errorData);
+                    // Check if we should retry
+                    if (attempt < RETRY_CONFIG.maxRetries && error.isRetryable) {
+                        const delay = this.getRetryDelay(attempt, response.headers.get("Retry-After") || undefined);
+                        debugLog(this.config, `Retrying in ${delay}ms...`);
+                        await this.sleep(delay);
+                        continue;
+                    }
+                    throw error;
+                }
+                const data = (await response.json());
+                // Cache successful GET responses
+                if (method === "GET" && cacheTtl) {
+                    const cacheKey = ResponseCache.key(method, path, params);
+                    this.cache.set(cacheKey, data, cacheTtl);
+                }
+                // Invalidate cache on write operations
+                if (method !== "GET") {
+                    const resourceType = path.split("/")[1]; // e.g., /sites -> sites
+                    if (resourceType) {
+                        this.cache.invalidateResourceType(resourceType);
+                    }
+                }
+                return data;
+            }
+            catch (error) {
+                lastError = error;
+                // Don't retry FraseApiError unless it's retryable
+                if (error instanceof FraseApiError && !error.isRetryable) {
+                    throw error;
+                }
+                // Network errors - retry if we have attempts left
+                if (attempt < RETRY_CONFIG.maxRetries && !(error instanceof FraseApiError)) {
+                    const delay = this.getRetryDelay(attempt);
+                    debugLog(this.config, `Network error, retrying in ${delay}ms...`);
+                    await this.sleep(delay);
+                    continue;
+                }
+                throw error;
+            }
+        }
+        throw lastError || new Error("Request failed after retries");
+    }
+    /**
+     * GET request
+     */
+    get(path, params, cacheTtl) {
+        return this.request("GET", path, { params, cacheTtl });
+    }
+    /**
+     * POST request
+     */
+    post(path, body) {
+        return this.request("POST", path, { body });
+    }
+    /**
+     * PUT request
+     */
+    put(path, body) {
+        return this.request("PUT", path, { body });
+    }
+    /**
+     * PATCH request
+     */
+    patch(path, body) {
+        return this.request("PATCH", path, { body });
+    }
+    /**
+     * DELETE request
+     */
+    delete(path) {
+        return this.request("DELETE", path);
+    }
+    /**
+     * Clear all cached data
+     */
+    clearCache() {
+        this.cache.clear();
+    }
+    /**
+     * Destroy the client (for graceful shutdown)
+     */
+    destroy() {
+        this.cache.destroy();
+    }
+}
+//# sourceMappingURL=api-client.js.map

package/dist/api-client.js.map

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

package/dist/cache.d.ts

@@ -0,0 +1,52 @@
+/**
+ * Simple in-memory cache for GET responses
+ */
+/**
+ * Cache TTL configuration (in milliseconds)
+ */
+export declare const CACHE_TTL: {
+    readonly lists: 60000;
+    readonly resources: 300000;
+};
+/**
+ * Simple cache implementation
+ */
+export declare class ResponseCache {
+    private cache;
+    private cleanupInterval;
+    constructor();
+    /**
+     * Get a cached value
+     */
+    get<T>(key: string): T | undefined;
+    /**
+     * Set a cached value
+     */
+    set<T>(key: string, data: T, ttl: number): void;
+    /**
+     * Generate cache key for a request
+     */
+    static key(method: string, path: string, params?: Record<string, unknown>): string;
+    /**
+     * Invalidate cache entries matching a pattern
+     */
+    invalidate(pattern: string | RegExp): void;
+    /**
+     * Invalidate all cache entries for a resource type
+     * Called after write operations
+     */
+    invalidateResourceType(resourceType: string): void;
+    /**
+     * Clear all cached entries
+     */
+    clear(): void;
+    /**
+     * Clean up expired entries
+     */
+    private cleanup;
+    /**
+     * Stop the cleanup interval (for graceful shutdown)
+     */
+    destroy(): void;
+}
+//# sourceMappingURL=cache.d.ts.map

package/dist/cache.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cache.d.ts","sourceRoot":"","sources":["../src/cache.ts"],"names":[],"mappings":"AAAA;;GAEG;AAOH;;GAEG;AACH,eAAO,MAAM,SAAS;;;CAGZ,CAAC;AAEX;;GAEG;AACH,qBAAa,aAAa;IACxB,OAAO,CAAC,KAAK,CAA0C;IACvD,OAAO,CAAC,eAAe,CAA+B;;IAOtD;;OAEG;IACH,GAAG,CAAC,CAAC,EAAE,GAAG,EAAE,MAAM,GAAG,CAAC,GAAG,SAAS;IAelC;;OAEG;IACH,GAAG,CAAC,CAAC,EAAE,GAAG,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC,EAAE,GAAG,EAAE,MAAM,GAAG,IAAI;IAO/C;;OAEG;IACH,MAAM,CAAC,GAAG,CAAC,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,MAAM;IAKlF;;OAEG;IACH,UAAU,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI;IAU1C;;;OAGG;IACH,sBAAsB,CAAC,YAAY,EAAE,MAAM,GAAG,IAAI;IAIlD;;OAEG;IACH,KAAK,IAAI,IAAI;IAIb;;OAEG;IACH,OAAO,CAAC,OAAO;IAUf;;OAEG;IACH,OAAO,IAAI,IAAI;CAOhB"}