List Tools

List all available agent tools.

Use this endpoint to discover available tools before creating a session.

Tool Categories:

• search: Tools for searching data (execute_retriever)
• read: Tools for reading resources (list_, get_)
• create: Tools for creating resources (create_*) - requires confirmation
• update: Tools for updating resources (update_*) - requires confirmation
• delete: Tools for deleting resources (delete_*) - requires confirmation
• upload: Tools for file uploads (upload_object)

Note: Write operations (create, update, delete) require user confirmation via the /confirmations endpoint before execution.

Args: request: FastAPI request with tenant context category: Optional filter by tool category

Returns: ListToolsResponse with available tools

Example: ```bash # List all tools curl -X GET http://localhost:8000/v1/agents/tools
-H "Authorization: Bearer {api_key}"
-H "X-Namespace: {namespace_id}"

# List only search tools
curl -X GET "http://localhost:8000/v1/agents/tools?category=search" \
  -H "Authorization: Bearer {api_key}" \
  -H "X-Namespace: {namespace_id}"
```