@tachu/extensions 1.0.0-beta.1 → 1.0.0-rc.1

package/dist/memory/fs-memory-system.js

@@ -0,0 +1,482 @@
+import { existsSync } from "node:fs";
+import { appendFile, mkdir, readFile, rename, rm, writeFile, } from "node:fs/promises";
+import { join } from "node:path";
+import { ProjectionWorker } from "./projection-worker";
+const JSONL_SEP = "\n";
+function isObject(x) {
+    return typeof x === "object" && x !== null && !Array.isArray(x);
+}
+function parseMemoryEntry(raw) {
+    if (!isObject(raw))
+        return null;
+    const { id, role, content, timestamp, anchored } = raw;
+    if ((role !== "user" && role !== "assistant" && role !== "system" && role !== "tool") ||
+        typeof timestamp !== "number" ||
+        !Number.isFinite(timestamp)) {
+        return null;
+    }
+    return {
+        id: typeof id === "string" && id.length > 0 ? id : `fs-${timestamp}`,
+        role,
+        content: content,
+        timestamp,
+        anchored: Boolean(anchored),
+    };
+}
+/**
+ * 将任意 session ID 标准化为文件名安全形式。
+ *
+ * 规则：
+ * - 仅保留 `[A-Za-z0-9._-]`，其余一律替换为 `_`
+ * - 首位不允许为 `.`（防止写隐藏文件 / 触发 shell 点号展开）
+ * - 空串兜底为 `default`
+ * - 超长截断到 120 字符（绝大多数 UUID / nanoid 场景足够）
+ */
+export function sanitizeSessionId(raw) {
+    const replaced = raw.replace(/[^A-Za-z0-9._-]/g, "_");
+    const stripped = replaced.replace(/^\.+/, "_");
+    const bounded = stripped.length > 120 ? stripped.slice(0, 120) : stripped;
+    return bounded.length === 0 ? "default" : bounded;
+}
+export class FsMemorySystem {
+    persistDir;
+    inner;
+    compressionThreshold;
+    hydrated = new Set();
+    pending = new Map();
+    checkpoints = new Map();
+    outbox;
+    projectionProject;
+    recovered = new Set();
+    /**
+    * 构造文件持久化 MemorySystem。
+    *
+    * @param options 参见 {@link FsMemorySystemOptions}
+    */
+    constructor(options) {
+        this.persistDir = options.persistDir;
+        this.inner = options.inner;
+        this.compressionThreshold = options.compressionThreshold;
+        this.outbox = options.projectionOutbox;
+        this.projectionProject = options.projectionProject;
+    }
+    /**
+    * @inheritdoc
+    */
+    async load(sessionId, ctx) {
+        return this.serialize(sessionId, async () => {
+            await this.hydrateIfNeeded(sessionId);
+            return this.inner.load(sessionId, ctx);
+        });
+    }
+    /**
+    * @inheritdoc
+    *
+    * 流程：
+    * 1. 确保 session 已 hydrate（使 window 与磁盘一致）
+    * 2. append-only 将 entry 序列化为单行 JSON 落盘（崩溃安全；即便本次进程 crash，
+    * 磁盘文件仍是合法 jsonl 的前缀）
+    * 3. 将 entry 通过 `inner.hydrate()` 注入内存 window（旁路 per-entry compress）
+    * 4. 手动检查 tokenCount 是否越过阈值；若越线：
+    * - `inner.compress(sid)` 触发 LLM 摘要
+    * - atomic rewrite jsonl，保持盘与内存一致
+    */
+    async append(sessionId, entry, ctx) {
+        await this.serialize(sessionId, async () => {
+            await this.hydrateIfNeeded(sessionId);
+            await this.writeJsonlLine(sessionId, entry);
+            await this.inner.hydrate(sessionId, [entry]);
+            const window = await this.inner.load(sessionId, ctx);
+            if (window.tokenCount > window.limit * this.compressionThreshold) {
+                await this.inner.compress(sessionId);
+                await this.rewriteJsonl(sessionId);
+            }
+        });
+    }
+    async appendEntries(sessionId, entries, ctx) {
+        for (const entry of entries) {
+            await this.append(sessionId, entry, ctx);
+        }
+        return {
+            appended: entries.length,
+            projectionStatus: entries.map((entry) => this.pendingProjection(entry.id)),
+        };
+    }
+    /**
+    * @inheritdoc
+    */
+    async compress(sessionId) {
+        await this.serialize(sessionId, async () => {
+            await this.hydrateIfNeeded(sessionId);
+            await this.inner.compress(sessionId);
+            await this.rewriteJsonl(sessionId);
+        });
+    }
+    /**
+    * @inheritdoc
+    */
+    async recall(sessionId, query, topK) {
+        await this.hydrateIfNeeded(sessionId);
+        return topK === undefined
+            ? this.inner.recall(sessionId, query)
+            : this.inner.recall(sessionId, query, topK);
+    }
+    /**
+    * @inheritdoc
+    */
+    async loadFull(sessionId) {
+        await this.hydrateIfNeeded(sessionId);
+        return this.inner.loadFull(sessionId);
+    }
+    async loadSession(sessionId, ctx) {
+        const window = await this.load(sessionId, ctx);
+        const entries = [...window.entries].sort((left, right) => left.timestamp - right.timestamp);
+        const updatedAt = entries.length > 0 ? Math.max(...entries.map((entry) => entry.timestamp)) : Date.now();
+        const archiveRefs = await this.readArchiveRefs(sessionId);
+        const outboxByRef = await this.snapshotOutboxByRef(sessionId);
+        return {
+            meta: {
+                id: sessionId,
+                updatedAt,
+                entryCount: entries.length,
+            },
+            hotLog: entries,
+            summaries: this.extractSummaries(sessionId, entries),
+            archiveRefs,
+            projectionStatus: entries.map((entry) => this.projectionStatusFor(entry.id, outboxByRef)),
+            budget: {
+                tokenLimit: window.limit,
+                tokenUsed: window.tokenCount,
+            },
+            ...(this.checkpoints.has(sessionId)
+                ? { checkpoint: this.checkpoints.get(sessionId) }
+                : {}),
+        };
+    }
+    async loadView(sessionId, view, ctx) {
+        const snapshot = await this.loadSession(sessionId, ctx);
+        const since = view.since ?? Number.NEGATIVE_INFINITY;
+        const entries = snapshot.hotLog
+            .filter((entry) => entry.timestamp >= since)
+            .slice(view.limit !== undefined ? -view.limit : 0);
+        if (view.kind === "summary") {
+            return {
+                kind: view.kind,
+                entries: [],
+                summaries: snapshot.summaries,
+                projectionStatus: snapshot.projectionStatus,
+            };
+        }
+        return {
+            kind: view.kind,
+            entries,
+            summaries: snapshot.summaries,
+            projectionStatus: snapshot.projectionStatus,
+        };
+    }
+    async compact(sessionId, _policy, _ctx) {
+        await this.compress(sessionId);
+        const entries = await this.loadFull(sessionId);
+        // archiveRefs 持久化。compact 生成一条 ref 描述本次压缩涉及的 entry 集合，
+        // 落盘到 `<persistDir>/<sid>.archive.json`，确保跨进程 `loadSession` 能正确回放。
+        const existing = await this.readArchiveRefs(sessionId);
+        const next = [
+            ...existing,
+            {
+                id: `compact-${Date.now()}`,
+                entryIds: entries.map((entry) => entry.id),
+                createdAt: Date.now(),
+            },
+        ];
+        await this.writeArchiveRefs(sessionId, next);
+        return {
+            summaries: this.extractSummaries(sessionId, entries),
+            archiveRefs: next,
+        };
+    }
+    async checkpoint(sessionId, checkpoint, _ctx) {
+        this.checkpoints.set(sessionId, checkpoint);
+    }
+    /**
+    * @inheritdoc
+    *
+    * 当 host 注入 `projectionOutbox` 时，每条 entry 走 outbox 状态机
+    * （pending → retrying → indexed/failed/dead），并在首次 archive 该 session 时
+    * 自动 `recover()` 残留的陈旧 retrying 项。
+    *
+    * `awaitProjection=false` 时只写冷归档并入队 projection，由 `ProjectionWorker`
+    * 后台 flush；默认保持旧同步语义，等待本轮 projection 完成后返回。
+    */
+    async archive(sessionId, options = {}) {
+        await this.hydrateIfNeeded(sessionId);
+        if (!this.outbox) {
+            await this.inner.archive(sessionId);
+            return;
+        }
+        if (!this.recovered.has(sessionId)) {
+            await this.outbox.recover(sessionId);
+            this.recovered.add(sessionId);
+        }
+        const entries = await this.inner.loadFull(sessionId);
+        if (entries.length === 0)
+            return;
+        for (const entry of entries) {
+            await this.outbox.enqueue(sessionId, entry.id);
+        }
+        await this.inner.archiveSource(sessionId);
+        if (options.awaitProjection !== false) {
+            await this.createProjectionWorker().flush(sessionId);
+        }
+    }
+    /**
+    * Construct a {@link ProjectionWorker} that drains the outbox via the
+    * host-injected `projectionProject` callback.
+    *
+    * **Fail-closed contract:** when `projectionOutbox` is
+    * enabled, `projectionProject` MUST be provided. The legacy fallback to
+    * `InMemoryMemorySystem.project()` (which forwarded raw `string` content
+    * straight to `VectorStore.upsert(id, text, { content })` and bypassed the
+    * `EmbeddingRuntime` / `VectorIndexAdapter` stack) has been removed — any
+    * production host that forgets to wire the projector now crashes loudly
+    * instead of silently re-introducing the deprecated text-embed path.
+    */
+    createProjectionWorker(options) {
+        if (!this.outbox) {
+            throw new Error("ProjectionWorker requires FsMemorySystem.projectionOutbox");
+        }
+        if (!this.projectionProject) {
+            throw new Error("ProjectionWorker requires FsMemorySystem.projectionProject when projectionOutbox is enabled. " +
+                "Inject an embedding-runtime + vector-index backed projector via host-defaults' " +
+                "resolveProjectionStack(); the legacy inner.project() fallback has been retired.");
+        }
+        return new ProjectionWorker({
+            outbox: this.outbox,
+            ...(options?.intervalMs !== undefined ? { intervalMs: options.intervalMs } : {}),
+            project: this.projectionProject,
+        });
+    }
+    /**
+    * @inheritdoc
+    */
+    async getSize(sessionId) {
+        await this.hydrateIfNeeded(sessionId);
+        return this.inner.getSize(sessionId);
+    }
+    /**
+    * @inheritdoc
+    */
+    async trim(sessionId, options) {
+        await this.serialize(sessionId, async () => {
+            await this.hydrateIfNeeded(sessionId);
+            await this.inner.trim(sessionId, options);
+            await this.rewriteJsonl(sessionId);
+        });
+    }
+    /**
+    * @inheritdoc
+    *
+    * 先清内存 window，再幂等删除磁盘 jsonl。未找到文件视为 no-op。
+    */
+    async clear(sessionId) {
+        await this.serialize(sessionId, async () => {
+            this.hydrated.delete(sessionId);
+            this.checkpoints.delete(sessionId);
+            await this.inner.clear(sessionId);
+            const path = this.pathFor(sessionId);
+            try {
+                await rm(path, { force: true });
+            }
+            catch {
+                // ignore
+            }
+        });
+    }
+    pendingProjection(ref) {
+        return {
+            kind: "pending",
+            ref,
+            reason: "awaiting semantic projection",
+            createdAt: Date.now(),
+        };
+    }
+    async snapshotOutboxByRef(sessionId) {
+        if (!this.outbox)
+            return undefined;
+        const records = await this.outbox.list(sessionId);
+        const map = new Map();
+        for (const rec of records) {
+            switch (rec.state) {
+                case "indexed":
+                    map.set(rec.ref, {
+                        kind: "indexed",
+                        ref: rec.ref,
+                        indexedAt: rec.updatedAt,
+                        adapter: "vector-store",
+                    });
+                    break;
+                case "failed":
+                case "retrying":
+                case "dead":
+                    map.set(rec.ref, {
+                        kind: "failed",
+                        ref: rec.ref,
+                        error: rec.lastError ?? "unknown",
+                        retryable: rec.state !== "dead",
+                        attempts: rec.attempts,
+                    });
+                    break;
+                case "pending":
+                default:
+                    map.set(rec.ref, {
+                        kind: "pending",
+                        ref: rec.ref,
+                        reason: "awaiting semantic projection",
+                        createdAt: rec.createdAt,
+                    });
+            }
+        }
+        return map;
+    }
+    projectionStatusFor(ref, outboxByRef) {
+        if (outboxByRef) {
+            const status = outboxByRef.get(ref);
+            if (status)
+                return status;
+        }
+        return this.pendingProjection(ref);
+    }
+    /** archiveRefs 持久化路径。 */
+    archiveRefsPathFor(sessionId) {
+        return join(this.persistDir, `${sanitizeSessionId(sessionId)}.archive.json`);
+    }
+    async readArchiveRefs(sessionId) {
+        const path = this.archiveRefsPathFor(sessionId);
+        if (!existsSync(path))
+            return [];
+        try {
+            const text = await readFile(path, "utf8");
+            const parsed = JSON.parse(text);
+            if (!Array.isArray(parsed))
+                return [];
+            return parsed.filter((item) => item &&
+                typeof item === "object" &&
+                typeof item.id === "string" &&
+                Array.isArray(item.entryIds) &&
+                typeof item.createdAt === "number");
+        }
+        catch {
+            return [];
+        }
+    }
+    async writeArchiveRefs(sessionId, refs) {
+        const path = this.archiveRefsPathFor(sessionId);
+        await mkdir(this.persistDir, { recursive: true });
+        const tmp = `${path}.tmp`;
+        await writeFile(tmp, JSON.stringify(refs, null, 2), "utf8");
+        await rename(tmp, path);
+    }
+    extractSummaries(sessionId, entries) {
+        return entries
+            .filter((entry) => entry.role === "system" &&
+            typeof entry.content === "string" &&
+            entry.content.includes("摘要"))
+            .map((entry) => ({
+            id: entry.id,
+            sessionId,
+            sourceEntryIds: [],
+            sourceRange: { fromTs: entry.timestamp, toTs: entry.timestamp },
+            content: entry.content,
+            method: "head-middle-tail",
+            createdAt: entry.timestamp,
+        }));
+    }
+    /**
+    * 获取某 session 的持久化文件绝对 / 相对路径（便于外层 CLI 做迁移、/history 展示）。
+    */
+    pathFor(sessionId) {
+        return join(this.persistDir, `${sanitizeSessionId(sessionId)}.jsonl`);
+    }
+    /**
+    * 从磁盘读取 session 的原始 entries 快照（不经 inner hydrate）。
+    *
+    * 外层 CLI 可借此在 `/history` / `/export` 命令中直接列出原始条目顺序，
+    * 不必先 `load` 触发 hydrate 副作用。
+    */
+    async readRaw(sessionId) {
+        const path = this.pathFor(sessionId);
+        if (!existsSync(path)) {
+            return [];
+        }
+        let raw;
+        try {
+            raw = await readFile(path, "utf8");
+        }
+        catch {
+            return [];
+        }
+        return this.parseJsonl(raw);
+    }
+    parseJsonl(raw) {
+        const entries = [];
+        for (const line of raw.split(JSONL_SEP)) {
+            const trimmed = line.trim();
+            if (!trimmed)
+                continue;
+            try {
+                const parsed = JSON.parse(trimmed);
+                const entry = parseMemoryEntry(parsed);
+                if (entry)
+                    entries.push(entry);
+            }
+            catch {
+                continue;
+            }
+        }
+        return entries;
+    }
+    async hydrateIfNeeded(sessionId) {
+        if (this.hydrated.has(sessionId))
+            return;
+        this.hydrated.add(sessionId);
+        const entries = await this.readRaw(sessionId);
+        if (entries.length === 0)
+            return;
+        await this.inner.hydrate(sessionId, entries);
+    }
+    async writeJsonlLine(sessionId, entry) {
+        await mkdir(this.persistDir, { recursive: true });
+        const line = `${JSON.stringify(entry)}${JSONL_SEP}`;
+        await appendFile(this.pathFor(sessionId), line, "utf8");
+    }
+    async rewriteJsonl(sessionId) {
+        const window = await this.inner.load(sessionId, this.inner.resolveAdapterContext(sessionId));
+        const path = this.pathFor(sessionId);
+        const tmp = `${path}.tmp`;
+        await mkdir(this.persistDir, { recursive: true });
+        const body = window.entries.length === 0
+            ? ""
+            : window.entries.map((entry) => JSON.stringify(entry)).join(JSONL_SEP) + JSONL_SEP;
+        await writeFile(tmp, body, "utf8");
+        await rename(tmp, path);
+    }
+    /**
+    * 串行化某 session 的关键操作 —— 通过 promise chain 保证同一 sessionId 上的
+    * load / append / compress / trim 不交错。
+    *
+    * 失败不阻塞队列：下一个 task 无论前一个 resolve 还是 reject 都会启动。
+    */
+    async serialize(sessionId, fn) {
+        const prev = this.pending.get(sessionId) ?? Promise.resolve();
+        const next = prev.then(fn, fn);
+        this.pending.set(sessionId, next);
+        try {
+            return await next;
+        }
+        finally {
+            if (this.pending.get(sessionId) === next) {
+                this.pending.delete(sessionId);
+            }
+        }
+    }
+}
+//# sourceMappingURL=fs-memory-system.js.map

package/dist/memory/fs-memory-system.js.map

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

package/dist/memory/index.d.ts

@@ -0,0 +1,5 @@
+export { FsMemorySystem, sanitizeSessionId, type FsMemorySystemOptions, } from "./fs-memory-system";
+export { ProjectionOutbox, type ProjectionOutboxOptions, type ProjectionRecord, type ProjectionState, } from "./projection-outbox";
+export { ProjectionWorker, type ProjectionWorkerFlushResult, type ProjectionWorkerOptions, type ProjectionWorkerProjectResult, } from "./projection-worker";
+export { projectMemoryRefs, type ProjectionProjectorDeps } from "./projection-projector";
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/memory/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,cAAc,EACd,iBAAiB,EACjB,KAAK,qBAAqB,GAC3B,MAAM,oBAAoB,CAAC;AAC5B,OAAO,EACL,gBAAgB,EAChB,KAAK,uBAAuB,EAC5B,KAAK,gBAAgB,EACrB,KAAK,eAAe,GACrB,MAAM,qBAAqB,CAAC;AAC7B,OAAO,EACL,gBAAgB,EAChB,KAAK,2BAA2B,EAChC,KAAK,uBAAuB,EAC5B,KAAK,6BAA6B,GACnC,MAAM,qBAAqB,CAAC;AAC7B,OAAO,EAAE,iBAAiB,EAAE,KAAK,uBAAuB,EAAE,MAAM,wBAAwB,CAAC"}

package/dist/memory/index.js

@@ -0,0 +1,5 @@
+export { FsMemorySystem, sanitizeSessionId, } from "./fs-memory-system";
+export { ProjectionOutbox, } from "./projection-outbox";
+export { ProjectionWorker, } from "./projection-worker";
+export { projectMemoryRefs } from "./projection-projector";
+//# sourceMappingURL=index.js.map

package/dist/memory/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/memory/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,cAAc,EACd,iBAAiB,GAElB,MAAM,oBAAoB,CAAC;AAC5B,OAAO,EACL,gBAAgB,GAIjB,MAAM,qBAAqB,CAAC;AAC7B,OAAO,EACL,gBAAgB,GAIjB,MAAM,qBAAqB,CAAC;AAC7B,OAAO,EAAE,iBAAiB,EAAgC,MAAM,wBAAwB,CAAC"}

package/dist/memory/projection-outbox.d.ts

@@ -0,0 +1,69 @@
+/**
+ * Projection 投递 outbox 状态机。
+ *
+ * 状态转移：
+ * ```
+ * pending ──enqueue──▶ retrying ──ok──▶ indexed
+ * │
+ * ├─error & attempts<max──▶ failed ──retry──▶ retrying
+ * │
+ * └─error & attempts≥max──▶ dead (DLQ)
+ * ```
+ *
+ * - 每条投递持久化到 `<dir>/<sessionId>.jsonl`（append-only + 原子重写）。
+ * - `dead` 项移到 `<dir>/dead/<sessionId>.<ts>.json` 形成 DLQ，主文件中标记为 `dead`。
+ * - 启动时 `recover()` 把超过 `staleAfterMs` 仍处于 `retrying` 的项重置为 `pending`，
+ * 防止上次进程在 upsert 期间被 kill 留下"幽灵 retrying"。
+ *
+ * 交付：真状态机 + 真持久化 + 真 DLQ + 真 crash 恢复。
+ * 交付：`ProjectionWorker` 可独立 flush pending 队列，
+ * 让 host 将 archive 主路径与 vector projection 解耦。
+ */
+export type ProjectionState = "pending" | "retrying" | "indexed" | "failed" | "dead";
+export interface ProjectionRecord {
+    ref: string;
+    state: ProjectionState;
+    attempts: number;
+    createdAt: number;
+    updatedAt: number;
+    lastError?: string;
+    vectorId?: string;
+}
+export interface ProjectionOutboxOptions {
+    /** 持久化根目录，默认 `<cwd>/.tachu/projections`。 */
+    dir: string;
+    /** 最大重试次数；达到后入 DLQ（默认 5）。 */
+    maxAttempts?: number;
+    /** retrying 状态超过该毫秒数视为陈旧（默认 5 分钟）。 */
+    staleAfterMs?: number;
+}
+export declare class ProjectionOutbox {
+    private readonly dir;
+    private readonly maxAttempts;
+    private readonly staleAfterMs;
+    private readonly cache;
+    constructor(options: ProjectionOutboxOptions);
+    private pathFor;
+    private deadDir;
+    /** 读取/构造 session 的内存索引（按 ref 唯一）。 */
+    private loadIndex;
+    /** 原子重写 jsonl。 */
+    private flush;
+    /** 启动恢复：将陈旧 retrying 重置为 pending。 */
+    recover(sessionId: string, now?: number): Promise<number>;
+    enqueue(sessionId: string, ref: string, now?: number): Promise<void>;
+    markRetrying(sessionId: string, ref: string, now?: number): Promise<void>;
+    markIndexed(sessionId: string, ref: string, vectorId: string, now?: number): Promise<void>;
+    markFailed(sessionId: string, ref: string, error: string, now?: number): Promise<ProjectionState>;
+    list(sessionId: string): Promise<ProjectionRecord[]>;
+    listSessions(): Promise<string[]>;
+    listPending(sessionId: string): Promise<ProjectionRecord[]>;
+    pendingCount(sessionId: string): Promise<number>;
+    /** 清空缓存（用于测试模拟进程重启）。 */
+    resetCache(): void;
+    get directory(): string;
+    /** 仅用于内部诊断：用户可拿到 dead 目录路径检查 DLQ。 */
+    get deadLetterDir(): string;
+    static dirnameOf(path: string): string;
+}
+//# sourceMappingURL=projection-outbox.d.ts.map

package/dist/memory/projection-outbox.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"projection-outbox.d.ts","sourceRoot":"","sources":["../../src/memory/projection-outbox.ts"],"names":[],"mappings":"AAIA;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,MAAM,MAAM,eAAe,GACvB,SAAS,GACT,UAAU,GACV,SAAS,GACT,QAAQ,GACR,MAAM,CAAC;AAEX,MAAM,WAAW,gBAAgB;IAC/B,GAAG,EAAE,MAAM,CAAC;IACZ,KAAK,EAAE,eAAe,CAAC;IACvB,QAAQ,EAAE,MAAM,CAAC;IACjB,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,uBAAuB;IACvC,4CAA4C;IAC3C,GAAG,EAAE,MAAM,CAAC;IACb,6BAA6B;IAC5B,WAAW,CAAC,EAAE,MAAM,CAAC;IACtB,sCAAsC;IACrC,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB;AAeD,qBAAa,gBAAgB;IAC3B,OAAO,CAAC,QAAQ,CAAC,GAAG,CAAS;IAC7B,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAS;IACrC,OAAO,CAAC,QAAQ,CAAC,YAAY,CAAS;IACtC,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAoD;gBAE9D,OAAO,EAAE,uBAAuB;IAM5C,OAAO,CAAC,OAAO;IAIf,OAAO,CAAC,OAAO;IAIhB,qCAAqC;YACtB,SAAS;IAiBxB,kBAAkB;YACH,KAAK;IAUpB,qCAAqC;IAC9B,OAAO,CAAC,SAAS,EAAE,MAAM,EAAE,GAAG,GAAE,MAAmB,GAAG,OAAO,CAAC,MAAM,CAAC;IAcrE,OAAO,CAAC,SAAS,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,EAAE,GAAG,GAAE,MAAmB,GAAG,OAAO,CAAC,IAAI,CAAC;IAchF,YAAY,CAAC,SAAS,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,EAAE,GAAG,GAAE,MAAmB,GAAG,OAAO,CAAC,IAAI,CAAC;IASrF,WAAW,CACf,SAAS,EAAE,MAAM,EACjB,GAAG,EAAE,MAAM,EACX,QAAQ,EAAE,MAAM,EAChB,GAAG,GAAE,MAAmB,GACvB,OAAO,CAAC,IAAI,CAAC;IAgBV,UAAU,CACd,SAAS,EAAE,MAAM,EACjB,GAAG,EAAE,MAAM,EACX,KAAK,EAAE,MAAM,EACb,GAAG,GAAE,MAAmB,GACvB,OAAO,CAAC,eAAe,CAAC;IA4BrB,IAAI,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,gBAAgB,EAAE,CAAC;IAKpD,YAAY,IAAI,OAAO,CAAC,MAAM,EAAE,CAAC;IASjC,WAAW,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,gBAAgB,EAAE,CAAC;IAK3D,YAAY,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IASvD,wBAAwB;IACvB,UAAU,IAAI,IAAI;IAIlB,IAAI,SAAS,IAAI,MAAM,CAEtB;IAEF,qCAAqC;IACpC,IAAI,aAAa,IAAI,MAAM,CAE1B;IAGD,MAAM,CAAC,SAAS,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM;CAGvC"}