Versiones compatibles
Esta página es una traducción automática de la página en inglés, que prevalece. Machine-translated from the English page, which is authoritative.
Las versiones N y N−1 reciben correcciones, y un SDK en X.Y funciona con un servidor en X.Y o X.(Y−1). Loom
publica una sola versión para el servidor, las dos imágenes, la aplicación web, ambos SDK, las skills raíz y el appVersion del
chart de Helm (proceso de publicación). Esta página también cubre
los plugins de agentes de programación y cómo se anuncia un cambio que elimina algo.
Líneas de versiones
| Línea | Qué recibe |
|---|---|
| N | la versión menor más reciente (X.Y): todas las correcciones, como versión de parche (X.Y.(Z+1)) cuando no pueden esperar |
| N−1 | la versión menor anterior: correcciones de seguridad y correcciones de pérdida de datos o de respuestas erróneas, como parches |
| N−2 | ninguna: actualice a N o N−1 |
Una versión menor sale de main aproximadamente cada dos semanas; un parche sale de la rama
release/X.Y de la línea, con la corrección fusionada antes en main. Una actualización sigue
las actualizaciones; dos versiones adyacentes funcionan en paralelo mientras una reemplaza a la otra
(actualizaciones progresivas).
SDK y servidores
Los SDK (clickhouse-loom en PyPI, @clickhouse/loom en npm) se publican con cada versión, con
la versión del servidor; el latest de npm apunta a la versión final más alta, y un parche de una línea anterior usa su
dist-tag release-X.Y. Frente al servidor más antiguo:
- un campo que el SDK envía y que el servidor más antiguo no conoce se atiende y se nombra en
ignored_argsde la respuesta, excepto en una op que cambia el estado, donde una clave que el servidor interpreta como un error ortográfico de uno de sus campos (un nombre cercano, un sinónimo, una palabra del nombre de un campo) se rechaza con422 UNKNOWN_ARGUMENTy no se escribe nada (campos desconocidos y eliminados); - una operación que el servidor más antiguo no atiende responde
404, que los SDK lanzan comoNotFound(Pythonloom.errors.NotFound, TypeScriptNotFound): una llamada nunca tiene éxito en silencio frente a un servidor que no puede realizarla. El mismo error significa que falta una fila, así que un cliente que deba distinguir ambos casos leeops.capabilitiesal arrancar (descubrir qué atiende un despliegue).
Una versión mayor (X.0) puede romper la regla frente al último servidor (X−1).Y; sus notas de la versión
indican qué necesita un SDK en X.0.
Un SDK más antiguo sigue funcionando con un servidor más reciente mientras el servidor atienda lo que llama; una eliminación sigue la regla de abajo.
Plugins de agentes de programación
Los plugins de Claude Code y Codex tienen su propia versión e indican el servidor más antiguo que sus
hooks admiten (MIN_SERVER_VERSION en lib/server-version.mjs). Una sesión contra un servidor más
antiguo empieza con una línea loom: que lo indica, y el plugin sigue funcionando donde puede
(Claude Code). El plugin de Claude Code requiere Claude Code
2.1.139 o posterior, la primera versión que ejecuta los args de un hook sin shell.
Eliminar algo
Una eliminación se anuncia, a mano en el pull request de la versión, en las notas de la versión menor
anterior a la que la elimina, bajo “What changed for clients”. Hasta la eliminación, el
servidor atiende el campo o la op antigua; después, un campo de solicitud eliminado se sigue aceptando y se nombra
en ignored_args, de modo que un cliente que lo envía se entera del cambio sin fallar, y una op eliminada
responde 404 (NotFound), lo que ops.capabilities distingue de una fila ausente.
Artefactos de la versión
Cada imagen de la versión se construye en la arquitectura en la que se ejecuta, se analiza en busca de vulnerabilidades críticas
con corrección disponible, y se publica con su procedencia y un SBOM. El índice multiarquitectura de cada imagen lleva una
firma sin clave del flujo de trabajo de publicación; imágenes de contenedor
da el comando cosign verify. Cada archivo de la GitHub Release se firma del mismo modo, en un
<file>.sigstore.json junto a él; archivos de la versión da el
comando cosign verify-blob.