spec/v0.8.0
microsoft/agent-host-protocolspec/v0.8.0Aug 18, 2026by github-actions[bot]
Upgrading?
AI Summary
The AHP specification is updated to version 0.8.0, defining metadata support and working directory replacement logic.
Key Highlights
- Optional `_meta` request metadata on all command parameters
- Reserved `x-` prefix for custom channel URI schemes
- Atomic `session/workingDirectoryReplaced` action
- Fixed typo: `ResourceReponsePart` to `ResourceResponsePart`
New Features
- Client plugin customization with child enablement decisions
- Scoped host-published provenance for enablement
- Protected resource metadata in auth requirements
- Legacy client compatibility for working directory replacements
Full Release Notes
## [0.8.0] — 2026-08-17 Spec version: `0.8.0` ### Added - Optional `_meta` request metadata on all command parameters. - `ClientPluginCustomization` can publish child enablement decisions. - Reserve the `x-` prefix for implementation-defined channel URI schemes, commands, notifications, and actions. (#367) - `session/workingDirectoryReplaced` atomically replaces a working-directory entry, including a replaceable primary. (#392) ### Changed - Renamed `ResourceReponsePart` to `ResourceResponsePart`, correcting a misspelling. The Rust and Go clients already exposed the corrected name via generator-level renames; the TypeScript, Kotlin and Swift clients previously carried the typo, so the type now has one consistent name across all five clients. - `SessionState.inputNeeded` entries of kind `toolClientExecution` no longer raise `SessionStatus.InputNeeded`. Such an entry is work delegated to a client, not a user prompt, so a session stays `InProgress` while a client tool runs. - `Customization` enablement now carries scoped host-published provenance, and `session/customizationToggled` replaces its complete decision set. - `auth/required` now carries complete `ProtectedResourceMetadata` in its required `resource` field. ### Fixed - `session/workingDirectoryReplaced` retains an earlier duplicate replacement so a later replacement cannot move a protected primary, and `primaryReplacement` may accompany `immutablePrimary` for safe legacy-client compatibility.
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.