theus-cli-linux-arm64 1.2.1 → 1.3.0

package/README.md

@@ -36,6 +36,21 @@ theus login              # conectar tu suscripción
 theus update             # actualizar
 ```
 
+## Volver donde lo dejaste
+
+Cada conversación queda guardada en la carpeta donde la tuviste, así que retomar el
+trabajo de ayer cuesta una tecla:
+
+```bash
+theus -c                 # retoma la conversación más reciente de esta carpeta
+theus -r                 # abre el selector y eliges cuál retomar
+theus -r <id-de-sesión>  # retoma una concreta por su ID
+theus -c --fork-session  # la retoma en una sesión nueva, sin escribir sobre la original
+```
+
+Ya dentro de una sesión, `/resume` —también `/continuar` o `/reanudar`— hace lo mismo
+sin salir del CLI.
+
 ---
 
 ## Qué hace de verdad

package/RELEASE.json

@@ -1,18 +1,18 @@
 {
   "schema": "theus.native-release.v1",
   "product": "Theus",
-  "version": "1.2.1",
-  "tag": "v1.2.1",
+  "version": "1.3.0",
+  "tag": "v1.3.0",
   "target": "linux-arm64",
   "compile_target": "bun-linux-arm64",
-  "commit": "c5c83beb9981856f92639afb1cffbc9b34cf0c95",
+  "commit": "422ed780987ce0910b3b5b6f1231a3126c4d3074",
   "bun_version": "1.3.6",
-  "executable_sha256": "3c931f129900cfc59954942b5d46ecd9bd721b0b3ae9d9101a8550a81b2a267a",
-  "executable_bytes": 103067883,
+  "executable_sha256": "da2646c29a531e0e1bd01ce160d68998b0bac85e940cb0e06b55ffef28b85d5e",
+  "executable_bytes": 103194431,
   "format_verified": true,
   "native_smoke": true,
   "signed": null,
   "notarized": null,
   "publishable": true,
-  "finalized_at": "2026-08-23T05:10:20.311Z"
+  "finalized_at": "2026-08-27T02:31:32.908Z"
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "theus-cli-linux-arm64",
-  "version": "1.2.1",
+  "version": "1.3.0",
   "description": "Binario nativo de Theus CLI para linux-arm64. No se instala directamente: es una dependencia de theus-cli.",
   "os": [
     "linux"

package/vendor/chrome-extension/README.md

@@ -0,0 +1,142 @@
+# Theus en Chrome — extensión MV3
+
+Extensión de navegador de Theus. Conecta Chrome con el CLI mediante
+**mensajería nativa**: el CLI instala el host
+(`com.theus.theus_code_browser_extension`) y sirve un socket local; esta
+extensión se conecta a ese host y ejecuta las acciones de navegador que el
+modelo pide a través de los tools MCP `mcp__theus-in-chrome__*`.
+
+## ID estable
+
+El `manifest.json` fija el campo `key`, así que Chrome asigna **siempre** el
+mismo ID, incluso cargándola sin empaquetar:
+
+```
+jooelelbehmeeikiemhadaecbjejhkga
+```
+
+Derivación: ID = primeros 32 caracteres hex del SHA-256 de la clave pública
+(DER/SPKI) del `key`, mapeados `0-9a-f → a-p`. Ese mismo ID está registrado en
+`utils/theusInChrome/setupPortable.ts` (detección de instalación) y entra en el
+`allowed_origins` del manifiesto de mensajería nativa que instala el CLI.
+
+> La clave privada del par **no** está en el repo (solo hace falta para
+> empaquetar o publicar en la Web Store conservando el ID). Guárdala fuera del
+> repositorio.
+
+## Cómo cargarla (modo desarrollador)
+
+1. Arranca el CLI al menos una vez con la integración activa
+   (`theus --chrome`, o actívala en `/config`): eso instala el host nativo y
+   su manifiesto en el navegador.
+2. Abre `chrome://extensions` en Chrome.
+3. Activa **Modo de desarrollador** (arriba a la derecha).
+4. Pulsa **Cargar descomprimida** y elige esta carpeta (`chrome-extension/`).
+5. Verifica que el ID mostrado es `jooelelbehmeeikiemhadaecbjejhkga`.
+6. Abre el popup de la extensión: debe decir «Host nativo: conectado» cuando
+   el CLI esté corriendo con la integración encendida. Dentro del CLI,
+   `/chrome` muestra el estado completo.
+
+Si instalaste la extensión **después** de arrancar el CLI, reinicia Chrome (el
+manifiesto de mensajería nativa se lee al arrancar el navegador).
+
+## Tools (15)
+
+Fase 1 — MVP (mensajería nativa + `chrome.scripting`):
+
+| Tool | Qué hace |
+| --- | --- |
+| `tabs_context_mcp` | Lista pestañas: id, url, título, activa |
+| `tabs_create_mcp` | Abre una pestaña (`url` opcional) y devuelve `tabId` |
+| `navigate` | Navega la pestaña a una URL y espera la carga |
+| `get_page_text` | Texto visible del DOM |
+| `javascript_tool` | Ejecuta JS en la página y devuelve el resultado |
+| `find` | Busca elementos por texto visible o selector CSS |
+
+Fase 2 — control total (exigen `chrome.debugger` / CDP):
+
+| Tool | Qué hace |
+| --- | --- |
+| `computer` | Ratón y teclado reales: `screenshot` (JPEG que el modelo VE), clics (izq/dcho/doble/central), arrastre, `type`, `key` (combinaciones tipo `ctrl+a`), `scroll`, `wait`. Apunta por `coordinate` [x, y] o por `ref` de `read_page` |
+| `read_page` | Árbol de accesibilidad resumido con refs estables (rol, nombre, valor, bounds) para apuntar con `computer` y `form_input` |
+| `form_input` | Fija el valor de un input/select/textarea por `ref`, con eventos `input`/`change` reales |
+| `resize_window` | Redimensiona la ventana de la pestaña (ancho × alto) |
+| `read_console_messages` | Mensajes de consola (console.*, excepciones, avisos), filtro por regex |
+| `read_network_requests` | Peticiones de red: método, URL, estado, tipo, tamaño, duración; filtro por regex |
+
+### Cómo funciona la fase 2
+
+- **Sesiones CDP por pestaña** (`cdp.js`): el debugger se adjunta perezosamente
+  con la primera tool de fase 2 sobre esa pestaña, se suelta al cerrarla y se
+  re-adjunta solo si Chrome lo soltó (en ese caso el buffer declara el corte).
+- **Buffers de consola y red** arrancan en el attach: no existen mensajes ni
+  peticiones anteriores a la instrumentación, y cada respuesta dice desde qué
+  hora graba («Buffer grabando desde las HH:MM:SS»).
+- **Aviso inevitable**: mientras una pestaña está instrumentada, Chrome
+  muestra la barra **«Theus en Chrome ha empezado a depurar este navegador»**.
+  Es un aviso del propio Chrome ligado a `chrome.debugger`; no se puede
+  ocultar. Si el usuario pulsa «Cancelar» en esa barra, la sesión se corta y
+  la siguiente tool re-instrumenta.
+- **Capturas**: viajan como contenido MCP de imagen (base64 JPEG). El canal
+  host↔CLI admite 16 MB por mensaje; si una captura lo amenaza, la extensión
+  la reescala (~1600 px de ancho máx.) y recomprime antes de enviarla.
+
+Límites conocidos: `javascript_tool` usa `eval` en el mundo de la página, así
+que las páginas con CSP estricta pueden bloquearlo; los textos largos se
+truncan honestamente; las páginas `chrome://…` y la Web Store no se pueden
+depurar (límite de Chrome).
+
+Grabador — Kuti fase 1 (`chrome.scripting` + `chrome.debugger`):
+
+| Tool | Qué hace |
+| --- | --- |
+| `recorder_start` | Empieza a **grabar** las acciones reales del usuario en la pestaña: inyecta el content script `recorder.js` y abre una sesión CDP para oír navegaciones. `tabId` requerido; `capturas` opcional |
+| `recorder_events` | Devuelve el guion coalescido con lo grabado **hasta ahora** (previsualización, sin detener). Solo lee el búfer local del servidor MCP; no habla con la extensión |
+| `recorder_stop` | Detiene la grabación y devuelve el guion final (pasos + parámetros secretos + `yaml` listo para guardar) |
+
+### Cómo funciona el grabador (Kuti fase 1)
+
+`chrome.debugger` **no reporta el input del usuario** (el dominio `Input` de CDP
+es solo inyección). Para GRABAR lo que la persona hace de verdad hace falta un
+**content script**:
+
+- **`recorder.js`** se inyecta con `chrome.scripting.executeScript` al llamar
+  `recorder_start`, y **se reinyecta tras cada navegación** (el content script
+  muere al cambiar de página; `chrome.tabs.onUpdated` lo repone). Escucha
+  `click`, `input`/`change`, `keydown` (solo Enter/Tab/Escape y atajos, **nunca**
+  el texto tecleado carácter a carácter) y `submit`. Por cada evento calcula un
+  **descriptor por intención** (rol ARIA, nombre accesible, texto, css corto,
+  name/id/placeholder/tipo/autocomplete) y lo manda a `background.js` por
+  `chrome.runtime.sendMessage`.
+- **`background.js`** reenvía esos eventos al CLI como **push** por el mismo
+  canal nativo: `{type:'recorder_event', evento}` (petición→respuesta era el
+  único flujo; el push es un `type` nuevo, respeta el límite de 16 MB). La
+  navegación del frame principal la aporta CDP (`Page.frameNavigated`), y con
+  `capturas: true` adjunta una captura recomprimida por cambio de página.
+- **Privacidad**: los campos sensibles (input `type=password`, `autocomplete`
+  `cc-*`, o name/id/placeholder con clave/token/cvv/CVC/OTP/pin…) se registran
+  **sin su valor**; el CLI los vuelve `{{parametro}}` con `secreto: true` y su
+  valor no toca el disco.
+
+> **Barra del depurador**: como el grabador abre una sesión CDP para oír las
+> navegaciones, Chrome muestra la misma barra **«Theus en Chrome ha empezado a
+> depurar este navegador»** durante la grabación. Es inevitable.
+
+> **Recargar la extensión es obligatorio al actualizar**: el content script
+> `recorder.js` solo existe desde la v0.3.0. Si actualizas la carpeta pero no
+> **recargas** la extensión en `chrome://extensions`, `recorder_start` fallará
+> (o no se capturará nada). Tras cualquier cambio en `chrome-extension/`, pulsa
+> **recargar** en esa página.
+
+Se maneja desde el CLI con `/grabar auto [<nombre>]` (enciende el grabador) y
+`/grabar fin` (llama a `recorder_stop` y guarda el `.guion.yaml`).
+
+## Qué falta (fase 3)
+
+- `gif_creator`, `upload_image`, `shortcuts_list`/`shortcuts_execute` y
+  `update_plan`.
+- Emparejamiento de dispositivos y bridge remoto (WebSocket + OAuth).
+- Persistir las capturas del grabador como `paso-NN.jpg` del guion (hoy la
+  captura por paso viaja en el evento pero aún no se escribe a disco).
+- Publicación en la Chrome Web Store: el zip candidato es la **v0.1.0 sin
+  `debugger`**; esta v0.3.0 se usa en local y saldrá como actualización.