Autonomous Intelligence

Una capa de acción local segura para transacciones para agentes de IA.

Autonomous Intelligence expone acciones de computación con ámbito de capacidades a través de MCP mientras mantiene la ejecución, aprobación y recuperación de fallos detrás de un Broker local separado.

Cómo empezar · Compatibilidad con clientes · Herramientas MCP · Modelo de seguridad · Arquitectura · Contribuir

Por qué existe esto

La mayoría de los prototipos de agentes de escritorio conectan la planificación probabilística directamente a primitivas potentes del sistema operativo. Esto es conveniente, pero hace que los reintentos, los fallos, la inyección de avisos (prompt injection) y el estado ambiguo de la interfaz de usuario sean peligrosos.

Autonomous Intelligence establece un límite claro:

• El adaptador MCP y el planificador no son confiables.

• El Broker deriva la política y la clase de acción de forma independiente.

• Cada efecto secundario se representa mediante una operación y un intento duraderos.

• Las escrituras requieren una aprobación exacta y de un solo uso.

• La recuperación verifica las poscondiciones antes de reintentar.

• Un efecto que no se puede conciliar se vuelve UNCERTAIN y se detiene.

La versión actual proporciona un corte vertical deliberadamente estrecho y orientado a la producción para operaciones de archivos del espacio de trabajo. La automatización de la interfaz de usuario de Windows y el control del navegador se agregarán solo cuando cumplan los mismos contratos.

Garantías clave

Interfaz MCP

Autonomous Intelligence es un servidor stdio MCP v2 con cinco herramientas enfocadas:

El recurso autonomous-intelligence://capabilities describe el espacio de trabajo activo y el límite de seguridad.

Los fallos de las herramientas se devuelven a través de MCP como is_error=true, lo que permite que un modelo anfitrión corrija rutas o argumentos no válidos sin confundir una cadena de error con un éxito.

Compatibilidad con clientes

El servidor es independiente del modelo y neutral respecto al anfitrión. Habla MCP sobre stdio y no llama a una API LLM de un proveedor específico.

Utilice la guía de configuración completa para múltiples clientes multi-client setup guide para la instalación global y por proyecto, comandos de verificación y comportamiento de aprobación específico del cliente.

Arquitectura

flowchart LR
    H["MCP host / AI client"] --> M["Untrusted stdio MCP adapter"]
    M --> E[("Engine journal")]
    E -->|"Authenticated JSON IPC"| B["Execution Broker"]
    B --> U["Human approval"]
    B --> L[("Authoritative Broker ledger")]
    B --> X["Semantic action executor"]
    X --> W["Capability-scoped workspace"]
    E -->|"Status + reconcile"| B

El Broker no está integrado en el proceso MCP. Si el Broker no está disponible, las herramientas fallan de forma visible en lugar de recurrir al acceso directo al anfitrión.

Cómo empezar

Requisitos

• Windows 10/11

• Python 3.11 o superior

• Un anfitrión MCP como Codex, ChatGPT de escritorio u otro cliente compatible

Instalar desde el código fuente

git clone https://github.com/coldrazer/autonomous-intelligence.git
cd autonomous-intelligence

python -m venv .venv
.\.venv\Scripts\Activate.ps1
python -m pip install -e ".[dev]"

1. Iniciar el Broker

Ejecute el Broker en una terminal visible para que las aprobaciones de escritura puedan revisarse:

autonomous-intelligence --workspace C:\path\to\allowed-workspace broker

El Broker deniega las escrituras por defecto a menos que se apruebe la operación exacta. --approval-mode allow existe solo para pruebas automatizadas desechables.

2. Conectar un cliente LLM

Genere configuración para cualquier anfitrión compatible sin modificar sus archivos:

autonomous-intelligence --workspace C:\path\to\allowed-workspace `
  client-config claude

Los nombres de cliente válidos son codex, claude, kimi, antigravity, gemini, cursor, vscode y generic.

Para Codex, el comando de registro directo es:

Con el entorno virtual activo:

codex mcp add autonomous-intelligence -- `
  autonomous-intelligence-mcp `
  --workspace C:\path\to\allowed-workspace

Verifique el registro:

codex mcp get autonomous-intelligence
codex mcp list

Reinicie el cliente Codex local después de cambiar la configuración de MCP. La aplicación de escritorio de ChatGPT, Codex CLI y la extensión IDE comparten la misma configuración de MCP de Codex.

Para la configuración manual, agregue esto a ~/.codex/config.toml:

[mcp_servers.autonomous-intelligence]
command = "C:\\path\\to\\autonomous-intelligence\\.venv\\Scripts\\autonomous-intelligence-mcp.exe"
args = ["--workspace", "C:\\path\\to\\allowed-workspace"]
startup_timeout_sec = 20
tool_timeout_sec = 120
default_tools_approval_mode = "auto"

[mcp_servers.autonomous-intelligence.tools.autonomous_write_file]
approval_mode = "prompt"

También hay una configuración de anfitrión genérica disponible en mcp-config.example.json. Consulte docs/CLIENT_SETUP.md para Claude Code, Kimi, Antigravity, Gemini CLI, Cursor, VS Code y clientes stdio genéricos.

Paquete de contenedor GitHub

Los anfitriones MCP orientados a contenedores pueden extraer la imagen OCI firmada y multiplataforma:

docker pull ghcr.io/coldrazer/autonomous-intelligence:0.3.1

Se recomienda el wheel nativo para uso en escritorio Windows. Las implementaciones en contenedores ejecutan el Broker y el adaptador MCP por separado con un volumen de estado compartido; consulte la guía de contenedores para conocer los comandos exactos y el límite de seguridad.

CLI directa

# Read a workspace file
autonomous-intelligence --workspace C:\workspace read notes.txt

# Create a file; approval occurs in the Broker terminal
autonomous-intelligence --workspace C:\workspace write output.txt `
  --content "verified output"

# Recover attempts after a process restart
autonomous-intelligence --workspace C:\workspace recover

# Stop the Broker
autonomous-intelligence --workspace C:\workspace shutdown

Modelo de seguridad

Ciclo de vida de envío

Engine PREPARED
  → Broker ACCEPTED
  → approval issued and consumed when required
  → Broker IN_FLIGHT
  → semantic effect attempted
  → Broker DELIVERY_ATTEMPTED
  → typed postcondition evaluated
  → Engine VERIFIED

IN_FLIGHT es intencionalmente conservador: un bloqueo justo antes de la entrega y uno justo después son indistinguibles hasta la reconciliación.

Comportamiento de recuperación

Autonomous Intelligence no garantiza una ejecución exactamente una vez para acciones de GUI arbitrarias o sistemas externos que no proporcionan claves de idempotencia ni reconciliación confiable.

Desarrollo

Instale las dependencias de desarrollo y ejecute el conjunto completo:

python -m pip install -e ".[dev]"
python -m pytest

Las pruebas cubren:

• Transiciones de estado del registro y conflictos de repetición

• Denegación, caducidad, vinculación y uso único de la aprobación

• Escapes del espacio de trabajo y rutas de estado protegidas

• Recuperación de fallos antes y después de efectos secundarios

• Esquemas MCP, anotaciones, recursos y semántica de errores de herramientas

• Renderizado de configuración específica del anfitrión para ocho formatos de cliente MCP

• La cadena completa de subprocesos de Windows: cliente MCP → servidor stdio → tubería con nombre → Broker → espacio de trabajo

Consulte docs/PROTOCOL.md para el contrato de red y recuperación y docs/IMPLEMENTATION_STATUS.md para el alcance actual y la hoja de ruta.

Hoja de ruta

• Engine transaccional y libro mayor autoritario del Broker

• Acciones de archivo semánticas con ámbito de capacidades

• Adaptador stdio MCP v2

• Activos de configuración de Codex, Claude, Kimi, Antigravity, Gemini, Cursor y VS Code

• Paquete de contenedor GitHub multiplataforma con SBOM y procedencia

• Pruebas de integración de tubería con nombre de Windows

• Adaptador de observación de automatización de UI de Windows de solo lectura

• Huellas dactilares de UI estructurales y rechazo de ambigüedad

• Detección de contención de entrada humana

• Adaptador CDP de navegador con enlace de origen y marco

• Identidad de servicio de Windows reforzada, ACL e instalador firmado

Seguridad

Lea SECURITY.md antes de implementar o informar una vulnerabilidad. La versión actual es un corte vertical local evaluado, no una afirmación de que el control autónomo de escritorio sin restricciones sea seguro.

Contribuir

Las contribuciones son bienvenidas cuando preservan el límite de transacciones y políticas. Comience con CONTRIBUTING.md.

Licencia

Publicado bajo la Licencia MIT.