Paco ACP Chat
Extension de VS Code para abrir un chat contra el servidor ACP de Paco.
Uso
- Abre la vista lateral de Paco en la barra izquierda.
- La primera pantalla es de
Iniciar sesion o Registro.
- Introduce
Usuario y Contrasena.
- La extension resuelve automaticamente el servidor local, el agente publico y el proyecto por defecto leyendo
apps/acp-server/.env; si falta algun valor, usa los defaults locales.
- La extension llama al backend ACP en
/auth/login o /auth/register.
- Si el backend valida las credenciales, devuelve un bearer token y la extension lo guarda en
SecretStorage.
- Una vez autenticado, la parte de acceso queda oculta y solo se mantiene
Cerrar sesion dentro del chat.
- El envio del chat ya no usa SSE: la extension abre un WebSocket contra
/runs-socket, envia el run y recibe progreso en vivo del servidor.
- Cada conversacion mantiene su propio socket mientras siga activa; si queda inactiva, la extension lo cierra tras un maximo de 30 minutos.
Historico de chats
La extension guarda localmente las conversaciones recientes y permite seleccionarlas desde el desplegable Conversaciones en la parte superior del chat.
Cada chat conserva su session_id, de modo que puedes retomar contexto sin volver a empezar.
Bitacora interactiva
Durante cada ejecucion, Paco muestra una linea de tiempo agrupada por fases como Planificacion, Delegacion, Archivos, Terminal o Inspeccion.
Esas fases llegan por WebSocket conforme el runtime va ejecutando herramientas y delegaciones, de modo que el chat refleja progreso real y no solo el resultado final.
Los eventos de delegacion solo se exponen cuando el cliente esta en entorno local o cuando el usuario autenticado tiene permisos de administrador.
Los eventos incluyen etiquetas visuales por tipo y acciones clicables:
Abrir ruta abre el archivo afectado o revela la carpeta en el explorador.Ver diff despliega un diff corto cuando Paco crea o modifica un archivo.
Adjuntos
El composer acepta arrastrar y soltar archivos, pegar archivos desde el portapapeles y pegar imagenes del clipboard.
- Los archivos de texto se adjuntan como contexto textual para el run.
- Las imagenes se pueden adjuntar y previsualizar en local; el runtime actual las envia como referencia textual y metadatos, no como analisis visual de pixeles.
Empaquetado
Ejecuta npm run package:vsix dentro de la carpeta de la extension.
El archivo .vsix se genera usando la version declarada en package.json. Si cambias esa version y vuelves a ejecutar el script, el nombre del paquete se actualiza automaticamente.
Ajustes
pacoChat.baseUrl: override opcional de la URL base si no quieres usar apps/acp-server/.env.pacoChat.agentName: override opcional del agente publico.pacoChat.projectRoot: override opcional del proyecto objetivo relativo a ACP_PROJECTS_ROOT.
El token ya no necesita configurarse manualmente en settings; el backend lo emite durante login o registro y la extension lo guarda usando SecretStorage de VS Code.
