@zooique/memora 2.0.3 → 3.0.0

package/dist/memory/vectorStore.d.ts

@@ -1,179 +0,0 @@
-import type { EmbeddingOptions } from '../llm/embedding.js';
-/**
- * 嵌入服务接口
- * 向量存储依赖此接口生成文本嵌入向量
- *
- * batchEmbed 返回向量数组，顺序与输入一致。
- * EmbeddingProvider（llm/embedding.ts）满足此接口（结构子类型）。
- *
- * 韧性补齐：embed/batchEmbed 接受 EmbeddingOptions（signal + timeoutMs），
- * 宿主在用户取消对话时可透传 AbortSignal 中断 embedding 请求。
- */
-export interface EmbeddingService {
-    embed(text: string, options?: EmbeddingOptions): Promise<number[]>;
-    batchEmbed(texts: string[], options?: EmbeddingOptions): Promise<Array<{
-        text: string;
-        vector: number[];
-    }>>;
-}
-/**
- * 向量存储接口（依赖倒置）
- *
- * 抽出接口让宿主可注入自定义实现（如 SqliteVectorStore / LanceDBVectorStore），
- * 内核消费者（recall.ts / memoryInspector.ts / agent.ts）只依赖此接口，
- * 不耦合具体持久化方式（JSON / SQLite / 外部向量库）。
- *
- * 与 IMemoryStorage / IMemoryRelationStore / ILogger / ITracer 同属
- * 内核六大注入接口，遵循 ADR-002 存储层抽象原则。
- *
- * 内核内置实现：JsonVectorStore（JSON 文件持久化，单用户本地场景）。
- */
-export interface IVectorStore {
-    /** 从持久化介质加载向量索引（冷启动） */
-    load(): Promise<void>;
-    /** 持久化向量索引到介质 */
-    save(): Promise<void>;
-    /**
-     * 为文本生成向量并存储
-     * @param id 记忆 ID
-     * @param text 待嵌入的文本
-     * @param options embedding 调用选项（signal 外部取消 + timeoutMs 超时）
-     */
-    upsert(id: string, text: string, options?: EmbeddingOptions): Promise<void>;
-    /**
-     * 批量嵌入并存储
-     * @param items ID + 文本对
-     * @param options embedding 调用选项（signal 外部取消 + timeoutMs 超时）
-     */
-    batchUpsert(items: Array<{
-        id: string;
-        text: string;
-    }>, options?: EmbeddingOptions): Promise<void>;
-    /**
-     * 删除向量并立即持久化
-     *
-     * 与 upsert（标记 dirty 由调用方 save）不同，delete 是低频操作，
-     * 立即 save 可防止崩溃后已删除向量在下次冷启动复活（FIX-P0-9）。
-     *
-     * @param id 待删除的记忆 ID
-     */
-    delete(id: string): Promise<void>;
-    /**
-     * 语义搜索：基于查询文本的向量，返回 topK 最相似的 ID
-     * @param query 查询文本
-     * @param topK 返回数量上限
-     * @param minSimilarity 最低相似度阈值（0~1）
-     * @param options embedding 调用选项（signal 外部取消 + timeoutMs 超时）
-     * @returns ID + 相似度 对的数组，按相似度降序排列
-     */
-    search(query: string, topK?: number, minSimilarity?: number, options?: EmbeddingOptions): Promise<Array<{
-        id: string;
-        similarity: number;
-    }>>;
-    /** 获取存储的向量数量 */
-    readonly size: number;
-}
-/**
- * JSON 持久化向量存储（IVectorStore 内核内置实现）
- *
- * 纯 JS 实现，内存中维护向量索引，定期持久化到 JSON 文件
- * 适用于单用户本地场景（5k 条记录以内）
- *
- * 依赖 EmbeddingService 接口（依赖倒置，与 llm/ 层解耦）
- * 实现 IVectorStore 接口，宿主可替换为其他实现（如 SqliteVectorStore）
- */
-export declare class JsonVectorStore implements IVectorStore {
-    private readonly storePath;
-    private readonly embeddingProvider;
-    /** 内存中的向量索引 */
-    private entries;
-    /** 向量维度（由第一个插入的向量决定） */
-    private dimension;
-    /** 是否有未持久化的变更 */
-    private dirty;
-    /**
-     * 串行化 save 调用的 Promise 链
-     *
-     * 防止并发 save 互相覆盖：每个 save 等待前一个完成后再执行。
-     * 无并发时为 null，有并发时为正在执行的 Promise。
-     */
-    private savePromise;
-    constructor(storePath: string, embeddingProvider: EmbeddingService);
-    /**
-     * 从 JSON 文件加载向量索引（冷启动）
-     *
-     * 加固：增加 schema 校验，损坏文件视为"从空开始"
-     * 防止部分写入 / 手动编辑错误 / 版本不匹配的文件污染内存索引
-     */
-    load(): Promise<void>;
-    /**
-     * 将损坏的向量索引文件备份为 .corrupt.<timestamp>，便于人工恢复或 re-embed，
-     * 避免 load 直接「从空开始」导致原始损坏数据被静默覆盖、不可逆丢失。
-     */
-    private backupCorrupt;
-    /**
-     * 持久化向量索引到 JSON 文件
-     *
-     * 加固：串行化并发 save，防止互相覆盖丢失数据。
-     * 调用方可在并发场景下安全地多次调用 save，每次都会等待前一次完成。
-     *
-     * @returns 等待所有挂起 save 完成的 Promise
-     */
-    save(): Promise<void>;
-    /**
-     * 实际执行持久化的内部方法
-     *
-     * 由 save() 串行化调度，外部不应直接调用
-     */
-    private doSave;
-    /**
-     * 为文本生成向量并存储
-     *
-     * 加固：维度一致性校验，防止维度错位导致 cosineSimilarity 计算崩溃
-     *
-     * @param id 记忆 ID
-     * @param text 待嵌入的文本
-     * @param options embedding 调用选项（signal 外部取消 + timeoutMs 超时）
-     * @throws {MemoraError} 当 embedding 返回的向量维度与已存维度不一致时抛出 configError
-     */
-    upsert(id: string, text: string, options?: EmbeddingOptions): Promise<void>;
-    /**
-     * 批量嵌入并存储
-     *
-     * 加固：维度一致性校验，与 upsert 同契约
-     *
-     * @param items ID + 文本对
-     * @param options embedding 调用选项（signal 外部取消 + timeoutMs 超时）
-     * @throws {MemoraError} 当 embedding 返回的向量维度与已存维度不一致时抛出 configError
-     */
-    batchUpsert(items: Array<{
-        id: string;
-        text: string;
-    }>, options?: EmbeddingOptions): Promise<void>;
-    /**
-     * 删除向量并立即持久化
-     *
-     * FIX-P0-9：原实现仅标记 dirty=true 不 save，崩溃时已删除向量会在下次冷启动复活。
-     * 现改为 async + 立即 save（与 upsert 不对称合理——delete 是低频操作，立即持久化代价可控）。
-     *
-     * @param id 待删除的记忆 ID
-     */
-    delete(id: string): Promise<void>;
-    /**
-     * 语义搜索：基于查询文本的向量，返回 topK 最相似的 ID
-     * @param query 查询文本
-     * @param topK 返回数量上限
-     * @param minSimilarity 最低相似度阈值（0~1）
-     * @param options embedding 调用选项（signal 外部取消 + timeoutMs 超时）
-     * @returns ID + 相似度 对的数组，按相似度降序排列
-     */
-    search(query: string, topK?: number, minSimilarity?: number, options?: EmbeddingOptions): Promise<Array<{
-        id: string;
-        similarity: number;
-    }>>;
-    /**
-     * 获取存储的向量数量
-     */
-    get size(): number;
-}
-//# sourceMappingURL=vectorStore.d.ts.map

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

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

package/dist/memory/vectorStore.js

@@ -1,284 +0,0 @@
-/**
- * 向量存储 — 纯 JS 实现，内存 + JSON 持久化
- *
- * 语义检索的向量索引层：
- * - 存储记忆 ID → 向量的映射
- * - 支持余弦相似度搜索（topK）
- * - 持久化到 JSON 文件（冷启动时加载）
- *
- * 设计原则：
- * - 0 新 npm 依赖（不引入 sqlite-vec / LanceDB 等外部向量库）
- * - 单用户本地场景，5k 条记录内纯 JS 余弦相似度 < 10ms
- * - 向量维度由 embedding 模型决定，存储层不关心
- *
- * 加固点：
- * - load() 增加 schema 校验（防止损坏文件污染内存索引）
- * - upsert/batchUpsert 增加维度一致性校验（防止维度错位导致相似度计算崩溃）
- * - save() 串行化（防止并发 save 互相覆盖丢失数据）
- * - delete() 立即 save（FIX-P0-9：防止崩溃后已删除向量复活）
- *
- * 详见 ADR-002 · 存储层抽象（向量检索备选方案）
- * 详见 ADR-013 · 记忆归档三步价值过滤
- */
-import { readFile, writeFile, mkdir, rename } from 'node:fs/promises';
-import { dirname } from 'node:path';
-import { logger } from '../logging/logger.js';
-import { configError } from '../utils/errors.js';
-import { cosineSimilarity } from '../utils/math.js';
-/**
- * 校验持久化文件是否符合 VectorStoreFile schema
- *
- * 防止损坏文件 / 旧版格式 / 手动编辑错误污染内存索引。
- * 校验项：
- *   - 顶层为对象
- *   - version === 1（未来版本需迁移逻辑）
- *   - dimension 为非负整数
- *   - entries 为数组，每个条目含字符串 id 和数字数组 vector
- *   - 所有 vector 长度等于 dimension
- *
- * @param data 已 JSON.parse 的对象
- * @returns true 表示通过校验
- */
-function isValidVectorStoreFile(data) {
-    if (typeof data !== 'object' || data === null)
-        return false;
-    const obj = data;
-    if (obj.version !== 1)
-        return false;
-    if (typeof obj.dimension !== 'number' || !Number.isInteger(obj.dimension) || obj.dimension < 0) {
-        return false;
-    }
-    if (!Array.isArray(obj.entries))
-        return false;
-    for (const entry of obj.entries) {
-        if (typeof entry !== 'object' || entry === null)
-            return false;
-        const e = entry;
-        if (typeof e.id !== 'string' || e.id.length === 0)
-            return false;
-        if (!Array.isArray(e.vector))
-            return false;
-        if (!e.vector.every((v) => typeof v === 'number' && Number.isFinite(v)))
-            return false;
-        if (e.vector.length !== obj.dimension)
-            return false;
-    }
-    return true;
-}
-/**
- * JSON 持久化向量存储（IVectorStore 内核内置实现）
- *
- * 纯 JS 实现，内存中维护向量索引，定期持久化到 JSON 文件
- * 适用于单用户本地场景（5k 条记录以内）
- *
- * 依赖 EmbeddingService 接口（依赖倒置，与 llm/ 层解耦）
- * 实现 IVectorStore 接口，宿主可替换为其他实现（如 SqliteVectorStore）
- */
-export class JsonVectorStore {
-    storePath;
-    embeddingProvider;
-    /** 内存中的向量索引 */
-    entries = new Map();
-    /** 向量维度（由第一个插入的向量决定） */
-    dimension = 0;
-    /** 是否有未持久化的变更 */
-    dirty = false;
-    /**
-     * 串行化 save 调用的 Promise 链
-     *
-     * 防止并发 save 互相覆盖：每个 save 等待前一个完成后再执行。
-     * 无并发时为 null，有并发时为正在执行的 Promise。
-     */
-    savePromise = null;
-    constructor(storePath, embeddingProvider) {
-        this.storePath = storePath;
-        this.embeddingProvider = embeddingProvider;
-    }
-    /**
-     * 从 JSON 文件加载向量索引（冷启动）
-     *
-     * 加固：增加 schema 校验，损坏文件视为"从空开始"
-     * 防止部分写入 / 手动编辑错误 / 版本不匹配的文件污染内存索引
-     */
-    async load() {
-        let content;
-        try {
-            content = await readFile(this.storePath, 'utf-8');
-        }
-        catch {
-            // 文件不存在，从空开始（正常冷启动路径）
-            logger.info({ path: this.storePath }, '向量索引文件不存在，从空开始');
-            return;
-        }
-        try {
-            const data = JSON.parse(content);
-            // schema 校验：损坏 / 格式错误的文件视为"从空开始"，但先备份以免数据不可逆丢失
-            if (!isValidVectorStoreFile(data)) {
-                await this.backupCorrupt();
-                logger.warn({ path: this.storePath }, '向量索引文件格式无效，已从空开始并备份损坏文件');
-                return;
-            }
-            this.dimension = data.dimension;
-            this.entries.clear();
-            for (const entry of data.entries) {
-                this.entries.set(entry.id, entry.vector);
-            }
-            this.dirty = false;
-            logger.info({ count: this.entries.size, dimension: this.dimension }, '向量索引加载完成');
-        }
-        catch {
-            // JSON 解析失败（文件半写 / 手动损坏），从空开始并备份
-            await this.backupCorrupt();
-            logger.warn({ path: this.storePath }, '向量索引文件解析失败，已从空开始并备份损坏文件');
-        }
-    }
-    /**
-     * 将损坏的向量索引文件备份为 .corrupt.<timestamp>，便于人工恢复或 re-embed，
-     * 避免 load 直接「从空开始」导致原始损坏数据被静默覆盖、不可逆丢失。
-     */
-    async backupCorrupt() {
-        try {
-            await rename(this.storePath, `${this.storePath}.corrupt.${Date.now()}`);
-        }
-        catch (err) {
-            logger.warn({ err, path: this.storePath }, '备份损坏向量索引文件失败（不影响从空开始）');
-        }
-    }
-    /**
-     * 持久化向量索引到 JSON 文件
-     *
-     * 加固：串行化并发 save，防止互相覆盖丢失数据。
-     * 调用方可在并发场景下安全地多次调用 save，每次都会等待前一次完成。
-     *
-     * @returns 等待所有挂起 save 完成的 Promise
-     */
-    async save() {
-        // 串行化：将本次 save 追加到既有链尾（或开启新链），确保多个 save 严格顺序执行。
-        // 仅当本节点仍是链尾（未被更新的 save 取代）时才在完成后清空引用，
-        // 避免旧实现「.finally 直接置 null」把仍在飞行的后续 save 链引用截断，导致并发写。
-        const p = (this.savePromise ?? Promise.resolve()).then(() => this.doSave());
-        this.savePromise = p;
-        p.finally(() => {
-            if (this.savePromise === p)
-                this.savePromise = null;
-        });
-        return p;
-    }
-    /**
-     * 实际执行持久化的内部方法
-     *
-     * 由 save() 串行化调度，外部不应直接调用
-     */
-    async doSave() {
-        if (!this.dirty)
-            return;
-        const data = {
-            version: 1,
-            dimension: this.dimension,
-            entries: Array.from(this.entries.entries()).map(([id, vector]) => ({ id, vector })),
-        };
-        await mkdir(dirname(this.storePath), { recursive: true });
-        // M9 修复：先写临时文件再原子 rename，避免写一半崩溃导致 vectors.json 损坏、
-        // 下次加载 isValidVectorStoreFile 失败而整库向量静默清空（向量索引昂贵且只能重算）。
-        const tmpPath = `${this.storePath}.tmp`;
-        await writeFile(tmpPath, JSON.stringify(data), 'utf-8');
-        await rename(tmpPath, this.storePath);
-        this.dirty = false;
-        logger.info({ count: this.entries.size }, '向量索引持久化完成');
-    }
-    /**
-     * 为文本生成向量并存储
-     *
-     * 加固：维度一致性校验，防止维度错位导致 cosineSimilarity 计算崩溃
-     *
-     * @param id 记忆 ID
-     * @param text 待嵌入的文本
-     * @param options embedding 调用选项（signal 外部取消 + timeoutMs 超时）
-     * @throws {MemoraError} 当 embedding 返回的向量维度与已存维度不一致时抛出 configError
-     */
-    async upsert(id, text, options) {
-        const vector = await this.embeddingProvider.embed(text, options);
-        if (this.dimension === 0) {
-            this.dimension = vector.length;
-        }
-        else if (vector.length !== this.dimension) {
-            // 维度不一致会破坏 cosineSimilarity 计算（长度不匹配返回 0）
-            // 此处主动报错，让调用方感知模型切换或配置错误
-            // G-1：统一 MemoraError 体系，提供中文标题 + 排查建议
-            throw configError('向量维度不一致', `期望 ${this.dimension}，实际 ${vector.length}（id=${id}）。可能是 embedding 模型切换导致。`, ['清空 vectors.json 后重试', '检查 embedding 模型是否切换']);
-        }
-        this.entries.set(id, vector);
-        this.dirty = true;
-    }
-    /**
-     * 批量嵌入并存储
-     *
-     * 加固：维度一致性校验，与 upsert 同契约
-     *
-     * @param items ID + 文本对
-     * @param options embedding 调用选项（signal 外部取消 + timeoutMs 超时）
-     * @throws {MemoraError} 当 embedding 返回的向量维度与已存维度不一致时抛出 configError
-     */
-    async batchUpsert(items, options) {
-        const texts = items.map((item) => item.text);
-        const results = await this.embeddingProvider.batchEmbed(texts, options);
-        for (let i = 0; i < items.length; i++) {
-            const result = results[i];
-            const item = items[i];
-            if (!result || !item)
-                continue;
-            if (this.dimension === 0) {
-                this.dimension = result.vector.length;
-            }
-            else if (result.vector.length !== this.dimension) {
-                // 维度不一致会破坏 cosineSimilarity 计算
-                // G-1：统一 MemoraError 体系，提供中文标题 + 排查建议
-                throw configError('批量插入向量维度不一致', `期望 ${this.dimension}，实际 ${result.vector.length}（id=${item.id}）`, ['清空 vectors.json 后重试', '检查 embedding 模型是否切换']);
-            }
-            this.entries.set(item.id, result.vector);
-        }
-        this.dirty = true;
-    }
-    /**
-     * 删除向量并立即持久化
-     *
-     * FIX-P0-9：原实现仅标记 dirty=true 不 save，崩溃时已删除向量会在下次冷启动复活。
-     * 现改为 async + 立即 save（与 upsert 不对称合理——delete 是低频操作，立即持久化代价可控）。
-     *
-     * @param id 待删除的记忆 ID
-     */
-    async delete(id) {
-        this.entries.delete(id);
-        this.dirty = true;
-        // 立即持久化，串行化由 save() 内部 savePromise 链保证
-        await this.save();
-    }
-    /**
-     * 语义搜索：基于查询文本的向量，返回 topK 最相似的 ID
-     * @param query 查询文本
-     * @param topK 返回数量上限
-     * @param minSimilarity 最低相似度阈值（0~1）
-     * @param options embedding 调用选项（signal 外部取消 + timeoutMs 超时）
-     * @returns ID + 相似度 对的数组，按相似度降序排列
-     */
-    async search(query, topK = 5, minSimilarity = 0.3, options) {
-        const queryVector = await this.embeddingProvider.embed(query, options);
-        const scored = [];
-        for (const [id, vector] of this.entries) {
-            const similarity = cosineSimilarity(queryVector, vector);
-            if (similarity >= minSimilarity) {
-                scored.push({ id, similarity });
-            }
-        }
-        // 按相似度降序排列，取 topK
-        scored.sort((a, b) => b.similarity - a.similarity);
-        return scored.slice(0, topK);
-    }
-    /**
-     * 获取存储的向量数量
-     */
-    get size() {
-        return this.entries.size;
-    }
-}
-//# sourceMappingURL=vectorStore.js.map

package/dist/memory/vectorStore.js.map

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

package/dist/persona/personaManager.d.ts

@@ -1,109 +0,0 @@
-import { ConfigResourceManager } from '../utils/configResourceManager.js';
-import type { Persona, PersonaMode } from '../persona/types.js';
-import type { ScannedMarkdownEntry } from '../utils/scanner.js';
-/**
- * 角色管理器
- */
-export declare class PersonaManager extends ConfigResourceManager<Persona, string> {
-    /** 当前激活的角色 */
-    private activePersona;
-    /** 激活模式 */
-    private mode;
-    /** 角色切换时间戳列表（用于时间窗口缓冲） */
-    private switchTimestamps;
-    /** 缓冲区开关（30s 内 5 次切换后锁定） */
-    private switchLocked;
-    /** 锁定恢复计时器 */
-    private unlockTimer;
-    /** 锁定自动恢复时间戳（ms epoch） */
-    private unlockAt;
-    /** 时间窗口：30 秒 */
-    private static readonly SWITCH_WINDOW_MS;
-    /** 窗口内最大切换次数：5 次 */
-    private static readonly MAX_SWITCHES_IN_WINDOW;
-    /** 锁定后自动恢复时间：2 分钟 */
-    private static readonly AUTO_UNLOCK_MS;
-    /**
-     * @param configDir 配置目录（角色文件在 <configDir>/personas/ 下）
-     */
-    constructor(configDir?: string);
-    /**
-     * 启动时加载：扫描目录 + 激活指定角色
-     *
-     * @param activePersona 要激活的角色名（可选，不传则使用第一个找到的角色）
-     * @returns 激活角色的 system prompt 段
-     */
-    load(activePersona?: string): Promise<string>;
-    /**
-     * 重载角色：清空内存缓存 + 重新扫描 + 保持当前激活角色
-     */
-    reload(): Promise<number>;
-    /**
-     * load() 完成后选择激活角色
-     *
-     * @param _items 已加载的角色列表
-     * @param activeName 指定的激活角色名（options 参数）
-     */
-    protected onAfterLoad(_items: Persona[], activeName?: string): void;
-    /** 当前激活的角色名 */
-    get activeName(): string;
-    /** 获取当前激活角色对象 */
-    getActive(): Persona | null;
-    /** 获取角色列表（委托基类） */
-    get list(): Persona[];
-    /**
-     * 切换角色（带时间窗口缓冲）
-     *
-     * @param name 角色名
-     * @returns 新角色的 system prompt 段
-     * @throws MemoraError 如果角色不存在
-     */
-    switchPersona(name: string): string;
-    /**
-     * 根据用户输入自动匹配最合适的角色（关键词高置信度匹配）
-     *
-     * @param userInput 用户输入文本
-     * @returns 匹配的角色名，无匹配返回 null
-     */
-    autoMatch(userInput: string): string | null;
-    /**
-     * 检查是否满足自动匹配的前置条件
-     */
-    canAutoMatch(): boolean;
-    /** 设置激活模式 */
-    setMode(mode: PersonaMode): void;
-    /** 获取角色切换锁定状态 */
-    getSwitchLockStatus(): {
-        locked: boolean;
-        unlockAt: number | null;
-    };
-    /** 获取当前激活模式 */
-    get currentMode(): PersonaMode;
-    /**
-     * 清理定时器资源（Agent.close() 时调用）
-     */
-    close(): void;
-    /**
-     * 删除角色
-     *
-     * 若删除的是激活角色，自动回退到列表第一个或默认角色。
-     *
-     * @param name 角色名
-     * @returns true 删除成功；false 角色不存在
-     */
-    deletePersona(name: string): boolean;
-    /**
-     * 构建 system prompt 中的角色段
-     */
-    buildSystemPrompt(name?: string): string;
-    protected createEntry(entry: ScannedMarkdownEntry): Persona;
-    /**
-     * 记录一次角色切换（时间窗口缓冲）
-     */
-    private recordSwitch;
-    /**
-     * 创建默认角色
-     */
-    private createDefaultPersona;
-}
-//# sourceMappingURL=personaManager.d.ts.map

package/dist/persona/personaManager.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"personaManager.d.ts","sourceRoot":"","sources":["../../src/persona/personaManager.ts"],"names":[],"mappings":"AAiBA,OAAO,EAAE,qBAAqB,EAAE,MAAM,kCAAkC,CAAC;AACzE,OAAO,KAAK,EAAE,OAAO,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AAE/D,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,oBAAoB,CAAC;AAyB/D;;GAEG;AACH,qBAAa,cAAe,SAAQ,qBAAqB,CAAC,OAAO,EAAE,MAAM,CAAC;IACxE,cAAc;IACd,OAAO,CAAC,aAAa,CAAwB;IAC7C,WAAW;IACX,OAAO,CAAC,IAAI,CAAuB;IACnC,0BAA0B;IAC1B,OAAO,CAAC,gBAAgB,CAAgB;IACxC,4BAA4B;IAC5B,OAAO,CAAC,YAAY,CAAS;IAC7B,cAAc;IACd,OAAO,CAAC,WAAW,CAA8C;IACjE,0BAA0B;IAC1B,OAAO,CAAC,QAAQ,CAAuB;IAEvC,gBAAgB;IAChB,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,gBAAgB,CAAU;IAClD,oBAAoB;IACpB,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,sBAAsB,CAAK;IACnD,qBAAqB;IACrB,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,cAAc,CAAW;IAEjD;;OAEG;gBACS,SAAS,CAAC,EAAE,MAAM;IAM9B;;;;;OAKG;IACG,IAAI,CAAC,aAAa,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IAMnD;;OAEG;IACG,MAAM,IAAI,OAAO,CAAC,MAAM,CAAC;IA6B/B;;;;;OAKG;IACH,SAAS,CAAC,WAAW,CAAC,MAAM,EAAE,OAAO,EAAE,EAAE,UAAU,CAAC,EAAE,MAAM,GAAG,IAAI;IAwBnE,eAAe;IACf,IAAI,UAAU,IAAI,MAAM,CAEvB;IAED,iBAAiB;IACjB,SAAS,IAAI,OAAO,GAAG,IAAI;IAI3B,mBAAmB;IACnB,IAAI,IAAI,IAAI,OAAO,EAAE,CAEpB;IAED;;;;;;OAMG;IACH,aAAa,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM;IAwBnC;;;;;OAKG;IACH,SAAS,CAAC,SAAS,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI;IAe3C;;OAEG;IACH,YAAY,IAAI,OAAO;IAIvB,aAAa;IACb,OAAO,CAAC,IAAI,EAAE,WAAW,GAAG,IAAI;IAUhC,iBAAiB;IACjB,mBAAmB,IAAI;QAAE,MAAM,EAAE,OAAO,CAAC;QAAC,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAA;KAAE;IAInE,eAAe;IACf,IAAI,WAAW,IAAI,WAAW,CAE7B;IAED;;OAEG;IACH,KAAK,IAAI,IAAI;IAUb;;;;;;;OAOG;IACH,aAAa,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO;IAqBpC;;OAEG;IACH,iBAAiB,CAAC,IAAI,CAAC,EAAE,MAAM,GAAG,MAAM;IAUxC,SAAS,CAAC,WAAW,CAAC,KAAK,EAAE,oBAAoB,GAAG,OAAO;IAe3D;;OAEG;IACH,OAAO,CAAC,YAAY;IAqBpB;;OAEG;IACH,OAAO,CAAC,oBAAoB;CAU7B"}