agent-handoff-protocol · packages

Provides the core TypeScript definitions, error classes, and utility functions required to implement the Agent Handoff Protocol. It exports a set of interfaces, a typed event emitter, and retry logic to standardize data structures and communication across agent handoff systems.

Reduces conversation history into a condensed format using sliding window, extractive summary, or hybrid strategies to fit within specific token budgets. It provides a set of compressor classes that implement the `ContextCompressor` interface from `@reaatech/agent-handoff` and supports custom token counting logic.

Orchestrates the transfer of conversation state between AI agents using a `HandoffManager` class that handles context compression, routing logic, and transport delivery. It provides a lifecycle event system and supports multiple transport protocols, including MCP and HTTP, to manage agent-to-agent handoffs.

Selects the optimal agent for a handoff using a weighted scoring algorithm that evaluates skills, domain expertise, load, and language. It provides a `CapabilityBasedRouter` class and an `AgentRegistry` that implement the `HandoffRouter` interface from the `@reaatech/agent-handoff` package.

Provides transport layer implementations for agent-to-agent handoffs via MCP tool calls or HTTP POST requests. It includes a factory class that performs health checks and auto-selects the highest-priority transport based on agent capabilities.

Validates Agent Handoff Protocol payloads and agent compatibility using a `HandoffValidator` class or standalone manual functions. It optionally integrates with Zod for schema enforcement, falling back to manual validation if Zod is not installed.