diff --git a/docs/tools/matrix.md b/docs/tools/matrix.md index d3fc1efe..8d39c7ed 100644 --- a/docs/tools/matrix.md +++ b/docs/tools/matrix.md @@ -84,6 +84,10 @@ Requires `hyperhive.matrix.enable = true`. Every matrix tool above takes an optional `account` parameter (a name from this map) to act as that identity instead of the primary one. +Declaring an extra account also changes what the agent *receives*: wake +bodies and invite todos gain an `[acct:]` prefix — see +[Architecture](#architecture) below. + ## Architecture `hive-matrix-daemon` is a single long-running process (one per agent @@ -110,6 +114,13 @@ Incoming room events wake the agent via `AgentRequest::Wake` with bulleted list (`- : : ` or `- : N unread` per room) +**Multi-account prefix**: when the daemon serves more than one account +(`hyperhive.matrixAccounts`), it prefixes every wake body and every invite todo +below with `[acct:] `, so a wake arrives as +`[acct:ccc] [matrix] in : …`. A single-account agent gets the +formats exactly as written — the daemon adds nothing — which is why matching +on a leading `[matrix]` works right up until you declare a second account. + hive-matrix-daemon includes the same per-room breakdown in the `UnreadMatrix` entry `get_loose_ends` returns, so unread rooms surface in the loose-ends list between turns.