Tilda Agent OS / Tilda MCP

Estado: 0.2.0-prealpha — Segmento vertical de la Fase 2 completado en un laboratorio autorizado aislado; el desarrollo activo continúa.

Tilda Agent OS es un plano de control de código abierto que permite a los agentes de codificación trabajar con un editor visual de Tilda mediante operaciones acotadas y legibles por máquina. Combina autoridad de navegador en la misma sesión, ChangeSets tipados, compuertas de destino exactas, relecturas posteriores a la operación, rollback y controles de publicación separados.

Este repositorio es un candidato pre-alfa, no una Tilda MCP de producción ni universal. El paquete público no contiene, a propósito, identificadores reales de cuentas/proyectos/páginas/registros, contenido de clientes, dominios, estado del navegador, trazas sin procesar ni fixtures privados en vivo. El estrecho segmento vertical en vivo se verificó de forma privada en un laboratorio aislado; el checkout público es la superficie de código reproducible y de pruebas unitarias, no una copia reproducible de esa cuenta.

Qué hay aquí

• Un servidor MCP stdio local con once herramientas acotadas: status, capabilities, lecturas exactas, plan/apply/verify/rollback de ChangeSet, solicitudes separadas de publicación y despublicación, verificación pública y una transacción fija de ciclo de vida de página.

• Almacenamiento tipado de ChangeSet y snapshots con comprobaciones de estado obsoleto, idempotencia, eventos de diario de solo anexión, recuperación de cierre seguro y protecciones de symlink/rutas.

• Contratos de adaptador para las operaciones acotadas y respaldadas por evidencia standard.field.patch, t123.code.replace, transiciones leaf/responsive/clone de Zero Block, y page.seo.patch, además de una lectura HEAD completa específica de página y un ciclo de vida page.head.code.replace que nunca publica como efecto secundario.

• Una autoridad de navegador CDP loopback que se reenlaza a la sesión autenticada actual y mantiene lecturas, escrituras y publicación del editor en un único flujo de trabajo explícito con compuerta de destino.

• Observabilidad saneada y un smoke test público de solo lectura de MCP que no utiliza identificadores de destino en vivo y no realiza escrituras remotas.

La evidencia privada de la Fase 2 cubrió cambios reversibles en Standard y T123, cambios acotados en Zero y SEO, reemplazo de HEAD específico de página, ciclo de vida de página, publicación/verificación pública separadas, el rechazo de un proyecto fuente, y un reinicio/reenlace de navegador dedicado seguido de un smoke test de MCP de solo lectura. Estas afirmaciones están deliberadamente limitadas a las formas exactas de laboratorio/editor/entorno probadas; no implican soporte para todos los bloques, campos, puntos de interrupción, cuentas o versiones del editor de Tilda.

Inicio rápido

Requisitos: Node.js 20+, pnpm 11+ y (solo para investigación local autenticada) un perfil dedicado de Chrome/Chromium con depuración remota habilitada.

if (-not (Test-Path .env)) { Copy-Item .env.example .env }
pnpm install --frozen-lockfile
pnpm typecheck
pnpm test
pnpm build
pnpm smoke:mcp

El smoke test público verifica el protocolo MCP local, los once registros de herramientas, la salida estructurada de capacidades y la salida estructurada de estado. No inicia sesión, no abre un destino en vivo, no muta Tilda, no publica nada ni requiere identificadores de cuenta.

Para Codex, la configuración a nivel de proyecto se encuentra en .codex/config.toml. Inicie el servidor manualmente con pnpm mcp; stdout está reservado para MCP JSON-RPC y los diagnósticos van a stderr.

Límite de seguridad

• Utilice únicamente cuentas y proyectos que el operador esté autorizado a operar.

• Trate todo proyecto preexistente como de solo lectura; utilice un laboratorio aislado dedicado para experimentos.

• Construya un inventario local ignorado de solo lectura y una lista blanca exacta del laboratorio antes de cualquier escritura. El paquete público no incluye ningún registro específico de cuenta, por lo que un checkout no configurado permanece con cierre seguro.

• Cada edición sigue: lectura → snapshot → dry-run → una mutación semántica → relectura → diff exacto → restauración → relectura de la restauración.

• La edición nunca publica. La publicación y la despublicación son operaciones separadas y controladas por aprobación.

• Nunca haga commit de credenciales, cookies, datos de autenticación/CSRF, perfiles de navegador, HAR o trazas sin procesar, Leads, pedidos, PII, contenido propietario ni identificadores reales de Tilda.

• Una escritura no documentada ambigua o fallida se pone en cuarentena. No la reintente a ciegas.

Consulte SECURITY.md, ARCHITECTURE.md y CAPABILITIES.md para conocer los límites de las afirmaciones y la evidencia.

Por qué esto importa

Los agentes de codificación ya disponen de interfaces de máquina fiables para archivos fuente, Git, CLIs, APIs y bases de datos. Los editores visuales de SaaS son diferentes: la automatización basada en cursor es frágil, mientras que las solicitudes de tiempo de ejecución no documentadas pueden ser inseguras. Este proyecto explora un patrón portátil para operar dichos entornos con identidad explícita, transacciones reversibles, etiquetas de evidencia y aprobación humana en compuertas de consecuencias importantes.

Alcance y hoja de ruta

El lanzamiento actual es un segmento vertical pre-alfa acotado. No pretende ser una API general de escritura de editor, acceso arbitrario a páginas/registros, todas las familias de Zero, activos, catálogo/formularios, movimientos entre proyectos, recuperación de papelera, HEAD en todo el sitio, compatibilidad con el Modo de Interfaz Avanzada ni fiabilidad de producción. Consulte ROADMAP.md para conocer las próximas compuertas de evidencia.

Licencia

Apache-2.0. Tilda es una marca comercial de su respectivo propietario. Este proyecto independiente no está afiliado, respaldado ni soportado por Tilda.