Skip to content

fix(executor): las herramientas de una conexión ya no desaparecen mientras se reconstruye su catálogo - #42

Merged
fforres merged 1 commit into
skywardfrom
fforres/catalog-rebuild-upsert
Nov 14, 2026
Merged

fforres merged 1 commit into
skywardfrom
fforres/catalog-rebuild-upsert

Conversation

@fforres

@fforres fforres commented Nov 14, 2026

Copy link
Copy Markdown

Qué cambia para quien usa Executor

Las herramientas de una conexión ya no desaparecen por un instante mientras Executor reconstruye su catálogo. Ese instante hacía que invoke respondiera «Tool not found or blocked by policy» a llamadas válidas. El 13 de noviembre botó el deploy de main (machines.machine_exec) y, en los mismos segundos, llamadas del agente de Skywardin.

Por qué pasaba

La reconstrucción borraba todas las filas de tool y definition de la conexión y después las volvía a insertar. En D1, transaction() no es atómico (D1 no admite transacciones interactivas), así que cada sentencia se confirma sola:

  • Entre el borrado y la inserción, quien lista herramientas ve el catálogo vacío.
  • Dos isolates que reconstruyen la misma conexión a la vez chocan al insertar (UNIQUE constraint failed: tool.tenant, …, tool.name). La reconstrucción que falla no marca tools_synced_at, así que la siguiente lectura reconstruye otra vez. En producción ese error aparece cada ~3,5 s: 359 veces el 13 de noviembre.

El cambio

La reconstrucción ahora hace upsert de las filas nuevas (sobre tool_uidx y definition_uidx) y después borra solo las herramientas que ya no están. Quien lee ve las filas viejas o las nuevas, nunca un catálogo vacío, y dos reconstrucciones a la vez ya no chocan. Un catálogo nuevo vacío sigue vaciando la conexión, como antes. created_at se conserva.

Cómo se probó

packages/core/sdk/src/connections.test.ts, bloque «tool catalog rebuild on an engine without interactive transactions». Los tests usan un motor sin transacciones interactivas, como D1, y fuerzan con statementGate el intercalado entre dos executors que comparten la base:

  • Con el código anterior fallan 2 de 3: «rebuilds that overlap across executors both succeed and keep each tool once» y «a rebuild never exposes an empty catalog to concurrent readers».
  • Con este cambio pasan los 3. La suite completa de packages/core/sdk pasa (1019 tests).

Lo que no cubren los tests: el camino de batch nativo de D1, que vuelve atómico un upsert de varias sentencias, no existe en libsql. Después del deploy, la prueba en producción es que el error UNIQUE de d1_all en executor-cloudflare baje a cero.

…nstead of delete and insert

On engines without interactive transactions (Cloudflare D1) the delete and
insert statements auto-commit, so readers saw an empty catalog between them
and overlapping rebuilds failed on the unique tool index. Upsert the new rows
on the unique key, then delete only the rows that are no longer produced.
@fforres
fforres merged commit 23ef707 into skyward Nov 14, 2026
4 of 41 checks passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant