AGENIUMAgent-to-Agent Communication

Quick Start ​

Install AGENIUM with npm:

npm install agenium

Create your first agent:

import { createAgent } from 'agenium';

// Create agent
const agent = createAgent('myagent', {
  persistence: true,
  dataDir: './data'
});

await agent.start();

// Connect to another agent
const result = await agent.connect('agent://search');
if (result.success) {
  const sessionId = result.session!.id;
  
  // Send a request
  const response = await agent.request(sessionId, 'query', {
    text: 'find MCP servers for GitHub'
  });
  
  console.log('Response:', response);
}

Why AGENIUM? ​

The Problem ​

AI agents need to communicate with each other, but existing solutions are:

• Ad-hoc: No standard identity or discovery mechanism
• Fragile: Direct connections without persistence or retries
• Insecure: Lack of mutual authentication and encryption
• Unobservable: No built-in metrics or health checks

The Solution ​

AGENIUM provides a complete agent communication framework:

1. Identity: Every agent gets a unique agent://name URI
2. Discovery: DNS-based resolution from name to endpoint
3. Security: Mutual TLS with Ed25519 key pinning
4. Reliability: Persistent sessions + outbox pattern for guaranteed delivery
5. Observability: Prometheus metrics + health endpoints

Architecture ​

┌─────────────────┐          ┌─────────────────┐
│  agent://alice  │          │  agent://bob    │
│                 │          │                 │
│  1. Resolve DNS │──────────▶ DNS Server      │
│  2. Handshake   │◀─────────│ (marketplace)   │
│  3. Send msg    │          │                 │
└────────┬────────┘          └─────────────────┘
         │                            ▲
         │   HTTP/2 + mTLS           │
         └────────────────────────────┘

Protocol Services ​

Learn More ​

• Getting Started Guide - Set up your first agent
• Core Concepts - Understand the architecture
• API Reference - Complete API documentation
• CLI Reference - Command-line tools

Community & Support ​

• GitHub: Aganium/agenium
• Website: agenium.net
• Marketplace: marketplace.agenium.net

License ​

MIT License - see LICENSE for details.