Skip to content

Commit db0a0b6

Browse files
committed
Refactor ACE tools to unify under 'ace-search' and update documentation
- Updated tool descriptions and usage in various prompts to reflect the new unified 'ace-search' tool. - Removed individual ACE tool references (e.g., ace-find_definition, ace-find_references) and replaced them with 'ace-search' that supports multiple actions. - Adjusted code handling in ToolResultPreview and MCP tool execution to accommodate the new unified structure. - Enhanced comments and documentation for clarity on tool functionalities and usage.
1 parent 2133a9b commit db0a0b6

23 files changed

Lines changed: 1513 additions & 1593 deletions

docs/usage/en/05.Sub-Agent Configuration.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -161,7 +161,7 @@ You can create custom sub-agents through the configuration interface to meet spe
161161
- Press Space to select/deselect tools
162162
- Tool categories include:
163163
- Filesystem tools (filesystem-read, filesystem-create, filesystem-edit, etc.)
164-
- ACE code search tools (ace-find_definition, ace-semantic_search, etc.)
164+
- ACE code search tool (`ace-search` with action: find_definition / find_references / semantic_search / file_outline / text_search)
165165
- Codebase tools (codebase-search)
166166
- Terminal tools (terminal-execute)
167167
- TODO management tools

docs/usage/en/17.LSP Configuration.md

Lines changed: 6 additions & 6 deletions
Original file line numberDiff line numberDiff line change
@@ -18,8 +18,8 @@ Snow CLI will try to use LSP first for certain code-search capabilities. If LSP
1818

1919
Currently, LSP mainly enhances these built-in tools:
2020

21-
- `ace-find_definition`: prefers LSP "go to definition"; falls back to regex search on failure
22-
- `ace-file_outline`: prefers LSP `documentSymbol`; falls back to regex search on failure
21+
- `ace-search` (action=`find_definition`): prefers LSP "go to definition"; falls back to regex search on failure
22+
- `ace-search` (action=`file_outline`): prefers LSP `documentSymbol`; falls back to regex search on failure
2323

2424
Notes:
2525

@@ -136,7 +136,7 @@ If you don’t want to install LSP for a language, remove its entry (or remove i
136136

137137
## Using LSP via ACE tools
138138

139-
### 1) Go to definition: `ace-find_definition`
139+
### 1) Go to definition: `ace-search` (action=`find_definition`)
140140

141141
If you provide `contextFile`, Snow CLI will try LSP first; otherwise it uses regex search directly.
142142

@@ -147,13 +147,13 @@ It’s recommended to pass cursor position:
147147

148148
Example: if your editor shows "Line 34, Column 7", you usually pass `line=33`, `column=6`.
149149

150-
### 2) File outline: `ace-file_outline`
150+
### 2) File outline: `ace-search` (action=`file_outline`)
151151

152152
For extracting symbols from a single file, Snow CLI tries LSP `documentSymbol` first and falls back to regex search.
153153

154154
Tip:
155155

156-
- For large files/projects, start with `ace-file_outline` to get a high-level map, then drill down.
156+
- For large files/projects, start with `ace-search` (action=`file_outline`) to get a high-level map, then drill down.
157157

158158
## FAQ
159159

@@ -172,5 +172,5 @@ Common causes:
172172

173173
### 3. Inaccurate jumps / wrong results
174174

175-
- Provide `contextFile + line + column` when calling `ace-find_definition`
175+
- Provide `contextFile + line + column` when calling `ace-search` (action=`find_definition`)
176176
- If `symbolName` appears multiple times in the file and you don’t pass position, Snow CLI will try the first occurrence, which may be inaccurate

0 commit comments

Comments
 (0)