Full-text search across OCR'd screen content.

Args: query: FTS5 match expression, e.g. invoice, "exact phrase", budget NEAR/5 forecast, sched*. start: Optional ISO 8601 local lower bound on frame time. end: Optional ISO 8601 local upper bound on frame time. bundle_ids: Optional allow-list of app bundle IDs to search within. limit: 1-100, default 20.

List capture segments (one contiguous stretch in one app window).

Args: start: Optional ISO 8601 local lower bound on segment start. end: Optional ISO 8601 local upper bound on segment start. bundle_id: Optional single app bundle ID to filter to. limit: 1-100, default 20.

Fetch one frame with its OCR text boxes and parent segment context.

Box geometry (leftX, topY, width, height) is expressed as normalised fractions of the frame, in the range 0.0-1.0 — not pixels. Multiply by the video's width/height to get pixel coordinates.

Args: frame_id: The frame's numeric id. limit: Max OCR node boxes to return, 1-100, default 20.

Time spent per app over a window, from summed segment durations.

Args: start: ISO 8601 local start of the window. end: ISO 8601 local end of the window. limit: 1-100, default 20.

List segment tags and how many (visible) segments carry each.

Args: limit: 1-100, default 20.

List segments carrying a given tag name.

Args: tag: Exact tag name, as returned by list_tags. limit: 1-100, default 20.