From 9217de3aa17de9d862f6d7cd1aa6b9767e7a2b1a Mon Sep 17 00:00:00 2001
From: gamer147 <gamer147@gmail.com>
Date: Mon, 1 Jun 2026 10:32:44 -0400
Subject: [PATCH] feat(battle-node): add IMsgBody marker + RawBody inbound
 wrapper

---
 SVSim.BattleNode/Protocol/IMsgBody.cs | 10 ++++++++++
 SVSim.BattleNode/Protocol/RawBody.cs  | 16 ++++++++++++++++
 2 files changed, 26 insertions(+)
 create mode 100644 SVSim.BattleNode/Protocol/IMsgBody.cs
 create mode 100644 SVSim.BattleNode/Protocol/RawBody.cs

diff --git a/SVSim.BattleNode/Protocol/IMsgBody.cs b/SVSim.BattleNode/Protocol/IMsgBody.cs
new file mode 100644
index 0000000..b1c7fb2
--- /dev/null
+++ b/SVSim.BattleNode/Protocol/IMsgBody.cs
@@ -0,0 +1,10 @@
+namespace SVSim.BattleNode.Protocol;
+
+/// <summary>
+/// Marker for every type that can appear as <see cref="MsgEnvelope.Body"/>.
+/// Implementers fall into two camps: typed records used on the outbound path
+/// (one per scripted frame shape) and <see cref="RawBody"/> used on the inbound
+/// path. The marker exists so the envelope can carry either without falling
+/// back to <c>object</c>.
+/// </summary>
+public interface IMsgBody { }
diff --git a/SVSim.BattleNode/Protocol/RawBody.cs b/SVSim.BattleNode/Protocol/RawBody.cs
new file mode 100644
index 0000000..6d4748d
--- /dev/null
+++ b/SVSim.BattleNode/Protocol/RawBody.cs
@@ -0,0 +1,16 @@
+namespace SVSim.BattleNode.Protocol;
+
+/// <summary>
+/// Wraps a parsed-dictionary body for the inbound path. <see cref="MsgEnvelope.FromJson"/>
+/// returns this; <see cref="MsgEnvelope.ToJson"/> flattens <see cref="Entries"/> back to
+/// top-level keys when echoing.
+/// </summary>
+public sealed class RawBody : IMsgBody
+{
+    public Dictionary<string, object?> Entries { get; }
+
+    public RawBody(Dictionary<string, object?> entries)
+    {
+        Entries = entries;
+    }
+}