Improve session recall accuracy

The built-in session search tool has been upgraded from a single-pass lookup to a two-step process: the agent first calls search_past_sessions() to retrieve lightweight previews of recent sessions, then selectively fetches the full conversation for a specific session with read_past_session(session_id).

This reduces unnecessary data loading and gives the agent a clearer, more structured path to locating relevant history.

‍

Details:

search_past_sessions() returns per-run previews across recent sessions without loading full message histories
read_past_session(session_id) fetches the complete conversation for a targeted session on demand
Control scope with num_past_sessions_to_search (default 20) and num_past_session_runs_in_search (default 3) to tune preview depth
Session history is scoped per user — agents cannot surface another user's sessions
Enable with search_past_sessions=True on the Agent; no other changes required

‍

See cookbook for reference.

‍