// Renames 'oldVar' to 'newVar' across the entire file
{
  "file_path": "./src/index.ts",
  "operation": "rename_identifier",
  "old_name": "oldVar",
  "new_name": "newVar"
}

// Moves 'calculateTotal' from src.ts to utils.ts
{
  "file_path": "./src/operations.ts",
  "operation": "move_function",
  "old_name": "placeholder", // required by schema, ignored for this operation
  "function_name": "calculateTotal",
  "target_path": "./src/utils.ts"
}

// Extracts the provided code block into a function named 'processData'
{
  "file_path": "./src/handler.ts",
  "operation": "extract_function",
  "old_name": "const result = value * 2;\nconsole.log(result);", // raw code to extract
  "new_name": "processData"
}

// Scans file for dead imports and removes them automatically
{
  "file_path": "./src/module.ts",
  "operation": "unused_import_cleanup"
}

{
  "category": "fileSystem"
}
// Returns: { success: true, categories: ["read_file", "write_file", ...] }

{
  "toolName": "read_file",
  "arguments": {
    "file_name": "./src/index.ts"
  }
}
// Delegates to provider.executeTool("read_file", args) with full validation

User Message → AI calls explore_tools(category="fileSystem") 
             → Returns: { success: true, categories: ["read_file", "write_file", ...] }
             → AI decides to use read_file
             → AI calls execute_gateway_tool(toolName="read_file", arguments={file_name: "example.txt"})
             → Gateway delegates to provider.executeTool("read_file", args)
             → Tool executes with full validation, security checks, error handling

// Renames 'oldVar' to 'newVar' across the entire file
{
  "file_path": "./src/index.ts",
  "operation": "rename_identifier",
  "old_name": "oldVar",
  "new_name": "newVar"
}

// Moves 'calculateTotal' from src.ts to utils.ts
{
  "file_path": "./src/operations.ts",
  "operation": "move_function",
  "old_name": "placeholder", // required by schema, ignored for this operation
  "function_name": "calculateTotal",
  "target_path": "./src/utils.ts"
}

// Extracts the provided code block into a function named 'processData'
{
  "file_path": "./src/handler.ts",
  "operation": "extract_function",
  "old_name": "const result = value * 2;\nconsole.log(result);", // raw code to extract
  "new_name": "processData"
}

// Scans file for dead imports and removes them automatically
{
  "file_path": "./src/module.ts",
  "operation": "unused_import_cleanup"
}

{
  "category": "fileSystem"
}
// Returns: { success: true, categories: ["read_file", "write_file", ...] }

{
  "toolName": "read_file",
  "arguments": {
    "file_name": "./src/index.ts"
  }
}
// Delegates to provider.executeTool("read_file", args) with full validation

User Message → AI calls explore_tools(category="fileSystem") 
             → Returns: { success: true, categories: ["read_file", "write_file", ...] }
             → AI decides to use read_file
             → AI calls execute_gateway_tool(toolName="read_file", arguments={file_name: "example.txt"})
             → Gateway delegates to provider.executeTool("read_file", args)
             → Tool executes with full validation, security checks, error handling