@openclaw/feishu 2026.9.1-beta.1 → 2026.9.2

package/dist/api.js

@@ -1,12 +1,11 @@
-import { r as listEnabledFeishuAccounts } from "./accounts-RwSyseKr.js";
-import { a as setFeishuNamedAccountEnabled, i as feishuSetupAdapter, n as feishuSetupWizard, r as runFeishuLogin, t as feishuPlugin } from "./channel-Dpgf8wLD.js";
-import { A as feishuExternalToolResult, F as resolveFeishuToolAccount, M as unknownToolActionResult, N as createFeishuToolClient, P as resolveAnyEnabledFeishuToolsConfig, Q as parseFeishuMarkdown, Y as chunkFeishuMarkdown, j as toolExecutionErrorResult, k as registerFeishuDriveTools } from "./presentation-card-C8Z7Tgru.js";
+import { a as setFeishuNamedAccountEnabled, i as feishuSetupAdapter, n as feishuSetupWizard, r as runFeishuLogin, t as feishuPlugin } from "./channel-VytDDz_B.js";
+import { G as createFeishuToolClient, H as feishuExternalToolResult, K as resolveAnyEnabledFeishuToolsConfig, U as toolExecutionErrorResult, V as registerFeishuDriveTools, W as unknownToolActionResult, lt as parseFeishuMarkdown, ot as chunkFeishuMarkdown, q as resolveFeishuToolAccount } from "./reply-delivery-result-CYaKkbUN.js";
 import { a as parseFeishuTargetId, i as parseFeishuDirectConversationId, n as buildFeishuModelOverrideParentCandidates, r as parseFeishuConversationId, t as buildFeishuConversationId } from "./conversation-id-VYgGQ-GX.js";
-import { s as resolveConfiguredHttpTimeoutMs } from "./client-DalLmpMf.js";
+import { s as resolveConfiguredHttpTimeoutMs } from "./client-DMbIL3UH.js";
 import { t as getFeishuRuntime } from "./runtime-C5JxBWZp.js";
-import { o as registerFeishuChatTools } from "./chat-C1nuW5UY.js";
-import { n as getFeishuThreadBindingManager, t as createFeishuThreadBindingManager } from "./thread-bindings-CptM_YU6.js";
-import { n as handleFeishuSubagentEnded, t as handleFeishuSubagentDeliveryTarget } from "./subagent-hooks-KUi-7vUy.js";
+import { o as registerFeishuChatTools } from "./chat-DDhIcPQy.js";
+import { n as getFeishuThreadBindingManager, t as createFeishuThreadBindingManager } from "./thread-bindings-BiL1wGqK.js";
+import { n as handleFeishuSubagentEnded, t as handleFeishuSubagentDeliveryTarget } from "./subagent-hooks-Buadpie_.js";
 import { optionalPositiveIntegerSchema } from "openclaw/plugin-sdk/channel-actions";
 import { formatErrorMessage } from "openclaw/plugin-sdk/error-runtime";
 import { normalizeLowercaseStringOrEmpty, normalizeOptionalString, readStringValue, uniqueStrings } from "openclaw/plugin-sdk/string-coerce-runtime";
@@ -167,23 +166,6 @@ const FeishuDocSchema = Type.Union([
 const MIN_COLUMN_WIDTH = 50;
 const MAX_COLUMN_WIDTH = 400;
 const DEFAULT_TABLE_WIDTH = 730;
-/**
-* Calculate adaptive column widths based on cell content length.
-*
-* Algorithm:
-* 1. For each column, find the max content length across all rows
-* 2. Weight CJK characters as 2x width (they render wider)
-* 3. Calculate proportional widths based on content length
-* 4. Apply min/max constraints
-* 5. Redistribute remaining space to fill total table width
-*
-* Total width is derived from the original column_width values returned
-* by the Convert API, ensuring tables match Feishu's expected dimensions.
-*
-* @param blocks - Array of blocks from Convert API
-* @param tableBlockId - The block_id of the table block
-* @returns Array of column widths in pixels
-*/
 function normalizeChildBlockIds(children) {
 	if (Array.isArray(children)) return children;
 	return typeof children === "string" ? [children] : [];
@@ -288,86 +270,61 @@ function cleanBlocksForDescendant(blocks) {
 		return cleanBlock;
 	});
 }
-async function insertTableRow(client, docToken, blockId, rowIndex = -1) {
-	const res = await client.docx.documentBlock.patch({
-		path: {
-			document_id: docToken,
-			block_id: blockId
-		},
-		data: { insert_table_row: { row_index: rowIndex } }
-	});
-	if (res.code !== 0) throw new Error(res.msg);
-	return {
-		success: true,
-		block: res.data?.block
-	};
-}
-async function insertTableColumn(client, docToken, blockId, columnIndex = -1) {
-	const res = await client.docx.documentBlock.patch({
-		path: {
-			document_id: docToken,
-			block_id: blockId
-		},
-		data: { insert_table_column: { column_index: columnIndex } }
-	});
-	if (res.code !== 0) throw new Error(res.msg);
-	return {
-		success: true,
-		block: res.data?.block
-	};
-}
-async function deleteTableRows(client, docToken, blockId, rowStart, rowCount = 1) {
-	const res = await client.docx.documentBlock.patch({
-		path: {
-			document_id: docToken,
-			block_id: blockId
-		},
-		data: { delete_table_rows: {
-			row_start_index: rowStart,
-			row_end_index: rowStart + rowCount
-		} }
-	});
-	if (res.code !== 0) throw new Error(res.msg);
-	return {
-		success: true,
-		rows_deleted: rowCount,
-		block: res.data?.block
-	};
-}
-async function deleteTableColumns(client, docToken, blockId, columnStart, columnCount = 1) {
-	const res = await client.docx.documentBlock.patch({
-		path: {
-			document_id: docToken,
-			block_id: blockId
-		},
-		data: { delete_table_columns: {
-			column_start_index: columnStart,
-			column_end_index: columnStart + columnCount
-		} }
-	});
-	if (res.code !== 0) throw new Error(res.msg);
-	return {
-		success: true,
-		columns_deleted: columnCount,
-		block: res.data?.block
-	};
-}
-async function mergeTableCells(client, docToken, blockId, rowStart, rowEnd, columnStart, columnEnd) {
+async function patchTable(client, params) {
+	const { doc_token, block_id } = params;
+	let data;
+	const counts = {};
+	switch (params.action) {
+		case "insert_table_row": {
+			const { row_index = -1 } = params;
+			data = { insert_table_row: { row_index } };
+			break;
+		}
+		case "insert_table_column": {
+			const { column_index = -1 } = params;
+			data = { insert_table_column: { column_index } };
+			break;
+		}
+		case "delete_table_rows": {
+			const { row_start, row_count = 1 } = params;
+			data = { delete_table_rows: {
+				row_start_index: row_start,
+				row_end_index: row_start + row_count
+			} };
+			counts.rows_deleted = row_count;
+			break;
+		}
+		case "delete_table_columns": {
+			const { column_start, column_count = 1 } = params;
+			data = { delete_table_columns: {
+				column_start_index: column_start,
+				column_end_index: column_start + column_count
+			} };
+			counts.columns_deleted = column_count;
+			break;
+		}
+		case "merge_table_cells": {
+			const { row_start, row_end, column_start, column_end } = params;
+			data = { merge_table_cells: {
+				row_start_index: row_start,
+				row_end_index: row_end,
+				column_start_index: column_start,
+				column_end_index: column_end
+			} };
+			break;
+		}
+	}
 	const res = await client.docx.documentBlock.patch({
 		path: {
-			document_id: docToken,
-			block_id: blockId
+			document_id: doc_token,
+			block_id
 		},
-		data: { merge_table_cells: {
-			row_start_index: rowStart,
-			row_end_index: rowEnd,
-			column_start_index: columnStart,
-			column_end_index: columnEnd
-		} }
+		data
 	});
 	if (res.code !== 0) throw new Error(res.msg);
 	return {
 		success: true,
+		...counts,
 		block: res.data?.block
 	};
 }
@@ -836,7 +793,7 @@ const BLOCK_TYPE_NAMES = {
 	32: "TableCell"
 };
 const UNSUPPORTED_CREATE_TYPES = /* @__PURE__ */ new Set([31, 32]);
-/** Clean blocks for insertion (remove unsupported types and read-only fields) */
+/** Remove block types unsupported by the children insertion API. */
 function cleanBlocksForInsert(blocks) {
 	const skipped = [];
 	return {
@@ -847,24 +804,21 @@ function cleanBlocksForInsert(blocks) {
 				return false;
 			}
 			return true;
-		}).map((block) => {
-			if (block.block_type === 31 && block.table?.merge_info) {
-				const { merge_info: _merge_info, ...tableRest } = block.table;
-				return Object.assign({}, block, { table: tableRest });
-			}
-			return block;
 		}),
 		skipped
 	};
 }
 /** Max blocks per documentBlockChildren.create request */
 const MAX_CONVERT_RETRY_DEPTH = 8;
+function assertFeishuDocApiSuccess(response) {
+	if (response.code !== 0) throw new Error(response.msg);
+}
 async function convertMarkdown(client, markdown) {
 	const res = await client.docx.document.convert({ data: {
 		content_type: "markdown",
 		content: markdown
 	} });
-	if (res.code !== 0) throw new Error(res.msg);
+	assertFeishuDocApiSuccess(res);
 	return {
 		blocks: res.data?.blocks ?? [],
 		firstLevelBlockIds: res.data?.first_level_block_ids ?? []
@@ -909,7 +863,8 @@ function normalizeConvertedBlockTree(blocks, firstLevelIds) {
 		const parentId = typeof block?.parent_id === "string" ? block.parent_id : "";
 		return !childIds.has(blockId) && (!parentId || !byId.has(parentId));
 	}).toSorted((a, b) => (originalOrder.get(a.block_id ?? "__missing__") ?? 0) - (originalOrder.get(b.block_id ?? "__missing__") ?? 0)).map((block) => block.block_id).filter((blockId) => typeof blockId === "string");
-	const uniqueRootIds = uniqueStrings((firstLevelIds && firstLevelIds.length > 0 ? firstLevelIds : inferredTopLevelIds).filter((id) => typeof id === "string" && byId.has(id)));
+	const rootIds = (firstLevelIds && firstLevelIds.length > 0 ? firstLevelIds : inferredTopLevelIds).filter((id) => typeof id === "string" && byId.has(id));
+	const uniqueRootIds = uniqueStrings(rootIds);
 	const orderedBlocks = [];
 	const visited = /* @__PURE__ */ new Set();
 	const visit = (blockId) => {
@@ -947,7 +902,7 @@ async function insertBlocks(client, docToken, blocks, parentBlockId, index) {
 				...index !== void 0 ? { index: index + offset } : {}
 			}
 		});
-		if (res.code !== 0) throw new Error(res.msg);
+		assertFeishuDocApiSuccess(res);
 		allInserted.push(...res.data?.children ?? []);
 	}
 	return {
@@ -1026,21 +981,18 @@ async function insertBlocksWithDescendant(client, docToken, blocks, firstLevelBl
 }
 async function clearDocumentContent(client, docToken) {
 	const existing = await client.docx.documentBlock.list({ path: { document_id: docToken } });
-	if (existing.code !== 0) throw new Error(existing.msg);
+	assertFeishuDocApiSuccess(existing);
 	const childIds = existing.data?.items?.filter((b) => b.parent_id === docToken && b.block_type !== 1).map((b) => b.block_id) ?? [];
-	if (childIds.length > 0) {
-		const res = await client.docx.documentBlockChildren.batchDelete({
-			path: {
-				document_id: docToken,
-				block_id: docToken
-			},
-			data: {
-				start_index: 0,
-				end_index: childIds.length
-			}
-		});
-		if (res.code !== 0) throw new Error(res.msg);
-	}
+	if (childIds.length > 0) assertFeishuDocApiSuccess(await client.docx.documentBlockChildren.batchDelete({
+		path: {
+			document_id: docToken,
+			block_id: docToken
+		},
+		data: {
+			start_index: 0,
+			end_index: childIds.length
+		}
+	}));
 	return childIds.length;
 }
 async function uploadImageToDocx(client, blockId, imageBuffer, fileName, docToken) {
@@ -1070,13 +1022,13 @@ async function processImages(client, docToken, images, insertedBlocks, maxBytes,
 				remoteReadTimeoutMs: imageReadTimeoutMs
 			});
 			const fileToken = await uploadImageToDocx(client, blockId, upload.buffer, upload.fileName, docToken);
-			await client.docx.documentBlock.patch({
+			assertFeishuDocApiSuccess(await client.docx.documentBlock.patch({
 				path: {
 					document_id: docToken,
 					block_id: blockId
 				},
 				data: { replace_image: { token: fileToken } }
-			});
+			}));
 			processed++;
 		} catch (err) {
 			console.error(`Failed to process image ${url}:`, err);
@@ -1133,14 +1085,13 @@ async function uploadImageBlock(client, docToken, maxBytes, imageReadTimeoutMs,
 	const imageBlockId = insertRes.data?.children?.find((b) => b.block_type === 27)?.block_id;
 	if (!imageBlockId) throw new Error("Failed to create image block");
 	const fileToken = await uploadImageToDocx(client, imageBlockId, upload.buffer, upload.fileName, docToken);
-	const patchRes = await client.docx.documentBlock.patch({
+	assertFeishuDocApiSuccess(await client.docx.documentBlock.patch({
 		path: {
 			document_id: docToken,
 			block_id: imageBlockId
 		},
 		data: { replace_image: { token: fileToken } }
-	});
-	if (patchRes.code !== 0) throw new Error(patchRes.msg);
+	}));
 	return {
 		success: true,
 		block_id: imageBlockId,
@@ -1168,21 +1119,18 @@ async function uploadFileBlock(client, docToken, maxBytes, localRoots, url, file
 		document_id: docToken,
 		block_id: parentId
 	} });
-	if (childrenRes.code !== 0) throw new Error(childrenRes.msg);
+	assertFeishuDocApiSuccess(childrenRes);
 	const placeholderIdx = (childrenRes.data?.items ?? []).findIndex((item) => item.block_id === placeholderBlock.block_id);
-	if (placeholderIdx >= 0) {
-		const deleteRes = await client.docx.documentBlockChildren.batchDelete({
-			path: {
-				document_id: docToken,
-				block_id: parentId
-			},
-			data: {
-				start_index: placeholderIdx,
-				end_index: placeholderIdx + 1
-			}
-		});
-		if (deleteRes.code !== 0) throw new Error(deleteRes.msg);
-	}
+	if (placeholderIdx >= 0) assertFeishuDocApiSuccess(await client.docx.documentBlockChildren.batchDelete({
+		path: {
+			document_id: docToken,
+			block_id: parentId
+		},
+		data: {
+			start_index: placeholderIdx,
+			end_index: placeholderIdx + 1
+		}
+	}));
 	const fileToken = (await client.drive.media.uploadAll({ data: {
 		file_name: upload.fileName,
 		parent_type: "docx_file",
@@ -1215,7 +1163,7 @@ async function readDoc(client, docToken) {
 		client.docx.document.get({ path: { document_id: docToken } }),
 		client.docx.documentBlock.list({ path: { document_id: docToken } })
 	]);
-	if (contentRes.code !== 0) throw new Error(contentRes.msg);
+	assertFeishuDocApiSuccess(contentRes);
 	const blocks = blocksRes.data?.items ?? [];
 	const blockCounts = {};
 	const structuredTypes = [];
@@ -1241,7 +1189,7 @@ async function createDoc(client, title, folderToken, options) {
 		title,
 		folder_token: folderToken
 	} });
-	if (res.code !== 0) throw new Error(res.msg);
+	assertFeishuDocApiSuccess(res);
 	const doc = res.data?.document;
 	const docToken = doc?.document_id;
 	if (!docToken) throw new Error("Document creation succeeded but no document_id was returned");
@@ -1251,23 +1199,25 @@ async function createDoc(client, title, folderToken, options) {
 	let requesterPermissionAdded = false;
 	let requesterPermissionSkippedReason;
 	let requesterPermissionError;
-	if (shouldGrantToRequester) if (!requesterOpenId) requesterPermissionSkippedReason = "trusted requester identity unavailable";
-	else try {
-		await client.drive.permissionMember.create({
-			path: { token: docToken },
-			params: {
-				type: "docx",
-				need_notification: false
-			},
-			data: {
-				member_type: "openid",
-				member_id: requesterOpenId,
-				perm: requesterPermType
-			}
-		});
-		requesterPermissionAdded = true;
-	} catch (err) {
-		requesterPermissionError = formatErrorMessage(err);
+	if (shouldGrantToRequester) {
+		if (!requesterOpenId) requesterPermissionSkippedReason = "trusted requester identity unavailable";
+		else try {
+			assertFeishuDocApiSuccess(await client.drive.permissionMember.create({
+				path: { token: docToken },
+				params: {
+					type: "docx",
+					need_notification: false
+				},
+				data: {
+					member_type: "openid",
+					member_id: requesterOpenId,
+					perm: requesterPermType
+				}
+			}));
+			requesterPermissionAdded = true;
+		} catch (err) {
+			requesterPermissionError = formatErrorMessage(err);
+		}
 	}
 	return {
 		document_id: docToken,
@@ -1326,11 +1276,12 @@ async function insertDoc(client, docToken, markdown, afterBlockId, maxBytes, ima
 		document_id: docToken,
 		block_id: afterBlockId
 	} });
-	if (blockInfo.code !== 0) throw new Error(blockInfo.msg);
+	assertFeishuDocApiSuccess(blockInfo);
 	const parentId = blockInfo.data?.block?.parent_id ?? docToken;
 	const items = [];
 	let pageToken;
-	do {
+	const seenPageTokens = /* @__PURE__ */ new Set();
+	while (true) {
 		const childrenRes = await client.docx.documentBlockChildren.get({
 			path: {
 				document_id: docToken,
@@ -1338,10 +1289,15 @@ async function insertDoc(client, docToken, markdown, afterBlockId, maxBytes, ima
 			},
 			params: pageToken ? { page_token: pageToken } : {}
 		});
-		if (childrenRes.code !== 0) throw new Error(childrenRes.msg);
+		assertFeishuDocApiSuccess(childrenRes);
 		items.push(...childrenRes.data?.items ?? []);
-		pageToken = childrenRes.data?.page_token ?? void 0;
-	} while (pageToken);
+		if (childrenRes.data?.has_more !== true) break;
+		const nextPageToken = childrenRes.data.page_token?.trim();
+		if (!nextPageToken) throw new Error(`Feishu document children pagination is missing its next page token for parent block "${parentId}"`);
+		if (seenPageTokens.has(nextPageToken)) throw new Error(`Feishu document children pagination repeated token for parent block "${parentId}"`);
+		seenPageTokens.add(nextPageToken);
+		pageToken = nextPageToken;
+	}
 	const blockIndex = items.findIndex((item) => item.block_id === afterBlockId);
 	if (blockIndex === -1) throw new Error(`after_block_id "${afterBlockId}" was not found among the children of parent block "${parentId}". Use list_blocks to verify the block ID.`);
 	const { blocks, inserted, imagesProcessed } = await convertInsertAndProcessDocx({
@@ -1383,7 +1339,7 @@ async function createTable(client, docToken, rowSize, columnSize, parentBlockId,
 			} }
 		}] }
 	});
-	if (res.code !== 0) throw new Error(res.msg);
+	assertFeishuDocApiSuccess(res);
 	const tableBlock = res.data?.children?.find((b) => b.block_type === 31);
 	const cells = normalizeInsertedChildBlocks(tableBlock?.children);
 	return {
@@ -1401,7 +1357,7 @@ async function writeTableCells(client, docToken, tableBlockId, values) {
 		document_id: docToken,
 		block_id: tableBlockId
 	} });
-	if (tableRes.code !== 0) throw new Error(tableRes.msg);
+	assertFeishuDocApiSuccess(tableRes);
 	const tableBlock = tableRes.data?.block;
 	if (tableBlock?.block_type !== 31) throw new Error("table_block_id is not a table block");
 	const tableData = tableBlock.table;
@@ -1421,21 +1377,18 @@ async function writeTableCells(client, docToken, tableBlockId, values) {
 				document_id: docToken,
 				block_id: cellId
 			} });
-			if (childrenRes.code !== 0) throw new Error(childrenRes.msg);
+			assertFeishuDocApiSuccess(childrenRes);
 			const existingChildren = childrenRes.data?.items ?? [];
-			if (existingChildren.length > 0) {
-				const delRes = await client.docx.documentBlockChildren.batchDelete({
-					path: {
-						document_id: docToken,
-						block_id: cellId
-					},
-					data: {
-						start_index: 0,
-						end_index: existingChildren.length
-					}
-				});
-				if (delRes.code !== 0) throw new Error(delRes.msg);
-			}
+			if (existingChildren.length > 0) assertFeishuDocApiSuccess(await client.docx.documentBlockChildren.batchDelete({
+				path: {
+					document_id: docToken,
+					block_id: cellId
+				},
+				data: {
+					start_index: 0,
+					end_index: existingChildren.length
+				}
+			}));
 			const converted = await convertMarkdown(client, rowValues[c] ?? "");
 			const { orderedBlocks } = normalizeConvertedBlockTree(converted.blocks, converted.firstLevelBlockIds);
 			if (orderedBlocks.length > 0) await insertBlocks(client, docToken, orderedBlocks, cellId);
@@ -1464,19 +1417,17 @@ async function createTableWithValues(client, docToken, rowSize, columnSize, valu
 	};
 }
 async function updateBlock(client, docToken, blockId, content) {
-	const blockInfo = await client.docx.documentBlock.get({ path: {
+	assertFeishuDocApiSuccess(await client.docx.documentBlock.get({ path: {
 		document_id: docToken,
 		block_id: blockId
-	} });
-	if (blockInfo.code !== 0) throw new Error(blockInfo.msg);
-	const res = await client.docx.documentBlock.patch({
+	} }));
+	assertFeishuDocApiSuccess(await client.docx.documentBlock.patch({
 		path: {
 			document_id: docToken,
 			block_id: blockId
 		},
 		data: { update_text_elements: { elements: [{ text_run: { content } }] } }
-	});
-	if (res.code !== 0) throw new Error(res.msg);
+	}));
 	return {
 		success: true,
 		block_id: blockId
@@ -1487,16 +1438,16 @@ async function deleteBlock(client, docToken, blockId) {
 		document_id: docToken,
 		block_id: blockId
 	} });
-	if (blockInfo.code !== 0) throw new Error(blockInfo.msg);
+	assertFeishuDocApiSuccess(blockInfo);
 	const parentId = blockInfo.data?.block?.parent_id ?? docToken;
 	const children = await client.docx.documentBlockChildren.get({ path: {
 		document_id: docToken,
 		block_id: parentId
 	} });
-	if (children.code !== 0) throw new Error(children.msg);
+	assertFeishuDocApiSuccess(children);
 	const index = (children.data?.items ?? []).findIndex((item) => item.block_id === blockId);
 	if (index === -1) throw new Error("Block not found");
-	const res = await client.docx.documentBlockChildren.batchDelete({
+	assertFeishuDocApiSuccess(await client.docx.documentBlockChildren.batchDelete({
 		path: {
 			document_id: docToken,
 			block_id: parentId
@@ -1505,8 +1456,7 @@ async function deleteBlock(client, docToken, blockId) {
 			start_index: index,
 			end_index: index + 1
 		}
-	});
-	if (res.code !== 0) throw new Error(res.msg);
+	}));
 	return {
 		success: true,
 		deleted_block_id: blockId
@@ -1514,7 +1464,7 @@ async function deleteBlock(client, docToken, blockId) {
 }
 async function listBlocks(client, docToken) {
 	const res = await client.docx.documentBlock.list({ path: { document_id: docToken } });
-	if (res.code !== 0) throw new Error(res.msg);
+	assertFeishuDocApiSuccess(res);
 	return { blocks: res.data?.items ?? [] };
 }
 async function getBlock(client, docToken, blockId) {
@@ -1522,12 +1472,12 @@ async function getBlock(client, docToken, blockId) {
 		document_id: docToken,
 		block_id: blockId
 	} });
-	if (res.code !== 0) throw new Error(res.msg);
+	assertFeishuDocApiSuccess(res);
 	return { block: res.data?.block };
 }
 async function listAppScopes(client) {
 	const res = await client.application.scope.list({});
-	if (res.code !== 0) throw new Error(res.msg);
+	assertFeishuDocApiSuccess(res);
 	const scopes = res.data?.scopes ?? [];
 	const granted = scopes.filter((s) => s.grant_status === 1);
 	const pending = scopes.filter((s) => s.grant_status !== 1);
@@ -1545,10 +1495,7 @@ async function listAppScopes(client) {
 }
 function registerFeishuDocTools(api) {
 	if (!api.config) return;
-	const accounts = listEnabledFeishuAccounts(api.config);
-	if (accounts.length === 0) return;
-	const toolsCfg = resolveAnyEnabledFeishuToolsConfig(accounts);
-	const registered = [];
+	const toolsCfg = resolveAnyEnabledFeishuToolsConfig(api.config);
 	const getClient = (params, defaultAccountId) => createFeishuToolClient({
 		api,
 		executeParams: params,
@@ -1576,80 +1523,75 @@ function registerFeishuDocTools(api) {
 			label: "Doc"
 		}
 	}));
-	if (toolsCfg.doc) {
-		api.registerTool((ctx) => {
-			const defaultAccountId = ctx.agentAccountId;
-			const mediaLocalRoots = resolveDocToolLocalRoots(ctx);
-			const trustedRequesterOpenId = ctx.messageChannel === "feishu" ? normalizeOptionalString(ctx.requesterSenderId) : void 0;
-			return {
-				name: "feishu_doc",
-				resultContentSource: "network",
-				label: "Feishu Doc",
-				description: "Feishu document operations. Actions: read, write, append, insert, create, list_blocks, get_block, update_block, delete_block, create_table, write_table_cells, create_table_with_values, insert_table_row, insert_table_column, delete_table_rows, delete_table_columns, merge_table_cells, upload_image, upload_file, color_text",
-				parameters: FeishuDocSchema,
-				async execute(_toolCallId, params) {
-					const p = params;
-					try {
-						if (p.action === "create" && Object.hasOwn(p, "content")) return feishuExternalToolResult({ error: "Feishu document creation does not support content. Call action \"create\" first, then call action \"write\" with the returned document_id as doc_token." });
-						const client = getClient(p, defaultAccountId);
-						switch (p.action) {
-							case "read": return feishuExternalToolResult(await readDoc(client, p.doc_token));
-							case "write": return feishuExternalToolResult(await writeDoc(client, p.doc_token, p.content, getMediaMaxBytes(p, defaultAccountId), getImageReadTimeoutMs(p, defaultAccountId), api.logger));
-							case "append": return feishuExternalToolResult(await appendDoc(client, p.doc_token, p.content, getMediaMaxBytes(p, defaultAccountId), getImageReadTimeoutMs(p, defaultAccountId), api.logger));
-							case "insert": return feishuExternalToolResult(await insertDoc(client, p.doc_token, p.content, p.after_block_id, getMediaMaxBytes(p, defaultAccountId), getImageReadTimeoutMs(p, defaultAccountId), api.logger));
-							case "create": return feishuExternalToolResult(await createDoc(client, p.title, p.folder_token, {
-								grantToRequester: p.grant_to_requester,
-								requesterOpenId: trustedRequesterOpenId
-							}));
-							case "list_blocks": return feishuExternalToolResult(await listBlocks(client, p.doc_token));
-							case "get_block": return feishuExternalToolResult(await getBlock(client, p.doc_token, p.block_id));
-							case "update_block": return feishuExternalToolResult(await updateBlock(client, p.doc_token, p.block_id, p.content));
-							case "delete_block": return feishuExternalToolResult(await deleteBlock(client, p.doc_token, p.block_id));
-							case "create_table": return feishuExternalToolResult(await createTable(client, p.doc_token, p.row_size, p.column_size, p.parent_block_id, p.column_width));
-							case "write_table_cells": return feishuExternalToolResult(await writeTableCells(client, p.doc_token, p.table_block_id, p.values));
-							case "create_table_with_values": return feishuExternalToolResult(await createTableWithValues(client, p.doc_token, p.row_size, p.column_size, p.values, p.parent_block_id, p.column_width));
-							case "upload_image": return feishuExternalToolResult(await uploadImageBlock(client, p.doc_token, getMediaMaxBytes(p, defaultAccountId), getImageReadTimeoutMs(p, defaultAccountId), mediaLocalRoots, p.url, p.file_path, p.parent_block_id, p.filename, p.index, p.image));
-							case "upload_file": return feishuExternalToolResult(await uploadFileBlock(client, p.doc_token, getMediaMaxBytes(p, defaultAccountId), mediaLocalRoots, p.url, p.file_path, p.parent_block_id, p.filename));
-							case "color_text": return feishuExternalToolResult(await updateColorText(client, p.doc_token, p.block_id, p.content));
-							case "insert_table_row": return feishuExternalToolResult(await insertTableRow(client, p.doc_token, p.block_id, p.row_index));
-							case "insert_table_column": return feishuExternalToolResult(await insertTableColumn(client, p.doc_token, p.block_id, p.column_index));
-							case "delete_table_rows": return feishuExternalToolResult(await deleteTableRows(client, p.doc_token, p.block_id, p.row_start, p.row_count));
-							case "delete_table_columns": return feishuExternalToolResult(await deleteTableColumns(client, p.doc_token, p.block_id, p.column_start, p.column_count));
-							case "merge_table_cells": return feishuExternalToolResult(await mergeTableCells(client, p.doc_token, p.block_id, p.row_start, p.row_end, p.column_start, p.column_end));
-							default: return feishuExternalToolResult({ error: "Unknown action" });
-						}
-					} catch (err) {
-						return feishuExternalToolResult({ error: formatErrorMessage(err) });
-					}
-				}
-			};
-		}, { name: "feishu_doc" });
-		registered.push("feishu_doc");
-	}
-	if (toolsCfg.scopes) {
-		api.registerTool((ctx) => ({
-			name: "feishu_app_scopes",
+	if (toolsCfg.doc) api.registerTool((ctx) => {
+		const defaultAccountId = ctx.agentAccountId;
+		const mediaLocalRoots = resolveDocToolLocalRoots(ctx);
+		const trustedRequesterOpenId = ctx.messageChannel === "feishu" ? normalizeOptionalString(ctx.requesterSenderId) : void 0;
+		return {
+			name: "feishu_doc",
 			resultContentSource: "network",
-			label: "Feishu App Scopes",
-			description: "List current app permissions (scopes). Use to debug permission issues or check available capabilities.",
-			parameters: Type.Object({}),
-			async execute() {
+			label: "Feishu Doc",
+			description: "Feishu document operations. Actions: read, write, append, insert, create, list_blocks, get_block, update_block, delete_block, create_table, write_table_cells, create_table_with_values, insert_table_row, insert_table_column, delete_table_rows, delete_table_columns, merge_table_cells, upload_image, upload_file, color_text",
+			parameters: FeishuDocSchema,
+			async execute(_toolCallId, params) {
+				const p = params;
 				try {
-					return feishuExternalToolResult(await listAppScopes(createFeishuToolClient({
-						api,
-						defaultAccountId: ctx.agentAccountId,
-						requiredTool: {
-							family: "scopes",
-							label: "App Scopes"
-						}
-					})));
+					if (p.action === "create" && Object.hasOwn(p, "content")) return feishuExternalToolResult({ error: "Feishu document creation does not support content. Call action \"create\" first, then call action \"write\" with the returned document_id as doc_token." });
+					const client = getClient(p, defaultAccountId);
+					switch (p.action) {
+						case "read": return feishuExternalToolResult(await readDoc(client, p.doc_token));
+						case "write": return feishuExternalToolResult(await writeDoc(client, p.doc_token, p.content, getMediaMaxBytes(p, defaultAccountId), getImageReadTimeoutMs(p, defaultAccountId), api.logger));
+						case "append": return feishuExternalToolResult(await appendDoc(client, p.doc_token, p.content, getMediaMaxBytes(p, defaultAccountId), getImageReadTimeoutMs(p, defaultAccountId), api.logger));
+						case "insert": return feishuExternalToolResult(await insertDoc(client, p.doc_token, p.content, p.after_block_id, getMediaMaxBytes(p, defaultAccountId), getImageReadTimeoutMs(p, defaultAccountId), api.logger));
+						case "create": return feishuExternalToolResult(await createDoc(client, p.title, p.folder_token, {
+							grantToRequester: p.grant_to_requester,
+							requesterOpenId: trustedRequesterOpenId
+						}));
+						case "list_blocks": return feishuExternalToolResult(await listBlocks(client, p.doc_token));
+						case "get_block": return feishuExternalToolResult(await getBlock(client, p.doc_token, p.block_id));
+						case "update_block": return feishuExternalToolResult(await updateBlock(client, p.doc_token, p.block_id, p.content));
+						case "delete_block": return feishuExternalToolResult(await deleteBlock(client, p.doc_token, p.block_id));
+						case "create_table": return feishuExternalToolResult(await createTable(client, p.doc_token, p.row_size, p.column_size, p.parent_block_id, p.column_width));
+						case "write_table_cells": return feishuExternalToolResult(await writeTableCells(client, p.doc_token, p.table_block_id, p.values));
+						case "create_table_with_values": return feishuExternalToolResult(await createTableWithValues(client, p.doc_token, p.row_size, p.column_size, p.values, p.parent_block_id, p.column_width));
+						case "upload_image": return feishuExternalToolResult(await uploadImageBlock(client, p.doc_token, getMediaMaxBytes(p, defaultAccountId), getImageReadTimeoutMs(p, defaultAccountId), mediaLocalRoots, p.url, p.file_path, p.parent_block_id, p.filename, p.index, p.image));
+						case "upload_file": return feishuExternalToolResult(await uploadFileBlock(client, p.doc_token, getMediaMaxBytes(p, defaultAccountId), mediaLocalRoots, p.url, p.file_path, p.parent_block_id, p.filename));
+						case "color_text": return feishuExternalToolResult(await updateColorText(client, p.doc_token, p.block_id, p.content));
+						case "insert_table_row":
+						case "insert_table_column":
+						case "delete_table_rows":
+						case "delete_table_columns":
+						case "merge_table_cells": return feishuExternalToolResult(await patchTable(client, p));
+						default: return feishuExternalToolResult({ error: "Unknown action" });
+					}
 				} catch (err) {
 					return feishuExternalToolResult({ error: formatErrorMessage(err) });
 				}
 			}
-		}), { name: "feishu_app_scopes" });
-		registered.push("feishu_app_scopes");
-	}
+		};
+	}, { name: "feishu_doc" });
+	if (toolsCfg.scopes) api.registerTool((ctx) => ({
+		name: "feishu_app_scopes",
+		resultContentSource: "network",
+		label: "Feishu App Scopes",
+		description: "List current app permissions (scopes). Use to debug permission issues or check available capabilities.",
+		parameters: Type.Object({}),
+		async execute() {
+			try {
+				const result = await listAppScopes(createFeishuToolClient({
+					api,
+					defaultAccountId: ctx.agentAccountId,
+					requiredTool: {
+						family: "scopes",
+						label: "App Scopes"
+					}
+				}));
+				return feishuExternalToolResult(result);
+			} catch (err) {
+				return feishuExternalToolResult({ error: formatErrorMessage(err) });
+			}
+		}
+	}), { name: "feishu_app_scopes" });
 }
 //#endregion
 //#region extensions/feishu/src/wiki-schema.ts
@@ -1837,9 +1779,7 @@ async function renameNode(client, spaceId, nodeToken, title) {
 }
 function registerFeishuWikiTools(api) {
 	if (!api.config) return;
-	const accounts = listEnabledFeishuAccounts(api.config);
-	if (accounts.length === 0) return;
-	if (!resolveAnyEnabledFeishuToolsConfig(accounts).wiki) return;
+	if (!resolveAnyEnabledFeishuToolsConfig(api.config).wiki) return;
 	api.registerTool((ctx) => {
 		const defaultAccountId = ctx.agentAccountId;
 		return {
@@ -1989,9 +1929,7 @@ async function removeMember(client, token, type, memberType, memberId) {
 }
 function registerFeishuPermTools(api) {
 	if (!api.config) return;
-	const accounts = listEnabledFeishuAccounts(api.config);
-	if (accounts.length === 0) return;
-	if (!resolveAnyEnabledFeishuToolsConfig(accounts).perm) return;
+	if (!resolveAnyEnabledFeishuToolsConfig(api.config).perm) return;
 	api.registerTool((ctx) => {
 		const defaultAccountId = ctx.agentAccountId;
 		return {
@@ -2339,7 +2277,7 @@ async function createApp(client, name, folderToken, logger) {
 		url: res.data?.app?.url,
 		cleaned_placeholder_rows: cleanedRows,
 		cleaned_default_fields: cleanedFields,
-		hint: tableId ? `Table created. Use app_token="${appToken}" and table_id="${tableId}" for other bitable tools.` : "Table created. Use feishu_bitable_get_meta to get table_id and field details."
+		hint: tableId ? `Table created. Use app_token="${appToken}" and table_id="${tableId}" for other bitable tools.` : "Application created, but table metadata was not retrieved. Inspect the existing application using the returned app_token or URL; do not create it again."
 	};
 }
 async function createField(client, appToken, tableId, fieldName, fieldType, property) {
@@ -2383,13 +2321,15 @@ async function updateRecord(client, appToken, tableId, recordId, fields) {
 	});
 	return { record: res.data?.record };
 }
+const BITABLE_APP_TOKEN_DESCRIPTION = "Bitable application token (the /base/ URL identifier, or app_token from metadata). Not the node token in a /wiki/ URL.";
+const BITABLE_RECORD_FIELDS_DESCRIPTION = "Field values keyed by field name. Format by type: Text='string', Number=123, SingleSelect='Option', MultiSelect=['A','B'], DateTime=timestamp_ms, User=[{id:'ou_xxx'}], URL={text:'Display',link:'https://...'}";
 const GetMetaSchema = Type.Object({ url: Type.String({ description: "Bitable URL. Supports both formats: /base/XXX?table=YYY or /wiki/XXX?table=YYY" }) });
 const ListFieldsSchema = Type.Object({
-	app_token: Type.String({ description: "Bitable app token (use feishu_bitable_get_meta to get from URL)" }),
+	app_token: Type.String({ description: BITABLE_APP_TOKEN_DESCRIPTION }),
 	table_id: Type.String({ description: "Table ID (from URL: ?table=YYY)" })
 });
 const ListRecordsSchema = Type.Object({
-	app_token: Type.String({ description: "Bitable app token (use feishu_bitable_get_meta to get from URL)" }),
+	app_token: Type.String({ description: BITABLE_APP_TOKEN_DESCRIPTION }),
 	table_id: Type.String({ description: "Table ID (from URL: ?table=YYY)" }),
 	page_size: optionalPositiveIntegerSchema({
 		description: "Number of records per page (1-500, default 100)",
@@ -2398,7 +2338,7 @@ const ListRecordsSchema = Type.Object({
 	page_token: Type.Optional(Type.String({ description: "Pagination token from previous response" }))
 });
 const GetRecordSchema = Type.Object({
-	app_token: Type.String({ description: "Bitable app token (use feishu_bitable_get_meta to get from URL)" }),
+	app_token: Type.String({ description: BITABLE_APP_TOKEN_DESCRIPTION }),
 	table_id: Type.String({ description: "Table ID (from URL: ?table=YYY)" }),
 	record_id: Type.String({ description: "Record ID to retrieve" })
 });
@@ -2411,16 +2351,16 @@ const BitableFieldValueSchema = Type.Unsafe({ type: [
 	"null"
 ] });
 const CreateRecordSchema = Type.Object({
-	app_token: Type.String({ description: "Bitable app token (use feishu_bitable_get_meta to get from URL)" }),
+	app_token: Type.String({ description: BITABLE_APP_TOKEN_DESCRIPTION }),
 	table_id: Type.String({ description: "Table ID (from URL: ?table=YYY)" }),
-	fields: Type.Record(Type.String(), BitableFieldValueSchema, { description: "Field values keyed by field name. Format by type: Text='string', Number=123, SingleSelect='Option', MultiSelect=['A','B'], DateTime=timestamp_ms, User=[{id:'ou_xxx'}], URL={text:'Display',link:'https://...'}" })
+	fields: Type.Record(Type.String(), BitableFieldValueSchema, { description: BITABLE_RECORD_FIELDS_DESCRIPTION })
 });
 const CreateAppSchema = Type.Object({
 	name: Type.String({ description: "Name for the new Bitable application" }),
 	folder_token: Type.Optional(Type.String({ description: "Optional folder token to place the Bitable in a specific folder" }))
 });
 const CreateFieldSchema = Type.Object({
-	app_token: Type.String({ description: "Bitable app token (use feishu_bitable_get_meta to get from URL, or feishu_bitable_create_app to create new)" }),
+	app_token: Type.String({ description: BITABLE_APP_TOKEN_DESCRIPTION }),
 	table_id: Type.String({ description: "Table ID (from URL: ?table=YYY)" }),
 	field_name: Type.String({ description: "Name for the new field" }),
 	field_type: Type.Number({
@@ -2430,16 +2370,14 @@ const CreateFieldSchema = Type.Object({
 	property: Type.Optional(Type.Record(Type.String(), BitableFieldValueSchema, { description: "Field-specific properties (e.g., options for SingleSelect, format for Number)" }))
 });
 const UpdateRecordSchema = Type.Object({
-	app_token: Type.String({ description: "Bitable app token (use feishu_bitable_get_meta to get from URL)" }),
+	app_token: Type.String({ description: BITABLE_APP_TOKEN_DESCRIPTION }),
 	table_id: Type.String({ description: "Table ID (from URL: ?table=YYY)" }),
 	record_id: Type.String({ description: "Record ID to update" }),
-	fields: Type.Record(Type.String(), BitableFieldValueSchema, { description: "Field values to update (same format as create_record)" })
+	fields: Type.Record(Type.String(), BitableFieldValueSchema, { description: BITABLE_RECORD_FIELDS_DESCRIPTION })
 });
 function registerFeishuBitableTools(api) {
 	if (!api.config) return;
-	const accounts = listEnabledFeishuAccounts(api.config);
-	if (accounts.length === 0) return;
-	if (!resolveAnyEnabledFeishuToolsConfig(accounts).bitable) return;
+	if (!resolveAnyEnabledFeishuToolsConfig(api.config).bitable) return;
 	const getClient = (params, defaultAccountId) => createFeishuToolClient({
 		api,
 		executeParams: params,