openclaw/extensions/matrix/src
Bronko d4a960fcca
fix(matrix): restore robust DM routing without the memberCount heuristic (#19736)
* fix(matrix): remove memberCount heuristic from DM detection

The memberCount === 2 check in isDirectMessage() misclassifies 2-person
group rooms (admin channels, monitoring rooms) as DMs, routing them to
the main session instead of their room-specific session.

Matrix already distinguishes DMs from groups at the protocol level via
m.direct account data and is_direct member state flags. Both are already
checked by client.dms.isDm() and hasDirectFlag(). The memberCount
heuristic only adds false positives for 2-person groups.

Move resolveMemberCount() below the protocol-level checks so it is only
reached for rooms not matched by m.direct or is_direct. This narrows its
role to diagnostic logging for confirmed group rooms.

Refs: #19739

* fix(matrix): add conservative fallback for broken DM flags

Some homeservers (notably Continuwuity) have broken m.direct account
data or never set is_direct on invite events. With the memberCount
heuristic removed, these DMs are no longer detected.

Add a conservative fallback that requires two signals before classifying
as DM: memberCount === 2 AND no explicit m.room.name. Group rooms almost
always have explicit names; DMs almost never do.

Error handling distinguishes M_NOT_FOUND (missing state event, expected
for unnamed rooms) from network/auth errors. Non-404 errors fall through
to group classification rather than guessing.

This is independently revertable — removing this commit restores pure
protocol-based detection without any heuristic fallback.

* fix(matrix): add parentPeer for DM room binding support

Add parentPeer to DM routes so conversations are bindable by room ID
while preserving DM trust semantics (secure 1:1, no group restrictions).

Suggested by @KirillShchetinin.

* fix(matrix): override DM detection for explicitly configured rooms

Builds on @robertcorreiro's config-driven approach from #9106.

Move resolveMatrixRoomConfig() before the DM check. If a room matches
a non-wildcard config entry (matchSource === "direct") and was
classified as DM, override the classification to group. This gives users
a deterministic escape hatch for misclassified rooms.

Wildcards are excluded from the override to avoid breaking DM routing
when a "*" catch-all exists. roomConfig is gated behind isRoom so DMs
never inherit group settings (skills, systemPrompt, autoReply).

This commit is independently droppable if the scope is too broad.

* test(matrix): add DM detection and config override tests

- 15 unit tests for direct.ts: all detection paths, priority order,
  M_NOT_FOUND vs network error handling, edge cases (whitespace names,
  API failures)
- 8 unit tests for rooms.ts: matchSource classification, wildcard
  safety for DM override, direct match priority over wildcard

* Changelog: note matrix DM routing follow-up

* fix(matrix): preserve DM fallback and room bindings

---------

Co-authored-by: Tak Hoffman <781889+Takhoffman@users.noreply.github.com>
2026-03-08 23:26:48 -05:00
..
matrix fix(matrix): restore robust DM routing without the memberCount heuristic (#19736) 2026-03-08 23:26:48 -05:00
actions.ts Plugins/matrix: migrate to scoped plugin-sdk imports 2026-03-04 02:35:12 -05:00
channel.directory.test.ts Plugins/matrix: migrate to scoped plugin-sdk imports 2026-03-04 02:35:12 -05:00
channel.ts Matrix: use scoped plugin SDK channel imports 2026-03-07 16:26:59 -08:00
config-schema.test.ts feat(secrets): expand SecretRef coverage across user-supplied credentials (#29580) 2026-03-03 02:58:20 +00:00
config-schema.ts Plugins/matrix: migrate to scoped plugin-sdk imports 2026-03-04 02:35:12 -05:00
directory-live.test.ts fix(matrix): land #31201 preserve room ID casing (@williamos-dev) 2026-03-02 03:09:23 +00:00
directory-live.ts Plugins/matrix: migrate to scoped plugin-sdk imports 2026-03-04 02:35:12 -05:00
group-mentions.ts Plugins/matrix: migrate to scoped plugin-sdk imports 2026-03-04 02:35:12 -05:00
onboarding.ts refactor: unify onboarding secret-input prompt state wiring 2026-03-07 23:27:51 +00:00
outbound.test.ts Plugins/matrix: migrate to scoped plugin-sdk imports 2026-03-04 02:35:12 -05:00
outbound.ts Plugins/matrix: migrate to scoped plugin-sdk imports 2026-03-04 02:35:12 -05:00
resolve-targets.test.ts Plugins/matrix: migrate to scoped plugin-sdk imports 2026-03-04 02:35:12 -05:00
resolve-targets.ts Matrix: use scoped plugin SDK resolve-target imports 2026-03-07 16:26:59 -08:00
runtime.ts refactor: harden browser runtime profile handling 2026-03-09 00:25:43 +00:00
secret-input.ts refactor(extensions): share secret input schema builder 2026-03-07 17:05:23 +00:00
tool-actions.ts Plugins/matrix: migrate to scoped plugin-sdk imports 2026-03-04 02:35:12 -05:00
types.ts Plugins/matrix: migrate to scoped plugin-sdk imports 2026-03-04 02:35:12 -05:00