`CLAUDE.md` is a symlink to this file. Always edit `AGENTS.md` directly; never modify `CLAUDE.md`

# CLAUDE.md

This file provides guidance to Claude Code (claude.ai/code) when working with code in this repository.

`CLAUDE.md` is a symlink to this file. Always edit `AGENTS.md` directly; never modify `CLAUDE.md`.

## Where to Look First

- [README.md](README.md): high-level usage and supported frameworks.
- [CONTRIBUTING.md](CONTRIBUTING.md): canonical dev setup, test matrix, and contribution workflow.
- [pyproject.toml](pyproject.toml) and [.pre-commit-config.yaml](.pre-commit-config.yaml): formatting/lint/typecheck configuration.
- [docs/](docs/): Astro/Starlight docs site (configured by [docs/astro.config.mjs](docs/astro.config.mjs)).

## Project Structure & Module Organization

- `src/any_agent/`: Core library. `AnyAgent` is the main entry point; `AgentConfig` and `AgentFramework` define config.
- `src/any_agent/frameworks/`: One module per supported framework (agno, google, langchain, llama_index, openai, smolagents, tinyagent). Each implements `AnyAgent`'s abstract methods via lazy imports to keep optional dependencies isolated. The `tinyagent` module is a thin shim that delegates to the standalone [`mozilla-ai-tinyagent`](https://github.com/mozilla-ai/tinyagent) package; the loop itself lives there.
- `src/any_agent/callbacks/`: Callback system with per-framework wrappers (`wrappers/`) and span generation (`span_generation/`). Base class is `Callback` in `base.py`.
- `src/any_agent/tools/`: Built-in tools (web browsing, user interaction, final output) plus MCP client integration (`mcp/`), A2A tools, and Composio integration.
- `src/any_agent/tracing/`: OpenTelemetry-based tracing. `AgentTrace` / `AgentSpan` are the primary types.
- `src/any_agent/evaluation/`: LLM judge and agent judge evaluators.
- `src/any_agent/serving/`: A2A protocol and MCP server implementations for serving agents.
- `src/any_agent/vendor/`: Vendored adapters (langchain_any_llm, llama_index_utils).
- `tests/`: `unit/`, `integration/`, `snapshots/`, plus shared fixtures in `tests/conftest.py`.