Context Bus

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

Le Context Bus est un journal d'événements persistant en ajout seul avec des événements versionnés, une lignée causale, des niveaux de cohérence et un routage sélectif. Chaque mutation de session, mise à jour de connaissance, création d'artefact et appel d'outil est publié comme un événement typé avec un versionnage monotonique. Les agents s'abonnent avec des TopicFilters pour ne recevoir que les événements pertinents, envoient des messages dirigés vers des agents spécifiques et utilisent le polling par curseur ou SSE pour les mises à jour en temps réel. Le transport cross-machine est pris en charge via des TransportEnvelopes signés et le protocole Google A2A JSON-RPC.

Le problème

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.

Abonnez-vous avec des TopicFilters pour un routage sélectif des événements. Les événements dirigés ciblent des agents spécifiques. Transport cross-machine via enveloppes signées.

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 outils

01

Routage sélectif et TopicFilter

Les agents s'abonnent avec des TopicFilters — filtrage par type d'événement, acteur, niveau de cohérence ou identité d'agent. Les événements dirigés ciblent uniquement certains agents, réduisant le bruit et économisant des tokens.

02

Niveaux de Cohérence

Chaque événement porte un niveau de cohérence — local (informatif), eventual (partagé, asynchrone) ou strong (nécessite la synchronisation) — pour que les agents sachent quels changements prioriser.

03

Transport A2A et transferts cross-machine

TransportEnvelopeV1 encapsule les paquets de contexte et les bundles de handoff avec des signatures HMAC-SHA256 et l'identité de l'agent pour un transport cross-machine sécurisé. Envoi via CLI (<code>lean-ctx pack send</code>) ou HTTP (<code>/v1/a2a/handoff</code>).

04

Compatibilité protocole Google A2A

Endpoint JSON-RPC 2.0 sur <code>/a2a</code> prenant en charge <code>tasks/send</code>, <code>tasks/get</code> et <code>tasks/cancel</code>. Agent Card publiée sur <code>/.well-known/agent.json</code> pour la découverte A2A standard.

05

Recherche d'événements, lignée et replay

Recherche plein texte sur les payloads d'événements (FTS5), graphes de lignée causale via des chaînes parent_id, replay basé sur curseur à partir de n'importe quel point. Les événements survivent aux redémarrages du serveur. Backfill automatique depuis SQLite.

6 Event Types
SSE Streaming Protocol
Event Replay Depth
outils

2 MCP outils

Le Context Bus est un journal d'événements persistant en ajout seul avec des événements versionnés, une lignée causale, des niveaux de cohérence et un routage sélectif. Chaque mutation de session, mise à jour de connaissance, création d'artefact et appel d'outil est publié comme un événement typé avec un versionnage monotonique. Les agents s'abonnent avec des TopicFilters pour ne recevoir que les événements pertinents, envoient des messages dirigés vers des agents spécifiques et utilisent le polling par curseur ou SSE pour les mises à jour en temps réel. Le transport cross-machine est pris en charge via des TransportEnvelopes signés et le protocole Google A2A JSON-RPC.

Context Bus

Documentation associée

Vérification

Chaque sortie porte une preuve

LeanCTX génère des artefacts de preuve pour chaque session : quels fichiers ont été lus, ce qui a été compressé, quelles vérifications ont réussi et comment les tokens ont été dépensés. Cela rend le travail IA auditable, reproductible et fiable.

Explore Context Bus

Le Context Bus est un journal d'événements persistant en ajout seul avec des événements versionnés, une lignée causale, des niveaux de cohérence et un routage sélectif. Chaque mutation de session, mise à jour de connaissance, création d'artefact et appel d'outil est publié comme un événement typé avec un versionnage monotonique. Les agents s'abonnent avec des TopicFilters pour ne recevoir que les événements pertinents, envoient des messages dirigés vers des agents spécifiques et utilisent le polling par curseur ou SSE pour les mises à jour en temps réel. Le transport cross-machine est pris en charge via des TransportEnvelopes signés et le protocole Google A2A JSON-RPC.