scheduleDashboardRefresh
Schedules automatic dashboard refreshes with a cron expression, shows next runs, or stops refresh for one page or all pages so dashboard data updates without an assistant open.
Instructions
Turns on, changes or stops the automatic refresh of a dashboard page. Use it only when the user
asks for it or says yes to the question of a dashboard prompt. A job in the scheduler of the
computer (launchd, cron or Task Scheduler) replaces the data of the page at the given times, also
with no assistant open. The refresh removes the coach notes, because old notes do not agree
with new data. The computer must be on at that time. The page must exist (writeDashboard first).
last is the last automatic run: its time, the pages that it could not update, with the error,
and in partial the pages that it updated with gaps. A page shows a note when its update is
more than 1 hour late: last tells why.
cron: convert what the user says, in any language, into a 5-field cron expression in local
time: minute hour day-of-month month weekday, numbers only (0 = Sunday), e.g. "0 7 * * 1-5" for
weekdays at 7. Two runs must be at least 1 hour apart. The cron is for all scheduled pages;
path adds that page (default the main page); off stops the refresh of path, or of every
page when no path is given. Without arguments it only reads. The reply has next, the next
runs in local time: tell them to the user in their language, so they can check the schedule.
Tool call template
This tool declares no required parameters. Add optional parameters from the input schema as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {},
"name": "scheduleDashboardRefresh"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| off | No | Stop the refresh | |
| cron | No | minute hour day-of-month month weekday, e.g. "0 7 * * *"; default 0 7 * * * | |
| path | No | The .html file; relative paths are inside the data dir |