Skip to content

v1.2.0 - ZDR, rotacion multi-key y errores accionables

Latest

Choose a tag to compare

@JoshRob297 JoshRob297 released this 31 Oct 18:34
0b89932

Agregado

  • ZDR opt-in. Con CMD_ZDR=1 cada request a api.commandcode.ai lleva x-cmd-zdr: 1.
    Sin opt-in se elimina cualquier x-cmd-zdr enviada por el cliente. La cabecera solo se
    aplica en el host estricto de Command Code (nunca en un lookalike que comparta la ruta).
  • Rotacion multi-key con cooldowns. Pool de 2 o mas keys via COMMANDCODE_API_KEYS,
    COMMANDCODE_KEYS_FILE o ~/.config/commandcode/keys.txt. Cooldowns: 402 y 401/403 = 24h,
    429 = Retry-After hasta 6h (5m por defecto), 5xx no culpa a la key. Si todas estan en
    cooldown gana la que se recupera antes. Estado solo con etiquetas (commandcode-keys-state.json,
    0600) y log sin secretos (commandcode-rotation.log). Con una sola key no cambia nada.
  • Errores accionables. Los envelopes JSON de error conservan status y forma, pero agregan
    una pista de resolucion: 402 (creditos u otra cuenta), MODEL_NOT_IN_PLAN (otro modelo o
    upgrade), 401/403 (reemplazar o rotar), 429 (esperar o rotar), unsupported_model
    (Anthropic-shaped, solo /messages). El status nunca se reescribe. Log en
    commandcode-errors.log.

Verificacion

  • bun test: 131 tests, 0 fail (nuevos zdr.test.ts, pool.test.ts, errors.test.ts).
  • bunx tsc --noEmit: limpio.
  • CI verify: pass en los PR #8, #9, #10 y #11.
  • En vivo: x-cmd-zdr: 1 -> HTTP 200; rotacion 402 -> siguiente key; 429 con Retry-After
    registrado en el estado.

Notas de operacion

  • La rotacion es opt-in: requiere un pool con 2 o mas keys.
  • providers.commandcode.settings.apiKey = {file:...} se resuelve al arrancar el daemon:
    cambiar la key exige opencode service restart.
  • Claude en Command Code es Anthropic-shaped (/provider/v1/messages); el transporte acepta
    Bearer y x-api-key, pero en INDIVIDUAL-GOAT responde 403 MODEL_NOT_IN_PLAN.