skip to content

detached 51db7d7

docs(agent): clarify wire framing location

commit: 51db7d7396ec6fa65a18643f3d8160901e59dd01
author: brice · 3mo ago · 2026-07-05 05:33 UTC
parent: a632506
signature: GPG VerifiedCD88F9E564E0102646FB6077A1A07C7C7C3E349D · arch-gpg Verified for the committer email

1 file · +2 -2

M AGENTS.md +2 -2


@@ -57,9 +57,9 @@ Before touching daemon teardown paths, read the lock-ordering notes at the top o
57	57
58	58		## Wire protocol
59	59
60		-	Wire code lives in `internal/ports/frame.go` and `internal/ports/wire.go`.
	60	+	Wire payload types/codecs live in `internal/ports/frame.go` and `internal/ports/wire.go`. Connection framing lives in `internal/adapters/ipc/transport.go`.
61	61
62		-	- Frames are 4-byte big-endian length, 1 type byte, then payload.
	62	+	- IPC frames on a connection are 4-byte big-endian length, 1 type byte, then payload.
63	63		- Client message types are `1–15`; server message types are `16+`.
64	64		- Version negotiation requires strict equality.
65	65		- `Hello.Version` must stay first so `PeekHelloVersion` works.


@@ -57,9 +57,9 @@ Before touching daemon teardown paths, read the lock-ordering notes at the top o
57			57
58		## Wire protocol	58		## Wire protocol
59			59
60	-	Wire code lives in `internal/ports/frame.go` and `internal/ports/wire.go`.	60	+	Wire payload types/codecs live in `internal/ports/frame.go` and `internal/ports/wire.go`. Connection framing lives in `internal/adapters/ipc/transport.go`.
61			61
62	-	- Frames are 4-byte big-endian length, 1 type byte, then payload.	62	+	- IPC frames on a connection are 4-byte big-endian length, 1 type byte, then payload.
63		- Client message types are `1–15`; server message types are `16+`.	63		- Client message types are `1–15`; server message types are `16+`.
64		- Version negotiation requires strict equality.	64		- Version negotiation requires strict equality.
65		- `Hello.Version` must stay first so `PeekHelloVersion` works.	65		- `Hello.Version` must stay first so `PeekHelloVersion` works.