feat: add tool alias support for model-specific tool customization

[daniel-lxs]

Summary

This PR adds a tool alias system that allows models to expose tools under different names while mapping to existing tool implementations. This enables:

1. Model-specific tool naming preferences (e.g., edit_file → apply_diff)
2. Backward compatibility when renaming tools
3. Semantic tool naming that better matches model training

Changes

Core Alias Infrastructure

• Added central TOOL_ALIASES constant in src/shared/tools.ts - single source of truth for all aliases
• Implemented alias resolution and validation in filter-tools-for-mode.ts
• Added helper functions: resolveToolAlias(), applyToolAliases(), getToolAliasGroup()

Model Tool Customization

• Enhanced applyModelToolCustomization() to track alias renames
• Updated filterNativeToolsForMode() to rename tools based on aliases in modelInfo.includedTools
• Added alias resolution in presentAssistantMessage.ts for tool validation

Parser Support

• Added alias resolution in NativeToolCallParser for both streaming and finalized tool calls
• Added search_and_replace case in createPartialToolUse() for streaming updates

Adding a New Alias

Simply add a single line to TOOL_ALIASES in src/shared/tools.ts:

export const TOOL_ALIASES: Record<string, ToolName> = {
    edit_file: "apply_diff",
    write_file: "write_to_file",
    // Add new aliases here - no other files need changes!
} as const

Example Usage

In modelInfo:

{
  includedTools: ["edit_file"],  // Alias for apply_diff
  excludedTools: ["search_and_replace"]
}

The model will see and use edit_file, but internally it maps to apply_diff.

How It Works

1. API Tool Building: When edit_file is in includedTools, filterNativeToolsForMode resolves it to apply_diff, adds it to allowed tools, and renames the tool definition back to edit_file
2. Model Invocation: Model calls edit_file
3. Parser Resolution: NativeToolCallParser.resolveToolAlias() converts edit_file → apply_diff
4. Validation: validateToolUse receives resolved includedTools so validation passes
5. Execution: apply_diff tool executes normally
6. History: Original alias name preserved in API conversation history for consistency

Test Coverage

• Added comprehensive tests for alias resolution functions
• Added tests for model tool customization with aliases
• Added tests for native tool filtering with alias renames
• Added tests for parser alias resolution (streaming and finalized)

Files Changed

• src/shared/tools.ts - Added central TOOL_ALIASES constant
• src/core/prompts/tools/filter-tools-for-mode.ts - Alias registration and resolution
• src/core/assistant-message/NativeToolCallParser.ts - Parser alias support
• src/core/assistant-message/presentAssistantMessage.ts - Validation fix
• src/core/task/Task.ts - Preserve alias name in API history

---

Important

Introduces a tool alias system for model-specific tool customization, enhancing flexibility and backward compatibility, with changes in tool resolution, validation, and execution.

• Behavior:
  • Introduces tool alias system allowing models to use alternative names for tools, mapping to existing implementations.
  • Supports model-specific tool naming, backward compatibility, and semantic naming.
• Core Infrastructure:
  • Adds TOOL_ALIASES in tools.ts as a central alias registry.
  • Implements alias resolution in filter-tools-for-mode.ts with functions like resolveToolAlias().
• Model Customization:
  • Updates applyModelToolCustomization() to handle alias renames.
  • Modifies filterNativeToolsForMode() to apply alias renames.
• Parser and Validation:
  • Enhances NativeToolCallParser to resolve aliases during tool call parsing.
  • Updates presentAssistantMessage.ts to validate tools with resolved aliases.
• Testing:
  • Adds tests for alias resolution and model tool customization in filter-tools-for-mode.spec.ts.

^{This description was created by for 5964457. You can customize this summary. It will automatically update as commits are pushed.}

[roomote]

Rooviewer   See task on Roo Cloud

No new issues found. The latest commit removes a redundant alias registration loop that duplicated logic already handled in applyModelToolCustomization(). All previous issues remain resolved.

• Missing alias registration for ApplyDiffTool and WriteToFileTool - the aliases are defined but not registered in filter-tools-for-mode.ts
• Missing changeset file for version bump and release notes

Previous reviews

• 2753783: Review #1
• 7745b1a: Review #2
• 10e2def: Review #3
• f061e92: Review #4
• 3431061: Review #5
• 36c1042: Review #6
• 28725ce: Review #7
• 9a1a527: Review #8
• 9509b6c: Review #9
• 08e3b8e: Review #10
• 923a1e3: Review #11
• ff87db7: Review #12
• 9578907: Review #13
• ec15a07: Review #14
• 8e2bd0c: Review #15
• e568484: Review #16
• e84b22e: Review #17

_{Mention @roomote in a comment to request specific changes to this pull request or fix all unresolved issues.}