agent-uri 0.2.0

Agent URI Protocol Implementation - A complete suite for addressing and interacting with AI agents

Agent URI Reference Implementation

This repository contains a reference implementation of the agent:// protocol as defined in the protocol specification.

Overview

The agent:// protocol is a URI-based framework for addressing, invoking, and interoperating with autonomous and semi-autonomous software agents. It introduces a layered architecture that supports minimal implementations (addressing and transport) and extensible features (capability discovery, contracts, orchestration).

This reference implementation provides a complete implementation of the protocol, including:

• URI parsing and validation
• Agent descriptor handling
• Resolution framework
• Transport bindings (HTTPS, WebSocket, Local)
• Security implementations
• Client and server SDKs
• Integration with other protocols (Agent2Agent, MCP)
• Example implementations and tools

Architecture

The implementation follows a modular, layered architecture:

agent-uri/
├── README.md                    # Project overview, setup instructions
├── docs/                        # Documentation
│   ├── architecture.md          # Architecture overview
│   ├── api-reference.md         # API documentation
│   ├── examples.md              # Usage examples
│   ├── rfc/                     # RFC documents
│   ├── spec/                    # Specification details
│   └── archive/                 # Archived documents
├── packages/                    # Core packages
│   ├── uri-parser/              # URI parsing and manipulation
│   ├── descriptor/              # Agent descriptor handling
│   ├── resolver/                # Resolution framework
│   ├── transport/               # Transport bindings
│   │   ├── transports/          # Transport implementations
│   │   └── registry             # Transport registry
│   ├── client/                  # Client SDK
│   ├── server/                  # Server SDK
│   └── common/                  # Shared utilities and types
└── examples/                    # Example implementations
    └── echo-agent/              # Echo agent example

Getting Started

Coming soon

Documentation

• Architecture Overview
• API Reference
• Usage Examples
• Protocol Specification

License

BSD 3-Clause License