Search Recording

search_recording

Search an index_recording timeline (screen text, events, markers, transcript): timecoded hits, best first, secrets masked. No frames unless asked.

watchread-onlyidempotentsince v0.46.0

00:00PARAMETERS

Name	Type	Description
`input`	`string`	Recording path.
`sessionId`	`string`	Or a stopped session id.
`query` required	`string`	Text; tolerates OCR misreads.
`regex`	`boolean`	query is a regex.
`limit`	`integer`	Max hits (default 10). ≥ 1, ≤ 50
`images`	`integer`	Thumbnails of the top N hits (default 0). ≥ 0, ≤ 20

00:05A MINIMAL CALL

search_recording { "query": "Save" }

The required arguments only, with placeholder values. Everything else takes its default.

00:10WHAT COMES BACK

Structured content (structuredContent), alongside a text summary:

Field	Type
`total` always	`number`
`hits` always	`any[]`