@zooique/memora 2.0.3 → 3.0.1

package/dist/agent/managers/configManager.js

@@ -1,331 +0,0 @@
-import { SOURCE_LABELS } from '../../memory/types.js';
-import { configError, toError } from '../../utils/errors.js';
-import { logger } from '../../logging/logger.js';
-import { nowIso } from '../../utils/time.js';
-// parseFrontmatter：与 FileStore.parseMemory 保持一致的 content 处理（只存 body，去掉 frontmatter）
-import { parseFrontmatter } from '../../utils/frontmatter.js';
-// ─── 类 ──────────────────────────────────────────────────
-export class ConfigManager {
-    index;
-    skillManager;
-    injectSystemMessage;
-    writeConfigFile;
-    refreshBootstrapMemories;
-    /** 配置建议回调（模式 3） */
-    suggestionHandler = null;
-    /**
-     * @param index - 记忆存储（规则写入 SQLite）
-     * @param skillManager - 技能管理器（运行时注入技能）
-     * @param injectSystemMessage - 注入 system 消息的回调（来自 AgentLoop）
-     * @param writeConfigFile - 写入配置文件的回调（来自 Agent，解耦 FileStore 依赖）
-     * @param refreshBootstrapMemories - 刷新 AgentLoop system prompt 中 bootstrap 段的回调
-     *   设定 CRUD（deleteRule/updateRule/deleteSkill）后调用，使 system prompt 中的
-     *   rule/skill 段立即同步。由 Agent 在装配时注入（assembler.ts）。
-     */
-    constructor(index, skillManager, injectSystemMessage, writeConfigFile, refreshBootstrapMemories) {
-        this.index = index;
-        this.skillManager = skillManager;
-        this.injectSystemMessage = injectSystemMessage;
-        this.writeConfigFile = writeConfigFile;
-        this.refreshBootstrapMemories = refreshBootstrapMemories;
-    }
-    // ─── 配置建议 ─────────────────────────────────────────
-    /**
-     * 注册配置建议回调（模式 3）
-     *
-     * 宿主项目通过此方法注册回调，当 AutoConfigRefiner 从对话中
-     * 提取到配置建议时，通过此回调通知宿主。
-     */
-    onConfigSuggestion(handler) {
-        this.suggestionHandler = handler;
-    }
-    /** 获取当前注册的配置建议回调 */
-    get suggestionCallback() {
-        return this.suggestionHandler;
-    }
-    /**
-     * 确认配置建议并写入配置文件（模式 3）
-     *
-     * 用户确认配置建议后，宿主调用此方法将建议持久化到 configDir/ 目录。
-     * 写入的是配置文件（真理源），下次启动时 MemoryLoader 自动扫描加载到 SQLite。
-     *
-     * 与 addRule() 的关键区别：
-     * - addRule() → 写入 SQLite（运行时注入，会话级，重启后需重新注入）
-     * - confirmConfigSuggestion() → 写入配置文件（持久化，重启后自动加载）
-     */
-    async confirmConfigSuggestion(suggestion) {
-        if (!this.writeConfigFile) {
-            throw configError('writeConfigFile 未设置', '模式 3 需要注入配置文件写入回调才能持久化', [
-                '在 Agent 构造时传入 configDir 参数（Agent 会自动创建 FileStore 并注入回调）',
-            ]);
-        }
-        // 根据建议类型映射到 source 标签（ADR-004：开放字符串，约定值走 sourceMap，扩展值走 memorySource）
-        const sourceMap = {
-            rule: SOURCE_LABELS.RULE,
-            persona: SOURCE_LABELS.PERSONA,
-            skill: SOURCE_LABELS.SKILL,
-        };
-        // 优先级：memorySource（扩展值）> sourceMap[type]（约定值）
-        const source = suggestion.memorySource ?? sourceMap[suggestion.type];
-        if (!source) {
-            throw configError('无法确定配置建议的 source 标签', `type='${suggestion.type}' 不在约定值（rule/persona/skill）内，且未提供 memorySource 字段`, [
-                '使用约定 type 值（rule/persona/skill）',
-                '或提供 memorySource 字段指定自定义 source 标签',
-            ]);
-        }
-        // 构造记忆对象并写入配置文件（真理源）
-        // 写入 SQLite index（运行时索引）：配置文件是真理源，SQLite 是运行时检索索引
-        // 两层写入语义：配置文件保证重启后自动加载；SQLite 保证当前会话 search_memories 可检索
-        const now = nowIso();
-        const memory = {
-            id: `${source}:${suggestion.name}`,
-            content: suggestion.content,
-            source,
-            name: suggestion.name,
-            createdAt: now,
-            accessedAt: now,
-            score: suggestion.confidence,
-            // metadata 透传到 FileStore.write，合并到 frontmatter（如 keywords/description）
-            metadata: suggestion.metadata,
-        };
-        // 包裹错误处理：磁盘满/权限不足/路径越界等异常转为友好的 configError
-        try {
-            await this.writeConfigFile(memory);
-        }
-        catch (err) {
-            const e = toError(err);
-            throw configError('配置文件写入失败', `source=${source} name=${suggestion.name} 错误：${e.message}`, [
-                '检查 configDir 路径是否存在且可写',
-                '确认磁盘空间充足',
-                '确认进程对配置目录有写权限',
-            ], e);
-        }
-        // 同步写入 SQLite index：当前会话的 search_memories / recall 可立即检索到新创建的配置
-        // persona/skill 后续由 reloadConfig → SkillManager.reload / PersonaManager.reload 重新扫描覆盖，
-        // 但 rule 的 reloadConfig 是 no-op（agent.ts 内跳过），必须在此显式同步
-        this.index.upsert(memory);
-        // 如果是规则，立即注入到 AgentLoop（当前会话生效，重启后由配置文件自动加载）
-        if (suggestion.type === 'rule') {
-            const rulePrompt = `【项目规则】${suggestion.name}\n${suggestion.content}`;
-            this.injectSystemMessage(rulePrompt);
-        }
-        logger.info({ type: suggestion.type, name: suggestion.name, confidence: suggestion.confidence }, '配置建议已确认并写入配置文件');
-    }
-    // ─── 规则注入 ─────────────────────────────────────────
-    /**
-     * 新增项目规则记忆（Q-701 · v1.1）
-     *
-     * 宿主项目可通过此 API 在运行时动态注入规则记忆。
-     * 规则写入 SQLite 索引后，重启时由 bootstrap 自动召回。
-     * 当前轮次以 system 消息注入 AgentLoop。
-     */
-    async addRule(memory) {
-        if (memory.source !== SOURCE_LABELS.RULE) {
-            throw configError('无效来源', `addRule 只接受 source='rule'，收到 '${memory.source}'`, [
-                '使用 SOURCE_LABELS.RULE 作为 source 字段',
-            ]);
-        }
-        this.index.upsert(memory);
-        const rulePrompt = `【项目规则】${memory.name}\n${memory.content}`;
-        this.injectSystemMessage(rulePrompt);
-        logger.info({ name: memory.name, source: memory.source }, '项目规则已注入');
-    }
-    /**
-     * 新增项目规则的便捷方法
-     *
-     * 宿主程序只需提供 name + content 两个业务字段，
-     * 内部自动填充 id / source / createdAt / accessedAt / score 等字段。
-     */
-    async addSimpleRule(name, content) {
-        const now = nowIso();
-        const memory = {
-            id: `rule:${name}`,
-            content,
-            source: SOURCE_LABELS.RULE,
-            name,
-            createdAt: now,
-            accessedAt: now,
-            score: 0.8,
-        };
-        await this.addRule(memory);
-    }
-    // ─── 技能注入 ─────────────────────────────────────────
-    /**
-     * 运行时动态注入技能（session-only）
-     *
-     * 技能在 Skill 的设计中属于"配置型记忆"——
-     * 由 SkillManager 在内存中管理，通过关键词匹配触发，
-     * 同时写入 SQLite 索引（source: skill）以支持 recall() 检索。
-     *
-     * 路径一（文件加载）：SkillManager.load() 扫描 configDir/skills/*.md → 内存 + SQLite
-     * 路径二（运行时注入）：addSkill() → SkillManager.register() → 内存 + SQLite
-     * 路径三（持久化新增）：config.confirmConfigSuggestion({type:'skill',...}) → 写配置文件 → 下次 load() 自动加载
-     *
-     * 注意：运行时注入的技能仅在当前会话内生效，重启后需重新注入。
-     * 如需跨会话持久化，宿主应调用 config.confirmConfigSuggestion() 写入配置文件。
-     */
-    async addSkill(memory) {
-        if (memory.source !== SOURCE_LABELS.SKILL) {
-            throw configError('无效来源', `addSkill 只接受 source='skill'，收到 '${memory.source}'`, [
-                '使用 SOURCE_LABELS.SKILL 作为 source 字段',
-            ]);
-        }
-        // 写入 SQLite 索引（遵循"万物皆记忆"——与 PersonaManager 一致）
-        this.index.upsert(memory);
-        // 同时注册到 SkillManager（内存缓存，用于关键词匹配）
-        this.skillManager.register({
-            name: memory.name,
-            keywords: [],
-            content: memory.content,
-            description: memory.content.slice(0, 80),
-            filePath: '',
-            layer: 'agent',
-        });
-        logger.info({ name: memory.name }, '技能已注入');
-    }
-    /**
-     * 运行时注入技能的便捷方法（session-only）
-     *
-     * 宿主程序只需提供 name + content 两个业务字段，
-     * 内部自动填充 id / source / createdAt / accessedAt / score。
-     * 注入后仅在当前会话生效，持久化需调用 config.confirmConfigSuggestion()。
-     */
-    async addSimpleSkill(name, content, keywords = []) {
-        void keywords; // 基元驱动模型下关键词暂不存储到 Memory，由 SkillManager 管理
-        const now = nowIso();
-        const memory = {
-            id: `skill:${name}`,
-            content,
-            source: SOURCE_LABELS.SKILL,
-            name,
-            createdAt: now,
-            accessedAt: now,
-            score: 0.7,
-        };
-        await this.addSkill(memory);
-    }
-    // ─── 设定 CRUD（设定面板专用） ───────────────────────
-    /**
-     * 删除规则（设定面板调用）
-     *
-     * 软删除 SQLite 中 source='rule' name=name 的记忆，
-     * 并刷新 AgentLoop system prompt 中的 bootstrap 段。
-     *
-     * 文件层删除由宿主层 configFileManager 处理（本方法不操作文件）。
-     * 删除后调用 refreshBootstrapMemories 回调，使 system prompt 立即同步。
-     *
-     * @param name 规则名（与 frontmatter name 字段一致）
-     * @returns true 删除成功；false 规则不存在
-     */
-    deleteRule(name) {
-        const id = `rule:${name}`;
-        const existing = this.index.getById(id);
-        if (!existing) {
-            logger.warn({ name, id }, '删除规则失败：规则不存在');
-            return false;
-        }
-        this.index.delete(id);
-        this.refreshBootstrapMemories?.();
-        logger.info({ name, id }, '规则已删除');
-        return true;
-    }
-    /**
-     * 更新规则内容（设定面板调用）
-     *
-     * upsert SQLite 中 source='rule' name=name 的记忆，
-     * 并刷新 AgentLoop system prompt 中的 bootstrap 段。
-     *
-     * 文件层更新由宿主层 configFileManager 处理（本方法不操作文件）。
-     * 与 addRule 的区别：addRule 是新增（追加 system 消息），
-     * updateRule 是覆盖更新（刷新 bootstrap 段，不追加 system 消息）。
-     *
-     * content 处理：调用方传入的是完整文件内容（含 frontmatter + body），
-     * 本方法用 parseFrontmatter 解析后只存 body.trim()，
-     * 与 FileStore.parseMemory（store.ts）保持一致——避免 system prompt bootstrap 段
-     * 含 frontmatter 噪音，且重启后 MemoryLoader 重新加载时内容一致。
-     *
-     * @param name 规则名
-     * @param content 新的规则文件内容（含 frontmatter + body）
-     */
-    updateRule(name, content) {
-        const id = `rule:${name}`;
-        const existing = this.index.getById(id);
-        const now = nowIso();
-        // 与 FileStore.parseMemory 保持一致：只存 body（去掉 frontmatter），避免 system prompt 含噪音
-        const { body } = parseFrontmatter(content);
-        const memory = {
-            id,
-            content: body.trim(),
-            source: SOURCE_LABELS.RULE,
-            name,
-            createdAt: existing?.createdAt ?? now,
-            accessedAt: now,
-            score: existing?.score ?? 0.8,
-        };
-        // 若 existing 已软删除，需先 restore 再 upsert（避免"通过 upsert 复活软删除记忆"校验失败）
-        if (existing?.deletedAt) {
-            this.index.restore(id);
-        }
-        this.index.upsert(memory);
-        this.refreshBootstrapMemories?.();
-        logger.info({ name, id }, '规则已更新');
-    }
-    /**
-     * 列出所有规则（设定面板调用）
-     *
-     * @returns 所有 source='rule' 的活跃记忆（按 score 降序）
-     */
-    listRules() {
-        return this.index.getBySource(SOURCE_LABELS.RULE);
-    }
-    /**
-     * 删除技能（设定面板调用）
-     *
-     * 软删除 SQLite 中 source='skill' name=name 的记忆，
-     * 同步清理 SkillManager 内存缓存，
-     * 并刷新 AgentLoop system prompt 中的 bootstrap 段。
-     *
-     * 文件层删除由宿主层 configFileManager 处理（本方法不操作文件）。
-     *
-     * @param name 技能名
-     * @returns true 删除成功；false 技能不存在
-     */
-    deleteSkill(name) {
-        const id = `skill:${name}`;
-        const existing = this.index.getById(id);
-        if (!existing) {
-            logger.warn({ name, id }, '删除技能失败：技能不存在');
-            return false;
-        }
-        this.index.delete(id);
-        // 同步清理 SkillManager 内存缓存（deleteSkill 内部处理 name 不存在的情况）
-        this.skillManager.deleteSkill(name);
-        this.refreshBootstrapMemories?.();
-        logger.info({ name, id }, '技能已删除');
-        return true;
-    }
-    /**
-     * 列出所有技能（设定面板调用）
-     *
-     * @returns 所有 source='skill' 的活跃记忆（按 score 降序）
-     */
-    listSkills() {
-        return this.index.getBySource(SOURCE_LABELS.SKILL);
-    }
-    /**
-     * 获取 bootstrap 记忆（仅 Rule，供 AgentLoop 刷新 system prompt）
-     *
-     * AgentLoop 的 system prompt 中包含 bootstrap 段（rule 记忆）。
-     * Skill 已迁移到 per-round matchAndInjectSkill 动态注入，不再放入 bootstrap。
-     * 设定 CRUD 后调用 refreshBootstrapMemories 回调，回调内部调用此方法
-     * 获取最新的 rule 记忆，传给 AgentLoop.refreshBootstrapMemories()。
-     *
-     * @returns rule 活跃记忆数组
-     */
-    getBootstrapMemories() {
-        return [
-            ...this.index.getBySource(SOURCE_LABELS.RULE),
-        ];
-    }
-}
-//# sourceMappingURL=configManager.js.map

package/dist/agent/managers/configManager.js.map

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

package/dist/agent/managers/insightExtractor.d.ts

@@ -1,139 +0,0 @@
-/**
- * Insight 提取器 — 输入分类 + 记忆提取
- *
- * 从 Agent 拆分出来，负责：
- *   - 三层输入分类（通用规则 → 宿主关键词 → 默认提取）
- *   - 异步 insight 提取（LLM 判断 + 去重 + 写入 SQLite）
- *   - 宿主记忆关键词管理
- *
- * 关系构建逻辑（ADR-014）已拆分至 RelationBuilder，本类通过 relationBuilder 委托调用。
- *
- * 设计原则：
- *   - 独立于 Agent 生命周期，仅依赖 Provider/Storage/Loop
- *   - 提取失败不影响主对话流程（fire-and-forget）
- */
-import type { LlmProvider } from '../../llm/provider.js';
-import type { Memory } from '../../memory/types.js';
-import type { IMemoryStorage } from '../../memory/storageInterface.js';
-import type { WriteExtensions } from '../../agent/toolExecutor.js';
-import type { RelationBuilder, ConflictInfo } from '../../agent/managers/relationBuilder.js';
-/**
- * 记忆关键词（宿主提供，用于输入分类 Layer 2）
- *
- * 宿主通过 setKeywords() 注册领域关键词和用户专属关键词，
- * 用于判断用户输入是否值得提取记忆。
- */
-export interface MemoryKeywords {
-    /** 领域关键词（如项目相关：['架构', '接口', '性能', '测试']） */
-    domain: string[];
-    /** 用户专属关键词（如：['我', '我的', '记住', '帮我']） */
-    personal: string[];
-}
-export declare class InsightExtractor {
-    private readonly provider;
-    private readonly index;
-    /** 宿主提供的记忆关键词（用于输入分类 Layer 2） */
-    private hostKeywords;
-    /** 写入扩展回调（宿主注入 diff 对比确认逻辑） */
-    writeExtensions: WriteExtensions | null;
-    /**
-     * 关系构建器（ADR-014 关系构建委托给 RelationBuilder）
-     * 未注入时跳过所有关系构建（保持向后兼容）
-     */
-    private readonly relationBuilder;
-    /**
-     * @param provider - LLM Provider（用于 insight 提取）
-     * @param index - 记忆存储（用于去重搜索 + 写入）
-     * @param relationBuilder - 关系构建器（可选，替代直接 relationStore 注入）
-     *   未注入时跳过关系构建（保持向后兼容，ADR-014 侧车模型）
-     */
-    constructor(provider: LlmProvider, index: IMemoryStorage, relationBuilder?: RelationBuilder | null);
-    /** 获取最近 N 轮对话历史的回调（由 AgentLoop 通过 bindGetRecentHistory 注入） */
-    private _getRecentHistory;
-    /**
-     * 绑定历史回调（由 assembler 在 AgentLoop 创建后调用，解决构造时序循环依赖）
-     */
-    bindGetRecentHistory(fn: (rounds: number) => Array<{
-        role: 'user' | 'assistant';
-        content: string;
-    }>): void;
-    /**
-     * 绑定冲突检测回调（委托给 RelationBuilder）
-     *
-     * 由 Agent.init() 在创建 InsightExtractor 后调用（与 bindGetRecentHistory 同模式），
-     * 解决 Agent 实例晚于 InsightExtractor 创建的时序循环依赖。
-     * RelationBuilder.buildRelations 检测到 contradicts 关系时调用此回调，Agent 在回调中 emit('conflictDetected')。
-     *
-     * @param fn 冲突检测回调（传入 null 可解除绑定）
-     */
-    bindOnConflict(fn: ((info: ConflictInfo) => void) | null): void;
-    /**
-     * 设置宿主记忆关键词（输入分类 Layer 2）
-     */
-    setKeywords(keywords: MemoryKeywords): void;
-    /**
-     * 设置写入扩展回调
-     */
-    setWriteExtensions(ext: WriteExtensions | null): void;
-    /**
-     * 输入分类三层架构（串联）
-     *
-     * Layer 1: 通用规则（Memora 内置，零成本）
-     * Layer 2: 宿主关键词（宿主提供，零成本）
-     * Layer 3: 默认 extract + 后台异步精判修正
-     *
-     * @returns 'skip' 或 'extract'
-     */
-    classify(input: string): 'skip' | 'extract';
-    /**
-     * 提取对话中的 insight（每轮异步提取）
-     *
-     * 流程：
-     * 1. 调用 LLM 提取 insight（异步，不阻塞主对话）
-     * 2. 去重检查（防止重复写入）
-     * 3. 写入 SQLite（source='insight', score=0.5）
-     */
-    extract(userInput: string, assistantContent: string): Promise<Memory[]>;
-    /**
-     * 计算 Jaccard 相似度（词级，基于 ICU 分词）
-     *
-     * 使用 segmentText（Intl.Segmenter ICU 分词）替代 split(/\s+/)，
-     * 正确处理中文（中文无空格分隔，split 会把整段中文当作一个"词"导致相似度失效）。
-     * 与 recall.ts extractKeywords 保持一致的分词策略。
-     */
-    private jaccardSimilarity;
-    /**
-     * 根据 LLM 返回的质量分级设置 score
-     * high → 0.8（优先召回）
-     * medium → 0.5（默认值）
-     * low → 0.2（快速衰减）
-     */
-    private scoreByQuality;
-    /**
-     * 利用 LLM 返回的 tags 生成语义化 name
-     *
-     * name 格式：`{清洗后的tag}-{uuid前6位}`（如 "偏好-a1b2c3"）
-     * - 取 tags 数组第一个非空 tag
-     * - 清洗 tag：保留中文/字母/数字，移除其他字符，取前 8 字符
-     * - UUID 前缀保证唯一性，tag 前缀提升 UI 可读性
-     * - 无 tags 或清洗后为空时，回退到 `insight-{uuid前8位}`
-     *
-     * @param tagsRaw - LLM 返回的 tags 字段（类型未知，需运行时校验）
-     * @param insightId - UUID，用于保证 name 唯一性
-     * @returns 语义化 name 字符串
-     */
-    private generateSemanticName;
-    /**
-     * Layer 1: 通用规则过滤
-     *
-     * 零成本规则过滤：短输入、问候、确认等无信息量输入 → skip
-     */
-    private classifyByRules;
-    /**
-     * Layer 2: 宿主关键词匹配
-     *
-     * 宿主提供的领域关键词和用户专属关键词匹配。
-     */
-    private classifyByHostKeywords;
-}
-//# sourceMappingURL=insightExtractor.d.ts.map

package/dist/agent/managers/insightExtractor.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"insightExtractor.d.ts","sourceRoot":"","sources":["../../../src/agent/managers/insightExtractor.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AACH,OAAO,KAAK,EAAE,WAAW,EAAW,MAAM,mBAAmB,CAAC;AAC9D,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,mBAAmB,CAAC;AAGhD,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,8BAA8B,CAAC;AAInE,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,yBAAyB,CAAC;AAG/D,OAAO,KAAK,EAAE,eAAe,EAAE,YAAY,EAAE,MAAM,qCAAqC,CAAC;AAkCzF;;;;;GAKG;AACH,MAAM,WAAW,cAAc;IAC7B,4CAA4C;IAC5C,MAAM,EAAE,MAAM,EAAE,CAAC;IACjB,yCAAyC;IACzC,QAAQ,EAAE,MAAM,EAAE,CAAC;CACpB;AAsFD,qBAAa,gBAAgB;IAoBzB,OAAO,CAAC,QAAQ,CAAC,QAAQ;IACzB,OAAO,CAAC,QAAQ,CAAC,KAAK;IApBxB,iCAAiC;IACjC,OAAO,CAAC,YAAY,CAA+B;IAEnD,+BAA+B;IACxB,eAAe,EAAE,eAAe,GAAG,IAAI,CAAQ;IAEtD;;;OAGG;IACH,OAAO,CAAC,QAAQ,CAAC,eAAe,CAAyB;IAEzD;;;;;OAKG;gBAEgB,QAAQ,EAAE,WAAW,EACrB,KAAK,EAAE,cAAc,EACtC,eAAe,GAAE,eAAe,GAAG,IAAW;IAOhD,8DAA8D;IAC9D,OAAO,CAAC,iBAAiB,CAA6E;IAEtG;;OAEG;IACH,oBAAoB,CAClB,EAAE,EAAE,CAAC,MAAM,EAAE,MAAM,KAAK,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,GAAG,WAAW,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE,CAAC,GAC7E,IAAI;IAIP;;;;;;;;OAQG;IACH,cAAc,CAAC,EAAE,EAAE,CAAC,CAAC,IAAI,EAAE,YAAY,KAAK,IAAI,CAAC,GAAG,IAAI,GAAG,IAAI;IAM/D;;OAEG;IACH,WAAW,CAAC,QAAQ,EAAE,cAAc,GAAG,IAAI;IAQ3C;;OAEG;IACH,kBAAkB,CAAC,GAAG,EAAE,eAAe,GAAG,IAAI,GAAG,IAAI;IAOrD;;;;;;;;OAQG;IACH,QAAQ,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS;IAe3C;;;;;;;OAOG;IACG,OAAO,CAAC,SAAS,EAAE,MAAM,EAAE,gBAAgB,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC;IA2I7E;;;;;;OAMG;IACH,OAAO,CAAC,iBAAiB;IAQzB;;;;;OAKG;IACH,OAAO,CAAC,cAAc;IAQtB;;;;;;;;;;;;OAYG;IACH,OAAO,CAAC,oBAAoB;IAyB5B;;;;OAIG;IACH,OAAO,CAAC,eAAe;IAUvB;;;;OAIG;IACH,OAAO,CAAC,sBAAsB;CAU/B"}