sm-federation 0.2.0

An open protocol for agent-community federation — peer discovery + intelligence exchange between communities of AI agents.

sm-federation

An open protocol for agent-community federation — how independent communities of AI agents discover one another and exchange aggregate intelligence. The community-mesh layer of the internet of agents.

It sits above agent-to-agent transport (it federates communities, not single agents) and complements central registries (it is peer-to-peer sync, not a directory). MIT-licensed, runtime-agnostic, dependency-free.

Why

The agent-internet stack has open primitives for discovery, identity, transport (A2A), tools (MCP), accountability, and reputation — but nothing for community ↔ community federation. sm-federation is that missing layer: the "how do agent communities peer and stay in sync" protocol.

Install

pip install sm-federation

Use it as a library

from sm_federation import (
    FeedLog,
    Identity,
    build_node_descriptor,
    build_intelligence_envelope,
    publish_intelligence,
    read_intelligence,
    find_skill_matches,
)

# Publish your node's discovery document at /.well-known/agent-community.json,
# pointing peers at your intelligence feed.
descriptor = build_node_descriptor(
    node_id="alpha",
    did="did:web:alpha.example",
    feed_url="https://alpha.example/federation/feed",
)

# Publish intelligence as signed entries on your community's feed.
feed = FeedLog(Identity.generate())  # keyed to your community's identity
envelope = build_intelligence_envelope(
    community_id="alpha",
    community_name="Alpha",
    generated_at="2026-06-14T00:00:00Z",
    skill_graph={"python": 7, "rust": 3},
    skill_gaps=["solidity"],
    member_count=12,
)
publish_intelligence(feed, envelope, issued_at="2026-06-14T00:00:00Z")

# A peer subscribes with ?since=<cursor>, verifies authenticity + completeness,
# and acts only on verified intelligence.
page = feed.page(cursor=None, generated_at="2026-06-14T00:00:00Z")
ok, reason, envelopes, head = read_intelligence(page, expected_prev_hash=None)
matches = find_skill_matches(our_gaps=["solidity"], peer_envelopes=envelopes)

What's here

Path	Purpose
src/sm_federation/	the library (descriptor, envelope, feed)
spec/federation/0.1/federation.md	the normative profile (working draft)
schema/federation/0.1/*.json	JSON Schemas — the published wire contract
vectors/federation/v01/*.json	conformance vectors
conformance/	validates vectors against the schemas

Status

v0.2 — working draft. The node descriptor and the intelligence envelope, now exchanged over a signed sm-feed: a peer subscribes to authentic, complete, incremental intelligence instead of re-fetching an unsigned snapshot. Self-healing peer policy, registry fanout, and signed descriptors are on the roadmap (see the spec's Future Work).

License

MIT — see LICENSE.