vinzenz/hyperhive
vinzenz/hyperhive
Watch
0
0
Fork
You've already forked hyperhive
 0
Code Issues Pull requests Projects Releases Packages Wiki Activity Actions

docs(tools/matrix): document auto-accept invites and pending-invite loose ends

Browse source
This commit is contained in:
iris 2026-06-05 16:44:03 +02:00 • committed by mara
commit 19a09c865e
1 changed files with 14 additions and 0 deletions
Download patch file Download diff file Expand all files Collapse all files

14
docs/tools/matrix.md
View file

@ -60,6 +60,20 @@ The same per-room breakdown is included in the `UnreadMatrix` entry
returned by `get_loose_ends` so unread rooms surface in the
loose-ends list between turns.
**Auto-accept invites**: when the daemon's sync loop receives an
`m.room.member` invite event for the agent's own user, it immediately
calls `join_room_by_id` and fires a wake so the agent learns about the
new room. This closes the gap where invites (e.g. the hive Matrix Space
created by hive-c0re on boot) would sit in the `invited_rooms()` list
indefinitely until the agent called `join_room` manually.
**Pending invites as loose ends**: any remaining pending invites (not
yet auto-accepted, e.g. delivered while the daemon was down) are written
to `mcp-loose-ends/matrix.json` and appear in `get_loose_ends` output
as `[matrix] pending invite: <room> — use list_invites to see,
join_room to accept`. The file is updated atomically after each invite
arrives or a room is joined.
See [`docs/matrix.md`](../matrix.md) for the homeserver setup,
provisioning flow, and federation config.