spec/v0.2.0
microsoft/agent-host-protocolspec/v0.2.0May 28, 2026by github-actions[bot]
Upgrading?
Release notes summary
First unified spec release introducing channel reorganization, resource management, and telemetry notifications.
Key Highlights
- Channel reorganization with top-level `channel` URI.
- New `otlp/*` notifications for telemetry export.
- New `resourceResolve` and `resourceMkdir` requests.
- Extended `resourceWrite` with `mode`, `position`, and `ifMatch` for concurrency.
New Features
- `session/agentChanged` action.
- `createResourceWatch` request and `ahp-resource-watch:` channel.
- `resourceWrite` modes (truncate, append, insert).
- `UserMessage._meta` field for provider metadata.
Full Release Notes
## [0.2.0] — 2026-05-28 Spec version: `0.2.0` This is the first version released through the unified spec release pipeline (`spec/v*` git tags → GitHub Release with attached schema artifacts). Changes to the protocol shape that landed under this version are tracked in the commits between `spec/v0.1.0` (not yet tagged) and `spec/v0.2.0`. Highlights: - Channels reorganization — every command and notification carries a top-level `channel: URI`; per-channel state types and action unions live under `types/channels-*/` (see PR #97 and PR #152). - New `otlp/*` notifications for telemetry export (`exportLogs` / `exportTraces` / `exportMetrics`). - New `session/agentChanged`, `session/customizationRemoved`, `session/changesetsChanged`, and the `changeset/*` action family. - Customizations redesigned as a typed two-level tree. - New `resourceResolve` (stat + realpath; throws `NotFound` for the existence check) and `resourceMkdir` (`mkdir -p` semantics) requests. - New `createResourceWatch` request plus the `ahp-resource-watch:/<id>` channel with the `resourceWatch/changed` action — long-lived file-change streams over the standard subscription mechanism. - `resourceWrite` extended with `mode` (`truncate` | `append` | `insert`), `position`, and `ifMatch` for optimistic concurrency. New `Conflict` (`-32011`) error code for stale `ifMatch` writes. - The entire content-bearing `resource*` family is now formally bidirectional — the methods appear in `ServerCommandMap` and may be initiated by either peer (matches VS Code's existing implementation). - `UserMessage._meta` optional `Record<string, unknown>` field for provider-specific message metadata, mirroring the MCP `_meta` convention already used on `MessageAttachmentBase`, `ToolDefinition`, `ToolCallBase`, `UsageInfo`, and `SessionState`.
Related Repositories
openclaw/openclaw★ 392,881
The AI that really does things. Any OS. Any Platform. The lobster way. 🦞
morluto/rea★ 372,857
Reverse engineer anything with agents, from app behavior down to native binaries.
nilbuild/developer-roadmap★ 370,230
Interactive roadmaps, guides and other educational content to help developers grow in their careers.
anomalyco/opencode★ 220,594
The open source coding agent.
n8n-io/n8n★ 208,408
Fair-code workflow automation platform with native AI capabilities. Combine visual building with custom code, self-host or cloud, 400+ integrations.