Add reboot and display power control

screen reboot (fleet requires --yes; reboot_unsupported explained),
screen display --power on|off [--until|--for] and screen display clear,
screen display-schedule show|set|clear, Display lines in screen show,
and screen.reboot_requested / screen.display_changed rendering.
Vendored from backend deaf865.

Co-Authored-By: Claude Opus 5.5 (1M context) <noreply@anthropic.com>

Author: gersham

README.md

@@ -422,6 +422,64 @@ cleared, and `reason`), and `screen.takeover_ended` (`reason`
 `screen.playlist_unavailable` (`playlist_id`, `entry_ids` comma-joined, and `code`
 `playlist_deleted|playlist_unavailable`).
 
+## Reboot and display power
+
+```sh
+screenrig screen reboot scr_LOBBY [--expect-rev REVISION]
+screenrig screen reboot scr_A scr_B --yes
+screenrig screen reboot --tag Lobby --yes
+screenrig screen display scr_LOBBY --power off [--until RFC3339 | --for 2h] [--expect-rev REVISION]
+screenrig screen display --tag Lobby --power on
+screenrig screen display clear scr_LOBBY [--expect-rev REVISION]
+screenrig screen display clear --tag Lobby
+screenrig screen display-schedule show scr_LOBBY
+screenrig screen display-schedule set scr_LOBBY --file hours.json [--expect-rev REVISION]
+screenrig screen display-schedule set --tag Cafe --file hours.json
+screenrig screen display-schedule clear scr_LOBBY
+```
+
+`screen reboot` asks the Player to reboot the device. Only a Player that
+declares the `reboot` capability in its host report receives it; `screen show`
+lists the host capabilities. Any other screen is refused with
+`reboot_unsupported` (exit 5) and nothing is sent; `screen reload` refreshes
+content without a device reboot. A reboot request expires after ten minutes,
+and each screen accepts at most 2 reboots per 10 minutes. A refused or failed
+request and an exact replay of the same request do not count. The CLI never
+prompts, so rebooting several ids or a `--tag` fleet requires `--yes`.
+
+`screen display` turns the display on or off now, as a manual override of the
+display schedule. `--power on|off` sets it (a trailing `on` or `off` after the
+ids is the same). `--until` takes a strict RFC 3339 instant, strictly in the
+future and at most 7 days ahead; `--for` takes a duration up to `6d23h59m`.
+Without either, the override ends at the display schedule's next boundary. A
+later display-schedule change or a timezone change moves that end to the new
+next boundary. With no schedule boundary in the next eight days (for example,
+no enabled schedule), the override holds until `screen display clear` or a
+replacement. `screen display clear` ends the override, so the display schedule
+applies again (without one, the display is on). The Player applies every change
+at once and reports what it achieved. A screen that is still waiting to pair
+answers `resource_conflict` (exit 5): it has no paired Player yet, though a
+display schedule can be set before pairing.
+
+A display schedule lists 1 to 16 windows when the display is ON, in the screen
+timezone (set one first with `screen set-timezone`). Outside every window the
+display goes to standby. The device evaluates it offline.
+
+```json
+{"enabled": true, "windows": [{"days": ["mon", "tue", "wed", "thu", "fri"], "start": "07:00", "end": "19:00"}, {"days": ["sat"]}]}
+```
+
+A window whose `end` is at or before its `start` crosses midnight; a window
+without `start` and `end` covers the whole day. `enabled: false` keeps the
+windows and leaves the display on. The saved output of `display-schedule show`
+can be edited and sent back with `set --file`.
+
+`screen show --human` prints `Display:` with the requested power, its source
+(manual override, display schedule, or default) and until when in the screen
+timezone, the schedule windows, and the power the Player reported, marked stale
+after 15 minutes without a report. `events list` prints
+`screen.reboot_requested` and `screen.display_changed`.
+
 ## Webhooks
 
 A webhook POSTs this project's own durable events to an HTTPS endpoint you

assets/playlist-write-v2.schema.json

@@ -1,5 +1,5 @@
 {
-  "$comment": "Generated by screenrig-protocol-gen from api/openapi.yaml; sha256=ec469ae74ca9fe82bacdd314fb67fc57b6b6d124fdba3584dbf75ae7c5b3808d. Shape validation for the adslot page union. Run canonical playlist-write-semantics.ts next. At most 16 adslot pages and one ordinary page with no visibility remain server checks.",
+  "$comment": "Generated by screenrig-protocol-gen from api/openapi.yaml; sha256=6c916f85a19b7573dfa7af37d242a83eae074d5f924bc16230b937e25af58efe. Shape validation for the adslot page union. Run canonical playlist-write-semantics.ts next. At most 16 adslot pages and one ordinary page with no visibility remain server checks.",
   "$defs": {
     "AdslotPageWrite": {
       "additionalProperties": false,

assets/playlist-write.schema.json

@@ -1,5 +1,5 @@
 {
-  "$comment": "Generated by screenrig-protocol-gen from api/openapi.yaml; sha256=ec469ae74ca9fe82bacdd314fb67fc57b6b6d124fdba3584dbf75ae7c5b3808d. Shape validation only; run canonical playlist-write-semantics.ts next. Reference resolution and DNS remain server checks.",
+  "$comment": "Generated by screenrig-protocol-gen from api/openapi.yaml; sha256=6c916f85a19b7573dfa7af37d242a83eae074d5f924bc16230b937e25af58efe. Shape validation only; run canonical playlist-write-semantics.ts next. Reference resolution and DNS remain server checks.",
   "$defs": {
     "CanvasBackground": {
       "description": "Solid canonical uppercase #RRGGBBAA, or a top-to-bottom linear gradient.",

src/adapters/protocol.ts

@@ -540,6 +540,40 @@ export interface ScreenHealth {
   renderer_restarts_24h?: number;
 }
 
+export interface ScreenDisplaySchedule {
+  enabled: boolean;
+  windows: ScreenScheduleWindow[];
+  updated_at: string;
+}
+
+export interface ScreenDisplayOverride {
+  override_id: string;
+  power: "on" | "off";
+  until: string | null;
+  ends_at: string | null;
+  set_at: string;
+}
+
+/** Screen.display: requested power now, why, until when, and the Player's reported power. */
+export interface ScreenDisplay {
+  requested: "on" | "off";
+  source: "override" | "schedule" | "default";
+  until?: string;
+  schedule?: ScreenDisplaySchedule;
+  override?: ScreenDisplayOverride;
+  reported?: { power?: "on" | "off" | "standby" | "unknown"; connected?: boolean; reported_at: string; stale: boolean };
+}
+
+export interface ScreenDisplayScheduleView {
+  display_schedule: ScreenDisplaySchedule | null;
+  display?: ScreenDisplay;
+}
+
+export interface ScreenRebootAccepted {
+  reboot_id: string;
+  expires_at: string;
+}
+
 export interface Screen {
   content_access_generation: number;
   created_at: string;
@@ -608,6 +642,7 @@ export interface Screen {
    */
   storage?: ScreenStorage;
   health?: ScreenHealth;
+  display?: ScreenDisplay;
   /**
    * Approximate steady-state target selection (no transition) from the last
    * reported capacity and the screen's desired manifest. Absent without a
@@ -669,7 +704,12 @@ export type ScreenAction =
   | { type: "takeover"; playlist_id: string; until?: string | null; reason?: string }
   | { type: "takeover_clear" }
   | { type: "set_playlist_schedule"; entries: ScreenScheduleEntryWrite[] }
-  | { type: "clear_playlist_schedule" };
+  | { type: "clear_playlist_schedule" }
+  | { type: "reboot" }
+  | { type: "display"; power: "on" | "off"; until?: string | null }
+  | { type: "display_clear" }
+  | { type: "set_display_schedule"; enabled: boolean; windows: ScreenScheduleWindow[] }
+  | { type: "clear_display_schedule" };
 
 export type ScreenActionType = ScreenAction["type"];
 
@@ -686,6 +726,7 @@ export interface ScreenActionScreenResult {
   tags?: string[];
   reload?: ScreenReloadAccepted;
   toast?: ScreenToastAccepted;
+  reboot?: ScreenRebootAccepted;
   problem?: { type?: string; title?: string; status?: number; detail?: string; code?: string; [key: string]: unknown };
 }
 

src/cli-commands/screen.ts

@@ -2,8 +2,9 @@ import { addValueAlias } from "./aliases.js";
 import { addCommandExamples, addCommandNotes, requireOptionGroup } from "./notes.js";
 import { positiveInteger, revision, screenTagOption, screenTagListOption, toastDuration } from "./options.js";
 import type { CommandActionBinder } from "./types.js";
-import { handleScreenPublish, handleScreenPair, handleScreenProvision, handleScreenUpdate, handleScreenList, handleScreenShow, handleScreenStorageForecast, handleScreenAssign, handleScreenSetTimezone, handleScreenArchive, handleScreenUnarchive, handleScreenDelete, handleScreenRotatePublicId, handleScreenRecover, handleScreenReload, handleScreenToast, handleScreenScreenshot, handleScreenTag, handleScreenScheduleShow, handleScreenScheduleSet, handleScreenScheduleClear, handleScreenTakeover, handleScreenTakeoverClear } from "../commands.js";
+import { handleScreenPublish, handleScreenPair, handleScreenProvision, handleScreenUpdate, handleScreenList, handleScreenShow, handleScreenStorageForecast, handleScreenAssign, handleScreenSetTimezone, handleScreenArchive, handleScreenUnarchive, handleScreenDelete, handleScreenRotatePublicId, handleScreenRecover, handleScreenReload, handleScreenToast, handleScreenScreenshot, handleScreenTag, handleScreenScheduleShow, handleScreenScheduleSet, handleScreenScheduleClear, handleScreenTakeover, handleScreenTakeoverClear, handleScreenReboot, handleScreenDisplay, handleScreenDisplayClear, handleScreenDisplayScheduleShow, handleScreenDisplayScheduleSet, handleScreenDisplayScheduleClear } from "../commands.js";
 import { durationOption, takeoverReason, takeoverUntilOption } from "../screen-control.js";
+import { untilOption } from "../screen-display.js";
 import { type Command, Option } from "commander";
 
 export function registerScreenCommands(root: Command, bind: CommandActionBinder): void {
@@ -162,6 +163,54 @@ export function registerScreenCommands(root: Command, bind: CommandActionBinder)
     "screenrig screen takeover scr_A scr_B --playlist-id pl_NOTICE --until none");
   addCommandExamples(takeover.commands.find((command) => command.name() === "clear")!,
     "screenrig screen takeover clear scr_LOBBY", "screenrig screen takeover clear --tag Lobby");
+  const reboot = screen.command("reboot").description("Reboot a screen's device, or a fleet's devices")
+    .argument("[id...]", "Screen identifier; several ids target those screens in one fleet request")
+    .option("--tag <TAG>", "Target every active screen carrying this tag", screenTagOption)
+    .option("--yes", "Confirm a reboot of several screens or --tag (required for a fleet)")
+    .option("--expect-rev <REVISION>", "Optionally require this screen revision (one screen id only)", revision)
+    .action(bind(handleScreenReboot));
+  addCommandNotes(reboot, "Reboot:\n  The Player reboots the device, not just itself. Only a Player that declares\n  the reboot capability in its host report receives it; any other screen is\n  refused with reboot_unsupported (exit 5) and nothing is sent. The request\n  expires after ten minutes, and each screen accepts at most 2 reboots per 10\n  minutes; a refused or failed request and an exact replay spend none. A\n  fleet (several ids or --tag) requires --yes: the CLI never prompts.");
+  addCommandExamples(reboot, "screenrig screen reboot scr_LOBBY", "screenrig screen reboot --tag Lobby --yes");
+
+  const displayGroup = screen.command("display").description("Turn a screen's display on or off now, or clear that override");
+  const display = displayGroup.command("set", { isDefault: true }).description("Turn a screen's display, or a fleet's displays, on or off now (default: screen display ID --power on|off)")
+    .argument("[id...]", "Screen identifier; several ids target those screens in one fleet request; a trailing on|off sets the power")
+    .option("--tag <TAG>", "Target every active screen carrying this tag", screenTagOption)
+    .addOption(new Option("--power <POWER>", "on or off").choices(["on", "off"]))
+    .addOption(new Option("--until <TIME>", "End at this RFC 3339 instant (strictly future, at most 7 days ahead)").argParser(untilOption).conflicts(["for"]))
+    .addOption(new Option("--for <DURATION>", "End after this duration, such as 30m, 2h, or 3d (at most 6d23h59m)").argParser(durationOption).conflicts(["until"]))
+    .option("--expect-rev <REVISION>", "Optionally require this screen revision (one screen id only)", revision)
+    .action(bind(handleScreenDisplay));
+  addCommandNotes(display, "Display power:\n  A manual override of the display schedule. Without --until or --for it ends\n  at the display schedule's next boundary; a later display-schedule change or\n  timezone change moves that end to the new next boundary. With no schedule\n  boundary in the next eight days (no enabled schedule) it holds until\n  screen display clear or a replacement. The Player applies it at once and\n  reports what it achieved (screen show: Display reported). At most 10\n  display changes per screen per minute; refusals and replays spend none.");
+  addCommandExamples(display, "screenrig screen display scr_LOBBY --power off --for 2h", "screenrig screen display --tag Lobby --power on", "screenrig screen display scr_A scr_B --power off --until 2026-10-01T07:00:00Z");
+  const displayClear = displayGroup.command("clear").description("End the manual display override on a screen or a fleet; the schedule (else on) applies again")
+    .argument("[id...]", "Screen identifier; several ids target those screens in one fleet request")
+    .option("--tag <TAG>", "Target every active screen carrying this tag", screenTagOption)
+    .option("--expect-rev <REVISION>", "Optionally require this screen revision (one screen id only)", revision)
+    .action(bind(handleScreenDisplayClear));
+  addCommandExamples(displayClear, "screenrig screen display clear scr_LOBBY", "screenrig screen display clear --tag Lobby");
+
+  const displaySchedule = screen.command("display-schedule").description("Show, set, or clear when a screen's display is on");
+  displaySchedule.command("show").description("Show a screen's display schedule and its display state")
+    .argument("<id>", "Screen identifier")
+    .action(bind(handleScreenDisplayScheduleShow));
+  displaySchedule.command("set").description("Replace the display schedule on a screen or a fleet of screens")
+    .argument("[id...]", "Screen identifier; several ids target those screens in one fleet request")
+    .option("--tag <TAG>", "Target every active screen carrying this tag", screenTagOption)
+    .requiredOption("--file <FILE>", "Display schedule JSON {\"enabled\": true, \"windows\": [...]}, or - for stdin (required)")
+    .option("--expect-rev <REVISION>", "Optionally require this screen revision (one screen id only)", revision)
+    .action(bind(handleScreenDisplayScheduleSet));
+  displaySchedule.command("clear").description("Remove the display schedule from a screen or a fleet of screens")
+    .argument("[id...]", "Screen identifier; several ids target those screens in one fleet request")
+    .option("--tag <TAG>", "Target every active screen carrying this tag", screenTagOption)
+    .option("--expect-rev <REVISION>", "Optionally require this screen revision (one screen id only)", revision)
+    .action(bind(handleScreenDisplayScheduleClear));
+  addCommandNotes(displaySchedule, "Display schedule:\n  1 to 16 windows when the display is ON, in the screen timezone (required):\n  {\"enabled\": true, \"windows\": [{\"days\": [\"mon\",\"tue\"], \"start\": \"07:00\", \"end\": \"19:00\"}]}.\n  end <= start crosses midnight; omit start and end for the whole day. Outside\n  every window the display goes to standby. enabled false keeps the windows and\n  leaves the display on. The device evaluates it offline.");
+  addCommandExamples(displaySchedule.commands.find((command) => command.name() === "show")!, "screenrig screen display-schedule show scr_LOBBY");
+  addCommandExamples(displaySchedule.commands.find((command) => command.name() === "set")!,
+    "screenrig screen display-schedule set scr_LOBBY --file hours.json", "screenrig screen display-schedule set --tag Cafe --file hours.json");
+  addCommandExamples(displaySchedule.commands.find((command) => command.name() === "clear")!,
+    "screenrig screen display-schedule clear scr_LOBBY", "screenrig screen display-schedule clear --tag Cafe");
   for (const name of ["pair", "provision"]) addValueAlias(screen.commands.find(command => command.name() === name)!, "--name", "--label", "Set the screen name");
   requireOptionGroup(screen.commands.find(command => command.name() === "update")!, "atLeastOne", ["--name", "--playlist-id", "--timezone"]);
 }