today (Soon): Reference

The resource

URI: sprout://child/{childId}/today

Required scope: task:read

The kid's today view: tasks for today, their statuses, current screen-time state. Soon Subscribers will receive a push whenever a task lands on today, gets completed, or gets reviewed.

When it pushes

A new task lands on the kid's today list (one-off or schedule fire).
The kid completes a task.
A parent reviews (approves or denies) a completed task.
A task is rescheduled into or out of today.

Push payload

The notification frame on the SSE stream:

JSON-RPC

{
  "jsonrpc": "2.0",
  "method": "notifications/resources/updated",
  "params": { "uri": "sprout://child//today" }
}

The frame only names the URI that changed. To get the new state, your agent calls resources/read <uri>.

Read shape

Calling resources/read sprout://child/{childId}/today returns:

JSON

{
  "childId": "uuid",
  "date": "2026-05-23",
  "tasks": [
    { "taskId": "uuid", "name": "Daily check-in", "status": "open" | "completed" | "reviewed", "startMinutes": 1020 }
  ],
  "screenTime": { "consumedMinutes": 25, "remainingMinutes": 35 }
}

Subscribe / unsubscribe

Shell

resources/subscribe sprout://child/{childId}/today
# ... server holds the SSE stream open, pushes on every change ...
resources/unsubscribe sprout://child/{childId}/today

Notes

Coming soon.