---
name: check-usage-http
description: Check provider usage via HTTP fast path (~2s, zero CLI tokens). PRIMARY action when the bridge fails to read usage. Falls back to `check-usage-tui` if HTTP returns RATE_LIMIT or fails.
allowed-tools: Bash(python3 *)
---

# Skill — Check usage via HTTP (rapido, ~2s, ZERO token)

## QUANDO USARLA

**Primario** quando ricevi `[BRIDGE FAILURE]` (= il bridge non riesce a leggere usage). HTTP è veloce, gratis (no spawn TUI), e quasi sempre funziona — solo Anthropic rate-limita aggressivamente con tick rapidi.

Ordine di fallback: **HTTP → TUI → FATAL**.

## Step 1 — Leggi provider attivo

```bash
python3 -c "import json; print(json.load(open('/jht_home/jht.config.json'))['active_provider'])"
```

Output: `claude` / `kimi` / `codex`.

## Step 2 — Chiama HTTP via libreria del bridge

Usa le funzioni `fetch_*_api` esposte da `sentinel-bridge.py` come libreria:

```bash
python3 -c "
import importlib.util
spec = importlib.util.spec_from_file_location('br', '/app/.launcher/sentinel-bridge.py')
br = importlib.util.module_from_spec(spec); spec.loader.exec_module(br)
print(br.fetch_claude_api())   # claude → /api/oauth/usage
# OPPURE: br.fetch_kimi_api()  # kimi  → /coding/v1/usages
# OPPURE: br.fetch_codex_rollout()  # codex → file rollout JSONL locale
"
```

Output Python dict:

```python
{'usage': 42, 'reset_at': '20:10', 'weekly_usage': 25}
```

## Step 3 — Gestisci edge cases

### Anthropic 429 (rate-limit)

`fetch_claude_api()` ritorna la stringa `"RATE_LIMIT"` invece del dict. Cooldown interno 5 min: prima di quello tornerà ancora `"RATE_LIMIT"`. Significa: HTTP non disponibile per 5 min → cadi su L2 (TUI worker).

### None / empty

API down, credenziali scadute, file rollout codex assente. Cadi su L2.

## Step 4 — Scrivi sample nel JSONL

```bash
python3 /app/shared/skills/usage_record.py --manual \
    --usage <X> \
    --reset-at <HH:MM> \
    --weekly <W> \
    --provider <claude|kimi|openai> \
    --source sentinella-api
```

Lo script chiama internamente `compute_metrics` → calcola velocità, projection, status, throttle. Stampa il sample completo come JSON.

## Step 5 — Procedi con la decisione

Hai ora un sample fresco con `usage`, `proj`, `status`. Aggiorna la tua memoria interna (vedi skill `memory-state`) e decidi se mandare ordine al Capitano (vedi skill `order-formats`).

## Note

- **No spawn tmux**, no token CLI consumati. ~2s totali.
- **Per Kimi e Codex**: l'API è stabile, quasi sempre il check va liscio.
- **Per Claude**: con tick troppo rapidi (< 2 min) Anthropic rate-limita. Se vedi `RATE_LIMIT` → cadi subito su TUI fallback (skill `check-usage-tui`).