From 93dd4e5c7ca78c4e645b6f58b9770372f2d4d27f Mon Sep 17 00:00:00 2001
From: David Baker <dave@matrix.org>
Date: Wed, 3 May 2023 16:17:10 +0100
Subject: [PATCH] Add m.call.select_answer

---
 .../examples/m.call.select_answer.yaml        | 10 ++++++
 .../schema/m.call.select_answer.yaml          | 35 +++++++++++++++++++
 2 files changed, 45 insertions(+)
 create mode 100644 data/event-schemas/examples/m.call.select_answer.yaml
 create mode 100644 data/event-schemas/schema/m.call.select_answer.yaml

diff --git a/data/event-schemas/examples/m.call.select_answer.yaml b/data/event-schemas/examples/m.call.select_answer.yaml
new file mode 100644
index 00000000..fbd6ad16
--- /dev/null
+++ b/data/event-schemas/examples/m.call.select_answer.yaml
@@ -0,0 +1,10 @@
+{
+  "$ref": "core/room_event.json",
+  "type": "m.call.select_answer",
+  "content": {
+    "version" : "1",
+    "call_id": "12345",
+    "party_id": "67890",
+    "selected_party_id": "111213"
+  }
+}
diff --git a/data/event-schemas/schema/m.call.select_answer.yaml b/data/event-schemas/schema/m.call.select_answer.yaml
new file mode 100644
index 00000000..88f32f1e
--- /dev/null
+++ b/data/event-schemas/schema/m.call.select_answer.yaml
@@ -0,0 +1,35 @@
+{
+    "type": "object",
+    "description": "This event is sent by the caller's client once it has decided which other client to talk to, by selecting one of multiple possible incoming `m.call.answer` events. Its `selected_party_id` field indicates the answer it's chosen. The `call_id` and `party_id` of the caller is also included. If the callee's client sees a `select_answer` for an answer with party ID other than the one it sent, it ends the call and informs the user the call was answered elsewhere. It does not send any events. Media can start flowing before this event is seen or even sent.  Clients that implement previous versions of this specification will ignore this event and behave as they did before.",
+    "allOf": [{
+        "$ref": "core-event-schema/room_event.yaml"
+    }],
+    "properties": {
+        "content": {
+            "type": "object",
+            "properties": {
+                "call_id": {
+                    "type": "string",
+                    "description": "The ID of the call this event relates to."
+                },
+                "version": {
+                    "type": "integer",
+                    "description": "The version of the VoIP specification this message adheres to. This specification is version 1. This field is a string such that experimental implementations can use non-integer versions. This field was an integer in the previous spec version and implementations must accept an integer 0."
+                },
+                "party_id": {
+                    "type": "string",
+                    "description": "This identifies the party that sent this event. A client may choose to re-use the device ID from end-to-end cryptography for the value of this field. "
+                },
+                "selected_party_id": {
+                    "type": "string",
+                    "description": "The `party_id` field from the answer event that the caller chose."
+                },
+            },
+            "required": ["call_id", "version"]
+        },
+        "type": {
+            "type": "string",
+            "enum": ["m.call.select_answer"]
+        }
+    }
+}