v1.0.0
microsoft/agent-host-protocolv1.0.0Oct 2, 2026by github-actions[bot]
Upgrading?
AI Summary
This release implements AHP 1.0.0, introducing lightweight chat navigation, enhanced automation rules, and robust changeset management. It also adds support for background work, canvas channels, and atomic chat transfers.
Key Highlights
- Lightweight chat navigation via `SessionSummary.chats` and `SessionChatSummary.status` for browsing without subscriptions.
- Enhanced automation with `AutomationDefinition.disableConditions` supporting complex OR logic rules and client plugins.
- Comprehensive changeset management via `ChatState.changesets` and status flags like `Recomputing`.
- Atomic `moveChat` transfer for host-authorized chats and exposure of background work within chat state.
Breaking Changes
- `FileEdit` and preview `edits` now use named models in generated SDKs, which breaks affected SDK APIs (though JSON shapes remain unchanged).
- Historical `ToolResultTerminalContent.resource` subscriptions now return lazily reconstructed exited terminal state with retained output.
New Features
- OAuth token lifetime tracking via `AuthenticateParams.expiresIn`.
- Independent chat archiving and read status tracking via `chat/isArchivedChanged` and `chat/isReadChanged`.
- Array cardinality validation for config properties via `ConfigPropertySchema.minItems` and `maxItems`.
- MCP server background processing control via `McpServerStartingState.blocking`.
- Aggregate file-change counts via `ChatSummary.changes` and `ChatState.changes`.
- Host-authorized atomic chat transfer via `moveChat`.
- Canvas channel reference advertising and synchronization capabilities.
Full Release Notes
## [1.0.0] — 2026-10-02 Implements AHP 1.0.0. ### Added - `AuthenticateParams.expiresIn` carries an OAuth access token's remaining lifetime in seconds. - `SessionSummary.chats`, `SessionChatSummary.interactivity`, and `SessionSummary.defaultChat` expose lightweight chat navigation data without requiring a session subscription. - `chat/isArchivedChanged` action for archiving a chat independently of its session. - `ChatState.changesets` and `chat/changesetsChanged` expose each chat's changeset catalogue through the subscribed chat channel. - `AutomationDefinition.disableConditions` supports `afterRuns` (`max`) and `afterDate` (`date`) rules combined with logical OR, with at most one condition per kind. Host-owned `AutomationEntry.runCount` tracks the current scheduled-run allowance. Edit conditions through `automation/updateRequested`: omission leaves them unchanged, an array replaces them, and `[]` removes all conditions without re-enabling the automation. - `ChangesetStatus.Recomputing` distinguishes refreshes of a completed result from initial changeset computation. - `ConfigPropertySchema.minItems` and `ConfigPropertySchema.maxItems` express array cardinality for `type: "array"` config properties. (#432) - `McpServerStartingState.blocking` flag indicating that message processing may be held on the server, and the client-dispatchable `session/mcpServerBackgroundRequested` action asking the host to background such a startup. - `AutomationSessionTemplate.customizations` lets automations carry client plugins (skills, agents, prompts, rules) that the host captures when the definition is saved, with the host-owned copies reported in `AutomationEntry.customizations` and support advertised by `AutomationCapabilities.customizations`. - Hosts can advertise chat-owned canvas channel references and synchronize live presentation metadata and source URLs on experimental per-canvas channels. - Atomic stable-URI `moveChat` transfer and same-session ordering for host-authorized chats, with per-chat `movable` discovery and durable authoritative catalogs. - Expose chat-owned background work (background shells and subagents) in chat state, with `chat/backgroundWorkSet` and `chat/backgroundWorkRemoved` actions independent of turn lifetime. - `ChatSummary.changes` and `ChatState.changes` provide aggregate file-change counts without requiring a changeset subscription. - `SessionChatSummary.status` exposes per-chat archived state via `SessionStatus.IsArchived` in the lightweight chat catalog without requiring a session subscription. - `chat/isReadChanged` action and optional `SessionChatSummary.status` projection for independently tracking the status of any known chat, including the default chat; the status bitset replaces the unreleased `isRead` and `archived` catalog fields. - `SessionChatSummary.changes` exposes per-chat change counts in the lightweight chat catalog without requiring a session subscription. ### Changed - Historical `ToolResultTerminalContent.resource` subscriptions return lazily reconstructed exited terminal state with retained output. - `FileEdit` and preview `edits` now use named models in generated SDKs. This breaks affected SDK APIs but keeps JSON shapes unchanged. - Advertise only the 1.0.0 and 0.9.0 protocol compatibility baselines independently of the development version. Host-side negotiation helpers select the highest client-offered version within either caret-compatible range and report malformed offers explicitly.
Related Repositories
openclaw/openclaw★ 392,707
The AI that really does things. Any OS. Any Platform. The lobster way. 🦞
nilbuild/developer-roadmap★ 370,074
Interactive roadmaps, guides and other educational content to help developers grow in their careers.
morluto/rea★ 358,339
Reverse engineer anything with agents, from app behavior down to native binaries.
anomalyco/opencode★ 219,723
The open source coding agent.
n8n-io/n8n★ 208,261
Fair-code workflow automation platform with native AI capabilities. Combine visual building with custom code, self-host or cloud, 400+ integrations.