Summary

Ports chat update stabilization for iOS shared OpenClawKit ChatUI.

Included

• ChatViewModel stability adjustments for gateway reply/session update behavior
• Matching ChatViewModel test updates

Scope

• Shared OpenClawKit ChatUI source + tests only

Testing

• cd apps/shared/OpenClawKit && swift test --filter ChatViewModelTests
• Result: pass (8 tests)

Greptile Summary

This PR stabilizes iOS ChatUI updates after gateway replies with two key changes:

• Message ID reconciliation: Adds reconcileMessageIDs and messageIdentityKey to preserve SwiftUI-stable UUIDs when messages are re-decoded from history payloads. Without this, every history refresh generates new UUIDs, causing SwiftUI to treat all messages as new items and triggering unnecessary re-renders and visual flicker.
• Canonical session key handling: Reorders the session-key guard in handleChatEvent so that events belonging to the view's own pending run are never dropped due to a session key mismatch (e.g. gateway publishes "agent:main:main" while the view uses "main"). This prevents the UI from getting stuck in a "thinking" state.

Both new tests (acceptsCanonicalSessionKeyEventsForOwnPendingRun, preservesMessageIDsAcrossHistoryRefreshes) directly cover the new behaviors. Note: the pre-existing test sessionChoicesPreferMainAndRecent is failing in the test output — this appears unrelated to this PR's changes, but should be investigated separately.

Confidence Score: 4/5

• This PR is safe to merge — both changes are well-scoped, correctly implemented, and tested.
• The changes are focused, logically sound, and address real UX issues (UI flicker from unstable message IDs, stuck "thinking" state from canonical key mismatches). The reconcileMessageIDs function handles edge cases like empty arrays and duplicate identity keys correctly. The session key guard reorder is minimal and well-commented. Two new tests directly cover the new behaviors. The only concern is the pre-existing failing test in the test output, which is unrelated to this PR.
• No files require special attention from this PR. The pre-existing sessionChoicesPreferMainAndRecent test failure in the test output should be investigated separately.

_{Last reviewed commit: 489c9c7}