EdiThor logo Docs

Documentacion Edithor

connecthor-plugin-edithor

Capa process especifica de Edithor: convierte las primitivas locales de ConnecThor en APIs de producto para reinos, agentes, flows, terminales, browser bridge y sesion Verserama.

Responsabilidad

connecthor-plugin-edithor es un binario Rust standalone que ConnecThor ejecuta como plugin process. Comunica su ciclo de vida por JSON-RPC sobre stdin/stdout, levanta un servidor HTTP local en el puerto asignado y deja que ConnecThor reverse-proxy sus rutas.

Su razon de existir es mantener a ConnecThor como core generico. Todo lo que huele a Edithor -reinos, Orchestrathor, Studio, storage por dominio, bridge browser o sesion Verserama- vive aqui y no en el agente base.

Esquema: Edithor Angular -> ConnecThor HTTP/WS autenticado -> connecthor-plugin-edithor -> workspace local, procesos, PTYs, SQLite y servicios de usuario.

Modos del binario

Modo Invocacion Uso
Plugin process connecthor-plugin-edithor Modo normal. ConnecThor lo arranca, le asigna puerto local y reverse-proxy sus rutas HTTP.
MCP connecthor-plugin-edithor mcp Servidor stdio para agentes de codigo; llama a endpoints HTTP de ConnecThor y Orchestrathor.
Manifest connecthor-plugin-edithor manifest Imprime el manifest que usa connecthor install para registrar el plugin.
Sync Claude agents connecthor-plugin-edithor sync-claude-agents Sincroniza el catalogo SQLite de Orchestrathor con .claude/agents/*.md.

Capacidades principales

Area Rutas de alto nivel Que habilita Docs relacionadas
Orchestrathor y agentes /orchestrathor/*, /agent/*, /agent-usage/* Catalogo de agentes, ownership, delegacion a agentes o flows, Heimdall, metricas, MCP-aware PTYs, instalacion de runtimes locales y contador de uso por sesion. Orchestrathor, Agent, Local agent
Terminal, procesos y tasks /terminal/*, /process/*, /tasks/* Gestiona PTYs persistentes, historial con secuencias, foreground process, ejecucion de procesos y tareas de agente con streaming. Terminal, Tasks
Explorer, Git y workspace /explorer/*, /git/*, /workspace/status Operaciones de ficheros, busqueda, escritura atomica, Git CLI, ramas, remotes, stash, worktrees, clones e informacion minima de workspace para sesiones remotas. Explorer, Git
Flows /flows/*, /orchestrathor/flows/* Ejecucion backend-driven de DAGs, instancias paralelas, paneles con PTY, loops, snapshots persistidos y delegacion a flows como target de ownership. Flows
Browser bridge /edithor/*, /__sync__/sync.js, /___plugin_hooks___/head.js Recibe acciones de plugins browser, emite broadcasts WS para Edithor, sirve sync.js y entrega hooks de inyeccion HTML para iframes/proxy. Landing ConnecThor, Studio
Collaborathor /collaborathor/* Cliente host-side hacia CollaboraThor para visibilidad self-remote, sesiones remotas, bus relay filtrado y metricas. Collaborathor
Auth Verserama /auth/session, /auth/logout, /auth/device-session, /auth/config Guarda la sesion local de usuario, valida JWT via JWKS, persiste device session y emite eventos de autenticacion para otros subsistemas. Verserama, Login
Estado compartido y utilidades /storage/*, /confirmation/*, /attachment/*, /studio/*, /system/info, /api/proxy KV SQLite por reino, confirmaciones, adjuntos locales, dependencias de Studio, proxy HTTP y snapshot de hardware/runtime. Core, Studio

Flujos de integracion

App web/PWA

Edithor detecta ConnecThor, usa token/puerto y llama rutas del plugin para operar ficheros, terminales, Git, flows, agentes y storage sin acoplarse a primitivas core.

Browser plugin

Una pagina web dispara acciones de connecthor-browser-edithor; la extension las envia a /edithor/*; el plugin emite eventos WS que Edithor consume.

Desktop

Edithor Desktop busca connecthor y el plugin junto al ejecutable o recursos del bundle, instala el plugin y arranca el sidecar con token inyectado en la WebView.

Agentes MCP

El modo mcp ofrece herramientas a agentes de codigo para listar owners, resolver ownership y delegar a agentes o flows usando las APIs locales.

Instalacion y distribucion

Camino Tratamiento documental
Web/PWA con ConnecThor Build Rust y registro con connecthor install o make install-plugin; ConnecThor spawnea el plugin al arrancar.
Extension browser connecthor-for-browser conecta el navegador con ConnecThor; connecthor-browser-edithor aporta menus, sync.js y acciones de pagina.
Edithor Desktop El repo desktop confirma distribucion con connecthor y connecthor-plugin-edithor como companion binaries, e instalacion via connecthor install al arranque.
Pendiente editorial No asumir publicacion remota, tienda de extensiones ni cadencia de releases sin una fuente de release mantenida.
Comandos confirmados: cargo build --release --bin connecthor-plugin-edithor, connecthor install target/release/connecthor-plugin-edithor y make install-plugin.

Limites de arquitectura

  • ConnecThor core mantiene primitivas genericas: WebSocket, token, PTY, filesystem, comandos, proxy y runtime de plugins.
  • El frontend de Edithor debe consumir endpoints de alto nivel del plugin, no primitivas core directas como fs_*, exec_run o PTY raw.
  • La validacion del token para rutas de plugin se centraliza en el proxy de ConnecThor; el plugin escucha en 127.0.0.1 y no revalida cada handler.
  • Las rutas internas se documentan como superficie de producto de Edithor, no como API publica estable para terceros salvo que el repo lo declare explicitamente.

Relacion con otras piezas

Esta pagina documenta el plugin process. La extension browser y los plugins browser se explican aparte porque viven en el navegador y tienen otro ciclo de instalacion.

Integracion Edithor + ConnecThor Landing ConnecThor Reinos relacionados Verserama en Edithor

Fuentes usadas

  • connecthor-plugin-edithor/AGENTS.md
  • connecthor-plugin-edithor/README.md
  • connecthor-plugin-edithor/src/bin/connecthor_plugin_edithor.rs
  • connecthor-plugin-edithor/src/routes.rs
  • connecthor-plugin-edithor/src/kingdoms/flow/AGENTS.md
  • connecthor-plugin-edithor/src/kingdoms/collaborathor/AGENTS.md
  • connecthor/AGENTS.md
  • connecthor-plugin-sdk/README.md
  • connecthor-for-browser/AGENTS.md
  • connecthor-browser-edithor/AGENTS.md
  • connecthor-browser-github/AGENTS.md
  • edithor-desktop/README.md
  • .plan/doc/catalogo-connecthor.md