list_memories tool ¶Paginated chronological listing for review, audit, and cleanup
workflows. Optional filters narrow the result to untagged rows,
very-short or very-long rows, or rows that haven’t been confirmed
since a given timestamp — the same filters are accepted by
count_memories so a client can preview the size of a cleanup
slice before listing it.
limitInteger. Optional, default 20, capped at MAX_RECALL_LIMIT.
offsetInteger. Optional, default 0.
include_deletedBoolean. Optional, default false. When true, soft-deleted memories (tombstones) and expired memories are also returned.
untagged_onlyBoolean. Optional, default false. When true, restrict to rows with no tags (empty tag array).
min_charsInteger. Optional. Return only rows whose text length is at
least this many characters.
max_charsInteger. Optional. Return only rows whose text length is at
most this many characters. Useful for finding fragments
(e.g. max_chars=20).
not_confirmed_sinceISO 8601 timestamp. Optional. Return only rows that have not
been confirmed since this instant — a row qualifies if
last_confirmed_at IS NULL (never confirmed) or
last_confirmed_at < this. Useful for finding stale memories
during cleanup.
When multiple filters are supplied they combine with AND.
Same shape as recall’s matches, but with no score
field, and ordered by created_at DESC.
INVALID_INPUT (negative min_chars or max_chars,
min_chars > max_chars, not_confirmed_since in the
future), DATABASE_ERROR.