Clase 4 · 15 min
Una tool no es para siempre: la página la registra cuando la función existe y la quita cuando sale de escena. En la spec del 16/10/2026 no existe unregisterTool; quien la quita es el signal de un AbortController. Y quien llama puede cancelar una ejecución a la mitad. En esta clase ves el ciclo completo y los eventos que dispara el navegador.
Empezar la lección
Objetivo: registrar, listar, quitar con AbortSignal y cancelar una ejecución, sabiendo qué eventos dispara el navegador en cada paso.
Haz clic en cada paso.
Medido el 19/10/2026: Chromium 156 dispara los tres eventos; el polyfill 6.0.3 solo toolchange.
Fragmento de kit/scripts/ciclo.mjs (corre dentro de la página). Dos controllers: uno para el registro, otro para la llamada.
const registro = new AbortController();
await mc.registerTool({
name: 'tarefa_lenta', description: 'Leva 2 segundos. Existe só para ensinar cancelamento.',
async execute(_, { signal }) {
return new Promise((ok, falha) => {
const t = setTimeout(() => ok({ terminou: true }), 2000);
signal.addEventListener('abort', () => { clearTimeout(t); falha(new DOMException('cancelada', 'AbortError')); });
});
}
}, { signal: registro.signal });
const t = (await mc.getTools()).find(x => x.name === 'tarefa_lenta');
const chamada = new AbortController();
setTimeout(() => chamada.abort(), 100);
try { await mc.executeTool(t, {}, { signal: chamada.signal }); }
catch (e) { /* AbortError */ }
registro.abort(); // quita la tool: no existe unregisterToolcd ~/projetos/formacao-webmcp-site-v72/kit node scripts/ciclo.mjs nativo; echo "saída: $?" node scripts/ciclo.mjs polyfill; echo "saída: $?"
== Chromium 156.0.8078.4 (Playwright) · modo: nativo antes: 4 ferramentas registrou tarefa_lenta: 5 ferramentas nome repetido: recusado (InvalidStateError) execução cancelada pelo chamador: AbortError depois do abort(): 4 ferramentas eventos: toolchange toolactivated:tarefa_lenta toolcancel:tarefa_lenta toolchange saída: 0 == Chromium 156.0.8078.4 (Playwright) · modo: polyfill antes: 4 ferramentas registrou tarefa_lenta: 5 ferramentas nome repetido: recusado (InvalidStateError) execução cancelada pelo chamador: AbortError depois do abort(): 4 ferramentas eventos: toolchange toolchange saída: 0
Misma secuencia en los dos. La diferencia está en la línea "eventos": solo el nativo dispara toolactivated y toolcancel.
Si el execute no escucha signal, la cancelación rechaza la llamada, pero el trabajo continúa: el setTimeout se dispara, el fetch se completa, la reserva ocurre. En una tool con efecto, revisa signal.aborted antes de guardar.
Misma regla en cualquier framework: registrar al inicio, abortar al final.
Registra cuando la regla ya esté lista y aborta en pagehide.
Es lo que hace iniciarWebMCP en el kit.
addEventListener('pagehide', () => pagina.abort(), { once: true })
Una tool de una sola pantalla existe solo mientras la pantalla está montada.
Cambió la ruta: abort() y registra las de la pantalla nueva.
En React, registra en el efecto y aborta en el cleanup; el modo estricto monta dos veces y el nombre repetido daría InvalidStateError.
El patrón sirve para otros frameworks; la clase 7 muestra el modelo.
Si la tercera de cuatro falla, las dos primeras quedan colgadas.
El registrar() del kit usa un controller por lote y aborta todo si hay una falla.
Ensayo en los dos modos con API. Cada ejercicio termina con un listo cuando.
Ejecuta el bloque del ciclo y léelo línea por línea.
Listo cuando: node scripts/ciclo.mjs nativo → nome repetido: recusado (InvalidStateError), execução cancelada pelo chamador: AbortError, depois do abort(): 4 ferramentas y eventos: toolchange toolactivated:tarefa_lenta toolcancel:tarefa_lenta toolchange.
Ejecuta lo mismo en el polyfill y anota en tu status-webmcp.md (clase 1) lo que el polyfill no hace.
Listo cuando: node scripts/ciclo.mjs polyfill → eventos: toolchange toolchange y saída: 0; la línea está en tu archivo.
Ejecuta las pruebas de regla del kit: una de ellas simula que la 2.ª tool falla en el registro.
Listo cuando: node --test 2>&1 | grep -E "^ℹ (pass|fail)" → ℹ pass 4 y ℹ fail 0.
La explicación aparece después de la respuesta.
Pregunta 1 de 4
¿Cómo se quita una tool en la spec del 16/10/2026?
Pregunta 2 de 4
Quien llama aborta la ejecución. ¿Qué pasa con el execute?
Pregunta 3 de 4
Tu prueba espera toolactivated y corre solo en el polyfill 6.0.3. ¿Qué pasa?
Pregunta 4 de 4
En un componente React, ¿dónde va el abort()?
Elige una alternativa. La explicación aparece después de tu intento.