AGNTCY Dir v0.3.0 Release Note

[muscariello]

🚀 AGNTCY Dir v0.3.0 Release — Major Update

We're excited to announce the release of AGNTCY Dir v0.3.0, a major upgrade that
stabilizes the API surface, unifies record models, introduces deterministic CIDs, adds
security schema, storage services, cross-dir sync mechanisms, unlocks powerful
network-wide search, and brings improvements to user/developer experience.

🌟 What's New in v0.3.0

Zero-Trust Security Architecture

• X.509-based SPIFFE/SPIRE identity framework with federation support
• Policy-based authorization framework with fine-grained access controls
• Secure mTLS communication across all services
• OCI-native PKI with client- and server-side verification capabilities

Content Standardization

• Unified Core v1 API with multi-version support for OASF objects
• Deterministic CID generation using canonical JSON marshaling
• Cross-language and service consistency with CIDv1 record addressing
• OCI-native object storage and relationship management

Search & Discovery

• Local search with wildcard and pattern matching support
• Network-wide record discovery with prefix-based search capabilities
• DHT-based routing for distributed service announcement and discovery

Data Synchronization

• Full and partial index synchronization with CID selection
• Automated sync workflows for simple data migration and replication
• Post-sync verification checks and search capabilities across records

Developer Experience

• Native Client SDKs for Golang, JavaScript, TypeScript, and Python
• Standardized CLI and SDK tooling with consistent interfaces
• Decoupled signing workflows for easier usage and integration
• Kubernetes deployment with SPIRE and Federation support

⚠️ Breaking Changes

Important: This release includes breaking changes that require updates:

• Proto API: Proto APIs and namespaces updated - regenerate code if you embed or call APIs
• SDK Changes: Applications should update to the latest SDK versions
• Server Changes: Deployments should upgrade to the new server version

If you maintain integrations or custom tooling, please review the repository CHANGELOG.md
and update imports, deployments, and perform necessary migrations.

📦 Component Compatibility Matrix

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

🚀 Getting Started

Installation

Directory API Server:

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

DIRCTL:

# Download latest dirctl (multi-platform support)
curl -L https://github.com/agntcy/dir/releases/download/v0.3.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

SDKs:

• Golang - pkg.go.dev/github.com/agntcy/dir/client - github.com/agntcy/dir/client

• Python - pypi.org/agntcy-dir - github.com/agntcy/dir/sdk/dir-py

• JavaScript - npmjs.com/agntcy-dir - github.com/agntcy/dir/sdk/dir-js

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:

• More powerful query capabilities and indexing
• Event subscription support for real-time updates
• Extended verification policies and attestation support
• Better object handling and lifecycle management with OCI
• Operational guides for larger topologies

---

#release #v0.3.0 #dir #api #cid #search #sync #sdk #security