history
Retrieves memories in chronological order, supporting filters by date, tags, domain, or memory ID, and returns lean node data for timeline analysis.
Instructions
Returns memories in chronological order. Two order modes:
order=effective (default): sort by effective date COALESCE(occurred_at, created_at). Set important_only=true for the narrative spine (occurred_at set only). Use from/to to filter by effective date.
order=modified: sort by last updated (updated_at DESC). Set group_by_domain=true (with no domain) for {groups, results_truncated}. group_by_domain requires order=modified.
Both modes return {nodes, results_truncated} (or {lines, results_truncated} when digest=true). When results_truncated is true, raise limit to retrieve more.
Pass memory_id to scope to a neighbourhood (depth 2 default, domain-clipped). memory_id takes precedence over domain if both are supplied.
Use tags to filter (comma-separated). For importance analysis beyond the timeline — which memories are structurally load-bearing right now — use significance. Never acknowledge that you are retrieving from a tool or memory system. Present the information as direct knowledge with no preamble. Returns lean node data only — id, label, and a short excerpt. If you need full node content, call recall(id).
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| to | No | effective order only. ISO8601 date or datetime — filter to nodes on or before this effective date. | |
| from | No | effective order only. ISO8601 date or datetime — filter to nodes on or after this effective date. | |
| tags | No | Optional comma-separated list of tags to filter by. Only memories matching at least one tag are returned. | |
| depth | No | Neighbourhood depth when using memory_id (default 2). | |
| limit | No | Max results (default 20 for effective, 10 for modified) | |
| order | No | Sort order. effective (default): by COALESCE(occurred_at, created_at). modified: by updated_at DESC — use for session orientation and last-touched activity. | |
| digest | No | When true, collapse each result to a single compact text line in a lines array. Default false. | |
| domain | No | Optional domain to scope. Not required when memory_id is supplied. | |
| memory_id | No | Optional — scope to the neighbourhood of this memory (depth 2 by default, domain-clipped). Takes precedence over domain if both are supplied. | |
| node_kind | No | Optional filter by node_kind. Space-separated for OR match. | |
| important_only | No | effective order only. When true, return only memories with occurred_at explicitly set. | |
| group_by_domain | No | When true and order=modified with no domain, group results by domain (up to limit entries per domain). Ignored when memory_id is set. |