recall

Recall past work on a specific project or topic.

Steps

1. Classify the question. Each shape has a cheapest path:

   • Needle — "what did we decide about X?" → search, then read just the matched exchange.
   • Arc — "where did we leave off on X?" → digest the relevant session(s).
   • Artifact — "what happened to this file?" → search with the files filter.

2. Find candidate sessions. Call search_sessions:

   • Needle/arc: query = topic keywords; add project if a path was given; limit: 10.
   • Artifact: files: [path or suffix], no query — results come back newest first.

   Each result carries messageHits — the specific messages that matched (index, role, snippet). The snippets alone often answer a needle question.

3. Digest the best 1-3 candidates. Call get_session_digest with each candidate's filePath. One bounded call (~2k tokens) returns the session's arc: every genuine user turn paired with its exchange's final assistant reply, each with a message index. For "where did we leave off", the last exchange of the newest session's digest usually is the answer.

4. Expand only what you need. To read around a specific point, call get_session_messages with offset = a messageHits[].index (from search) or exchanges[].index (from digest) and a small limit (5-10). Never page a transcript from offset 0 when a hit or digest index is available.