VO

A compiled digest of everything the user listened to in a time window: a timeline of every episode heard (title, when, minutes heard, moments saved) plus, for the most significant episodes, the user's listening notes and saved moments with vo.fm links. The timeline always covers the whole window; the detailed entries may be a subset that fits `max_chars` (2000 to 60000), and the result states how many of how many. `topic` steers which episodes get detail and does not change which episodes are in the window. With no since/until the window is the user's entire history, which fits only as a timeline. Where the user heard only a small part of an episode the result flags it, because listening notes describe whole episodes. For one episode in depth use get_episode; for a specific fact use search_memory.

get_memory_digest

One episode in one call, whether the user heard all of it, part of it or none of it: title, show and duration; an overview of the whole episode, chapter by chapter with a one-line gist and a vo.fm link each, every chapter marked heard or not yet heard, plus where to pick up; how much the user heard; the moments they saved in it (up to 200, each with a vo.fm link); and the listening notes when they exist: the personal recap VO writes after the user finishes an episode, built around their saved moments and its key points. Use it to summarise an episode, to say what the user missed, or to judge whether it is worth a listen. Takes an episode id from list_listening_history, search_memory or search_catalog. `include` selects sections (overview, heard, moments, notes); the default is all four. For the exact words the user heard use get_heard_transcript.

get_episode

The exact words the user heard in one episode, joined from their listening spans (only the parts they played; get_episode covers the whole episode), each with its timestamp, its machine-attributed speaker and a vo.fm link. Takes an episode id from list_listening_history or search_catalog. Optional `speaker` filter (case-insensitive substring of the speaker name). Returned in parts of up to about 60,000 characters: when more remains, the result names the `from_seconds` for the next call.

get_heard_transcript

Episodes the user has listened to, ordered by when the user last listened (most recent first, not by publish date), with title, show, percent heard, last-heard date, whether it is in the user's Listen Later list, and a vo.fm link that resumes where they left off. Optional since/until window on the last-heard time, and a bookmarked_only filter (Listen Later is VO's bookmark). Paged: `limit` (default 50, max 200) and `offset`; the result states the total and names `next_offset` when more remain. Returns the episode ids that get_episode, get_heard_transcript and list_saved_moments take. For a period's content use get_memory_digest; for a topic use search_memory.

list_listening_history

The moments the user saved while listening in VO, newest first, across all episodes or for one `episode_id`, optionally within a since/until window of when they were saved. Each has the episode, timestamp, the gist, the words spoken around it when available, and a vo.fm link that plays that second. Paged: `limit` (default 50, max 200) and `offset`; the result names `next_offset` when more remain. No text filter: topic search over saved moments is search_memory with scope 'saved'.

list_saved_moments

Search what the user has listened to and saved in VO by topic. Returns evidence: passages the user heard and moments they saved, each with the episode, when the user heard or saved it, and a vo.fm link that plays that exact second. Semantic: matches meaning as well as keywords, across the user's whole history; only content the user actually heard is returned. Items marked LOOSE MATCH matched on meaning alone, with no keyword overlap. Optional filters: scope (all, listened, saved), since/until (when the user listened), episode_ids, people. Returns up to `limit` items (default 20, max 50), ranked by relevance. Needs a topic. For a period rather than a topic use get_memory_digest; for 'what did I listen to' use list_listening_history; to find episodes the user has not heard use search_catalog.

search_memory

Search the VO podcast catalog, which is not limited to what the user heard, for an episode, show, guest or topic. Returns episodes and podcasts by default; `types` can add key moments, the clips VO cuts inside catalog episodes (the same for everyone, not the user's saved moments). Up to `limit` results (default 10, max 50), ranked by relevance, each with its episode id or podcast id and a vo.fm link. The only tool that looks beyond the user's own listening. Its episode ids work with get_episode, which gives the gist of any episode, heard or not; get_heard_transcript returns words only for episodes the user has heard.

search_catalog

The VO account this connection is signed in as: name, email, when the account was created, and whether it has any listening yet. VO matches the connector sign-in to a VO account by email address.

whoami