flashclaw 1.0.0

package/dist/core/api-client.js

@@ -0,0 +1,369 @@
+/**
+ * FlashClaw API 客户端
+ * 直接调用 Anthropic API，支持 MiniMax 等兼容 API
+ *
+ * 特性：
+ * - 支持多模型提供商
+ * - 工具调用 (Tool Use)
+ * - 流式响应 (Streaming)
+ * - 错误重试
+ */
+import Anthropic from '@anthropic-ai/sdk';
+// ==================== API 客户端实现 ====================
+/**
+ * FlashClaw API 客户端
+ *
+ * @example
+ * ```typescript
+ * const client = new ApiClient({
+ *   apiKey: process.env.ANTHROPIC_API_KEY!,
+ * });
+ *
+ * const response = await client.chat([
+ *   { role: 'user', content: '你好！' }
+ * ]);
+ *
+ * console.log(response.content[0]);
+ * ```
+ */
+export class ApiClient {
+    client;
+    model;
+    maxRetries;
+    timeout;
+    constructor(config) {
+        this.client = new Anthropic({
+            apiKey: config.apiKey,
+            baseURL: config.baseURL,
+            maxRetries: config.maxRetries ?? 3,
+            timeout: config.timeout ?? 60000,
+        });
+        this.model = config.model || 'claude-sonnet-4-20250514';
+        this.maxRetries = config.maxRetries ?? 3;
+        this.timeout = config.timeout ?? 60000;
+    }
+    /**
+     * 发送消息并获取回复
+     *
+     * @param messages - 聊天消息历史
+     * @param options - 聊天选项
+     * @returns API 响应消息
+     *
+     * @example
+     * ```typescript
+     * const response = await client.chat(
+     *   [{ role: 'user', content: '解释量子计算' }],
+     *   { system: '你是一位物理学教授', maxTokens: 1024 }
+     * );
+     * ```
+     */
+    async chat(messages, options) {
+        const params = {
+            model: this.model,
+            max_tokens: options?.maxTokens ?? 4096,
+            messages: messages.map(msg => ({
+                role: msg.role,
+                content: msg.content,
+            })),
+        };
+        // 添加系统提示词
+        if (options?.system) {
+            params.system = options.system;
+        }
+        // 添加工具
+        if (options?.tools && options.tools.length > 0) {
+            params.tools = options.tools;
+        }
+        // 添加温度
+        if (options?.temperature !== undefined) {
+            params.temperature = options.temperature;
+        }
+        // 添加停止序列
+        if (options?.stopSequences && options.stopSequences.length > 0) {
+            params.stop_sequences = options.stopSequences;
+        }
+        // 发送请求，带重试
+        let lastError = null;
+        for (let attempt = 0; attempt < this.maxRetries; attempt++) {
+            try {
+                const response = await this.client.messages.create(params);
+                return response;
+            }
+            catch (error) {
+                lastError = error;
+                // 判断是否可重试
+                if (this.isRetryableError(error)) {
+                    // 指数退避
+                    const delay = Math.min(1000 * Math.pow(2, attempt), 10000);
+                    await this.sleep(delay);
+                    continue;
+                }
+                // 不可重试的错误直接抛出
+                throw error;
+            }
+        }
+        throw lastError || new Error('API 请求失败');
+    }
+    /**
+     * 流式发送消息
+     *
+     * @param messages - 聊天消息历史
+     * @param options - 聊天选项
+     * @returns 异步迭代器，产生流式事件
+     *
+     * @example
+     * ```typescript
+     * for await (const event of client.chatStream(messages)) {
+     *   if (event.type === 'text') {
+     *     process.stdout.write(event.text);
+     *   }
+     * }
+     * ```
+     */
+    async *chatStream(messages, options) {
+        const params = {
+            model: this.model,
+            max_tokens: options?.maxTokens ?? 4096,
+            messages: messages.map(msg => ({
+                role: msg.role,
+                content: msg.content,
+            })),
+            stream: true,
+        };
+        if (options?.system) {
+            params.system = options.system;
+        }
+        if (options?.tools && options.tools.length > 0) {
+            params.tools = options.tools;
+        }
+        if (options?.temperature !== undefined) {
+            params.temperature = options.temperature;
+        }
+        const stream = await this.client.messages.create(params);
+        // 处理流式响应
+        let finalMessage = null;
+        for await (const event of stream) {
+            if (event.type === 'content_block_delta') {
+                const delta = event.delta;
+                if ('text' in delta) {
+                    yield { type: 'text', text: delta.text };
+                }
+                else if ('partial_json' in delta) {
+                    // 工具调用的部分 JSON，暂时跳过
+                }
+            }
+            else if (event.type === 'content_block_start') {
+                const block = event.content_block;
+                if (block.type === 'tool_use') {
+                    // 工具调用开始，等待完整输入
+                }
+            }
+            else if (event.type === 'message_stop') {
+                // 消息结束
+            }
+            else if (event.type === 'message_delta') {
+                // 消息元数据更新
+            }
+            // 保存最终消息
+            if (event.type === 'message_start') {
+                finalMessage = event.message;
+            }
+        }
+        // 重新获取完整消息以获取工具调用
+        if (finalMessage) {
+            const fullResponse = await this.chat(messages, { ...options, maxTokens: options?.maxTokens ?? 4096 });
+            // 检查工具调用
+            for (const block of fullResponse.content) {
+                if (block.type === 'tool_use') {
+                    yield {
+                        type: 'tool_use',
+                        id: block.id,
+                        name: block.name,
+                        input: block.input,
+                    };
+                }
+            }
+            yield { type: 'done', message: fullResponse };
+        }
+    }
+    /**
+     * 处理工具调用
+     * 自动执行工具并获取最终回复
+     *
+     * @param response - 包含工具调用的 API 响应
+     * @param messages - 原始消息历史
+     * @param executeTool - 工具执行函数
+     * @param options - 聊天选项（用于后续请求）
+     * @returns 最终文本回复
+     *
+     * @example
+     * ```typescript
+     * const response = await client.chat(messages, { tools });
+     *
+     * if (response.stop_reason === 'tool_use') {
+     *   const finalText = await client.handleToolUse(
+     *     response,
+     *     messages,
+     *     async (name, params) => {
+     *       // 执行工具逻辑
+     *       return { result: 'done' };
+     *     }
+     *   );
+     * }
+     * ```
+     */
+    async handleToolUse(response, messages, executeTool, options) {
+        // 检查是否有工具调用
+        const toolUseBlocks = response.content.filter((block) => block.type === 'tool_use');
+        if (toolUseBlocks.length === 0) {
+            // 没有工具调用，提取文本回复
+            return this.extractText(response);
+        }
+        // 构建新的消息序列
+        const newMessages = [
+            ...messages.map(msg => ({
+                role: msg.role,
+                content: msg.content,
+            })),
+            // 添加 assistant 的回复（包含工具调用）
+            {
+                role: 'assistant',
+                content: response.content,
+            },
+        ];
+        // 执行所有工具并收集结果
+        const toolResults = [];
+        for (const toolUse of toolUseBlocks) {
+            try {
+                const result = await executeTool(toolUse.name, toolUse.input);
+                toolResults.push({
+                    type: 'tool_result',
+                    tool_use_id: toolUse.id,
+                    content: typeof result === 'string' ? result : JSON.stringify(result),
+                });
+            }
+            catch (error) {
+                // 工具执行失败，返回错误信息
+                toolResults.push({
+                    type: 'tool_result',
+                    tool_use_id: toolUse.id,
+                    content: `工具执行失败: ${error.message}`,
+                    is_error: true,
+                });
+            }
+        }
+        // 添加工具结果
+        newMessages.push({
+            role: 'user',
+            content: toolResults,
+        });
+        // 发送后续请求
+        const params = {
+            model: this.model,
+            max_tokens: options?.maxTokens ?? 4096,
+            messages: newMessages,
+        };
+        if (options?.system) {
+            params.system = options.system;
+        }
+        if (options?.tools && options.tools.length > 0) {
+            params.tools = options.tools;
+        }
+        const nextResponse = await this.client.messages.create(params);
+        // 递归处理，以支持多轮工具调用
+        if (nextResponse.stop_reason === 'tool_use') {
+            // 将新消息转换回 ChatMessage 格式继续处理
+            const updatedMessages = [
+                ...messages,
+                { role: 'assistant', content: this.extractText(response) },
+                { role: 'user', content: toolResults.map(r => r.content).join('\n') },
+            ];
+            return this.handleToolUse(nextResponse, updatedMessages, executeTool, options);
+        }
+        return this.extractText(nextResponse);
+    }
+    /**
+     * 从响应中提取文本内容
+     *
+     * @param response - API 响应
+     * @returns 文本内容
+     */
+    extractText(response) {
+        const textBlocks = response.content.filter((block) => block.type === 'text');
+        return textBlocks.map(block => block.text).join('');
+    }
+    /**
+     * 获取当前使用的模型
+     */
+    getModel() {
+        return this.model;
+    }
+    /**
+     * 设置模型
+     *
+     * @param model - 模型名称
+     */
+    setModel(model) {
+        this.model = model;
+    }
+    /**
+     * 判断错误是否可重试
+     */
+    isRetryableError(error) {
+        if (error instanceof Anthropic.APIError) {
+            // 429 Rate Limit, 500+ Server Error 可重试
+            return error.status === 429 || error.status >= 500;
+        }
+        // 网络错误可重试
+        if (error instanceof Error && error.message.includes('fetch')) {
+            return true;
+        }
+        return false;
+    }
+    /**
+     * 延迟函数
+     */
+    sleep(ms) {
+        return new Promise(resolve => setTimeout(resolve, ms));
+    }
+}
+// ==================== 工厂函数 ====================
+/**
+ * 创建默认 API 客户端
+ * 从环境变量读取配置
+ *
+ * @returns API 客户端实例，如果配置缺失则返回 null
+ */
+export function createApiClient() {
+    // 支持两种环境变量名（兼容不同配置）
+    const apiKey = process.env.ANTHROPIC_AUTH_TOKEN || process.env.ANTHROPIC_API_KEY;
+    if (!apiKey) {
+        return null;
+    }
+    return new ApiClient({
+        apiKey,
+        baseURL: process.env.ANTHROPIC_BASE_URL,
+        model: process.env.AI_MODEL || process.env.ANTHROPIC_MODEL,
+        maxRetries: process.env.API_MAX_RETRIES ? parseInt(process.env.API_MAX_RETRIES) : undefined,
+        timeout: process.env.API_TIMEOUT ? parseInt(process.env.API_TIMEOUT) : undefined,
+    });
+}
+/**
+ * 获取全局 API 客户端单例
+ * 确保 jiti 热加载的插件访问同一实例
+ *
+ * @returns API 客户端实例，如果配置缺失则返回 null
+ */
+export function getApiClient() {
+    if (global.__flashclaw_api_client === undefined) {
+        global.__flashclaw_api_client = createApiClient();
+    }
+    return global.__flashclaw_api_client;
+}
+/**
+ * 重置 API 客户端（用于配置变更后重新初始化）
+ */
+export function resetApiClient() {
+    global.__flashclaw_api_client = undefined;
+}
+//# sourceMappingURL=api-client.js.map

package/dist/core/api-client.js.map

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

package/dist/core/memory.d.ts

@@ -0,0 +1,291 @@
+/**
+ * FlashClaw 记忆系统
+ *
+ * 三层记忆架构：
+ * 1. 短期记忆 - 最近 N 条消息，保存在内存中
+ * 2. 长期记忆 - 重要信息，保存在 data/memory/{group}.md 文件
+ * 3. 上下文压缩 - 超长对话时自动摘要，减少 token 消耗
+ *
+ * 参考 OpenClaw 的 session-memory 设计
+ */
+import type { ApiClient, ChatMessage } from './api-client.js';
+/**
+ * 记忆配置
+ */
+export interface MemoryConfig {
+    /** 上下文 token 限制（发送给 AI 的最大 token 数，默认 100000） */
+    contextTokenLimit: number;
+    /** 触发自动压缩的 token 阈值（默认 150000，略高于 70% 提示） */
+    compactThreshold: number;
+    /** 长期记忆存储目录（默认 data/memory） */
+    memoryDir: string;
+    /** 压缩后保留的 token 数（默认 30000） */
+    compactKeepTokens: number;
+}
+/**
+ * 记忆条目（长期记忆）
+ */
+export interface MemoryEntry {
+    /** 记忆键 */
+    key: string;
+    /** 记忆值 */
+    value: string;
+    /** 创建时间 */
+    createdAt: string;
+    /** 更新时间 */
+    updatedAt: string;
+}
+/**
+ * 上下文压缩结果
+ */
+export interface CompactResult {
+    /** 原始消息数 */
+    originalCount: number;
+    /** 压缩后消息数 */
+    compactedCount: number;
+    /** 摘要内容 */
+    summary: string;
+    /** 估算节省的 token 数 */
+    savedTokens: number;
+}
+/**
+ * 记忆管理器
+ *
+ * @example
+ * ```typescript
+ * const memory = new MemoryManager({
+ *   shortTermLimit: 50,
+ *   compactThreshold: 80000,
+ *   memoryDir: 'data/memory',
+ *   compactKeepRecent: 10,
+ * });
+ *
+ * // 添加消息
+ * memory.addMessage('group1', { role: 'user', content: '你好' });
+ *
+ * // 获取上下文
+ * const context = memory.getContext('group1');
+ *
+ * // 记住重要信息
+ * memory.remember('group1', 'user_name', '张三');
+ *
+ * // 回忆信息
+ * const name = memory.recall('group1', 'user_name');
+ * ```
+ */
+export declare class MemoryManager {
+    private config;
+    /** 短期记忆存储：groupId -> 消息列表 */
+    private shortTermMemory;
+    /** 长期记忆缓存：groupId -> 记忆条目映射 */
+    private longTermCache;
+    /** 用户级别记忆缓存：userId -> 记忆条目映射 */
+    private userMemoryCache;
+    /** 压缩摘要缓存：groupId -> 摘要 */
+    private summaryCache;
+    constructor(config?: Partial<MemoryConfig>);
+    /**
+     * 获取群组的对话上下文
+     * 基于 token 限制返回消息（从最新到最旧）
+     *
+     * @param groupId - 群组 ID
+     * @param maxTokens - 最大 token 数（可选，默认使用配置值）
+     * @returns 消息列表
+     */
+    getContext(groupId: string, maxTokens?: number): ChatMessage[];
+    /**
+     * 估算单条消息的 token 数
+     * 中文约 2 字符/token，英文约 4 字符/token
+     */
+    private estimateMessageTokens;
+    /**
+     * 添加消息到短期记忆
+     *
+     * @param groupId - 群组 ID
+     * @param message - 消息
+     */
+    addMessage(groupId: string, message: ChatMessage): void;
+    /**
+     * 批量添加消息
+     *
+     * @param groupId - 群组 ID
+     * @param messages - 消息列表
+     */
+    addMessages(groupId: string, messages: ChatMessage[]): void;
+    /**
+     * 清除群组的短期记忆
+     *
+     * @param groupId - 群组 ID
+     */
+    clearContext(groupId: string): void;
+    /**
+     * 获取消息数量
+     *
+     * @param groupId - 群组 ID
+     * @returns 消息数量
+     */
+    getMessageCount(groupId: string): number;
+    /**
+     * 记住重要信息（持久化到文件）
+     *
+     * @param groupId - 群组 ID
+     * @param key - 记忆键
+     * @param value - 记忆值
+     */
+    remember(groupId: string, key: string, value: string): void;
+    /**
+     * 回忆信息
+     *
+     * @param groupId - 群组 ID
+     * @param key - 记忆键（可选，不提供则返回所有记忆）
+     * @returns 记忆值或格式化的所有记忆
+     */
+    recall(groupId: string, key?: string): string;
+    /**
+     * 删除记忆
+     *
+     * @param groupId - 群组 ID
+     * @param key - 记忆键
+     */
+    forget(groupId: string, key: string): void;
+    /**
+     * 获取所有记忆键
+     *
+     * @param groupId - 群组 ID
+     * @returns 记忆键列表
+     */
+    getMemoryKeys(groupId: string): string[];
+    /**
+     * 记住用户级别信息（跨会话共享）
+     *
+     * @param userId - 用户 ID
+     * @param key - 记忆键
+     * @param value - 记忆值
+     */
+    rememberUser(userId: string, key: string, value: string): void;
+    /**
+     * 回忆用户级别信息
+     *
+     * @param userId - 用户 ID
+     * @param key - 记忆键（可选，不提供则返回所有记忆）
+     * @returns 记忆值或格式化的所有记忆
+     */
+    recallUser(userId: string, key?: string): string;
+    /**
+     * 删除用户级别记忆
+     */
+    forgetUser(userId: string, key: string): void;
+    /**
+     * 获取用户文件路径
+     */
+    private getUserMemoryFilePath;
+    /**
+     * 加载用户级别记忆
+     */
+    private loadUserMemory;
+    /**
+     * 保存用户级别记忆
+     */
+    private saveUserMemory;
+    /**
+     * 构建包含用户记忆的系统提示词
+     */
+    buildUserSystemPrompt(userId: string, basePrompt?: string): string;
+    /**
+     * 估算消息的 token 数量（简单估算）
+     * 中文约 2 字符/token，英文约 4 字符/token
+     *
+     * @param messages - 消息列表
+     * @returns 估算的 token 数
+     */
+    estimateTokens(messages: ChatMessage[]): number;
+    /**
+     * 检查是否需要压缩
+     *
+     * @param groupId - 群组 ID
+     * @returns 是否需要压缩
+     */
+    needsCompaction(groupId: string): boolean;
+    /**
+     * 压缩对话上下文
+     * 将旧消息总结为摘要，只保留最近的消息（基于 token 限制）
+     *
+     * @param groupId - 群组 ID
+     * @param apiClient - API 客户端（用于生成摘要）
+     * @returns 压缩结果
+     */
+    compact(groupId: string, apiClient: ApiClient): Promise<CompactResult>;
+    /**
+     * 生成对话摘要
+     *
+     * @param messages - 要压缩的消息
+     * @param apiClient - API 客户端
+     * @returns 摘要文本
+     */
+    private generateSummary;
+    /**
+     * 获取压缩摘要
+     *
+     * @param groupId - 群组 ID
+     * @returns 摘要文本，如果没有则返回空字符串
+     */
+    getSummary(groupId: string): string;
+    /**
+     * 构建包含长期记忆的系统提示词
+     *
+     * @param groupId - 群组 ID
+     * @param basePrompt - 基础系统提示词
+     * @returns 完整的系统提示词
+     */
+    buildSystemPrompt(groupId: string, basePrompt?: string): string;
+    /**
+     * 确保记忆目录存在
+     */
+    private ensureMemoryDir;
+    /**
+     * 获取群组的记忆文件路径
+     */
+    private getMemoryFilePath;
+    /**
+     * 加载长期记忆
+     */
+    private loadLongTermMemory;
+    /**
+     * 保存长期记忆
+     */
+    private saveLongTermMemory;
+    /**
+     * 解析记忆文件
+     */
+    private parseMemoryFile;
+    /**
+     * 格式化记忆文件
+     */
+    private formatMemoryFile;
+    /**
+     * 导出会话历史到 Markdown 文件
+     * 类似 OpenClaw 的 session-memory hook
+     *
+     * @param groupId - 群组 ID
+     * @param filename - 文件名（可选，自动生成）
+     * @returns 保存的文件路径
+     */
+    exportSession(groupId: string, filename?: string): string;
+}
+declare global {
+    var __flashclaw_memory_manager: MemoryManager | undefined;
+}
+/**
+ * 获取全局记忆管理器实例
+ * 确保所有模块（包括 jiti 加载的插件）使用同一个实例
+ */
+export declare function getMemoryManager(): MemoryManager;
+/**
+ * 创建默认记忆管理器
+ *
+ * @param baseDir - 基础目录（可选）
+ * @returns 记忆管理器实例
+ * @deprecated 使用 getMemoryManager() 获取全局单例
+ */
+export declare function createMemoryManager(baseDir?: string): MemoryManager;
+//# sourceMappingURL=memory.d.ts.map

package/dist/core/memory.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"memory.d.ts","sourceRoot":"","sources":["../../src/core/memory.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAIH,OAAO,KAAK,EAAE,SAAS,EAAE,WAAW,EAAE,MAAM,iBAAiB,CAAC;AAO9D;;GAEG;AACH,MAAM,WAAW,YAAY;IAC3B,iDAAiD;IACjD,iBAAiB,EAAE,MAAM,CAAC;IAC1B,6CAA6C;IAC7C,gBAAgB,EAAE,MAAM,CAAC;IACzB,+BAA+B;IAC/B,SAAS,EAAE,MAAM,CAAC;IAClB,+BAA+B;IAC/B,iBAAiB,EAAE,MAAM,CAAC;CAC3B;AAED;;GAEG;AACH,MAAM,WAAW,WAAW;IAC1B,UAAU;IACV,GAAG,EAAE,MAAM,CAAC;IACZ,UAAU;IACV,KAAK,EAAE,MAAM,CAAC;IACd,WAAW;IACX,SAAS,EAAE,MAAM,CAAC;IAClB,WAAW;IACX,SAAS,EAAE,MAAM,CAAC;CACnB;AAED;;GAEG;AACH,MAAM,WAAW,aAAa;IAC5B,YAAY;IACZ,aAAa,EAAE,MAAM,CAAC;IACtB,aAAa;IACb,cAAc,EAAE,MAAM,CAAC;IACvB,WAAW;IACX,OAAO,EAAE,MAAM,CAAC;IAChB,oBAAoB;IACpB,WAAW,EAAE,MAAM,CAAC;CACrB;AAID;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AACH,qBAAa,aAAa;IACxB,OAAO,CAAC,MAAM,CAAe;IAE7B,6BAA6B;IAC7B,OAAO,CAAC,eAAe,CAAyC;IAEhE,+BAA+B;IAC/B,OAAO,CAAC,aAAa,CAAoD;IAEzE,gCAAgC;IAChC,OAAO,CAAC,eAAe,CAAoD;IAE3E,2BAA2B;IAC3B,OAAO,CAAC,YAAY,CAAkC;gBAE1C,MAAM,GAAE,OAAO,CAAC,YAAY,CAAM;IAc9C;;;;;;;OAOG;IACH,UAAU,CAAC,OAAO,EAAE,MAAM,EAAE,SAAS,CAAC,EAAE,MAAM,GAAG,WAAW,EAAE;IAgC9D;;;OAGG;IACH,OAAO,CAAC,qBAAqB;IAQ7B;;;;;OAKG;IACH,UAAU,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,WAAW,GAAG,IAAI;IAgBvD;;;;;OAKG;IACH,WAAW,CAAC,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAE,WAAW,EAAE,GAAG,IAAI;IAM3D;;;;OAIG;IACH,YAAY,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI;IAKnC;;;;;OAKG;IACH,eAAe,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM;IAMxC;;;;;;OAMG;IACH,QAAQ,CAAC,OAAO,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,IAAI;IAuB3D;;;;;;OAMG;IACH,MAAM,CAAC,OAAO,EAAE,MAAM,EAAE,GAAG,CAAC,EAAE,MAAM,GAAG,MAAM;IAwB7C;;;;;OAKG;IACH,MAAM,CAAC,OAAO,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,IAAI;IAW1C;;;;;OAKG;IACH,aAAa,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,EAAE;IAUxC;;;;;;OAMG;IACH,YAAY,CAAC,MAAM,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,IAAI;IAoB9D;;;;;;OAMG;IACH,UAAU,CAAC,MAAM,EAAE,MAAM,EAAE,GAAG,CAAC,EAAE,MAAM,GAAG,MAAM;IAsBhD;;OAEG;IACH,UAAU,CAAC,MAAM,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,IAAI;IAW7C;;OAEG;IACH,OAAO,CAAC,qBAAqB;IAK7B;;OAEG;IACH,OAAO,CAAC,cAAc;IAoBtB;;OAEG;IACH,OAAO,CAAC,cAAc;IAqBtB;;OAEG;IACH,qBAAqB,CAAC,MAAM,EAAE,MAAM,EAAE,UAAU,CAAC,EAAE,MAAM,GAAG,MAAM;IAkBlE;;;;;;OAMG;IACH,cAAc,CAAC,QAAQ,EAAE,WAAW,EAAE,GAAG,MAAM;IAQ/C;;;;;OAKG;IACH,eAAe,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO;IAMzC;;;;;;;OAOG;IACG,OAAO,CAAC,OAAO,EAAE,MAAM,EAAE,SAAS,EAAE,SAAS,GAAG,OAAO,CAAC,aAAa,CAAC;IAuF5E;;;;;;OAMG;YACW,eAAe;IAkC7B;;;;;OAKG;IACH,UAAU,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM;IAMnC;;;;;;OAMG;IACH,iBAAiB,CAAC,OAAO,EAAE,MAAM,EAAE,UAAU,CAAC,EAAE,MAAM,GAAG,MAAM;IAyB/D;;OAEG;IACH,OAAO,CAAC,eAAe;IAMvB;;OAEG;IACH,OAAO,CAAC,iBAAiB;IAMzB;;OAEG;IACH,OAAO,CAAC,kBAAkB;IAqB1B;;OAEG;IACH,OAAO,CAAC,kBAAkB;IAc1B;;OAEG;IACH,OAAO,CAAC,eAAe;IAmEvB;;OAEG;IACH,OAAO,CAAC,gBAAgB;IAsBxB;;;;;;;OAOG;IACH,aAAa,CAAC,OAAO,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,MAAM,GAAG,MAAM;CAsD1D;AAKD,OAAO,CAAC,MAAM,CAAC;IAEb,IAAI,0BAA0B,EAAE,aAAa,GAAG,SAAS,CAAC;CAC3D;AAED;;;GAGG;AACH,wBAAgB,gBAAgB,IAAI,aAAa,CAOhD;AAED;;;;;;GAMG;AACH,wBAAgB,mBAAmB,CAAC,OAAO,CAAC,EAAE,MAAM,GAAG,aAAa,CASnE"}