OpenPrinterOpenPrinter Agent Gateway
Server sends a print job
The server sends a queued job after the session is ready. Delivery is
at-least-once: a transport retry can deliver the same job again, so the
agent must deduplicate using jobId and idempotencyKey before sending
agent.job_received.
Address
/.well-known/openprinter/gatewayDescription
The authenticated, bidirectional OPPA gateway socket.
Messages
An at-least-once delivery of a structured print job. The agent stores the complete payload before acknowledging it and uses the job identity to make redelivery safe.
Payload
Message Example
{ "protocolVersion": "1", "messageId": "job_delivery_01", "sentAt": "2026-08-21T00:00:05Z", "type": "server.print_job", "payload": { "jobId": "job_01", "idempotencyKey": "order_123_receipt_v1", "printerId": "printer_01", "createdAt": "2026-08-21T00:00:00Z", "document": { "width": 80, "sections": [ { "type": "text", "value": "Order 123", "align": "center", "bold": true }, { "type": "divider" }, { "type": "row", "left": "Coffee", "right": "$4.00" }, { "type": "feed", "lines": 2 }, { "type": "cut" } ] }, "metadata": { "source": "checkout", "orderId": "order_123" } }}