Repository navigation
v5.0.0 — The Universal Agent Tool Interface
The Universal Agent Tool Interface
Tooli v5.0 adds a Python API for direct in-process invocation, granular capability declarations, multi-agent handoff metadata, framework export code generation, and AGENTS.md documentation generation. All changes are additive — existing v4.x code runs unchanged.
Highlights
- Python API:
app.call(),app.acall(),app.stream(),app.astream()for typed in-process invocation returningTooliResultobjects - Capabilities:
capabilities=[...]for granular permission declarations with STRICT mode enforcement viaTOOLI_ALLOWED_CAPABILITIES - Handoffs:
handoffs=[...]anddelegation_hintfor multi-agent workflow orchestration - Error field mapping: Link errors to specific input parameters with
field="param_name" - Output schema:
output_schemain envelope meta for detailed response format - AGENTS.md: Generator for GitHub Copilot / OpenAI Codex compatibility
- Export command:
mytool export --target openai|langchain|adk|pythongenerates framework-specific integration code - 4 SDK integration examples: Claude, OpenAI, LangChain, Google ADK
- All 18 example apps updated with v5 metadata (capabilities on all 65 commands)
- 627 tests passing across Python 3.10+
Install
pip install tooli==5.0.0Migration
See MIGRATION_GUIDE_v5.md for upgrade steps. No breaking changes.
Full Changelog: https://github.com/weisberg/tooli/blob/main/CHANGELOG.md