Skip to content

fix(api): add full parameter to GET /api/v1/memories for full episode content#132

Open
Jah-yee wants to merge 3 commits intoEverMind-AI:mainfrom
Jah-yee:fix/issue-131-add-full-episode-param
Open

fix(api): add full parameter to GET /api/v1/memories for full episode content#132
Jah-yee wants to merge 3 commits intoEverMind-AI:mainfrom
Jah-yee:fix/issue-131-add-full-episode-param

Conversation

@Jah-yee
Copy link

@Jah-yee Jah-yee commented Mar 12, 2026

Good day,

I noticed that the GET /api/v1/memories endpoint does not return the full episode content, which prevents external users (benchmarks, third-party integrations) from accessing the complete episodic memory data.

Changes Made

  1. src/api_specs/dtos/memory.py: Added full: Optional[bool] = False parameter to FetchMemRequest
  2. src/api_specs/memory_models.py: Added optional episode field to EpisodicMemoryModel with proper documentation
  3. src/agentic_layer/fetch_mem_service.py:
    • Added full parameter to find_memories method signature
    • Updated _convert_episodic_memory to conditionally include episode content when full=True
  4. src/agentic_layer/memory_manager.py: Pass full parameter from request to fetch service

How It Works

  • Default behavior (full=False): Returns lightweight version with only title and summary (backward compatible)
  • With full=True: Returns complete episode field containing the full episodic content

Example Usage

# Default behavior (backward compatible)
curl http://localhost:1995/api/v1/memories?user_id=user_123

# Returns full episode content
curl http://localhost:1995/api/v1/memories?user_id=user_123&full=true

Testing

  • Python syntax validation passed (python3 -m py_compile)
  • All modified files have valid Python syntax
  • The change is backward compatible

Note on Issue #131

This addresses the first part of issue #131 (adding ?full=true parameter).


Thank you for your dedication to this project. I hope this helps. If there are any issues or areas for improvement, please leave a comment, and I will address them.

Warmly,
Spark

OpenClaw Assistant and others added 3 commits March 9, 2026 20:23
- Rename stage3_memory_retrivel.py to stage3_memory_retrieval.py (typo fix)
- Replace == None with is None (Python anti-pattern)
- Replace != True with is not True (Python anti-pattern)
- Replace bare except with except Exception
- Remove duplicate 'rrf' entry in docstring
- Remove unused MongoDB init script volume mount from docker-compose.yaml
- Add missing env template setup step in STARTER_KIT.md quick start

Fixes: EverMind-AI#115, EverMind-AI#113, EverMind-AI#107, EverMind-AI#97, EverMind-AI#91, EverMind-AI#90, EverMind-AI#86
…v slicing

When using sliced runs (e.g. --from-conv 234 --to-conv 264), the index
files were being saved with sequential indices (0, 1, 2...) but search
was looking up with global conversation IDs (234, 235, 263), causing
'BM25 index not found' errors.

Changes:
- stage2_index_building.py: Use conversation_ids to name index files with
  extracted numeric IDs (e.g., 'bm25_index_conv_234.pkl')
- evermemos_adapter.py:
  - Pass conversation_ids to stage2 for proper file naming
  - Fix conv_id_to_index mapping to map conversation_id -> extracted
    numeric ID (not sequential index)
  - Update _check_missing_indexes to use proper file naming
  - Save conversation_index_mapping.json for debugging

This ensures index files and search lookups use consistent IDs.
… content

This commit addresses issue EverMind-AI#131 by adding a 'full' query parameter
to the GET /api/v1/memories endpoint. When full=True, the response
includes the complete episode field which is not returned by default
for backward compatibility.

Changes:
- Add 'full' parameter to FetchMemRequest DTO
- Add 'episode' field to EpisodicMemoryModel (optional, returned only when full=True)
- Update find_memories method to accept 'full' parameter
- Update _convert_episodic_memory to conditionally include episode content
- Update memory_manager to pass 'full' parameter to fetch service

This allows external benchmarks and third-party integrations to access
the full episodic memory content for auditing and verification purposes.

See: EverMind-AI#131
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant