@openclaw/feishu 2026.7.2-beta.7 → 2026.8.1-beta.2

package/dist/{monitor.startup-CqH2tiJq.js → monitor.startup-BGErejNH.js}

@@ -1,5 +1,5 @@
 import { t as getFeishuRuntime } from "./runtime-C5JxBWZp.js";
-import { r as registerFeishuAiAgent, t as probeFeishu } from "./probe-p3POS2RN.js";
+import { r as registerFeishuAiAgent, t as probeFeishu } from "./probe-DVpy58s0.js";
 import { parseStrictPositiveInteger } from "openclaw/plugin-sdk/number-runtime";
 import { normalizeLowercaseStringOrEmpty, normalizeOptionalString } from "openclaw/plugin-sdk/string-coerce-runtime";
 import { normalizeAccountId } from "openclaw/plugin-sdk/account-resolution";

package/dist/{probe-p3POS2RN.js → probe-DVpy58s0.js}

@@ -1,7 +1,7 @@
 import { t as __exportAll } from "./rolldown-runtime-8H4AJuhK.js";
-import { r as createFeishuClient } from "./client-Dcbs6vml.js";
-import { asDateTimestampMs, resolveExpiresAtMsFromDurationMs, resolveTimerTimeoutMs } from "openclaw/plugin-sdk/number-runtime";
+import { r as createFeishuClient } from "./client-Hp7uo_cl.js";
 import { formatErrorMessage } from "openclaw/plugin-sdk/error-runtime";
+import { asDateTimestampMs, resolveExpiresAtMsFromDurationMs, resolveTimerTimeoutMs } from "openclaw/plugin-sdk/number-runtime";
 import { createHash } from "node:crypto";
 //#region extensions/feishu/src/async.ts
 const RACE_TIMEOUT = Symbol("race-timeout");

package/dist/security-audit-D6Fz2h6p.js

@@ -0,0 +1,23 @@
+import "./security-audit-shared-BgpY7AiJ.js";
+//#region extensions/feishu/src/message-action-contract.ts
+const FEISHU_NATIVE_CHAT_TARGET_ALIASES = [
+	"chatId",
+	"chat_id",
+	"channel_id"
+];
+function createMessageMutationTargetAliases() {
+	return {
+		aliases: ["messageId", ...FEISHU_NATIVE_CHAT_TARGET_ALIASES],
+		deliveryTargetAliases: [...FEISHU_NATIVE_CHAT_TARGET_ALIASES]
+	};
+}
+const messageActionTargetAliases = {
+	read: { aliases: ["messageId"] },
+	edit: createMessageMutationTargetAliases(),
+	pin: createMessageMutationTargetAliases(),
+	unpin: createMessageMutationTargetAliases(),
+	"list-pins": { aliases: ["chatId"] },
+	"channel-info": { aliases: ["chatId"] }
+};
+//#endregion
+export { messageActionTargetAliases as t };

package/dist/{send-result-B9_BpUPx.js → send-result-DEAycmOk.js}

@@ -1,4 +1,3 @@
-import { d as isRecord$1 } from "./accounts-u9X5Wsan.js";
 import { r as normalizeFeishuTarget, t as detectIdType } from "./targets-BUjQ1TcA.js";
 import { compileAllowlist, resolveAllowlistMatchByCandidates } from "openclaw/plugin-sdk/allow-from";
 import { ToolAuthorizationError } from "openclaw/plugin-sdk/channel-actions";
@@ -11,6 +10,7 @@ import { fromMarkdown } from "mdast-util-from-markdown";
 import { gfmTableFromMarkdown } from "mdast-util-gfm-table";
 import { gfmTable } from "micromark-extension-gfm-table";
 import { chunkMarkdownTextWithMode } from "openclaw/plugin-sdk/reply-chunking";
+import { createChannelPartialDeliveryError } from "openclaw/plugin-sdk/channel-inbound";
 //#region extensions/feishu/src/card-interaction.ts
 const FEISHU_CARD_INTERACTION_VERSION = "ocf1";
 function isInteractionKind(value) {
@@ -27,7 +27,7 @@ function createFeishuCardInteractionEnvelope(envelope) {
 }
 function buildFeishuCardActionTextFallback(event) {
 	const actionValue = event.action.value;
-	if (isRecord$1(actionValue)) {
+	if (isRecord(actionValue)) {
 		if (typeof actionValue.text === "string") return actionValue.text;
 		if (typeof actionValue.command === "string") return actionValue.command;
 		return JSON.stringify(actionValue);
@@ -37,7 +37,7 @@ function buildFeishuCardActionTextFallback(event) {
 function decodeFeishuCardAction(params) {
 	const { event, now = Date.now() } = params;
 	const actionValue = event.action.value;
-	if (!isRecord$1(actionValue) || actionValue.oc !== "ocf1") return {
+	if (!isRecord(actionValue) || actionValue.oc !== "ocf1") return {
 		kind: "legacy",
 		text: buildFeishuCardActionTextFallback(event)
 	};
@@ -50,7 +50,7 @@ function decodeFeishuCardAction(params) {
 		reason: "malformed"
 	};
 	if (actionValue.m !== void 0) {
-		if (!isRecord$1(actionValue.m)) return {
+		if (!isRecord(actionValue.m)) return {
 			kind: "invalid",
 			reason: "malformed"
 		};
@@ -60,7 +60,7 @@ function decodeFeishuCardAction(params) {
 		};
 	}
 	if (actionValue.c !== void 0) {
-		if (!isRecord$1(actionValue.c)) return {
+		if (!isRecord(actionValue.c)) return {
 			kind: "invalid",
 			reason: "malformed"
 		};
@@ -197,6 +197,7 @@ async function resolveFeishuDmIngressAccess(params) {
 			kind: "direct",
 			id: params.conversationId
 		},
+		...params.contextBinding ? { contextBinding: params.contextBinding } : {},
 		event: { mayPair: params.mayPair },
 		dmPolicy: normalizeFeishuDmPolicy(params.dmPolicy),
 		groupPolicy: "disabled",
@@ -214,8 +215,10 @@ async function resolveFeishuGroupConversationIngressAccess(params) {
 		subject: createFeishuIngressSubject({ primaryId: params.chatId }),
 		conversation: {
 			kind: "group",
-			id: params.chatId
+			id: params.chatId,
+			threadId: params.threadId
 		},
+		...params.contextBinding ? { contextBinding: params.contextBinding } : {},
 		dmPolicy: "disabled",
 		groupPolicy,
 		groupAllowFrom
@@ -233,8 +236,10 @@ async function resolveFeishuGroupSenderActivationIngressAccess(params) {
 		}),
 		conversation: {
 			kind: "group",
-			id: params.chatId
+			id: params.chatId,
+			threadId: params.threadId
 		},
+		...params.contextBinding ? { contextBinding: params.contextBinding } : {},
 		dmPolicy: "disabled",
 		groupPolicy: groupAllowFrom.length > 0 ? "allowlist" : "open",
 		groupAllowFrom,
@@ -754,8 +759,12 @@ function createFeishuSendReceipt(params) {
 function assertFeishuMessageApiSuccess(response, errorPrefix) {
 	if (response.code !== 0) throw new Error(`${errorPrefix}: ${response.msg || `code ${response.code}`}`);
 }
-function toFeishuSendResult(response, chatId, kind) {
-	const messageId = response.data?.message_id ?? "unknown";
+function toFeishuSendResult(response, chatId, kind, errorPrefix = "Feishu send failed") {
+	const messageId = response.data?.message_id?.trim();
+	if (!messageId) throw createChannelPartialDeliveryError(/* @__PURE__ */ new Error(`${errorPrefix}: no message_id returned`), {
+		messageIds: [],
+		visibleReplySent: true
+	});
 	return {
 		messageId,
 		chatId,

package/dist/session-binding-contract-api.js

@@ -1,2 +1,2 @@
-import { r as testing, t as createFeishuThreadBindingManager } from "./thread-bindings-N3wkgkIN.js";
+import { r as testing, t as createFeishuThreadBindingManager } from "./thread-bindings-Itvfmx6_.js";
 export { createFeishuThreadBindingManager, testing as feishuThreadBindingTesting };

package/dist/{session-conversation-BksWrfzm.js → session-conversation-DFCIvQK-.js}

@@ -1,4 +1,4 @@
-import { r as parseFeishuConversationId, t as buildFeishuConversationId } from "./conversation-id-BeJL-wq7.js";
+import { r as parseFeishuConversationId, t as buildFeishuConversationId } from "./conversation-id-VYgGQ-GX.js";
 //#region extensions/feishu/src/session-conversation.ts
 function resolveFeishuParentConversationCandidates(rawId) {
 	const parsed = parseFeishuConversationId({ conversationId: rawId });

package/dist/session-key-api.js

@@ -1,2 +1,2 @@
-import { t as resolveFeishuSessionConversation } from "./session-conversation-BksWrfzm.js";
+import { t as resolveFeishuSessionConversation } from "./session-conversation-DFCIvQK-.js";
 export { resolveFeishuSessionConversation as resolveSessionConversation };

package/dist/setup-api.js

@@ -1,2 +1,2 @@
-import { i as feishuSetupAdapter, n as feishuSetupWizard, t as feishuPlugin } from "./channel-CScE82zY.js";
+import { i as feishuSetupAdapter, n as feishuSetupWizard, t as feishuPlugin } from "./channel-Dzb5jv3i.js";
 export { feishuPlugin, feishuSetupAdapter, feishuSetupWizard };

package/dist/{subagent-hooks-Cx1cX7rW.js → subagent-hooks-B867acTt.js}

@@ -1,7 +1,7 @@
 import { t as __exportAll } from "./rolldown-runtime-8H4AJuhK.js";
 import { r as normalizeFeishuTarget } from "./targets-BUjQ1TcA.js";
-import { r as parseFeishuConversationId, t as buildFeishuConversationId } from "./conversation-id-BeJL-wq7.js";
-import { n as getFeishuThreadBindingManager } from "./thread-bindings-N3wkgkIN.js";
+import { r as parseFeishuConversationId, t as buildFeishuConversationId } from "./conversation-id-VYgGQ-GX.js";
+import { n as getFeishuThreadBindingManager } from "./thread-bindings-Itvfmx6_.js";
 import { normalizeOptionalLowercaseString, normalizeOptionalString } from "openclaw/plugin-sdk/string-coerce-runtime";
 //#region extensions/feishu/src/subagent-hooks.ts
 var subagent_hooks_exports = /* @__PURE__ */ __exportAll({

package/dist/subagent-hooks-api.js

@@ -1,6 +1,6 @@
 import { createLazyRuntimeModule } from "openclaw/plugin-sdk/lazy-runtime";
 //#region extensions/feishu/subagent-hooks-api.ts
-const loadFeishuSubagentHooksModule = createLazyRuntimeModule(() => import("./subagent-hooks-Cx1cX7rW.js").then((n) => n.i));
+const loadFeishuSubagentHooksModule = createLazyRuntimeModule(() => import("./subagent-hooks-B867acTt.js").then((n) => n.i));
 function registerFeishuSubagentHooks(api) {
 	api.on("subagent_delivery_target", async (event) => {
 		const { handleFeishuSubagentDeliveryTarget } = await loadFeishuSubagentHooksModule();

package/dist/{thread-bindings-N3wkgkIN.js → thread-bindings-Itvfmx6_.js}

@@ -1,8 +1,8 @@
 import { registerSessionBindingAdapter, resolveThreadBindingConversationIdFromBindingId, resolveThreadBindingIdleTimeoutMsForChannel, resolveThreadBindingMaxAgeMsForChannel, unregisterSessionBindingAdapter } from "openclaw/plugin-sdk/conversation-runtime";
 import { isFutureDateTimestampMs } from "openclaw/plugin-sdk/number-runtime";
 import { normalizeOptionalString } from "openclaw/plugin-sdk/string-coerce-runtime";
-import { normalizeAccountId, resolveAgentIdFromSessionKey } from "openclaw/plugin-sdk/routing";
-import { resolveDefaultAgentId } from "openclaw/plugin-sdk/agent-runtime";
+import { normalizeAccountId } from "openclaw/plugin-sdk/routing";
+import { resolveSessionAgentId } from "openclaw/plugin-sdk/agent-scope-runtime";
 //#region extensions/feishu/src/thread-bindings.ts
 const FEISHU_THREAD_BINDINGS_STATE_KEY = Symbol.for("openclaw.feishuThreadBindingsState");
 let state;
@@ -107,7 +107,10 @@ function createFeishuThreadBindingManager(params) {
 				deliveryThreadId: typeof metadata?.deliveryThreadId === "string" && metadata.deliveryThreadId.trim() ? metadata.deliveryThreadId.trim() : existingLocal?.deliveryThreadId,
 				targetKind: toFeishuTargetKind(targetKind),
 				targetSessionKey: normalizedTargetSessionKey,
-				agentId: typeof metadata?.agentId === "string" && metadata.agentId.trim() ? metadata.agentId.trim() : existingLocal?.agentId ?? resolveAgentIdFromSessionKey(normalizedTargetSessionKey, resolveDefaultAgentId(params.cfg)),
+				agentId: normalizeOptionalString(metadata?.agentId) ?? existingLocal?.agentId ?? resolveSessionAgentId({
+					config: params.cfg,
+					sessionKey: normalizedTargetSessionKey
+				}),
 				label: typeof metadata?.label === "string" && metadata.label.trim() ? metadata.label.trim() : existingLocal?.label,
 				boundBy: typeof metadata?.boundBy === "string" && metadata.boundBy.trim() ? metadata.boundBy.trim() : existingLocal?.boundBy,
 				boundAt: now,

package/openclaw.plugin.json

@@ -1,5 +1,8 @@
 {
   "id": "feishu",
+  "doctorContract": {
+    "configRepair": true
+  },
   "name": "Feishu/Lark",
   "description": "OpenClaw Feishu/Lark channel plugin for chats and workplace tools (community maintained by @m1heng).",
   "activation": {
@@ -310,7 +313,8 @@
             "enum": [
               "env",
               "file",
-              "exec"
+              "exec",
+              "store"
             ]
           },
           "provider": {
@@ -580,6 +584,29 @@
                     ],
                     "additionalProperties": false
                   },
+                  {
+                    "type": "object",
+                    "properties": {
+                      "source": {
+                        "type": "string",
+                        "const": "store"
+                      },
+                      "provider": {
+                        "type": "string",
+                        "pattern": "^[a-z][a-z0-9_-]{0,63}$"
+                      },
+                      "id": {
+                        "type": "string",
+                        "pattern": "^[A-Z][A-Z0-9_]{0,127}$"
+                      }
+                    },
+                    "required": [
+                      "source",
+                      "provider",
+                      "id"
+                    ],
+                    "additionalProperties": false
+                  },
                   {
                     "type": "object",
                     "properties": {
@@ -658,6 +685,29 @@
                     ],
                     "additionalProperties": false
                   },
+                  {
+                    "type": "object",
+                    "properties": {
+                      "source": {
+                        "type": "string",
+                        "const": "store"
+                      },
+                      "provider": {
+                        "type": "string",
+                        "pattern": "^[a-z][a-z0-9_-]{0,63}$"
+                      },
+                      "id": {
+                        "type": "string",
+                        "pattern": "^[A-Z][A-Z0-9_]{0,127}$"
+                      }
+                    },
+                    "required": [
+                      "source",
+                      "provider",
+                      "id"
+                    ],
+                    "additionalProperties": false
+                  },
                   {
                     "type": "object",
                     "properties": {
@@ -736,6 +786,29 @@
                     ],
                     "additionalProperties": false
                   },
+                  {
+                    "type": "object",
+                    "properties": {
+                      "source": {
+                        "type": "string",
+                        "const": "store"
+                      },
+                      "provider": {
+                        "type": "string",
+                        "pattern": "^[a-z][a-z0-9_-]{0,63}$"
+                      },
+                      "id": {
+                        "type": "string",
+                        "pattern": "^[A-Z][A-Z0-9_]{0,127}$"
+                      }
+                    },
+                    "required": [
+                      "source",
+                      "provider",
+                      "id"
+                    ],
+                    "additionalProperties": false
+                  },
                   {
                     "type": "object",
                     "properties": {
@@ -1348,6 +1421,29 @@
                           ],
                           "additionalProperties": false
                         },
+                        {
+                          "type": "object",
+                          "properties": {
+                            "source": {
+                              "type": "string",
+                              "const": "store"
+                            },
+                            "provider": {
+                              "type": "string",
+                              "pattern": "^[a-z][a-z0-9_-]{0,63}$"
+                            },
+                            "id": {
+                              "type": "string",
+                              "pattern": "^[A-Z][A-Z0-9_]{0,127}$"
+                            }
+                          },
+                          "required": [
+                            "source",
+                            "provider",
+                            "id"
+                          ],
+                          "additionalProperties": false
+                        },
                         {
                           "type": "object",
                           "properties": {
@@ -1426,6 +1522,29 @@
                           ],
                           "additionalProperties": false
                         },
+                        {
+                          "type": "object",
+                          "properties": {
+                            "source": {
+                              "type": "string",
+                              "const": "store"
+                            },
+                            "provider": {
+                              "type": "string",
+                              "pattern": "^[a-z][a-z0-9_-]{0,63}$"
+                            },
+                            "id": {
+                              "type": "string",
+                              "pattern": "^[A-Z][A-Z0-9_]{0,127}$"
+                            }
+                          },
+                          "required": [
+                            "source",
+                            "provider",
+                            "id"
+                          ],
+                          "additionalProperties": false
+                        },
                         {
                           "type": "object",
                           "properties": {
@@ -1504,6 +1623,29 @@
                           ],
                           "additionalProperties": false
                         },
+                        {
+                          "type": "object",
+                          "properties": {
+                            "source": {
+                              "type": "string",
+                              "const": "store"
+                            },
+                            "provider": {
+                              "type": "string",
+                              "pattern": "^[a-z][a-z0-9_-]{0,63}$"
+                            },
+                            "id": {
+                              "type": "string",
+                              "pattern": "^[A-Z][A-Z0-9_]{0,127}$"
+                            }
+                          },
+                          "required": [
+                            "source",
+                            "provider",
+                            "id"
+                          ],
+                          "additionalProperties": false
+                        },
                         {
                           "type": "object",
                           "properties": {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@openclaw/feishu",
-  "version": "2026.7.2-beta.7",
+  "version": "2026.8.1-beta.2",
   "description": "OpenClaw Feishu/Lark channel plugin for chats and workplace tools (community maintained by @m1heng).",
   "repository": {
     "type": "git",
@@ -16,7 +16,7 @@
     "zod": "4.4.3"
   },
   "peerDependencies": {
-    "openclaw": ">=2026.7.2-beta.7"
+    "openclaw": ">=2026.8.1-beta.2"
   },
   "peerDependenciesMeta": {
     "openclaw": {
@@ -60,10 +60,10 @@
       "minHostVersion": ">=2026.5.29"
     },
     "compat": {
-      "pluginApi": ">=2026.7.2-beta.7"
+      "pluginApi": ">=2026.8.1-beta.2"
     },
     "build": {
-      "openclawVersion": "2026.7.2-beta.7"
+      "openclawVersion": "2026.8.1-beta.2"
     },
     "release": {
       "publishToClawHub": true,

package/skills/feishu-doc/SKILL.md

@@ -1,215 +1,40 @@
 ---
 name: feishu-doc
 description: |
-  Feishu document read/write operations. Activate when user mentions Feishu docs, cloud docs, or docx links.
+  Feishu document read/write workflows. Activate when the user mentions Feishu docs, cloud docs, or docx links.
 ---
 
-# Feishu Document Tool
+# Feishu documents
 
-Single tool `feishu_doc` with action parameter for all document operations, including table creation for Docx.
+Use the single `feishu_doc` tool. Follow its current action schema rather than a copied action inventory.
 
-## Token Extraction
+From `https://example.feishu.cn/docx/ABC123def`, use `ABC123def` as `doc_token`.
 
-From URL `https://xxx.feishu.cn/docx/ABC123def` → `doc_token` = `ABC123def`
+## Read and edit
 
-## Actions
+1. Start with `read` for plain text and block statistics.
+2. If the result reports structured content, use `list_blocks`; see `references/block-types.md` for block meanings.
+3. Use `update_block` or `delete_block` for one known block. Use `insert` with `after_block_id` to place new Markdown after a known block.
+4. Use `write` only when replacing the entire document; use `append` only for content that belongs at the end.
 
-### Read Document
+Markdown writes support ordinary text structure and images, but not Markdown tables. For tables, use the explicit table actions exposed by the tool. Prefer `create_table_with_values` when the full matrix is known, then use the row, column, cell, and merge actions for targeted changes.
 
-```json
-{ "action": "read", "doc_token": "ABC123def" }
-```
-
-Returns: title, plain text content, block statistics. Check `hint` field - if present, structured content (tables, images) exists that requires `list_blocks`.
-
-### Write Document (Replace All)
-
-```json
-{ "action": "write", "doc_token": "ABC123def", "content": "# Title\n\nMarkdown content..." }
-```
-
-Replaces entire document with markdown content. Supports: headings, lists, code blocks, quotes, links, images (`![](url)` auto-uploaded), bold/italic/strikethrough.
-
-**Limitation:** Markdown tables are NOT supported.
-
-### Append Content
-
-```json
-{ "action": "append", "doc_token": "ABC123def", "content": "Additional content" }
-```
-
-Appends markdown to end of document.
-
-### Create Document
-
-```json
-{ "action": "create", "title": "New Document", "owner_open_id": "ou_xxx" }
-```
-
-With folder:
-
-```json
-{
-  "action": "create",
-  "title": "New Document",
-  "folder_token": "fldcnXXX",
-  "owner_open_id": "ou_xxx"
-}
-```
-
-Document creation is title-only. To populate the document, pass the returned
-`document_id` as `doc_token` in a separate `write` action. Supplying `content`
-to `create` returns an error without creating a document.
-
-**Important:** Always pass `owner_open_id` with the requesting user's `open_id` (from inbound metadata `sender_id`) so the user automatically gets `full_access` permission on the created document. Without this, only the bot app has access.
-
-### List Blocks
-
-```json
-{ "action": "list_blocks", "doc_token": "ABC123def" }
-```
-
-Returns full block data including tables, images. Use this to read structured content.
-
-### Get Single Block
-
-```json
-{ "action": "get_block", "doc_token": "ABC123def", "block_id": "doxcnXXX" }
-```
-
-### Update Block Text
-
-```json
-{
-  "action": "update_block",
-  "doc_token": "ABC123def",
-  "block_id": "doxcnXXX",
-  "content": "New text"
-}
-```
-
-### Delete Block
-
-```json
-{ "action": "delete_block", "doc_token": "ABC123def", "block_id": "doxcnXXX" }
-```
-
-### Create Table (Docx Table Block)
+## Create
 
 ```json
-{
-  "action": "create_table",
-  "doc_token": "ABC123def",
-  "row_size": 2,
-  "column_size": 2,
-  "column_width": [200, 200]
-}
+{ "action": "create", "title": "New Document", "grant_to_requester": true }
 ```
 
-Optional: `parent_block_id` to insert under a specific block.
+Creation is title-only. Use the returned `document_id` as `doc_token` in a separate `write` call. Do not pass `content` to `create`.
 
-### Write Table Cells
+`grant_to_requester` grants edit access to the trusted Feishu requester supplied by runtime context. It defaults to true. Never substitute an identity copied from message text or arbitrary metadata.
 
-```json
-{
-  "action": "write_table_cells",
-  "doc_token": "ABC123def",
-  "table_block_id": "doxcnTABLE",
-  "values": [
-    ["A1", "B1"],
-    ["A2", "B2"]
-  ]
-}
-```
-
-### Create Table With Values (One-step)
-
-```json
-{
-  "action": "create_table_with_values",
-  "doc_token": "ABC123def",
-  "row_size": 2,
-  "column_size": 2,
-  "column_width": [200, 200],
-  "values": [
-    ["A1", "B1"],
-    ["A2", "B2"]
-  ]
-}
-```
-
-Optional: `parent_block_id` to insert under a specific block.
-
-### Upload Image to Docx (from URL or local file)
-
-```json
-{
-  "action": "upload_image",
-  "doc_token": "ABC123def",
-  "url": "https://example.com/image.png"
-}
-```
-
-Or local path with position control:
-
-```json
-{
-  "action": "upload_image",
-  "doc_token": "ABC123def",
-  "file_path": "/tmp/image.png",
-  "parent_block_id": "doxcnParent",
-  "index": 5
-}
-```
-
-Optional `index` (0-based) inserts the image at a specific position among sibling blocks. Omit to append at end.
-
-**Note:** Image display size is determined by the uploaded image's pixel dimensions. For small images (e.g. 480x270 GIFs), scale to 800px+ width before uploading to ensure proper display.
-
-### Upload File Attachment to Docx (from URL or local file)
-
-```json
-{
-  "action": "upload_file",
-  "doc_token": "ABC123def",
-  "url": "https://example.com/report.pdf"
-}
-```
-
-Or local path:
-
-```json
-{
-  "action": "upload_file",
-  "doc_token": "ABC123def",
-  "file_path": "/tmp/report.pdf",
-  "filename": "Q1-report.pdf"
-}
-```
-
-Rules:
-
-- exactly one of `url` / `file_path`
-- optional `filename` override
-- optional `parent_block_id`
-
-## Reading Workflow
-
-1. Start with `action: "read"` - get plain text + statistics
-2. Check `block_types` in response for Table, Image, Code, etc.
-3. If structured content exists, use `action: "list_blocks"` for full data
-
-## Configuration
-
-```yaml
-channels:
-  feishu:
-    tools:
-      doc: true # default: true
-```
+## Media
 
-**Note:** `feishu_wiki` depends on this tool - wiki page content is read/written via `feishu_doc`.
+Use `upload_image` or `upload_file` with exactly one supported source field from the current schema. Pass `parent_block_id` and `index` only when placement matters. Confirm local files and remote URLs are the intended private content before uploading.
 
-## Permissions
+## Safety
 
-Required: `docx:document`, `docx:document:readonly`, `docx:document.block:convert`, `drive:drive`
+- Resolve exact document and block IDs before destructive edits.
+- Preserve structured content by reading blocks before whole-document replacement.
+- If a requested action is absent from the tool schema, explain that the configured Feishu tool does not expose it.