SDK

SDK de Miblo: tus programas y apps en la pantalla de Miblo

El SDK de Miblo: la Status API en tu computador, el token, las apps del Desk de página (HTML y CSS) y la tienda de apps. TypeScript y Python; nada sale de tu equipo.

Qué es

El SDK de Miblo permite que tus propios programas aparezcan en Miblo: un script de build, un trabajo de datos, un bot que vigila un sitio web, una herramienta de IA que Miblo no conecta. Un programa puede:

convertirse en una sesión en el Miblo Desk, en Miblo Hub y en Miblo Remote (trabajando, te necesita, en reposo o terminada), con una alerta cuando te necesita;
poner un mensaje corto en la pantalla, iniciar una sesión de enfoque (Pomodoro) o un temporizador;
dibujar la pantalla de apps, una pantalla de la rotación de Miblo que es toda suya: una página web (HTML, CSS y JavaScript) que Miblo Hub dibuja en el computador y transmite al Miblo Desk, o, de la manera antigua y obsoleta, una tarjeta con números, anillos, barras y gráficos y una imagen de fondo;
convertirse en una app: con un nombre, ajustes que la persona completa en Miblo Hub, y Miblo encargándose de ejecutarla. Las apps oficiales de Miblo (Procesador, Bitcoin y Cripto y las que trae cada versión) son exactamente eso.

El SDK hace estado y nada más. No aprueba, no responde ni inicia tareas en tus herramientas de IA, y nada en él las activa. Es la regla de Miblo: muestra, nunca interfiere.

Hay dos paquetes con la misma API: @miblo/status para Node.js 20+ (TypeScript, con tipos, sin dependencias) y miblo-status para Python 3.9+ (solo biblioteca estándar), ambos en la versión 2.x. Cualquier otro lenguaje puede hablar el mismo protocolo: está todo en la referencia.

Cómo funciona

El puente de Miblo es el proceso de Miblo que ya corre en tu computador: habla con tus herramientas de IA, con el Miblo Desk y con Miblo Remote. Abre la Status API (SDK 2.x) solo en 127.0.0.1:47821, tu propia máquina.
Tu programa habla con el puente por HTTP local, con un token solo de estado que le entregas (miblo sdk token). Cada solicitud lleva un desafío de un solo uso firmado con HMAC-SHA256, y cada respuesta vuelve firmada: el programa sabe que habló con Miblo, y el puente sabe que el programa tiene el token.
El puente verifica todo (tamaños, límites, las frases reservadas de Miblo) y lo pasa al Miblo Desk por tu red local, con su emparejamiento, y a Miblo Hub y Miblo Remote junto con el estado que ya reciben (cifrado de extremo a extremo en Miblo Remote).
El Miblo Desk pinta. Para una app del Desk de página (Miblo 1.45), Miblo Hub renderiza la página en el computador y envía lo que cambió; las tarjetas, los marcos y las animaciones del estilo antiguo también los dibuja Miblo Hub desde la 1.45, y una imagen se convierte en el computador antes de enviarse.

El token

El token (miblo_sdk_ + 64 caracteres hexadecimales) es independiente de la clave del puente: solo llega a las rutas /sdk/v1/*. Con él un programa muestra estado; no puede leer comandos, prompts, archivos, costos ni nada de Miblo+, no puede aprobar nada y no puede cambiar los ajustes del Miblo Desk. Si se filtra (un log de CI, un script compartido), la filtración se limita al estado, y miblo sdk token --rotate la termina.

Obtén el token en una terminal (miblo sdk token) o en Miblo Hub → Programas (SDK). Los detalles están en Instalación.

Qué puedes hacer

Quiero...	Usa	Página
Mostrar que mi script está corriendo y recibir una alerta cuando me necesita	`session()`, `needsYou()`, `done()`	Sesiones y estado
Poner un mensaje, una sesión de enfoque o un temporizador en el Miblo Desk	`say()`, `focus()`, `timer()`	Sesiones y estado
Saber quién está trabajando y quién me necesita	`snapshot()`	Sesiones y estado
Dibujar una pantalla propia, con HTML y CSS	`screen.page()`, `screen.data()`	Apps del Desk de página
Dibujar una pantalla propia con una tarjeta (obsoleto)	`screen.card()`, `screen.layer()`	La pantalla de apps
Tener ajustes que la persona completa en Miblo Hub	`app.declare()`, `app.settings`	Apps y ajustes
Leer los datos de Google o Microsoft de la persona (un calendario, un canal de YouTube)	`app.connect`	Apps y ajustes
Avisar que algo pasó, sin pantalla	`alerts.send()`	Apps solo de alertas
Dejar que Miblo mantenga mi programa corriendo	`miblo apps add`	Instalación
Publicar mi app en la tienda de apps del Desk	miblo.ai/apps	Publicar en la tienda de apps del Desk

Por dónde empezar

Instala el paquete y obtén el token, luego ejecuta tu primer programa (10 líneas).
Lee Sesiones y estado para las alertas, y Apps del Desk de página para dibujar.
¿Quieres que otras personas lo usen? Conviértelo en una app, pruébalo en el simulador y publícalo.

Versiones

Usa el SDK 2.x. Desde Miblo 1.30.0 cada solicitud dice qué API del SDK habla, y el puente acepta la API 2 y más nuevas: un SDK 1.x recibe upgrade en su primera llamada. Las rutas siguen siendo /sdk/v1/*.
Qué necesita qué:

Usas	Necesita
SDK 2.x: sesiones, mensajes, la pantalla de apps, apps, alertas	Miblo 1.30.0 o más nuevo en el computador, y en el Miblo Desk si tienes uno (a un dispositivo más antiguo solo se le dice que actualice)
Una app que lee las sesiones de IA de la persona (`sessions: true`)	Miblo 1.34.0 o más nuevo
Una app del Desk de página (`display: "page"`, API de apps 4 o 5)	Miblo 1.45 en el computador (1.46 para la API 5) y firmware 1.45.0 en el Miblo Desk

Si el SDK es más nuevo que Miblo en el computador, el SDK dice bridge_outdated: ejecuta miblo update. Si Miblo necesita un SDK más nuevo, dice upgrade: instala el último desde Instalación.
Dentro de un nivel de API los campos solo se agregan. Un cambio que rompería un programa sube el nivel, y el error de arriba le dice al programa qué actualizar.
Lo que trajo cada versión del SDK está en Novedades del SDK.
Los paquetes vienen solo de miblo.ai (no están en npm ni en PyPI), con una firma Ed25519 junto a cada archivo.

Qué es#

Cómo funciona#

El token#

Qué puedes hacer#

Por dónde empezar#