search_memory
Retrieve memories by query, tag, or filter, with scoring and pagination. Automatically blend in items due for review to reinforce retention.
Instructions
Search for memories with optional filters and scoring.
This tool implements natural spaced repetition by blending memories due for review into results when they're relevant. This creates the "Maslow effect" - natural reinforcement through conversation.
Pagination: Results are paginated to help you find specific memories across
large result sets. Use page and page_size to navigate through results.
If a search term isn't found on the first page, increment page to see more results.
Args: query: Text query to search for (max 50,000 chars). tags: Filter by tags (max 50 tags). top_k: Maximum number of results before pagination (1-100). window_days: Only search memories from last N days (1-3650). min_score: Minimum decay score threshold (0.0-1.0). use_embeddings: Use semantic search with embeddings. include_review_candidates: Blend in memories due for review (default True). page: Page number to retrieve (1-indexed, default: 1). page_size: Number of memories per page (default: 10, max: 100).
Returns: Dictionary with paginated results including: - results: List of matching memories with scores for current page - pagination: Metadata (page, page_size, total_count, total_pages, has_more)
Some results may be review candidates that benefit from reinforcement.Examples: # Get first page (10 results) search_memory(query="authentication", page=1, page_size=10)
# Get next page
search_memory(query="authentication", page=2, page_size=10)
# Larger page size
search_memory(query="authentication", page=1, page_size=25)Raises: ValueError: If any input fails validation.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| page | No | ||
| tags | No | ||
| query | No | ||
| top_k | No | ||
| min_score | No | ||
| page_size | No | ||
| window_days | No | ||
| use_embeddings | No | ||
| include_review_candidates | No |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
No arguments | |||