Skip to content
reaatechREAATECH

reaatech/agent-handoff-protocol

0Last commit: Jun 4, 2026GitHub →

These packages give you a complete lifecycle for transferring a conversation from one AI agent to another mid-session, including compressing the conversation history, scoring and selecting the best target agent, validating payload compatibility, delivering the handoff via MCP or A2A transport, and handling rejection with fallback alternatives. You would adopt them to solve the problem of routing a live multi-turn conversation between specialized agents without losing context or requiring the user to repeat themselves. The most distinctive thing is that every stage—compression, routing, validation, transport, and rejection handling—is a separate, pluggable package with zero runtime dependencies, so you can compose only the pieces you need and inject your own implementations for any stage.

Packages

6 packages

@reaatech/agent-handoff

v0.1.0
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.
status
published
published
1 month ago

@reaatech/agent-handoff-compression

v0.1.0
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.
status
published
published
1 month ago

@reaatech/agent-handoff-protocol

v0.1.0
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`.
status
published
published
1 month ago

@reaatech/agent-handoff-routing

v0.1.0
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`.
status
published
published
1 month ago

@reaatech/agent-handoff-transport

v0.1.0
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.
status
published
published
1 month ago

@reaatech/agent-handoff-validation

v0.1.0
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.
status
published
published
1 month ago

Comments

Sign in with GitHub to comment and vote.

Loading comments…