{
  "markdown": "# AGENIUM\n\nStateful agent-to-agent communication client for the `agent://` protocol.\n\n## What is AGENIUM?\n\nAGENIUM 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.\n\n## Quick Start\n\n### Create a New Agent (Recommended)\n\n```bash\nnpx @agenium/create-agent my-agent\ncd my-agent\nnpm install\nnpm start\n```\n\nChoose from 3 templates: **echo** (hello world), **tools** (tool-calling), **api** (REST gateway).\n\n### Use as a Library\n\n```bash\nnpm install agenium\n```\n\n```typescript\nimport { AgeniumClient } from 'agenium';\n\nconst client = new AgeniumClient({\n  apiKey: 'dom_your_api_key_here',  // Get one at marketplace.agenium.net\n  agentUri: 'agent://myagent',\n});\n\n// Resolve another agent\nconst target = await client.resolve('agent://search');\nconsole.log(target.endpoint); // https://...\n\n// Connect and send message\nconst session = await client.connect('agent://search');\nawait session.send({ query: 'find MCP servers for GitHub' });\nconst response = await session.receive();\n```\n\n## Features\n\n- **`agent://` Protocol** — Unique agent identity via URI scheme\n- **DNS Resolution** — Discover agents by name (`agent://name` → endpoint)\n- **Stateful Sessions** — SQLite-backed persistent sessions\n- **HTTP/2 + mTLS** — Secure transport with mutual TLS\n- **At-Least-Once Delivery** — Outbox pattern for reliable messaging\n- **Circuit Breakers** — Automatic failure detection and recovery\n- **Prometheus Metrics** — Built-in observability\n\n## Getting an API Key\n\n1. Visit [marketplace.agenium.net](https://marketplace.agenium.net)\n2. Register a domain name (e.g., `agent://myagent`)\n3. Complete purchase (TON payment)\n4. Save your API key (shown only once)\n\n## CLI\n\n```bash\n# Initialize agent configuration\nagenium init\n\n# Resolve an agent\nagenium resolve agent://search\n\n# Check connection\nagenium status\n\n# End-to-end connectivity test\nagenium e2e\n```\n\n## Architecture\n\n```\nagent://myagent                    agent://search\n     │                                  │\n     ├── resolve(\"agent://search\") ────►│\n     │   (DNS lookup via marketplace)   │\n     │◄── endpoint: https://...  ───────┤\n     │                                  │\n     ├── POST /a2a/message ────────────►│\n     │   (HTTP/2 + mTLS)               │\n     │◄── response ────────────────────┤\n```\n\n## Configuration\n\n```typescript\nconst client = new AgeniumClient({\n  // Required\n  apiKey: 'dom_xxx',           // Your marketplace API key\n  agentUri: 'agent://myname',  // Your agent URI\n\n  // Optional\n  dnsServer: 'https://marketplace.agenium.net',  // DNS resolver\n  dataDir: './data',           // SQLite session storage\n  timeout: 30000,              // Request timeout (ms)\n  retries: 3,                  // Max retry attempts\n});\n```\n\n## API Reference\n\n### `client.resolve(agentUri)`\nResolve an agent URI to its endpoint and capabilities.\n\n### `client.connect(agentUri)`\nEstablish a stateful session with another agent.\n\n### `session.send(message)`\nSend a message in an active session.\n\n### `session.receive()`\nReceive the next message in a session.\n\n### `session.close()`\nGracefully close a session.\n\n## Protocol Services\n\nThe AGENIUM ecosystem includes:\n\n| Service | URI | Description |\n|---------|-----|-------------|\n| Search | `agent://agenium` | Agent & tool discovery engine |\n| Marketplace | [marketplace.agenium.net](https://marketplace.agenium.net) | Domain registration & credentials |\n\n## Development\n\n```bash\n# Install dependencies\nnpm install\n\n# Run tests\nnpm test\n\n# Build\nnpm run build\n\n# Run E2E tests\nnpm run e2e\n```\n\n## Tests\n\n56 tests passing:\n- 22 unit tests\n- 24 bug-server integration tests\n- 10 end-to-end tests\n\n## License\n\nMIT\n\n## Ecosystem\n\n| Package | Description |\n|---------|-------------|\n| [`agenium`](https://npm.im/agenium) | Core client SDK |\n| [`@agenium/create-agent`](https://github.com/Aganium/create-agenium-agent) | CLI scaffold tool |\n| [`@agenium/mcp-server`](https://npm.im/@agenium/mcp-server) | MCP → agent:// bridge |\n| [`discord-agenium`](https://npm.im/discord-agenium) | Discord bot gateway |\n| [`slack-agenium`](https://npm.im/slack-agenium) | Slack app gateway |\n| [`n8n-nodes-agenium`](https://npm.im/n8n-nodes-agenium) | n8n automation nodes |\n\n## Links\n\n- Website: [agenium.net](https://agenium.net)\n- Docs: [docs.agenium.net](https://docs.agenium.net)\n- Demo: [demo.agenium.net](https://demo.agenium.net)\n- Marketplace: [marketplace.agenium.net](https://marketplace.agenium.net)\n- Organization: [github.com/Aganium](https://github.com/Aganium)\n",
  "bytes": 4608,
  "sha": "f2a67ad0b17817bdf47133eeef351946aac0986160f168a7db8c216d01476d9a",
  "repo_slug": "aganium/agenium",
  "fonte": "repo",
  "truncated": false,
  "api": "https://agentalog.com/api/listings/mcp_io_github_chorghemaruti64_creator_ageniu_f171a119/readme"
}