@gulibs/safe-coder 0.0.25 → 0.0.27

package/dist/server/safe-coder-mcp.js

@@ -0,0 +1,164 @@
+#!/usr/bin/env node
+import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+import { StdioServerTransport } from '@modelcontextprotocol/sdk/server/stdio.js';
+import { crawlDocumentation, CrawlDocumentationSchema, listCachedDocumentation, clearCache, ClearCacheSchema, saveSkill, SaveSkillSchema, } from '../tools/index.js';
+/**
+ * Safe Coder MCP Server
+ * Orchestrates safe-coder-cli for documentation crawling and SKILL generation
+ */
+export class SafeCoderMCPServer {
+    server;
+    constructor() {
+        this.server = new McpServer({
+            name: 'safe-coder',
+            version: '1.0.0',
+        });
+        this.setupTools();
+    }
+    /**
+     * Register MCP tools
+     */
+    setupTools() {
+        // Register crawl_documentation tool
+        this.server.registerTool('crawl_documentation', {
+            title: 'Crawl Documentation',
+            description: 'Crawl documentation website and generate SKILL file guidance. This tool calls safe-coder-cli to perform the actual crawling, then processes the results and provides guidance for SKILL generation. Requires safe-coder-cli to be installed globally. Parameters: url (required), maxPages (optional, default 200), depth (optional, default 3), workers (optional), useBrowser (optional), browser (optional: puppeteer/playwright), spaStrategy (optional: smart/auto/manual), useCache (optional, default true), forceRefresh (optional, default false).',
+            inputSchema: CrawlDocumentationSchema,
+        }, async (args) => {
+            try {
+                const result = await crawlDocumentation(args);
+                return {
+                    content: [
+                        {
+                            type: 'text',
+                            text: JSON.stringify(result, null, 2),
+                        },
+                    ],
+                };
+            }
+            catch (error) {
+                const errorMessage = error instanceof Error ? error.message : String(error);
+                return {
+                    content: [
+                        {
+                            type: 'text',
+                            text: JSON.stringify({
+                                success: false,
+                                error: errorMessage,
+                            }, null, 2),
+                        },
+                    ],
+                    isError: true,
+                };
+            }
+        });
+        // Register list_cached_documentation tool
+        this.server.registerTool('list_cached_documentation', {
+            title: 'List Cached Documentation',
+            description: 'List all cached documentation crawl results with metadata. No parameters required.',
+            inputSchema: {},
+        }, async () => {
+            try {
+                const result = await listCachedDocumentation();
+                return {
+                    content: [
+                        {
+                            type: 'text',
+                            text: JSON.stringify(result, null, 2),
+                        },
+                    ],
+                };
+            }
+            catch (error) {
+                const errorMessage = error instanceof Error ? error.message : String(error);
+                return {
+                    content: [
+                        {
+                            type: 'text',
+                            text: JSON.stringify({
+                                success: false,
+                                error: errorMessage,
+                            }, null, 2),
+                        },
+                    ],
+                    isError: true,
+                };
+            }
+        });
+        // Register clear_cache tool
+        this.server.registerTool('clear_cache', {
+            title: 'Clear Cache',
+            description: 'Clear cached documentation results. Parameters: urlPattern (optional string) - URL pattern to match, clearAll (optional boolean) - clear all entries. If no parameters, clears only expired entries.',
+            inputSchema: ClearCacheSchema,
+        }, async (args) => {
+            try {
+                const result = await clearCache(args || {});
+                return {
+                    content: [
+                        {
+                            type: 'text',
+                            text: JSON.stringify(result, null, 2),
+                        },
+                    ],
+                };
+            }
+            catch (error) {
+                const errorMessage = error instanceof Error ? error.message : String(error);
+                return {
+                    content: [
+                        {
+                            type: 'text',
+                            text: JSON.stringify({
+                                success: false,
+                                error: errorMessage,
+                            }, null, 2),
+                        },
+                    ],
+                    isError: true,
+                };
+            }
+        });
+        // Register save_skill tool
+        this.server.registerTool('save_skill', {
+            title: 'Save SKILL Files',
+            description: 'Save complete SKILL directory structure (SKILL.md + references/) to filesystem. Creates a properly formatted Cursor Agent Skill with all reference documentation organized by category. Parameters: skillName (required string) - name for skill directory, skillContent (required string) - SKILL.md content, referenceFiles (optional object) - map of category -> markdown content, baseDirectory (optional string, default ~/.claude/skills) - base directory for skills, overwrite (optional boolean, default false) - overwrite existing skill.',
+            inputSchema: SaveSkillSchema,
+        }, async (args) => {
+            try {
+                const result = await saveSkill(args);
+                return {
+                    content: [
+                        {
+                            type: 'text',
+                            text: JSON.stringify(result, null, 2),
+                        },
+                    ],
+                };
+            }
+            catch (error) {
+                const errorMessage = error instanceof Error ? error.message : String(error);
+                return {
+                    content: [
+                        {
+                            type: 'text',
+                            text: JSON.stringify({
+                                success: false,
+                                error: errorMessage,
+                            }, null, 2),
+                        },
+                    ],
+                    isError: true,
+                };
+            }
+        });
+    }
+    /**
+     * Start the MCP server
+     */
+    async run() {
+        const transport = new StdioServerTransport();
+        await this.server.connect(transport);
+        console.error('Safe Coder MCP Server running on stdio');
+    }
+}
+//# sourceMappingURL=safe-coder-mcp.js.map

package/dist/server/safe-coder-mcp.js.map

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

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

@@ -0,0 +1,42 @@
+import { z } from 'zod';
+/**
+ * List cached documentation schema
+ */
+export declare const ListCachedDocumentationSchema: z.ZodObject<{}, "strip", z.ZodTypeAny, {}, {}>;
+/**
+ * Clear cache schema
+ */
+export declare const ClearCacheSchema: z.ZodObject<{
+    urlPattern: z.ZodOptional<z.ZodString>;
+    clearAll: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
+}, "strip", z.ZodTypeAny, {
+    clearAll: boolean;
+    urlPattern?: string | undefined;
+}, {
+    urlPattern?: string | undefined;
+    clearAll?: boolean | undefined;
+}>;
+export type ClearCacheInput = z.infer<typeof ClearCacheSchema>;
+/**
+ * List cached documentation
+ */
+export declare function listCachedDocumentation(): Promise<{
+    success: boolean;
+    entries: import("../cache/cache-manager.js").CacheEntry[];
+    statistics: {
+        totalEntries: number;
+        totalSize: string;
+        oldestEntry: string | undefined;
+        newestEntry: string | undefined;
+    };
+    message: string;
+}>;
+/**
+ * Clear cache
+ */
+export declare function clearCache(input: ClearCacheInput): Promise<{
+    success: boolean;
+    deletedCount: number;
+    message: string;
+}>;
+//# sourceMappingURL=cache-tools.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"cache-tools.d.ts","sourceRoot":"","sources":["../../src/tools/cache-tools.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAGxB;;GAEG;AACH,eAAO,MAAM,6BAA6B,gDAAe,CAAC;AAE1D;;GAEG;AACH,eAAO,MAAM,gBAAgB;;;;;;;;;EAG3B,CAAC;AAEH,MAAM,MAAM,eAAe,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,gBAAgB,CAAC,CAAC;AAE/D;;GAEG;AACH,wBAAsB,uBAAuB;;;;;;;;;;GAiB5C;AAED;;GAEG;AACH,wBAAsB,UAAU,CAAC,KAAK,EAAE,eAAe;;;;GAuBtD"}

package/dist/tools/cache-tools.js

@@ -0,0 +1,70 @@
+import { z } from 'zod';
+import { CacheManager } from '../cache/cache-manager.js';
+/**
+ * List cached documentation schema
+ */
+export const ListCachedDocumentationSchema = z.object({});
+/**
+ * Clear cache schema
+ */
+export const ClearCacheSchema = z.object({
+    urlPattern: z.string().optional().describe('URL pattern to match for deletion (optional)'),
+    clearAll: z.boolean().optional().default(false).describe('Clear all cached entries'),
+});
+/**
+ * List cached documentation
+ */
+export async function listCachedDocumentation() {
+    const cache = new CacheManager();
+    const entries = await cache.list();
+    const stats = await cache.getStats();
+    return {
+        success: true,
+        entries,
+        statistics: {
+            totalEntries: stats.totalEntries,
+            totalSize: formatBytes(stats.totalSize),
+            oldestEntry: stats.oldestEntry?.toISOString(),
+            newestEntry: stats.newestEntry?.toISOString(),
+        },
+        message: `Found ${entries.length} cached documentation${entries.length !== 1 ? 's' : ''}`,
+    };
+}
+/**
+ * Clear cache
+ */
+export async function clearCache(input) {
+    const cache = new CacheManager();
+    let deletedCount;
+    let message;
+    if (input.clearAll) {
+        deletedCount = await cache.clear();
+        message = `Cleared all cache: deleted ${deletedCount} entry${deletedCount !== 1 ? 'ies' : 'y'}`;
+    }
+    else if (input.urlPattern) {
+        deletedCount = await cache.clear(input.urlPattern);
+        message = `Cleared cache matching "${input.urlPattern}": deleted ${deletedCount} entry${deletedCount !== 1 ? 'ies' : 'y'}`;
+    }
+    else {
+        // Clear expired only
+        deletedCount = await cache.clearExpired();
+        message = `Cleared expired cache: deleted ${deletedCount} entry${deletedCount !== 1 ? 'ies' : 'y'}`;
+    }
+    return {
+        success: true,
+        deletedCount,
+        message,
+    };
+}
+/**
+ * Format bytes to human-readable format
+ */
+function formatBytes(bytes) {
+    if (bytes === 0)
+        return '0 Bytes';
+    const k = 1024;
+    const sizes = ['Bytes', 'KB', 'MB', 'GB'];
+    const i = Math.floor(Math.log(bytes) / Math.log(k));
+    return `${Math.round(bytes / Math.pow(k, i) * 100) / 100} ${sizes[i]}`;
+}
+//# sourceMappingURL=cache-tools.js.map

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

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

package/dist/tools/crawl-documentation.d.ts

@@ -0,0 +1,57 @@
+import { z } from 'zod';
+/**
+ * Input schema for crawl_documentation tool
+ */
+export declare const CrawlDocumentationSchema: z.ZodObject<{
+    url: z.ZodString;
+    maxPages: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
+    depth: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
+    workers: z.ZodOptional<z.ZodNumber>;
+    useBrowser: z.ZodOptional<z.ZodBoolean>;
+    browser: z.ZodOptional<z.ZodEnum<["puppeteer", "playwright"]>>;
+    spaStrategy: z.ZodOptional<z.ZodEnum<["smart", "auto", "manual"]>>;
+    useCache: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
+    forceRefresh: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
+}, "strip", z.ZodTypeAny, {
+    url: string;
+    maxPages: number;
+    depth: number;
+    useCache: boolean;
+    forceRefresh: boolean;
+    workers?: number | undefined;
+    useBrowser?: boolean | undefined;
+    browser?: "puppeteer" | "playwright" | undefined;
+    spaStrategy?: "smart" | "auto" | "manual" | undefined;
+}, {
+    url: string;
+    maxPages?: number | undefined;
+    depth?: number | undefined;
+    workers?: number | undefined;
+    useBrowser?: boolean | undefined;
+    browser?: "puppeteer" | "playwright" | undefined;
+    spaStrategy?: "smart" | "auto" | "manual" | undefined;
+    useCache?: boolean | undefined;
+    forceRefresh?: boolean | undefined;
+}>;
+export type CrawlDocumentationInput = z.infer<typeof CrawlDocumentationSchema>;
+/**
+ * Crawl documentation tool handler
+ */
+export declare function crawlDocumentation(input: CrawlDocumentationInput): Promise<{
+    success: boolean;
+    data: import("../processor/content-processor.js").ProcessedContent;
+    skillGenerationGuide: import("../processor/guide-generator.js").SkillGenerationGuide;
+    fromCache: boolean;
+    cacheAge: string;
+    message: string;
+    rawCrawlResult?: undefined;
+} | {
+    success: boolean;
+    data: import("../processor/content-processor.js").ProcessedContent;
+    rawCrawlResult: import("../executor/cli-executor.js").CrawlResult;
+    skillGenerationGuide: import("../processor/guide-generator.js").SkillGenerationGuide;
+    fromCache: boolean;
+    message: string;
+    cacheAge?: undefined;
+}>;
+//# sourceMappingURL=crawl-documentation.d.ts.map

package/dist/tools/crawl-documentation.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"crawl-documentation.d.ts","sourceRoot":"","sources":["../../src/tools/crawl-documentation.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAOxB;;GAEG;AACH,eAAO,MAAM,wBAAwB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAUnC,CAAC;AAEH,MAAM,MAAM,uBAAuB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,wBAAwB,CAAC,CAAC;AAE/E;;GAEG;AACH,wBAAsB,kBAAkB,CAAC,KAAK,EAAE,uBAAuB;;;;;;;;;;;;;;;;GA+EtE"}

package/dist/tools/crawl-documentation.js

@@ -0,0 +1,96 @@
+import { z } from 'zod';
+import { DependencyChecker } from '../executor/dependency-checker.js';
+import { CLIExecutor } from '../executor/cli-executor.js';
+import { ContentProcessor } from '../processor/content-processor.js';
+import { GuideGenerator } from '../processor/guide-generator.js';
+import { CacheManager } from '../cache/cache-manager.js';
+/**
+ * Input schema for crawl_documentation tool
+ */
+export const CrawlDocumentationSchema = z.object({
+    url: z.string().url().describe('Documentation URL to crawl'),
+    maxPages: z.number().optional().default(200).describe('Maximum number of pages to crawl'),
+    depth: z.number().optional().default(3).describe('Maximum crawl depth'),
+    workers: z.number().optional().describe('Number of parallel workers'),
+    useBrowser: z.boolean().optional().describe('Force browser automation'),
+    browser: z.enum(['puppeteer', 'playwright']).optional().describe('Browser type to use'),
+    spaStrategy: z.enum(['smart', 'auto', 'manual']).optional().describe('SPA crawling strategy'),
+    useCache: z.boolean().optional().default(true).describe('Use cached results if available'),
+    forceRefresh: z.boolean().optional().default(false).describe('Force refresh even if cached'),
+});
+/**
+ * Crawl documentation tool handler
+ */
+export async function crawlDocumentation(input) {
+    const checker = new DependencyChecker();
+    const executor = new CLIExecutor(checker);
+    const processor = new ContentProcessor();
+    const guideGenerator = new GuideGenerator();
+    const cache = new CacheManager();
+    // 1. Check if CLI is installed
+    const cliCheck = await checker.checkCLIInstalled();
+    if (!cliCheck.installed) {
+        throw new Error(cliCheck.message);
+    }
+    // 2. Check cache (if enabled and not forcing refresh)
+    if (input.useCache && !input.forceRefresh) {
+        const cached = await cache.get(input.url);
+        if (cached) {
+            const ageMinutes = Math.floor((Date.now() - cached.timestamp) / 1000 / 60);
+            return {
+                success: true,
+                data: cached.data,
+                skillGenerationGuide: cached.guide,
+                fromCache: true,
+                cacheAge: `${ageMinutes} minutes`,
+                message: `Using cached data from ${ageMinutes} minutes ago. Use forceRefresh: true to re-crawl.`,
+            };
+        }
+    }
+    // 3. Prepare crawl parameters
+    const crawlParams = {
+        url: input.url,
+        maxPages: input.maxPages,
+        maxDepth: input.depth,
+        workers: input.workers,
+        useBrowser: input.useBrowser,
+        browser: input.browser,
+        spaStrategy: input.spaStrategy,
+    };
+    // 4. Execute crawl with progress reporting
+    let lastProgress = '';
+    const rawResult = await executor.executeCrawl(crawlParams, (progress) => {
+        // Log progress to stderr (visible in MCP client logs)
+        if (progress.message !== lastProgress) {
+            console.error(`[Progress] ${progress.message}`);
+            lastProgress = progress.message;
+        }
+    });
+    // 5. Process content
+    console.error('[Processing] Analyzing crawled content...');
+    const processed = await processor.process(rawResult);
+    // 6. Generate SKILL guidance
+    console.error('[Processing] Generating SKILL generation guide...');
+    const guide = guideGenerator.generate(processed);
+    // 7. Cache results
+    if (input.useCache) {
+        try {
+            await cache.set(input.url, processed, guide);
+            console.error('[Cache] Results cached successfully');
+        }
+        catch (error) {
+            console.error('[Cache] Warning: Failed to cache results:', error);
+            // Don't fail the entire operation if caching fails
+        }
+    }
+    // 8. Return results with raw crawl data for file saving
+    return {
+        success: true,
+        data: processed,
+        rawCrawlResult: rawResult, // Include raw result for skill file generation
+        skillGenerationGuide: guide,
+        fromCache: false,
+        message: `Successfully crawled ${processed.statistics.totalPages} pages. Quality score: ${guide.quality.overall}/100`,
+    };
+}
+//# sourceMappingURL=crawl-documentation.js.map

package/dist/tools/crawl-documentation.js.map

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

package/dist/tools/index.d.ts

@@ -0,0 +1,4 @@
+export { crawlDocumentation, CrawlDocumentationSchema, type CrawlDocumentationInput, } from './crawl-documentation.js';
+export { listCachedDocumentation, clearCache, ListCachedDocumentationSchema, ClearCacheSchema, type ClearCacheInput, } from './cache-tools.js';
+export { saveSkill, SaveSkillSchema, type SaveSkillInput, type SaveSkillResult, extractSkillDataFromCrawlResult, } from './save-skill.js';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/tools/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,kBAAkB,EAClB,wBAAwB,EACxB,KAAK,uBAAuB,GAC7B,MAAM,0BAA0B,CAAC;AAElC,OAAO,EACL,uBAAuB,EACvB,UAAU,EACV,6BAA6B,EAC7B,gBAAgB,EAChB,KAAK,eAAe,GACrB,MAAM,kBAAkB,CAAC;AAE1B,OAAO,EACL,SAAS,EACT,eAAe,EACf,KAAK,cAAc,EACnB,KAAK,eAAe,EACpB,+BAA+B,GAChC,MAAM,iBAAiB,CAAC"}

package/dist/tools/index.js

@@ -0,0 +1,4 @@
+export { crawlDocumentation, CrawlDocumentationSchema, } from './crawl-documentation.js';
+export { listCachedDocumentation, clearCache, ListCachedDocumentationSchema, ClearCacheSchema, } from './cache-tools.js';
+export { saveSkill, SaveSkillSchema, extractSkillDataFromCrawlResult, } from './save-skill.js';
+//# sourceMappingURL=index.js.map

package/dist/tools/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/tools/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,kBAAkB,EAClB,wBAAwB,GAEzB,MAAM,0BAA0B,CAAC;AAElC,OAAO,EACL,uBAAuB,EACvB,UAAU,EACV,6BAA6B,EAC7B,gBAAgB,GAEjB,MAAM,kBAAkB,CAAC;AAE1B,OAAO,EACL,SAAS,EACT,eAAe,EAGf,+BAA+B,GAChC,MAAM,iBAAiB,CAAC"}

package/dist/tools/save-skill.d.ts

@@ -0,0 +1,49 @@
+import { z } from 'zod';
+import type { CrawlResult } from '../executor/cli-executor.js';
+/**
+ * Input schema for save_skill tool
+ */
+export declare const SaveSkillSchema: z.ZodObject<{
+    skillName: z.ZodString;
+    skillContent: z.ZodString;
+    referenceFiles: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
+    baseDirectory: z.ZodDefault<z.ZodOptional<z.ZodString>>;
+    overwrite: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
+}, "strip", z.ZodTypeAny, {
+    skillName: string;
+    skillContent: string;
+    baseDirectory: string;
+    overwrite: boolean;
+    referenceFiles?: Record<string, string> | undefined;
+}, {
+    skillName: string;
+    skillContent: string;
+    referenceFiles?: Record<string, string> | undefined;
+    baseDirectory?: string | undefined;
+    overwrite?: boolean | undefined;
+}>;
+export type SaveSkillInput = z.infer<typeof SaveSkillSchema>;
+/**
+ * Save skill result
+ */
+export interface SaveSkillResult {
+    success: boolean;
+    skillDirectory: string;
+    filesCreated: {
+        skillMd: string;
+        references: string[];
+    };
+    message: string;
+}
+/**
+ * Helper to extract skill data from crawl result
+ */
+export declare function extractSkillDataFromCrawlResult(crawlResult: CrawlResult, skillName: string): {
+    skillContent: string;
+    referenceFiles: Record<string, string>;
+};
+/**
+ * Save skill tool handler
+ */
+export declare function saveSkill(input: SaveSkillInput): Promise<SaveSkillResult>;
+//# sourceMappingURL=save-skill.d.ts.map

package/dist/tools/save-skill.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"save-skill.d.ts","sourceRoot":"","sources":["../../src/tools/save-skill.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAIxB,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,6BAA6B,CAAC;AAE/D;;GAEG;AACH,eAAO,MAAM,eAAe;;;;;;;;;;;;;;;;;;EAM1B,CAAC;AAEH,MAAM,MAAM,cAAc,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,eAAe,CAAC,CAAC;AAE7D;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B,OAAO,EAAE,OAAO,CAAC;IACjB,cAAc,EAAE,MAAM,CAAC;IACvB,YAAY,EAAE;QACZ,OAAO,EAAE,MAAM,CAAC;QAChB,UAAU,EAAE,MAAM,EAAE,CAAC;KACtB,CAAC;IACF,OAAO,EAAE,MAAM,CAAC;CACjB;AAED;;GAEG;AACH,wBAAgB,+BAA+B,CAC7C,WAAW,EAAE,WAAW,EACxB,SAAS,EAAE,MAAM,GAChB;IACD,YAAY,EAAE,MAAM,CAAC;IACrB,cAAc,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CACxC,CAmBA;AAyJD;;GAEG;AACH,wBAAsB,SAAS,CAAC,KAAK,EAAE,cAAc,GAAG,OAAO,CAAC,eAAe,CAAC,CAqD/E"}