# v0.18.2 Release Notes

> v0.18.1 -> v0.18.2

## Summary

Improve tool-call reliability by correctly handling stub tools and streamed function-call arguments, while tightening absolute-path guidance and file path resolution across prompts, schemas, and filesystem helpers.
<details>
<summary>翻譯</summary>
改善工具呼叫穩定性，正確處理 stub 工具與串流函式參數，同時在提示詞、工具 schema 與檔案系統輔助邏輯中強化絕對路徑指引與路徑解析。
</details>

## Changes

### FEAT
- Add TUI input mode toggle to switch between command execution and agent message mode with the Tab key.

<details>
<summary>翻譯</summary>

- 新增 TUI 輸入模式切換，可透過 Tab 鍵在命令執行與 agent 訊息模式間切換。

</details>

### FIX
- Handle stub tools by auto-loading their schemas through `search_tools` before re-invoking the tool with real arguments.
- Validate required tool arguments from tool schemas instead of hardcoded per-tool rules, including better invalid-JSON and missing-field errors.
- Reconstruct streamed function-call arguments from Codex SSE events so tool calls complete with the correct payload.
- Allow user-home root paths in absolute path resolution instead of rejecting the home directory itself.
- Run skill synchronization inline during app startup instead of dispatching it asynchronously.

<details>
<summary>翻譯</summary>

- 透過 `search_tools` 自動載入 stub 工具 schema，之後再以實際參數重新呼叫工具。
- 改為從工具 schema 驗證必要參數，不再使用硬編碼規則，並補強無效 JSON 與缺欄位錯誤訊息。
- 從 Codex SSE 事件重建串流函式呼叫參數，確保工具呼叫能以正確 payload 完成。
- 在絕對路徑解析中允許使用者家目錄根路徑，而不再把 home 目錄本身誤判為非法。
- 啟動 app 時改為同步執行 skill 同步流程，而非非同步派發。

</details>

### UPDATE
- Clarify that file tools prefer absolute paths and that relative paths resolve against the work directory across system prompts and skill execution prompts.
- Add a dedicated prior-summary context prompt to mark summary content as reference-only and non-repeatable in replies.
- Expand `glob_files` to support `~`, absolute-path patterns, direct file matches without glob metacharacters, and faster matching when `**` is not used.
- Update the skill-creator skill instructions to use explicit `python3 scripts/init_skill.py` commands.

<details>
<summary>翻譯</summary>

- 在 system prompt 與 skill execution prompt 中明確說明檔案工具優先使用絕對路徑，且相對路徑會以工作目錄為基準解析。
- 新增 prior-summary context prompt，明確標示摘要內容僅供參考，且不可在回覆中重述。
- 擴充 `glob_files`，支援 `~`、絕對路徑 pattern、無 glob 字元時的直接檔案比對，以及未使用 `**` 時的更快匹配路徑。
- 更新 skill-creator 指令，改用明確的 `python3 scripts/init_skill.py` 指令格式。

</details>

***

## Files Changed

| File | Status | Tag |
|------|--------|-----|
| `cmd/app/main.go` | Modified | FIX |
| `configs/prompts/skill_execution.md` | Modified | UPDATE |
| `configs/prompts/summary_context.md` | Added | UPDATE |
| `configs/prompts/system_prompt.md` | Modified | UPDATE |
| `extensions/skills/skill-creator/SKILL.md` | Modified | UPDATE |
| `internal/agents/exec/toolCall.go` | Modified | FIX |
| `internal/agents/provider/openaiCodex/send.go` | Modified | FIX |
| `internal/filesystem/absPath.go` | Modified | FIX |
| `internal/session/summary.go` | Modified | CHORE |
| `internal/tools/file/globFiles.go` | Modified | UPDATE |
| `internal/tools/file/listFiles.go` | Modified | CHORE |
| `internal/tools/file/patchEdit.go` | Modified | CHORE |
| `internal/tools/file/readFile.go` | Modified | CHORE |
| `internal/tools/file/readImage.go` | Modified | CHORE |
| `internal/tools/file/writeFile.go` | Modified | CHORE |
| `internal/tui/commandMode.go` | Modified | FEAT |
| `internal/tui/globalShortcut.go` | Modified | FEAT |
| `internal/tui/new.go` | Modified | FEAT |

***

Generated by [SKILL](https://github.com/pardnchiu/skill-version-generate)