Context Bus

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

O Context Bus é um registro de eventos persistente e somente de adição com eventos versionados, linhagem causal, níveis de consistência e roteamento seletivo. Cada mutação de sessão, atualização de conhecimento, criação de artefato e chamada de ferramenta é publicada como um evento tipado com versionamento monotônico. Os agentes assinam com TopicFilters para receber apenas eventos relevantes, enviam mensagens direcionadas a agentes específicos e usam polling baseado em cursor ou SSE para atualizações em tempo real. Transporte entre máquinas é suportado via TransportEnvelopes assinados e o protocolo Google A2A JSON-RPC.

O 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.

Inscreva-se com TopicFilters para roteamento seletivo de eventos. Eventos direcionados visam agentes específicos. Transporte entre máquinas via envelopes assinados.

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 ferramentas

01

Roteamento seletivo e TopicFilter

Os agentes inscrevem-se com TopicFilters — filtram por tipo de evento, ator, nível de consistência ou identidade do agente. Eventos direcionados visam apenas agentes específicos, reduzindo ruído e economizando tokens.

02

Níveis de Consistência

Cada evento carrega um nível de consistência — local (informativo), eventual (compartilhado, assíncrono) ou strong (requer sincronização) — para que os agentes saibam quais mudanças priorizar.

03

Transporte A2A e handoffs entre máquinas

TransportEnvelopeV1 encapsula pacotes de contexto e bundles de handoff com assinaturas HMAC-SHA256 e identidade do agente para transporte seguro entre máquinas. Envio via CLI (<code>lean-ctx pack send</code>) ou HTTP (<code>/v1/a2a/handoff</code>).

04

Compatibilidade com o protocolo Google A2A

Endpoint JSON-RPC 2.0 em <code>/a2a</code> com suporte a <code>tasks/send</code>, <code>tasks/get</code> e <code>tasks/cancel</code>. Agent Card publicada em <code>/.well-known/agent.json</code> para descoberta A2A padrão.

05

Pesquisa de eventos, linhagem e replay

Pesquisa de texto completo sobre payloads de eventos (FTS5), grafos de linhagem causal via cadeias parent_id, replay baseado em cursor a partir de qualquer ponto. Os eventos sobrevivem a reinicializações do servidor. Backfill automático do SQLite.

6 Event Types
SSE Streaming Protocol
Event Replay Depth
ferramentas

2 MCP ferramentas

O Context Bus é um registro de eventos persistente e somente de adição com eventos versionados, linhagem causal, níveis de consistência e roteamento seletivo. Cada mutação de sessão, atualização de conhecimento, criação de artefato e chamada de ferramenta é publicada como um evento tipado com versionamento monotônico. Os agentes assinam com TopicFilters para receber apenas eventos relevantes, enviam mensagens direcionadas a agentes específicos e usam polling baseado em cursor ou SSE para atualizações em tempo real. Transporte entre máquinas é suportado via TransportEnvelopes assinados e o protocolo Google A2A JSON-RPC.

Context Bus

Documentação relacionada

Verificação

Cada saída carrega prova

O LeanCTX gera artefatos de prova para cada sessão: quais arquivos foram lidos, o que foi comprimido, quais verificações passaram e como os tokens foram gastos. Isso torna o trabalho de IA auditável, reproduzível e confiável.

Explore Context Bus

O Context Bus é um registro de eventos persistente e somente de adição com eventos versionados, linhagem causal, níveis de consistência e roteamento seletivo. Cada mutação de sessão, atualização de conhecimento, criação de artefato e chamada de ferramenta é publicada como um evento tipado com versionamento monotônico. Os agentes assinam com TopicFilters para receber apenas eventos relevantes, enviam mensagens direcionadas a agentes específicos e usam polling baseado em cursor ou SSE para atualizações em tempo real. Transporte entre máquinas é suportado via TransportEnvelopes assinados e o protocolo Google A2A JSON-RPC.