Summary

Implement a CompositeBackend that routes specific memory paths to different storage backends, enabling durable persistence for some memory types while keeping others thread-scoped.

Research Source

• Deep Agents Context Engineering (LangChain, 2026-03)

Design

Concept

A wrapper implementing the existing MemoryBackend protocol that dispatches to different concrete backends based on path prefix:

class CompositeBackend:
    routes: dict[str, MemoryBackend]  # path prefix -> backend
    default: MemoryBackend            # fallback for unmatched paths

Routing Rules

Behavior

• Paths start empty; agent creates files on-demand
• Pre-seeding available via Store API
• Follows existing MemoryBackend protocol -- no interface changes
• Configuration via YAML:

memory:
  backend: "composite"
  composite:
    routes:
      memories: "mem0"       # durable
      preferences: "mem0"   # durable
      scratch: "session"     # thread-scoped
      working: "session"     # thread-scoped
    default: "session"

Key Files

• src/synthorg/memory/backends/ -- existing backend implementations
• src/synthorg/memory/retriever.py -- retrieval pipeline
• src/synthorg/memory/injection.py -- injection strategy enum

Related Issues

• research: multi-agent memory consistency protocols (shared vs distributed) #702 (multi-agent memory consistency protocols)
• feat: memory consolidation upgrades (LLM Merge, Search-and-Ask, diversity penalty) #704 (memory consolidation upgrades)