Aganium/agenium

Stateful agent-to-agent communication client for the agent:// protocol.
What is AGENIUM?
AGENIUM provides identity, discovery, and messaging for AI agents. Think of it as DNS + HTTP for agents — each agent gets a unique agent://name URI and can discover and communicate with other agents.
Quick Start
Create a New Agent (Recommended)
Choose from 3 templates: **echo** (hello world), **tools** (tool-calling), **api** (REST gateway).
Use as a Library
Features
- **agent:// Protocol** — Unique agent identity via URI scheme
- **DNS Resolution** — Discover agents by name (agent://name → endpoint)
- **Stateful Sessions** — SQLite-backed persistent sessions
- **HTTP/2 + mTLS** — Secure transport with mutual TLS
- **At-Least-Once Delivery** — Outbox pattern for reliable messaging
- **Circuit Breakers** — Automatic failure detection and recovery
- **Prometheus Metrics** — Built-in observability
Getting an API Key
1. Visit marketplace.agenium.net
2. Register a domain name (e.g., agent://myagent)
3. Complete purchase (TON payment)
4. Save your API key (shown only once)
CLI
Architecture
Configuration
API Reference
client.resolve(agentUri)
Resolve an agent URI to its endpoint and capabilities.
client.connect(agentUri)
Establish a stateful session with another agent.
session.send(message)
Send a message in an active session.
session.receive()
Receive the next message in a session.
session.close()
Gracefully close a session.
Protocol Services
The AGENIUM ecosystem includes:
| Service | URI | Description |
|---------|-----|-------------|
| Search | agent://agenium | Agent & tool discovery engine |
| Marketplace | marketplace.agenium.net | Domain registration & credentials |
Development
Tests
56 tests passing:
- 22 unit tests
- 24 bug-server integration tests
- 10 end-to-end tests
License
MIT
Ecosystem
| Package | Description |
|---------|-------------|
| agenium | Core client SDK |
| @agenium/create-agent | CLI scaffold tool |
| @agenium/mcp-server | MCP → agent:// bridge |
| discord-agenium | Discord bot gateway |