@page.su/ai-blog-cli 0.1.0-beta.1

package/dist/tools/helpers.js

@@ -0,0 +1,65 @@
+/**
+ * MCP 工具通用 helper 函数
+ * 统一处理工具返回值和错误格式，避免各工具文件重复定义
+ */
+import { ApiClientError } from "../api-client.js";
+/**
+ * 将数据转换为 MCP 工具的标准文本响应格式
+ */
+export function toToolText(value) {
+    return {
+        content: [
+            {
+                type: "text",
+                text: typeof value === "string" ? value : JSON.stringify(value, null, 2),
+            },
+        ],
+    };
+}
+/**
+ * 将错误转换为 MCP 工具的标准错误响应格式
+ * 对 ApiClientError 做特殊处理，输出 HTTP 状态码和校验问题
+ */
+export function toToolError(error) {
+    let text;
+    if (error instanceof ApiClientError) {
+        const lines = [`HTTP ${error.status}: ${error.message}`];
+        if (error.issues !== undefined) {
+            lines.push("Validation issues:");
+            lines.push(JSON.stringify(error.issues, null, 2));
+        }
+        text = lines.join("\n");
+    }
+    else if (error instanceof Error) {
+        text = error.message;
+    }
+    else {
+        text = String(error);
+    }
+    return {
+        content: [{ type: "text", text }],
+        isError: true,
+    };
+}
+/**
+ * 安全执行异步函数，自动捕获错误并转换为标准错误格式
+ * 用于简化工具函数的错误处理逻辑
+ */
+export async function safe(fn) {
+    try {
+        const result = await fn();
+        return toToolText(result);
+    }
+    catch (error) {
+        return toToolError(error);
+    }
+}
+/**
+ * 导出统一的 helper 对象，方便导入使用
+ */
+export const toolReplyHelpers = {
+    toToolText,
+    toToolError,
+    safe,
+};
+//# sourceMappingURL=helpers.js.map

package/dist/tools/helpers.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"helpers.js","sourceRoot":"","sources":["../../src/tools/helpers.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAElD;;GAEG;AACH,MAAM,UAAU,UAAU,CAAC,KAAc;IACvC,OAAO;QACL,OAAO,EAAE;YACP;gBACE,IAAI,EAAE,MAAM;gBACZ,IAAI,EAAE,OAAO,KAAK,KAAK,QAAQ,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC;aACzE;SACF;KACF,CAAC;AACJ,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,WAAW,CAAC,KAAc;IAIxC,IAAI,IAAY,CAAC;IACjB,IAAI,KAAK,YAAY,cAAc,EAAE,CAAC;QACpC,MAAM,KAAK,GAAG,CAAC,QAAQ,KAAK,CAAC,MAAM,KAAK,KAAK,CAAC,OAAO,EAAE,CAAC,CAAC;QACzD,IAAI,KAAK,CAAC,MAAM,KAAK,SAAS,EAAE,CAAC;YAC/B,KAAK,CAAC,IAAI,CAAC,oBAAoB,CAAC,CAAC;YACjC,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC;QACpD,CAAC;QACD,IAAI,GAAG,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IAC1B,CAAC;SAAM,IAAI,KAAK,YAAY,KAAK,EAAE,CAAC;QAClC,IAAI,GAAG,KAAK,CAAC,OAAO,CAAC;IACvB,CAAC;SAAM,CAAC;QACN,IAAI,GAAG,MAAM,CAAC,KAAK,CAAC,CAAC;IACvB,CAAC;IACD,OAAO;QACL,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC;QACjC,OAAO,EAAE,IAAI;KACd,CAAC;AACJ,CAAC;AAED;;;GAGG;AACH,MAAM,CAAC,KAAK,UAAU,IAAI,CACxB,EAAoB;IAEpB,IAAI,CAAC;QACH,MAAM,MAAM,GAAG,MAAM,EAAE,EAAE,CAAC;QAC1B,OAAO,UAAU,CAAC,MAAM,CAAC,CAAC;IAC5B,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,OAAO,WAAW,CAAC,KAAK,CAAC,CAAC;IAC5B,CAAC;AACH,CAAC;AAED;;GAEG;AACH,MAAM,CAAC,MAAM,gBAAgB,GAAG;IAC9B,UAAU;IACV,WAAW;IACX,IAAI;CACL,CAAC"}

package/dist/tools/knowledge.d.ts

@@ -0,0 +1,4 @@
+import type { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import type { ApiClient } from "../api-client.js";
+export declare function registerKnowledgeTools(server: McpServer, api: ApiClient): void;
+//# sourceMappingURL=knowledge.d.ts.map

package/dist/tools/knowledge.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"knowledge.d.ts","sourceRoot":"","sources":["../../src/tools/knowledge.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AACzE,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAC;AAuClD,wBAAgB,sBAAsB,CAAC,MAAM,EAAE,SAAS,EAAE,GAAG,EAAE,SAAS,GAAG,IAAI,CAgI9E"}

package/dist/tools/knowledge.js

@@ -0,0 +1,140 @@
+import { z } from "zod";
+import { toToolText, toToolError } from "./helpers.js";
+/**
+ * 统一知识库 MCP 工具：knowledge.list / get / create / update / delete / find_or_suggest
+ *
+ * 合并了原 glossary 和 math-concepts 两套工具。
+ * 通过 domain 参数区分：glossary（纯术语）、math（数学概念）、all（全部）。
+ * 数学概念额外支持 mathEnhancement 字段（difficulty/formulas/notation/prerequisites）。
+ */
+/** 知识条目基础字段 schema */
+const knowledgeFieldsShape = {
+    title: z.string().min(1).describe("知识条目标题，必填").optional(),
+    slug: z.string().describe("条目 slug；为空时由后端自动生成").optional(),
+    status: z.enum(["draft", "published"]).describe("状态").optional(),
+    publishedAt: z.string().describe("ISO 时间字符串").optional(),
+    categoryIds: z.array(z.string().uuid()).describe("分类 id 列表").optional(),
+    tagIds: z.array(z.string().uuid()).describe("标签 id 列表").optional(),
+    excerpt: z.string().describe("摘要，最长 400 字符").optional(),
+    content: z.string().describe("Markdown 正文，知识条目的完整说明").optional(),
+    seoTitle: z.string().describe("SEO 标题").optional(),
+    seoDescription: z.string().describe("SEO 描述").optional(),
+    terms: z.string().describe("匹配词，多个用 | 分隔，如 'Promise|Thenable'").optional(),
+    brief: z.string().describe("简短释义（≤200字），用于 hover tooltip").optional(),
+    autoLink: z.boolean().describe("是否启用自动高亮匹配").optional(),
+    mathEnhancement: z.object({
+        difficulty: z.number().int().min(1).max(5).describe("难度等级 1-5（1=入门, 2=基础, 3=进阶, 4=高级, 5=专家）").optional(),
+        formulas: z.string().describe("核心公式（LaTeX），列表页预览用。同一公式不可重复创建，系统会自动去重检查").optional(),
+        notation: z.string().describe("符号说明。推荐使用 JSON 格式（结构化参数表 + 可选分步计算），示例：" +
+            '{"params":[{"symbol":"z_i","name":"第i个输入值","detail":"任意实数","range":"(-∞,+∞)"}],' +
+            '"steps":[{"expression":"e^{z_i}","explanation":"对每个输入值取指数，确保结果为正数"}]}。' +
+            "也兼容旧格式：'n: 样本数, μ: 均值'").optional(),
+        prerequisites: z.string().describe("前置知识 slug 列表（逗号分隔）").optional(),
+    }).describe("数学增强字段，传入则标记为数学概念，不传或传 null 则为普通术语").optional().nullable(),
+};
+export function registerKnowledgeTools(server, api) {
+    // ── knowledge.list ──
+    server.tool("knowledge_list", "列出知识库中的条目。支持按域（general=术语/math=数学概念/all=全部）、状态、难度筛选和关键词搜索。", {
+        domain: z.enum(["all", "glossary", "math"]).describe("筛选域：all=全部, glossary=纯术语, math=数学概念").optional(),
+        status: z.enum(["draft", "published"]).describe("按状态筛选").optional(),
+        difficulty: z.number().int().min(1).max(5).describe("按难度筛选（1-5），仅对数学概念有效").optional(),
+        search: z.string().describe("搜索关键词（匹配条目名/匹配词）").optional(),
+        page: z.number().int().positive().describe("页码，默认 1").optional(),
+        pageSize: z.number().int().positive().max(100).describe("每页数量，默认 20").optional(),
+    }, async ({ domain, status, difficulty, search, page, pageSize }) => {
+        try {
+            const params = new URLSearchParams();
+            params.set("action", "list");
+            if (domain)
+                params.set("domain", domain);
+            if (status)
+                params.set("status", status);
+            if (difficulty)
+                params.set("difficulty", String(difficulty));
+            if (search)
+                params.set("search", search);
+            if (page)
+                params.set("page", String(page));
+            if (pageSize)
+                params.set("pageSize", String(pageSize));
+            const result = await api.get(`/api/mcp/knowledge?${params.toString()}`);
+            return toToolText(result);
+        }
+        catch (error) {
+            return toToolError(error);
+        }
+    });
+    // ── knowledge.get ──
+    server.tool("knowledge_get", "获取一个知识条目的完整可编辑数据，包含匹配词、简短释义、Markdown 正文，以及数学增强字段（如有）。", {
+        id: z.string().uuid().describe("知识条目 id (uuid)"),
+    }, async ({ id }) => {
+        try {
+            const result = await api.get(`/api/mcp/knowledge?action=get&id=${id}`);
+            return toToolText(result);
+        }
+        catch (error) {
+            return toToolError(error);
+        }
+    });
+    // ── knowledge.create ──
+    server.tool("knowledge_create", "创建一个新的知识条目。terms（匹配词）和 brief（简短释义）为必填字段。" +
+        "传入 mathEnhancement 则创建为数学概念，不传则为普通术语。" +
+        "⚠️ 创建前先用 knowledge.find_or_suggest 查重，避免重复创建。", knowledgeFieldsShape, async (params) => {
+        try {
+            const result = await api.post("/api/mcp/knowledge", {
+                action: "create",
+                data: params,
+            });
+            return toToolText(result);
+        }
+        catch (error) {
+            return toToolError(error);
+        }
+    });
+    // ── knowledge.update ──
+    server.tool("knowledge_update", "更新一个已有的知识条目。传入 mathEnhancement 可添加/更新数学增强；传入 null 可移除数学增强，将其降级为普通术语。", {
+        id: z.string().uuid().describe("知识条目 id (uuid)"),
+        ...knowledgeFieldsShape,
+    }, async ({ id, ...data }) => {
+        try {
+            const result = await api.post("/api/mcp/knowledge", {
+                action: "update",
+                id,
+                data,
+            });
+            return toToolText(result);
+        }
+        catch (error) {
+            return toToolError(error);
+        }
+    });
+    // ── knowledge.delete ──
+    server.tool("knowledge_delete", "永久删除一个知识条目。请谨慎使用。", {
+        id: z.string().uuid().describe("知识条目 id (uuid)"),
+    }, async ({ id }) => {
+        try {
+            const result = await api.post("/api/mcp/knowledge", {
+                action: "delete",
+                id,
+            });
+            return toToolText(result);
+        }
+        catch (error) {
+            return toToolError(error);
+        }
+    });
+    // ── knowledge.find_or_suggest ──
+    server.tool("knowledge_find_or_suggest", "写文章时传入关键词，查找是否已有匹配的知识条目。如果有则返回条目信息（可直接引用），如果没有则提示创建新条目。" +
+        "⚠️ 推荐在写文章时对正文涉及的专业术语逐一调用此工具，确保与知识库关联。", {
+        keyword: z.string().min(1).describe("要查找的关键词，如 '贝叶斯' 或 'Promise'"),
+    }, async ({ keyword }) => {
+        try {
+            const result = await api.get(`/api/mcp/knowledge?action=find_or_suggest&keyword=${encodeURIComponent(keyword)}`);
+            return toToolText(result);
+        }
+        catch (error) {
+            return toToolError(error);
+        }
+    });
+}
+//# sourceMappingURL=knowledge.js.map

package/dist/tools/knowledge.js.map

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

package/dist/tools/math-concepts.d.ts

@@ -0,0 +1,4 @@
+import type { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import { type ApiClient } from "../api-client.js";
+export declare function registerMathConceptTools(server: McpServer, api: ApiClient): void;
+//# sourceMappingURL=math-concepts.d.ts.map

package/dist/tools/math-concepts.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"math-concepts.d.ts","sourceRoot":"","sources":["../../src/tools/math-concepts.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AACzE,OAAO,EAAkB,KAAK,SAAS,EAAE,MAAM,kBAAkB,CAAC;AAgElE,wBAAgB,wBAAwB,CAAC,MAAM,EAAE,SAAS,EAAE,GAAG,EAAE,SAAS,GAAG,IAAI,CA0HhF"}

package/dist/tools/math-concepts.js

@@ -0,0 +1,158 @@
+import { z } from "zod";
+import { ApiClientError } from "../api-client.js";
+/**
+ * 数学知识库相关 MCP 工具：math_concept.list / get / create / update / delete / find_or_suggest
+ *
+ * 独立于 post 和 glossary 工具，数学概念有额外的 difficulty/formulas/notation/prerequisites 字段，
+ * 且语义上应与文章和术语区分，AI 使用时更清晰。
+ */
+/** 数学概念字段 schema */
+const mathConceptFieldsShape = {
+    title: z.string().min(1).describe("数学概念标题，必填").optional(),
+    slug: z.string().describe("概念 slug；为空时由后端自动生成").optional(),
+    status: z.enum(["draft", "published"]).describe("状态").optional(),
+    publishedAt: z.string().describe("ISO 时间字符串").optional(),
+    categoryIds: z.array(z.string().uuid()).describe("分类 id 列表").optional(),
+    tagIds: z.array(z.string().uuid()).describe("标签 id 列表").optional(),
+    excerpt: z.string().describe("摘要，最长 400 字符").optional(),
+    content: z.string().describe("Markdown 正文，数学概念的完整说明，建议包含 Live Demo 可视化").optional(),
+    seoTitle: z.string().describe("SEO 标题").optional(),
+    seoDescription: z.string().describe("SEO 描述").optional(),
+    terms: z.string().describe("匹配词，多个用 | 分隔，如 '贝叶斯定理|Bayes' theorem|贝叶斯公式'").optional(),
+    brief: z.string().describe("简短释义（≤200字），用于 hover tooltip").optional(),
+    autoLink: z.boolean().describe("是否启用自动高亮匹配").optional(),
+    difficulty: z.number().int().min(1).max(5).describe("难度等级 1-5（1=入门, 2=基础, 3=进阶, 4=高级, 5=专家）").optional(),
+    formulas: z.string().describe("核心公式（LaTeX），列表页预览用").optional(),
+    notation: z.string().describe("符号说明，如 'n: 样本数, μ: 均值'").optional(),
+    prerequisites: z.string().describe("前置知识 slug 列表（逗号分隔）").optional(),
+};
+function toToolText(value) {
+    return {
+        content: [
+            {
+                type: "text",
+                text: typeof value === "string" ? value : JSON.stringify(value, null, 2),
+            },
+        ],
+    };
+}
+function toToolError(error) {
+    let text;
+    if (error instanceof ApiClientError) {
+        const lines = [`HTTP ${error.status}: ${error.message}`];
+        if (error.issues !== undefined) {
+            lines.push("Validation issues:");
+            lines.push(JSON.stringify(error.issues, null, 2));
+        }
+        text = lines.join("\n");
+    }
+    else if (error instanceof Error) {
+        text = error.message;
+    }
+    else {
+        text = String(error);
+    }
+    return {
+        content: [{ type: "text", text }],
+        isError: true,
+    };
+}
+export function registerMathConceptTools(server, api) {
+    // ── math_concept.list ──
+    server.tool("math_concept_list", "列出数学知识库中的概念。支持按状态筛选、难度筛选和关键词搜索。", {
+        status: z.enum(["draft", "published"]).describe("按状态筛选").optional(),
+        difficulty: z.number().int().min(1).max(5).describe("按难度筛选（1-5）").optional(),
+        search: z.string().describe("搜索关键词（匹配概念名/匹配词）").optional(),
+        page: z.number().int().positive().describe("页码，默认 1").optional(),
+        pageSize: z.number().int().positive().max(100).describe("每页数量，默认 20").optional(),
+    }, async ({ status, difficulty, search, page, pageSize }) => {
+        try {
+            const params = new URLSearchParams();
+            if (status)
+                params.set("status", status);
+            if (difficulty)
+                params.set("difficulty", String(difficulty));
+            if (search)
+                params.set("search", search);
+            if (page)
+                params.set("page", String(page));
+            if (pageSize)
+                params.set("pageSize", String(pageSize));
+            const result = await api.get(`/api/mcp/math-concepts?action=list&${params.toString()}`);
+            return toToolText(result);
+        }
+        catch (error) {
+            return toToolError(error);
+        }
+    });
+    // ── math_concept.get ──
+    server.tool("math_concept_get", "获取一个数学概念的完整可编辑数据，包含匹配词、简短释义、难度、公式、符号说明等。", {
+        id: z.string().uuid().describe("数学概念 id (uuid)"),
+    }, async ({ id }) => {
+        try {
+            const result = await api.get(`/api/mcp/math-concepts?action=get&id=${id}`);
+            return toToolText(result);
+        }
+        catch (error) {
+            return toToolError(error);
+        }
+    });
+    // ── math_concept.create ──
+    server.tool("math_concept_create", "创建一个新的数学概念条目。terms（匹配词）、brief（简短释义）、difficulty（难度）为关键字段。content 建议包含 Live Demo 可视化。", mathConceptFieldsShape, async (params) => {
+        try {
+            const result = await api.post("/api/mcp/math-concepts", {
+                action: "create",
+                data: params,
+            });
+            return toToolText(result);
+        }
+        catch (error) {
+            return toToolError(error);
+        }
+    });
+    // ── math_concept.update ──
+    server.tool("math_concept_update", "更新一个已有的数学概念条目。需要传入完整字段。", {
+        id: z.string().uuid().describe("数学概念 id (uuid)"),
+        ...mathConceptFieldsShape,
+    }, async ({ id, ...data }) => {
+        try {
+            const result = await api.post("/api/mcp/math-concepts", {
+                action: "update",
+                id,
+                data,
+            });
+            return toToolText(result);
+        }
+        catch (error) {
+            return toToolError(error);
+        }
+    });
+    // ── math_concept.delete ──
+    server.tool("math_concept_delete", "永久删除一个数学概念条目。请谨慎使用。", {
+        id: z.string().uuid().describe("数学概念 id (uuid)"),
+    }, async ({ id }) => {
+        try {
+            const result = await api.post("/api/mcp/math-concepts", {
+                action: "delete",
+                id,
+            });
+            return toToolText(result);
+        }
+        catch (error) {
+            return toToolError(error);
+        }
+    });
+    // ── math_concept.find_or_suggest ──
+    server.tool("math_concept_find_or_suggest", "写文章时传入数学关键词，查找是否已有匹配的数学概念。如果有则返回概念信息（可直接引用），如果没有则提示创建新概念。这是写数学相关文章时推荐先调用的工具。", {
+        keyword: z.string().min(1).describe("要查找的数学关键词，如 '贝叶斯' 或 'gradient descent'"),
+    }, async ({ keyword }) => {
+        try {
+            const result = await api.get(`/api/mcp/math-concepts?action=find_or_suggest&keyword=${encodeURIComponent(keyword)}`);
+            return toToolText(result);
+        }
+        catch (error) {
+            return toToolError(error);
+        }
+    });
+}
+//# sourceMappingURL=math-concepts.js.map

package/dist/tools/math-concepts.js.map

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

package/dist/tools/posts.d.ts

@@ -0,0 +1,35 @@
+import type { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import { type ApiClient } from "../api-client.js";
+/** 把任意值序列化为可读 JSON 文本，用于 tool result */
+declare function toToolText(value: unknown): {
+    content: Array<{
+        type: "text";
+        text: string;
+    }>;
+};
+/** 把 ApiClientError 转成可读的 tool error result，让 AI 能在对话里看到原因 */
+declare function toToolError(error: unknown): {
+    content: Array<{
+        type: "text";
+        text: string;
+    }>;
+    isError: true;
+};
+/** 在 tool 的 callback 内统一接住异常，避免抛出去后 SDK 给客户端 generic 错误 */
+declare function safe<T>(fn: () => Promise<T>): Promise<{
+    content: Array<{
+        type: "text";
+        text: string;
+    }>;
+    isError?: true;
+}>;
+/** 注册全部 post.* 工具 */
+export declare function registerPostTools(server: McpServer, api: ApiClient): void;
+/** 工具内部辅助：暴露给 build.ts / validate.ts 等共享 toToolText/toToolError */
+export declare const toolReplyHelpers: {
+    toToolText: typeof toToolText;
+    toToolError: typeof toToolError;
+    safe: typeof safe;
+};
+export {};
+//# sourceMappingURL=posts.d.ts.map

package/dist/tools/posts.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"posts.d.ts","sourceRoot":"","sources":["../../src/tools/posts.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AACzE,OAAO,EAAkB,KAAK,SAAS,EAAE,MAAM,kBAAkB,CAAC;AA6ClE,wCAAwC;AACxC,iBAAS,UAAU,CAAC,KAAK,EAAE,OAAO,GAAG;IAAE,OAAO,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,CAAC,CAAA;CAAE,CAStF;AAED,8DAA8D;AAC9D,iBAAS,WAAW,CAAC,KAAK,EAAE,OAAO,GAAG;IACpC,OAAO,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IAC/C,OAAO,EAAE,IAAI,CAAC;CACf,CAkBA;AAED,2DAA2D;AAC3D,iBAAe,IAAI,CAAC,CAAC,EACnB,EAAE,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,GACnB,OAAO,CAAC;IAAE,OAAO,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IAAC,OAAO,CAAC,EAAE,IAAI,CAAA;CAAE,CAAC,CAO7E;AAED,qBAAqB;AACrB,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,SAAS,EAAE,GAAG,EAAE,SAAS,GAAG,IAAI,CAwRzE;AAED,mEAAmE;AACnE,eAAO,MAAM,gBAAgB;;;;CAAoC,CAAC"}