@fgbg/mdocs 0.8.9 → 0.8.12

package/agent-skills/usage-search/SKILL.md

@@ -0,0 +1,34 @@
+---
+id: usage-search
+name: "全文搜索"
+description: "mdocs 内置了基于 FTS5（SQLite 全文索引引擎）的搜索功能，支持中文分词。"
+keywords: []
+source: usage/search.md
+---
+
+# 全文搜索
+
+mdocs 内置了基于 FTS5（SQLite 全文索引引擎）的搜索功能，支持中文分词。
+
+## 搜索入口
+
+在编辑器顶部的搜索栏输入关键词，系统会在当前域的所有文档中检索。
+
+## 搜索能力
+
+- **全文检索**：搜索文档正文内容，不只是标题
+- **中文分词**：使用 jieba 分词，自动切分中文句子，提高匹配精度
+- **相关性排序**：按 BM25 算法排序，匹配度最高的结果排在最前
+- **权限过滤**：自动过滤当前访客无权阅读的文档
+- **片段高亮**：搜索结果展示匹配片段，快速定位关键内容
+
+## 限制搜索范围
+
+支持通过 `--domain` 参数限定在特定域内搜索（仅 CLI 客户端支持），Web 端默认在当前域内搜索。
+
+## 索引更新
+
+- 文档创建或更新后自动触发索引重建（异步）
+- 每 60 秒扫描一次待索引的文档
+- 索引更新不影响文档的正常访问
+

package/agent-skills/usage-settings/SKILL.md

@@ -0,0 +1,95 @@
+---
+id: usage-settings
+name: "设置页面"
+description: "设置页面是 mdocs 的集中配置中心：身份与密码、收藏与文章、域与成员模板、上手助手、草稿同步等都在这里。"
+keywords: []
+source: usage/settings.md
+---
+
+# 设置页面
+
+## 功能概述
+
+设置页面是 mdocs 的集中配置中心：身份与密码、收藏与文章、域与成员模板、上手助手、草稿同步等都在这里。
+
+## 入口
+
+点击左侧边栏**底部的访客信息区**（头像 + 昵称那一行），进入设置页面。
+
+![设置入口：点击侧栏底部访客信息](./settings/setting-rukou.png)
+
+侧栏底部另有 **返回文档**，可随时回到编辑主界面。
+
+---
+
+## 左侧导航概览
+
+顺序与界面一致：
+
+| 导航项 | 功能 |
+|-------|------|
+| [通用](#通用设置) | 语言、自动编辑、CLI Token、恢复码（兼容）、登录密码 |
+| [我的收藏](./bookmarks.md) | 收藏列表、搜索、取消收藏 |
+| [我的文章](./my-documents.md) | 自己创建的文档、邀请成员、打开 |
+| [域管理](./domain-members.md) | 创建 / 筛选 / 重命名 / 改类型 / 删除域；受限域成员 |
+| [域成员模板](./domain-members.md) | 可复用的访客名单 |
+| [AI](./onboarding-ai.md) | 上手助手的 DeepSeek 配置 |
+| [保存与发布](./drafts.md) | 本地快照、自动同步、未发布草稿 |
+
+---
+
+## 通用设置
+
+![通用设置界面](./settings/general.png)
+
+### 语言
+
+「中」/「EN」即时切换界面语言，无需刷新。
+
+### 自动编辑
+
+开启后，打开文档时自动进入编辑模式；关闭则默认只读，需手动点编辑。
+
+- **写作为主**：建议开启
+- **阅读为主**：建议关闭
+
+### CLI Token
+
+给命令行与外部 Agent 用的身份令牌，继承你的权限。可查看活跃 Token、重置。详情见 [CLI Token](./cli-token.md)。
+
+### 恢复码（兼容）
+
+Token / Cookie 丢失时的自助找回；引入登录密码后已边缘化。详情见 [恢复码与身份找回](./recovery-code.md)。
+
+### 登录密码（推荐跨端）
+
+设置至少 4 位密码后，可在其他浏览器或设备用「用户名 + 密码」登录同一访客。
+
+---
+
+## 其他模块一览
+
+各页详情见对应文档；此处仅对照设置内截图入口。
+
+| 模块 | 文档 |
+|------|------|
+| 我的收藏 | [收藏功能](./bookmarks.md) |
+| 我的文章 | [我的文章](./my-documents.md) |
+| 域管理 / 域成员模板 | [受限域成员与名单模板](./domain-members.md) |
+| AI | [上手助手（AI）](./onboarding-ai.md) |
+| 保存与发布 | [草稿与同步](./drafts.md) |
+
+---
+
+## 常见问题
+
+### 设置会保存在哪里？
+
+语言、自动编辑、自动同步等偏好多在浏览器本地；与身份绑定的数据（收藏、域与成员、模板、CLI Token、密码哈希、恢复码哈希、AI 配置）在服务端。
+
+### 为什么看不到某些操作？
+
+- **域管理**：重命名 / 删除等通常仅域创建者可见
+- **受限域「成员」**：仅受限域且你是创建者时才有
+- **邀请成员**：仅自己创建的文档显示
+

package/agent-skills/why-mdocs/SKILL.md

@@ -0,0 +1,13 @@
+---
+id: why-mdocs
+name: "why-mdocs"
+description: "import { WhyMdocsPage } from '../../src/components/WhyMdocsPage';"
+keywords: []
+source: why-mdocs.mdx
+---
+
+
+import { WhyMdocsPage } from '../../src/components/WhyMdocsPage';
+
+<WhyMdocsPage />
+

package/dist/server/agent/Agent/run.js

@@ -0,0 +1,222 @@
+import { Agent } from "@earendil-works/pi-agent-core";
+import { createModels, createProvider, } from "@earendil-works/pi-ai";
+import { openAICompletionsApi } from "@earendil-works/pi-ai/api/openai-completions.lazy";
+import { getVisitorAgentConfig, } from "../Config/config.js";
+import { getSkillLoader } from "../Skill/skill-loader.js";
+import { buildSystemPrompt } from "./system-prompt.js";
+import { createSkillTools } from "./tools.js";
+import { AgentSessionManager, } from "./session-manager.js";
+export function getAgentStatus(visitorId) {
+    const cfg = getVisitorAgentConfig(visitorId);
+    const skills = getSkillLoader();
+    const hasKey = Boolean(cfg?.apiKey);
+    return {
+        enabled: hasKey && skills.isReady(),
+        skillsReady: skills.isReady(),
+        model: hasKey ? cfg.modelId : null,
+        configId: hasKey ? cfg.id : null,
+        reason: !hasKey
+            ? "missing_api_key"
+            : !skills.isReady()
+                ? "skills_missing"
+                : undefined,
+    };
+}
+/**
+ * 上手 Agent 主流程：config → session hydrate → agent → subscribe → prompt。
+ * 流式进度经 onEvent 上抛，路由不感知 Pi / skill 细节。
+ */
+export async function runOnboardingChat(params) {
+    const { visitorId, message, onEvent, signal } = params;
+    const cfg = getVisitorAgentConfig(visitorId);
+    if (!cfg?.apiKey)
+        throw new Error("missing_api_key");
+    const skills = getSkillLoader();
+    if (!skills.isReady())
+        throw new Error("skills_missing");
+    const { models, model } = createDeepSeekModel(cfg);
+    const tools = createSkillTools(skills);
+    const systemPrompt = buildSystemPrompt();
+    const sessionManager = new AgentSessionManager(visitorId);
+    const { sessionId, messages: history } = await sessionManager.loadLastOpenedMessages();
+    const agent = new Agent({
+        initialState: {
+            systemPrompt,
+            model,
+            tools,
+            messages: toPiMessages(history, model),
+        },
+        streamFn: models.streamSimple.bind(models),
+    });
+    const track = { emittedError: false };
+    const unsub = agent.subscribe(bindAgentEvents({
+        sessionId,
+        sessionManager,
+        onEvent,
+        track,
+    }));
+    const onAbort = () => agent.abort();
+    signal?.addEventListener("abort", onAbort);
+    try {
+        await agent.prompt(message);
+        const leftover = agent.state.errorMessage;
+        // prompt 在模型鉴权失败时仍可能 resolve，再兜底一次
+        if (leftover && !track.emittedError) {
+            onEvent({ type: "error", message: leftover });
+        }
+        onEvent({ type: "done" });
+    }
+    catch (err) {
+        if (signal?.aborted)
+            return;
+        const msg = err instanceof Error ? err.message : String(err);
+        onEvent({ type: "error", message: msg });
+        throw err;
+    }
+    finally {
+        signal?.removeEventListener("abort", onAbort);
+        unsub();
+    }
+}
+// —— helpers（主流程外）——
+const EMPTY_USAGE = {
+    input: 0,
+    output: 0,
+    cacheRead: 0,
+    cacheWrite: 0,
+    totalTokens: 0,
+    cost: { input: 0, output: 0, cacheRead: 0, cacheWrite: 0, total: 0 },
+};
+/** jsonl 历史 → Pi Agent.messages（请求内内存副本） */
+function toPiMessages(history, model) {
+    const ts = Date.now();
+    return history.map((m) => {
+        if (m.role === "user") {
+            return { role: "user", content: m.content, timestamp: ts };
+        }
+        return {
+            role: "assistant",
+            content: [{ type: "text", text: m.content }],
+            api: model.api,
+            provider: model.provider,
+            model: model.id,
+            usage: EMPTY_USAGE,
+            stopReason: "stop",
+            timestamp: ts,
+        };
+    });
+}
+function extractUserContent(userMsg) {
+    const c = userMsg.content;
+    if (typeof c === "string")
+        return c;
+    if (Array.isArray(c)) {
+        return c
+            .filter((x) => x?.type === "text")
+            .map((x) => x.text)
+            .join("");
+    }
+    return "";
+}
+function extractAssistantVisibleText(assistantMsg) {
+    const content = assistantMsg.content;
+    if (!Array.isArray(content))
+        return "";
+    return content
+        .filter((x) => x?.type === "text")
+        .map((x) => x.text)
+        .join("");
+}
+/** SSE + session 落盘：只写 user / 最终 assistant 文本，忽略 thinking / tool */
+function bindAgentEvents(opts) {
+    const { sessionId, sessionManager, onEvent, track } = opts;
+    const sourcesById = new Map();
+    let appendedUser = false;
+    let appendedAssistant = false;
+    return async (event) => {
+        if (event.type === "message_update" &&
+            event.assistantMessageEvent.type === "text_delta") {
+            onEvent({ type: "text_delta", text: event.assistantMessageEvent.delta });
+            return;
+        }
+        if (event.type === "message_end") {
+            if (event.message.role === "user") {
+                if (!appendedUser) {
+                    appendedUser = true;
+                    const content = extractUserContent(event.message);
+                    if (content)
+                        await sessionManager.appendUser(sessionId, content);
+                }
+                return;
+            }
+            if (event.message.role === "assistant") {
+                const msg = event.message;
+                if ((msg.stopReason === "error" || msg.stopReason === "aborted") &&
+                    msg.errorMessage) {
+                    track.emittedError = true;
+                    onEvent({ type: "error", message: msg.errorMessage });
+                    return;
+                }
+                // toolUse = 准备调工具，不是最终可见回答
+                if (!appendedAssistant &&
+                    (msg.stopReason === "stop" || msg.stopReason === "length")) {
+                    appendedAssistant = true;
+                    const visibleText = extractAssistantVisibleText(event.message);
+                    if (visibleText) {
+                        await sessionManager.appendAssistant(sessionId, visibleText);
+                    }
+                }
+                return;
+            }
+        }
+        if (event.type === "tool_execution_end" &&
+            event.toolName === "mdocs_manual_content" &&
+            !event.isError) {
+            const source = event.result?.details?.source;
+            if (source?.url && !sourcesById.has(source.id)) {
+                sourcesById.set(source.id, source);
+                onEvent({ type: "sources", items: [...sourcesById.values()] });
+            }
+        }
+    };
+}
+function createDeepSeekModel(cfg) {
+    const model = {
+        id: cfg.modelId,
+        name: cfg.modelId,
+        api: "openai-completions",
+        provider: "deepseek",
+        baseUrl: cfg.endpoint,
+        reasoning: false,
+        input: ["text"],
+        cost: { input: 0, output: 0, cacheRead: 0, cacheWrite: 0 },
+        contextWindow: 128000,
+        maxTokens: 8192,
+        compat: {
+            supportsDeveloperRole: false,
+            supportsReasoningEffort: false,
+        },
+    };
+    const apiKey = cfg.apiKey;
+    const models = createModels();
+    models.setProvider(createProvider({
+        id: "deepseek",
+        name: "DeepSeek",
+        baseUrl: cfg.endpoint,
+        auth: {
+            apiKey: {
+                name: "DeepSeek API key",
+                async resolve() {
+                    return { auth: { apiKey }, source: "visitor_config" };
+                },
+            },
+        },
+        models: [model],
+        api: openAICompletionsApi(),
+    }));
+    const resolved = models.getModel("deepseek", cfg.modelId);
+    if (!resolved)
+        throw new Error("model_not_found");
+    return { models, model: resolved };
+}
+//# sourceMappingURL=run.js.map

package/dist/server/agent/Agent/run.js.map

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

package/dist/server/agent/Agent/session-manager.js

@@ -0,0 +1,147 @@
+import fs from "node:fs";
+import path from "node:path";
+import { randomUUID } from "node:crypto";
+import { getConfig } from "../../config/index.js";
+function safeString(v) {
+    if (typeof v !== "string")
+        return null;
+    const t = v.trim();
+    return t ? t : null;
+}
+function nowIso() {
+    return new Date().toISOString();
+}
+export class AgentSessionManager {
+    visitorId;
+    tenantDir;
+    sessionDir;
+    metaPath;
+    cachedSessionId = null;
+    constructor(visitorId) {
+        this.visitorId = visitorId;
+        const { dataDir } = getConfig();
+        // tenant 仅用于访客私有运行时数据（知识库仍走 files/）
+        this.tenantDir = path.join(dataDir, "tenant", visitorId);
+        this.sessionDir = path.join(this.tenantDir, "agent", "session");
+        this.metaPath = path.join(this.sessionDir, "session.json");
+    }
+    jsonlPath(sessionId) {
+        return path.join(this.sessionDir, `${sessionId}.jsonl`);
+    }
+    async ensureSessionDir() {
+        await fs.promises.mkdir(this.sessionDir, { recursive: true });
+    }
+    async readMeta() {
+        try {
+            const txt = await fs.promises.readFile(this.metaPath, "utf8");
+            const parsed = JSON.parse(txt);
+            const lastOpenedSessionId = safeString(parsed?.lastOpenedSessionId);
+            if (!lastOpenedSessionId)
+                return null;
+            return {
+                lastOpenedSessionId,
+                sessions: Array.isArray(parsed?.sessions) ? parsed.sessions : undefined,
+            };
+        }
+        catch (err) {
+            if (err && typeof err === "object" && "code" in err && err.code === "ENOENT")
+                return null;
+            return null;
+        }
+    }
+    async writeMeta(meta) {
+        const txt = JSON.stringify(meta, null, 2);
+        await fs.promises.writeFile(this.metaPath, txt, "utf8");
+    }
+    ensureSessionEntry(meta, sessionId) {
+        if (!meta.sessions)
+            meta.sessions = [];
+        const exists = meta.sessions.some((s) => s.id === sessionId);
+        if (!exists)
+            meta.sessions.push({ id: sessionId, updatedAt: nowIso() });
+        meta.sessions = meta.sessions
+            .filter((s) => safeString(s?.id) === s.id)
+            .map((s) => (s.id === sessionId ? { ...s, updatedAt: s.updatedAt ?? nowIso() } : s));
+    }
+    async ensureLastOpened() {
+        await this.ensureSessionDir();
+        if (this.cachedSessionId)
+            return this.cachedSessionId;
+        const meta = await this.readMeta();
+        if (!meta) {
+            const sessionId = randomUUID();
+            const created = {
+                lastOpenedSessionId: sessionId,
+                sessions: [{ id: sessionId, updatedAt: nowIso() }],
+            };
+            await this.writeMeta(created);
+            this.cachedSessionId = sessionId;
+            return sessionId;
+        }
+        const sessionId = meta.lastOpenedSessionId;
+        this.ensureSessionEntry(meta, sessionId);
+        // 维护 sessions.updatedAt（首次读也做一次轻更新）
+        const updatedAt = nowIso();
+        meta.sessions = meta.sessions?.map((s) => (s.id === sessionId ? { ...s, updatedAt } : s));
+        meta.lastOpenedSessionId = sessionId;
+        await this.writeMeta(meta);
+        this.cachedSessionId = sessionId;
+        return sessionId;
+    }
+    async loadLastOpenedMessages() {
+        const sessionId = await this.ensureLastOpened();
+        const jsonlPath = this.jsonlPath(sessionId);
+        try {
+            const txt = await fs.promises.readFile(jsonlPath, "utf8");
+            const lines = txt.split("\n").map((l) => l.trim()).filter(Boolean);
+            const messages = [];
+            for (const line of lines) {
+                try {
+                    const row = JSON.parse(line);
+                    const role = row.role === "user" ? "user" : row.role === "assistant" ? "assistant" : null;
+                    const content = typeof row.content === "string" ? row.content : null;
+                    if (!role || content === null)
+                        continue;
+                    messages.push({ role, content });
+                }
+                catch {
+                    /* ignore invalid line */
+                }
+            }
+            return { sessionId, messages };
+        }
+        catch (err) {
+            if (err && typeof err === "object" && "code" in err && err.code === "ENOENT") {
+                return { sessionId, messages: [] };
+            }
+            return { sessionId, messages: [] };
+        }
+    }
+    async touchLastOpened(sessionId) {
+        const meta = await this.readMeta();
+        if (!meta) {
+            await this.writeMeta({
+                lastOpenedSessionId: sessionId,
+                sessions: [{ id: sessionId, updatedAt: nowIso() }],
+            });
+            return;
+        }
+        meta.lastOpenedSessionId = sessionId;
+        this.ensureSessionEntry(meta, sessionId);
+        meta.sessions = meta.sessions?.map((s) => (s.id === sessionId ? { ...s, updatedAt: nowIso() } : s));
+        await this.writeMeta(meta);
+    }
+    async appendUser(sessionId, content) {
+        await fs.promises.appendFile(this.jsonlPath(sessionId), JSON.stringify({ role: "user", content, ts: nowIso() }) + "\n", "utf8");
+        await this.touchLastOpened(sessionId);
+    }
+    async appendAssistant(sessionId, content) {
+        await fs.promises.appendFile(this.jsonlPath(sessionId), JSON.stringify({ role: "assistant", content, ts: nowIso() }) + "\n", "utf8");
+        await this.touchLastOpened(sessionId);
+    }
+}
+export async function getAgentSessionForApi(visitorId) {
+    const manager = new AgentSessionManager(visitorId);
+    return manager.loadLastOpenedMessages();
+}
+//# sourceMappingURL=session-manager.js.map

package/dist/server/agent/Agent/session-manager.js.map

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

package/dist/server/agent/Agent/system-prompt.js

@@ -0,0 +1,13 @@
+const RULES = `你是 mdocs 的上手向导，只帮助用户理解如何使用 mdocs（域、草稿、发布、Slash、权限等）。
+
+规则：
+1. 禁止代写、润色、改写用户文档，也不要给出可直接粘贴进正文的长文草稿。
+2. 需要产品知识时：先调用「查询 mdocs 手册大纲」了解有哪些主题，再调用「查询 mdocs 手册正文」按 id 阅读相关章节后回答。
+3. 若用户要求写作或改文档，明确拒绝，并提示他们在编辑器中自行操作。
+4. 回答简洁、面向操作步骤。
+5. 每轮回答正文结束后，另起一段追加一句引导（只追加一次，不要反复追问）：先问「您还有什么想了解的吗？」，再给 1～2 个与本轮话题相关、可继续深挖的具体问题示例（例如「比如：受限域怎么加成员？」「比如：文档档位和邀请有什么区别？」）。示例要短、可直接当作下一句提问；与当前无关的主题不要乱推。`;
+/** 组装 system prompt：角色规则 + tool 使用说明（手册目录由 tool 按需返回） */
+export function buildSystemPrompt() {
+    return RULES;
+}
+//# sourceMappingURL=system-prompt.js.map

package/dist/server/agent/Agent/system-prompt.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"system-prompt.js","sourceRoot":"","sources":["../../../../src/server/agent/Agent/system-prompt.ts"],"names":[],"mappings":"AAAA,MAAM,KAAK,GAAG;;;;;;;qJAOuI,CAAC;AAEtJ,yDAAyD;AACzD,MAAM,UAAU,iBAAiB;IAC/B,OAAO,KAAK,CAAC;AACf,CAAC"}

package/dist/server/agent/Agent/tools.js

@@ -0,0 +1,37 @@
+import { Type } from "@earendil-works/pi-ai";
+export function createSkillTools(skills) {
+    return [
+        {
+            name: "mdocs_manual_outline",
+            label: "查询 mdocs 手册大纲",
+            description: "列出 mdocs 用户手册各章节元数据（id / name / description），用于选择要阅读的章节",
+            parameters: Type.Object({}),
+            execute: async () => ({
+                content: [{ type: "text", text: JSON.stringify(skills.list(), null, 2) }],
+                details: {},
+            }),
+        },
+        {
+            name: "mdocs_manual_content",
+            label: "查询 mdocs 手册正文",
+            description: "按 id 读取 mdocs 用户手册某一章节的完整正文",
+            parameters: Type.Object({
+                id: Type.String({ description: "章节 id，来自「查询 mdocs 手册大纲」" }),
+            }),
+            execute: async (_id, params) => {
+                const id = params.id;
+                const body = skills.read(id);
+                if (!body)
+                    throw new Error(`手册章节不存在: ${id}，请先调用「查询 mdocs 手册大纲」`);
+                const source = body.url
+                    ? { id: body.id, name: body.name, url: body.url }
+                    : null;
+                return {
+                    content: [{ type: "text", text: body.content }],
+                    details: { id: body.id, source },
+                };
+            },
+        },
+    ];
+}
+//# sourceMappingURL=tools.js.map

package/dist/server/agent/Agent/tools.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tools.js","sourceRoot":"","sources":["../../../../src/server/agent/Agent/tools.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAE,MAAM,uBAAuB,CAAC;AAU7C,MAAM,UAAU,gBAAgB,CAAC,MAAmB;IAClD,OAAO;QACL;YACE,IAAI,EAAE,sBAAsB;YAC5B,KAAK,EAAE,eAAe;YACtB,WAAW,EACT,yDAAyD;YAC3D,UAAU,EAAE,IAAI,CAAC,MAAM,CAAC,EAAE,CAAC;YAC3B,OAAO,EAAE,KAAK,IAAI,EAAE,CAAC,CAAC;gBACpB,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,IAAI,EAAE,EAAE,IAAI,EAAE,CAAC,CAAC,EAAE,CAAC;gBACzE,OAAO,EAAE,EAAE;aACZ,CAAC;SACH;QACD;YACE,IAAI,EAAE,sBAAsB;YAC5B,KAAK,EAAE,eAAe;YACtB,WAAW,EAAE,6BAA6B;YAC1C,UAAU,EAAE,IAAI,CAAC,MAAM,CAAC;gBACtB,EAAE,EAAE,IAAI,CAAC,MAAM,CAAC,EAAE,WAAW,EAAE,yBAAyB,EAAE,CAAC;aAC5D,CAAC;YACF,OAAO,EAAE,KAAK,EAAE,GAAG,EAAE,MAAM,EAAE,EAAE;gBAC7B,MAAM,EAAE,GAAI,MAAyB,CAAC,EAAE,CAAC;gBACzC,MAAM,IAAI,GAAG,MAAM,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;gBAC7B,IAAI,CAAC,IAAI;oBAAE,MAAM,IAAI,KAAK,CAAC,YAAY,EAAE,sBAAsB,CAAC,CAAC;gBACjE,MAAM,MAAM,GAA2B,IAAI,CAAC,GAAG;oBAC7C,CAAC,CAAC,EAAE,EAAE,EAAE,IAAI,CAAC,EAAE,EAAE,IAAI,EAAE,IAAI,CAAC,IAAI,EAAE,GAAG,EAAE,IAAI,CAAC,GAAG,EAAE;oBACjD,CAAC,CAAC,IAAI,CAAC;gBACT,OAAO;oBACL,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,IAAI,CAAC,OAAO,EAAE,CAAC;oBAC/C,OAAO,EAAE,EAAE,EAAE,EAAE,IAAI,CAAC,EAAE,EAAE,MAAM,EAAE;iBACjC,CAAC;YACJ,CAAC;SACF;KACF,CAAC;AACJ,CAAC"}