@ghostystudio/computer
«La computadora del agente»: lo que un agente hace, paso por paso, al lado del chat. El plan palomeado, el navegador con captura, cursor fantasma, vista en vivo y «Tomar el control», resultados de búsqueda, diffs de archivos y la terminal escondida detrás de «Ver detalle técnico».
Nació en Sitios de EasyBits; lo usan Ghosty Teams y el chat de Ghosty Studio (/c).
import { upsertStep, attachFrame, computerCard, type AgentStep } from "@ghostystudio/computer";
import { AgentComputer, ComputerCard } from "@ghostystudio/computer/react";
import "@ghostystudio/computer/styles.css";
- El host pone los datos:
steps(los arma conupsertStepdesde los eventos de tool de su turno yattachFramecon cada captura),live, y los adaptadorest(traducción, la clave es el texto en español),resolveImage,onWatchyonTakeover. - Estilos propios con prefijo
.gc-sobre variables de.gc-scope(--gc-bg,--gc-ink,--gc-brand…): cada app las mapea a sus tokens. Sin Tailwind ni!important. - Publicar = subir
versionaquí y hacer merge a main (.github/workflows/publish-computer.yml, npm Trusted Publishing).
Comprobante y cuándo abrir el panel (0.3.0)
ComputerCardterminado = comprobante «▶ Ver cómo lo revisé» con la última captura;onOpen(replay)avisa si se abre como repetición (pásaleautoplayaAgentComputer).TurnReceipt({steps, onOpen})lo arma desde los pasos.worthWatching(steps, now): abre el panel solo si el turno llevaWATCH_AFTER_MS(15 s), un paso espera algo (note) o el navegador falló.turnReceipt(steps)→{thumb, host, browsed}.- La ventana del navegador dice «En vivo» (screencast) o «Captura».
Diffs y modo no técnico (0.3.2)
- Una salida de
diff -u/git diffen la terminal se pinta como cambios (parseUnifiedDiff), no como texto. exitMeaning(command, exitCode):diff/cmpcon 1 = «hay diferencias»,grep/rgcon 1 = «sin coincidencias».AgentComputer technical={false}(Sitios): terminal y genérico = tarjeta de trabajo con engrane,intenty «✓ Listo / No se pudo»; diffs como «Antes / Ahora»; la terminal tras «Ver detalles técnicos».
Captura del turno y pedido de ayuda en la tarjeta (0.4.5)
attachTurnFrame(steps, frame, image, stepId?): cuelga la captura tal cual viaja del host (TurnFrame, el eventobrowserde gs) con la imagen que tu navegador puede pintar (data URL, ruta privada…).pendingAsk(steps)→{stepId, text, key}delcloud_browser_ask_humanabierto;keycambia con cada pedido nuevo (para reabrir el panel o avisar una sola vez).ComputerCarden vivo con un pedido abierto se vuelve la alerta «Te necesito aquí · …» con «Tomar el control» (abre el panel cononOpen(false)).
Contestar el pedido de ayuda sin tomar el control (0.7.3)
ComputerCard onAnswer(sessionId, "delegate" | "cancel"): la alerta «Te necesito aquí» suma «Hazlo tú» y «Cancelar» junto a «Tomar el control». El host suelta la espera del agente con esa respuesta (en gs,POST /api/v2/me/agents/:agentId/browser/answer {sessionId, answer}). SinonAnswer, sólo «Tomar el control».- 0.7.5:
onAnswerpuede resolver{gone: true}(el agente ya no esperaba): la alerta se cierra. Si rechaza, la tarjeta enseña el error bajo el texto; ningún botón se queda mudo.