Skip to content

Python: [Bug]: can't import ChatMessageStore in 1.2.2 #5700

Description

@doctorcolossus

Description

I'm unable to import ChatMessageStore from agent_framework. The documentation still lists from agent_framework import ChatMessageStore, ChatMessage, but ChatMessage has been renamed to Message. However, according to this article, "ChatClient, ChatResponse, ChatOptions, and ChatMessageStore are not renamed by this change". 🤔

Code Sample

$ python
Python 3.14.4 (main, Apr 16 2026, 00:00:00) [GCC 16.0.1 20260321 (Red Hat 16.0.1-0)] on linux
Type "help", "copyright", "credits" or "license" for more information.

>>> from agent_framework import ChatMessageStore

Traceback (most recent call last):
  File "<python-input-0>", line 1, in <module>
    from agent_framework import ChatMessageStore
ImportError: cannot import name 'ChatMessageStore' from 'agent_framework' (/usr/local/lib/python3.14/site-packages/agent_framework/__init__.py)

>>> from agent_framework import MessageStore

Traceback (most recent call last):
  File "<python-input-1>", line 1, in <module>
    from agent_framework import MessageStore
ImportError: cannot import name 'MessageStore' from 'agent_framework' (/usr/local/lib/python3.14/site-packages/agent_framework/__init__.py)

$ pip show agent-framework
Name: agent-framework
Version: 1.2.2
Summary: Microsoft Agent Framework for building AI Agents with Python. This package contains all the core and optional packages.
Home-page: https://aka.ms/agent-framework
Author: 
Author-email: Microsoft <af-support@microsoft.com>
License: 
Location: /usr/local/lib/python3.14/site-packages
Requires: agent-framework-core
Required-by: 

$ pip show agent-framework-core
Name: agent-framework-core
Version: 1.2.2
Summary: Microsoft Agent Framework for building AI Agents with Python. This is the core package that has all the core abstractions and implementations.
Home-page: https://aka.ms/agent-framework
Author: 
Author-email: Microsoft <af-support@microsoft.com>
License: 
Location: /usr/local/lib/python3.14/site-packages
Requires: opentelemetry-api, pydantic, python-dotenv, typing-extensions
Required-by: agent-framework, agent-framework-a2a, agent-framework-ag-ui, agent-framework-anthropic, agent-framework-azure-ai-search, agent-framework-azure-cosmos, agent-framework-azurefunctions, agent-framework-bedrock, agent-framework-chatkit, agent-framework-claude, agent-framework-copilotstudio, agent-framework-declarative, agent-framework-devui, agent-framework-durabletask, agent-framework-foundry, agent-framework-foundry-local, agent-framework-github-copilot, agent-framework-lab, agent-framework-mem0, agent-framework-ollama, agent-framework-openai, agent-framework-orchestrations, agent-framework-purview, agent-framework-redis

$ cd  /usr/local/lib/python3.14/site-packages
$ grep -r "class ChatMessageStore"
$ grep -r "class MessageStore"
$ 

Package Versions

agent-framework-core 1.2.2

Python Version

Python 3.14

Metadata

Metadata

Assignees

Labels

bugUsage: [Issues], Target: all issues (Legacy, prefer issue type: bug)documentationUsage: [Issues, PRs], Target: documentation in the code base and learn docspythonUsage: [Issues, PRs], Target: PythonreproducedUsage: [Issues], Target: all issues that can be reproduced by the triage workflow

Type

No fields configured for Bug.

Projects

Status
Done

Milestone

No milestone

Relationships

None yet

Development

No branches or pull requests

Issue actions