From 5e763a2e37e07d309bf9a2344f6505ec59ebd0f6 Mon Sep 17 00:00:00 2001
From: Adriano Dal Pastro <adrianodalpastro@tielogic.com>
Date: Mon, 25 May 2026 21:08:15 +0000
Subject: [PATCH] docs: add /api/models endpoint to README and CLAUDE.md

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
---
 CLAUDE.md | 1 +
 README.md | 9 +++++++++
 2 files changed, 10 insertions(+)

diff --git a/CLAUDE.md b/CLAUDE.md
index 1ebeabb..47935c4 100644
--- a/CLAUDE.md
+++ b/CLAUDE.md
@@ -53,6 +53,7 @@ Three tables in SQLite:
 All require `X-Api-Key` header. All responses use envelope: `{success, data, error}`.
 
 - `GET /api/health` — health check (DB + worker)
+- `GET /api/models` — list available Claude models (aliases + default)
 - `POST|GET /api/topics`, `GET|PUT|DELETE /api/topics/{id}` — topic CRUD
 - `POST /api/topics/{id}/summarize` — regenerate complete topic summary
 - `POST /api/requests` (202) — submit prompt (async queue), `GET|DELETE /api/requests[/{id}]`
diff --git a/README.md b/README.md
index 8b66527..a889da3 100644
--- a/README.md
+++ b/README.md
@@ -62,6 +62,15 @@ Documentazione interattiva:
 - Swagger UI: `https://opus-agent.tielogic.xyz/docs`
 - ReDoc: `https://opus-agent.tielogic.xyz/redoc`
 
+### Modelli disponibili
+
+```bash
+curl http://localhost:8000/api/models -H "X-Api-Key: TUA_KEY"
+```
+
+Ritorna i modelli disponibili dall'SDK (`default`, `opus`, `sonnet`, `opusplan`) e il modello
+di default configurato. Gli alias possono essere usati nel campo `model` di topic e richieste.
+
 ### Esempio d'uso
 
 ```bash