feat: Add OpenHands-inspired tools (OH tools) with comprehensive tests

[wolvever]

Summary

• Implemented 4 core OH tools adapted from OpenHands for enhanced agent capabilities
• Added comprehensive test suite with 41 tests achieving 77% code coverage
• Integrated tools follow the existing agentic rollout framework patterns

Implementation Details

New Tools Added

1. OHBashTool - Execute bash commands with timeout and session management

   • Supports command execution with configurable timeouts
   • Maintains persistent shell sessions
   • Handles long-running processes and user interaction

2. OHStrReplaceEditorTool - File viewing, creation, and editing capabilities

   • View files with optional line ranges
   • Create new files with parent directory validation
   • String replacement with uniqueness checking
   • Insert lines at specific positions
   • Undo functionality for recent edits

3. OHThinkTool - Log agent thought processes and reasoning

   • Captures agent reasoning for transparency
   • Maintains thought history per instance
   • Configurable thought truncation

4. OHFinishTool - Signal task completion with status tracking

   • Tracks task completion status (complete/partial/failed)
   • Generates commit messages
   • Provides final user messages

Utility Functions

• get_oh_tool(name, config) - Get individual tool with optional configuration
• get_all_oh_tools(config) - Get all OH tools as a dictionary
• OH_TOOLS registry for easy tool access

Testing

• Created test_oh_tools.py with comprehensive test coverage
• 41 tests covering all tools and edge cases
• Integration test demonstrating tools working together
• 77% code coverage across all OH tools modules

Dependencies Added

• chardet>=5.2.0 - For file encoding detection
• pytest>=8.3.5 - Testing framework
• pytest-asyncio>=0.24.0 - Async test support
• pytest-cov>=5.0.0 - Coverage reporting

Test Results

============================== 41 passed in 1.26s ==============================

Coverage Report:
Name                                           Stmts   Miss  Cover   Missing
----------------------------------------------------------------------------
workers/tools/oh_tools/__init__.py                13      0   100%
workers/tools/oh_tools/bash.py                    77     22    71%
workers/tools/oh_tools/finish.py                  52      3    94%
workers/tools/oh_tools/str_replace_editor.py     212     61    71%
workers/tools/oh_tools/think.py                   43      4    91%
----------------------------------------------------------------------------
TOTAL                                            397     90    77%

Usage Example

from workers.tools.oh_tools import get_oh_tool, get_all_oh_tools

# Get individual tool
bash_tool = get_oh_tool('bash')
result = await bash_tool.execute_tool(instance_id, {"command": "ls -la"})

# Get all tools
tools = get_all_oh_tools(config={"max_output_length": 5000})

🤖 Generated with Claude Code

[guru4elephant]

需要支持k8s版本，参考r2e和kodo的组合方式。

[guru4elephant]

这个方案不行，得用k8s方案，kodo去pod执行。我会在远程启pod，然后用pod name 过去执行。参考r2e k8s的tools实现。