@zooique/memora 2.0.3 → 3.0.1

package/dist/memory/inMemorySessionViewLoader.js

@@ -0,0 +1,183 @@
+/**
+ * 内存会话视图加载器 — ISessionViewLoader 的内存版实现
+ *
+ * 职责：将 Session（Round ID 列表）+ RoundStore（物理存储）组合成完整视图
+ *
+ * 使用场景：
+ * - 宿主生产：宿主封装本类并注入文件系统存储（VS Code 宿主 WorkspaceSessionViewLoader
+ *   即委托本类，入口 extension.ts → sessionViewLoader.ts:delegate）
+ * - 测试环境（零依赖）
+ * - 开发调试
+ */
+// 会话显示名回退单一真理源（displayName→autoName），sessionId 兜底留在调用端
+import { getSessionDisplayName } from '../memory/sessionStore.js';
+import { flattenRoundsToMessages, truncateRoundsUpTo, countMessagesInRounds, } from '../memory/sessionViewLoader.js';
+/**
+ * 内存会话视图加载器
+ *
+ * 实现策略：
+ * 1. 从 SessionStore 获取 SessionMeta（含 roundIds）
+ * 2. 从 RoundStore 批量加载所有 Round
+ * 3. 展开为扁平消息列表
+ * 4. 支持截断操作（分叉场景）
+ */
+export class InMemorySessionViewLoader {
+    roundStore;
+    sessionStore;
+    constructor(roundStore, sessionStore) {
+        this.roundStore = roundStore;
+        this.sessionStore = sessionStore;
+    }
+    /**
+     * 加载会话的完整对话视图
+     *
+     * 流程：
+     * 1. 获取 SessionMeta（含 roundIds 列表）
+     * 2. 从 RoundStore 批量加载所有 Round
+     * 3. 展开为扁平消息列表
+     *
+     * @param sessionId - 会话 ID
+     * @returns 完整会话视图
+     * @throws Error 会话不存在时抛出
+     */
+    loadView(sessionId) {
+        // 1. 获取会话元数据
+        const meta = this.getSessionMeta(sessionId);
+        if (!meta) {
+            throw new Error(`会话不存在: ${sessionId}`);
+        }
+        // 2. 获取 Round ID 列表
+        const roundIds = this.getRoundIds(sessionId);
+        // 3. 批量加载 Round
+        const rounds = this.roundStore.getByIds(roundIds);
+        // 4. 展开为扁平消息列表
+        const messages = flattenRoundsToMessages(rounds);
+        return {
+            sessionId,
+            meta,
+            rounds,
+            messages,
+        };
+    }
+    /**
+     * 加载会话的简化摘要（用于历史列表等轻量场景）
+     *
+     * @param sessionId - 会话 ID
+     * @returns 会话摘要，不存在返回 null
+     */
+    loadSummary(sessionId) {
+        // 获取会话元数据
+        const meta = this.getSessionMeta(sessionId);
+        if (!meta)
+            return null;
+        // 获取 Round ID 列表
+        const roundIds = this.getRoundIds(sessionId);
+        // 加载最后一个 Round（用于预览）
+        const lastRoundId = roundIds[roundIds.length - 1];
+        let lastMessagePreview;
+        if (lastRoundId) {
+            const lastRound = this.roundStore.getById(lastRoundId);
+            if (lastRound) {
+                // 取 AI 消息的前 50 个字符作为预览
+                if (lastRound.assistantMessage) {
+                    lastMessagePreview = lastRound.assistantMessage.content.slice(0, 50);
+                    if (lastRound.assistantMessage.content.length > 50) {
+                        lastMessagePreview += '...';
+                    }
+                }
+            }
+        }
+        // 计算标题（SSOT 显示名回退 displayName→autoName，sessionId 作最后兜底）
+        const title = getSessionDisplayName(meta) || sessionId;
+        return {
+            sessionId,
+            title,
+            roundCount: roundIds.length,
+            updatedAt: meta.updatedAt,
+            lastMessagePreview,
+        };
+    }
+    /**
+     * 批量加载多个会话的摘要
+     *
+     * @param sessionIds - 会话 ID 数组
+     * @returns 会话摘要数组
+     */
+    loadBatchSummaries(sessionIds) {
+        const summaries = [];
+        for (const sessionId of sessionIds) {
+            const summary = this.loadSummary(sessionId);
+            if (summary) {
+                summaries.push(summary);
+            }
+        }
+        // 按 updatedAt 降序排列
+        summaries.sort((a, b) => {
+            return b.updatedAt > a.updatedAt ? 1 : b.updatedAt < a.updatedAt ? -1 : 0;
+        });
+        return summaries;
+    }
+    /**
+     * 获取会话的消息数量
+     *
+     * 不加载完整 Round 数据，仅统计消息数
+     *
+     * @param sessionId - 会话 ID
+     * @returns 消息数量（User + AI）
+     */
+    getMessageCount(sessionId) {
+        const meta = this.getSessionMeta(sessionId);
+        if (!meta)
+            return 0;
+        return meta.messageCount;
+    }
+    /**
+     * 从指定 Round 位置截断会话视图
+     *
+     * 用途：分叉操作时获取分叉点之前的对话
+     *
+     * @param sessionId - 会话 ID
+     * @param upToRoundId - 截断到哪个 Round（包含）
+     * @returns 截断后的会话视图
+     */
+    loadViewUpTo(sessionId, upToRoundId) {
+        // 1. 获取完整视图
+        const fullView = this.loadView(sessionId);
+        // 2. 截断 Round 列表
+        const truncatedRounds = truncateRoundsUpTo(fullView.rounds, upToRoundId);
+        // 3. 重新展开消息列表
+        const messages = flattenRoundsToMessages(truncatedRounds);
+        // 4. 更新元数据中的消息数
+        const updatedMeta = {
+            ...fullView.meta,
+            messageCount: countMessagesInRounds(truncatedRounds),
+        };
+        return {
+            sessionId,
+            meta: updatedMeta,
+            rounds: truncatedRounds,
+            messages,
+        };
+    }
+    // ─── 私有辅助方法 ─────────────────────────────────────
+    /**
+     * 获取会话元数据
+     *
+     * 直接走 sessionStore.getSessionMeta——ISessionStore 接口**必选**方法（sessionStore.ts 契约），
+     * 宿主与内核实现均齐备。返回浅拷贝防外部改 meta 污染存储。
+     */
+    getSessionMeta(sessionId) {
+        const meta = this.sessionStore.getSessionMeta(sessionId);
+        return meta ? { ...meta } : null;
+    }
+    /**
+     * 获取会话的 Round ID 列表（SSOT：唯一真源为 sessionStore.getRoundIds）
+     *
+     * SessionMeta 已回归纯展示 DTO（无 roundIds 字段），轮次一律经真源方法读取。
+     * 接口契约保证返回 string[]（非空数组也可能），直接展开即可，无需存在性判断。
+     */
+    getRoundIds(sessionId) {
+        return [...this.sessionStore.getRoundIds(sessionId)];
+    }
+}
+//# sourceMappingURL=inMemorySessionViewLoader.js.map

package/dist/memory/inMemorySessionViewLoader.js.map

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

package/dist/memory/inMemoryStorage.d.ts

@@ -1,207 +1,57 @@
 /**
- * 内存存储实现 — IMemoryStorage 的纯 JS 内存实现
- *
- * 零依赖、零 IO，适用于：
- * - 单元测试（不需要 better-sqlite3，不需要文件系统）
- * - 宿主项目注入前的临时占位
- * - 沙箱/演示环境
- *
- * 注意：此实现不持久化，进程退出后数据丢失。
- * ⚠️ 仅限测试/开发使用，生产环境请注入 SqliteStorage（宿主项目提供）。
+ * 内存存储实现 — IMemoryStorage 的纯 JS 内存版。
+ * 零依赖零 IO，用于单元测试、宿主注入前的临时占位、沙箱。不持久化（进程退出即丢失），
+ * 仅限测试/开发；生产由宿主注入持久化实现（当前 vscode 宿主为 WorkspaceStorage，JSON 文件落地）。
  */
 import type { IMemoryStorage } from '../memory/storageInterface.js';
 import type { Memory } from '../memory/types.js';
 /**
- * 内存存储实现
- *
- * 使用 Map 存储记忆，核心操作 O(1)~O(log n)。
- * 优化：维护 source→count 增量缓存，stats()/sourceHealth() 无需全量遍历。
+ * 内存存储：Map 存储，核心操作 O(1)~O(log n)。
+ * 维护 source→count 增量缓存，stats()/sourceHealth() 无需全量遍历。
  */
 export declare class InMemoryStorage implements IMemoryStorage {
     /** 记忆存储（id → Memory） */
     private memories;
-    /** source→count 增量缓存（upsert/delete 时维护，getAllSources 时直接读取） */
+    /** source→count 增量缓存（upsert/delete 时维护，getAllSources 直接读取） */
     private sourceCountCache;
     /**
-     * 插入或更新记忆
-     *
-     * 自动校验 source 字段，对疑似 typo 发出警告日志。
-     * 增量维护 sourceCountCache（仅统计活跃记忆）：
-     *   - 新增活跃记忆：source 计数 +1
-     *   - 更新同 source 同活跃态：计数不变
-     *   - 更新换 source：旧 source -1、新 source +1
-     * 软删除状态转换维护：
-     *   - 活跃 → 软删除：source 计数 -1
-     *   - 软删除 → 活跃：source 计数 +1
-     *
-     * 软删除校验：
-     *   若 existing 已软删除（deletedAt !== undefined）且 newMemory 为活跃态
-     *   （deletedAt === undefined），抛出错误阻止"通过 upsert 复活软删除记忆"。
-     *   调用方必须先显式 restore(id) 恢复记忆后再 upsert。
-     *   例外：newMemory 显式带 deletedAt（如测试场景篡改 deletedAt）允许通过，
-     *   因为此时调用方明确意图是覆盖软删除状态而非"复活"。
-     *
-     * 采用 delta 方式：先扣除 existing 的活跃贡献，再加回 newMemory 的活跃贡献。
-     * 该方式可统一处理 source 变更 + 软删除状态变更的所有组合，避免分支爆炸。
+     * upsert：校验 source + 软删除复活拦截 + delta 维护 sourceCountCache。
+     * 增量按 source/软删态加减活跃计数；软删除记忆不能经 upsert 静默复活（须先 restore）。
      */
     upsert(memory: Memory): void;
-    /**
-     * 软删除记忆
-     *
-     * 写入 deletedAt 时间戳，不物理移除 Map 条目。
-     * - 召回/搜索/列表/统计自动过滤已软删除的记忆
-     * - 可通过 restore(id) 恢复
-     * - 回收站保留期过后由 purgeExpired(before) 物理清理
-     *
-     * 对已软删除的记忆调用为 no-op。
-     * 增量维护 sourceCountCache：软删除时对应 source 减 1。
-     */
+    /** 软删除：写 deletedAt 标记不物理移除；可 restore 恢复，过期由 purgeExpired 清理 */
     delete(id: string): void;
-    /**
-     * 恢复软删除的记忆
-     *
-     * 清除 deletedAt 字段，使记忆重新出现在召回/搜索/列表中。
-     * 对活跃记忆调用为 no-op。
-     * 增量维护 sourceCountCache：恢复时对应 source 加 1。
-     */
+    /** 恢复软删除：清除 deletedAt 使记忆重回召回/搜索/列表；活跃态调用为 no-op */
     restore(id: string): void;
-    /**
-     * 物理删除记忆
-     *
-     * 从 Map 中彻底移除，不可恢复。
-     * 用于回收站的"彻底删除"操作，或测试环境的强制清理。
-     *
-     * 注意：若记忆为活跃态（未软删除），purge 也会减 1 计数，
-     * 但正常流程应先软删除再 purge，此时计数已在 delete() 中扣除。
-     */
+    /** 物理删除：从 Map 彻底移除不可恢复；活跃态亦扣减计数（正常流程先 delete 已扣） */
     purge(id: string): void;
-    /**
-     * 列出回收站中的软删除记忆
-     *
-     * 按 deletedAt 降序（最近删除的在前），便于回收站 UI 展示。
-     * 返回浅拷贝，避免调用方修改污染存储内部对象。
-     *
-     * @param limit - 返回数量上限。`limit <= 0` 或 `undefined` 表示不设上限（返回全部）；
-     *                正整数 N 表示返回最近 N 条。默认 undefined（全部）。
-     * @returns 软删除记忆列表（副本）
-     */
+    /** 列出软删除记忆，按 deletedAt 降序；limit<=0 或 undefined 表示不设上限（返回全部） */
     listDeleted(limit?: number): Memory[];
-    /**
-     * 按 ID 获取单条软删除记忆
-     *
-     * 用于 restore/purge 操作前的存在性校验，避免 listDeleted 默认 50 上限
-     * 导致回收站超量时操作失效。
-     *
-     * @param id 记忆唯一标识
-     * @returns 软删除记忆（浅拷贝），不存在或未软删除时返回 null
-     */
+    /** 按 ID 取单条软删除记忆（浅拷贝）；不存在或未软删除返回 null */
     getDeletedById(id: string): Memory | null;
-    /**
-     * 清理过期的软删除记忆
-     *
-     * 物理删除所有 deletedAt 早于 before 的记忆。
-     * 由宿主项目的定时器调用（默认 30 天保留期）。
-     *
-     * @param before - 时间阈值，deletedAt 早于此值的记忆将被物理删除
-     * @returns 被清理的记忆数量
-     */
+    /** 物理删除 deletedAt 早于 before 的软删除记忆，返回清理数量（宿主定时器默认 30 天保留期调用） */
     purgeExpired(before: Date): number;
-    /**
-     * 按 ID 获取单条活跃记忆（已软删除的返回 null）
-     *
-     * 返回浅拷贝，避免调用方修改污染存储内部对象（接口契约：读取隔离）
-     */
+    /** 按 ID 取活跃记忆（浅拷贝，软删除返回 null，读取隔离契约） */
     getById(id: string): Memory | null;
-    /**
-     * 按来源标签获取活跃记忆（自动过滤已软删除的）
-     *
-     * 返回浅拷贝数组，避免调用方修改污染存储内部对象。
-     *
-     * @param source - 来源标签（如 'persona'、'rule'、'insight'）
-     * @returns 该来源的所有活跃记忆（副本），按 score 降序排列
-     */
+    /** 按 source 取活跃记忆（浅拷贝，自动过滤软删除，accessedAt 降序） */
     getBySource(source: string): Memory[];
-    /**
-     * 文本搜索活跃记忆（自动过滤已软删除的，内存版）
-     *
-     * 使用 segmentText() 规范分词，与 SqliteStorage 行为一致。
-     * 搜索 content 和 name 字段，按 score 降序排列。
-     *
-     * @param query - 搜索查询文本
-     * @param limit - 返回数量上限（默认 10）
-     * @returns 匹配的活跃记忆列表
-     */
+    /** 文本搜索活跃记忆（segmentLower 与 SqliteStorage/keywordsTouch 一致），accessedAt 降序，limit 默认 10 */
     search(query: string, limit?: number): Memory[];
-    /**
-     * 排序 + 截断 + 浅拷贝三件套
-     *
-     * 消除 search() 内 3 次重复的 .sort(byScoreDesc).slice(0, limit).map((m) => ({ ...m })) 模式
-     * （ADR-017 枝叶层 2 次提取原则，3 次重复已超阈值）。
-     *
-     * @param memories 待处理的记忆数组
-     * @param limit 返回数量上限
-     * @returns 排序截断后的浅拷贝记忆数组
-     */
+    /** 排序 + 截断 + 浅拷贝，消除 search 内重复的 pattern */
     private sortCopyLimit;
-    /**
-     * 统计活跃记忆总数（不含已软删除的）
-     *
-     * 优化：直接累加 sourceCountCache 的所有值，O(sources) 复杂度。
-     * 因 sourceCountCache 仅维护活跃记忆计数，求和即为活跃总数。
-     */
+    /** 活跃记忆总数：累加 sourceCountCache（仅维护活跃计数） */
     count(): number;
-    /**
-     * 按来源标签统计记忆数量
-     *
-     * 优化：直接读取 sourceCountCache，O(1) 复杂度
-     * （getAllSources 为 O(sources)，因需拷贝 Map，二者复杂度不同）
-     * 原实现 O(n) 遍历所有记忆，与增量缓存设计不一致
-     */
+    /** 按 source 统计活跃数量，O(1) 读 sourceCountCache */
     countBySource(source: string): number;
-    /**
-     * 衰减指定来源的活跃记忆 score（跳过已软删除的）
-     *
-     * 遍历所有匹配 source 的活跃记忆，按时间衰减。
-     * 生产环境宿主（SqliteStorage）应重写为 SQL UPDATE 批量操作。
-     */
-    decayScores(sources: string[], now: Date): number;
-    /**
-     * 原子增加记忆 score（MIND2-L3：消除 boost read-modify-write 并发冲突）
-     *
-     * score = clamp(score + delta, DECAY_FLOOR, SCORE_CEILING)，同时更新 accessedAt。
-     * JS 单线程下与同步 storage 调用天然原子。
-     *
-     * @param id 记忆 ID
-     * @param delta 增量（正数 boost，负数可降级）
-     * @param now 当前时间（ISO 8601）
-     * @returns 记忆不存在/软删除时返回 false，成功返回 true
-     */
-    incrementScore(id: string, delta: number, now: string): boolean;
-    /**
-     * 原子设置记忆 score 绝对值（MIND2-L3：消除 demote spread 旧快照覆盖其他字段）
-     *
-     * 直接设置 score = newScore，不 clamp（调用方负责传合法值）。同时更新 accessedAt。
-     *
-     * @param id 记忆 ID
-     * @param newScore 新 score 绝对值
-     * @param now 当前时间（ISO 8601）
-     * @returns 记忆不存在/软删除时返回 false，成功返回 true
-     */
-    setScore(id: string, newScore: number, now: string): boolean;
-    /**
-     * 获取所有 source 标签及其记忆数量
-     *
-     * 优化：直接读取增量维护的 sourceCountCache。
-     * 复杂度为 O(sources)（拷贝 Map），相比全量遍历 O(n) 仍有显著优化。
-     */
+    /** 刷新 accessedAt（score 退役后的唯一写位）；不存在/软删返回 false */
+    touch(id: string, now: string): boolean;
+    /** 全部 source 及活跃计数（拷贝 Map，O(sources)） */
     getAllSources(): Map<string, number>;
-    /**
-     * 关闭（内存实现无需关闭）
-     */
+    /** 关闭即丢弃全部记忆（终结操作不可逆）；勿在会话暂停/检查点恢复等状态层动作调用 */
     close(): void;
     /** source 计数 +1 */
     private incrementSourceCount;
-    /** source 计数 -1（减至 0 时移除键） */
+    /** source 计数 -1（减至 0 移除键） */
     private decrementSourceCount;
 }
 //# sourceMappingURL=inMemoryStorage.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"inMemoryStorage.d.ts","sourceRoot":"","sources":["../../src/memory/inMemoryStorage.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AACH,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,8BAA8B,CAAC;AACnE,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,mBAAmB,CAAC;AAUhD;;;;;GAKG;AACH,qBAAa,eAAgB,YAAW,cAAc;IACpD,wBAAwB;IACxB,OAAO,CAAC,QAAQ,CAAkC;IAElD,+DAA+D;IAC/D,OAAO,CAAC,gBAAgB,CAAkC;IAE1D;;;;;;;;;;;;;;;;;;;;;OAqBG;IACH,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI;IA2C5B;;;;;;;;;;OAUG;IACH,MAAM,CAAC,EAAE,EAAE,MAAM,GAAG,IAAI;IAWxB;;;;;;OAMG;IACH,OAAO,CAAC,EAAE,EAAE,MAAM,GAAG,IAAI;IAWzB;;;;;;;;OAQG;IACH,KAAK,CAAC,EAAE,EAAE,MAAM,GAAG,IAAI;IAUvB;;;;;;;;;OASG;IACH,WAAW,CAAC,KAAK,CAAC,EAAE,MAAM,GAAG,MAAM,EAAE;IAYrC;;;;;;;;OAQG;IACH,cAAc,CAAC,EAAE,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI;IAOzC;;;;;;;;OAQG;IACH,YAAY,CAAC,MAAM,EAAE,IAAI,GAAG,MAAM;IAalC;;;;OAIG;IACH,OAAO,CAAC,EAAE,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI;IAOlC;;;;;;;OAOG;IACH,WAAW,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,EAAE;IAOrC;;;;;;;;;OASG;IACH,MAAM,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,SAAK,GAAG,MAAM,EAAE;IA2B3C;;;;;;;;;OASG;IACH,OAAO,CAAC,aAAa;IAOrB;;;;;OAKG;IACH,KAAK,IAAI,MAAM;IAMf;;;;;;OAMG;IACH,aAAa,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM;IAIrC;;;;;OAKG;IACH,WAAW,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE,GAAG,EAAE,IAAI,GAAG,MAAM;IAajD;;;;;;;;;;OAUG;IACH,cAAc,CAAC,EAAE,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,OAAO;IAU/D;;;;;;;;;OASG;IACH,QAAQ,CAAC,EAAE,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,OAAO;IAQ5D;;;;;OAKG;IACH,aAAa,IAAI,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC;IAIpC;;OAEG;IACH,KAAK,IAAI,IAAI;IAQb,mBAAmB;IACnB,OAAO,CAAC,oBAAoB;IAI5B,8BAA8B;IAC9B,OAAO,CAAC,oBAAoB;CAS7B"}
+{"version":3,"file":"inMemoryStorage.d.ts","sourceRoot":"","sources":["../../src/memory/inMemoryStorage.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,8BAA8B,CAAC;AACnE,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,mBAAmB,CAAC;AAQhD;;;GAGG;AACH,qBAAa,eAAgB,YAAW,cAAc;IACpD,wBAAwB;IACxB,OAAO,CAAC,QAAQ,CAAkC;IAClD,8DAA8D;IAC9D,OAAO,CAAC,gBAAgB,CAAkC;IAE1D;;;OAGG;IACH,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI;IAqC5B,+DAA+D;IAC/D,MAAM,CAAC,EAAE,EAAE,MAAM,GAAG,IAAI;IAQxB,oDAAoD;IACpD,OAAO,CAAC,EAAE,EAAE,MAAM,GAAG,IAAI;IAQzB,oDAAoD;IACpD,KAAK,CAAC,EAAE,EAAE,MAAM,GAAG,IAAI;IASvB,+DAA+D;IAC/D,WAAW,CAAC,KAAK,CAAC,EAAE,MAAM,GAAG,MAAM,EAAE;IAUrC,yCAAyC;IACzC,cAAc,CAAC,EAAE,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI;IAMzC,gEAAgE;IAChE,YAAY,CAAC,MAAM,EAAE,IAAI,GAAG,MAAM;IAYlC,wCAAwC;IACxC,OAAO,CAAC,EAAE,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI;IAMlC,gDAAgD;IAChD,WAAW,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,EAAE;IAOrC,wFAAwF;IACxF,MAAM,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,SAAK,GAAG,MAAM,EAAE;IAoB3C,2CAA2C;IAC3C,OAAO,CAAC,aAAa;IAOrB,0CAA0C;IAC1C,KAAK,IAAI,MAAM;IAMf,8CAA8C;IAC9C,aAAa,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM;IAIrC,mDAAmD;IACnD,KAAK,CAAC,EAAE,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,OAAO;IAOvC,yCAAyC;IACzC,aAAa,IAAI,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC;IAIpC,8CAA8C;IAC9C,KAAK,IAAI,IAAI;IAKb,mBAAmB;IACnB,OAAO,CAAC,oBAAoB;IAI5B,6BAA6B;IAC7B,OAAO,CAAC,oBAAoB;CAS7B"}