AXL Protocol¶
Agent eXchange Language — Let them speak.
AXL is a universal language for agents and autonomous machines. It is not an API, not a framework, and not a prompt template. It is a grammar — a structured, parseable, self-describing packet format that any LLM can learn on first read.
Why AXL?¶
Agents today communicate through fragile JSON blobs, ad-hoc function calls, and prompt-engineered natural language. AXL replaces all of that with a single, deterministic wire format that is:
- Learnable in one read — a 133-line Rosetta specification teaches any LLM the full grammar on first exposure.
- Proven at scale — 95.8% comprehension across tested models, 1,502 packets generated with 100% parse validity.
- Type-safe — Egyptian-inspired determinatives prevent injection and ambiguity.
- Payment-native — every packet carries a cryptographic payment proof (
π) as part of its grammar. - Five encoding layers — from human-readable L4 down to vector-embedded L0.
Quick Start¶
from axl import Packet
pkt = Packet.parse(
"@rosetta_url|π:AXL_ID:SIG:GAS|T:1719422400|S:OPS.CRITICAL"
"|target:db-primary|status:!DOWN|metric:latency|value:%312.5"
"|threshold:#100|action:failover|LOG"
)
print(pkt.domain) # OPS
print(pkt.tier) # CRITICAL
print(pkt.flags) # ['LOG']
Documentation¶
Specification¶
| Section | Description |
|---|---|
| Packet Format | Full anatomy of an AXL packet |
| Domains | All 10 domain schemas and field definitions |
| Type System | Determinative type sigils and injection prevention |
| Payment Proof (π) | Cryptographic payment grammar |
| Flags | The 6 trailing metadata flags |
| Encoding Layers | L0 through L4 encoding stack |
Rosetta¶
| Section | Description |
|---|---|
| The Rosetta | The 133-line self-bootstrapping spec |
| P-S-A-S-E-G-D Algorithm | How the Rosetta is generated |
| Full Rosetta Text | Complete 133-line Rosetta reference |
Key Numbers¶
| Metric | Value |
|---|---|
| Rosetta length | 445 lines, ~2,800 words, ~25,900 bytes |
| Comprehension | 95.8% on first read |
| Test corpus | 1,502 packets |
| Parse validity | 100% |
| Domains | 10 |
| Encoding layers | 5 (L0-L4) |
| Flags | 6 |
License¶
AXL Protocol is open. The Rosetta is served live at https://axlprotocol.org/rosetta.