spec/v0.9.0
siteboon/claudecodeuispec/v0.9.0Aug 28, 2026by github-actions[bot]
Upgrading?
AI Summary
Specification version 0.9.0 defining the core AHP protocol changes including automation, error handling, and session lifecycles.
Key Highlights
- Protocol definitions for automation catalogue and run channels
- Durable error response parts for turns
- Metadata extensions for host capabilities
- Annotation origin requirements
- Terminal state lifecycle definitions
Breaking Changes
- Renamed `failed` session lifecycle
- Removed session-level forking
- Removed `error` from `changeset/contentChanged`
New Features
- Protocol enums preserve unknown values
- Self-contained host-defined event triggers
- Resumable error handling mechanism
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,696
The AI that really does things. Any OS. Any Platform. The lobster way. 🦞
nilbuild/developer-roadmap★ 370,067
Interactive roadmaps, guides and other educational content to help developers grow in their careers.
morluto/rea★ 357,700
Reverse engineer anything with agents, from app behavior down to native binaries.
anomalyco/opencode★ 219,670
The open source coding agent.
n8n-io/n8n★ 208,251
Fair-code workflow automation platform with native AI capabilities. Combine visual building with custom code, self-host or cloud, 400+ integrations.