v0.28.20 Release Notes - Agenvoy Docs

v0.28.19 -> v0.28.20

Summary

File interaction gains a batched workflow and clearer edit feedback. The runtime also adds safer command gating and a steerable TUI execution flow.

翻譯

檔案操作支援批次工作流程並提供更清楚的編輯回饋。執行環境也加強命令確認，並讓 TUI 執行流程可以中途調整。

⚠️ Breaking Changes

File tool interface changed

The single-file read tool was replaced by the batched read interface, and file listing/globbing/search arguments and results were expanded. Integrations that call the old tool name or payload shape must migrate to the new batched interfaces and updated schemas.

Migration:

Replace calls to read_file with read_files.
Send the new files collection and update consumers for batched results.
Update list_files and glob_files callers to the revised argument and result structures.
Replace single-pattern search_files arguments with the batched queries array; drop the old single-pattern fields.

翻譯

單檔讀取工具已改為批次讀取介面，檔案列舉、glob 與內容搜尋的參數及結果也已擴充。呼叫舊工具名稱或舊 payload 格式的整合程式，必須遷移至新的批次介面與 schema。

遷移方式：

將 read_file 呼叫改為 read_files。
傳入新的 files 集合，並更新批次結果處理邏輯。
依新版參數與結果結構更新 list_files 與 glob_files 呼叫端。
將 search_files 的單一 pattern 參數改為批次 queries 陣列，並移除舊的單一 pattern 欄位。

Changes

BREAKING

Replace the single-file read tool with batched read_files support and expand file listing/globbing payloads (@pardnchiu) [58e0992]
Extend batched file tools with patch row numbers and multi-edit support (@pardnchiu) [3e8bcde]
Batch search_files via a queries array and drop single-pattern arguments (@pardnchiu) [2425314]

翻譯

以批次 read_files 支援取代單檔讀取工具，並擴充檔案列舉與 glob payload
為批次檔案工具加入 patch 行號與多段編輯支援
將 search_files 改為透過 queries 陣列批次查詢，並移除單一 pattern 參數

FEAT

Add a mid-run steer queue and cancel confirmation to the TUI (@pardnchiu) [a168dec]
Skip confirmation for read-only commands and clear pending state on cancellation (@pardnchiu) [2feb014]

翻譯

為 TUI 新增執行中 steer queue 與取消確認
唯讀命令跳過確認，並在取消時清除 pending 狀態

Scope

internal/tools/file/ — BREAKING (globFiles.go, listFiles.go, patchFile.go, readFiles.go, searchFiles.go, register.go, writeFile.go)
internal/runtime/tui/ — FEAT (commandRemoveSession.go, handlerExec.go, handlerPopup.go, handlerLogFormat.go, helper.go, init.go, renderWait.go, update.go, view.go, viewRender.go)
internal/agents/exec/ — FEAT, BREAKING (execute.go, reset.go, skillImprove.go, steerWait.go, toolCall.go)
configs/ — FEAT, BREAKING (configs.go, jsons/white_command.json, prompts/)
extensions/skills/readme-generate/ — BREAKING (SKILL.md, scripts/examples/doc-cli.md)
internal/utils/ — BREAKING (event.go, utils.go)
internal/session/log/ — FEAT (format.go, replay.go)
internal/filesystem/ — FEAT (runtime.go)

Generated by SKILL