Reflect on recent thoughts and patterns.
Analyzes recent activity to identify patterns, topics, and insights.
Useful for understanding "what have I been thinking about?"
By default, only returns user-created memories (not document chunks).
Set include_documents=True to also include chunks from uploaded documents.
⚠️ EXPERIMENTAL:
- Importance weighting in results not yet implemented. Importance scores are stored but don't affect ranking.
Args:
time_window: Time period to analyze ('recent', 'today', 'week', 'month', '1d', '7d', '30d', '90d')
include_documents: Whether to include document chunks (default: False, only user memories)
start_date: Filter memories created on or after this date (ISO 8601: '2025-01-01' or '2025-01-01T00:00:00Z')
end_date: Filter memories created on or before this date (ISO 8601: '2025-01-09' or '2025-01-09T23:59:59Z')
ctx: MCP context (automatically provided)
Returns:
Dict with analysis including top memories, active topics, patterns,
insights, and any saved contexts (checkpoints) created in the window.
Examples:
>>> await reflect("recent")
{'success': True, 'memories_analyzed': 50, 'active_topics': [...], 'contexts': [...], ...}
>>> await reflect("week", include_documents=True)
{'success': True, 'memories_analyzed': 150, ...} # includes document chunks
>>> await reflect(start_date="2025-01-01", end_date="2025-01-07")
{'success': True, 'memories_analyzed': 25, ...} # memories from first week of January