agent-framework-memorysync

MemorySync for the Microsoft Agent Framework: agents that remember users across sessions — without ever stalling a run.

pip install agent-framework-memorysync

Quick start

from agent_framework import Agent
from agent_framework_memorysync import MemorySyncContextProvider

provider = MemorySyncContextProvider(
    api_key="ms_...",          # or MEMORYSYNC_API_KEY
    user_id="customer-42",     # required — who these memories belong to
    session_id="support",      # tags the facts from this conversation
)

agent = Agent(client=..., context_providers=[provider])
result = await agent.run("which seat should I book?")

Every run recalls relevant memories into the instructions layer under a hard budget, and after the run the user's messages are sent to MemorySync, which extracts the durable facts they contain — no extra code per turn. The agent's replies are not sent: assistant replies are not stored as memories.

Why this one

Semantics worth knowing

• User messages are sent to fact extraction; only durable facts are stored. After each run, every user input message goes to MemorySync as plain text with role: "user" under the agent-framework::<session> session scope. The server extracts the durable facts it contains and stores only those, tagged with session_id: "agent-framework::<session>" — the same shared user memories as every other MemorySync surface. Filler such as "ok" or "thanks" yields none, and the message text itself is not stored. The agent's replies are not sent: assistant replies are not stored as memories.
• The resolved run identity is pinned in the provider's session-state slice, so recall and capture can never diverge within a run — and the slice stays JSON-native, so AgentSession serialization keeps working.
• expose_search_tool=True adds search_memory + save_memory tools via context.extend_tools.
• Free-tier quota exhaustion is silent by design (adds accepted-without- storing, reads empty); evaluation keys surface strict 429s.

Configuration

Development

pip install -e . agent-framework-core pytest pytest-asyncio "httpx>=0.25,<1"
python -m pytest tests -q     # 26 tests incl. a REAL Agent run (stub chat client)

License

MIT