Messages Reference

Complete reference of all JSON-RPC methods in the Agent Host Protocol, organized by direction and type.

Client → Server Requests

These methods have an id and expect a response.

Method	Description	Reference
initialize	Handshake — establishes the connection and protocol version	Lifecycle
reconnect	Re-establishes a dropped connection with replay or snapshot	Lifecycle
subscribe	Subscribe to a URI-identified state resource	Subscriptions
createSession	Create a new agent session	Commands
disposeSession	Dispose a session and clean up resources	Commands
listSessions	Fetch session summaries	Commands
fetchTurns	Fetch historical turns for a session	Commands
resourceRead	Read content by URI	Commands
resourceWrite	Write content to a file on the server filesystem	Commands
resourceList	List directory entries on the server filesystem	Commands
resourceCopy	Copy a resource from one URI to another	Commands
resourceDelete	Delete a resource at a URI	Commands
resourceMove	Move a resource from one URI to another	Commands
resourceRequest	Request access to a resource (also Server → Client)	Commands

Client → Server Notifications

These methods have no id and expect no response.

Method	Description	Reference
unsubscribe	Stop receiving updates for a URI	Subscriptions
dispatchAction	Fire-and-forget action dispatch (write-ahead)	Actions

Server → Client Notifications

These are pushed by the server without a preceding request.

Method	Description	Reference
action	Delivers an ActionEnvelope to subscribed clients	Actions
notification	Ephemeral protocol notification (e.g. session added/removed)	Notifications

Version Introduction

All messages listed above were introduced in protocol version 1.