mirror of
https://github.com/hwchase17/langchain.git
synced 2026-07-12 19:31:24 +00:00
c44a9c9fdf
Fixes #36427 ## Why Mistral citation responses can return `content` as typed chunks, including `reference` chunks with `reference_ids`. Those `reference` chunks contain visible answer text plus citation metadata. Previously, `ChatMistralAI` did not preserve that citation metadata in a way LangChain users could consume. RAG users could not reliably map cited answer spans back to source documents through LangChain. ## What changed - Normalize Mistral `reference` chunks into text-compatible content blocks so standard text accessors still include the cited answer span. - Preserve Mistral citation metadata on the normalized text block under `reference`. - Translate normalized Mistral reference metadata into standard `TextContentBlock` citation annotations via `content_blocks`. - Support the same normalization for streaming chunks. - Preserve citation metadata when round-tripping v1 content blocks back to Mistral chat message content. For example, a Mistral response like: ```python [ {"type": "text", "text": "The answer is "}, {"type": "reference", "reference_ids": [0], "text": "42"}, {"type": "text", "text": "."}, ] ``` is represented internally as text content with reference metadata, so `message.text` returns `"The answer is 42."`, while `message.content_blocks` exposes a standard citation annotation for the cited span. References: - https://docs.mistral.ai/capabilities/citations/ - https://docs.mistral.ai/resources/cookbooks/mistral-rag-mistral-reference-rag --------- Co-authored-by: Mason Daugherty <github@mdrxy.com>