OpenPrinter Agent Gateway
Server disconnects
The server sends this frame before an intentional close. reconnect
states whether the agent should reconnect, while retryAfterMs can
provide a lower-bound delay for the next attempt.
Address
/.well-known/openprinter/gatewayDescription
The authenticated, bidirectional OPPA gateway socket.
Messages
A final application frame before an intentional server close. The reconnect flag and optional delay give the agent the host's reconnect policy without exposing implementation details.
Payload
Message Example
{ "protocolVersion": "1", "messageId": "disconnect_01", "sentAt": "2026-08-21T00:03:00Z", "type": "server.disconnect", "payload": { "code": "server_maintenance", "reason": "The gateway is restarting for maintenance.", "reconnect": true, "retryAfterMs": 5000 }}