gofannon 0.25.19__py3-none-any.whl → 0.25.21__py3-none-any.whl

gofannon/base/__init__.py

@@ -8,6 +8,7 @@ from pathlib import Path
 
 import anyio
 
+from .adk_mixin import AdkMixin
 from ..config import ToolConfig
 
 from .smol_agents import SmolAgentsMixin
@@ -74,6 +75,7 @@ class BaseTool(SmolAgentsMixin,
                LangflowMixin,
                MCPMixin,
                LlamaStackMixin,
+               AdkMixin,
                ABC):
     def __init__(self, **kwargs):
         self.logger = logging.getLogger(

gofannon/base/adk_mixin.py

@@ -0,0 +1,291 @@
+# gofannon/base/adk_mixin.py
+
+import inspect
+import json
+from typing import Any, Callable, Dict, List, Optional, Type as TypingType
+
+# Try to import ADK components
+try:
+    from google.adk.tools import BaseTool as AdkBaseTool
+    from google.adk.tools import FunctionTool as AdkFunctionTool
+    from google.adk.tools.tool_context import ToolContext as AdkToolContext
+    # _automatic_function_calling_util is not typically a public export,
+    # but FunctionTool uses it. For export, we might need a different strategy
+    # or rely on AdkFunctionTool to build its declaration.
+    # from google.adk.tools._automatic_function_calling_util import (
+    #     build_function_declaration as adk_build_function_declaration,
+    # )
+    from google.genai import types as adk_gemini_types
+    import anyio # For running sync Gofannon fn in async ADK tool
+
+    _HAS_ADK = True
+except ImportError:
+    _HAS_ADK = False
+    # Define dummy types for type hinting if ADK is not present
+    class AdkBaseTool: pass
+    class AdkFunctionTool(AdkBaseTool): pass # type: ignore
+    class AdkToolContext: pass # type: ignore
+    class adk_gemini_types: # type: ignore
+        class Type:
+            STRING = "STRING"
+            INTEGER = "INTEGER"
+            NUMBER = "NUMBER"
+            BOOLEAN = "BOOLEAN"
+            ARRAY = "ARRAY"
+            OBJECT = "OBJECT"
+            TYPE_UNSPECIFIED = "TYPE_UNSPECIFIED"
+        class Schema: # type: ignore
+            def __init__(self, **kwargs):
+                self.type = kwargs.get('type', adk_gemini_types.Type.OBJECT)
+                self.description = kwargs.get('description')
+                self.properties = kwargs.get('properties', {})
+                self.items = kwargs.get('items')
+                self.required = kwargs.get('required', [])
+                self.enum = kwargs.get('enum')
+                self.nullable = kwargs.get('nullable')
+
+        class FunctionDeclaration: # type: ignore
+            def __init__(self, name, description, parameters):
+                self.name = name
+                self.description = description
+                self.parameters = parameters
+
+
+            # Helper for ADK Schema to Gofannon JSON Schema
+ADK_GEMINI_TYPE_TO_JSON_TYPE = {
+    adk_gemini_types.Type.STRING: "string",
+    adk_gemini_types.Type.INTEGER: "integer",
+    adk_gemini_types.Type.NUMBER: "number",
+    adk_gemini_types.Type.BOOLEAN: "boolean",
+    adk_gemini_types.Type.ARRAY: "array",
+    adk_gemini_types.Type.OBJECT: "object",
+    adk_gemini_types.Type.TYPE_UNSPECIFIED: "object", # Default for unspecified
+}
+
+def _adk_schema_to_gofannon_json_schema(adk_schema: Optional[adk_gemini_types.Schema]) -> Dict[str, Any]:
+    if not adk_schema:
+        return {"type": "object", "properties": {}}
+
+    json_schema: Dict[str, Any] = {}
+
+    adk_type_enum = getattr(adk_schema, 'type', adk_gemini_types.Type.TYPE_UNSPECIFIED)
+    json_type_str = ADK_GEMINI_TYPE_TO_JSON_TYPE.get(adk_type_enum, "object")
+
+    if getattr(adk_schema, 'nullable', False):
+        # Represent nullable as a list of types including "null" if original type is singular
+        # or handle it based on how Gofannon expects nullable
+        json_schema["type"] = [json_type_str, "null"] if json_type_str != "object" else json_type_str # Pydantic v1 style for Optional[T]
+        if json_type_str == "object": # For objects, nullable flag is more common in JSON schema
+            json_schema["nullable"] = True
+            json_schema["type"] = "object" # Keep type as object if it was object
+    else:
+        json_schema["type"] = json_type_str
+
+    description = getattr(adk_schema, 'description', None)
+    if description:
+        json_schema["description"] = description
+
+    if adk_type_enum == adk_gemini_types.Type.OBJECT:
+        properties = getattr(adk_schema, 'properties', None)
+        if properties:
+            json_schema["properties"] = {
+                name: _adk_schema_to_gofannon_json_schema(prop_schema)
+                for name, prop_schema in properties.items()
+            }
+        else:
+            json_schema["properties"] = {} # Ensure properties exist for object type
+
+    items = getattr(adk_schema, 'items', None)
+    if adk_type_enum == adk_gemini_types.Type.ARRAY and items:
+        json_schema["items"] = _adk_schema_to_gofannon_json_schema(items)
+
+    required_list = getattr(adk_schema, 'required', None)
+    if required_list:
+        json_schema["required"] = list(required_list)
+
+    enum_list = getattr(adk_schema, 'enum', None)
+    if enum_list:
+        json_schema["enum"] = list(enum_list)
+
+        # Ensure "properties" field exists if type is "object"
+    if json_schema.get("type") == "object" and "properties" not in json_schema:
+        json_schema["properties"] = {}
+
+    return json_schema
+
+# Helper for Gofannon JSON Schema to ADK Schema
+JSON_TYPE_TO_ADK_GEMINI_TYPE = {
+    "string": adk_gemini_types.Type.STRING,
+    "integer": adk_gemini_types.Type.INTEGER,
+    "number": adk_gemini_types.Type.NUMBER,
+    "boolean": adk_gemini_types.Type.BOOLEAN,
+    "array": adk_gemini_types.Type.ARRAY,
+    "object": adk_gemini_types.Type.OBJECT,
+    "null": adk_gemini_types.Type.TYPE_UNSPECIFIED, # ADK has no 'null' type, unspecified is closest
+}
+
+def _gofannon_json_schema_to_adk_schema(json_schema: Dict[str, Any]) -> adk_gemini_types.Schema:
+    if not json_schema: # Handles empty dict {} case
+        return adk_gemini_types.Schema(type=adk_gemini_types.Type.OBJECT, properties={})
+
+    adk_schema_kwargs: Dict[str, Any] = {}
+
+    json_type_val = json_schema.get("type", "object")
+    is_nullable = json_schema.get("nullable", False) # Check for explicit "nullable"
+
+    actual_json_type_str = json_type_val
+    if isinstance(json_type_val, list): # Handles type: ["string", "null"]
+        if "null" in json_type_val:
+            is_nullable = True
+        actual_json_type_str = next((t for t in json_type_val if t != "null"), "object")
+
+    adk_type_enum = JSON_TYPE_TO_ADK_GEMINI_TYPE.get(str(actual_json_type_str).lower(), adk_gemini_types.Type.OBJECT)
+    adk_schema_kwargs["type"] = adk_type_enum
+    if is_nullable:
+        adk_schema_kwargs["nullable"] = True
+
+    if "description" in json_schema:
+        adk_schema_kwargs["description"] = json_schema["description"]
+
+    if adk_type_enum == adk_gemini_types.Type.OBJECT and "properties" in json_schema:
+        adk_schema_kwargs["properties"] = {
+            name: _gofannon_json_schema_to_adk_schema(prop_schema)
+            for name, prop_schema in json_schema["properties"].items()
+        }
+    elif adk_type_enum == adk_gemini_types.Type.OBJECT: # Ensure properties for object type
+        adk_schema_kwargs["properties"] = {}
+
+    if adk_type_enum == adk_gemini_types.Type.ARRAY and "items" in json_schema:
+        adk_schema_kwargs["items"] = _gofannon_json_schema_to_adk_schema(json_schema["items"])
+
+    if "required" in json_schema:
+        adk_schema_kwargs["required"] = list(json_schema["required"])
+
+    if "enum" in json_schema:
+        adk_schema_kwargs["enum"] = list(json_schema["enum"])
+
+    return adk_gemini_types.Schema(**adk_schema_kwargs)
+
+
+class AdkMixin:
+    def import_from_adk(self, adk_tool: AdkBaseTool):
+        """
+        Adapts a google-adk-python tool to the Gofannon BaseTool structure.
+
+        Args:
+            adk_tool: An instance of a class derived from `google.adk.tools.BaseTool`.
+        """
+        if not _HAS_ADK:
+            raise RuntimeError(
+                "google-adk-python is not installed. Install with `pip install google-adk`"
+            )
+        if not isinstance(adk_tool, AdkBaseTool): # type: ignore
+            raise TypeError("Input must be an instance of ADK BaseTool.")
+
+        self.name = adk_tool.name # type: ignore
+        self.description = adk_tool.description # type: ignore
+
+        declaration = None
+        # Ensure _get_declaration is callable and attempt to call it
+        if hasattr(adk_tool, "_get_declaration") and callable(adk_tool._get_declaration): # type: ignore
+            try:
+                declaration = adk_tool._get_declaration() # type: ignore
+            except Exception as e:
+                self.logger.warning(f"Could not get declaration from ADK tool {self.name}: {e}. Assuming no parameters.") # type: ignore
+
+        gofannon_params_schema: Dict[str, Any] = {"type": "object", "properties": {}}
+        if declaration and hasattr(declaration, 'parameters') and declaration.parameters:
+            gofannon_params_schema = _adk_schema_to_gofannon_json_schema(declaration.parameters)
+
+        self.definition = { # type: ignore
+            "function": {
+                "name": self.name,
+                "description": self.description,
+                "parameters": gofannon_params_schema
+            }
+        }
+
+        # Adapt the execution logic
+        if isinstance(adk_tool, AdkFunctionTool) and hasattr(adk_tool, 'func'): # type: ignore
+            target_callable = adk_tool.func # type: ignore
+            self.fn = target_callable # type: ignore
+        elif hasattr(adk_tool, 'run_async') and callable(adk_tool.run_async): # type: ignore
+            self.logger.warning( # type: ignore
+                f"Importing ADK tool {self.name} that is not a FunctionTool. "
+                f"ADK ToolContext features will not be available or may require a dummy context. "
+                f"Ensure this tool can operate correctly with args only."
+            )
+            # This wrapper will become self.fn. If self.fn is async, Gofannon's
+            # execute_async can await it directly. Gofannon's sync execute
+            # would need to handle running this async fn (e.g., using anyio.run).
+            async def adk_run_async_wrapper(**kwargs):
+                # This simplified call assumes the tool can function with a None ToolContext
+                # or that its core logic doesn't strictly depend on it.
+                return await adk_tool.run_async(args=kwargs, tool_context=None) # type: ignore
+            self.fn = adk_run_async_wrapper # type: ignore
+        else:
+            self.logger.error( # type: ignore
+                f"ADK tool {self.name} does not have a suitable execution method ('func' or 'run_async')."
+            )
+            def placeholder_fn(**kwargs):
+                raise NotImplementedError(f"Execution for imported ADK tool {self.name} is not available.")
+            self.fn = placeholder_fn # type: ignore
+
+
+    def export_to_adk(self) -> AdkBaseTool:
+        """
+        Converts the Gofannon tool to a google-adk-python compatible tool.
+        This typically creates a custom AdkBaseTool derivative that uses the
+        Gofannon tool's definition and execution logic.
+
+        Returns:
+            An instance of a `google.adk.tools.BaseTool` derivative.
+        """
+        if not _HAS_ADK:
+            raise RuntimeError(
+                "google-adk-python is not installed. Install with `pip install google-adk`"
+            )
+
+        gofannon_def = self.definition.get("function", {}) # type: ignore
+        tool_name = gofannon_def.get("name", getattr(self, "name", "gofannon_exported_tool"))
+        tool_description = gofannon_def.get("description", getattr(self, "description", "No description provided."))
+
+        gofannon_params_schema = gofannon_def.get("parameters", {"type": "object", "properties": {}})
+
+        original_gofannon_fn = self.fn # type: ignore
+        is_gofannon_fn_async = inspect.iscoroutinefunction(original_gofannon_fn)
+
+        # Define a custom ADK Tool class
+        class GofannonAdkTool(AdkBaseTool): # type: ignore
+            def __init__(self, name, description, gofannon_json_schema, gofannon_exec_fn, is_fn_async):
+                super().__init__(name=name, description=description) # type: ignore
+                self._gofannon_json_schema = gofannon_json_schema
+                self._gofannon_exec_fn = gofannon_exec_fn
+                self._is_fn_async = is_fn_async
+
+            def _get_declaration(self) -> Optional[adk_gemini_types.FunctionDeclaration]: # type: ignore
+                adk_params_schema = _gofannon_json_schema_to_adk_schema(self._gofannon_json_schema)
+                return adk_gemini_types.FunctionDeclaration( # type: ignore
+                    name=self.name,
+                    description=self.description,
+                    parameters=adk_params_schema
+                )
+
+            async def run_async(self, *, args: Dict[str, Any], tool_context: AdkToolContext) -> Any: # type: ignore
+                # The ADK tool_context is available here but the Gofannon fn doesn't expect it.
+                # We simply pass the args to the Gofannon function.
+                if self._is_fn_async:
+                    return await self._gofannon_exec_fn(**args)
+                else:
+                    # Gofannon's synchronous fn needs to be run in a thread
+                    # as ADK's run_async is an async method.
+                    return await anyio.to_thread.run_sync(self._gofannon_exec_fn, **args) # type: ignore
+
+        exported_adk_tool = GofannonAdkTool(
+            name=tool_name,
+            description=tool_description,
+            gofannon_json_schema=gofannon_params_schema,
+            gofannon_exec_fn=original_gofannon_fn,
+            is_fn_async=is_gofannon_fn_async
+        )
+        return exported_adk_tool  

gofannon/config.py

@@ -15,6 +15,8 @@ class ToolConfig:
             'google_search_api_key': os.getenv('GOOGLE_SEARCH_API_KEY'),
             'google_search_engine_id': os.getenv('GOOGLE_SEARCH_ENGINE_ID'),
             'nasa_apod_api_key': os.getenv('NASA_APOD_API_KEY'),
+            'simpler_grants_api_key': os.getenv('SIMPLER_GRANTS_API_KEY'),
+            'simpler_grants_base_url': os.getenv('SIMPLER_GRANTS_BASE_URL', 'https://api.simpler.grants.gov'), #configurable as key in dev, maybe someone wants to test?
         }
 
     @classmethod

gofannon/simpler_grants_gov/base.py

@@ -0,0 +1,125 @@
+import requests
+import logging
+import json
+from typing import Optional, Dict, Any
+
+from ..base import BaseTool
+from ..config import ToolConfig
+
+logger = logging.getLogger(__name__)
+
+class SimplerGrantsGovBase(BaseTool):
+    """
+    Base class for tools interacting with the Simpler Grants Gov API.
+
+    Handles common setup like API key and base URL management, and provides
+    a helper method for making authenticated requests.
+    """
+    def __init__(self, api_key: Optional[str] = None, base_url: Optional[str] = None, **kwargs):
+        super().__init__(**kwargs)
+        self.api_key = api_key or ToolConfig.get("simpler_grants_api_key")
+        self.base_url = base_url or ToolConfig.get("simpler_grants_base_url")
+
+        if not self.api_key:
+            msg = "Simpler Grants Gov API key is missing. Please set SIMPLER_GRANTS_API_KEY environment variable or pass api_key argument."
+            logger.error(msg)
+            # Decide on behavior: raise error or allow initialization but fail on execution?
+            # Raising an error early is often clearer.
+            # raise ValueError(msg)
+            # Or, log and proceed, letting _make_request handle the missing key later.
+            self.logger.warning(msg + " Tool execution will likely fail.")
+
+
+        if not self.base_url:
+            msg = "Simpler Grants Gov base URL is missing. Please set SIMPLER_GRANTS_BASE_URL environment variable or pass base_url argument."
+            logger.error(msg)
+            # raise ValueError(msg)
+            self.logger.warning(msg + " Tool execution will likely fail.")
+
+        self.logger.debug(f"Initialized {self.__class__.__name__} with base_url: {self.base_url} and API key {'present' if self.api_key else 'missing'}")
+
+
+    def _make_request(self, method: str, endpoint: str, params: Optional[Dict[str, Any]] = None, json_payload: Optional[Dict[str, Any]] = None) -> str:
+        """
+        Makes an authenticated request to the Simpler Grants Gov API.
+
+        Args:
+            method: HTTP method (e.g., 'GET', 'POST').
+            endpoint: API endpoint path (e.g., '/v1/opportunities/search').
+            params: URL query parameters.
+            json_payload: JSON body for POST/PUT requests.
+
+        Returns:
+            The JSON response content as a string.
+
+        Raises:
+            requests.exceptions.RequestException: If the request fails.
+            ValueError: If API key or base URL is missing.
+        """
+        if not self.api_key:
+            raise ValueError("Simpler Grants Gov API key is missing.")
+        if not self.base_url:
+            raise ValueError("Simpler Grants Gov base URL is missing.")
+
+        full_url = f"{self.base_url.rstrip('/')}/{endpoint.lstrip('/')}"
+        headers = {
+            # Based on api_key_auth.py, the API expects the key in this header
+            'X-Auth': self.api_key,
+            'Content-Type': 'application/json',
+            'accept': 'application/json'
+        }
+
+        self.logger.debug(f"Making {method} request to {full_url}")
+        self.logger.debug(f"Headers: {{'X-Auth': '***', 'Content-Type': 'application/json', 'accept': 'application/json'}}") # Don't log key
+        if params:
+            self.logger.debug(f"Params: {params}")
+        if json_payload:
+            # Be careful logging potentially large/sensitive payloads
+            log_payload = json.dumps(json_payload)[:500] # Log truncated payload
+            self.logger.debug(f"JSON Payload (truncated): {log_payload}")
+
+
+        try:
+            response = requests.request(
+                method,
+                full_url,
+                headers=headers,
+                params=params,
+                json=json_payload,
+                timeout=30 # Add a reasonable timeout
+            )
+            response.raise_for_status()  # Raise an exception for bad status codes (4xx or 5xx)
+
+            # Check if response is empty or not JSON before trying to parse
+            content_type = response.headers.get('Content-Type', '')
+            if response.content and 'application/json' in content_type:
+                try:
+                    # Return raw text which usually includes JSON string
+                    return response.text
+                except json.JSONDecodeError as e:
+                    self.logger.error(f"Failed to decode JSON response from {full_url}. Status: {response.status_code}. Content: {response.text[:500]}... Error: {e}")
+                    # Return raw text even if not JSON, could be an error message
+                    return response.text
+            elif response.content:
+                self.logger.warning(f"Response from {full_url} is not JSON (Content-Type: {content_type}). Returning raw text.")
+                return response.text
+            else:
+                self.logger.warning(f"Received empty response from {full_url}. Status: {response.status_code}")
+                return "" # Return empty string for empty response
+
+
+        except requests.exceptions.RequestException as e:
+            self.logger.error(f"Request to {full_url} failed: {e}")
+            # Re-raise the exception to be handled by the BaseTool's execute method
+            # Or return a formatted error string
+            # return json.dumps({"error": f"API request failed: {e}"})
+            raise # Re-raise for BaseTool's error handling
+
+
+    # Subclasses must implement definition and fn
+    @property
+    def definition(self):
+        raise NotImplementedError("Subclasses must implement the 'definition' property.")
+
+    def fn(self, *args, **kwargs):
+        raise NotImplementedError("Subclasses must implement the 'fn' method.")

gofannon/simpler_grants_gov/get_opportunity.py

@@ -0,0 +1,66 @@
+import logging
+from typing import Optional
+import json
+
+from .base import SimplerGrantsGovBase
+from ..config import FunctionRegistry
+
+logger = logging.getLogger(__name__)
+
+@FunctionRegistry.register
+class GetOpportunity(SimplerGrantsGovBase):
+    """
+    Tool to retrieve details for a specific grant opportunity by its ID.
+    Corresponds to the GET /v1/opportunities/{opportunity_id} endpoint.
+    """
+    def __init__(self, api_key: Optional[str] = None, base_url: Optional[str] = None, name: str = "get_opportunity"):
+        super().__init__(api_key=api_key, base_url=base_url)
+        self.name = name
+
+    @property
+    def definition(self):
+        # Based on route GET /v1/opportunities/{opportunity_id} and OpportunityGetResponseV1Schema
+        return {
+            "type": "function",
+            "function": {
+                "name": self.name,
+                "description": "Retrieve the full details of a specific grant opportunity, including attachments, using its unique identifier.",
+                "parameters": {
+                    "type": "object",
+                    "properties": {
+                        "opportunity_id": {
+                            "type": "integer",
+                            "description": "The unique numeric identifier for the grant opportunity."
+                        }
+                    },
+                    "required": ["opportunity_id"]
+                }
+            }
+        }
+
+    def fn(self, opportunity_id: int) -> str:
+        """
+        Executes the get opportunity request.
+
+        Args:
+            opportunity_id: The ID of the opportunity to retrieve.
+
+        Returns:
+            A JSON string representing the opportunity details.
+        """
+        self.logger.info(f"Executing Simpler Grants Gov get opportunity tool for ID: {opportunity_id}")
+
+        if not isinstance(opportunity_id, int) or opportunity_id <= 0:
+            # Add validation for the ID
+            self.logger.error(f"Invalid opportunity_id provided: {opportunity_id}. Must be a positive integer.")
+            return json.dumps({"error": "Invalid opportunity_id provided. Must be a positive integer.", "success": False})
+
+        endpoint = f"/v1/opportunities/{opportunity_id}"
+        try:
+            result = self._make_request("GET", endpoint)
+            self.logger.debug(f"Get opportunity successful for ID {opportunity_id}. Response length: {len(result)}")
+            return result
+        except Exception as e:
+            self.logger.error(f"Get opportunity failed for ID {opportunity_id}: {e}", exc_info=True)
+            # Return a JSON error string
+            return json.dumps({"error": f"Get opportunity failed: {str(e)}", "success": False})

gofannon/simpler_grants_gov/list_agencies.py

@@ -0,0 +1,83 @@
+import logging
+from typing import Optional, Dict, Any
+import json
+
+from .base import SimplerGrantsGovBase
+from ..config import FunctionRegistry
+
+logger = logging.getLogger(__name__)
+
+@FunctionRegistry.register
+class ListAgencies(SimplerGrantsGovBase):
+    """
+    Tool to retrieve a list of agencies, potentially filtered.
+    Corresponds to the POST /v1/agencies endpoint.
+    NOTE: The API uses POST for listing/filtering, not GET.
+    """
+    def __init__(self, api_key: Optional[str] = None, base_url: Optional[str] = None, name: str = "list_agencies"):
+        super().__init__(api_key=api_key, base_url=base_url)
+        self.name = name
+
+    @property
+    def definition(self):
+        # Based on AgencyListRequestSchema
+        return {
+            "type": "function",
+            "function": {
+                "name": self.name,
+                "description": "Retrieve a paginated list of agencies, optionally filtered by agency ID or active status.",
+                "parameters": {
+                    "type": "object",
+                    "properties": {
+                        "filters": {
+                            "type": "object",
+                            "description": "Optional. A JSON object for filtering. Can contain 'agency_id' (UUID string) or 'active' (boolean).",
+                            "properties": {
+                                "agency_id": {"type": "string", "format": "uuid"},
+                                "active": {"type": "boolean"}
+                            }
+                        },
+                        "pagination": {
+                            "type": "object",
+                            "description": "Required. A JSON object for pagination. Must include 'page_offset', 'page_size', and 'sort_order' (array of objects with 'order_by': ['agency_code', 'agency_name', 'created_at'] and 'sort_direction': ['ascending', 'descending']).",
+                            "properties": {
+                                "page_offset": {"type": "integer", "description": "Page number (starts at 1)."},
+                                "page_size": {"type": "integer", "description": "Results per page."},
+                                "sort_order": {
+                                    "type": "array",
+                                    "items": {
+                                        "type": "object",
+                                        "properties": {
+                                            "order_by": {"type": "string", "enum": ["agency_code", "agency_name", "created_at"]},
+                                            "sort_direction": {"type": "string", "enum": ["ascending", "descending"]}
+                                        },
+                                        "required": ["order_by", "sort_direction"]
+                                    }
+                                }
+                            },
+                            "required": ["page_offset", "page_size", "sort_order"]
+                        }
+                    },
+                    "required": ["pagination"]
+                }
+            }
+        }
+
+    def fn(self, pagination: Dict[str, Any], filters: Optional[Dict[str, Any]] = None) -> str:
+        """
+        Executes the list agencies request.
+        """
+        self.logger.info("Executing Simpler Grants Gov list agencies tool")
+        payload = {"pagination": pagination}
+        if filters:
+            payload["filters"] = filters
+
+        endpoint = "/v1/agencies"
+        try:
+            result = self._make_request("POST", endpoint, json_payload=payload)
+            self.logger.debug(f"List agencies successful. Response length: {len(result)}")
+            return result
+        except Exception as e:
+            self.logger.error(f"List agencies failed: {e}", exc_info=True)
+            return json.dumps({"error": f"List agencies failed: {str(e)}", "success": False})
+