From 19a09c865eaecd0f42f21945d69717747220d0c2 Mon Sep 17 00:00:00 2001 From: iris Date: Fri, 5 Jun 2026 16:44:03 +0200 Subject: [PATCH] docs(tools/matrix): document auto-accept invites and pending-invite loose ends --- docs/tools/matrix.md | 14 ++++++++++++++ 1 file changed, 14 insertions(+) diff --git a/docs/tools/matrix.md b/docs/tools/matrix.md index 818e2bdb..06f25486 100644 --- a/docs/tools/matrix.md +++ b/docs/tools/matrix.md @@ -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: — 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.