Strata

Memoria de agente portátil. Registros de solo añadir, procedencia verificada, herramientas MCP y autoalojamiento.

Strata ofrece a un equipo una memoria duradera que cualquier agente puede leer y actualizar sin mezclar proyectos, filtrar secretos ni reescribir el historial. Está diseñado para el trabajo que se mueve entre personas, sesiones, máquinas y entornos de ejecución.

Por qué existe

La memoria local del agente se rompe cuando el trabajo se mueve entre máquinas, personas, herramientas o sesiones antiguas. Strata conserva los hechos que deberían sobrevivir a una ejecución del agente:

• resultados de experimentos y decisiones;

• notas de conjuntos de datos, sumas de verificación de origen y estado de extracción;

• procedimientos que funcionaron y errores a evitar;

• traspasos de proyectos para agentes que se unan más tarde.

Strata no almacena secretos, transcripciones sin procesar, cadenas de pensamiento, claves de API ni configuraciones de proveedor.

Related MCP server: mnemochain

Qué incluye

Inicio rápido

git clone https://github.com/rx6ru/strata.git
cd strata
python -m venv .venv
. .venv/bin/activate
python -m pip install -e .
strata --help

Inicia una puerta de enlace local:

strata serve --root /tmp/strata-demo --host 127.0.0.1 --port 8787

Compruébalo desde otra terminal:

curl -fsS http://127.0.0.1:8787/healthz
curl -fsS -H 'X-Strata-Client: 1' http://127.0.0.1:8787/v1/status

Si estás ejecutando desde una copia del código fuente antes de instalar el paquete:

PYTHONPATH=. python -m strata --help
PYTHONPATH=. python -m strata root-hash --root /tmp/strata-demo

Lee la guía de configuración completa en docs/getting-started.md.

Cómo lo usan los agentes

1. Copia skills/strata/ en el directorio de habilidades del entorno de ejecución del agente.

2. Proporciona al agente solo valores de ejecución no secretos, como la URL de la puerta de enlace, el espacio de nombres, la tarea actual, el alias SSH y la ruta opcional del envoltorio del ciclo de vida.

3. El agente obtiene la política, prepara el contexto delimitado, lee los registros canónicos y escribe solo conocimiento duradero verificado.

4. Las correcciones añaden registros que reemplazan a los anteriores. La reorganización añade eventos de reubicación, división, fusión o invalidación. Los agentes comunes nunca editan el historial en el lugar.

La habilidad no codifica nombres de host, direcciones IP, ID de instancias EC2, nombres de usuario, claves de API, espacios de nombres de proyectos, hashes de políticas, raíces ni ID de registros. Consulta docs/agent-skill.md.

Cómo se mantienen limpias las escrituras

Strata comprueba cada escritura antes de confirmar:

• el hash de la política actual se reconoce antes de confirmar;

• los esquemas validan el registro;

• las claves de idempotencia evitan reintentos duplicados;

• los disparadores de SQLite de solo añadir bloquean las ediciones del historial en el lugar;

• los hashes de contenido y los manifiestos raíz hacen que las exportaciones sean verificables;

• los escáneres de secretos y transcripciones sin procesar rechazan cargas útiles no seguras;

• el recuerdo derivado se etiqueta como navegación, no como verdad.

Autoalojamiento

Para la pila Docker:

./scripts/configure.sh
./scripts/control.sh start

Para un servicio de sistema, usa la guía de instalación y el envoltorio de ciclo de vida restringido en deploy/. Los agentes remotos deben llamar solo a ese envoltorio para status, start, stop o restart.

El despliegue predeterminado no tiene usuarios a nivel de aplicación. Mantenlo en loopback, una red privada, SSH, VPN, firewall o tu propia capa de proxy/autenticación. Lee docs/security-model.md y SECURITY.md antes de alojarlo para un equipo.

REST y MCP

La puerta de enlace REST expone los endpoints de salud, política, estado, búsqueda, recuerdo, registro, añadir, reemplazar, reubicar, dividir, fusionar e invalidar bajo /v1.

El puente MCP expone herramientas correspondientes como memory_policy, memory_prepare_context, memory_search, memory_get, memory_capture_verified y memory_status.

Evaluación

PYTHONPATH=. python -m strata eval --input tests/fixtures/strata_eval/cases.json

El fixture comprueba el aislamiento de espacios de nombres, la procedencia, el comportamiento de promoción y rechazo, las etiquetas de recuerdo derivado y la fuga de valores prohibidos.

Licencia

MIT. Consulta LICENSE. Las notas de terceros están en THIRD_PARTY_NOTICES.md.