API

GET /temporal/query

Temporal query constrains retrieval to explicit time windows for timeline-sensitive reasoning.

When to use

Use temporal query when users ask what was true at a specific time, or when you need only the most recent period of activity.

This endpoint is useful for compliance, debugging, and user-facing activity summaries.

Window controls

Window boundaries are inclusive.
Out-of-window memories are excluded before final ranking.
Temporal filters combine with kind filters if provided.

Temporal request (GET)

curl "http://127.0.0.1:3000/temporal/query?entity_id=user-123&textual_query=where+did+I+live&window_start_ms=1751328000000&window_end_ms=1767225599000&limit=10"

Interpretation

Temporal windows answer a different question than decay. Decay softly biases relevance toward freshness, while windows enforce hard time boundaries.