History & Personal Bests
timer_historyRead-onlyIdempotent
Access personal bests, recent sessions, and lifetime totals for timers. Filter by name and limit results to review progress.
Instructions
Personal bests, recent finished runs, and lifetime totals. Read-only.
Args:
name (string, optional): Filter to one timer name; omit for everything.
limit (number, default 10): Max recent sessions returned (1–50).
Returns: { bests: [{name, best_ms?, count, total_ms}], recent: [{id, name, elapsed_ms, formatted, pb, splits, stopped_wall, target_ms?, over_under_ms?}], lifetime_ms, lifetime_sessions }
Great for "what's my record?", "how much have I tracked today?", or building a leaderboard recap for the user.
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| name | No | Filter to one timer name | |
| limit | No | Max recent sessions |
Output Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| bests | Yes | ||
| recent | Yes | ||
| lifetime_ms | Yes | ||
| lifetime_sessions | Yes |