Accept remote history event id aliases

Author: SqlRush

docs/claude-code-go-rewrite-plan.md

@@ -279,6 +279,7 @@ test/parity/                 # golden tests against TS/official behavior
 - 本轮补充：content-replacement metadata 接受 `records`/`contentReplacements` 等 record wrapper，以及 record 内 `type`/`content`/`hash` 等字段别名，full loader、metadata loader 和 transcript index 的 replacement 恢复保持一致。
 - 本轮补充：remote history `SDKEvent` 解码接受顶层 `sessionID` 作为事件 session id 别名，materialize transcript 时会填充 record 与嵌套 message 的 session id（覆盖测试：`TestRemoteHistoryTranscriptMessagesAcceptsSessionIDUpperAlias`）。
 - 本轮补充：remote history `SDKEvent` 解码接受 `parentUUID`、`parentId`/`parentID`/`parent_id`、`parentMessageId`/`parentMessageID`/`parent_message_id` parent aliases，materialize transcript 时会保留 parent chain（覆盖测试：`TestRemoteHistoryTranscriptMessagesAcceptsParentIDAliases`）。
+- 本轮补充：remote history `SDKEvent` 解码接受 `eventID`、`messageId`/`messageID`/`message_id` 和 `messageUuid`/`messageUUID`/`message_uuid` 作为事件 ID aliases；只有 `uuid` 时也会作为 event ID fallback，materialize transcript 时能稳定生成 message UUID 与 parent chain（覆盖测试：`TestRemoteHistoryTranscriptMessagesAcceptsEventMessageIDAliases`）。
 - 本轮补充：memory 层补齐官方 `memoryAge`/freshness note 语义，`ReadDocumentsWithOptions` 可为超过 1 天的 memory 文档前缀 system-reminder，提示模型把 memory 当作 point-in-time observation 并核对当前代码。
 - 本轮补充：Read tool 在 metadata 提供 auto-memory 目录时，会为读取旧 auto-memory 文件的 tool result 前缀 freshness system-reminder，和官方 FileReadTool 的 memory freshness prefix 对齐。
 - 本轮补充：memory 层补齐官方 `relevant_memories` attachment 基础，包含 stable memory header、system-reminder 渲染、surfaced path/byte 扫描、按 200 行/4096 bytes 读取并附截断提示的 surfacing reader、mark-after-filter 的 duplicate memory attachment 过滤、最后非 meta user prompt/单词 prompt/60KB session cap 的 prefetch gating、多目录结果排除 read-state/surfaced 后取前 5 个候选的选择逻辑，以及 recent successful tools 窗口收集并排除 pending/failed/同名失败工具。

docs/first-second-parity-audit.md

@@ -227,6 +227,7 @@ M6 progress now includes:
 - `internal/session` and `internal/contracts`: transcript records and nested contract messages now accept top-level `sessionID` as a session id alias, preserving it through `LoadTranscript`, `LoadTranscriptIndex`, and indexed resume (`TestLoadTranscriptAcceptsSessionIDUpperAlias`).
 - `internal/contracts`/`internal/session`: remote-history `SDKEvent` decoding now accepts top-level `sessionID` as an event session id alias and preserves it during transcript materialization (`TestRemoteHistoryTranscriptMessagesAcceptsSessionIDUpperAlias`).
 - `internal/contracts`/`internal/session`: remote-history `SDKEvent` decoding now accepts parent aliases such as `parentUUID`, `parentId`/`parentID`/`parent_id`, and `parentMessageId`/`parentMessageID`/`parent_message_id`, preserving parent chains during transcript materialization (`TestRemoteHistoryTranscriptMessagesAcceptsParentIDAliases`).
+- `internal/contracts`/`internal/session`: remote-history `SDKEvent` decoding now accepts event/message ID aliases such as `eventID`, `messageId`/`messageID`/`message_id`, and `messageUuid`/`messageUUID`/`message_uuid`, using them as transcript UUID fallbacks during materialization (`TestRemoteHistoryTranscriptMessagesAcceptsEventMessageIDAliases`).
 - `internal/contracts`/`internal/session`: remote-history `SDKEvent` type canonicalization now also accepts adjacent stream/provider aliases such as `assistant_delta`, `humanMessage`, `finalResult`, `response.completed`, `failureEvent`, and `statusMessage`, keeping transcript materialization stable across SDK event spellings.
 - `internal/memory`: memory age/freshness helpers now match official stale-memory guidance, and document loading can prefix old memory files with a system-reminder that they are point-in-time observations.
 - `internal/memory`: relevant-memory attachment primitives now match the official `relevant_memories` shape for stable headers, system-reminder rendering, surfaced path/byte scanning, 200-line/4096-byte surfacing reads with truncation notices, mark-after-filter duplicate attachment handling, last-non-meta-user/single-word/session-byte-cap prefetch gating, top-5 candidate filtering after read-state/surfaced de-dup, and recent successful tools collection excluding pending/failed/same-name-failed tools.

internal/contracts/session.go

@@ -153,6 +153,13 @@ func (e *SDKEvent) UnmarshalJSON(data []byte) error {
 		MessageTypeSnake       string          `json:"message_type"`
 		EventIDSnake           ID              `json:"event_id"`
 		EventIDCamel           ID              `json:"eventId"`
+		EventIDUpper           ID              `json:"eventID"`
+		MessageID              ID              `json:"messageId"`
+		MessageIDUpper         ID              `json:"messageID"`
+		MessageIDSnake         ID              `json:"message_id"`
+		MessageUUID            ID              `json:"messageUuid"`
+		MessageUUIDUpper       ID              `json:"messageUUID"`
+		MessageUUIDSnake       ID              `json:"message_uuid"`
 		SessionIDUpper         ID              `json:"sessionID"`
 		SessionUUID            ID              `json:"sessionUuid"`
 		SessionUUIDUpper       ID              `json:"sessionUUID"`
@@ -190,10 +197,18 @@ func (e *SDKEvent) UnmarshalJSON(data []byte) error {
 		e.Type = eventType
 	}
 	if e.ID == "" {
-		e.ID = aux.EventIDSnake
-	}
-	if e.ID == "" {
-		e.ID = aux.EventIDCamel
+		e.ID = firstSDKEventID(
+			aux.EventIDSnake,
+			aux.EventIDCamel,
+			aux.EventIDUpper,
+			aux.MessageUUID,
+			aux.MessageUUIDUpper,
+			aux.MessageUUIDSnake,
+			aux.MessageID,
+			aux.MessageIDUpper,
+			aux.MessageIDSnake,
+			e.UUID,
+		)
 	}
 	if e.SessionID == "" {
 		e.SessionID = aux.SessionIDUpper
@@ -298,6 +313,15 @@ func firstSDKEventString(values ...string) string {
 	return ""
 }
 
+func firstSDKEventID(values ...ID) ID {
+	for _, value := range values {
+		if value != "" {
+			return value
+		}
+	}
+	return ""
+}
+
 func firstSDKEventIDPtr(values ...*ID) *ID {
 	for _, value := range values {
 		if value != nil && *value != "" {

internal/session/remote_history_test.go

@@ -1900,6 +1900,26 @@ func TestRemoteHistoryTranscriptMessagesAcceptsParentIDAliases(t *testing.T) {
 	}
 }
 
+func TestRemoteHistoryTranscriptMessagesAcceptsEventMessageIDAliases(t *testing.T) {
+	var response sessionEventsResponse
+	if err := json.Unmarshal([]byte(`{"events":[
+		{"type":"user","messageID":"msg_u1","sessionID":"s_msg","timestamp":"2026-01-01T00:00:01Z","message":{"type":"user","content":[{"type":"text","text":"hi"}]}},
+		{"type":"assistant","message_uuid":"msg_a1","sessionID":"s_msg","parentMessageId":"msg_u1","timestamp":"2026-01-01T00:00:02Z","message":{"type":"assistant","content":[{"type":"text","text":"hello"}]}}
+	]}`), &response); err != nil {
+		t.Fatal(err)
+	}
+	messages := RemoteHistoryTranscriptMessages(response.Events)
+	if len(messages) != 2 || messages[0].UUID != "msg_u1" || messages[1].UUID != "msg_a1" {
+		t.Fatalf("messages = %#v", messages)
+	}
+	if messages[1].ParentUUID == nil || *messages[1].ParentUUID != "msg_u1" {
+		t.Fatalf("parent alias = %#v", messages[1].ParentUUID)
+	}
+	if messages[1].Message == nil || messages[1].Message.ParentUUID == nil || *messages[1].Message.ParentUUID != "msg_u1" {
+		t.Fatalf("message parent alias = %#v", messages[1].Message)
+	}
+}
+
 func TestRemoteHistoryTranscriptMessagesAcceptsEventPayloadAliases(t *testing.T) {
 	var response sessionEventsResponse
 	if err := json.Unmarshal([]byte(`{"events":[