strands-memorysync

MemorySync for Strands Agents (AWS's agent SDK): automatic memory injection before every model call, duplicate-proof turn-by-turn extraction, and a crash-proof lifecycle — with zero framework dependencies.

pip install strands-memorysync

Quick start

from strands import Agent
from strands.memory import MemoryManager
from strands_memorysync import MemorySyncStore

store = MemorySyncStore(
    api_key="ms_...",          # or MEMORYSYNC_API_KEY
    user_id="customer-42",     # required — who these memories belong to
    session_id="support",      # scopes the transcript
)

agent = Agent(memory_manager=MemoryManager(stores=[store]))
agent("which seat should I book?")

The MemoryManager consults the store before every model call (automatic injection — not tool-gated), and conversation turns persist through the extraction sink.

Why this one

Semantics worth knowing

• Turns store verbatim under the strands::<session> transcript scope with deterministic seeds — manager retries and batch overlaps converge on one stored row.
• Tool/system messages are never persisted.
• AddMessagesContext.sequence_numbers are recorded in metadata for ordering.
• Free-tier quota exhaustion is silent by design (adds accepted-without- storing, reads empty); evaluation keys surface strict 429s.
• store.get_tools() returns memorysync_search + memorysync_save (@tool-decorated) — enabled via the MemoryManager's tool config.

Configuration

Development

pip install -e . strands-agents pytest pytest-asyncio
python -m pytest tests -q     # 22 tests incl. a REAL Agent turn (stub Model)

License

MIT