halyn 2.0.0

Halyn — AAP in action. AI agents that can prove what they did.

Halyn

AAP in action. AI agents that can prove what they did.

The reference implementation of AAP — Agent Accountability Protocol

Website · AAP Spec · NRP

---

What is Halyn?

Halyn is the complete demonstration of AAP.

Every agent action goes through 7 steps — none skippable:

Identity → Authorization → Scope → Shield → Execute → Provenance → Audit

from halyn import HalynControlPlane, ExecutionContext
from aap import AAPKeyPair, AAPIdentity, AAPAuthorization, AuthorizationLevel

# Setup
supervisor = AAPKeyPair.generate()
cp = HalynControlPlane(supervisor_keypair=supervisor, supervisor_did="did:key:z6Mk...")

# Register agent + node
cp.register_identity(identity)
cp.register_node(node)
auth = cp.grant_authorization(agent_id=..., level=AuthorizationLevel.SUPERVISED, scope=["write:file"])

# Execute — full AAP pipeline, fully audited
ctx = ExecutionContext(identity=identity, authorization=auth, agent_keypair=agent_kp)
result = cp.execute(ctx, node_id="nrp://acme/server/files-1", action="write:file", params={...})

# Verify audit chain integrity
valid, count, broken = cp.verify_audit()

AAP Ecosystem

Layer	Project	Role
Spec	AAP	Protocol definition
Physical	NRP	AAP for robots, IoT, machines
Full system	Halyn (this)	Complete demonstration

License

MIT