@xopcai/xopc 0.0.14 → 0.0.16

package/dist/extensions/feishu/src/streaming/streaming-adapter.js

@@ -0,0 +1,242 @@
+import { createLogger } from "../../../../src/utils/logger/index.js";
+import { init_logger } from "../../../../src/utils/logger.js";
+import { resolveFeishuAccount } from "../state/accounts.js";
+import { createFeishuClient } from "../transport/client/client.js";
+import { getFeishuBindingByMessageId, recordFeishuMessageBinding } from "../state/message-bindings.js";
+import { formatFeishuOutboundText } from "../format.js";
+//#region extensions/feishu/src/streaming/streaming-adapter.ts
+init_logger();
+const log = createLogger("FeishuStreaming");
+function createFeishuStreamingAdapter(getConfig) {
+	return { startStream(options) {
+		const account = resolveFeishuAccount(getConfig(), options.accountId ?? "default");
+		if (!account.configured) return null;
+		if (account.streaming !== true) return null;
+		const { api } = createFeishuClient(account);
+		let messageId;
+		let lastText = "";
+		let timer = null;
+		let aborted = false;
+		let editedAtLeastOnce = false;
+		let ready = null;
+		let cardId;
+		let cardSeq = 0;
+		const cardElementId = "md_1";
+		let fallbackSent = false;
+		const renderMode = account.renderMode ?? "auto";
+		const preferCard = renderMode === "card" || renderMode === "auto";
+		const formatStreamText = (text) => {
+			if (!text.trim()) return text;
+			if (text.trim() === "Thinking…") return text;
+			return formatFeishuOutboundText({
+				text,
+				renderMode,
+				forCardMarkdown: Boolean(preferCard && cardId)
+			});
+		};
+		const recordBindingIfReply = (childMessageId) => {
+			if (!childMessageId) return;
+			const parentId = options.replyToMessageId;
+			if (!parentId) return;
+			const parent = getFeishuBindingByMessageId(parentId);
+			if (!parent) return;
+			recordFeishuMessageBinding({
+				...parent,
+				messageId: childMessageId
+			});
+		};
+		const edit = async (text) => {
+			if (ready) await ready;
+			if (!messageId) return;
+			const outbound = formatStreamText(text);
+			if (cardId && preferCard) {
+				cardSeq += 1;
+				await api.cardkit.v1.cardElement.content({
+					path: {
+						card_id: cardId,
+						element_id: cardElementId
+					},
+					data: {
+						content: outbound,
+						sequence: cardSeq,
+						uuid: `${cardId}:${cardSeq}`
+					}
+				});
+			} else await api.im.v1.message.update({
+				path: { message_id: messageId },
+				data: {
+					msg_type: "text",
+					content: JSON.stringify({ text: outbound })
+				}
+			});
+			editedAtLeastOnce = true;
+		};
+		const sendFallbackText = async (text) => {
+			if (fallbackSent) return;
+			fallbackSent = true;
+			const receive_id_type = options.chatId.startsWith("ou_") || options.chatId.startsWith("on_") ? "open_id" : "chat_id";
+			try {
+				const outbound = formatStreamText(text);
+				const res = options.replyToMessageId ? await api.im.message.reply({
+					path: { message_id: options.replyToMessageId },
+					data: {
+						msg_type: "text",
+						content: JSON.stringify({ text: outbound }),
+						...options.threadId ? { reply_in_thread: true } : {}
+					}
+				}) : await api.im.message.create({
+					params: { receive_id_type },
+					data: {
+						receive_id: options.chatId,
+						msg_type: "text",
+						content: JSON.stringify({ text: outbound })
+					}
+				});
+				const mid = res?.data?.message_id ?? res?.message_id ?? void 0;
+				if (mid) recordBindingIfReply(mid);
+				editedAtLeastOnce = true;
+				messageId = mid ?? messageId;
+				cardId = void 0;
+			} catch (err) {
+				log.warn({
+					err,
+					accountId: account.accountId
+				}, "Feishu streaming fallback send failed");
+			}
+		};
+		const flush = async () => {
+			if (aborted) return;
+			if (ready) await ready;
+			if (!messageId) return;
+			const text = lastText;
+			if (!text.trim()) return;
+			try {
+				await edit(text);
+			} catch (err) {
+				log.warn({
+					err,
+					accountId: account.accountId,
+					messageId,
+					mode: preferCard ? "card" : "text"
+				}, "Feishu streaming edit failed");
+				if (preferCard) await sendFallbackText(text);
+			}
+		};
+		const start = async () => {
+			const receive_id_type = options.chatId.startsWith("ou_") || options.chatId.startsWith("on_") ? "open_id" : "chat_id";
+			const thinking = "Thinking…";
+			if (preferCard) {
+				const cardSpec = {
+					schema: "2.0",
+					config: { update_multi: true },
+					header: { title: {
+						tag: "plain_text",
+						content: "xopc"
+					} },
+					body: { elements: [{
+						tag: "markdown",
+						element_id: cardElementId,
+						content: thinking
+					}] }
+				};
+				const c = await api.cardkit.v1.card.create({ data: {
+					type: "card_json",
+					data: JSON.stringify(cardSpec)
+				} });
+				cardId = c?.data?.card_id ?? c?.card_id ?? void 0;
+				const res = options.replyToMessageId ? await api.im.message.reply({
+					path: { message_id: options.replyToMessageId },
+					data: {
+						msg_type: "interactive",
+						content: JSON.stringify({
+							type: "card",
+							data: { card_id: cardId }
+						}),
+						...options.threadId ? { reply_in_thread: true } : {}
+					}
+				}) : await api.im.message.create({
+					params: { receive_id_type },
+					data: {
+						receive_id: options.chatId,
+						msg_type: "interactive",
+						content: JSON.stringify({
+							type: "card",
+							data: { card_id: cardId }
+						})
+					}
+				});
+				messageId = res?.data?.message_id ?? res?.message_id ?? void 0;
+				if (messageId) recordBindingIfReply(messageId);
+				log.info({
+					accountId: account.accountId,
+					chatId: options.chatId,
+					messageId,
+					mode: "card"
+				}, "Feishu streaming started");
+				return;
+			}
+			const res = options.replyToMessageId ? await api.im.message.reply({
+				path: { message_id: options.replyToMessageId },
+				data: {
+					msg_type: "text",
+					content: JSON.stringify({ text: thinking }),
+					...options.threadId ? { reply_in_thread: true } : {}
+				}
+			}) : await api.im.message.create({
+				params: { receive_id_type },
+				data: {
+					receive_id: options.chatId,
+					msg_type: "text",
+					content: JSON.stringify({ text: thinking })
+				}
+			});
+			messageId = res?.data?.message_id ?? res?.message_id ?? void 0;
+			if (messageId) recordBindingIfReply(messageId);
+			log.info({
+				accountId: account.accountId,
+				chatId: options.chatId,
+				messageId,
+				mode: "text"
+			}, "Feishu streaming started");
+		};
+		ready = start().catch((err) => {
+			log.warn({
+				err,
+				accountId: account.accountId
+			}, "Feishu streaming start failed");
+		});
+		return {
+			update: (text) => {
+				lastText = text;
+				if (timer) clearTimeout(timer);
+				timer = setTimeout(() => {
+					flush().catch((err) => log.warn({ err }, "Feishu streaming flush failed"));
+				}, 800);
+			},
+			end: async () => {
+				if (timer) clearTimeout(timer);
+				await flush();
+				log.debug({
+					accountId: account.accountId,
+					chatId: options.chatId,
+					messageId,
+					editedAtLeastOnce,
+					lastTextLen: lastText.length,
+					mode: preferCard ? "card" : "text"
+				}, "Feishu streaming ended");
+			},
+			abort: async () => {
+				aborted = true;
+				if (timer) clearTimeout(timer);
+			},
+			messageId: () => void 0,
+			skipFinalOutbound: () => Boolean(messageId) && editedAtLeastOnce,
+			updateProgress: void 0,
+			setProgress: void 0
+		};
+	} };
+}
+//#endregion
+export { createFeishuStreamingAdapter };
+
+//# sourceMappingURL=streaming-adapter.js.map

package/dist/extensions/feishu/src/streaming/streaming-adapter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"streaming-adapter.js","names":[],"sources":["../../../../../extensions/feishu/src/streaming/streaming-adapter.ts"],"sourcesContent":["import type {\n  ChannelStreamHandle,\n  ChannelStreamingAdapter,\n} from '@xopcai/xopc/channels/plugin-types.js';\nimport type { Config } from '@xopcai/xopc/config/schema.js';\nimport { createLogger } from '@xopcai/xopc/utils/logger.js';\n\nimport { resolveFeishuAccount } from '../state/accounts.js';\nimport { formatFeishuOutboundText } from '../format.js';\nimport { getFeishuBindingByMessageId, recordFeishuMessageBinding } from '../state/message-bindings.js';\nimport { createFeishuClient } from '../transport/client/client.js';\n\nconst log = createLogger('FeishuStreaming');\n\nexport function createFeishuStreamingAdapter(getConfig: () => Config): ChannelStreamingAdapter {\n  return {\n    startStream(options: {\n      chatId: string;\n      accountId?: string;\n      threadId?: string;\n      replyToMessageId?: string;\n      parseMode?: 'Markdown' | 'HTML';\n    }): ChannelStreamHandle | null {\n      const cfg = getConfig();\n      const account = resolveFeishuAccount(cfg, options.accountId ?? 'default');\n      if (!account.configured) {\n        return null;\n      }\n      // Feishu streaming is opt-in. When omitted/false, fall back to normal final outbound.\n      if (account.streaming !== true) {\n        return null;\n      }\n      const { api } = createFeishuClient(account);\n\n      let messageId: string | undefined;\n      let lastText = '';\n      let timer: NodeJS.Timeout | null = null;\n      let aborted = false;\n      let editedAtLeastOnce = false;\n      let ready: Promise<void> | null = null;\n      let cardId: string | undefined;\n      let cardSeq = 0;\n      const cardElementId = 'md_1';\n      let fallbackSent = false;\n\n      const renderMode = account.renderMode ?? 'auto';\n      const preferCard = renderMode === 'card' || renderMode === 'auto';\n\n      const formatStreamText = (text: string) => {\n        if (!text.trim()) return text;\n        if (text.trim() === 'Thinking…') return text;\n        const forCardMarkdown = Boolean(preferCard && cardId);\n        return formatFeishuOutboundText({\n          text,\n          renderMode,\n          forCardMarkdown,\n        });\n      };\n\n      const recordBindingIfReply = (childMessageId: string) => {\n        if (!childMessageId) return;\n        const parentId = options.replyToMessageId;\n        if (!parentId) return;\n        const parent = getFeishuBindingByMessageId(parentId);\n        if (!parent) return;\n        recordFeishuMessageBinding({ ...parent, messageId: childMessageId });\n      };\n\n      const edit = async (text: string) => {\n        if (ready) await ready;\n        if (!messageId) return;\n        const outbound = formatStreamText(text);\n        if (cardId && preferCard) {\n          cardSeq += 1;\n          await (api as any).cardkit.v1.cardElement.content({\n            path: { card_id: cardId, element_id: cardElementId },\n            data: {\n              content: outbound,\n              sequence: cardSeq,\n              uuid: `${cardId}:${cardSeq}`,\n            },\n          });\n        } else {\n          await (api as any).im.v1.message.update({\n            path: { message_id: messageId },\n            data: { msg_type: 'text', content: JSON.stringify({ text: outbound }) },\n          });\n        }\n        editedAtLeastOnce = true;\n      };\n\n      const sendFallbackText = async (text: string) => {\n        if (fallbackSent) return;\n        fallbackSent = true;\n        const receive_id_type =\n          options.chatId.startsWith('ou_') || options.chatId.startsWith('on_') ? 'open_id' : 'chat_id';\n        try {\n          const outbound = formatStreamText(text);\n          const res = options.replyToMessageId\n            ? await (api as any).im.message.reply({\n                path: { message_id: options.replyToMessageId },\n                data: {\n                  msg_type: 'text',\n                  content: JSON.stringify({ text: outbound }),\n                  ...(options.threadId ? { reply_in_thread: true } : {}),\n                },\n              })\n            : await (api as any).im.message.create({\n                params: { receive_id_type },\n                data: {\n                  receive_id: options.chatId,\n                  msg_type: 'text',\n                  content: JSON.stringify({ text: outbound }),\n                },\n              });\n          const mid = res?.data?.message_id ?? res?.message_id ?? undefined;\n          if (mid) recordBindingIfReply(mid);\n          // Mark as delivered through the channel so the final outbound is skipped.\n          editedAtLeastOnce = true;\n          messageId = mid ?? messageId;\n          // If we were in card mode, stop trying to update the card.\n          cardId = undefined;\n        } catch (err) {\n          log.warn({ err, accountId: account.accountId }, 'Feishu streaming fallback send failed');\n        }\n      };\n\n      const flush = async () => {\n        if (aborted) return;\n        if (ready) await ready;\n        if (!messageId) return;\n        const text = lastText;\n        if (!text.trim()) return;\n        try {\n          await edit(text);\n        } catch (err) {\n          // Don't crash the agent loop. In card mode, card streaming can fail due to missing CardKit scopes;\n          // fall back to sending a plain text reply so the user never gets stuck on \"Thinking…\".\n          log.warn({ err, accountId: account.accountId, messageId, mode: preferCard ? 'card' : 'text' }, 'Feishu streaming edit failed');\n          if (preferCard) {\n            await sendFallbackText(text);\n          }\n        }\n      };\n\n      const start = async () => {\n        const receive_id_type =\n          options.chatId.startsWith('ou_') || options.chatId.startsWith('on_') ? 'open_id' : 'chat_id';\n        const thinking = 'Thinking…';\n\n        if (preferCard) {\n          const cardSpec = {\n            schema: '2.0',\n            config: { update_multi: true },\n            header: {\n              title: { tag: 'plain_text', content: 'xopc' },\n            },\n            body: {\n              elements: [\n                {\n                  tag: 'markdown',\n                  element_id: cardElementId,\n                  content: thinking,\n                },\n              ],\n            },\n          };\n\n          const c = await (api as any).cardkit.v1.card.create({\n            data: { type: 'card_json', data: JSON.stringify(cardSpec) },\n          });\n          cardId = c?.data?.card_id ?? c?.card_id ?? undefined;\n\n          const res = options.replyToMessageId\n            ? await (api as any).im.message.reply({\n                path: { message_id: options.replyToMessageId },\n                data: {\n                  msg_type: 'interactive',\n                  content: JSON.stringify({ type: 'card', data: { card_id: cardId } }),\n                  ...(options.threadId ? { reply_in_thread: true } : {}),\n                },\n              })\n            : await (api as any).im.message.create({\n                params: { receive_id_type },\n                data: {\n                  receive_id: options.chatId,\n                  msg_type: 'interactive',\n                  content: JSON.stringify({ type: 'card', data: { card_id: cardId } }),\n                },\n              });\n          messageId = res?.data?.message_id ?? res?.message_id ?? undefined;\n          if (messageId) recordBindingIfReply(messageId);\n          log.info(\n            { accountId: account.accountId, chatId: options.chatId, messageId, mode: 'card' },\n            'Feishu streaming started',\n          );\n          return;\n        }\n\n        const res = options.replyToMessageId\n          ? await (api as any).im.message.reply({\n              path: { message_id: options.replyToMessageId },\n              data: {\n                msg_type: 'text',\n                content: JSON.stringify({ text: thinking }),\n                ...(options.threadId ? { reply_in_thread: true } : {}),\n              },\n            })\n          : await (api as any).im.message.create({\n              params: { receive_id_type },\n              data: {\n                receive_id: options.chatId,\n                msg_type: 'text',\n                content: JSON.stringify({ text: thinking }),\n              },\n            });\n        messageId = res?.data?.message_id ?? res?.message_id ?? undefined;\n        if (messageId) recordBindingIfReply(messageId);\n        log.info(\n          { accountId: account.accountId, chatId: options.chatId, messageId, mode: 'text' },\n          'Feishu streaming started',\n        );\n      };\n\n      ready = start().catch((err) => {\n        log.warn({ err, accountId: account.accountId }, 'Feishu streaming start failed');\n      });\n\n      return {\n        update: (text: string) => {\n          lastText = text;\n          if (timer) clearTimeout(timer);\n          timer = setTimeout(() => {\n            void flush().catch((err) => log.warn({ err }, 'Feishu streaming flush failed'));\n          }, 800);\n        },\n        end: async () => {\n          if (timer) clearTimeout(timer);\n          await flush();\n          log.debug(\n            {\n              accountId: account.accountId,\n              chatId: options.chatId,\n              messageId,\n              editedAtLeastOnce,\n              lastTextLen: lastText.length,\n              mode: preferCard ? 'card' : 'text',\n            },\n            'Feishu streaming ended',\n          );\n        },\n        abort: async () => {\n          aborted = true;\n          if (timer) clearTimeout(timer);\n        },\n        messageId: () => undefined,\n        skipFinalOutbound: () => Boolean(messageId) && editedAtLeastOnce,\n        updateProgress: undefined,\n        setProgress: undefined,\n      };\n    },\n  };\n}\n\n"],"mappings":"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"}

package/dist/extensions/feishu/src/subagent-hooks.js

@@ -0,0 +1,52 @@
+import { bindFeishuConversation, unbindBySessionKey } from "./state/thread-bindings.js";
+//#region extensions/feishu/src/subagent-hooks.ts
+function normLower(v) {
+	return typeof v === "string" ? v.trim().toLowerCase() : "";
+}
+function stripProviderPrefix(raw) {
+	return raw.replace(/^(feishu|lark):/i, "").trim();
+}
+async function handleFeishuSubagentSpawning(event, ctx = {}) {
+	if (!event?.threadRequested) return void 0;
+	if (normLower(event?.requester?.channel) !== "feishu") return void 0;
+	const accountId = String(event?.requester?.accountId ?? "").trim() || "default";
+	const to = String(event?.requester?.to ?? "").trim();
+	const threadId = event?.requester?.threadId != null && event.requester.threadId !== "" ? String(event.requester.threadId).trim() : "";
+	const withoutProvider = to ? stripProviderPrefix(to) : "";
+	const isChatTarget = /^(chat|group|channel):/i.test(withoutProvider);
+	if (!to) return {
+		status: "error",
+		error: "Missing requester delivery target (to)"
+	};
+	if (isChatTarget && !threadId) return {
+		status: "error",
+		error: "Thread binding requires a topic threadId for chat targets"
+	};
+	bindFeishuConversation({
+		accountId,
+		conversationId: isChatTarget ? `${withoutProvider}|topic:${threadId}` : withoutProvider,
+		parentConversationId: isChatTarget ? withoutProvider : void 0,
+		targetSessionKey: String(event.childSessionKey),
+		metadata: {
+			requesterSessionKey: ctx.requesterSessionKey,
+			deliveryTo: to,
+			deliveryThreadId: threadId || void 0,
+			agentId: event?.agentId,
+			label: event?.label
+		}
+	});
+	return {
+		status: "ok",
+		threadBindingReady: true
+	};
+}
+function handleFeishuSubagentEnded(event) {
+	const accountId = String(event?.accountId ?? "").trim() || "default";
+	const sk = String(event?.targetSessionKey ?? "").trim();
+	if (!sk) return;
+	unbindBySessionKey(accountId, sk);
+}
+//#endregion
+export { handleFeishuSubagentEnded, handleFeishuSubagentSpawning };
+
+//# sourceMappingURL=subagent-hooks.js.map

package/dist/extensions/feishu/src/subagent-hooks.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"subagent-hooks.js","names":[],"sources":["../../../../extensions/feishu/src/subagent-hooks.ts"],"sourcesContent":["import { bindFeishuConversation, unbindBySessionKey } from './state/thread-bindings.js';\n\nfunction normLower(v: unknown): string {\n  return typeof v === 'string' ? v.trim().toLowerCase() : '';\n}\n\nfunction stripProviderPrefix(raw: string): string {\n  return raw.replace(/^(feishu|lark):/i, '').trim();\n}\n\nexport async function handleFeishuSubagentSpawning(event: any, ctx: { requesterSessionKey?: string } = {}) {\n  if (!event?.threadRequested) return undefined;\n  const requesterChannel = normLower(event?.requester?.channel);\n  if (requesterChannel !== 'feishu') return undefined;\n\n  const accountId = String(event?.requester?.accountId ?? '').trim() || 'default';\n  const to = String(event?.requester?.to ?? '').trim();\n  const threadId =\n    event?.requester?.threadId != null && event.requester.threadId !== ''\n      ? String(event.requester.threadId).trim()\n      : '';\n\n  const withoutProvider = to ? stripProviderPrefix(to) : '';\n  const isChatTarget = /^(chat|group|channel):/i.test(withoutProvider);\n\n  // Minimal parity: only bind DM targets or topic thread targets.\n  if (!to) return { status: 'error' as const, error: 'Missing requester delivery target (to)' };\n  if (isChatTarget && !threadId) {\n    return { status: 'error' as const, error: 'Thread binding requires a topic threadId for chat targets' };\n  }\n\n  const conversationId = isChatTarget ? `${withoutProvider}|topic:${threadId}` : withoutProvider;\n  bindFeishuConversation({\n    accountId,\n    conversationId,\n    parentConversationId: isChatTarget ? withoutProvider : undefined,\n    targetSessionKey: String(event.childSessionKey),\n    metadata: {\n      requesterSessionKey: ctx.requesterSessionKey,\n      deliveryTo: to,\n      deliveryThreadId: threadId || undefined,\n      agentId: event?.agentId,\n      label: event?.label,\n    },\n  });\n\n  return { status: 'ok' as const, threadBindingReady: true };\n}\n\nexport function handleFeishuSubagentEnded(event: any) {\n  const accountId = String(event?.accountId ?? '').trim() || 'default';\n  const sk = String(event?.targetSessionKey ?? '').trim();\n  if (!sk) return;\n  unbindBySessionKey(accountId, sk);\n}\n\n"],"mappings":";;AAEA,SAAS,UAAU,GAAoB;AACrC,QAAO,OAAO,MAAM,WAAW,EAAE,MAAM,CAAC,aAAa,GAAG;;AAG1D,SAAS,oBAAoB,KAAqB;AAChD,QAAO,IAAI,QAAQ,oBAAoB,GAAG,CAAC,MAAM;;AAGnD,eAAsB,6BAA6B,OAAY,MAAwC,EAAE,EAAE;AACzG,KAAI,CAAC,OAAO,gBAAiB,QAAO,KAAA;AAEpC,KADyB,UAAU,OAAO,WAAW,QACjC,KAAK,SAAU,QAAO,KAAA;CAE1C,MAAM,YAAY,OAAO,OAAO,WAAW,aAAa,GAAG,CAAC,MAAM,IAAI;CACtE,MAAM,KAAK,OAAO,OAAO,WAAW,MAAM,GAAG,CAAC,MAAM;CACpD,MAAM,WACJ,OAAO,WAAW,YAAY,QAAQ,MAAM,UAAU,aAAa,KAC/D,OAAO,MAAM,UAAU,SAAS,CAAC,MAAM,GACvC;CAEN,MAAM,kBAAkB,KAAK,oBAAoB,GAAG,GAAG;CACvD,MAAM,eAAe,0BAA0B,KAAK,gBAAgB;AAGpE,KAAI,CAAC,GAAI,QAAO;EAAE,QAAQ;EAAkB,OAAO;EAA0C;AAC7F,KAAI,gBAAgB,CAAC,SACnB,QAAO;EAAE,QAAQ;EAAkB,OAAO;EAA6D;AAIzG,wBAAuB;EACrB;EACA,gBAHqB,eAAe,GAAG,gBAAgB,SAAS,aAAa;EAI7E,sBAAsB,eAAe,kBAAkB,KAAA;EACvD,kBAAkB,OAAO,MAAM,gBAAgB;EAC/C,UAAU;GACR,qBAAqB,IAAI;GACzB,YAAY;GACZ,kBAAkB,YAAY,KAAA;GAC9B,SAAS,OAAO;GAChB,OAAO,OAAO;GACf;EACF,CAAC;AAEF,QAAO;EAAE,QAAQ;EAAe,oBAAoB;EAAM;;AAG5D,SAAgB,0BAA0B,OAAY;CACpD,MAAM,YAAY,OAAO,OAAO,aAAa,GAAG,CAAC,MAAM,IAAI;CAC3D,MAAM,KAAK,OAAO,OAAO,oBAAoB,GAAG,CAAC,MAAM;AACvD,KAAI,CAAC,GAAI;AACT,oBAAmB,WAAW,GAAG"}

package/dist/extensions/feishu/src/tools/docx/docx-batch-insert.js

@@ -0,0 +1,95 @@
+import { cleanBlocksForDescendant } from "./docx-table-ops.js";
+//#region extensions/feishu/src/tools/docx/docx-batch-insert.ts
+const BATCH_SIZE = 1e3;
+function readStringValue(value) {
+	return typeof value === "string" && value.trim() ? value : void 0;
+}
+function normalizeChildIds(children) {
+	if (Array.isArray(children)) return children;
+	const child = readStringValue(children);
+	return child ? [child] : void 0;
+}
+function toDescendantBlock(block) {
+	const children = normalizeChildIds(block.children);
+	return {
+		...block,
+		...children ? { children } : {}
+	};
+}
+function collectDescendants(blockMap, rootId) {
+	const result = [];
+	const visited = /* @__PURE__ */ new Set();
+	function collect(blockId) {
+		if (visited.has(blockId)) return;
+		visited.add(blockId);
+		const block = blockMap.get(blockId);
+		if (!block) return;
+		result.push(block);
+		const children = block.children;
+		if (Array.isArray(children)) for (const childId of children) collect(childId);
+		else if (typeof children === "string") collect(children);
+	}
+	collect(rootId);
+	return result;
+}
+async function insertBatch(client, docToken, blocks, firstLevelBlockIds, parentBlockId = docToken, index = -1) {
+	const descendants = cleanBlocksForDescendant(blocks);
+	if (descendants.length === 0) return [];
+	const res = await client.docx.documentBlockDescendant.create({
+		path: {
+			document_id: docToken,
+			block_id: parentBlockId
+		},
+		data: {
+			children_id: firstLevelBlockIds,
+			descendants: descendants.map(toDescendantBlock),
+			index
+		}
+	});
+	if (res.code !== 0) throw new Error(`${res.msg} (code: ${res.code})`);
+	return res.data?.children ?? [];
+}
+async function insertBlocksInBatches(client, docToken, blocks, firstLevelBlockIds, logger, parentBlockId = docToken, startIndex = -1) {
+	const allChildren = [];
+	const batches = [];
+	let currentBatch = {
+		firstLevelIds: [],
+		blocks: []
+	};
+	const usedBlockIds = /* @__PURE__ */ new Set();
+	const blockMap = /* @__PURE__ */ new Map();
+	for (const block of blocks) if (block.block_id) blockMap.set(block.block_id, block);
+	for (const firstLevelId of firstLevelBlockIds) {
+		const newBlocks = collectDescendants(blockMap, firstLevelId).filter((b) => b.block_id && !usedBlockIds.has(b.block_id));
+		if (newBlocks.length > 1e3) throw new Error(`Block "${firstLevelId}" has ${newBlocks.length} descendants, exceeds Feishu API limit ${BATCH_SIZE}. Split content.`);
+		if (currentBatch.blocks.length + newBlocks.length > 1e3 && currentBatch.blocks.length > 0) {
+			batches.push(currentBatch);
+			currentBatch = {
+				firstLevelIds: [],
+				blocks: []
+			};
+		}
+		currentBatch.firstLevelIds.push(firstLevelId);
+		for (const block of newBlocks) {
+			currentBatch.blocks.push(block);
+			if (block.block_id) usedBlockIds.add(block.block_id);
+		}
+	}
+	if (currentBatch.blocks.length > 0) batches.push(currentBatch);
+	let currentIndex = startIndex;
+	for (let i = 0; i < batches.length; i++) {
+		const batch = batches[i];
+		logger?.info?.(`feishu_doc: Inserting batch ${i + 1}/${batches.length} (${batch.blocks.length} blocks)...`);
+		const children = await insertBatch(client, docToken, batch.blocks, batch.firstLevelIds, parentBlockId, currentIndex);
+		allChildren.push(...children);
+		if (currentIndex !== -1) currentIndex += batch.firstLevelIds.length;
+	}
+	return {
+		children: allChildren,
+		skipped: []
+	};
+}
+//#endregion
+export { BATCH_SIZE, insertBlocksInBatches };
+
+//# sourceMappingURL=docx-batch-insert.js.map

package/dist/extensions/feishu/src/tools/docx/docx-batch-insert.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"docx-batch-insert.js","names":[],"sources":["../../../../../../extensions/feishu/src/tools/docx/docx-batch-insert.ts"],"sourcesContent":["import type * as Lark from '@larksuiteoapi/node-sdk';\n\nimport { cleanBlocksForDescendant } from './docx-table-ops.js';\nimport type { FeishuDocxBlock, FeishuDocxBlockChild } from './docx-types.js';\n\nexport const BATCH_SIZE = 1000;\n\nfunction readStringValue(value: unknown): string | undefined {\n  return typeof value === 'string' && value.trim() ? value : undefined;\n}\n\ntype DocxDescendantCreatePayload = NonNullable<\n  Parameters<Lark.Client['docx']['documentBlockDescendant']['create']>[0]\n>;\ntype DocxDescendantCreateBlock = NonNullable<\n  NonNullable<DocxDescendantCreatePayload['data']>['descendants']\n>[number];\n\nfunction normalizeChildIds(children: string[] | string | undefined): string[] | undefined {\n  if (Array.isArray(children)) return children;\n  const child = readStringValue(children);\n  return child ? [child] : undefined;\n}\n\nfunction toDescendantBlock(block: FeishuDocxBlock): DocxDescendantCreateBlock {\n  const children = normalizeChildIds(block.children);\n  return {\n    ...block,\n    ...(children ? { children } : {}),\n  } as DocxDescendantCreateBlock;\n}\n\nfunction collectDescendants(blockMap: Map<string, FeishuDocxBlock>, rootId: string): FeishuDocxBlock[] {\n  const result: FeishuDocxBlock[] = [];\n  const visited = new Set<string>();\n\n  function collect(blockId: string) {\n    if (visited.has(blockId)) return;\n    visited.add(blockId);\n    const block = blockMap.get(blockId);\n    if (!block) return;\n    result.push(block);\n    const children = block.children;\n    if (Array.isArray(children)) {\n      for (const childId of children) collect(childId);\n    } else if (typeof children === 'string') {\n      collect(children);\n    }\n  }\n\n  collect(rootId);\n  return result;\n}\n\nasync function insertBatch(\n  client: Lark.Client,\n  docToken: string,\n  blocks: FeishuDocxBlock[],\n  firstLevelBlockIds: string[],\n  parentBlockId: string = docToken,\n  index: number = -1,\n): Promise<FeishuDocxBlockChild[]> {\n  const descendants = cleanBlocksForDescendant(blocks);\n  if (descendants.length === 0) return [];\n\n  const res = await client.docx.documentBlockDescendant.create({\n    path: { document_id: docToken, block_id: parentBlockId },\n    data: {\n      children_id: firstLevelBlockIds,\n      descendants: descendants.map(toDescendantBlock),\n      index,\n    },\n  });\n  if (res.code !== 0) throw new Error(`${res.msg} (code: ${res.code})`);\n  return res.data?.children ?? [];\n}\n\ntype Logger = { info?: (msg: string) => void };\n\nexport async function insertBlocksInBatches(\n  client: Lark.Client,\n  docToken: string,\n  blocks: FeishuDocxBlock[],\n  firstLevelBlockIds: string[],\n  logger?: Logger,\n  parentBlockId: string = docToken,\n  startIndex: number = -1,\n): Promise<{ children: FeishuDocxBlockChild[]; skipped: string[] }> {\n  const allChildren: FeishuDocxBlockChild[] = [];\n\n  const batches: Array<{ firstLevelIds: string[]; blocks: FeishuDocxBlock[] }> = [];\n  let currentBatch: { firstLevelIds: string[]; blocks: FeishuDocxBlock[] } = { firstLevelIds: [], blocks: [] };\n  const usedBlockIds = new Set<string>();\n  const blockMap = new Map<string, FeishuDocxBlock>();\n  for (const block of blocks) {\n    if (block.block_id) blockMap.set(block.block_id, block);\n  }\n\n  for (const firstLevelId of firstLevelBlockIds) {\n    const descendants = collectDescendants(blockMap, firstLevelId);\n    const newBlocks = descendants.filter((b) => b.block_id && !usedBlockIds.has(b.block_id));\n\n    if (newBlocks.length > BATCH_SIZE) {\n      throw new Error(\n        `Block \"${firstLevelId}\" has ${newBlocks.length} descendants, exceeds Feishu API limit ${BATCH_SIZE}. Split content.`,\n      );\n    }\n\n    if (currentBatch.blocks.length + newBlocks.length > BATCH_SIZE && currentBatch.blocks.length > 0) {\n      batches.push(currentBatch);\n      currentBatch = { firstLevelIds: [], blocks: [] };\n    }\n\n    currentBatch.firstLevelIds.push(firstLevelId);\n    for (const block of newBlocks) {\n      currentBatch.blocks.push(block);\n      if (block.block_id) usedBlockIds.add(block.block_id);\n    }\n  }\n\n  if (currentBatch.blocks.length > 0) batches.push(currentBatch);\n\n  let currentIndex = startIndex;\n  for (let i = 0; i < batches.length; i++) {\n    const batch = batches[i]!;\n    logger?.info?.(`feishu_doc: Inserting batch ${i + 1}/${batches.length} (${batch.blocks.length} blocks)...`);\n    const children = await insertBatch(client, docToken, batch.blocks, batch.firstLevelIds, parentBlockId, currentIndex);\n    allChildren.push(...children);\n    if (currentIndex !== -1) currentIndex += batch.firstLevelIds.length;\n  }\n\n  return { children: allChildren, skipped: [] };\n}\n"],"mappings":"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"}

package/dist/extensions/feishu/src/tools/docx/docx-color-text.js

@@ -0,0 +1,75 @@
+//#region extensions/feishu/src/tools/docx/docx-color-text.ts
+const TEXT_COLOR = {
+	red: 1,
+	orange: 2,
+	yellow: 3,
+	green: 4,
+	blue: 5,
+	purple: 6,
+	grey: 7,
+	gray: 7
+};
+const BACKGROUND_COLOR = {
+	red: 1,
+	orange: 2,
+	yellow: 3,
+	green: 4,
+	blue: 5,
+	purple: 6,
+	grey: 7,
+	gray: 7
+};
+function normalizeLower(s) {
+	return (s ?? "").trim().toLowerCase();
+}
+function parseColorMarkup(content) {
+	const segments = [];
+	const KNOWN = "(?:bg:[a-z]+|bold|red|orange|yellow|green|blue|purple|gr[ae]y)";
+	const tagPattern = new RegExp(`\\[(${KNOWN}(?:\\s+${KNOWN})*)\\](.*?)\\[\\/(?:[^\\]]+)\\]|([^[]+|\\[)`, "gis");
+	let match;
+	while ((match = tagPattern.exec(content)) !== null) {
+		if (match[3] !== void 0) {
+			if (match[3]) segments.push({ text: match[3] });
+			continue;
+		}
+		const tagStr = normalizeLower(match[1] || "");
+		const text = match[2] || "";
+		const tags = tagStr.split(/\s+/).filter(Boolean);
+		const segment = { text };
+		for (const tag of tags) if (tag.startsWith("bg:")) {
+			const color = tag.slice(3);
+			if (BACKGROUND_COLOR[color]) segment.bgColor = BACKGROUND_COLOR[color];
+		} else if (tag === "bold") segment.bold = true;
+		else if (TEXT_COLOR[tag]) segment.textColor = TEXT_COLOR[tag];
+		if (text) segments.push(segment);
+	}
+	return segments;
+}
+async function updateColorText(client, docToken, blockId, content) {
+	const segments = parseColorMarkup(content);
+	const elements = segments.map((seg) => ({ text_run: {
+		content: seg.text,
+		text_element_style: {
+			...seg.textColor ? { text_color: seg.textColor } : {},
+			...seg.bgColor ? { background_color: seg.bgColor } : {},
+			...seg.bold ? { bold: true } : {}
+		}
+	} }));
+	const res = await client.docx.documentBlock.patch({
+		path: {
+			document_id: docToken,
+			block_id: blockId
+		},
+		data: { update_text_elements: { elements } }
+	});
+	if (res.code !== 0) throw new Error(res.msg);
+	return {
+		success: true,
+		segments: segments.length,
+		block: res.data?.block
+	};
+}
+//#endregion
+export { parseColorMarkup, updateColorText };
+
+//# sourceMappingURL=docx-color-text.js.map

package/dist/extensions/feishu/src/tools/docx/docx-color-text.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"docx-color-text.js","names":[],"sources":["../../../../../../extensions/feishu/src/tools/docx/docx-color-text.ts"],"sourcesContent":["import type * as Lark from '@larksuiteoapi/node-sdk';\n\nconst TEXT_COLOR: Record<string, number> = {\n  red: 1,\n  orange: 2,\n  yellow: 3,\n  green: 4,\n  blue: 5,\n  purple: 6,\n  grey: 7,\n  gray: 7,\n};\n\nconst BACKGROUND_COLOR: Record<string, number> = {\n  red: 1,\n  orange: 2,\n  yellow: 3,\n  green: 4,\n  blue: 5,\n  purple: 6,\n  grey: 7,\n  gray: 7,\n};\n\nfunction normalizeLower(s: string): string {\n  return (s ?? '').trim().toLowerCase();\n}\n\ninterface Segment {\n  text: string;\n  textColor?: number;\n  bgColor?: number;\n  bold?: boolean;\n}\n\ntype DocxPatchPayload = NonNullable<Parameters<Lark.Client['docx']['documentBlock']['patch']>[0]>;\ntype DocxTextElement = NonNullable<\n  NonNullable<NonNullable<DocxPatchPayload['data']>['update_text_elements']>['elements']\n>[number];\n\nexport function parseColorMarkup(content: string): Segment[] {\n  const segments: Segment[] = [];\n  const KNOWN = '(?:bg:[a-z]+|bold|red|orange|yellow|green|blue|purple|gr[ae]y)';\n  const tagPattern = new RegExp(\n    `\\\\[(${KNOWN}(?:\\\\s+${KNOWN})*)\\\\](.*?)\\\\[\\\\/(?:[^\\\\]]+)\\\\]|([^[]+|\\\\[)`,\n    'gis',\n  );\n\n  let match: RegExpExecArray | null;\n  while ((match = tagPattern.exec(content)) !== null) {\n    if (match[3] !== undefined) {\n      if (match[3]) segments.push({ text: match[3] });\n      continue;\n    }\n    const tagStr = normalizeLower(match[1] || '');\n    const text = match[2] || '';\n    const tags = tagStr.split(/\\s+/).filter(Boolean);\n    const segment: Segment = { text };\n    for (const tag of tags) {\n      if (tag.startsWith('bg:')) {\n        const color = tag.slice(3);\n        if (BACKGROUND_COLOR[color]) segment.bgColor = BACKGROUND_COLOR[color];\n      } else if (tag === 'bold') {\n        segment.bold = true;\n      } else if (TEXT_COLOR[tag]) {\n        segment.textColor = TEXT_COLOR[tag];\n      }\n    }\n    if (text) segments.push(segment);\n  }\n  return segments;\n}\n\nexport async function updateColorText(client: Lark.Client, docToken: string, blockId: string, content: string) {\n  const segments = parseColorMarkup(content);\n  const elements: DocxTextElement[] = segments.map((seg) => ({\n    text_run: {\n      content: seg.text,\n      text_element_style: {\n        ...(seg.textColor ? { text_color: seg.textColor } : {}),\n        ...(seg.bgColor ? { background_color: seg.bgColor } : {}),\n        ...(seg.bold ? { bold: true } : {}),\n      },\n    },\n  }));\n\n  const res = await client.docx.documentBlock.patch({\n    path: { document_id: docToken, block_id: blockId },\n    data: { update_text_elements: { elements } },\n  });\n  if (res.code !== 0) throw new Error(res.msg);\n  return { success: true, segments: segments.length, block: res.data?.block };\n}\n\n"],"mappings":";AAEA,MAAM,aAAqC;CACzC,KAAK;CACL,QAAQ;CACR,QAAQ;CACR,OAAO;CACP,MAAM;CACN,QAAQ;CACR,MAAM;CACN,MAAM;CACP;AAED,MAAM,mBAA2C;CAC/C,KAAK;CACL,QAAQ;CACR,QAAQ;CACR,OAAO;CACP,MAAM;CACN,QAAQ;CACR,MAAM;CACN,MAAM;CACP;AAED,SAAS,eAAe,GAAmB;AACzC,SAAQ,KAAK,IAAI,MAAM,CAAC,aAAa;;AAevC,SAAgB,iBAAiB,SAA4B;CAC3D,MAAM,WAAsB,EAAE;CAC9B,MAAM,QAAQ;CACd,MAAM,aAAa,IAAI,OACrB,OAAO,MAAM,SAAS,MAAM,8CAC5B,MACD;CAED,IAAI;AACJ,SAAQ,QAAQ,WAAW,KAAK,QAAQ,MAAM,MAAM;AAClD,MAAI,MAAM,OAAO,KAAA,GAAW;AAC1B,OAAI,MAAM,GAAI,UAAS,KAAK,EAAE,MAAM,MAAM,IAAI,CAAC;AAC/C;;EAEF,MAAM,SAAS,eAAe,MAAM,MAAM,GAAG;EAC7C,MAAM,OAAO,MAAM,MAAM;EACzB,MAAM,OAAO,OAAO,MAAM,MAAM,CAAC,OAAO,QAAQ;EAChD,MAAM,UAAmB,EAAE,MAAM;AACjC,OAAK,MAAM,OAAO,KAChB,KAAI,IAAI,WAAW,MAAM,EAAE;GACzB,MAAM,QAAQ,IAAI,MAAM,EAAE;AAC1B,OAAI,iBAAiB,OAAQ,SAAQ,UAAU,iBAAiB;aACvD,QAAQ,OACjB,SAAQ,OAAO;WACN,WAAW,KACpB,SAAQ,YAAY,WAAW;AAGnC,MAAI,KAAM,UAAS,KAAK,QAAQ;;AAElC,QAAO;;AAGT,eAAsB,gBAAgB,QAAqB,UAAkB,SAAiB,SAAiB;CAC7G,MAAM,WAAW,iBAAiB,QAAQ;CAC1C,MAAM,WAA8B,SAAS,KAAK,SAAS,EACzD,UAAU;EACR,SAAS,IAAI;EACb,oBAAoB;GAClB,GAAI,IAAI,YAAY,EAAE,YAAY,IAAI,WAAW,GAAG,EAAE;GACtD,GAAI,IAAI,UAAU,EAAE,kBAAkB,IAAI,SAAS,GAAG,EAAE;GACxD,GAAI,IAAI,OAAO,EAAE,MAAM,MAAM,GAAG,EAAE;GACnC;EACF,EACF,EAAE;CAEH,MAAM,MAAM,MAAM,OAAO,KAAK,cAAc,MAAM;EAChD,MAAM;GAAE,aAAa;GAAU,UAAU;GAAS;EAClD,MAAM,EAAE,sBAAsB,EAAE,UAAU,EAAE;EAC7C,CAAC;AACF,KAAI,IAAI,SAAS,EAAG,OAAM,IAAI,MAAM,IAAI,IAAI;AAC5C,QAAO;EAAE,SAAS;EAAM,UAAU,SAAS;EAAQ,OAAO,IAAI,MAAM;EAAO"}