OpenPrinter Agent Gateway
Agent sends hello
This is the first application message on every authenticated connection.
The agentId must match the identity proven during authentication. A
server selects one shared protocol version in server.hello.
Address
/.well-known/openprinter/gatewayDescription
The authenticated, bidirectional OPPA gateway socket.
Messages
The first application message on every authenticated connection. It identifies the running product and advertises the protocol versions the agent can speak.
Payload
Message Example
{ "protocolVersion": "1", "messageId": "message_hello_01", "sentAt": "2026-08-21T00:00:01Z", "type": "agent.hello", "payload": { "agentId": "agent_01", "agentVersion": "0.1.0", "productId": "oppa", "productVersion": "0.1.0", "supportedProtocolVersions": [ "1" ] }}