spec/v0.9.0
microsoft/agent-host-protocolspec/v0.9.0Aug 28, 2026by github-actions[bot]
Upgrading?
AI Summary
The AHP specification is updated to version 0.9.0, defining the new automation catalogue and durable error handling mechanisms.
Key Highlights
- Automation catalogue and automation-run channels
- Durable turn errors and resumable sessions
- Extension capabilities in initialize responses
- Annotations carry `origin` metadata
Breaking Changes
- Renamed failed session lifecycle value from `creationFailed` to `failed`
- Removed `error` from `changeset/contentChanged`
- Removed session-level forking from `createSession`
- Removed `ContentNotFound` as an exported AHP error code
New Features
- Shared trigger-based agent session workflows
- Host-defined event triggers
- Turn error durability
- Metadata extensions in annotations
Full Release Notes
## [0.9.0] — 2026-08-28 Spec version: `0.9.0` ### Added - Automation catalogue and automation-run channels, including self-contained host-defined event triggers and automation-origin messages, for shared trigger-based agent session workflows. - Turn errors are durable response parts, and resumable errors can reopen the same turn through `chat/turnResume`. - `InitializeResult._meta` for hosts to advertise implementation-specific extension capabilities in initialize responses. ### Changed - Annotations now carry an `origin` with a required session URI and optional chat URI and turn ID. - Renamed the failed session lifecycle value from `creationFailed` to `failed`. - `TerminalSessionClaim` now requires the chat URI that owns the terminal. - Terminal state now uses an explicit `running`/`exited` lifecycle that preserves exits without an exit code. - Generated clients now preserve unknown values for nonexhaustive protocol enums and their discriminated unions. - `SessionToolClientExecutionRequest.toolCall` is narrowed to a running tool-call state. - Automation catalogue snapshots now use `AutomationState.entries`, whose items are named `AutomationEntry`. ### Removed - Removed `error` from `changeset/contentChanged`; changeset failures are represented by `changeset/statusChanged`. - Removed session-level forking from `createSession`; use chat forking instead. - `ContentNotFound` is no longer an exported AHP error code; `-32006` remains reserved and unassigned. ### Fixed - Chat reducers now derive `modifiedAt` from turn action data instead of local wall clocks.
Related Repositories
openclaw/openclaw★ 392,691
The AI that really does things. Any OS. Any Platform. The lobster way. 🦞
nilbuild/developer-roadmap★ 370,064
Interactive roadmaps, guides and other educational content to help developers grow in their careers.
morluto/rea★ 357,526
Reverse engineer anything with agents, from app behavior down to native binaries.
anomalyco/opencode★ 219,654
The open source coding agent.
n8n-io/n8n★ 208,248
Fair-code workflow automation platform with native AI capabilities. Combine visual building with custom code, self-host or cloud, 400+ integrations.