How fa66666/conmemcode works
ConMem is a pluggable memory layer for single- and multi-agent task hosts. A host retrieves task-relevant cards to condition agent prompts, then submits the completed trajectory for interpretation, admission, graph updates, and later reuse. CAMEL, MacNet, AutoGen, and single-agent integrations are documented; benchmark environments cover code generation, factual QA, and symbolic planning. The README supplies the core stage wiring, while excerpts show interaction hooks, retrieval, storage, and external API calls; some subsystem links therefore reflect documentation rather than sampled implementations.
Main entry points: conmem_module.py Memory coordinator · multiturn_interaction.py Multi-turn host · agent.py Single agent · llm_backend.py LLM and embeddings
Components 27
Agent hosts
- Single agent
utils/agent.py - Multi-turn host
interactions/multiturn_interaction.py - CAMEL host
mas_core/structures/camel/camel_main.py - MacNet host
mas_core/structures/macnet/macnet_main.py - AutoGen host
mas_core/structures/autogen/autogen_main.py
ConMem lifecycle
- Memory coordinator
mas_core/memory/backbone/conmem/conmem_module.py - Trajectory interpreter
mas_core/memory/backbone/conmem/interpreter.py - Card admission
mas_core/memory/backbone/conmem/admission.py - Card retriever
mas_core/memory/backbone/conmem/retriever.py - Graph coordinator
mas_core/memory/backbone/conmem/coordinator.py - Hint serializer
mas_core/memory/backbone/conmem/serializer.py
Memory state
- Memory graph
mas_core/memory/backbone/conmem/memory_graph.py - Card store
mas_core/memory/backbone/conmem/storage.py - Card schema
mas_core/memory/backbone/conmem/schema.py
Task environments
- KodCode tasks
data/kodcode/env.py - TriviaQA tasks
data/triviaqa/env.py - PopQA tasks
data/popqa/env.py - PDDL planning
data/pddl/env/pddl_env.py - QA retrieval
common/utils/retrieval_utils.py - PopQA retrieval
data/popqa/retriever.py
Optional backends
- LLM and embeddings
mas_core/memory/backbone/conmem/llm_backend.py - SimpleMem adapter
mas_core/memory/backbone/simplemem/centralized_adapter.py - ReMe adapter
mas_core/memory/backbone/reme/centralized_adapter.py
Other components
- Task requester
- LLM endpoint
- Embedding endpoint
- QA search service
Connections 39
- Task requester → Single agent: submits task
- Task requester → Multi-turn host: submits task
- Task requester → CAMEL host: submits task
- Task requester → MacNet host: submits task
- Task requester → AutoGen host: submits task
- Single agent → Memory coordinator: retrieves memory
- Single agent → Memory coordinator: submits trajectory
- Multi-turn host → Memory coordinator: retrieves memory
- Multi-turn host → Memory coordinator: submits trajectory
- CAMEL host → Memory coordinator: memory hooks
- MacNet host → Memory coordinator: memory hooks
- AutoGen host → Memory coordinator: memory hooks
- Memory coordinator → Card retriever: retrieves cards
- Memory coordinator → Trajectory interpreter: interprets trajectory
- Memory coordinator → Card admission: admits candidates
- Memory coordinator → Graph coordinator: coordinates cards
- Memory coordinator → Hint serializer: serializes hints
- Trajectory interpreter → LLM and embeddings: requests interpretation
- Card admission → LLM and embeddings: requests scoring
- Card retriever → LLM and embeddings: embeds query
- Card retriever → Card store: reads cards
- Graph coordinator → Memory graph: walks and merges
- Graph coordinator → Card store: reads and writes
- Card admission → Card store: writes admitted cards
- Trajectory interpreter → Card schema: creates typed cards
- Hint serializer → Single agent: returns prompt hints
- Hint serializer → Multi-turn host: returns prompt hints
- LLM and embeddings → LLM endpoint: calls inference API
- LLM and embeddings → Embedding endpoint: calls embedding API
- KodCode tasks → Multi-turn host: provides task
- TriviaQA tasks → Multi-turn host: provides task
- PopQA tasks → Multi-turn host: provides task
- PDDL planning → Multi-turn host: provides task
- TriviaQA tasks → QA retrieval: issues search queries
- QA retrieval → QA search service: posts queries
- PopQA tasks → PopQA retrieval: issues search queries
- PopQA retrieval → QA search service: posts queries
- Single agent → SimpleMem adapter: alternate backend
- Single agent → ReMe adapter: alternate backend