raidian 1.0.0

Shared protobuf definitions for YuXu DevOps platform - used by server, CLI, and editor integrations (Zed, Logos)
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58

syntax = "proto3";
package raidian;

// Real-time collaboration messages (yrs/CRDT over WebSocket).
// Protocol: binary WebSocket frames with 1-byte type prefix.
// Types: Join(0x01), JoinAck(0x02), SyncUpdate(0x03), Awareness(0x04),
//        ParticipantJoined(0x05), ParticipantLeft(0x06)
//
// Compatible with Logos IDE and Zed editor integrations.

message CollabJoinRequest {
  string repository_id = 1;
  string file_path = 2;
  optional string token = 3;  // JWT, optional for unauthenticated clients (e.g. Zed without auth)
}

message CollabJoinResponse {
  string session_id = 1;
  bytes initial_state = 2;    // Y.Doc encoded state vector
  repeated CollabParticipant participants = 3;
}

message CollabParticipant {
  string user_id = 1;
  string display_name = 2;
  string avatar_url = 3;
}

message CollabUpdate {
  string session_id = 1;
  bytes update = 2;           // yrs update payload
}

message CollabAwareness {
  string session_id = 1;
  string user_id = 2;
  bytes awareness_state = 3;  // cursor position, selection, etc.
}

message CollabParticipantJoined {
  CollabParticipant participant = 1;
}

message CollabParticipantLeft {
  string user_id = 1;
}

message CollabSessionInfo {
  string session_id = 1;
  string repository_id = 2;
  string file_path = 3;
  repeated CollabParticipant participants = 4;
  int64 created_at = 5;
}

message ListCollabSessionsResponse {
  repeated CollabSessionInfo sessions = 1;
}