Listen to Sadhu

Author List

List all authors.

Author Resolve

Find a author by name (fuzzy).

Document Get

Get a document (commentary/prose_chapter/letter) by id.

Document List

List documents at a reference / in a book. A verse's purport = document_list(source, tokens, kind:"commentary").

Excerpt Prepare

Generate (or fetch, if cached) the audio clip for a lecture passage and return its playable URL. This is the excerpt player's Play action — it is called for you by the player UI on demand. Agents should use excerpt_render to show the player, not call this directly. Idempotent: same track+window returns the same cached clip.

Excerpt Render

Let the user HEAR a lecture passage inline. Call this when the user wants to LISTEN to a specific moment in a track — e.g. from a search(types:["track"]) hit, pass its track_id plus start_ms/end_ms. Renders an inline audio player that generates the clip on demand (public share-audio, max 10 minutes).

Location List

List all locations.

Location Resolve

Find a location by name (fuzzy).

Media Render

Show/play an existing corpus VIDEO clip inline. Call this when the user wants to WATCH a clip found via search(types:["media"]) — pass the hit's media_id. Renders an inline video player.

Search

Semantic + lexical search over the corpus. Returns verses, documents, track passages and titles matching a natural-language query, each with the id needed to fetch the full record (verse_id→verse_get, document_id→document_get, track_id+start_ms/end_ms→transcript_window; media_id→media_render to play the clip). Every filter is optional. Use min_score to drop weak matches.

Source Get

Get one book by id or code ("source_…" or "BG"/"БГ").

Source List

List all books (Caitanya-caritāmṛta is three sources).

Source Resolve

Find a book by name (fuzzy): "gita", "бхагаватам", "CC Madhya".

Track Get

Get a track (lecture/conversation): metadata, cited references, transcript/pdf availability.

Track List

List tracks, filterable by reference (source[+tokens] = tracks citing it), author/location/kind/date/lang. No filter ⇒ recent tracks (date desc).

Transcript Window

Read a track's transcript around a time window (from a search track hit or track_list). Widen with pad_ms.

Verse Get

Fetch a verse's raw fields for your own reasoning (NOT for display — to show a verse to the user, use verse_render). Returns original script + transliteration as line arrays; with lang, also the canonical translation inline plus an `alternatives` manifest of other translation kinds in that language (fetch their text with verse_translation, word-by-word with verse_synonyms). Address by ref ("BG 2.13"), source+tokens, or verse id.

Verse List

List the verses of a book / chapter. Skips .0 chapter summaries; collapses merged verses into one item with a covers span.

Verse Render

Show a verse to the user. THE DEFAULT way to display/read a scripture verse: renders an inline card with the original script (centered), transliteration in the requested language, the word-by-word, and the translation — all at once. Use this whenever the user asks to see, read, open, or quote a specific verse ("покажи БГ 2.13", "read Bhagavad-gita 2.13"). The other verse_* tools are for fetching raw data; for DISPLAY prefer this one. Address by ref ("BG 2.13"), source+tokens, or id; lang sets th

Verse Synonyms

Fetch the word-by-word ("Synonyms") as a raw {word, meaning} array for one verse translation (data — verse_render already shows the word-by-word inside the card). Defaults to the canonical rendering; pass `kind` for an alternative.

Verse Translation

Fetch the text of ONE translation of a verse (data, not a card — to display a verse use verse_render). Defaults to the canonical (kind=canonical); pass a `kind` from verse_get's `alternatives` manifest to fetch a specific rendering.