docs/tools.md

# Tools

All `hf_*` tools are anonymous, read‑only, and return JSON as a string.
- Listing tools → `{ "results": [...] }`
- Detail tools → `{ "item": {...} }`

Common metadata: `visibility`, `access`, `type`, `id`, `owner`, `url`, `likes`, `downloads`, `updatedAt`.

## Searches
- `hf_models_search(query, owner?, task?, tags?, sort?, direction?, limit=10)`
- `hf_datasets_search(query, owner?, tags?, sort?, direction?, limit=10)`
- `hf_spaces_search(query, owner?, tags?, sort?, direction?, limit=10)`
- `hf_site_search(query, limit=10)` — Blog/Learn/Docs discovery (plain links)

## Details
- `hf_model_info(repo_id)`
- `hf_dataset_info(repo_id)`
- `hf_space_info(repo_id)`
- `hf_user_info(username)`
- `hf_collections_list(owner)` / `hf_collection_get(owner, slug)`
- `hf_paper_info(arxiv_id)` / `hf_paper_repos(arxiv_id)` / `hf_daily_papers(date?)`
- `hf_repo_info(repo_type, repo_id)`

## Parsing rules (important)
- `web_search` → returns plain text. Do not `json.loads`.
- `hf_*` tools → return JSON as a string. Always `json.loads(...)` before indexing.

## Examples
- “Find top Stable Diffusion models.”
- “Datasets for Spanish sentiment analysis.”
- “Spaces for document Q&A.”