@gtrabanco/pi-nan-provider 0.6.11 → 0.8.0

package/README.es.md

@@ -1,7 +1,7 @@
 # @gtrabanco/pi-nan-provider
 
 [![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
-[![Version](https://img.shields.io/badge/version-0.6.5-blue)](https://github.com/gtrabanco/pi-nan-provider/releases)
+[![Version](https://img.shields.io/badge/version-0.8.0-blue)](https://github.com/gtrabanco/pi-nan-provider/releases)
 
 [NaN Builders](https://nan.builders) model provider + MCP bridges para [pi](https://github.com/earendil-works/pi). 
 
@@ -156,74 +156,99 @@ bun run check-nan-mcp-server --issue    # crea/refresca el issue
 
 ## 📊 Uso de Cuotas: `/nan-usage`
 
-Muestra tu uso de tokens de NaN por modelo, los límites mensuales y el tiempo hasta el reinicio del ciclo de facturación.
+Muestra tu uso de tokens de NaN por modelo combinado con los límites mensuales documentados, los totales de la ventana, tus totales acumulados y el tiempo hasta el reinicio del ciclo de facturación.
 
 ### Cómo funciona
 
-`/nan-usage` lee el token de sesión desde `~/.config/nan/session.json` — el mismo archivo que usa la [CLI de NaN](https://github.com/helmcode/nan-cli). Si el archivo existe y contiene una sesión válida, el comando obtiene datos de uso reales del dashboard de NaN. Si no, muestra los límites de cuota estáticos de la documentación.
+`/nan-usage` llama al endpoint [`GET /v1/usage`](https://nan.builders/docs/api#tag/usage) de NaN con **la misma API key que ya usas para chat** — la credencial guardada en pi (`/login nan`) o `NAN_API_KEY`. Sin login de la CLI, sin cookie de sesión, sin configuración extra.
+
+El endpoint devuelve tu uso (filas por fecha y modelo) y los totales de la ventana solicitada — máximo 90 días inclusivos. El comando lee esos totales y los combina con los límites publicados en la [documentación de NaN](https://nan.builders/docs/models) para mostrarte qué porcentaje de cada cuota mensual has consumido. `/usage` solo reporta consumo, así que los límites siempre vienen de la tabla documentada (comprobado 2026-09-27).
+
+Límite de tasa: 30 peticiones por minuto para `/usage`, separado del de los endpoints de modelos.
+
+### Uso
+
+```
+/nan-usage        # mes en curso en UTC (coincide con las cuotas mensuales)
+/nan-usage 7      # ventana móvil de 7 días (1-90)
+/nan-usage 30     # ventana móvil de 30 días
+/nan-usage help   # muestra la línea de uso
+```
 
 ### Configuración
 
-1. **Instala la CLI de NaN**:
-   ```bash
-   curl -fsSL https://nan.builders/install | sh
+1. **Autentica el proveedor `nan` en pi** con tu clave `sk-...`:
+   ```
+   /login nan
    ```
-2. **Inicia sesión**:
+   o expórtala en su lugar:
    ```bash
-   nan auth login
+   export NAN_API_KEY=sk-...
    ```
-   Te envía un enlace de inicio de sesión por email. Pega el enlace en la terminal.
-3. **Usa en pi**:
+2. **Úsalo en pi**:
    ```
    /nan-usage
    ```
 
 > [!TIP]
-> El token de sesión se comparte automáticamente — no necesitas variables de entorno ni configuración extra. Si la sesión expira, ejecuta `nan auth login` de nuevo.
+> ¿No se resuelve ninguna API key? El comando muestra la tabla estática de cuotas de la documentación y te indica cómo autenticarte.
 
 ### Lo que ves
 
-**Con sesión válida** (uso real):
+**Con API key** (uso real):
 ```
-📊 NaN Quota Status
+📊 NaN Usage
+
+🗓️  Window: 2026-09-01 → 2026-09-27 UTC (27 days)
 
-⏱️  Next billing reset: 2026-10-01 UTC (8d 14h 32m 15s)
+⏱️  Next billing reset: 2026-09-30 UTC (2d 14h 30m 0s)
 
 Models with monthly caps:
 
 DeepSeek V4 Flash:
-  [████████░░░░░░░░░░░░] 40.2%
-  Used: 1.2B / 3.0B (1.8B remaining)
+  [████████░░░░░░░░░░░░] 40.0% of monthly cap
+  Used: 1.2B / 3.0B (1.8B remaining) · 5,120 requests
 
 MiMo V2.5:
-  [██░░░░░░░░░░░░░░░░░░] 12.5%
-  Used: 125.0M / 1.0B (875.0M remaining)
+  [███░░░░░░░░░░░░░░░░░] 12.5% of monthly cap
+  Used: 125.0M / 1.0B (875.0M remaining) · 840 requests
+
+GLM 5.3 👑:
+  [████████░░░░░░░░░░░░] 40.0% of monthly cap
+  Used: 1.2B / 3.0B (1.8B remaining) · 2,400 requests
+  ↳ rolling window: 400.0M / 4h (daily granularity — /usage cannot break it down)
 
 Uncapped models:
 
-Qwen 3.6: 890.5K used
-Gemma 4: 234.1K used
+Qwen 3.6: 890.5K used · 123 requests
+
+Window totals: 2.6B tokens (2.0B prompt / 640.0M completion) · 18,432 requests
+All time: 13.2B tokens · 41,250 requests (cached 2026-02-01)
+💡 Source: GET /v1/usage · caps from https://nan.builders/docs/models
 ```
 
-**Sin sesión** (solo límites estáticos):
+**Sin API key** (solo límites estáticos):
 ```
 📊 NaN Quota Status (static limits)
 
-⏱️  Next billing reset: 2026-10-01 UTC (8d 14h 32m 15s)
+⏱️  Next billing reset: 2026-09-30 UTC (2d 14h 30m 0s)
 
 Model                        Monthly Cap
 ─────────────────────────────────────────────────
 DeepSeek V4 Flash            3.0B
 MiMo V2.5                    1.0B
+MiMo V2.6 Flash              1.0B
 Qwen 3.6                     uncapped
 Gemma 4                      uncapped
 Qwen 3.8 Flash               500.0M
 GLM 5.3 Flash                2.0B
-GLM 5.3 👑                   3.0B (rolling 400.0M/4h)
+GLM 5.3                      3.0B 👑 (rolling 400.0M/4h)
 
-💡 Run `nan auth login` to see real usage data.
+💡 Set NAN_API_KEY or run `/login nan` to see real usage (GET /v1/usage).
 ```
 
+Los errores siguen siendo accionables: `401` → ejecuta `/login nan` o corrige `NAN_API_KEY`, `404` → la cuenta no tiene identidad de uso que reportar, `429` → reintenta tras los segundos de `Retry-After`.
+
 ---
 
 ## 📊 Modelos

package/README.md

@@ -1,7 +1,7 @@
 # @gtrabanco/pi-nan-provider
 
 [![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
-[![Version](https://img.shields.io/badge/version-0.6.5-blue)](https://github.com/gtrabanco/pi-nan-provider/releases)
+[![Version](https://img.shields.io/badge/version-0.8.0-blue)](https://github.com/gtrabanco/pi-nan-provider/releases)
 
 [NaN Builders](https://nan.builders) model provider + MCP bridges for [pi](https://github.com/earendil-works/pi). 
 
@@ -156,74 +156,99 @@ bun run check-nan-mcp-server --issue    # create/refresh the issue
 
 ## 📊 Quota Usage: `/nan-usage`
 
-Shows your NaN token usage per model, monthly limits, and time until the billing cycle resets.
+Shows your NaN token usage per model merged with the documented monthly caps, the window totals, your all-time totals, and the time until the billing cycle resets.
 
 ### How it works
 
-`/nan-usage` reads the session token from `~/.config/nan/session.json` — the same file the [NaN CLI](https://github.com/helmcode/nan-cli) uses. If the file exists and contains a valid session, the command fetches real usage data from NaN's dashboard. Otherwise, it shows static quota limits from the docs.
+`/nan-usage` calls NaN's [`GET /v1/usage`](https://nan.builders/docs/api#tag/usage) endpoint with the **same API key you already use for chat** — pi's stored credential (`/login nan`) or `NAN_API_KEY`. No CLI login, no session cookie, no extra setup.
+
+The endpoint returns your usage (rows per date and model) plus totals covering the requested window — at most 90 inclusive days. The command reads those totals and merges them with the caps published in the [NaN docs](https://nan.builders/docs/models) to show how much of each monthly cap you have consumed. `/usage` reports consumption only, so the caps themselves always come from the documented table (checked 2026-09-27).
+
+Rate limit: 30 requests per minute for `/usage`, separate from the model endpoints.
+
+### Usage
+
+```
+/nan-usage        # current UTC month (matches the monthly caps)
+/nan-usage 7      # rolling 7-day window (1-90)
+/nan-usage 30     # rolling 30-day window
+/nan-usage help   # show the usage line
+```
 
 ### Setup
 
-1. **Install the NaN CLI**:
-   ```bash
-   curl -fsSL https://nan.builders/install | sh
+1. **Authenticate the `nan` provider in pi** with your `sk-...` key:
+   ```
+   /login nan
    ```
-2. **Log in**:
+   or export it instead:
    ```bash
-   nan auth login
+   export NAN_API_KEY=sk-...
    ```
-   This sends a sign-in link to your email. Paste the link back into the terminal.
-3. **Use in pi**:
+2. **Use in pi**:
    ```
    /nan-usage
    ```
 
 > [!TIP]
-> The session token is shared automatically — no env vars or extra config needed. If the session expires, run `nan auth login` again.
+> No API key resolves? The command falls back to the static quota table from the docs and tells you how to authenticate.
 
 ### What you see
 
-**With a valid session** (real usage):
+**With an API key** (real usage):
 ```
-📊 NaN Quota Status
+📊 NaN Usage
 
-⏱️  Next billing reset: 2026-10-01 UTC (8d 14h 32m 15s)
+🗓️  Window: 2026-09-01 → 2026-09-27 UTC (27 days)
+
+⏱️  Next billing reset: 2026-09-30 UTC (2d 14h 30m 0s)
 
 Models with monthly caps:
 
 DeepSeek V4 Flash:
-  [████████░░░░░░░░░░░░] 40.2%
-  Used: 1.2B / 3.0B (1.8B remaining)
+  [████████░░░░░░░░░░░░] 40.0% of monthly cap
+  Used: 1.2B / 3.0B (1.8B remaining) · 5,120 requests
 
 MiMo V2.5:
-  [██░░░░░░░░░░░░░░░░░░] 12.5%
-  Used: 125.0M / 1.0B (875.0M remaining)
+  [███░░░░░░░░░░░░░░░░░] 12.5% of monthly cap
+  Used: 125.0M / 1.0B (875.0M remaining) · 840 requests
+
+GLM 5.3 👑:
+  [████████░░░░░░░░░░░░] 40.0% of monthly cap
+  Used: 1.2B / 3.0B (1.8B remaining) · 2,400 requests
+  ↳ rolling window: 400.0M / 4h (daily granularity — /usage cannot break it down)
 
 Uncapped models:
 
-Qwen 3.6: 890.5K used
-Gemma 4: 234.1K used
+Qwen 3.6: 890.5K used · 123 requests
+
+Window totals: 2.6B tokens (2.0B prompt / 640.0M completion) · 18,432 requests
+All time: 13.2B tokens · 41,250 requests (cached 2026-02-01)
+💡 Source: GET /v1/usage · caps from https://nan.builders/docs/models
 ```
 
-**Without a session** (static limits only):
+**Without an API key** (static limits only):
 ```
 📊 NaN Quota Status (static limits)
 
-⏱️  Next billing reset: 2026-10-01 UTC (8d 14h 32m 15s)
+⏱️  Next billing reset: 2026-09-30 UTC (2d 14h 30m 0s)
 
 Model                        Monthly Cap
 ─────────────────────────────────────────────────
 DeepSeek V4 Flash            3.0B
 MiMo V2.5                    1.0B
+MiMo V2.6 Flash              1.0B
 Qwen 3.6                     uncapped
 Gemma 4                      uncapped
 Qwen 3.8 Flash               500.0M
 GLM 5.3 Flash                2.0B
-GLM 5.3 👑                   3.0B (rolling 400.0M/4h)
+GLM 5.3                      3.0B 👑 (rolling 400.0M/4h)
 
-💡 Run `nan auth login` to see real usage data.
+💡 Set NAN_API_KEY or run `/login nan` to see real usage (GET /v1/usage).
 ```
 
+Failures stay actionable: `401` → run `/login nan` or fix `NAN_API_KEY`, `404` → the account has no usage identity to report, `429` → retry after the `Retry-After` seconds.
+
 ---
 
 ## 📊 Models
@@ -236,9 +261,25 @@ Baseline catalog (verified against [NaN docs](https://nan.builders/docs/models)
 | `gemma4` | 262,144 | 32,768 | text, image | ✅ |
 | `deepseek-v4-flash` | 1,000,000 | 384,000 | text, image | ✅ |
 | `mimo-v2.5` | 1,048,576 | 131,072 | text, image | ✅ |
+| `mimo-v2.6-flash` | 1,048,576 | 131,072 | text, image | ✅ |
 | `glm5.3-flash` | 1,000,000 | 131,072 | text, image | ✅ |
 | `qwen3.8-flash` | 262,144 | 131,072 | text, image | ✅ |
 
+> [!NOTE]  
+> `mimo-v2.6-flash` is served by NaN but not yet listed on models.dev provider `nan`; it enters the catalog through a manual-only entry with the same limits as `mimo-v2.5`. The model will be auto-detected from models.dev once added there.
+
+---
+
+## 🧠 Reasoning controls
+
+NaN's `reasoning_effort` parameter controls how much the model thinks before answering — but the degree of control varies by model:
+
+| Model | Reasoning effort | How it works |
+| :--- | :--- | :--- |
+| `glm5.3`, `glm5.3-flash` | `low` · `medium` · `high` · `max` | Fully controllable — higher values let the model reason longer |
+| `qwen3.6`, `gemma4` | `none` · `minimal` · `low` · `medium` · `high` · `max` | `none`/`minimal` skip reasoning entirely; others cap at 2K / 8K / 16K / 32K tokens |
+| `deepseek-v4-flash`, `qwen3.8-flash`, `mimo-v2.5`, `mimo-v2.6-flash` | *(accepted but not adjustable)* | The parameter is accepted and never rejected, but the model manages its own reasoning depth — it is never an error to send a value these models don't adjust |
+
 ---
 
 ## 🚀 Development

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@gtrabanco/pi-nan-provider",
-	"version": "0.6.11",
+	"version": "0.8.0",
 	"description": "NaN Builders (api.nan.builders) model provider for pi - OpenAI-compatible registration with a models.dev-generated fallback, tier-aware live catalog, and MCP bridges (official web search + optional community media server)",
 	"keywords": [
 		"pi",
@@ -38,7 +38,8 @@
 		"check-nan-mcp-server": "bun run scripts/check-nan-mcp-server.ts",
 		"prepublishOnly": "bun run generate-models && bun test && bun run typecheck",
 		"test": "bun test",
-		"typecheck": "bunx tsc --noEmit"
+		"typecheck": "bunx tsc --noEmit",
+		"check-pi-sdk-versions": "node scripts/check-pi-sdk-versions.mjs --report"
 	},
 	"peerDependencies": {
 		"@earendil-works/pi-ai": ">=0.83.0 <1",