Lunes, 16 de noviembre de 2026
Portada de las 21:50
Todos los periódicos y la radio, en unoEscrito por IA a partir de Hacker News · Cómo se hace
Hacker News
Programación · github.com

Type Server Protocol

Microsoft publica en el repositorio de Pylance la especificación del Type Server Protocol (TSP), un protocolo JSON-RPC para pedir a un servidor de tipos datos de análisis de Python. Reutiliza convenciones del Language Server Protocol y está en versión 0.4.1, con cambios que aún pueden romper compatibilidad.

Foto: vía github.com

Leer el artículo aquíArtículo original (github.com) 172 comentarios en Hacker News

Escucha la noticia3 min

El TSP es un protocolo JSON-RPC con el que un cliente pregunta a un «type server» por el análisis de Python de un espacio de trabajo. El servidor mantiene el estado del análisis y responde sobre la versión del protocolo, los snapshots, las rutas de búsqueda de Python, la resolución de imports y las consultas de tipos: calculados, declarados y esperados. Los métodos llevan el prefijo typeServer/ y el protocolo toma del LSP formas de datos como Position y Range, además de representar las URI como cadenas.

Una sesión típica empieza con la inicialización LSP habitual. Luego el cliente comprueba que la versión semver que devuelve el servidor es compatible, pide un primer snapshot y lanza consultas que lo incluyen. Un snapshot es un entero no negativo que identifica una vista del estado del análisis en un instante. El servidor lo avanza cuando un resultado previo puede haber dejado de ser válido, por ejemplo por cambios en archivos, en la configuración o en dependencias, y avisa con typeServer/snapshotChanged. Las peticiones con un snapshot obsoleto deben fallar, preferiblemente con el código ServerCancelled (-32802) de LSP.

La versión 0.4.1 añade un modo opcional de varias conexiones, pensado como mejora de rendimiento para consultas de solo lectura concurrentes. Se negocia en la inicialización mediante capabilities.experimental.typeServerMultiConnection y, por ahora, solo admite el transporte ipc. La conexión principal conserva el estado mutable (inicialización, sincronización de documentos, notificaciones), y las conexiones extra solo aceptan los mensajes TSP de lectura definidos para la versión negociada. Mientras el protocolo siga en la línea 0.x, los cambios de versión menor pueden romper compatibilidad.

El documento indica como definiciones oficiales typeServerProtocol.ts (interfaces y tipos de petición en TypeScript), tsp.json (el modelo legible por máquina) y tsp.schema.json (su esquema JSON). Los posiciones siguen LSP: líneas y desplazamientos de carácter empiezan en cero, y estos últimos se cuentan en unidades de código UTF-16.

En Hacker News

«Type Server Protocol» · puesto 27 · 264 puntos · enviado por adamnemecek

Lo que dicen los comentarios

Gran parte de la conversación gira en torno a para qué existe el protocolo. Varios comentarios citan la postura crítica del mantenedor de basedpyright, que lo ve como un intento de Microsoft de mantener Pylance relevante externalizando el análisis de tipos y reservando funciones para Pylance; Ty, de Astral, sí tiene previsto soportarlo. Otros lo describen como una extensión de LSP que ofrece consultas de tipos estructuradas y legibles por máquina, en lugar de texto para mostrar en el editor, y lamentan que no sea una extensión del propio LSP. También se discute el nombre, por ser un protocolo genérico en apariencia pero específico de Python, y la elección de UTF-16. Hay quien menciona la fragmentación entre pyright, Pylance y basedpyright, y quien duda de que sirva para otros lenguajes sin verificador de tipos oficial, como PHP, Erlang o Ruby.

  • DetachHead, mantenedor de basedpyright, ya criticó el TSP. En cambio, Ty, el verificador de tipos de Astral, aparentemente sí lo soportará.
    — nikolatt, leer el comentario
  • Debería llamarse Python Type Server Protocol. Resulta raro ocupar el espacio de nombres de un protocolo genérico para uno que solo admite Python, y más viniendo de la empresa detrás de LSP, que sí es genérico.
    — anonymous908213, leer el comentario
  • Parece una representación más estructurada del tipo. En LSP normalmente hay texto plano o markdown que se pinta en el IDE, pero nada que se pueda analizar estructuralmente. Es una pena que no sea una extensión de LSP.
    — Wilfred, leer el comentario
  • Cita la documentación de basedpyright: el protocolo sería un intento desesperado de Microsoft de evitar que Pylance quede obsoleto, no beneficia a nadie más y añade complejidad a los servidores que lo soporten.
    — nextaccountic, leer el comentario
  • Uso la extensión de Pyrefly en VSCode y Zed y lo ejecuto en la CI, y todo funciona bien. La fragmentación entre pyright, Pylance, basedpyright y otros impide obtener resultados consistentes entre IDEs.
    — PufPufPuf, leer el comentario

Pregunta sobre esta noticia

Respuestas automáticas a partir de las noticias de El Autómata, sus fuentes y la radio. Pueden contener errores: comprueba los enlaces.

Esta noticia la ha redactado una inteligencia artificial a partir de las fuentes citadas, con el criterio editorial de El Autómata (equilibrio, atribución y solo hechos publicados). Puede contener errores: consulta las fuentes originales. Modelo: claude-sonnet-5.5.