kolo docsbeta

Hoja de ruta

Lo que viene en Kolo: un puente local, grupos grandes, un borde web, Bluetooth LE entre peers cercanos, un SDK de JavaScript y apps. Sin fechas, y todo sigue en beta.

En esta página

Todo en Kolo está en beta. Cada biblioteca está en v0.x, y la API de cualquiera de ellas puede cambiar antes de la v1.0.0.

Esta página solo lista lo que está por venir. Lo que existe hoy está en la página de Bibliotecas. Aquí no hay fechas, y nada de lo que sigue fija una API: los nombres y las formas pueden cambiar mientras se hace el trabajo.

Los ejemplos que existen hoy están en Hecho con Kolo.

Cada elemento tiene uno de tres estados:

  • Planificado tenemos intención de construirlo y sabemos para qué sirve.
  • En exploración todavía estamos viendo si construirlo, y de qué forma.
  • Futuro una idea que queremos tener presente; todavía no hay nada investigado ni planificado.

Cada elemento muestra también su tema: Puente local, Grupos, Borde web, Peers cercanos, Red, SDK o Apps.

Planificado

Hoy usas Kolo desde Go, dentro del mismo proceso que tu app. El puente local es para un programa que no está escrito en Go, o que se ejecuta como un proceso aparte en el mismo ordenador.

  • kolo-ipc PlanificadoPuente local un canal entre un proceso de Kolo y otro programa del mismo ordenador, abierto solo al mismo usuario. Con él, una interfaz escrita en otro lenguaje puede usar un peer que se ejecuta a su lado.
  • kolo-rpc PlanificadoPuente local peticiones y respuestas sobre ese canal. El otro programa le pide algo al proceso de Kolo y recibe un resultado, sin escribir su propio formato de mensajes.
  • Una app de chat PlanificadoApps una app de chat para el día a día, construida sobre las bibliotecas de Kolo. El chat del tutorial está para enseñar; esta está pensada para usarse.
  • kolo-gossip PlanificadoGrupos una biblioteca para difundir mensajes pequeños a muchos miembros de un topic sin un relay: cada miembro pasa un mensaje a unos pocos otros hasta que todos los miembros lo tienen. Sigue la especificación GossipSub de libp2p, versión 1.1 (una Candidate Recommendation) con la regla IDONTWANT de la versión 1.2 (un Working Draft), con el formato de red propio de Kolo, y cada mensaje va firmado con la clave del dispositivo que lo escribió. Planificada, todavía sin código. Diremos qué tamaño de grupo soporta, y de qué protege, solo después de nuestra propia simulación y de las pruebas.
  • kolo-mls PlanificadoGrupos cifrado de extremo a extremo para grupos, según el estándar MLS (RFC 9420, arquitectura en RFC 9750), suite de cifrado 0x0001 (X25519, AES-128-GCM, SHA-256, Ed25519). El objetivo: una persona a la que se quita de un grupo no lee nada de lo que se envía después de que su eliminación llegue al grupo. Lo que recibió mientras era miembro se queda con ella. Planificada, todavía sin código. Diremos qué tamaño de grupo soporta, y de qué protege, solo después de nuestra propia simulación y de las pruebas.

En exploración

  • kolo-http En exploraciónBorde web una forma de que un navegador o cualquier cliente HTTP llegue a lo que sirve un peer. Una pestaña del navegador no puede abrir las conexiones UDP que usan los peers, así que necesita un peer que le responda por HTTP.
  • kolo-ble En exploraciónPeers cercanos conexiones por Bluetooth LE entre peers que están cerca. El objetivo es la misma conexión pequeña que ya reciben las capas de arriba (Conn, como en kolo-sync y kolo-braid), para que la sincronización, los pins, los blobs y los braids funcionen sobre ella sin cambios. No ha empezado. El nombre sigue la forma en que Kolo nombra una biblioteca por lo que es: kolo-transport es QUIC, y un enlace Bluetooth es otra cosa. No hay nada decidido sobre el diseño. Un diseño posible lleva la pila cifrada actual sobre un enlace de paquetes Bluetooth; otro necesita un handshake propio, y una revisión de seguridad antes de escribir código. Cómo se encontrarían los peers cercanos, y qué podría observar alguien que esté cerca, son preguntas abiertas.
  • SDK de JavaScript En exploraciónSDK un cliente ligero para JavaScript y TypeScript. En el escritorio habla con un proceso de Kolo a través del puente local (kolo-ipc y kolo-rpc), y en la web habla con kolo-http. El peer sigue estando en Go.
  • Servidor MCP de la documentación En exploraciónSDK un endpoint MCP público al que las herramientas de programación con IA puedan conectarse para buscar y leer la documentación de Kolo. No ha empezado. Hoy cada página de esta documentación tiene una versión en Markdown, en inglés, español y portugués, y el sitio publica llms.txt y llms-full.txt para cada idioma.
  • Rotación de claves en un chat En exploraciónApps una clave nueva de la conversación después de quitar a un miembro. Hoy quitar a un miembro no revoca su acceso: el miembro quitado conserva la clave y aún puede leer los mensajes nuevos desde los pins.
  • Cuentas en varios dispositivos En exploraciónApps una persona en varios dispositivos en los programas de ejemplo. La parte de las bibliotecas está hecha y publicada: kolo-id tiene la frase de recuperación de 24 palabras, la clave de la persona y los certificados de dispositivo, kolo-invite vincula un dispositivo nuevo por invitación, y el paquete devices de kolo-braid guarda la lista de dispositivos de una persona en un grupo. Ningún programa de ejemplo las usa todavía, así que en los ejemplos una persona con dos dispositivos sigue siendo dos miembros.
  • Herramientas de moderación para salas En exploraciónApps herramientas para los admins de una sala. Hoy un admin puede aprobar solicitudes y quitar a un miembro, y nada más.
  • Ejemplos para móviles En exploraciónApps ejemplos móviles para iOS y Android que enseñan a construir con Kolo: primero el chat, y luego compartir archivos, el tablero y las reuniones. No ha empezado. Antes hay que investigar cómo incluir código Go con las bibliotecas de Kolo en una app móvil, usando solo las API públicas de los móviles, y los flujos de permisos de cámara y micrófono que necesita el ejemplo de reuniones.

Futuro

  • IPv6 FuturoRed hoy las bibliotecas de Kolo funcionan sobre IPv4: las direcciones, los nodos de entrada, los relays y la DHT usan solo IPv4, y las formas IPv6 se rechazan a propósito. Dar soporte a IPv6 es un elemento futuro, sin plan ni fecha.

El camino a la 1.0.0

Estas son las condiciones para una v1.0.0. Son criterios, no fechas.

  • La API pública de cada biblioteca está revisada y congelada.
  • La validación en macOS, Linux y Windows está completa para cada biblioteca.
  • El modelo de seguridad está escrito para cada biblioteca.
  • La documentación y los ejemplos están completos.

Cuando sabemos de algo que bloquea una 1.0.0, aparece en esta documentación: consulta Límites y Seguridad.

Hasta entonces, todo en Kolo está en beta (v0.x): cada biblioteca, con una API que puede cambiar antes de la v1.0.0.