Saltar al contenido principal

alphaswarm-kb-federation

Catalog date: 2026-06-24.

alphaswarm-kb-federation is a standalone cross-silo marketplace federation reverse-proxy. It allows tenants to securely share and subscribe to knowledge corpora across the AlphaSwarm platform.

Status​

Scaffold. The app factory, settings (ALPHASWARM_KB_FED_*), health surface (/healthz, /readyz, /metrics), Dockerfile, and Helm + compose skeletons are shipped. The /federation/recall router, the OpenFGA check, the share-token signer/verifier, and the BitemporalMerger described below are not yet implemented — see the repo's AGENTS.md for the current plan phase.

Role​

  • Knowledge Marketplace: Facilitates the discovery and recall of shared knowledge from other silos.
  • Secure Proxying: Brokers zero-copy dataset sharing without exposing subscriber bearers upstream.
  • Access Control: Integrates with OpenFGA to confirm visibility and subscription rights before minting signed share tokens.
  • Bitemporal Merging: Merges federated results into the subscriber's local context while preserving bitemporal metadata.

Flow​

subscriber silo                    federation gateway                source silo
─────────────────                  ──────────────────                ───────────
POST /federation/recall  ─────▶
                                   1. OpenFGA `check` (visible?)
                                   2. mint signed share token
                                   3. POST /kb/corpora/.../recall ──▶
                                                                    verify share token
                                                                    return hits
                                   4. BitemporalMerger.merge_layers
◀───────── ComposedResult

Hard Boundaries​

  1. Read-only by Design: The federation gateway never modifies upstream data.
  2. No Monolith Imports: Decoupled from alphaswarm.*; uses alphaswarm_core and HTTP.

Repository​