A TypeScript SDK for implementing the Agent-to-Agent (A2A) communication protocol, enabling seamless communication between AI agents.
This SDK provides a complete implementation of the A2A protocol specification, allowing developers to build, connect, and deploy intelligent agents. Developed by Dexwox Innovations Pvt Ltd to offer a robust TypeScript solution for agent-based systems.
Unified package that includes all Google A2A protocol components:
- Complete implementation of Google's A2A protocol in a single package
- Documentation and examples
- Simplified imports and usage
Google A2A protocol server implementation with:
- HTTP/WebSocket interfaces compliant with Google's A2A specification
- Task management for A2A agents
- Request handling for agent communication
- Middleware support
Client library for interacting with Google A2A protocol agents:
- Type-safe API client for Google's A2A protocol
- Circuit breaker pattern
- Error handling
- Message streaming
Shared types and utilities for Google's A2A protocol:
- Google A2A protocol definitions and interfaces
- Validation decorators for protocol compliance
- Common utilities for working with A2A messages
- Error classes for protocol-specific error handling
- Node.js 18+
- pnpm 8+
git clone https://github.com/Dexwox-Innovations-Org/a2a-node-sdk.git
cd a2a-node-sdk
pnpm install# Install the unified package (recommended)
npm install @dexwox-labs/a2a-node
# Or install individual packages if needed
npm install @dexwox-labs/a2a-core
npm install @dexwox-labs/a2a-client
npm install @dexwox-labs/a2a-server# Run all tests
pnpm test
# Start dev servers
pnpm devCheck out the examples directory for working code samples:
- Basic Client: Simple client implementation showing how to connect to an A2A server
- Basic Server: Simple server implementation demonstrating how to create and host an agent
- Weather Agent: Example agent implementation that processes weather-related queries
- Full Stack: Complete example with client, server, and agent integration
graph TD
A[Client] -->|HTTP/WS| B[Server]
B --> C[Task Manager]
C --> D[Agent Executor]
D --> E[External Services]
- API Reference - Comprehensive reference for all A2A APIs
- Protocol Specification - Details of the A2A communication protocol
- Development Guide - Guide for developing with the A2A platform
- Deployment Guide - Strategies for deploying A2A applications to production
- Integration Guide - Instructions for integrating A2A with other systems
Please read CONTRIBUTING.md for development guidelines.
A2A protocol is a specification for agent communication. This implementation is provided by Dexwox Innovations Pvt Ltd. Google and A2A are trademarks of Google LLC.
- Complete Protocol Implementation: Full implementation of Google's A2A protocol specification
- TypeScript Support: Built with TypeScript for type safety and better developer experience
- Modular Architecture: Use the full package or individual components as needed
- Extensible: Easily extend with custom middleware and handlers
- Well-Documented: Comprehensive documentation and examples
- Production-Ready: Designed for reliability and performance in production environments
This SDK is compatible with the following versions of Google's A2A protocol:
- A2A Protocol v1.0 (current stable version)
We strive to maintain compatibility with the latest protocol specifications as they evolve.
- Enhanced WebSocket support for real-time agent communication
- Additional middleware for common use cases
- Performance optimizations for large-scale deployments
- Integration with popular AI frameworks
- Google A2A Protocol Documentation - Official documentation for Google's A2A protocol
- A2A Protocol Specification - Technical specification for the protocol