From d16ba9c5d9eac8ef2228261bdacc7feb4ae4fe1e Mon Sep 17 00:00:00 2001
From: Travis Ralston <travisr@matrix.org>
Date: Thu, 12 Jan 2023 21:53:25 -0700
Subject: [PATCH 1/2] Extensible Events - Automated event mixin (notices)

---
 ...3955-extensible-events-bot-notice-mixin.md | 61 +++++++++++++++++++
 1 file changed, 61 insertions(+)
 create mode 100644 proposals/3955-extensible-events-bot-notice-mixin.md

diff --git a/proposals/3955-extensible-events-bot-notice-mixin.md b/proposals/3955-extensible-events-bot-notice-mixin.md
new file mode 100644
index 00000000000..115a03f3d43
--- /dev/null
+++ b/proposals/3955-extensible-events-bot-notice-mixin.md
@@ -0,0 +1,61 @@
+# MSC3955: Extensible Events - Automated event mixin (notices)
+
+[MSC1767](https://github.com/matrix-org/matrix-doc/pull/1767) describes Extensible Events in detail,
+though deliberately does not include schemas for some messaging types. This MSC covers a replacement
+for the `m.notice` `msgtype` specifically.
+
+*Rationale*: Splitting the MSCs down into individual parts makes it easier to implement and review in
+stages without blocking other pieces of the overall idea. For example, an issue with the way notices
+are represented should not block the overall schema from going through.
+
+## Proposal
+
+As mentioned in MSC1767, it is desirable to represent more than just text events as "automated" or
+sent by a bot. Currently, [`m.notice`](https://spec.matrix.org/v1.5/client-server-api/#mnotice) is
+defined only as a `msgtype` on `m.room.message` events, thus only allowing bots (and other automated
+clients) to send plain text. To open this functionality up to any event, we define an `m.automated`
+*mixin* content block that can be applied to any event:
+
+```json5
+{
+    // irrelevant fields not shown
+    "type": "m.emote",
+    "content": {
+        "m.markup": [{"body": "says hi"}],
+        "m.automated": true
+    }
+}
+```
+
+`m.automated`'s value is a boolean, defaulting to `false` when not present, to denote if an event is
+automated. Note that other value types should be treated as `false` (ie: not present).
+
+When an event is flagged as automated, the client should render that event differently compared to
+normal. For example, reducing the opacity of the event.
+
+If the client does not believe there is a material difference between automated and non-automated for
+a particular event type, it is not required to render the event differently. Such an example might be
+a poll: the practical difference from a user perspective of a bot sending a poll versus a user isn't
+generally important, and so the client may decide to forgo opacifying the event. This is also the
+default behaviour if the client does not understand the mixin: the event will be rendered normally,
+with the client ultimately ignoring the `m.automated` mixin.
+
+## Potential issues
+
+No significant issues known.
+
+## Alternatives
+
+No significant alternatives known.
+
+## Security considerations
+
+No specific considerations are required for this proposal.
+
+## Unstable prefix
+
+While this MSC is not considered stable, implementations should use `org.matrix.msc1767.*` as a prefix in
+place of `m.*` throughout this proposal. Note that this uses the namespace of the parent MSC rather than
+the namespace of this MSC - this is deliberate.
+
+Note that extensible events should only be used in an appropriate room version as well.

From 4a3e7091b244e7e1adfb0a731e42ce7a9447a464 Mon Sep 17 00:00:00 2001
From: Travis Ralston <travisr@matrix.org>
Date: Tue, 18 Apr 2023 14:29:54 -0600
Subject: [PATCH 2/2] Update for MSC1767

---
 proposals/3955-extensible-events-bot-notice-mixin.md | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/proposals/3955-extensible-events-bot-notice-mixin.md b/proposals/3955-extensible-events-bot-notice-mixin.md
index 115a03f3d43..bab05deab47 100644
--- a/proposals/3955-extensible-events-bot-notice-mixin.md
+++ b/proposals/3955-extensible-events-bot-notice-mixin.md
@@ -21,7 +21,7 @@ clients) to send plain text. To open this functionality up to any event, we defi
     // irrelevant fields not shown
     "type": "m.emote",
     "content": {
-        "m.markup": [{"body": "says hi"}],
+        "m.text": [{"body": "says hi"}],
         "m.automated": true
     }
 }