ahp_sdk 0.1.0

A Dart implementation of the Agent Host Protocol (AHP) — synchronized multi-client state for AI agent sessions.

Changelog

All notable changes to the Dart client are documented here.

The format follows Keep a Changelog, and this package adheres to Semantic Versioning.

The Dart client moves on its own SemVer track, independent of the protocol specification version it implements.

0.1.0

First release. Implements protocol 0.7.0.

Added

• Generated wire types for the full protocol surface, emitted from types/ by scripts/generate-dart.ts. Verified against upstream's 39-fixture round-trip corpus.
• The seven channel reducers, hand-ported from types/channels-*/reducer.ts and verified against upstream's 246-fixture corpus.
• Write-ahead reconciliation with optimistic dispatch, rejection revert, and rebase-on-foreign-action. No other AHP client implements this, so there is no cross-language corpus; correctness rests on a convergence property suite.
• AhpStateMirror, routing all seven channel kinds — including the annotations channel, which is addressed as a path suffix on the session scheme rather than a scheme of its own.
• WebSocket transport and a bidirectional JSON-RPC peer that answers the host's resource* requests, so a host is never left waiting.
• AhpRuntime: refcounted subscriptions, a reconnect state machine with full-jitter backoff, and catch-up that completes before consumers are told the connection is usable.
• A CLI (dart run ahp_sdk:ahp --url …), verified against VS Code 1.131.0's agent host.