summaryrefslogtreecommitdiff
path: root/src/detached/wire.zig
diff options
context:
space:
mode:
authorGabriel Schneider <[email protected]>2026-10-30 17:54:43 -0300
committerGabriel Schneider <[email protected]>2026-10-30 20:25:56 -0300
commit494aeadc46212766b3d7869a2ed8b811ac490ffa (patch)
treeb3a00bf03f741415c1dd39a5eb7ba4f070152d14 /src/detached/wire.zig
parent58c230e73ab64e7b015a95462bde554c6b25df79 (diff)
downloadpardes-494aeadc46212766b3d7869a2ed8b811ac490ffa.tar.gz
pardes-494aeadc46212766b3d7869a2ed8b811ac490ffa.zip
replica: an input's time is its client's: it is sent stamped with the client's guess of the session's clocks (wire 18's `stamp`), the guess its speculation records, and the authority's step reads that, not its own clocks (within a second of them, else its own), so a step's clock read never mispredicts: an edit's second across a turn, a message's millisecond (Ctrl-W's, a jump's) were each a rollback (fixer 1: 4 seen in 2 minutes), and every reapply of one now reads the same time
Co-Authored-By: Claude Opus 5.5 <[email protected]>
Diffstat (limited to 'src/detached/wire.zig')
-rw-r--r--src/detached/wire.zig15
1 files changed, 13 insertions, 2 deletions
diff --git a/src/detached/wire.zig b/src/detached/wire.zig
index a809bebd..6090dedb 100644
--- a/src/detached/wire.zig
+++ b/src/detached/wire.zig
@@ -9,6 +9,8 @@ const builtin = @import("builtin");
const pardes = @import("../pardes.zig");
const config = @import("pardes_config");
+/// 18: a replica's input is stamped with its guess of the session's
+/// clocks, the time its step reads (phase 6's instant interaction notes);
/// 17: a pointer's hit carries the place it was made on (Layer.Place) and
/// a tag hit its line, which the step resolves it by, not by its frame;
/// 16: a far client says so, the session sends it its blobs' hashes before
@@ -20,7 +22,7 @@ const config = @import("pardes_config");
/// part B); 14: the hello names a session and
/// carries the semantics hash, and a ping is answered (phase 5's
/// groundwork); 13: the frames went (phase 3).
-pub const version: u16 = 17;
+pub const version: u16 = 18;
/// The terminal's build and the window's step alike (`semantics`).
const family = switch (config.platform) {
@@ -85,6 +87,10 @@ pub const ClientTag = enum(u8) {
far = 0x06,
/// The join's blobs a far client lacks, a bit each in `blobs` order.
want = 0x07,
+ /// The session's clocks (realtime and monotonic, ns) as the client
+ /// guessed them for the input that follows: its time, which the step
+ /// reads (src/replica.zig).
+ stamp = 0x08,
key = 0x10,
mouse = 0x11,
@@ -269,6 +275,7 @@ pub const ClientMsg = union(enum) {
check,
far: bool,
want: []const u8,
+ stamp: [2]i64,
event: pardes.Event,
};
@@ -497,6 +504,7 @@ pub fn encodeClient(out: []u8, msg: ClientMsg) Error![]const u8 {
.screen_ack, .want => |bytes| try w.writeAll(bytes),
.check => {},
.far => |far| try w.writeByte(@intFromBool(far)),
+ .stamp => |s| for (s) |v| try w.writeInt(i64, v, .little),
.event => |ev| switch (ev) {
.key => |k| {
try w.writeInt(u32, k.cp, .little);
@@ -572,6 +580,7 @@ pub fn decodeClient(tag: u8, payload: []const u8) Error!ClientMsg {
.check => .check,
.far => .{ .far = try getBool(&r) },
.want => return .{ .want = payload },
+ .stamp => .{ .stamp = .{ try r.takeInt(i64, .little), try r.takeInt(i64, .little) } },
.key => blk: {
const cp = try r.takeInt(u32, .little);
// `Key.cp` is a u21, and the specials live in the private-use
@@ -633,7 +642,7 @@ const msg_slack = header_len + 64;
pub fn clientBound(msg: ClientMsg) usize {
return msg_slack + switch (msg) {
.hello => |h| h.session.len,
- .bye, .ping, .check, .far => 0,
+ .bye, .ping, .check, .far, .stamp => 0,
.screen_ack, .want => |bytes| bytes.len,
.event => |ev| switch (ev) {
// Its hits' places (14 bytes each) past the slack.
@@ -775,6 +784,8 @@ test "detached wire: a session is never told to do a frontend's remembering" {
"hello", "bye", "ping", "screen_ack", "check",
// ...and how far it is, and which of the join's blobs it lacks.
"far", "want",
+ // ...and when its next input was, by the session's clocks.
+ "stamp",
// ...and everything a person can do to a window.
"key", "mouse", "resize",
"paste", "command", "pdf_scroll", "pinch", "touch_scroll",