ask-with-history tool goes beyond answering “what is X right now?” — it shows you the full arc of how something evolved. It returns both the current state of a topic and a chronological view of how it got there, drawn from Hyper’s predecessor graph of memory documents. Use it when you need to understand context that requires knowing what changed, when it changed, and why it changed — not just the final answer.
Parameters
Returns
string
A summary of what Hyper currently knows about the topic — the most recent, authoritative answer.
string
A chronological account of how the topic changed over time, drawn from the predecessor graph of memory documents. Each entry in the evolution reflects a meaningful state change with context about when and why it occurred.
How It Works
ask-with-history combines vector search with traversal of Hyper’s predecessor graph — a linked structure that connects each memory document to the earlier documents it superseded. This lets Hyper reconstruct not just what’s true now, but what was true at each earlier point, and what caused the transition.
ask-with-history is only available on v2 workspaces. If your workspace is on v1, calling this tool automatically falls back to ask() and returns the current state without history.Example Calls
Pricing evolution
Past decisions on a technical choice
What someone was working on before their current project
When to Use ask-with-history vs. ask
Choosing between the two tools is straightforward:v1 Workspace Fallback
If your workspace hasn’t been upgraded to v2,ask-with-history gracefully degrades to ask — you’ll get the current state of the topic without the evolution history. The response won’t include a historical breakdown, but it won’t error either. Contact your workspace admin or the Hyper team to upgrade to v2 if you want full history traversal.