refactor(core): remove example attribute from AIMessage and HumanMessage

[mdrxy]

No description provided.

[vercel]

The latest updates on your projects. Learn more about Vercel for GitHub.

Project	Deployment	Preview	Comments	Updated (UTC)
langchain	Ready	Preview	Comment	Sep 11, 2025 2:06am

[Copilot]

Pull Request Overview

This PR removes the deprecated example attribute from both AIMessage and HumanMessage classes. The attribute was previously marked as discouraged and ignored by most models, making it safe to remove for API cleanup.

Key changes:

• Removed example field definition and documentation from both message classes
• Removed validation logic for example field mismatches in AIMessageChunk concatenation
• Updated all test expectations to exclude the example field from message objects

Reviewed Changes

Copilot reviewed 8 out of 8 changed files in this pull request and generated 1 comment.

Show a summary per file

File	Description
libs/core/langchain_core/messages/ai.py	Removed example attribute definition and validation logic from AIMessage and AIMessageChunk
libs/core/langchain_core/messages/human.py	Removed example attribute definition from HumanMessage
libs/core/tests/unit_tests/test_messages.py	Updated tests to remove example field usage and validation
libs/core/tests/unit_tests/prompts/test_few_shot.py	Updated expected message objects to exclude example field
libs/core/tests/unit_tests/prompts/test_chat.py	Updated expected message objects to exclude example field
libs/core/tests/unit_tests/runnables/snapshots/test_graph.ambr	Updated schema snapshots to remove example field
libs/core/tests/unit_tests/prompts/snapshots/test_chat.ambr	Updated schema snapshots to remove example field
libs/langchain/tests/unit_tests/agents/test_agent.py	Updated test expectations to exclude example field

[codspeed-hq]

CodSpeed WallTime Performance Report

Merging #32565 will not alter performance

_{Comparing mdrxy/rfc-remove-example (165febe) with wip-v1.0 (750a3ff)}

⚠️ Unknown Walltime execution environment detected

Using the Walltime instrument on standard Hosted Runners will lead to inconsistent data.

For the most accurate results, we recommend using CodSpeed Macro Runners: bare-metal machines fine-tuned for performance measurement consistency.

Summary

✅ 13 untouched benchmarks

[codspeed-hq]

CodSpeed Instrumentation Performance Report

Merging #32565 will not alter performance

_{Comparing mdrxy/rfc-remove-example (165febe) with wip-v1.0 (750a3ff)}

Summary

✅ 14 untouched benchmarks