agent-handoff-protocol · packages

Core types, utilities, and configuration for the Agent Handoff Protocol, providing 35+ TypeScript types, 7 typed error classes, a typed event emitter, a retry utility with configurable backoff, and a config factory — all with zero runtime dependencies.

Compresses conversation history before agent handoff using three built-in strategies (hybrid, summary, sliding-window) with configurable token budgets. Exports compressor classes (`HybridCompressor`, `SummaryCompressor`, `SlidingWindowCompressor`) that implement the `ContextCompressor` interface from `@reaatech/agent-handoff`, plus a `SimpleTokenCounter` for heuristic token estimation.

A TypeScript library for transferring a conversation from one AI agent to another mid-session, providing context compression, capability-based routing, payload validation, transport delivery, and rejection handling with fallback. It exports a `HandoffManager` class that orchestrates the lifecycle, along with composable components like `HybridCompressor`, `CapabilityBasedRouter`, and `MCPTransport`.

A weighted scoring engine that selects the best target agent during a handoff, implementing a route/clarify/fallback decision tree with an in-memory agent registry. Exports `CapabilityBasedRouter` (a class implementing the `HandoffRouter` interface from `@reaatech/agent-handoff`) and `AgentRegistry`.

Transport layer implementations for delivering handoffs between agents, providing MCP (tool-call-based), A2A (HTTP POST with retry), and a transport factory with health-check caching and priority-based auto-selection. Exports `MCPTransport`, `A2ATransport`, and `TransportFactory` classes.

Validates `HandoffPayload` structure and checks agent compatibility (language, capacity, availability, history size) for the Agent Handoff Protocol. Exports a `HandoffValidator` class with a `validatePayload` method, plus standalone manual validation functions and a `classifyRejectionReason` utility; optionally uses Zod for stricter schema validation when installed.