evo-skills 0.1.0

package/dist/daemon/index.js

@@ -0,0 +1,144 @@
+import { watch } from 'chokidar';
+import { existsSync } from 'node:fs';
+import { join } from 'node:path';
+import { createChildLogger } from '../utils/logger.js';
+import { createShadowManager } from '../core/shadow-manager/index.js';
+import { createCodexObserver } from '../core/observer/codex-observer.js';
+const logger = createChildLogger('daemon');
+/**
+ * 后台守护进程
+ * 负责监听文件变化和定时任务
+ */
+export class Daemon {
+    projectRoot;
+    shadowManager;
+    codexObserver;
+    watcher = null;
+    isRunning = false;
+    cleanupInterval = null;
+    constructor(projectRoot) {
+        this.projectRoot = projectRoot;
+        this.shadowManager = createShadowManager(projectRoot);
+        this.codexObserver = createCodexObserver();
+    }
+    /**
+     * 启动守护进程
+     */
+    async start() {
+        if (this.isRunning) {
+            logger.warn('Daemon already running');
+            return;
+        }
+        this.isRunning = true;
+        logger.info('Starting daemon', { projectRoot: this.projectRoot });
+        // 初始化 shadow manager
+        await this.shadowManager.init();
+        // 设置 trace 回调
+        this.codexObserver.onTrace((trace) => {
+            this.shadowManager.processTrace(trace).catch((error) => {
+                logger.error('Failed to process trace', { error });
+            });
+        });
+        // 启动 codex observer
+        await this.codexObserver.start();
+        // 监听项目 .sea 目录变化
+        this.startFileWatcher();
+        // 启动定时清理任务
+        this.startCleanupTask();
+        logger.info('Daemon started successfully');
+    }
+    /**
+     * 启动文件监听器
+     */
+    startFileWatcher() {
+        const seaDir = join(this.projectRoot, '.sea');
+        if (!existsSync(seaDir)) {
+            logger.debug('.sea directory not found, skipping file watcher');
+            return;
+        }
+        this.watcher = watch(seaDir, {
+            persistent: true,
+            ignoreInitial: true,
+            awaitWriteFinish: {
+                stabilityThreshold: 200,
+                pollInterval: 100,
+            },
+        });
+        this.watcher.on('change', (path) => {
+            logger.debug('File changed', { path });
+            // 可以在这里处理文件变化
+        });
+        this.watcher.on('error', (error) => {
+            logger.error('File watcher error', { error });
+        });
+        logger.info('File watcher started', { path: seaDir });
+    }
+    /**
+     * 启动定时清理任务
+     */
+    startCleanupTask() {
+        // 每小时清理一次旧 traces
+        this.cleanupInterval = setInterval(async () => {
+            try {
+                const retentionDays = 30;
+                const cleaned = await this.shadowManager.cleanupOldTraces(retentionDays);
+                if (cleaned > 0) {
+                    logger.info(`Cleaned ${cleaned} old traces`);
+                }
+            }
+            catch (error) {
+                logger.error('Cleanup task failed', { error });
+            }
+        }, 60 * 60 * 1000 // 1 小时
+        );
+        logger.info('Cleanup task started');
+    }
+    /**
+     * 停止守护进程
+     */
+    async stop() {
+        if (!this.isRunning) {
+            return;
+        }
+        this.isRunning = false;
+        logger.info('Stopping daemon');
+        // 停止 codex observer
+        await this.codexObserver.stop();
+        // 停止文件监听器
+        if (this.watcher) {
+            await this.watcher.close();
+            this.watcher = null;
+        }
+        // 停止定时任务
+        if (this.cleanupInterval) {
+            clearInterval(this.cleanupInterval);
+            this.cleanupInterval = null;
+        }
+        // 关闭 shadow manager
+        this.shadowManager.close();
+        logger.info('Daemon stopped');
+    }
+    /**
+     * 检查是否正在运行
+     */
+    isActive() {
+        return this.isRunning;
+    }
+    /**
+     * 获取 shadow manager
+     */
+    getShadowManager() {
+        return this.shadowManager;
+    }
+    /**
+     * 获取 codex observer
+     */
+    getCodexObserver() {
+        return this.codexObserver;
+    }
+}
+// 导出工厂函数
+export function createDaemon(projectRoot) {
+    return new Daemon(projectRoot);
+}
+//# sourceMappingURL=index.js.map

package/dist/daemon/index.js.map

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

package/dist/storage/index.d.ts

@@ -0,0 +1,7 @@
+/**
+ * 存储层入口
+ */
+export { SQLiteStorage, createSQLiteStorage } from './sqlite.js';
+export { NDJSONReader, NDJSONWriter, TraceStore, JournalStore, createTraceStore, createJournalStore } from './ndjson.js';
+export { MarkdownSkill, createMarkdownSkill } from './markdown.js';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/storage/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,aAAa,EAAE,mBAAmB,EAAE,MAAM,aAAa,CAAC;AACjE,OAAO,EAAE,YAAY,EAAE,YAAY,EAAE,UAAU,EAAE,YAAY,EAAE,gBAAgB,EAAE,kBAAkB,EAAE,MAAM,aAAa,CAAC;AACzH,OAAO,EAAE,aAAa,EAAE,mBAAmB,EAAE,MAAM,eAAe,CAAC"}

package/dist/storage/index.js

@@ -0,0 +1,7 @@
+/**
+ * 存储层入口
+ */
+export { SQLiteStorage, createSQLiteStorage } from './sqlite.js';
+export { NDJSONReader, NDJSONWriter, TraceStore, JournalStore, createTraceStore, createJournalStore } from './ndjson.js';
+export { MarkdownSkill, createMarkdownSkill } from './markdown.js';
+//# sourceMappingURL=index.js.map

package/dist/storage/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/storage/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,aAAa,EAAE,mBAAmB,EAAE,MAAM,aAAa,CAAC;AACjE,OAAO,EAAE,YAAY,EAAE,YAAY,EAAE,UAAU,EAAE,YAAY,EAAE,gBAAgB,EAAE,kBAAkB,EAAE,MAAM,aAAa,CAAC;AACzH,OAAO,EAAE,aAAa,EAAE,mBAAmB,EAAE,MAAM,eAAe,CAAC"}

package/dist/storage/markdown.d.ts

@@ -0,0 +1,66 @@
+/**
+ * Markdown Skill 文件操作器
+ */
+export declare class MarkdownSkill {
+    private filePath;
+    private content;
+    constructor(filePath: string);
+    /**
+     * 读取文件内容
+     */
+    read(): string;
+    /**
+     * 写入文件内容
+     */
+    write(content: string): void;
+    /**
+     * 获取当前内容
+     */
+    getContent(): string;
+    /**
+     * 获取内容哈希
+     */
+    getContentHash(): string;
+    /**
+     * 检查文件是否存在
+     */
+    exists(): boolean;
+    /**
+     * 获取文件路径
+     */
+    getPath(): string;
+    /**
+     * 解析 frontmatter
+     */
+    parseFrontmatter(): Record<string, unknown>;
+    /**
+     * 更新 frontmatter
+     */
+    updateFrontmatter(updates: Record<string, unknown>): string;
+    /**
+     * 查找 section
+     */
+    findSection(heading: string): {
+        start: number;
+        end: number;
+        content: string;
+    } | null;
+    /**
+     * 替换 section 内容
+     */
+    replaceSection(heading: string, newContent: string): string;
+    /**
+     * 在指定 section 后追加内容
+     */
+    appendAfterSection(heading: string, content: string): string;
+    /**
+     * 生成 diff
+     */
+    generateDiff(oldContent: string, newContent: string): string;
+    /**
+     * 从 origin 复制
+     */
+    copyFromOrigin(originPath: string): void;
+}
+export declare function createMarkdownSkill(filePath: string): MarkdownSkill;
+//# sourceMappingURL=markdown.d.ts.map

package/dist/storage/markdown.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"markdown.d.ts","sourceRoot":"","sources":["../../src/storage/markdown.ts"],"names":[],"mappings":"AAQA;;GAEG;AACH,qBAAa,aAAa;IACxB,OAAO,CAAC,QAAQ,CAAS;IACzB,OAAO,CAAC,OAAO,CAAc;gBAEjB,QAAQ,EAAE,MAAM;IAI5B;;OAEG;IACH,IAAI,IAAI,MAAM;IAQd;;OAEG;IACH,KAAK,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI;IAU5B;;OAEG;IACH,UAAU,IAAI,MAAM;IAIpB;;OAEG;IACH,cAAc,IAAI,MAAM;IAIxB;;OAEG;IACH,MAAM,IAAI,OAAO;IAIjB;;OAEG;IACH,OAAO,IAAI,MAAM;IAIjB;;OAEG;IACH,gBAAgB,IAAI,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;IAmC3C;;OAEG;IACH,iBAAiB,CAAC,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,MAAM;IA6C3D;;OAEG;IACH,WAAW,CAAC,OAAO,EAAE,MAAM,GAAG;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,GAAG,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE,GAAG,IAAI;IAoCpF;;OAEG;IACH,cAAc,CAAC,OAAO,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,GAAG,MAAM;IAmB3D;;OAEG;IACH,kBAAkB,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,MAAM;IAqB5D;;OAEG;IACH,YAAY,CAAC,UAAU,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,GAAG,MAAM;IAI5D;;OAEG;IACH,cAAc,CAAC,UAAU,EAAE,MAAM,GAAG,IAAI;CASzC;AAGD,wBAAgB,mBAAmB,CAAC,QAAQ,EAAE,MAAM,GAAG,aAAa,CAEnE"}

package/dist/storage/markdown.js

@@ -0,0 +1,227 @@
+import { readFileSync, writeFileSync, existsSync, mkdirSync } from 'node:fs';
+import { dirname } from 'node:path';
+import { createChildLogger } from '../utils/logger.js';
+import { hashString } from '../utils/hash.js';
+import { createUnifiedDiff } from '../utils/diff.js';
+const logger = createChildLogger('markdown');
+/**
+ * Markdown Skill 文件操作器
+ */
+export class MarkdownSkill {
+    filePath;
+    content = '';
+    constructor(filePath) {
+        this.filePath = filePath;
+    }
+    /**
+     * 读取文件内容
+     */
+    read() {
+        if (!existsSync(this.filePath)) {
+            throw new Error(`Skill file not found: ${this.filePath}`);
+        }
+        this.content = readFileSync(this.filePath, 'utf-8');
+        return this.content;
+    }
+    /**
+     * 写入文件内容
+     */
+    write(content) {
+        const dir = dirname(this.filePath);
+        if (!existsSync(dir)) {
+            mkdirSync(dir, { recursive: true });
+        }
+        writeFileSync(this.filePath, content, 'utf-8');
+        this.content = content;
+        logger.debug('Skill file written', { path: this.filePath });
+    }
+    /**
+     * 获取当前内容
+     */
+    getContent() {
+        return this.content;
+    }
+    /**
+     * 获取内容哈希
+     */
+    getContentHash() {
+        return hashString(this.content);
+    }
+    /**
+     * 检查文件是否存在
+     */
+    exists() {
+        return existsSync(this.filePath);
+    }
+    /**
+     * 获取文件路径
+     */
+    getPath() {
+        return this.filePath;
+    }
+    /**
+     * 解析 frontmatter
+     */
+    parseFrontmatter() {
+        const frontmatter = {};
+        const lines = this.content.split('\n');
+        if (lines[0]?.trim() !== '---') {
+            return frontmatter;
+        }
+        let endIndex = -1;
+        for (let i = 1; i < lines.length; i++) {
+            if (lines[i]?.trim() === '---') {
+                endIndex = i;
+                break;
+            }
+        }
+        if (endIndex === -1) {
+            return frontmatter;
+        }
+        for (let i = 1; i < endIndex; i++) {
+            const line = lines[i];
+            const colonIndex = line?.indexOf(':') ?? -1;
+            if (colonIndex > 0) {
+                const key = line?.substring(0, colonIndex).trim();
+                const value = line?.substring(colonIndex + 1).trim();
+                if (key) {
+                    frontmatter[key] = value;
+                }
+            }
+        }
+        return frontmatter;
+    }
+    /**
+     * 更新 frontmatter
+     */
+    updateFrontmatter(updates) {
+        const lines = this.content.split('\n');
+        if (lines[0]?.trim() !== '---') {
+            // 没有 frontmatter，添加一个
+            const newFrontmatter = Object.entries(updates)
+                .map(([k, v]) => `${k}: ${v}`)
+                .join('\n');
+            const newContent = `---\n${newFrontmatter}\n---\n\n${this.content}`;
+            this.write(newContent);
+            return newContent;
+        }
+        let endIndex = -1;
+        for (let i = 1; i < lines.length; i++) {
+            if (lines[i]?.trim() === '---') {
+                endIndex = i;
+                break;
+            }
+        }
+        if (endIndex === -1) {
+            return this.content;
+        }
+        // 解析现有 frontmatter
+        const existingFrontmatter = this.parseFrontmatter();
+        const mergedFrontmatter = { ...existingFrontmatter, ...updates };
+        // 重建 frontmatter
+        const newFrontmatterLines = Object.entries(mergedFrontmatter).map(([k, v]) => `${k}: ${v}`);
+        const newContent = [
+            '---',
+            ...newFrontmatterLines,
+            '---',
+            ...lines.slice(endIndex + 1),
+        ].join('\n');
+        this.write(newContent);
+        return newContent;
+    }
+    /**
+     * 查找 section
+     */
+    findSection(heading) {
+        const lines = this.content.split('\n');
+        const headingPattern = new RegExp(`^#{1,6}\\s+${heading}`, 'i');
+        let start = -1;
+        let headingLevel = 0;
+        for (let i = 0; i < lines.length; i++) {
+            if (headingPattern.test(lines[i] ?? '')) {
+                start = i;
+                headingLevel = (lines[i]?.match(/^(#{1,6})/) ?? ['', ''])[1].length;
+                break;
+            }
+        }
+        if (start === -1) {
+            return null;
+        }
+        // 找到下一个同级或更高级的 heading
+        let end = lines.length;
+        for (let i = start + 1; i < lines.length; i++) {
+            const match = lines[i]?.match(/^(#{1,6})\s/);
+            if (match && match[1].length <= headingLevel) {
+                end = i;
+                break;
+            }
+        }
+        return {
+            start,
+            end,
+            content: lines.slice(start, end).join('\n'),
+        };
+    }
+    /**
+     * 替换 section 内容
+     */
+    replaceSection(heading, newContent) {
+        const section = this.findSection(heading);
+        if (!section) {
+            logger.warn(`Section not found: ${heading}`);
+            return this.content;
+        }
+        const lines = this.content.split('\n');
+        const newLines = [
+            ...lines.slice(0, section.start + 1),
+            ...newContent.split('\n'),
+            ...lines.slice(section.end),
+        ];
+        const result = newLines.join('\n');
+        this.write(result);
+        return result;
+    }
+    /**
+     * 在指定 section 后追加内容
+     */
+    appendAfterSection(heading, content) {
+        const section = this.findSection(heading);
+        if (!section) {
+            logger.warn(`Section not found: ${heading}`);
+            return this.content;
+        }
+        const lines = this.content.split('\n');
+        const newLines = [
+            ...lines.slice(0, section.end),
+            '',
+            content,
+            '',
+            ...lines.slice(section.end),
+        ];
+        const result = newLines.join('\n');
+        this.write(result);
+        return result;
+    }
+    /**
+     * 生成 diff
+     */
+    generateDiff(oldContent, newContent) {
+        return createUnifiedDiff(this.filePath, oldContent, newContent);
+    }
+    /**
+     * 从 origin 复制
+     */
+    copyFromOrigin(originPath) {
+        if (!existsSync(originPath)) {
+            throw new Error(`Origin skill not found: ${originPath}`);
+        }
+        const originContent = readFileSync(originPath, 'utf-8');
+        this.write(originContent);
+        logger.info('Skill copied from origin', { from: originPath, to: this.filePath });
+    }
+}
+// 导出工厂函数
+export function createMarkdownSkill(filePath) {
+    return new MarkdownSkill(filePath);
+}
+//# sourceMappingURL=markdown.js.map

package/dist/storage/markdown.js.map

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

package/dist/storage/ndjson.d.ts

@@ -0,0 +1,118 @@
+import type { Trace, EvolutionRecord } from '../types/index.js';
+/**
+ * NDJSON 读写器
+ */
+export declare class NDJSONReader<T> {
+    private filePath;
+    constructor(filePath: string);
+    /**
+     * 检查文件是否存在
+     */
+    exists(): boolean;
+    /**
+     * 逐行读取并解析
+     */
+    readLines(): AsyncGenerator<T>;
+    /**
+     * 读取所有记录
+     */
+    readAll(): Promise<T[]>;
+    /**
+     * 读取最后 N 条记录
+     */
+    readLast(n: number): Promise<T[]>;
+    /**
+     * 按条件过滤
+     */
+    filter(predicate: (item: T) => boolean): AsyncGenerator<T>;
+    /**
+     * 统计记录数
+     */
+    count(): Promise<number>;
+}
+/**
+ * NDJSON 写入器
+ */
+export declare class NDJSONWriter<T> {
+    private filePath;
+    constructor(filePath: string);
+    /**
+     * 确保目录存在
+     */
+    private ensureDirectory;
+    /**
+     * 追加一条记录
+     */
+    append(record: T): void;
+    /**
+     * 批量追加记录
+     */
+    appendBatch(records: T[]): void;
+    /**
+     * 清空文件
+     */
+    clear(): void;
+    /**
+     * 获取文件路径
+     */
+    getPath(): string;
+}
+/**
+ * Trace NDJSON 存储
+ */
+export declare class TraceStore {
+    private writer;
+    private reader;
+    constructor(tracesDir: string, sessionId: string);
+    /**
+     * 记录 trace
+     */
+    append(trace: Trace): void;
+    /**
+     * 读取所有 traces
+     */
+    readAll(): Promise<Trace[]>;
+    /**
+     * 读取 session 的 traces
+     */
+    readBySession(sessionId: string): Promise<Trace[]>;
+    /**
+     * 读取最近的 traces
+     */
+    readRecent(count: number): Promise<Trace[]>;
+}
+/**
+ * Journal NDJSON 存储
+ */
+export declare class JournalStore {
+    private writer;
+    private reader;
+    constructor(journalPath: string);
+    /**
+     * 记录演化
+     */
+    append(record: EvolutionRecord): void;
+    /**
+     * 读取所有记录
+     */
+    readAll(): Promise<EvolutionRecord[]>;
+    /**
+     * 读取指定 revision 范围的记录
+     */
+    readRange(fromRevision: number, toRevision: number): Promise<EvolutionRecord[]>;
+    /**
+     * 读取最后 N 条记录
+     */
+    readLast(n: number): Promise<EvolutionRecord[]>;
+    /**
+     * 获取最新 revision
+     */
+    getLatestRevision(): Promise<number>;
+    /**
+     * 获取指定 revision 的记录
+     */
+    getByRevision(revision: number): Promise<EvolutionRecord | null>;
+}
+export declare function createTraceStore(tracesDir: string, sessionId: string): TraceStore;
+export declare function createJournalStore(journalPath: string): JournalStore;
+//# sourceMappingURL=ndjson.d.ts.map

package/dist/storage/ndjson.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ndjson.d.ts","sourceRoot":"","sources":["../../src/storage/ndjson.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,KAAK,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC;AAIhE;;GAEG;AACH,qBAAa,YAAY,CAAC,CAAC;IACzB,OAAO,CAAC,QAAQ,CAAS;gBAEb,QAAQ,EAAE,MAAM;IAI5B;;OAEG;IACH,MAAM,IAAI,OAAO;IAIjB;;OAEG;IACI,SAAS,IAAI,cAAc,CAAC,CAAC,CAAC;IAyBrC;;OAEG;IACG,OAAO,IAAI,OAAO,CAAC,CAAC,EAAE,CAAC;IAQ7B;;OAEG;IACG,QAAQ,CAAC,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,CAAC,EAAE,CAAC;IAKvC;;OAEG;IACI,MAAM,CAAC,SAAS,EAAE,CAAC,IAAI,EAAE,CAAC,KAAK,OAAO,GAAG,cAAc,CAAC,CAAC,CAAC;IAQjE;;OAEG;IACG,KAAK,IAAI,OAAO,CAAC,MAAM,CAAC;CAO/B;AAED;;GAEG;AACH,qBAAa,YAAY,CAAC,CAAC;IACzB,OAAO,CAAC,QAAQ,CAAS;gBAEb,QAAQ,EAAE,MAAM;IAK5B;;OAEG;IACH,OAAO,CAAC,eAAe;IAOvB;;OAEG;IACH,MAAM,CAAC,MAAM,EAAE,CAAC,GAAG,IAAI;IAKvB;;OAEG;IACH,WAAW,CAAC,OAAO,EAAE,CAAC,EAAE,GAAG,IAAI;IAK/B;;OAEG;IACH,KAAK,IAAI,IAAI;IAKb;;OAEG;IACH,OAAO,IAAI,MAAM;CAGlB;AAED;;GAEG;AACH,qBAAa,UAAU;IACrB,OAAO,CAAC,MAAM,CAAsB;IACpC,OAAO,CAAC,MAAM,CAAsB;gBAExB,SAAS,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM;IAMhD;;OAEG;IACH,MAAM,CAAC,KAAK,EAAE,KAAK,GAAG,IAAI;IAK1B;;OAEG;IACG,OAAO,IAAI,OAAO,CAAC,KAAK,EAAE,CAAC;IAIjC;;OAEG;IACG,aAAa,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,KAAK,EAAE,CAAC;IAQxD;;OAEG;IACG,UAAU,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,KAAK,EAAE,CAAC;CAGlD;AAED;;GAEG;AACH,qBAAa,YAAY;IACvB,OAAO,CAAC,MAAM,CAAgC;IAC9C,OAAO,CAAC,MAAM,CAAgC;gBAElC,WAAW,EAAE,MAAM;IAK/B;;OAEG;IACH,MAAM,CAAC,MAAM,EAAE,eAAe,GAAG,IAAI;IASrC;;OAEG;IACG,OAAO,IAAI,OAAO,CAAC,eAAe,EAAE,CAAC;IAI3C;;OAEG;IACG,SAAS,CAAC,YAAY,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,eAAe,EAAE,CAAC;IAUrF;;OAEG;IACG,QAAQ,CAAC,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,eAAe,EAAE,CAAC;IAIrD;;OAEG;IACG,iBAAiB,IAAI,OAAO,CAAC,MAAM,CAAC;IAK1C;;OAEG;IACG,aAAa,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,eAAe,GAAG,IAAI,CAAC;CAMvE;AAGD,wBAAgB,gBAAgB,CAAC,SAAS,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,UAAU,CAEjF;AAED,wBAAgB,kBAAkB,CAAC,WAAW,EAAE,MAAM,GAAG,YAAY,CAEpE"}