DEV Community

邱敬幃 Pardn Chiu
邱敬幃 Pardn Chiu

Posted on

Agenvoy@v0.16.0: Introduced script tool as a first-class tool subsystem

#go #ai #openclaw #pardnchiu

cover
repo: pardnchiu/Agenvoy

Agenvoy is inspired by OpenClaw, built on a Go-based architecture with multi-provider intelligent dispatch and a security-first design.

v0.15.2 -> v0.16.0

Summary

Introduced script tool as a first-class tool subsystem, allowing agents to discover and execute local JavaScript and Python scripts via a stdin/stdout JSON protocol — mirroring the existing API tool architecture. Also refactored internal package structure and fixed Discord file upload reliability.

翻譯
新增 script tool 子系統，讓 agent 可自動發現並執行本地 JavaScript 與 Python 腳本（stdin/stdout JSON 協定），架構與現有 API tool 對稱。同時重構內部套件結構，並修正 Discord 上傳問題。

Changes

FEAT

  • Script Tool Runtime — Add internal/scriptAdapter package mirroring internal/apiAdapter. On startup, the executor scans ~/.config/agenvoy/script_tools/ and <workdir>/.config/agenvoy/script_tools/ for subdirectories containing a tool.json manifest (name, description, parameters schema) and an executable script.js or script.py. Discovered tools are registered as first-class agent tools with the script_ prefix and dispatched via stdin/stdout JSON, identical to the API tool contract.
  • Add git tools for skill management (skill_git_commit, skill_git_log, skill_git_rollback)
  • Add Copilot token auto-relogin on 401 during token refresh

翻譯

  • Script Tool 執行環境 — 新增 internal/scriptAdapter，架構與 internal/apiAdapter 對稱。啟動時掃描 ~/.config/agenvoy/script_tools/ 與 /.config/agenvoy/script_tools/，自動載入包含 tool.json（name、description、parameters）與 script.js/script.py 的子目錄。已發現的工具以 script_ 前綴註冊為一等工具，透過 stdin/stdout JSON 協定執行，與 API tool 完全一致。
  • 新增 skill 管理用 git 工具（commit、log、rollback）
  • 新增 Copilot token 401 時自動重新登入

FIX

  • Fix Discord file upload failure caused by non-ASCII filenames (Japanese, special chars) in multipart upload
  • Fix system message ordering and multi-system-prompt merging for Nvidia provider

翻譯

  • 修正 Discord 上傳含日文等非 ASCII 字元檔名時 multipart 上傳失敗的問題
  • 修正 Nvidia provider 的 system message 排序與多 prompt 合併邏輯

UPDATE

  • Add file size validation (10MB limit) before Discord upload with user-facing warning
  • Update default download path to prefer ~/Downloads over ~/.config/agenvoy/download

翻譯

  • 新增 Discord 上傳前檔案大小驗證（10MB 限制），超限時向用戶回報警告
  • 預設下載路徑改為優先使用 ~/Downloads

REFACTOR

  • Rename internal/tools/apis/adapter → internal/apiAdapter and internal/tools/apis → internal/tools/api for consistent naming alongside the new scriptAdapter

翻譯

  • 重命名 internal/tools/apis/adapter → internal/apiAdapter，internal/tools/apis → internal/tools/api，與新增的 scriptAdapter 形成對稱命名

ADD

  • Add script-tool-creator skill with Python initializer to scaffold new script tools
  • Add yt-dlp downloader and info query as example script tools

翻譯

  • 新增 script-tool-creator skill 及 Python 腳手架腳本，快速建立新 script tool
  • 新增 yt-dlp 下載與資訊查詢作為 script tool 使用範例

Files Changed

File Status Tag
internal/scriptAdapter/ececute.go Added FEAT
internal/scriptAdapter/translator.go Added FEAT
internal/tools/executor.go Modified FEAT
internal/tools/types/executor.go Modified FEAT
internal/tools/git/skillCommit.go Added FEAT
internal/tools/git/skillLog.go Added FEAT
internal/tools/git/skillRollback.go Added FEAT
internal/tools/git/register.go Added FEAT
internal/agents/provider/copilot/refresh.go Modified FEAT
internal/discord/reply.go Modified FIX
internal/agents/provider/nvidia/send.go Modified FIX
internal/filesystem/filesystem.go Modified UPDATE
internal/tools/browser/download.go Modified UPDATE
internal/tools/browser/register.go Modified UPDATE
internal/tools/file/writeFile.go Modified UPDATE
internal/apiAdapter/ (from tools/apis/adapter) Renamed REFACTOR
internal/tools/api/ (from tools/apis) Renamed REFACTOR
internal/tools/register.go Modified REFACTOR
extensions/skills/script-tool-creator/SKILL.md Added ADD
extensions/skills/script-tool-creator/scripts/init_script_tool.py Added ADD
extensions/scripts/example-yt-dlp-downloader/ Added ADD
extensions/scripts/example-yt-dlp-info/ Added ADD
internal/filesystem/git.go Added FEAT
configs/prompts/system_prompt.md Modified UPDATE
go.mod Modified CHORE

©️ 2026 邱敬幃 Pardn Chiu

Top comments (0)