La Especificación de la Cápsula.
Una cápsula es el activo permanente detrás de una Retenta: corpus + manifiesto + conjunto de evaluación + registro de escrituras. Las incrustaciones y los índices son artefactos desechables, reconstruibles en cualquier momento. Publicamos el formato abiertamente porque la portabilidad solo cuenta si puedes leerlo y reconstruirlo sin nosotros.
La infraestructura es desechable. La memoria es permanente.
Qué hay en una cápsula
Corpus
Texto fuente direccionado por contenido — cada fragmento identificado por su SHA-256, incluido el audio transcrito a texto durante la construcción. Esto es lo que tu agente recuerda; las incrustaciones y el índice se reconstruyen a partir de él.
Manifiesto
Registra qué construyó la capa desechable: versión de la cápsula, motor, el modelo de incrustación y los hashes de corpus + manifiesto — para que cualquier versión sepa exactamente qué produjo su índice.
Conjunto de evaluación
Los casos con los que se califica tu cápsula, más la ejecución más reciente. Cada versión la puntúa un juez LLM; la puntuación y el aprobado/reprobado viajan con la cápsula.
Registro de escrituras
Solo de adición. Cada escritura lleva procedencia — agente, sesión, fuente — y cada reversión es una entrada de lápida. Nada se elimina de forma permanente del registro.
El paquete de exportación
GET /capsules/:id/export devuelve toda la cápsula como un solo archivo — más un directorio rematerialize/ que reconstruye la capa desechable en otro destino, y un informe de paridad de evaluación que compara las puntuaciones antes y después.
maple-harbor.capsule/
manifest.json # version, engine, embedding model, hashes, eval score
corpus/ # content-addressed source text, incl. transcribed audio (sha256 filenames)
evals/ # the eval set + the latest run
writes_log.jsonl # append-only — provenance + revert markers
rematerialize/ # scripts to rebuild on pgvector + one more target
eval-parity.json # eval scores: original engine vs. re-materializedEl manifiesto
Direccionado por contenido y autodescriptivo. El manifiesto registra el modelo de incrustación que construyó el índice, los hashes del corpus y del manifiesto, la versión padre y la puntuación de evaluación — para que cualquier versión sea reproducible y cada construcción sea rastreable a lo que la produjo.
{
"retenta": "0.1",
"capsule": "maple-harbor",
"version": "v14",
"parent": "v13",
"engine": "cloudflare-native",
"embedding_model": "@cf/baai/bge-base-en-v1.5",
"corpus_hash": "sha256:2f0a…",
"manifest_hash": "sha256:9c31…",
"eval": { "score": 0.94, "passed": true, "gate": 0.90 }
}El registro de escrituras
Una cápsula es memoria en la que un agente escribe, no solo lee. Cada escritura es una entrada de solo adición con procedencia; una reversión es una nueva entrada de lápida que también elimina el vector. El registro es el rastro de auditoría — nada se elimina de forma permanente.
{"ts":"2026-07-19T04:12:03Z","op":"write","agent":"claude-loop",
"session":"s_8a1","source":"nightly-triage","id":"w_123"}
{"ts":"2026-07-19T05:40:11Z","op":"revert","reverts":"w_123","id":"w_140"}Las garantías
Portabilidad
Exporta y rematerializa en cualquier base de datos vectorial, modelo de incrustación o nube. La calidad de las respuestas puede variar según el motor; el comportamiento de gobernanza no — y un informe de paridad de evaluación lo demuestra.
Cada versión evaluada
El conjunto de evaluación viaja con la cápsula. Cada versión se califica y se controla; las versiones por debajo del umbral se crean pero nunca se promueven, así que el formato mismo lleva el listón de calidad.
Versionado compatible con Git
Direccionado por contenido y basado en texto: fija, compara y revierte. Producción sirve la versión que fijaste, y el registro anota qué versión respondió cada consulta.
Posee la memoria. Alquila la infraestructura.
Crea una cápsula, llénala y expórtala cuando quieras — el formato es tuyo para leer y reconstruir, con nosotros o sin nosotros.