tool-interface-analysislisted

# Tool Interface Analysis Analyzes how agent frameworks model, register, and execute tools. This skill examines the **tool abstraction layer**, **schema generation**, **built-in inventory**, and **error feedback mechanisms**. ## Distinction from harness-model-protocol | tool-interface-analysis | harness-model-protocol | |------------------------|------------------------| | How a "tool" is represented (types, base classes) | How tool calls are encoded on the wire | | Schema generation (Pydantic -> JSON Schema) | Schema transmission to LLM API | | Built-in tool inventory | Provider-specific tool formats | | Registration and discovery patterns | Message format translation | | Error feedback to LLM for retry | Response parsing and streaming | | Tool execution orchestration | Partial tool call handling | ## Process 1. **Map tool modeling** - Identify how tools are represented (types, protocols, base classes) 2. **Analyze schema generation** - How tool definitions become JSON Schema 3. **Catalog built-in inventory** - What tools ship with the framework 4. **Trace registration flow** - How tools are discovered and made available 5. **Document execution patterns** - Invocation, validation, error handling 6. **Evaluate retry mechanisms** - Self-correction and feedback loops ## Tool Modeling Patterns ### Abstract Base Class Pattern ```python from abc import ABC, abstractmethod from typing import Any class BaseTool(ABC): """Framework's tool abstraction.""" name: str