memory-context-recall

id	memory-context-recall
name	Memory Context Recall
description	Recall past conversations and facts from agent memory
role	other
requiredTools	[{"type":"builtin","tool":"search_memory"}]

Memory Context Recall

When the user asks to remember past conversations or facts:

• Use search_memory with a suitable grain (working, daily, weekly, monthly, quarterly, yearly) and optional queryText for semantic search.
• Use minimumDaysAgo and maximumDaysAgo to bound the time window (e.g. "last week" = maximumDaysAgo 7, minimumDaysAgo 0).
• Synthesize recalled events into context before answering; cite that the answer is based on prior context when relevant.
• Prefer working grain for "our last conversation" or recent context; use daily or weekly for broader recall.
• When no queryText is provided, the tool returns most recent events for the grain and time range.

Step-by-step instructions

1. Interpret the user's time intent: "last conversation" -> working, 0-1 days; "last week" -> daily or weekly, maximumDaysAgo 7; "last month" -> weekly or monthly, maximumDaysAgo 30.
2. Call search_memory with grain, minimumDaysAgo, maximumDaysAgo, and optionally queryText (for semantic match) and maxResults (default 10, max 100).
3. Read the returned events (prefixed by date when available) and extract relevant facts or prior decisions.
4. Answer the user's question using the recalled context; say "Based on our previous conversation..." or "From what we discussed..." when appropriate.
5. If nothing relevant is found, say so and suggest rephrasing the time range or query.

Examples of inputs and outputs

• Input: "What did we decide about the API design last time?"
  Output: Short summary of the relevant prior decision from search_memory (grain=working or daily, queryText="API design" or no queryText with recent range); cite that it's from a prior conversation.

• Input: "Do you remember the budget number we discussed?"
  Output: The budget value if found in search_memory (e.g. grain=working, queryText="budget"); if not found, "I don't have that in memory for that period."

Common edge cases

• No results: Say "I couldn't find anything in memory for that period/topic" and suggest widening the time range or trying a different query.
• Ambiguous time range: If the user says "a while ago", use a broad range (e.g. maximumDaysAgo 90) and optionally queryText; summarize what you find.
• Too many results: Use maxResults (e.g. 10-20) and summarize the most relevant; mention that more may exist.
• queryText vs no queryText: Use queryText for topic-specific recall; omit it for "what happened in the last N days" style requests.

Tool usage for specific purposes

• search_memory (grain=working): Use for "last conversation", "recently", or most recent events.
• search_memory (grain=daily/weekly/monthly): Use for "last week", "this month", or summarized recall over longer periods.
• search_memory (queryText): Use when the user asks about a specific topic or fact to search semantically.
• minimumDaysAgo / maximumDaysAgo: Use to narrow the window (e.g. last 7 days: maximumDaysAgo 7, minimumDaysAgo 0).