a2a-reference-ts · packages

Provides a set of interchangeable authentication strategies—including API key, JWT, and no-op—that implement a unified `authenticate` method. Each strategy is exported as a class that validates request headers and returns a standardized authentication result.

Provides a TypeScript client class for interacting with A2A agents via JSON-RPC 2.0 and Server-Sent Events. It includes built-in agent discovery, automatic retry logic, and an `AsyncGenerator` interface for consuming real-time task streams.

Provides canonical TypeScript types, Zod schemas, and custom error classes for the Agent-to-Agent (A2A) protocol. It serves as a shared library for validating agent cards, tasks, messages, and artifacts at runtime.

Exposes A2A agent skills as MCP tools and wraps MCP tools as A2A skills to enable interoperability between the two ecosystems. It provides classes for bidirectional protocol translation and requires the `@modelcontextprotocol/sdk` package at runtime.

Provides pre-configured Pino logger instances and utility functions for propagating correlation IDs across asynchronous boundaries. It exports a default logger and factory functions that automatically toggle between human-readable output for development and structured JSON for production environments.

Provides a standardized `TaskStore` interface for persisting A2A task state, offering implementations for in-memory, file-system, and Redis storage. It supports paginated listing, history management, and artifact tracking, with the Redis implementation requiring the `ioredis` package at runtime.

Provides Express and Hono adapters for building interoperable AI agents using JSON-RPC 2.0 routing, SSE streaming, and a task lifecycle state machine. It exposes factory functions that accept an agent definition and execution logic to generate a fully configured server instance.