Find quotes and clip moments

search finds the passage; transcript with start and end returns the exact lines around it with second offsets, which give the verbatim quote and the clip boundaries.

Run each program with arcmira_execute_read; arcmira_describe has the method reference.

When to use

• find a quote, with the source and a timestamp
• the moment a show talked about a topic, to clip or cite
• what a specific person said about a topic, in their words

Pick the entity the user meant

Users give names; filters take ids only (ent_..., UC..., 11-character video ids), and a name where an id belongs throws id_required.

1. Resolve the exact name the user said, with their own words about it as context (a bare "Theo" has none).
2. best and suggested give the id. A suggested pick is an assumption: the answer names it, with suggested.evidence as the reason.
3. ask: several entities fit, and ask.options goes back to the user. No answer at all: the name is not in the index.