From 6892156b7cbdfd7812b387bc9d9656792687ba27 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?=E5=85=AC=E6=98=8E?=
 <83812544+Ed1s0nZ@users.noreply.github.com>
Date: Wed, 22 Jul 2026 13:36:39 +0800
Subject: [PATCH] Add files via upload

---
 docs/en-US/tool-execution-governance.md | 9 +++++++++
 docs/zh-CN/tool-execution-governance.md | 9 +++++++++
 2 files changed, 18 insertions(+)

diff --git a/docs/en-US/tool-execution-governance.md b/docs/en-US/tool-execution-governance.md
index ad8d2ba7..5ca06b80 100644
--- a/docs/en-US/tool-execution-governance.md
+++ b/docs/en-US/tool-execution-governance.md
@@ -51,6 +51,13 @@ Important: when `wait_tool_execution` reaches `timeout_seconds` and the target e
 | `wait_tool_execution` | Wait for a selected execution for a bounded interval |
 | `cancel_tool_execution` | Cancel a selected execution |
 
+`get_tool_execution` and `wait_tool_execution` can include a live output preview:
+
+- `include_partial_output`: whether to return partial output, default `true`.
+- `partial_output_max_bytes`: tail preview limit for this call, default `4096`, maximum `65536`.
+
+Partial output is a bounded preview of output produced so far, not the final `result`. The canonical `result` is still written only when the tool finishes. Tools that do not support streaming output simply omit partial fields.
+
 Typical flow:
 
 ```text
@@ -60,6 +67,8 @@ Typical flow:
 4. If still incomplete, continue waiting or call cancel_tool_execution
 ```
 
+`tool_wait_timeout_seconds` applies to internal MCP tools, external MCP tools, and Eino filesystem's streaming `execute`. Eino's non-streaming filesystem tools such as `ls/read_file/write_file/edit_file/glob/grep` are recorded in execution monitoring, but they are not converted into resumable background workers.
+
 ## Cancellation and Session Cleanup
 
 - User stop cancels running tools for the current conversation.
diff --git a/docs/zh-CN/tool-execution-governance.md b/docs/zh-CN/tool-execution-governance.md
index d2815fdf..71a99765 100644
--- a/docs/zh-CN/tool-execution-governance.md
+++ b/docs/zh-CN/tool-execution-governance.md
@@ -51,6 +51,13 @@ Agent 调用工具
 | `wait_tool_execution` | 等待指定 execution 一段时间 |
 | `cancel_tool_execution` | 主动取消指定 execution |
 
+`get_tool_execution` 与 `wait_tool_execution` 支持返回运行中输出预览：
+
+- `include_partial_output`：是否返回 partial output，默认 `true`。
+- `partial_output_max_bytes`：本次返回的尾部预览上限，默认 `4096`，最大 `65536`。
+
+partial output 是“已产生输出的有界预览”，不等同于最终 `result`。最终 `result` 仍只在工具结束时写入 canonical execution 记录；不支持流式输出的工具不会返回 partial 字段。
+
 典型流程：
 
 ```text
@@ -60,6 +67,8 @@ Agent 调用工具
 4. 仍未完成时可继续等待，或调用 cancel_tool_execution
 ```
 
+`tool_wait_timeout_seconds` 适用于内部 MCP、外部 MCP，以及 Eino filesystem 的流式 `execute`。Eino 的 `ls/read_file/write_file/edit_file/glob/grep` 等非流式 filesystem 工具会写入 execution 监控记录，但不作为后台 worker 做软等待续跑。
+
 ## 取消和会话清理
 
 - 用户点击“停止任务”时，会取消当前会话仍在运行的工具。