Unwrap nested remote event payloads

Author: SqlRush

docs/cc-100-roadmap.md

@@ -418,6 +418,8 @@ M7 补充：prompt history `LogEntry` 读取现在接受 `sessionID`/`session`/`
 
 本轮补充：contract image source 解码现在接受 `mediaType`/`mimeType`/`contentType`、`base64`/`payload` 等 source 字段别名，并支持顶层 image block 直接携带媒体类型和 base64 数据，transcript resume 会保留为规范 `ImageSource`。
 
+本轮补充：remote history `SDKEvent` payload materialization 现在会递归解包 `payload`/`data`/`body` 内的 `record`/`entry`/`item`/`event`/`result`/`response`/`output` wrapper，减少远端事件多层包装导致的消息丢失。
+
 ### M7: TUI Renderer And Interaction
 
 目标：还原交互式 Claude Code 体验。

docs/first-second-parity-audit.md

@@ -313,6 +313,7 @@ M7 progress now includes:
 - `internal/tui`: interaction script single-step JSON now unwraps `step`/`scriptStep`/`interactionStep`/`record`/`entry`/`item`/`event` objects in arrays, JSONL records, and wrapper-object step lists.
 - `internal/tui`: interaction script top-level wrappers now accept record-array aliases such as `records`/`recordedSteps`/`events`/`entries`/`items`/`actions`/`timeline`.
 - `internal/tui`: interaction script loading now recurses through outer API/fixture wrappers such as `data`/`payload`/`body`/`result`/`response`/`recording`/`session`/`run`.
+- `internal/contracts`/`internal/session`: remote history `SDKEvent` message extraction now recurses through nested payload wrappers such as `record`/`entry`/`item`/`event`/`result`/`response`/`output`.
 
 Still missing for full M6/M7 parity:
 

internal/contracts/session.go

@@ -305,7 +305,23 @@ func sdkEventMessageFromRaw(raw json.RawMessage, eventType SDKEventType) *Messag
 	if err := json.Unmarshal(raw, &fields); err != nil {
 		return nil
 	}
-	for _, name := range []string{"message", "serialized_message", "serializedMessage", "payload", "data", "body"} {
+	for _, name := range []string{
+		"message",
+		"message_payload",
+		"messagePayload",
+		"serialized_message",
+		"serializedMessage",
+		"payload",
+		"data",
+		"body",
+		"record",
+		"entry",
+		"item",
+		"event",
+		"result",
+		"response",
+		"output",
+	} {
 		if nested := sdkEventMessageFromRaw(fields[name], eventType); nested != nil {
 			return nested
 		}

internal/session/remote_history_test.go

@@ -1107,6 +1107,29 @@ func TestRemoteHistoryTranscriptMessagesAcceptsEventPayloadAliases(t *testing.T)
 	}
 }
 
+func TestRemoteHistoryTranscriptMessagesAcceptsNestedEventPayloadWrappers(t *testing.T) {
+	var response sessionEventsResponse
+	if err := json.Unmarshal([]byte(`{"events":[
+		{"eventType":"user","eventId":"evt_u1","sessionID":"s_nested","createdAt":"2026-01-01T00:00:01Z","payload":{"record":{"role":"user","text":"hi"}}},
+		{"eventType":"assistant","eventId":"evt_a1","sessionID":"s_nested","parentMessageID":"evt_u1","createdAt":"2026-01-01T00:00:02Z","data":{"entry":{"role":"assistant","message":"hello"}}}
+	]}`), &response); err != nil {
+		t.Fatal(err)
+	}
+	messages := RemoteHistoryTranscriptMessages(response.Events)
+	if len(messages) != 2 || messages[0].UUID != "evt_u1" || messages[1].UUID != "evt_a1" {
+		t.Fatalf("messages = %#v", messages)
+	}
+	if messages[0].Message == nil || len(messages[0].Message.Content) != 1 || messages[0].Message.Content[0].Text != "hi" {
+		t.Fatalf("user nested payload = %#v", messages[0].Message)
+	}
+	if messages[1].Message == nil || len(messages[1].Message.Content) != 1 || messages[1].Message.Content[0].Text != "hello" {
+		t.Fatalf("assistant nested payload = %#v", messages[1].Message)
+	}
+	if messages[1].ParentUUID == nil || *messages[1].ParentUUID != "evt_u1" || messages[1].Message.ParentUUID == nil || *messages[1].Message.ParentUUID != "evt_u1" {
+		t.Fatalf("parent linkage = %#v message=%#v", messages[1].ParentUUID, messages[1].Message)
+	}
+}
+
 func TestRemoteHistoryTranscriptMessagesAcceptsNumericIDAliases(t *testing.T) {
 	var response sessionEventsResponse
 	if err := json.Unmarshal([]byte(`{"events":[{"type":"user","id":101,"sessionId":7,"timestamp":"2026-01-01T00:00:01Z","message":{"type":"user","content":[{"type":"text","text":"hi"}]}},{"type":"assistant","eventId":102,"sessionId":7,"parentMessageID":101,"timestamp":"2026-01-01T00:00:02Z","message":{"type":"assistant","content":[{"type":"text","text":"hello"}]}}]}`), &response); err != nil {