Tools Reference

{
  "code": "INVALID_ARGUMENT",
  "message": "Missing required parameter: 'transaction_id'."
}

import json

def call_tool(agent_response):
    for block in agent_response.content:
        if not hasattr(block, "text"):
            continue
        try:
            payload = json.loads(block.text)
        except json.JSONDecodeError:
            # Successful tool result — plain text or structured data, not an error envelope
            return block.text

        code = payload.get("code")
        message = payload.get("message", "Unknown error")

        if code == "INVALID_ARGUMENT":
            raise ValueError(f"Bad request: {message}")
        elif code == "UNAUTHENTICATED":
            raise PermissionError(f"Auth failed: {message}")
        elif code == "PERMISSION_DENIED":
            raise PermissionError(f"Insufficient permissions: {message}")
        elif code == "INTERNAL":
            raise RuntimeError(f"Server error: {message}")