fix(ai): preserve existing message ids on interrupt snapshots

[kolaworld]

Keep ModelMessage.id on MESSAGES_SNAPSHOT so interrupt boundaries do not rewrite stable identity. Generate snapshot_<run>_<index> only when an id is missing.

Fixes#1107

🎯 Changes

• Keep a stored ModelMessage.id on interrupt MESSAGES_SNAPSHOT events instead of always rewriting it to snapshot_<run>_<index>.
• Generate snapshot_<run>_<index> only when a message has no id, matching the client snapshot normalizer.
• That stops a stable user/assistant identity from looking like new input after a native interrupt, which breaks dedupe, reconciliation, and in-place rendering keyed on message.id.
• Add a chat() regression that asserts user-1 and stream-assistant survive the snapshot, plus a patch changeset for @tanstack/ai.

✅ Checklist

• I have followed the steps in the Contributing guide.
• I have tested this code locally with pnpm run test:pr.

🚀 Release Impact

• This change affects published code, and I have generated a changeset.
• This change is docs/CI/dev-only (no release).

Summary by CodeRabbit

• Bug Fixes

  • Preserved existing message IDs in chat snapshots generated when an interaction is interrupted.
  • Assigned consistent fallback IDs to messages that do not already have one.

• Tests

  • Added coverage for preserving existing IDs and generating deterministic IDs for messages without IDs.

[coderabbitai]

No actionable comments were generated in the recent review. 🎉

ℹ️ Recent review info

⚙️ Run configuration

Configuration used: defaults

Review profile: CHILL

Plan: Pro Plus

Run ID: ebcf428e-14f4-43f0-b238-1e0f02bed0fd

📥 Commits

Reviewing files that changed from the base of the PR and between 9a4124d and b6c9128.

📒 Files selected for processing (3)

• .changeset/fix-1107-snapshot-message-ids.md
• packages/ai/src/activities/chat/index.ts
• packages/ai/tests/chat.test.ts

---

📝 Walkthrough

Walkthrough

Interrupt MESSAGES_SNAPSHOT events now preserve existing message IDs. Snapshots generate IDs from the run ID and message index only when messages do not already have IDs. Regression tests cover both behaviors.

Changes

Snapshot message ID preservation

Layer / File(s)	Summary
Preserve and validate snapshot IDs packages/ai/src/activities/chat/index.ts, packages/ai/tests/chat.test.ts, .changeset/fix-1107-snapshot-message-ids.md	buildMessagesSnapshotChunk keeps existing message IDs and generates fallback snapshot IDs for messages without IDs. Tests cover supplied user and assistant IDs and the fallback format. The changeset records the patch release.

Estimated code review effort: 2 (Simple) | ~10 minutes

Merge Risk:⚪ Minimal · up to b6c91

The change preserves existing message identities at interrupt boundaries and only generates fallback IDs when needed; no actionable merge-blocking risk remains after normal checks and review.

Possibly related PRs

• TanStack/ai#1066: Preserves message IDs during UI-to-model conversion.
• TanStack/ai#1101: Updates assistant message ID handling in chat snapshots and turns.

Suggested reviewers:alemtuzlak, tombeckenham, season179

🚥 Pre-merge checks | ✅ 5

✅ Passed checks (5 passed)

Check name	Status	Explanation
Title check	✅ Passed	The title clearly summarizes the main change: preserving existing message IDs in interrupt snapshots.
Description check	✅ Passed	The description includes the required changes, checklist, and release impact sections with relevant details and completed items.
Linked Issues check	✅ Passed	The implementation, regression tests, fallback ID behavior, and changeset satisfy issue #1107 requirements.
Out of Scope Changes check	✅ Passed	All changes directly support preserving message IDs and validating fallback snapshot IDs for issue #1107.
Docstring Coverage	✅ Passed	No functions found in the changed files to evaluate docstring coverage. Skipping docstring coverage check.

✨ Finishing Touches

🧪 Generate unit tests (beta)

• Create PR with unit tests

Warning

There were issues while running some tools. Please review the errors and either fix the tool's configuration or disable the tool if it's a critical failure.

🔧 ESLint

If the error stems from missing dependencies, add them to the package.json file. For unrecoverable errors (e.g., due to private dependencies), disable the tool in the CodeRabbit configuration.

ESLint install failed. For unrecoverable errors, disable the tool in CodeRabbit configuration.

---

Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out.

❤️ Share

• X
• Mastodon
• Reddit
• LinkedIn

_{Comment @coderabbitai help to get the list of available commands.}

[nx-cloud]

View your CI Pipeline Execution ↗ for commit b6c9128

Command	Status	Duration	Result
nx run-many --targets=build --exclude=examples/...	✅ Succeeded	1m 50s	View ↗

---

☁️ Nx Cloud last updated this comment at 2026-08-17 12:56:04 UTC

[pkg-pr-new]

Open in StackBlitz

@tanstack/ai

npm i https://pkg.pr.new/@tanstack/ai@1116

@tanstack/ai-acp

npm i https://pkg.pr.new/@tanstack/ai-acp@1116

@tanstack/ai-angular

npm i https://pkg.pr.new/@tanstack/ai-angular@1116

@tanstack/ai-anthropic

npm i https://pkg.pr.new/@tanstack/ai-anthropic@1116

@tanstack/ai-bedrock

npm i https://pkg.pr.new/@tanstack/ai-bedrock@1116

@tanstack/ai-byteplus

npm i https://pkg.pr.new/@tanstack/ai-byteplus@1116

@tanstack/ai-claude-code

npm i https://pkg.pr.new/@tanstack/ai-claude-code@1116

@tanstack/ai-client

npm i https://pkg.pr.new/@tanstack/ai-client@1116

@tanstack/ai-code-mode

npm i https://pkg.pr.new/@tanstack/ai-code-mode@1116

@tanstack/ai-code-mode-skills

npm i https://pkg.pr.new/@tanstack/ai-code-mode-skills@1116

@tanstack/ai-codex

npm i https://pkg.pr.new/@tanstack/ai-codex@1116

@tanstack/ai-cohere

npm i https://pkg.pr.new/@tanstack/ai-cohere@1116

@tanstack/ai-devtools-core

npm i https://pkg.pr.new/@tanstack/ai-devtools-core@1116

@tanstack/ai-durable-stream

npm i https://pkg.pr.new/@tanstack/ai-durable-stream@1116

@tanstack/ai-elevenlabs

npm i https://pkg.pr.new/@tanstack/ai-elevenlabs@1116

@tanstack/ai-event-client

npm i https://pkg.pr.new/@tanstack/ai-event-client@1116

@tanstack/ai-fal

npm i https://pkg.pr.new/@tanstack/ai-fal@1116

@tanstack/ai-gemini

npm i https://pkg.pr.new/@tanstack/ai-gemini@1116

@tanstack/ai-grok

npm i https://pkg.pr.new/@tanstack/ai-grok@1116

@tanstack/ai-grok-build

npm i https://pkg.pr.new/@tanstack/ai-grok-build@1116

@tanstack/ai-groq

npm i https://pkg.pr.new/@tanstack/ai-groq@1116

@tanstack/ai-isolate-cloudflare

npm i https://pkg.pr.new/@tanstack/ai-isolate-cloudflare@1116

@tanstack/ai-isolate-daytona

npm i https://pkg.pr.new/@tanstack/ai-isolate-daytona@1116

@tanstack/ai-isolate-node

npm i https://pkg.pr.new/@tanstack/ai-isolate-node@1116

@tanstack/ai-isolate-quickjs

npm i https://pkg.pr.new/@tanstack/ai-isolate-quickjs@1116

@tanstack/ai-isolate-quickjs-bun

npm i https://pkg.pr.new/@tanstack/ai-isolate-quickjs-bun@1116

@tanstack/ai-mcp

npm i https://pkg.pr.new/@tanstack/ai-mcp@1116

@tanstack/ai-memory

npm i https://pkg.pr.new/@tanstack/ai-memory@1116

@tanstack/ai-mistral

npm i https://pkg.pr.new/@tanstack/ai-mistral@1116

@tanstack/ai-ollama

npm i https://pkg.pr.new/@tanstack/ai-ollama@1116

@tanstack/ai-openai

npm i https://pkg.pr.new/@tanstack/ai-openai@1116

@tanstack/ai-opencode

npm i https://pkg.pr.new/@tanstack/ai-opencode@1116

@tanstack/ai-openrouter

npm i https://pkg.pr.new/@tanstack/ai-openrouter@1116

@tanstack/ai-perplexity

npm i https://pkg.pr.new/@tanstack/ai-perplexity@1116

@tanstack/ai-persistence

npm i https://pkg.pr.new/@tanstack/ai-persistence@1116

@tanstack/ai-preact

npm i https://pkg.pr.new/@tanstack/ai-preact@1116

@tanstack/ai-react

npm i https://pkg.pr.new/@tanstack/ai-react@1116

@tanstack/ai-react-ui

npm i https://pkg.pr.new/@tanstack/ai-react-ui@1116

@tanstack/ai-sandbox

npm i https://pkg.pr.new/@tanstack/ai-sandbox@1116

@tanstack/ai-sandbox-cloudflare

npm i https://pkg.pr.new/@tanstack/ai-sandbox-cloudflare@1116

@tanstack/ai-sandbox-daytona

npm i https://pkg.pr.new/@tanstack/ai-sandbox-daytona@1116

@tanstack/ai-sandbox-docker

npm i https://pkg.pr.new/@tanstack/ai-sandbox-docker@1116

@tanstack/ai-sandbox-local-process

npm i https://pkg.pr.new/@tanstack/ai-sandbox-local-process@1116

@tanstack/ai-sandbox-sprites

npm i https://pkg.pr.new/@tanstack/ai-sandbox-sprites@1116

@tanstack/ai-sandbox-vercel

npm i https://pkg.pr.new/@tanstack/ai-sandbox-vercel@1116

@tanstack/ai-solid

npm i https://pkg.pr.new/@tanstack/ai-solid@1116

@tanstack/ai-solid-ui

npm i https://pkg.pr.new/@tanstack/ai-solid-ui@1116

@tanstack/ai-svelte

npm i https://pkg.pr.new/@tanstack/ai-svelte@1116

@tanstack/ai-utils

npm i https://pkg.pr.new/@tanstack/ai-utils@1116

@tanstack/ai-vercel-gateway

npm i https://pkg.pr.new/@tanstack/ai-vercel-gateway@1116

@tanstack/ai-vue

npm i https://pkg.pr.new/@tanstack/ai-vue@1116

@tanstack/ai-vue-ui

npm i https://pkg.pr.new/@tanstack/ai-vue-ui@1116

@tanstack/openai-base

npm i https://pkg.pr.new/@tanstack/openai-base@1116

@tanstack/preact-ai-devtools

npm i https://pkg.pr.new/@tanstack/preact-ai-devtools@1116

@tanstack/react-ai-devtools

npm i https://pkg.pr.new/@tanstack/react-ai-devtools@1116

@tanstack/solid-ai-devtools

npm i https://pkg.pr.new/@tanstack/solid-ai-devtools@1116

commit: b6c9128