Define archive control v1 protocol

2026-07-22 11:59:57 +00:00
commit 7652262b4c
25 changed files with 1333 additions and 0 deletions
@@ -0,0 +1,33 @@
+syntax = "proto3";
+
+package archive_control.v1;
+
+import "archive_control/v1/client.proto";
+import "archive_control/v1/common.proto";
+import "archive_control/v1/control.proto";
+import "archive_control/v1/inventory.proto";
+import "google/protobuf/timestamp.proto";
+
+// Envelope is the only top-level WebSocket application message. UUID fields
+// use lowercase canonical UUID text. correlation_id links a response/event to
+// the initiating envelope when applicable.
+message Envelope {
+  ProtocolVersion protocol_version = 1;
+  string message_id = 2;
+  string correlation_id = 3;
+  google.protobuf.Timestamp sent_at = 4;
+  oneof payload {
+    RegisterRequest register_request = 10;
+    RegisterResponse register_response = 11;
+    Heartbeat heartbeat = 12;
+    HeartbeatAck heartbeat_ack = 13;
+    Command command = 14;
+    CommandAck command_ack = 15;
+    InventoryChunk inventory_chunk = 16;
+    JobEvent job_event = 17;
+    JobSnapshot job_snapshot = 18;
+    ClientStateSnapshot client_state_snapshot = 19;
+    RouteUpdate route_update = 20;
+    ProtocolError protocol_error = 21;
+  }
+}