Context Bus

Context changes happen silently. No agent knows what another agent just learned, changed, or decided.

El Context Bus es un registro de eventos persistente y de solo adición con eventos versionados, linaje causal, niveles de consistencia y enrutamiento selectivo. Cada mutación de sesión, actualización de conocimiento, creación de artefacto y llamada de herramienta se publica como un evento tipado con versionado monotónico. Los agentes se suscriben con TopicFilters para recibir solo eventos relevantes, envían mensajes dirigidos a agentes concretos y usan sondeo basado en cursor o SSE para actualizaciones en tiempo real. El transporte entre máquinas se admite mediante TransportEnvelopes firmados y el protocolo Google A2A JSON-RPC.

El problema

Silent Context Drift

Agent A learns that the database schema changed. Agent B, working on the same project, has no idea and writes queries against the old schema. Without a shared event stream, context drift is invisible.

Suscríbase con TopicFilters para un enrutamiento selectivo de eventos. Los eventos dirigidos van a agentes específicos. Transporte entre máquinas mediante sobres firmados.

curl
curl (-N http://localhost:7700/v1/events?workspaceId=my-team)
- id: 42
- event: session_mutated
- data: {"id":42,"workspaceId":"my-team","channelId":"feat/auth",
- "kind":"session_mutated","version":42,"consistencyLevel":"strong",
- "actor":"cursor","payload":{"tool":"ctx_session","action":"save"}}
-
- id: 43
- event: knowledge_remembered
- data: {"id":43,"workspaceId":"my-team","channelId":"feat/auth",
- "kind":"knowledge_remembered","version":43,"parentId":42,
- "consistencyLevel":"eventual","actor":"claude","payload":{
- "tool":"ctx_knowledge","key":"auth/strategy"}}
Context Bus

5 herramientas

01

Enrutamiento selectivo y TopicFilter

Los agentes se suscriben con TopicFilters: filtran por tipo de evento, actor, nivel de consistencia o identidad del agente. Los eventos dirigidos se dirigen solo a agentes específicos, reduciendo ruido y ahorrando tokens.

02

Niveles de Consistencia

Cada evento lleva un nivel de consistencia — local (informativo), eventual (compartido, asíncrono) o strong (requiere sincronización) — para que los agentes sepan qué cambios priorizar.

03

Transporte A2A y traspasos entre máquinas

TransportEnvelopeV1 envuelve paquetes de contexto y bundles de handoff con firmas HMAC-SHA256 e identidad del agente para un transporte seguro entre máquinas. Envío por CLI (<code>lean-ctx pack send</code>) o HTTP (<code>/v1/a2a/handoff</code>).

04

Compatibilidad con el protocolo Google A2A

El endpoint JSON-RPC 2.0 en <code>/a2a</code> admite <code>tasks/send</code>, <code>tasks/get</code> y <code>tasks/cancel</code>. Agent Card publicada en <code>/.well-known/agent.json</code> para el descubrimiento A2A estándar.

05

Búsqueda de eventos, linaje y replay

Búsqueda de texto completo sobre payloads de eventos (FTS5), grafos de linaje causal mediante cadenas parent_id, replay basado en cursor desde cualquier punto. Los eventos sobreviven a reinicios del servidor. Backfill automático desde SQLite.

6 Event Types
SSE Streaming Protocol
Event Replay Depth
herramientas

2 MCP herramientas

El Context Bus es un registro de eventos persistente y de solo adición con eventos versionados, linaje causal, niveles de consistencia y enrutamiento selectivo. Cada mutación de sesión, actualización de conocimiento, creación de artefacto y llamada de herramienta se publica como un evento tipado con versionado monotónico. Los agentes se suscriben con TopicFilters para recibir solo eventos relevantes, envían mensajes dirigidos a agentes concretos y usan sondeo basado en cursor o SSE para actualizaciones en tiempo real. El transporte entre máquinas se admite mediante TransportEnvelopes firmados y el protocolo Google A2A JSON-RPC.

Context Bus

Documentación relacionada

Verificación

Cada salida lleva prueba

LeanCTX genera artefactos de prueba para cada sesión: qué archivos se leyeron, qué se comprimió, qué verificaciones pasaron y cómo se gastaron los tokens. Esto hace que el trabajo de IA sea auditable, reproducible y confiable.

Explore Context Bus

El Context Bus es un registro de eventos persistente y de solo adición con eventos versionados, linaje causal, niveles de consistencia y enrutamiento selectivo. Cada mutación de sesión, actualización de conocimiento, creación de artefacto y llamada de herramienta se publica como un evento tipado con versionado monotónico. Los agentes se suscriben con TopicFilters para recibir solo eventos relevantes, envían mensajes dirigidos a agentes concretos y usan sondeo basado en cursor o SSE para actualizaciones en tiempo real. El transporte entre máquinas se admite mediante TransportEnvelopes firmados y el protocolo Google A2A JSON-RPC.