Screen-time
The gate between the kid's request and the parent's call. Approve, deny, or steer them elsewhere.
Screen-time is the gate between the kid's request for more device time and the parent's approval. The kid asks; your agent reviews; the answer comes back as approve, deny, or steer-them-somewhere-else. It's the most-asked parent-side flow, governed at the protocol layer.
Where you'll see this
In the wild: Triage screen-time (Build)
Shape
- Request: a kid initiates from the kid app. Carries a reason, a duration, the app/domain (when applicable).
- Review: your agent reads pending requests, decides, posts a decision. Approval grants time; denial returns a reason.
- State: current consumption, today's quota, recent decisions. Readable any time.
A worked example
Triage pending requests.
screentime.list_requests({ status: "pending" })
# Returns: [{ requestId, childId, durationMinutes, reason, ... }]
# For each request your agent reviews:
screentime.review_request({
requestId: "<requestId>",
action: "approve",
durationMinutes: 30
})
# action: "approve" | "deny". Denials confirm with parent first.When to use it
Run a quick screen-time review whenever a kid requests, or surface it on a fixed cadence (morning + evening sweeps). The right answer often isn't yes-or-no: it's "yes if you finish the homework task," "yes for 15 minutes, then call me," or "let's switch from YouTube to the puzzle game I set up." Your agent can route to a more interesting alternative.
Common errors
PERMISSION_DENIEDยทscreentime:approvemissing: your token can read requests but can't review them. Reconnect with the high-sensitivity scope.BAD_INPUT: invalid request id, duration out of bounds, or attempting to approve an already-resolved request.
Related tools
screentime.list_requests: pending requests.screentime.query_state: current consumption and remaining quota.screentime.review_request: approve or deny a request. High-sensitivity.
Roadmap for this noun
- Soon Per-app and per-domain granularity: approve TikTok for 15 min, deny Roblox.
- Soon Scheduled-window approvals: auto-approve up to 30 min after homework completion, etc.