Repository navigation
Releases
v1.2.0 - ZDR, rotacion multi-key y errores accionables
Agregado
- ZDR opt-in. Con
CMD_ZDR=1cada request aapi.commandcode.aillevax-cmd-zdr: 1.
Sin opt-in se elimina cualquierx-cmd-zdrenviada 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_FILEo~/.config/commandcode/keys.txt. Cooldowns: 402 y 401/403 = 24h,
429 =Retry-Afterhasta 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 (nuevoszdr.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 exigeopencode service restart.- Claude en Command Code es Anthropic-shaped (
/provider/v1/messages); el transporte acepta
Bearer yx-api-key, pero en INDIVIDUAL-GOAT responde403 MODEL_NOT_IN_PLAN.
v1.0.6 - Soporte reasoning_content y CLI 1.88.0
Repara compatibilidad con modelos que exigen historial de reasoning_content (ej: reflection/beam:free) y actualiza la version rastreada del CLI a 1.88.0.
v1.0.5 - TTL de catalogo reducido a 6h
Se reduce el TTL de cache del catalogo de 12h a 6h (CATALOG_TTL_MS) para descubrir el doble de rapido las rotaciones de modelos, nuevos modelos promo/free y deprecaciones upstream.
v1.0.4 - limite de salida 32k (DeepSeek 1017 al maximo)
Limite de salida por modelo corregido: OpenCode envia limit.output como
max_completion_tokens, y el plugin lo tenia fijo en 16.384 para todos los modelos,
capando cada respuesta sin importar lo que el modelo soporte.
Que cambio
- Default 32.768, el valor mas alto seguro para todo el catalogo: el minimo declarado
en el providercommandcodede models.dev es exactamente 32.768 (Qwen3.8-27B y
Ling 3.1 Flash). El build DeepSeek V4.1 Flash 1017 declara 393.216. COMMANDCODE_OUTPUT_TOKENSsobreescribe el limite por proceso.- Los 28 modelos estaticos de
opencode.jsonllevabanoutput: 16384, que ganaba sobre
el plugin. Los limites ahora los define solo el plugin.
Verificacion
- Medido con un provider eco local: el request sale con
max_completion_tokens: 32768
por defecto y131072con el override. - 84 tests offline en verde, typecheck estricto limpio.
- En vivo: 83 modelos de Command Code, 0 Claude, Google 4, OpenCode Zen 10.
v1.0.3 - orden del catalogo y bloqueo de modelos ajenos
Orden del catalogo en el selector y bloqueo de los modelos ajenos que models.dev
mezclaba en el provider.
Orden en el selector
El picker ordena por (badge Free, fecha de release, titulo), asi que el plugin ahora
escribe dos campos que antes no tocaba:
costcon input en cero para los modelos promo: otorga el badgeFreey ademas
reporta su costo real como cero.time.releasedcodificando el rango de familia y la recencia de la version.
Resultado: los promo primero, despues las familias agrupadas (Claude, GPT, Gemini,
DeepSeek, Kimi, GLM, MiniMax, Qwen...) y, dentro de cada familia, la version mas nueva
primero. Verificado en la TUI real: 5 modelos con badge Free arriba y gpt-6.1-sol
antes que gpt-6-sol antes que gpt-5.6-sol.
Bloqueo de modelos ajenos
models.dev publica su propio provider commandcode, y OpenCode lo mezcla con el que
declara el config. Ese merge reintrodujo los 11 modelos claude-* de forma Anthropic,
que responden 400 unsupported_model en el transporte compatible con OpenAI. El
transform del catalogo ahora desactiva todo modelo del provider que no forme parte del
catalogo curado.
Verificacion
- 84 tests offline en verde (3 en la suite live opcional).
- Typecheck estricto sin errores.
- En vivo: 84 modelos de Command Code, 0 Claude, 5 promo con badge.
v1.0.2 - atribucion de reintentos al modelo que falla
Correccion de la telemetria de reintentos: los reintentos ahora se atribuyen al modelo
que fallo, con el agente, el numero de intento y el delay de backoff.
Que pasaba
El hook retry de OpenCode v2.0.32 expone el modelo como model.id / model.providerID.
No existe un campo modelID, asi que el plugin leia un campo inexistente y registraba
undefined en las 175 entradas acumuladas. Sin atribucion no se podia saber que modelo
estaba fallando ni distinguir un timeout upstream de un loop de reintentos del runtime.
Forma real del evento, capturada con un servidor sonda que corta el stream a mitad:
{
"sessionID": "ses_...",
"agent": "build",
"model": { "id": "probe-model", "providerID": "probe" },
"error": { "type": "provider.transport", "message": "... ECONNRESET ...", "status": 200 },
"attempt": 2,
"decision": { "retry": true, "delay": 2281 }
}Cambios
src/telemetry.ts: helpers puros para normalizar el evento de reintento.- El log de reintentos registra ahora
modelID,providerID,agent,attempt,
retryydelayMs. - Documentacion de troubleshooting (ingles y espanol) sobre como atribuir resets por
modelo y como leer el gap entre entradas.
Verificacion
- 67 tests offline en verde, 3 en la suite live opcional.
- Typecheck estricto sin errores.
- Paridad de encabezados EN/ES verificada.
v1.0.1 - instalacion desde GitHub (github:) y auto-descubrimiento documentado
Instalacion directa desde GitHub, sin npm y sin build, y documentacion del
auto-descubrimiento de plugins.
Instalar:
// ~/.config/opencode/opencode.json
{
"plugins": ["github:JoshRob297/opencode-commandcode"]
}Added
- Instalacion directa desde GitHub con el especificador
github:, verificada de punta a
punta en un HOME aislado: OpenCode clono el repositorio a su cache, cargoindex.ts
(loading plugin id=github:JoshRob297/opencode-commandcode, 0 fallos) y completo un
turno de inferencia. Sin publicacion en npm y sin paso de build. - Seccion de troubleshooting sobre la asimetria del auto-descubrimiento: un plugin que se
quita deopencode.json, o que se renombra dentro de~/.config/opencode/plugins/,
se sigue cargando hasta que el directorio sale deplugins/; entonces el watcher lo
descarga en vivo, sin reiniciar el servicio.
Changed
- El readme y la documentacion de configuracion (ingles y espanol) describen las tres
vias de instalacion: especificador de GitHub (recomendada), clon local y directorio de
plugins auto-descubierto.
Verificacion
- 61 tests offline en verde, 3 en la suite live opcional.
- Typecheck estricto sin errores.
- Paridad de encabezados EN/ES verificada en readme y troubleshooting.
- Instalacion desde GitHub probada contra el repositorio publico en un entorno aislado.
v1.0.0 - descubrimiento dinamico, hardening de credenciales y docs bilingues
Plugin de resiliencia, descubrimiento dinamico de modelos y telemetria de cuota
para el proveedor Command Code en OpenCode.
Verificado contra OpenCode v2.0.32, CLI de Command Code 1.73.4 y Bun 1.4.0.
Documentacion bilingue (ingles y espanol) en README.md / README.es.md.
First modular release. Migrates the single-file commandcode-quota plugin into a
structured package with dynamic model discovery.
Added
- Dynamic model discovery from
GET /provider/v1/modelsthrough the OpenCode v2
model editor, with transport-aware filtering and automatic[FREE PROMO]
badges for free/promo tiers. - On-disk model catalog cache (12h TTL) so an upstream outage cannot leave the
provider with an empty model list at startup. - Multi-source credential resolution:
COMMAND_CODE_API_KEY,COMMANDCODE_KEY_FILE,
$XDG_CONFIG_HOME/commandcode/key.txt,/etc/environment, then the official CLI
stores under~/.commandcode/. - Strict origin guard (
isCommandCodeHost) for credential injection, plus the
COMMANDCODE_ALLOWED_HOSTSallow-list opt-in. - Bounded API calls via
AbortSignal.timeout(10s default). - Vision capability metadata (
imageinput) for multimodal models. applyModelCatalogexported for testability.- Offline test suite (58 tests) and an opt-in live suite gated by
COMMANDCODE_LIVE_TESTS. - Strict typecheck configuration (
allowImportingTsExtensions,strict,
noUncheckedIndexedAccess) withbun-types. - Documentation:
README.md,docs/ARCHITECTURE.md,docs/CONFIGURATION.md,
docs/TROUBLESHOOTING.md,LICENSE.
Changed
- State directory, key paths and the connection-close sentinel are resolved from
XDG/home instead of hardcoded/rootpaths. - Retry telemetry now ignores non-Command-Code providers, keeping
commandcode-retries.logmeaningful. - The
retrylog records the provider id and degrades gracefully when the hook
is unsupported by the running build.
Fixed
- Security: credentials were attached based on substring URL matching
(api.commandcode.aianywhere in the URL, or any URL containing
/provider/v1/chat/completions). That leaked the API key to lookalike hosts
such asapi.commandcode.ai.evil.com, to any host carrying the provider path,
and to values injected in query strings or fragments. - Anthropic-shaped models (
claude-*,/messagesonly) were registered under the
OpenAI-compatible transport and failed with400 unsupported_model. They are now
filtered out. - Free-model detection missed
-free/_free/.freeid shapes, so e.g.
poolside/laguna-s-2.1-freewas not tagged. - The sanitizer had regressed relative to the proven v1 implementation:
nulland
empty tool response content was no longer normalized, orphan detection was no
longer order-sensitive, and malformedtool_callentries were not pruned. - The sanitizer mutated the caller's message array in place instead of working on
a shallow clone. - The watchdog could fire an abort after a consumer cancellation, and a throwing
logging callback could leave the stream open. - Quota report rendering crashed on a missing window; it now degrades per field.
Removed
- Hardcoded user-specific absolute paths removed from the runtime code in favour of
XDG/home resolution. - Network calls from the default test suite.