Agent Residue Evidence

Agent Residue Evidence (ARE) agrega un punto de control de evidencia al flujo de trabajo de prueba y compilación de un agente:

observe → Agent reviews evidence → user authorizes cleanup
        → Agent cleans with its own tools → ARE verifies

ARE muestra archivos del ámbito de la tarea, directorios, procesos atribuidos y sus puertos de escucha. Nunca elimina archivos, detiene procesos, cierra puertos, decide que algo es seguro de eliminar, escanea la máquina completa, sube datos, usa la red ni recopila telemetría.

Visita el sitio del proyecto, ejecuta la demo reproducible de residuos de tareas o descarga la última versión verificada.

Tarea estándar

Antes de la primera prueba o compilación, el agente llama a begin_task_observation con el espacio de trabajo exacto y cualquier raíz temporal propia de la tarea. Los eventos son opcionales; se pueden enviar eventos genéricos seguros o heartbeats vacíos con append_task_events. Antes de su respuesta final, el agente llama a end_task_observation, explica los candidatos y pregunta al usuario qué hacer. Solo después de la autorización explícita el agente limpia con sus herramientas normales. Luego llama a verify_task_residue para volver a comprobar los mismos candidatos estables.

NO_CANDIDATES_OBSERVED significa únicamente que no apareció ningún candidato dentro del ámbito de observación declarado. No es una afirmación de limpieza en todo el host.

Related MCP server: SystemLens

Tarea completada sin línea base

inspect_completed_task acepta raíces explícitas y una ventana de tiempo acotada. El resultado es siempre PARTIAL_EVIDENCE; puede usar evidencia de eventos, recibos, inferida o no atribuida, pero nunca afirma BASELINE_OBSERVED. Usa get_residue_report para leer un informe guardado sin volver a observar.

Cada observación está aislada por una capacidad opaca de propietario. Los IDs de tarea, IDs de informe, IDs de observación e IDs de candidato son solo referencias de visualización y nunca autorizan el acceso. El estado se cifra en reposo con nombres de archivo opacos; las rutas exactas solo se revelan mediante una llamada autorizada de resolución de candidatos. Las capacidades de ejecutor de corta duración solo pueden añadir tipos de eventos y alias de raíz explícitamente permitidos y no pueden leer, finalizar, verificar ni resolver una tarea.

La superficie MCP contiene exactamente ocho herramientas:

• begin_task_observation

• append_task_events

• end_task_observation

• inspect_completed_task

• get_residue_report

• verify_task_residue

• delegate_task_executor

• resolve_residue_candidate

Deliberadamente no existe ninguna herramienta de limpieza, borrado, ejecución, terminación o cierre.

Empaquetado local-first

Una versión contiene un servidor MCP nativo CLI/stdio, un plugin de agente ligero, MCPB, sumas de verificación, procedencia y SPDX SBOM. Consulta Inicio rápido e Instalación. El funcionamiento en tiempo de ejecución es completamente local y sin conexión. Los informes tienen por defecto una retención de siete días y un límite total de 100 MB; los informes conservados y las líneas base activas están protegidos. La desinstalación nunca elimina informes silenciosamente.

El espacio de nombres del Registro MCP es io.github.fantasyce/agent-residue-evidence.

La aceptación nativa cubre macOS 14+ arm64, Linux amd64 y Windows 11 amd64 mediante trabajos de CI nativos obligatorios. La compilación cruzada por sí sola no se reporta como aceptación nativa.

Desarrollo

Se requiere Go 1.26 o 1.27.

bash scripts/check.sh
bash scripts/run_native_acceptance.sh

Con licencia Apache-2.0. Consulta Seguridad, Contribución y aceptación nativa.