@wecom/wecom-openclaw-plugin 2026.3.31-beta.0 → 2026.4.1-beta.1

package/dist/cjs/src/mcp/interceptors/msg-media.js

@@ -0,0 +1,159 @@
+'use strict';
+
+var fs = require('node:fs/promises');
+var path = require('node:path');
+var transport = require('../transport.js');
+var runtime = require('../../runtime.js');
+var openclawCompat = require('../../openclaw-compat.js');
+
+function _interopNamespaceDefault(e) {
+    var n = Object.create(null);
+    if (e) {
+        Object.keys(e).forEach(function (k) {
+            if (k !== 'default') {
+                var d = Object.getOwnPropertyDescriptor(e, k);
+                Object.defineProperty(n, k, d.get ? d : {
+                    enumerable: true,
+                    get: function () { return e[k]; }
+                });
+            }
+        });
+    }
+    n.default = e;
+    return Object.freeze(n);
+}
+
+var fs__namespace = /*#__PURE__*/_interopNamespaceDefault(fs);
+var path__namespace = /*#__PURE__*/_interopNamespaceDefault(path);
+
+/**
+ * get_msg_media 响应拦截器
+ *
+ * 核心逻辑：
+ * 1. beforeCall: 设置延长的超时时间（120s），因为 base64 数据可达 ~27MB
+ * 2. afterCall: 从 MCP result 的 content[].text 中提取 base64_data，
+ *    解码为 Buffer 并通过 saveMediaBuffer 保存到本地媒体目录，
+ *    替换响应中的 base64_data 为 local_path，避免大模型被 base64 数据消耗 token
+ */
+// ============================================================================
+// 拦截器实现
+// ============================================================================
+const mediaInterceptor = {
+    name: "media",
+    /** 仅对 get_msg_media 方法生效 */
+    match: (ctx) => ctx.method === "get_msg_media",
+    /** 设置延长的超时时间 */
+    beforeCall() {
+        return { timeoutMs: transport.MEDIA_DOWNLOAD_TIMEOUT_MS };
+    },
+    /** 拦截响应：base64 → 本地文件 */
+    async afterCall(ctx, result) {
+        return interceptMediaResponse(result);
+    },
+};
+// ============================================================================
+// 内部实现
+// ============================================================================
+/**
+ * 拦截 get_msg_media 的 MCP 响应
+ *
+ * 1. 从 MCP result 的 content[].text 中提取业务 JSON
+ * 2. 提取 media_item.base64_data，解码为 Buffer
+ * 3. 通过 openclaw SDK 的 saveMediaBuffer 保存到本地媒体目录
+ * 4. 替换响应：移除 base64_data，加入 local_path
+ *
+ * 这样大模型只看到轻量的文件路径信息，不会被 base64 数据消耗 token。
+ */
+async function interceptMediaResponse(result) {
+    const t0 = performance.now();
+    // 1. 提取 MCP result 中的 content 数组
+    const content = result?.content;
+    if (!Array.isArray(content))
+        return result;
+    const textItem = content.find((c) => c.type === "text" && typeof c.text === "string");
+    if (!textItem)
+        return result;
+    // 2. 解析业务 JSON
+    let bizData;
+    try {
+        bizData = JSON.parse(textItem.text);
+    }
+    catch {
+        // 非 JSON 格式，原样返回
+        return result;
+    }
+    // 3. 校验业务响应：errcode !== 0 或无 media_item 时原样返回
+    if (bizData.errcode !== 0)
+        return result;
+    const mediaItem = bizData.media_item;
+    if (!mediaItem || typeof mediaItem.base64_data !== "string")
+        return result;
+    const base64Data = mediaItem.base64_data;
+    const mediaName = mediaItem.name;
+    const mediaType = mediaItem.type;
+    const mediaId = mediaItem.media_id;
+    const tParsed = performance.now();
+    // 4. 解码 base64 → Buffer
+    const buffer = Buffer.from(base64Data, "base64");
+    const tDecoded = performance.now();
+    // 5. 检测 contentType，并通过 saveMediaBuffer 保存到本地媒体目录
+    const contentType = await openclawCompat.detectMime({ buffer, filePath: mediaName }) ?? "application/octet-stream";
+    const tMimeDetected = performance.now();
+    // 企业微信聊天记录附件可达 20MB（文件消息上限），
+    // 而 saveMediaBuffer 默认 maxBytes 为 5MB（针对 outbound 场景），
+    // 此处显式放宽到 20MB 以支持大文件下载。
+    const INBOUND_MAX_BYTES = 20 * 1024 * 1024; // 20MB
+    const core = runtime.getWeComRuntime();
+    const saved = await core.channel.media.saveMediaBuffer(buffer, contentType, "inbound", INBOUND_MAX_BYTES, // maxBytes: 放宽到 20MB，匹配企业微信文件消息上限
+    mediaName);
+    // 5.1 补偿：核心库 EXT_BY_MIME 可能缺少某些格式映射（如 audio/amr），
+    //     导致保存的文件没有后缀。此处检测并修复。
+    const MIME_EXT_PATCH = {
+        "audio/amr": ".amr",
+    };
+    const patchExt = MIME_EXT_PATCH[contentType];
+    if (patchExt && !path__namespace.extname(saved.path)) {
+        const newPath = saved.path + patchExt;
+        try {
+            await fs__namespace.rename(saved.path, newPath);
+            saved.path = newPath;
+        }
+        catch {
+            // rename 失败不影响主流程，文件仍可用
+        }
+    }
+    const tSaved = performance.now();
+    // 6. 构造精简响应，移除 base64_data，加入本地路径
+    const newBizData = {
+        errcode: 0,
+        errmsg: "ok",
+        media_item: {
+            media_id: mediaId,
+            name: mediaName ?? saved.path.split("/").pop(),
+            type: mediaType,
+            local_path: saved.path,
+            size: buffer.length,
+            content_type: saved.contentType,
+        },
+    };
+    const tEnd = performance.now();
+    // 耗时日志：各环节耗时（ms）
+    console.log(`[mcp] get_msg_media 拦截成功: media_id=${mediaId ?? "unknown"}, ` +
+        `type=${mediaType ?? "unknown"}, size=${buffer.length}, saved=${saved.path}\n` +
+        `  ⏱ 耗时明细 (总 ${(tEnd - t0).toFixed(1)}ms):\n` +
+        `    解析响应 JSON:   ${(tParsed - t0).toFixed(1)}ms\n` +
+        `    base64 解码:     ${(tDecoded - tParsed).toFixed(1)}ms  (${(base64Data.length / 1024).toFixed(0)}KB base64 → ${(buffer.length / 1024).toFixed(0)}KB buffer)\n` +
+        `    MIME 检测:       ${(tMimeDetected - tDecoded).toFixed(1)}ms  (${contentType})\n` +
+        `    saveMediaBuffer: ${(tSaved - tMimeDetected).toFixed(1)}ms\n` +
+        `    构造响应:        ${(tEnd - tSaved).toFixed(1)}ms`);
+    // 7. 返回修改后的 MCP result 结构
+    return {
+        content: [{
+                type: "text",
+                text: JSON.stringify(newBizData),
+            }],
+    };
+}
+
+exports.mediaInterceptor = mediaInterceptor;
+//# sourceMappingURL=msg-media.js.map

package/dist/cjs/src/mcp/interceptors/msg-media.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"msg-media.js","sources":["../../../../../../../src/mcp/interceptors/msg-media.ts"],"sourcesContent":["/**\n * get_msg_media 响应拦截器\n *\n * 核心逻辑：\n * 1. beforeCall: 设置延长的超时时间（120s），因为 base64 数据可达 ~27MB\n * 2. afterCall: 从 MCP result 的 content[].text 中提取 base64_data，\n *    解码为 Buffer 并通过 saveMediaBuffer 保存到本地媒体目录，\n *    替换响应中的 base64_data 为 local_path，避免大模型被 base64 数据消耗 token\n */\n\nimport * as fs from \"node:fs/promises\";\nimport * as path from \"node:path\";\nimport { MEDIA_DOWNLOAD_TIMEOUT_MS } from \"../transport.js\";\nimport { getWeComRuntime } from \"../../runtime.js\";\nimport { detectMime } from \"../../openclaw-compat.js\";\nimport type { CallInterceptor, CallContext } from \"./types.js\";\n\n// ============================================================================\n// 拦截器实现\n// ============================================================================\n\nexport const mediaInterceptor: CallInterceptor = {\n  name: \"media\",\n\n  /** 仅对 get_msg_media 方法生效 */\n  match: (ctx: CallContext) => ctx.method === \"get_msg_media\",\n\n  /** 设置延长的超时时间 */\n  beforeCall() {\n    return { timeoutMs: MEDIA_DOWNLOAD_TIMEOUT_MS };\n  },\n\n  /** 拦截响应：base64 → 本地文件 */\n  async afterCall(ctx: CallContext, result: unknown): Promise<unknown> {\n    return interceptMediaResponse(result);\n  },\n};\n\n// ============================================================================\n// 内部实现\n// ============================================================================\n\n/**\n * 拦截 get_msg_media 的 MCP 响应\n *\n * 1. 从 MCP result 的 content[].text 中提取业务 JSON\n * 2. 提取 media_item.base64_data，解码为 Buffer\n * 3. 通过 openclaw SDK 的 saveMediaBuffer 保存到本地媒体目录\n * 4. 替换响应：移除 base64_data，加入 local_path\n *\n * 这样大模型只看到轻量的文件路径信息，不会被 base64 数据消耗 token。\n */\nasync function interceptMediaResponse(result: unknown): Promise<unknown> {\n  const t0 = performance.now();\n\n  // 1. 提取 MCP result 中的 content 数组\n  const content = (result as Record<string, unknown>)?.content;\n  if (!Array.isArray(content)) return result;\n\n  const textItem = content.find(\n    (c: Record<string, unknown>) => c.type === \"text\" && typeof c.text === \"string\",\n  ) as { type: string; text: string } | undefined;\n  if (!textItem) return result;\n\n  // 2. 解析业务 JSON\n  let bizData: Record<string, unknown>;\n  try {\n    bizData = JSON.parse(textItem.text) as Record<string, unknown>;\n  } catch {\n    // 非 JSON 格式，原样返回\n    return result;\n  }\n\n  // 3. 校验业务响应：errcode !== 0 或无 media_item 时原样返回\n  if (bizData.errcode !== 0) return result;\n\n  const mediaItem = bizData.media_item as Record<string, unknown> | undefined;\n  if (!mediaItem || typeof mediaItem.base64_data !== \"string\") return result;\n\n  const base64Data = mediaItem.base64_data as string;\n  const mediaName = mediaItem.name as string | undefined;\n  const mediaType = mediaItem.type as string | undefined;\n  const mediaId = mediaItem.media_id as string | undefined;\n\n  const tParsed = performance.now();\n\n  // 4. 解码 base64 → Buffer\n  const buffer = Buffer.from(base64Data, \"base64\");\n  const tDecoded = performance.now();\n\n  // 5. 检测 contentType，并通过 saveMediaBuffer 保存到本地媒体目录\n  const contentType = await detectMime({ buffer, filePath: mediaName }) ?? \"application/octet-stream\";\n  const tMimeDetected = performance.now();\n\n  // 企业微信聊天记录附件可达 20MB（文件消息上限），\n  // 而 saveMediaBuffer 默认 maxBytes 为 5MB（针对 outbound 场景），\n  // 此处显式放宽到 20MB 以支持大文件下载。\n  const INBOUND_MAX_BYTES = 20 * 1024 * 1024; // 20MB\n\n  const core = getWeComRuntime();\n  const saved = await core.channel.media.saveMediaBuffer(\n    buffer,\n    contentType,\n    \"inbound\",\n    INBOUND_MAX_BYTES,   // maxBytes: 放宽到 20MB，匹配企业微信文件消息上限\n    mediaName,           // originalFilename: 保留原始文件名\n  );\n\n  // 5.1 补偿：核心库 EXT_BY_MIME 可能缺少某些格式映射（如 audio/amr），\n  //     导致保存的文件没有后缀。此处检测并修复。\n  const MIME_EXT_PATCH: Record<string, string> = {\n    \"audio/amr\": \".amr\",\n  };\n  const patchExt = MIME_EXT_PATCH[contentType];\n  if (patchExt && !path.extname(saved.path)) {\n    const newPath = saved.path + patchExt;\n    try {\n      await fs.rename(saved.path, newPath);\n      saved.path = newPath;\n    } catch {\n      // rename 失败不影响主流程，文件仍可用\n    }\n  }\n\n  const tSaved = performance.now();\n\n  // 6. 构造精简响应，移除 base64_data，加入本地路径\n  const newBizData = {\n    errcode: 0,\n    errmsg: \"ok\",\n    media_item: {\n      media_id: mediaId,\n      name: mediaName ?? saved.path.split(\"/\").pop(),\n      type: mediaType,\n      local_path: saved.path,\n      size: buffer.length,\n      content_type: saved.contentType,\n    },\n  };\n\n  const tEnd = performance.now();\n\n  // 耗时日志：各环节耗时（ms）\n  console.log(\n    `[mcp] get_msg_media 拦截成功: media_id=${mediaId ?? \"unknown\"}, ` +\n    `type=${mediaType ?? \"unknown\"}, size=${buffer.length}, saved=${saved.path}\\n` +\n    `  ⏱ 耗时明细 (总 ${(tEnd - t0).toFixed(1)}ms):\\n` +\n    `    解析响应 JSON:   ${(tParsed - t0).toFixed(1)}ms\\n` +\n    `    base64 解码:     ${(tDecoded - tParsed).toFixed(1)}ms  (${(base64Data.length / 1024).toFixed(0)}KB base64 → ${(buffer.length / 1024).toFixed(0)}KB buffer)\\n` +\n    `    MIME 检测:       ${(tMimeDetected - tDecoded).toFixed(1)}ms  (${contentType})\\n` +\n    `    saveMediaBuffer: ${(tSaved - tMimeDetected).toFixed(1)}ms\\n` +\n    `    构造响应:        ${(tEnd - tSaved).toFixed(1)}ms`,\n  );\n\n  // 7. 返回修改后的 MCP result 结构\n  return {\n    content: [{\n      type: \"text\" as const,\n      text: JSON.stringify(newBizData),\n    }],\n  };\n}\n"],"names":["MEDIA_DOWNLOAD_TIMEOUT_MS","detectMime","getWeComRuntime","path","fs"],"mappings":"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"}

package/dist/cjs/src/mcp/interceptors/smartpage-create.js

@@ -0,0 +1,157 @@
+'use strict';
+
+var fs = require('node:fs/promises');
+
+function _interopNamespaceDefault(e) {
+    var n = Object.create(null);
+    if (e) {
+        Object.keys(e).forEach(function (k) {
+            if (k !== 'default') {
+                var d = Object.getOwnPropertyDescriptor(e, k);
+                Object.defineProperty(n, k, d.get ? d : {
+                    enumerable: true,
+                    get: function () { return e[k]; }
+                });
+            }
+        });
+    }
+    n.default = e;
+    return Object.freeze(n);
+}
+
+var fs__namespace = /*#__PURE__*/_interopNamespaceDefault(fs);
+
+/**
+ * smartpage_create 请求拦截器
+ *
+ * 核心逻辑：
+ * smartpage_create 的 pages 数组中，每个 page 可能包含 page_filepath 字段
+ * （指向本地 markdown 文件），用于避免在命令行传递大段文本内容。
+ * 本拦截器在 beforeCall 阶段遍历 pages 数组，逐个读取 page_filepath
+ * 指向的本地文件内容，填入 page_content 字段，并移除 page_filepath。
+ *
+ * 入参约定：
+ *   wecom_mcp call doc smartpage_create '{
+ *     "title": "主页标题",
+ *     "pages": [
+ *       {"page_title": "页面1", "page_filepath": "/tmp/page1.md", "content_type": "markdown"},
+ *       {"page_title": "页面2", "page_filepath": "/tmp/page2.md", "content_type": "markdown"}
+ *     ]
+ *   }'
+ *
+ * 拦截器行为：
+ *   1. 检测 args.pages 数组
+ *   2. 校验文件大小：单文件不超过 10MB，所有文件总计不超过 20MB
+ *   3. 遍历每个 page，若存在 page_filepath 则读取本地文件内容
+ *   4. 将文件内容填入 page_content 字段，移除 page_filepath
+ *   5. 返回修改后的完整 args
+ *
+ * 传给 MCP Server 的格式：
+ *   { "title": "...", "pages": [{"page_title": "...", "page_content": "...", "content_type": "..."}] }
+ */
+// ============================================================================
+// 常量
+// ============================================================================
+/** 单个 page_filepath 文件大小上限：10MB */
+const MAX_SINGLE_FILE_SIZE = 10 * 1024 * 1024;
+/** 所有 page_filepath 文件总大小上限：20MB */
+const MAX_TOTAL_FILE_SIZE = 20 * 1024 * 1024;
+// ============================================================================
+// 内部辅助函数
+// ============================================================================
+/**
+ * 校验所有 page_filepath 的文件大小
+ *
+ * 使用 fs.stat 在读取文件内容之前检查大小，避免超大文件被加载到内存。
+ * - 单文件 > 10MB → 报错
+ * - 所有文件累计 > 20MB → 报错
+ */
+async function validateFileSize(pages) {
+    let totalSize = 0;
+    for (let i = 0; i < pages.length; i++) {
+        const filePath = pages[i].page_filepath;
+        if (typeof filePath !== "string" || !filePath)
+            continue;
+        let stat;
+        try {
+            stat = await fs__namespace.stat(filePath);
+        }
+        catch (err) {
+            // stat 失败不在这里处理，留给后续 readFile 阶段抛出更详细的错误
+            continue;
+        }
+        if (stat.size > MAX_SINGLE_FILE_SIZE) {
+            console.error(`[mcp] smartpage_create: pages[${i}] 文件 "${filePath}" ` +
+                `大小 ${(stat.size / 1024 / 1024).toFixed(1)}MB 超过单文件上限 10MB`);
+            throw new Error("内容大小超出限制，无法创建");
+        }
+        totalSize += stat.size;
+        if (totalSize > MAX_TOTAL_FILE_SIZE) {
+            console.error(`[mcp] smartpage_create: 累计文件大小 ${(totalSize / 1024 / 1024).toFixed(1)}MB ` +
+                `超过总上限 20MB（在 pages[${i}] "${filePath}" 处超出）`);
+            throw new Error("内容大小超出限制，无法创建");
+        }
+    }
+    if (totalSize > 0) {
+        console.log(`[mcp] smartpage_create: 文件大小校验通过，总计 ${(totalSize / 1024 / 1024).toFixed(2)}MB`);
+    }
+}
+/** 异步解析 pages 中的 page_filepath，返回 BeforeCallOptions */
+async function resolvePages(ctx, pages) {
+    console.log(`[mcp] smartpage_create: 开始解析 ${pages.length} 个 page 的 page_filepath`);
+    // 阶段 1：文件大小校验（stat 阶段，不读内容）
+    await validateFileSize(pages);
+    // 阶段 2：读取文件内容
+    const resolvedPages = await Promise.all(pages.map(async (page, index) => {
+        const filePath = page.page_filepath;
+        if (typeof filePath !== "string" || !filePath) {
+            // 该 page 没有 page_filepath，保留原样（可能已有 page_content）
+            return page;
+        }
+        let fileContent;
+        try {
+            fileContent = await fs__namespace.readFile(filePath, "utf-8");
+        }
+        catch (err) {
+            throw new Error(`smartpage_create: pages[${index}] 无法读取文件 "${filePath}": ${err instanceof Error ? err.message : String(err)}`);
+        }
+        console.log(`[mcp] smartpage_create: pages[${index}] 读取成功 "${filePath}" (${fileContent.length} chars)`);
+        // 构造新的 page 对象：填入 page_content，移除 page_filepath
+        const { page_filepath: _, ...rest } = page;
+        return { ...rest, page_content: fileContent };
+    }));
+    console.log(`[mcp] smartpage_create: 所有 page_filepath 解析完成`);
+    // 返回修改后的完整 args
+    return {
+        args: {
+            ...ctx.args,
+            pages: resolvedPages,
+        },
+    };
+}
+// ============================================================================
+// 拦截器实现
+// ============================================================================
+const smartpageCreateInterceptor = {
+    name: "smartpage-create",
+    /** 仅对 doc 品类的 smartpage_create 方法生效 */
+    match: (ctx) => ctx.category === "doc" && ctx.method === "smartpage_create",
+    /** 遍历 pages 数组，逐个读取 page_filepath 填入 page_content */
+    beforeCall(ctx) {
+        const pages = ctx.args.pages;
+        if (!Array.isArray(pages) || pages.length === 0) {
+            // 没有 pages 数组，不做拦截
+            return undefined;
+        }
+        // 检查是否有任何 page 包含 page_filepath
+        const hasFilePath = pages.some((p) => typeof p.page_filepath === "string" && p.page_filepath);
+        if (!hasFilePath) {
+            // 所有 page 都没有 page_filepath（可能直接传了 page_content），不做拦截
+            return undefined;
+        }
+        return resolvePages(ctx, pages);
+    },
+};
+
+exports.smartpageCreateInterceptor = smartpageCreateInterceptor;
+//# sourceMappingURL=smartpage-create.js.map

package/dist/cjs/src/mcp/interceptors/smartpage-create.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"smartpage-create.js","sources":["../../../../../../../src/mcp/interceptors/smartpage-create.ts"],"sourcesContent":["/**\n * smartpage_create 请求拦截器\n *\n * 核心逻辑：\n * smartpage_create 的 pages 数组中，每个 page 可能包含 page_filepath 字段\n * （指向本地 markdown 文件），用于避免在命令行传递大段文本内容。\n * 本拦截器在 beforeCall 阶段遍历 pages 数组，逐个读取 page_filepath\n * 指向的本地文件内容，填入 page_content 字段，并移除 page_filepath。\n *\n * 入参约定：\n *   wecom_mcp call doc smartpage_create '{\n *     \"title\": \"主页标题\",\n *     \"pages\": [\n *       {\"page_title\": \"页面1\", \"page_filepath\": \"/tmp/page1.md\", \"content_type\": \"markdown\"},\n *       {\"page_title\": \"页面2\", \"page_filepath\": \"/tmp/page2.md\", \"content_type\": \"markdown\"}\n *     ]\n *   }'\n *\n * 拦截器行为：\n *   1. 检测 args.pages 数组\n *   2. 校验文件大小：单文件不超过 10MB，所有文件总计不超过 20MB\n *   3. 遍历每个 page，若存在 page_filepath 则读取本地文件内容\n *   4. 将文件内容填入 page_content 字段，移除 page_filepath\n *   5. 返回修改后的完整 args\n *\n * 传给 MCP Server 的格式：\n *   { \"title\": \"...\", \"pages\": [{\"page_title\": \"...\", \"page_content\": \"...\", \"content_type\": \"...\"}] }\n */\n\nimport * as fs from \"node:fs/promises\";\nimport type { CallInterceptor, CallContext, BeforeCallOptions } from \"./types.js\";\n\n// ============================================================================\n// 常量\n// ============================================================================\n\n/** 单个 page_filepath 文件大小上限：10MB */\nconst MAX_SINGLE_FILE_SIZE = 10 * 1024 * 1024;\n/** 所有 page_filepath 文件总大小上限：20MB */\nconst MAX_TOTAL_FILE_SIZE = 20 * 1024 * 1024;\n\n// ============================================================================\n// 内部辅助函数\n// ============================================================================\n\n/**\n * 校验所有 page_filepath 的文件大小\n *\n * 使用 fs.stat 在读取文件内容之前检查大小，避免超大文件被加载到内存。\n * - 单文件 > 10MB → 报错\n * - 所有文件累计 > 20MB → 报错\n */\nasync function validateFileSize(\n  pages: Record<string, unknown>[],\n): Promise<void> {\n  let totalSize = 0;\n\n  for (let i = 0; i < pages.length; i++) {\n    const filePath = pages[i].page_filepath;\n    if (typeof filePath !== \"string\" || !filePath) continue;\n\n    let stat: Awaited<ReturnType<typeof fs.stat>>;\n    try {\n      stat = await fs.stat(filePath);\n    } catch (err) {\n      // stat 失败不在这里处理，留给后续 readFile 阶段抛出更详细的错误\n      continue;\n    }\n\n    if (stat.size > MAX_SINGLE_FILE_SIZE) {\n      console.error(\n        `[mcp] smartpage_create: pages[${i}] 文件 \"${filePath}\" ` +\n        `大小 ${(stat.size / 1024 / 1024).toFixed(1)}MB 超过单文件上限 10MB`,\n      );\n      throw new Error(\"内容大小超出限制，无法创建\");\n    }\n\n    totalSize += stat.size;\n    if (totalSize > MAX_TOTAL_FILE_SIZE) {\n      console.error(\n        `[mcp] smartpage_create: 累计文件大小 ${(totalSize / 1024 / 1024).toFixed(1)}MB ` +\n        `超过总上限 20MB（在 pages[${i}] \"${filePath}\" 处超出）`,\n      );\n      throw new Error(\"内容大小超出限制，无法创建\");\n    }\n  }\n\n  if (totalSize > 0) {\n    console.log(\n      `[mcp] smartpage_create: 文件大小校验通过，总计 ${(totalSize / 1024 / 1024).toFixed(2)}MB`,\n    );\n  }\n}\n\n/** 异步解析 pages 中的 page_filepath，返回 BeforeCallOptions */\nasync function resolvePages(\n  ctx: CallContext,\n  pages: Record<string, unknown>[],\n): Promise<BeforeCallOptions> {\n  console.log(`[mcp] smartpage_create: 开始解析 ${pages.length} 个 page 的 page_filepath`);\n\n  // 阶段 1：文件大小校验（stat 阶段，不读内容）\n  await validateFileSize(pages);\n\n  // 阶段 2：读取文件内容\n  const resolvedPages = await Promise.all(\n    pages.map(async (page: Record<string, unknown>, index: number) => {\n      const filePath = page.page_filepath;\n      if (typeof filePath !== \"string\" || !filePath) {\n        // 该 page 没有 page_filepath，保留原样（可能已有 page_content）\n        return page;\n      }\n\n      let fileContent: string;\n      try {\n        fileContent = await fs.readFile(filePath, \"utf-8\");\n      } catch (err) {\n        throw new Error(\n          `smartpage_create: pages[${index}] 无法读取文件 \"${filePath}\": ${err instanceof Error ? err.message : String(err)}`,\n        );\n      }\n\n      console.log(\n        `[mcp] smartpage_create: pages[${index}] 读取成功 \"${filePath}\" (${fileContent.length} chars)`,\n      );\n\n      // 构造新的 page 对象：填入 page_content，移除 page_filepath\n      const { page_filepath: _, ...rest } = page;\n      return { ...rest, page_content: fileContent };\n    }),\n  );\n\n  console.log(`[mcp] smartpage_create: 所有 page_filepath 解析完成`);\n\n  // 返回修改后的完整 args\n  return {\n    args: {\n      ...ctx.args,\n      pages: resolvedPages,\n    },\n  };\n}\n\n// ============================================================================\n// 拦截器实现\n// ============================================================================\n\nexport const smartpageCreateInterceptor: CallInterceptor = {\n  name: \"smartpage-create\",\n\n  /** 仅对 doc 品类的 smartpage_create 方法生效 */\n  match: (ctx: CallContext) => ctx.category === \"doc\" && ctx.method === \"smartpage_create\",\n\n  /** 遍历 pages 数组，逐个读取 page_filepath 填入 page_content */\n  beforeCall(ctx: CallContext) {\n    const pages = ctx.args.pages;\n    if (!Array.isArray(pages) || pages.length === 0) {\n      // 没有 pages 数组，不做拦截\n      return undefined;\n    }\n\n    // 检查是否有任何 page 包含 page_filepath\n    const hasFilePath = pages.some(\n      (p: Record<string, unknown>) => typeof p.page_filepath === \"string\" && p.page_filepath,\n    );\n    if (!hasFilePath) {\n      // 所有 page 都没有 page_filepath（可能直接传了 page_content），不做拦截\n      return undefined;\n    }\n\n    return resolvePages(ctx, pages);\n  },\n};\n"],"names":["fs"],"mappings":"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"}

package/dist/cjs/src/mcp/interceptors/smartpage-export.js

@@ -0,0 +1,93 @@
+'use strict';
+
+var runtime = require('../../runtime.js');
+
+/**
+ * smartpage_get_export_result 响应拦截器
+ *
+ * 核心逻辑：
+ * MCP Server 返回的 smartpage_get_export_result 响应中，当 task_done=true 时
+ * 会包含 content 字段（markdown 文本内容）。该内容可能很大，直接返回给 LLM
+ * 会消耗大量 token。
+ *
+ * 本拦截器在 afterCall 阶段：
+ * 1. 检测 task_done=true 且存在 content 字段
+ * 2. 将 content 保存到本地文件（使用与 msg-media 一致的媒体目录）
+ * 3. 用 content_path（文件路径）替换 content 字段
+ *
+ * 这样 LLM 只看到轻量的文件路径信息，Skill 可通过文件路径读取完整内容。
+ */
+// ============================================================================
+// 拦截器实现
+// ============================================================================
+const smartpageExportInterceptor = {
+    name: "smartpage-export",
+    /** 仅对 doc 品类的 smartpage_get_export_result 方法生效 */
+    match: (ctx) => ctx.category === "doc" && ctx.method === "smartpage_get_export_result",
+    /** 拦截响应：将 markdown content 保存为本地文件 */
+    async afterCall(_ctx, result) {
+        return interceptExportResponse(result);
+    },
+};
+// ============================================================================
+// 内部实现
+// ============================================================================
+/**
+ * 拦截 smartpage_get_export_result 的 MCP 响应
+ *
+ * 1. 从 MCP result 的 content[].text 中提取业务 JSON
+ * 2. 检测 task_done=true 且存在 content 字段
+ * 3. 将 content（markdown 文本）通过 saveMediaBuffer 保存到本地媒体目录
+ * 4. 构造新响应：移除 content，添加 content_path
+ */
+async function interceptExportResponse(result) {
+    // 1. 提取 MCP result 中的 content 数组
+    const content = result?.content;
+    if (!Array.isArray(content))
+        return result;
+    const textItem = content.find((c) => c.type === "text" && typeof c.text === "string");
+    if (!textItem)
+        return result;
+    // 2. 解析业务 JSON
+    let bizData;
+    try {
+        bizData = JSON.parse(textItem.text);
+    }
+    catch {
+        // 非 JSON 格式，原样返回
+        return result;
+    }
+    // 3. 校验：errcode !== 0 或 task_done 不为 true 或无 content 时原样返回
+    if (bizData.errcode !== 0)
+        return result;
+    if (bizData.task_done !== true)
+        return result;
+    if (typeof bizData.content !== "string")
+        return result;
+    const markdownContent = bizData.content;
+    console.log(`[mcp] smartpage_get_export_result: 拦截 content (${markdownContent.length} chars)，保存到本地文件`);
+    // 4. 将 markdown 内容通过 saveMediaBuffer 保存到本地媒体目录
+    //    使用 text/markdown 类型，与 msg-media 拦截器保持一致的路径管理
+    const buffer = Buffer.from(markdownContent, "utf-8");
+    const core = runtime.getWeComRuntime();
+    const saved = await core.channel.media.saveMediaBuffer(buffer, "text/markdown", "inbound", undefined, // maxBytes: markdown 文本通常不大，使用默认限制
+    "smartpage_export.md");
+    console.log(`[mcp] smartpage_get_export_result: 已保存到 ${saved.path}`);
+    // 5. 构造新响应：移除 content，添加 content_path
+    const newBizData = {
+        errcode: bizData.errcode,
+        errmsg: bizData.errmsg ?? "ok",
+        task_done: true,
+        content_path: saved.path,
+    };
+    // 6. 返回修改后的 MCP result 结构
+    return {
+        content: [{
+                type: "text",
+                text: JSON.stringify(newBizData),
+            }],
+    };
+}
+
+exports.smartpageExportInterceptor = smartpageExportInterceptor;
+//# sourceMappingURL=smartpage-export.js.map

package/dist/cjs/src/mcp/interceptors/smartpage-export.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"smartpage-export.js","sources":["../../../../../../../src/mcp/interceptors/smartpage-export.ts"],"sourcesContent":["/**\n * smartpage_get_export_result 响应拦截器\n *\n * 核心逻辑：\n * MCP Server 返回的 smartpage_get_export_result 响应中，当 task_done=true 时\n * 会包含 content 字段（markdown 文本内容）。该内容可能很大，直接返回给 LLM\n * 会消耗大量 token。\n *\n * 本拦截器在 afterCall 阶段：\n * 1. 检测 task_done=true 且存在 content 字段\n * 2. 将 content 保存到本地文件（使用与 msg-media 一致的媒体目录）\n * 3. 用 content_path（文件路径）替换 content 字段\n *\n * 这样 LLM 只看到轻量的文件路径信息，Skill 可通过文件路径读取完整内容。\n */\n\nimport { getWeComRuntime } from \"../../runtime.js\";\nimport type { CallInterceptor, CallContext } from \"./types.js\";\n\n// ============================================================================\n// 拦截器实现\n// ============================================================================\n\nexport const smartpageExportInterceptor: CallInterceptor = {\n  name: \"smartpage-export\",\n\n  /** 仅对 doc 品类的 smartpage_get_export_result 方法生效 */\n  match: (ctx: CallContext) => ctx.category === \"doc\" && ctx.method === \"smartpage_get_export_result\",\n\n  /** 拦截响应：将 markdown content 保存为本地文件 */\n  async afterCall(_ctx: CallContext, result: unknown): Promise<unknown> {\n    return interceptExportResponse(result);\n  },\n};\n\n// ============================================================================\n// 内部实现\n// ============================================================================\n\n/**\n * 拦截 smartpage_get_export_result 的 MCP 响应\n *\n * 1. 从 MCP result 的 content[].text 中提取业务 JSON\n * 2. 检测 task_done=true 且存在 content 字段\n * 3. 将 content（markdown 文本）通过 saveMediaBuffer 保存到本地媒体目录\n * 4. 构造新响应：移除 content，添加 content_path\n */\nasync function interceptExportResponse(result: unknown): Promise<unknown> {\n  // 1. 提取 MCP result 中的 content 数组\n  const content = (result as Record<string, unknown>)?.content;\n  if (!Array.isArray(content)) return result;\n\n  const textItem = content.find(\n    (c: Record<string, unknown>) => c.type === \"text\" && typeof c.text === \"string\",\n  ) as { type: string; text: string } | undefined;\n  if (!textItem) return result;\n\n  // 2. 解析业务 JSON\n  let bizData: Record<string, unknown>;\n  try {\n    bizData = JSON.parse(textItem.text) as Record<string, unknown>;\n  } catch {\n    // 非 JSON 格式，原样返回\n    return result;\n  }\n\n  // 3. 校验：errcode !== 0 或 task_done 不为 true 或无 content 时原样返回\n  if (bizData.errcode !== 0) return result;\n  if (bizData.task_done !== true) return result;\n  if (typeof bizData.content !== \"string\") return result;\n\n  const markdownContent = bizData.content as string;\n\n  console.log(\n    `[mcp] smartpage_get_export_result: 拦截 content (${markdownContent.length} chars)，保存到本地文件`,\n  );\n\n  // 4. 将 markdown 内容通过 saveMediaBuffer 保存到本地媒体目录\n  //    使用 text/markdown 类型，与 msg-media 拦截器保持一致的路径管理\n  const buffer = Buffer.from(markdownContent, \"utf-8\");\n  const core = getWeComRuntime();\n  const saved = await core.channel.media.saveMediaBuffer(\n    buffer,\n    \"text/markdown\",\n    \"inbound\",\n    undefined,            // maxBytes: markdown 文本通常不大，使用默认限制\n    \"smartpage_export.md\", // originalFilename\n  );\n\n  console.log(`[mcp] smartpage_get_export_result: 已保存到 ${saved.path}`);\n\n  // 5. 构造新响应：移除 content，添加 content_path\n  const newBizData = {\n    errcode: bizData.errcode,\n    errmsg: bizData.errmsg ?? \"ok\",\n    task_done: true,\n    content_path: saved.path,\n  };\n\n  // 6. 返回修改后的 MCP result 结构\n  return {\n    content: [{\n      type: \"text\" as const,\n      text: JSON.stringify(newBizData),\n    }],\n  };\n}\n"],"names":["getWeComRuntime"],"mappings":";;;;AAAA;;;;;;;;;;;;;;AAcG;AAKH;AACA;AACA;AAEO,MAAM,0BAA0B,GAAoB;AACzD,IAAA,IAAI,EAAE,kBAAkB;;AAGxB,IAAA,KAAK,EAAE,CAAC,GAAgB,KAAK,GAAG,CAAC,QAAQ,KAAK,KAAK,IAAI,GAAG,CAAC,MAAM,KAAK,6BAA6B;;AAGnG,IAAA,MAAM,SAAS,CAAC,IAAiB,EAAE,MAAe,EAAA;AAChD,QAAA,OAAO,uBAAuB,CAAC,MAAM,CAAC;IACxC,CAAC;;AAGH;AACA;AACA;AAEA;;;;;;;AAOG;AACH,eAAe,uBAAuB,CAAC,MAAe,EAAA;;AAEpD,IAAA,MAAM,OAAO,GAAI,MAAkC,EAAE,OAAO;AAC5D,IAAA,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,OAAO,CAAC;AAAE,QAAA,OAAO,MAAM;IAE1C,MAAM,QAAQ,GAAG,OAAO,CAAC,IAAI,CAC3B,CAAC,CAA0B,KAAK,CAAC,CAAC,IAAI,KAAK,MAAM,IAAI,OAAO,CAAC,CAAC,IAAI,KAAK,QAAQ,CAClC;AAC/C,IAAA,IAAI,CAAC,QAAQ;AAAE,QAAA,OAAO,MAAM;;AAG5B,IAAA,IAAI,OAAgC;AACpC,IAAA,IAAI;QACF,OAAO,GAAG,IAAI,CAAC,KAAK,CAAC,QAAQ,CAAC,IAAI,CAA4B;IAChE;AAAE,IAAA,MAAM;;AAEN,QAAA,OAAO,MAAM;IACf;;AAGA,IAAA,IAAI,OAAO,CAAC,OAAO,KAAK,CAAC;AAAE,QAAA,OAAO,MAAM;AACxC,IAAA,IAAI,OAAO,CAAC,SAAS,KAAK,IAAI;AAAE,QAAA,OAAO,MAAM;AAC7C,IAAA,IAAI,OAAO,OAAO,CAAC,OAAO,KAAK,QAAQ;AAAE,QAAA,OAAO,MAAM;AAEtD,IAAA,MAAM,eAAe,GAAG,OAAO,CAAC,OAAiB;IAEjD,OAAO,CAAC,GAAG,CACT,CAAA,+CAAA,EAAkD,eAAe,CAAC,MAAM,CAAA,eAAA,CAAiB,CAC1F;;;IAID,MAAM,MAAM,GAAG,MAAM,CAAC,IAAI,CAAC,eAAe,EAAE,OAAO,CAAC;AACpD,IAAA,MAAM,IAAI,GAAGA,uBAAe,EAAE;AAC9B,IAAA,MAAM,KAAK,GAAG,MAAM,IAAI,CAAC,OAAO,CAAC,KAAK,CAAC,eAAe,CACpD,MAAM,EACN,eAAe,EACf,SAAS,EACT,SAAS;AACT,IAAA,qBAAqB,CACtB;IAED,OAAO,CAAC,GAAG,CAAC,CAAA,wCAAA,EAA2C,KAAK,CAAC,IAAI,CAAA,CAAE,CAAC;;AAGpE,IAAA,MAAM,UAAU,GAAG;QACjB,OAAO,EAAE,OAAO,CAAC,OAAO;AACxB,QAAA,MAAM,EAAE,OAAO,CAAC,MAAM,IAAI,IAAI;AAC9B,QAAA,SAAS,EAAE,IAAI;QACf,YAAY,EAAE,KAAK,CAAC,IAAI;KACzB;;IAGD,OAAO;AACL,QAAA,OAAO,EAAE,CAAC;AACR,gBAAA,IAAI,EAAE,MAAe;AACrB,gBAAA,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,UAAU,CAAC;aACjC,CAAC;KACH;AACH;;;;"}

package/dist/cjs/src/mcp/schema.js

@@ -0,0 +1,104 @@
+'use strict';
+
+/**
+ * MCP Schema 清洗模块
+ *
+ * 负责内联 $ref/$defs 引用并移除 Gemini 不支持的 JSON Schema 关键词，
+ * 防止 Gemini 模型解析 function response 时报 400 错误。
+ */
+/** Gemini 不支持的 JSON Schema 关键词 */
+const GEMINI_UNSUPPORTED_KEYWORDS = new Set([
+    "patternProperties", "additionalProperties", "$schema", "$id", "$ref", "$defs",
+    "definitions", "examples", "minLength", "maxLength", "minimum", "maximum",
+    "multipleOf", "pattern", "format", "minItems", "maxItems", "uniqueItems",
+    "minProperties", "maxProperties",
+]);
+/**
+ * 清洗 JSON Schema，内联 $ref 引用并移除 Gemini 不支持的关键词，
+ * 防止 Gemini 模型解析 function response 时报 400 错误。
+ */
+function cleanSchemaForGemini(schema) {
+    if (!schema || typeof schema !== "object")
+        return schema;
+    if (Array.isArray(schema))
+        return schema.map(cleanSchemaForGemini);
+    const obj = schema;
+    // 收集 $defs/definitions 用于后续 $ref 内联解析
+    const defs = {
+        ...(obj.$defs && typeof obj.$defs === "object" ? obj.$defs : {}),
+        ...(obj.definitions && typeof obj.definitions === "object" ? obj.definitions : {}),
+    };
+    return cleanWithDefs(obj, defs, new Set());
+}
+function cleanWithDefs(schema, defs, refStack) {
+    if (!schema || typeof schema !== "object")
+        return schema;
+    if (Array.isArray(schema))
+        return schema.map((item) => cleanWithDefs(item, defs, refStack));
+    const obj = schema;
+    // 合并当前层级的 $defs/definitions 到 defs 中
+    if (obj.$defs && typeof obj.$defs === "object") {
+        Object.assign(defs, obj.$defs);
+    }
+    if (obj.definitions && typeof obj.definitions === "object") {
+        Object.assign(defs, obj.definitions);
+    }
+    // 处理 $ref 引用：尝试内联解析
+    if (typeof obj.$ref === "string") {
+        const ref = obj.$ref;
+        if (refStack.has(ref))
+            return {}; // 防止循环引用
+        const match = ref.match(/^#\/(?:\$defs|definitions)\/(.+)$/);
+        if (match && match[1] && defs[match[1]]) {
+            const nextStack = new Set(refStack);
+            nextStack.add(ref);
+            return cleanWithDefs(defs[match[1]], defs, nextStack);
+        }
+        return {}; // 无法解析的 $ref，返回空对象
+    }
+    const cleaned = {};
+    for (const [key, value] of Object.entries(obj)) {
+        if (GEMINI_UNSUPPORTED_KEYWORDS.has(key))
+            continue;
+        if (key === "const") {
+            cleaned.enum = [value];
+            continue;
+        }
+        if (key === "properties" && value && typeof value === "object" && !Array.isArray(value)) {
+            cleaned[key] = Object.fromEntries(Object.entries(value).map(([k, v]) => [
+                k, cleanWithDefs(v, defs, refStack),
+            ]));
+        }
+        else if (key === "items" && value) {
+            cleaned[key] = Array.isArray(value)
+                ? value.map((item) => cleanWithDefs(item, defs, refStack))
+                : cleanWithDefs(value, defs, refStack);
+        }
+        else if ((key === "anyOf" || key === "oneOf" || key === "allOf") && Array.isArray(value)) {
+            // 过滤掉 null 类型的变体
+            const nonNull = value.filter((v) => {
+                if (!v || typeof v !== "object")
+                    return true;
+                const r = v;
+                return r.type !== "null";
+            });
+            if (nonNull.length === 1) {
+                // 只剩一个变体时直接内联
+                const single = cleanWithDefs(nonNull[0], defs, refStack);
+                if (single && typeof single === "object" && !Array.isArray(single)) {
+                    Object.assign(cleaned, single);
+                }
+            }
+            else {
+                cleaned[key] = nonNull.map((v) => cleanWithDefs(v, defs, refStack));
+            }
+        }
+        else {
+            cleaned[key] = value;
+        }
+    }
+    return cleaned;
+}
+
+exports.cleanSchemaForGemini = cleanSchemaForGemini;
+//# sourceMappingURL=schema.js.map

package/dist/cjs/src/mcp/schema.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"schema.js","sources":["../../../../../../src/mcp/schema.ts"],"sourcesContent":["/**\n * MCP Schema 清洗模块\n *\n * 负责内联 $ref/$defs 引用并移除 Gemini 不支持的 JSON Schema 关键词，\n * 防止 Gemini 模型解析 function response 时报 400 错误。\n */\n\n/** Gemini 不支持的 JSON Schema 关键词 */\nconst GEMINI_UNSUPPORTED_KEYWORDS = new Set([\n  \"patternProperties\", \"additionalProperties\", \"$schema\", \"$id\", \"$ref\", \"$defs\",\n  \"definitions\", \"examples\", \"minLength\", \"maxLength\", \"minimum\", \"maximum\",\n  \"multipleOf\", \"pattern\", \"format\", \"minItems\", \"maxItems\", \"uniqueItems\",\n  \"minProperties\", \"maxProperties\",\n]);\n\n/**\n * 清洗 JSON Schema，内联 $ref 引用并移除 Gemini 不支持的关键词，\n * 防止 Gemini 模型解析 function response 时报 400 错误。\n */\nexport function cleanSchemaForGemini(schema: unknown): unknown {\n  if (!schema || typeof schema !== \"object\") return schema;\n  if (Array.isArray(schema)) return schema.map(cleanSchemaForGemini);\n\n  const obj = schema as Record<string, unknown>;\n\n  // 收集 $defs/definitions 用于后续 $ref 内联解析\n  const defs: Record<string, unknown> = {\n    ...(obj.$defs && typeof obj.$defs === \"object\" ? obj.$defs as Record<string, unknown> : {}),\n    ...(obj.definitions && typeof obj.definitions === \"object\" ? obj.definitions as Record<string, unknown> : {}),\n  };\n\n  return cleanWithDefs(obj, defs, new Set());\n}\n\nfunction cleanWithDefs(\n  schema: unknown,\n  defs: Record<string, unknown>,\n  refStack: Set<string>,\n): unknown {\n  if (!schema || typeof schema !== \"object\") return schema;\n  if (Array.isArray(schema)) return schema.map((item) => cleanWithDefs(item, defs, refStack));\n\n  const obj = schema as Record<string, unknown>;\n\n  // 合并当前层级的 $defs/definitions 到 defs 中\n  if (obj.$defs && typeof obj.$defs === \"object\") {\n    Object.assign(defs, obj.$defs as Record<string, unknown>);\n  }\n  if (obj.definitions && typeof obj.definitions === \"object\") {\n    Object.assign(defs, obj.definitions as Record<string, unknown>);\n  }\n\n  // 处理 $ref 引用：尝试内联解析\n  if (typeof obj.$ref === \"string\") {\n    const ref = obj.$ref;\n    if (refStack.has(ref)) return {}; // 防止循环引用\n\n    const match = ref.match(/^#\\/(?:\\$defs|definitions)\\/(.+)$/);\n    if (match && match[1] && defs[match[1]]) {\n      const nextStack = new Set(refStack);\n      nextStack.add(ref);\n      return cleanWithDefs(defs[match[1]], defs, nextStack);\n    }\n    return {}; // 无法解析的 $ref，返回空对象\n  }\n\n  const cleaned: Record<string, unknown> = {};\n  for (const [key, value] of Object.entries(obj)) {\n    if (GEMINI_UNSUPPORTED_KEYWORDS.has(key)) continue;\n\n    if (key === \"const\") {\n      cleaned.enum = [value];\n      continue;\n    }\n\n    if (key === \"properties\" && value && typeof value === \"object\" && !Array.isArray(value)) {\n      cleaned[key] = Object.fromEntries(\n        Object.entries(value as Record<string, unknown>).map(([k, v]) => [\n          k, cleanWithDefs(v, defs, refStack),\n        ]),\n      );\n    } else if (key === \"items\" && value) {\n      cleaned[key] = Array.isArray(value)\n        ? value.map((item) => cleanWithDefs(item, defs, refStack))\n        : cleanWithDefs(value, defs, refStack);\n    } else if ((key === \"anyOf\" || key === \"oneOf\" || key === \"allOf\") && Array.isArray(value)) {\n      // 过滤掉 null 类型的变体\n      const nonNull = value.filter((v) => {\n        if (!v || typeof v !== \"object\") return true;\n        const r = v as Record<string, unknown>;\n        return r.type !== \"null\";\n      });\n      if (nonNull.length === 1) {\n        // 只剩一个变体时直接内联\n        const single = cleanWithDefs(nonNull[0], defs, refStack);\n        if (single && typeof single === \"object\" && !Array.isArray(single)) {\n          Object.assign(cleaned, single as Record<string, unknown>);\n        }\n      } else {\n        cleaned[key] = nonNull.map((v) => cleanWithDefs(v, defs, refStack));\n      }\n    } else {\n      cleaned[key] = value;\n    }\n  }\n\n  return cleaned;\n}\n"],"names":[],"mappings":"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"}