scheduleDashboardRefresh
Schedules, changes or stops automatic dashboard data refreshes with a cron expression, even when no assistant is running. Cron runs replace page data at set times and clear outdated coach notes.
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 |