custo-sessao

Auto-dedução: sem argumentos, busca o arquivo JSONL com mtime mais recente cujo idle ≤ 30min — assume que é a sessão ativa em curso. Útil para statusline / on-the-fly check.

Lê: o arquivo JSONL da sessão (~/.claude/projects/<slug>/<sessionId>.jsonl).

Cria/Atualiza: nada por default. Com --persist, grava em .planning/costs/<ts>-cost-session.json.

Após: o user vê session_id, started_at, last_activity_at, total_usd, breakdown by_model e flags de qualidade.

Disambiguation: sobre USD/tokens reais da sessão de chat Claude. NÃO é métricas internas do MCP server (use metrics-snapshot para isso). Ver skill cost-tracking.

• <session_id> — UUID da sessão. Omita para auto-deduzir.
• --refresh-pricing — opt-in models.dev fallback. Side-effects de rede + cache.
• --persist — salva snapshot em .planning/costs/.

Cross-reference: SSOT do shape e do auto-deduz é a skill cost-tracking. Algoritmo de auto-dedução: arquivo JSONL com mtime mais recente cujo now - mtime ≤ max_idle_ms (default 30min).

1. Parsear argumentos

SESSION_ID=$(echo "$ARGUMENTS" | awk '{for(i=1;i<=NF;i++) if($i !~ /^--/) {print $i; exit}}')
REFRESH=$(echo "$ARGUMENTS" | grep -oE -- '--refresh-pricing' | head -1)
PERSIST=$(echo "$ARGUMENTS" | grep -oE -- '--persist' | head -1)

2. Invocar MCP tool cost-session

Chame cost-session com:

{
  "session_id": "<id ou omitir para auto-deduzir>",
  "refresh_pricing": <true se --refresh-pricing, senão omitir>,
  "persist": <true se --persist, senão omitir>
}

3. Renderizar resultado

═══════════════════════════════════════════════════════════
 kit-mcp ▸ COST-SESSION ▸ <session_id>
═══════════════════════════════════════════════════════════
 Iniciada: <started_at>
 Última atividade: <last_activity_at>
 Source: <source_file>

 Total: $<total_usd> | <entry_count> entries | pricing snapshot age: <pricing_staleness_days>d

 Por modelo:
 - <model>: $<usd> (<input_tokens> in / <output_tokens> out / <cache_read_tokens> cache_read)
 ...

 Qualidade:
 - dedup: <deduped_count>
 - skipped: <skipped_entry_count>
 - parse errors: <parse_error_count>
 - unknown_models: <list ou "none">

 [Se pricing_warning:] AVISO: <pricing_warning>
 [Se persisted_to:] Snapshot salvo: <persisted_to>
═══════════════════════════════════════════════════════════