AGNTCY Dir v0.4.0 Release Notes

[ramizpolic]

🚀 AGNTCY Dir v0.4.0 Release

We're excited to announce the release of AGNTCY Dir v0.4.0, a major upgrade that
delivers improvements to application layer via generic referrers, security schema with
JWT/TLS support, network capabilities, operational stability, and developer experience,
with a focus on:

🌟 What's New in v0.4.0

Security & Authentication

• Secure communication with JWT/X.509 over TLS versus mTLS
• Authenticated PeerID integration with libp2p transport
• Secure credential management for zot sync operations
• OCI 1.1 referrers specification migration for signature attachments

Networking & Connectivity

• GossipSub implementation for efficient label announcements
• Connection Manager implementation with removal of custom peer discovery
• Improved routing search with better peer address handling
• Locator-based record search capabilities across the network

Generic Record Referrers

• Support for storage and handling of generic record referrers
• Referrer object encoding across server and SDK components
• Application support via referrer (e.g., signatures, attestations)

Developer Experience & Tooling

• Streaming package for Golang gRPC client functionality
• Standardized CLI output formats and command improvements
• Reusable setup-dirctl GitHub Action for CI/CD workflows

Quality & Stability Improvements

• Comprehensive test suite enhancements including SPIRE tests
• E2E network test stability with environment warm-up phases
• Bug fixes for API key formatting, file permissions, and documentation

📦 Component Compatibility Matrix

Component	Version	Compatible With
dir-apiserver	v0.4.0	oasf v0.3.x, v0.7.x
dirctl	v0.4.0	dir-apiserver >= v0.3.0, oasf v0.3.x, v0.7.x
dir-go	v0.4.0	dir-apiserver >= v0.3.0, oasf v0.3.x, v0.7.x
dir-py	v0.4.0	dir-apiserver >= v0.3.0, oasf v0.3.x, v0.7.x
dir-js	v0.4.0	dir-apiserver >= v0.3.0, oasf v0.3.x, v0.7.x

🚀 Getting Started

Installation

DIR API Server:

# Install Directory via Helm
helm install dir oci://ghcr.io/agntcy/dir/helm-charts/dir --version v0.4.0

DIRCTL:

# Download latest dirctl (multi-platform support)
curl -L https://github.com/agntcy/dir/releases/download/v0.4.0/dirctl-<platform> -o dirctl
chmod +x dirctl

# OR install via Homebrew (macOS/Linux)
brew tap agntcy/dir https://github.com/agntcy/dir/
brew install dirctl

Language-specific SDKs

Quick Start Example

Check out the examples to get started with AGNTCY Directory.

🤝 Community & Support

• Changelog: Changelog
• Issues: GitHub Issues
• Milestones: GitHub Milestones
• Discussions: GitHub Discussions
• Documentation: docs.agntcy.org

🙏 Acknowledgments

Thank you to all contributors who made this release possible! Special thanks to the community for
feedback, bug reports, and feature requests that helped shape this release.

🔮 What's Next?

Stay tuned for upcoming features:

• Sync support for heterogeneous registries
• Production-ready API
• Directory MCP Server

---

#release #v0.4.0 #dir