Metadata-Version: 2.4
Name: beacon-protocol
Version: 0.1.0
Summary: Fleet discovery and registry — Ship Protocol Layer 5. The lighthouse broadcasting.
Author-email: Oracle1 <oracle1@cocapn.ai>
License-Expression: MIT
Project-URL: Homepage, https://github.com/SuperInstance/beacon-protocol
Keywords: beacon,discovery,fleet,registry,cocapn,ship-protocol
Classifier: Development Status :: 3 - Alpha
Classifier: Intended Audience :: Developers
Classifier: Programming Language :: Python :: 3
Requires-Python: >=3.10
Description-Content-Type: text/markdown

# beacon-protocol

Fleet discovery and registry. Ship Protocol Layer 5. The lighthouse broadcasting.

Agents register their capabilities and services. Other agents discover them. Heartbeats keep the roster alive. Beacons broadcast events fleet-wide.

## Usage

```python
from beacon_protocol import BeaconRegistry, AgentDescriptor, ServiceType, Beacon

registry = BeaconRegistry()
registry.register(AgentDescriptor(
    agent_id="oracle1", name="Oracle1",
    services=[ServiceType.KEEPER],
    capabilities=["crates", "coordination"],
    endpoint="keeper:8900",
))

# Discover agents with crate publishing capability
agents = registry.discover(capabilities=["crates"])

# Broadcast an event
registry.broadcast(Beacon(agent_id="oracle1", payload={"event": "crate_published"}))
```

Zero deps. `pip install beacon-protocol`
