feat(tools): add CSV tools with DuckDB SQL support

Add comprehensive CSV manipulation tools:
- csv_read: Read CSV with pagination (limit/offset)
- csv_write: Create new CSV files
- csv_append: Append rows to existing CSV
- csv_info: Get CSV metadata (columns, row count, file size)
- csv_sql: Query CSV using SQL (powered by DuckDB)

Features:
- Session sandbox security (workspace_id, agent_id, session_id)
- DuckDB as optional dependency for SQL queries
- Security: Only SELECT queries allowed, dangerous keywords blocked
- Full Unicode support
- 45 tests covering all tools

Install SQL support: pip install tools[sql]

Author: Hundao

tools/pyproject.toml

@@ -42,10 +42,14 @@ ocr = [
     "pytesseract>=0.3.10",
     "pillow>=10.0.0",
 ]
+sql = [
+    "duckdb>=1.0.0",
+]
 all = [
     "RestrictedPython>=7.0",
     "pytesseract>=0.3.10",
     "pillow>=10.0.0",
+    "duckdb>=1.0.0",
 ]
 
 [build-system]

tools/src/aden_tools/tools/__init__.py

@@ -32,6 +32,7 @@
 from .file_system_toolkits.apply_patch import register_tools as register_apply_patch
 from .file_system_toolkits.grep_search import register_tools as register_grep_search
 from .file_system_toolkits.execute_command_tool import register_tools as register_execute_command
+from .csv_tool import register_tools as register_csv
 
 
 def register_all_tools(
@@ -67,6 +68,7 @@ def register_all_tools(
     register_apply_patch(mcp)
     register_grep_search(mcp)
     register_execute_command(mcp)
+    register_csv(mcp)
 
     return [
         "example_tool",
@@ -81,6 +83,11 @@ def register_all_tools(
         "apply_patch",
         "grep_search",
         "execute_command_tool",
+        "csv_read",
+        "csv_write",
+        "csv_append",
+        "csv_info",
+        "csv_sql",
     ]
 
 

tools/src/aden_tools/tools/csv_tool/__init__.py

@@ -0,0 +1,4 @@
+"""CSV Tool package."""
+from .csv_tool import register_tools
+
+__all__ = ["register_tools"]