Tools Registry¶

CONCEPT:ECO-4.0 — Agent Tool System

Overview¶

The tools/ module provides 18 tool modules that are exposed to agents during graph execution. Each tool module registers functions that the LLM can call via the PydanticAI tool system.

Tool Categories¶

Agent & Team Tools¶

Module	Key Functions	Description
`agent_tools`	`agent_share_your_reasoning`, `agent_run_shell_command`	Core agent capabilities
`team_tools`	`delegate_to_team`, `request_review`	Multi-agent coordination
`a2a_tools`	`discover_agents`, `send_a2a_message`	Agent-to-Agent protocol tools

Developer Tools¶

Module	Key Functions	Description
`developer_tools`	`create_file`, `replace_in_file`, `read_file`	File manipulation
`git_tools`	`git_status`, `git_diff`, `git_commit`	Version control
`workspace_tools`	`list_workspace`, `search_files`, `grep`	Workspace navigation

Knowledge & Memory Tools¶

Module	Key Functions	Description
`knowledge_tools`	`query_knowledge_graph`, `store_knowledge`	KG read/write
`memory_tools`	`recall_memory`, `store_memory`	Conversational memory
`kg_evolution_tools`	`evolve_schema`, `migrate_graph`	KG schema management
`kg_share_tools`	`export_subgraph`, `import_subgraph`	KG data sharing
`pattern_tools`	`detect_pattern`, `apply_pattern`	Pattern recognition

Module	Key Functions	Description
`x_search_tool`	`x_search`, `browse_x_post`	Native X search and post browsing using xAI authentication

Infrastructure Tools¶

Module	Key Functions	Description
`scheduler_tools`	`schedule_task`, `list_scheduled`	Task scheduling
`mcp_sync_tool`	`sync_mcp_agents`	MCP server discovery
`sdd_tools`	`run_sdd_pipeline`, `validate_specs`	Spec-driven development
`self_improvement_tools`	`analyze_codebase`, `suggest_improvements`	Self-improvement
`style_tools`	`apply_coding_style`, `check_conventions`	Code style enforcement
`onboarding_tools`	`analyze_project`, `generate_onboarding`	Project onboarding

Tool Registration¶

Tools are registered with the agent during creation:

from agent_utilities.agent.factory import create_agent

# Tools are automatically loaded based on skill_types
agent = create_agent(
    name="MyAgent",
    skill_types=["universal", "graphs"],
)

Tool Guard (`security/tool_guard.py`)¶

Safety layer that validates tool calls before execution: - Allowlist/blocklist: Restrict which tools are available - Rate limiting: Prevent excessive tool calls - Approval gates: Require human approval for destructive operations

Tool Filtering (`tool_filtering.py`)¶

Dynamic tool selection based on context: - Reduces token usage by only exposing relevant tools - Uses semantic similarity to match tools to the current task - Supports explicit tool pinning via configuration

Tool Registry (`tools/tool_registry.py`)¶

Central entry point that wires all available tool modules onto a PydanticAI agent at creation time:

from agent_utilities.tools.tool_registry import register_agent_tools

# Registers the relevant tool modules (developer, git, workspace, knowledge,
# memory, a2a, etc.) onto the agent, guarded against duplicate registration.
register_agent_tools(agent, graph_bundle=my_graph_bundle)

X & xAI Integration¶

The x_search_tool provides native capabilities to search X posts and browse individual posts directly from an agent. It leverages the secure XaiAuthManager to obtain OAuth 2.0 access tokens.

Functions¶

x_search(query: str, allowed_x_handles=None, excluded_x_handles=None, from_date="", to_date=""): Searches X posts for a query and returns matching posts, authors, and text. Exactly one of allowed_x_handles/excluded_x_handles may be set.
browse_x_post(url: str, auto_ingest: bool = False): Fetches the text, author, and engagement metrics for a specific X post by its URL; optionally classifies and ingests it into the KG.

Example Code¶

# The agent will automatically call these tools when given an X URL or asked to search X:
result = browse_x_post("https://x.com/gkisokay/status/2056726149074657704")
print(result)