ControlProtocol(feat): Add MESSAGE and CONFIG_ERROR notification types

tony · tony · commit 45298f16f4b4 · 2025-12-06T11:53:32.000-06:00
why: Complete coverage of all tmux control mode notification types
per analysis of tmux source code (control-notify.c, cfg.c).
what:
- Add MESSAGE and CONFIG_ERROR to NotificationKind enum
- Parse %message notifications (from display-message command)
- Parse %config-error notifications (from config file errors)
- Add test fixtures for both notification types
diff --git a/src/libtmux/_internal/engines/base.py b/src/libtmux/_internal/engines/base.py
@@ -99,6 +99,8 @@ class NotificationKind(enum.Enum):
     CONTINUE = enum.auto()
     SUBSCRIPTION_CHANGED = enum.auto()
     EXIT = enum.auto()
+    MESSAGE = enum.auto()
+    CONFIG_ERROR = enum.auto()
     RAW = enum.auto()
 
 
diff --git a/src/libtmux/_internal/engines/control_protocol.py b/src/libtmux/_internal/engines/control_protocol.py
@@ -155,6 +155,12 @@ def _parse_notification(line: str, parts: list[str]) -> Notification:
         data = {"name": parts[1], "type": parts[2], "value": " ".join(parts[3:])}
     elif tag == "%exit":
         kind = NotificationKind.EXIT
+    elif tag == "%message" and len(parts) >= 2:
+        kind = NotificationKind.MESSAGE
+        data = {"text": " ".join(parts[1:])}
+    elif tag == "%config-error" and len(parts) >= 2:
+        kind = NotificationKind.CONFIG_ERROR
+        data = {"error": " ".join(parts[1:])}
 
     return Notification(kind=kind, when=now, raw=line, data=data)
 
diff --git a/tests/test_engine_protocol.py b/tests/test_engine_protocol.py
@@ -191,6 +191,18 @@ def test_control_protocol_skips_unexpected_begin() -> None:
         expected_kind=NotificationKind.PASTE_BUFFER_DELETED,
         expected_subset={"name": "buf1"},
     ),
+    NotificationFixture(
+        test_id="message",
+        line="%message Hello world from tmux",
+        expected_kind=NotificationKind.MESSAGE,
+        expected_subset={"text": "Hello world from tmux"},
+    ),
+    NotificationFixture(
+        test_id="config_error",
+        line="%config-error /home/user/.tmux.conf:10: unknown option",
+        expected_kind=NotificationKind.CONFIG_ERROR,
+        expected_subset={"error": "/home/user/.tmux.conf:10: unknown option"},
+    ),
 ]
 
 
