Merge remote-tracking branch 'origin/main'

Author: gersham

assets/playlist-write-v2.schema.json

@@ -1,5 +1,5 @@
 {
-  "$comment": "Generated by screenrig-protocol-gen from api/openapi.yaml; sha256=5ef79df8b0c254905e5ea4aa43d8921e1c3470ced2cd440c418376d8e9d2ce0e. 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=30fc492b905cf3c69f8b5972c19af58b38f04e3d5059e36fc123d62816601c93. 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=5ef79df8b0c254905e5ea4aa43d8921e1c3470ced2cd440c418376d8e9d2ce0e. 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=30fc492b905cf3c69f8b5972c19af58b38f04e3d5059e36fc123d62816601c93. 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.",

contracts.sha256

@@ -1,8 +1,8 @@
-a3f1d0147ca522533c5314467e1dda6f6bf6ad723bedce253451a2fbec90e4c9  assets/playlist-write-v2.schema.json
-45e683d0a9118c9235dc6ac7d2e6421110ac6ce86eccfa208223b113353d97fa  assets/playlist-write.schema.json
+eac70bfe83a4524425d96d92826a803b30d9adc72c5974cb62c513c20337cc4a  assets/playlist-write-v2.schema.json
+57c92a960074c9fc2c0508e9851fa58cef657d39a258fca44fc67e42df316210  assets/playlist-write.schema.json
 196c14344083df520e4dc3a87e3ac13dfa451980281d6b125bee00d70f445b68  assets/screenrig.runtime.js
-0e67f6100416d3b6785b44b5004d22ab2d9e8dd3c5a68f13caa5275d3041374d  contracts.source
+9b3f11eb78fb31cb318e1bd841e4545e30018ebd352f2ab364a1c14abfb4cee9  contracts.source
 793525dd0551533ec1730fbd3a8561189f819895a11b95b7c703383d2abc3eb1  src/generated/playlist-write-semantics.ts
 30d91e0b855e59700dee5de38922a2c807b8bff15ccc3317612b7de8ad8ec4e5  src/generated/resource-ids.ts
-bdada479b83fe09121e7a3a3bb98f6bddb08077b3ef16c91b7447ec55f98d23b  vendor/openapi.yaml
-5a7917f5bd6a154e9adefb2d4bad3b4d8038f2ba5c7dcd1358ed839997754d36  vendor/protocol/openapi.gen.ts
+28e4f0dcf6864b2dbfbfbb328b16bcae253eb790ccccb1b6d90e1caf6048d001  vendor/openapi.yaml
+eb4d245df04e48881bc57ada645e29b108ecffaf7815265e1a979be0bedc88a5  vendor/protocol/openapi.gen.ts

contracts.source

@@ -1 +1 @@
-backend 0b02cbc0c04119b4f22aa6f20c9b894bfd99fe1d
+backend 4319691a180611e4eeb3152dcf5547a957bbed5b

src/adapters/protocol.ts

@@ -583,9 +583,61 @@ export interface ScreenDisplayScheduleView {
   display?: ScreenDisplay;
 }
 
+/** sent: the screen was online and its Player was handed the command at once. queued: the screen was offline; the command is sent when it comes online before expires_at. */
+export type ScreenCommandDelivery = "queued" | "sent";
+
 export interface ScreenRebootAccepted {
   reboot_id: string;
   expires_at: string;
+  state: ScreenCommandDelivery;
+}
+
+/** The optional body of POST /api/screens/{id}/reboot and /reload: how long the command stays actionable, 60 to 86400 seconds (default 86400). */
+export interface ScreenCommandWrite {
+  expires_in_s?: number;
+}
+
+/**
+ * One reboot or reload asked of a screen, in Screen.commands (oldest first, at
+ * most 10). expired is derived by the server on read for a queued command past
+ * expires_at; a reload never reaches done.
+ */
+export interface ScreenCommand {
+  id: string;
+  type: "reboot" | "reload";
+  state: "queued" | "sent" | "done" | "expired" | "cancelled" | "superseded";
+  requested_at: string;
+  expires_at: string;
+  sent_at?: string;
+  done_at?: string;
+}
+
+/** Screen.suspension: present while the screen shows a notice instead of its content. */
+export interface ScreenSuspension {
+  message: string;
+  since: string;
+}
+
+/** Write body for POST /api/screens/{id}/identify; duration_ms is omitted so the server can default it (60000). */
+export interface ScreenIdentifyWrite {
+  duration_ms?: number;
+}
+
+/** Accepted POST /api/screens/{id}/identify. A Player acts on one identify_id at most once and ignores it after expires_at. */
+export interface ScreenIdentifyAccepted {
+  identify_id: string;
+  duration_ms: number;
+  expires_at: string;
+}
+
+/** Write body for POST /api/screens/{id}/suspend. */
+export interface ScreenSuspendWrite {
+  message: string;
+}
+
+/** Write body for POST /api/screens/{id}/replace: the screen whose paired device takes over the screen in the path. */
+export interface ScreenReplaceWrite {
+  with: string;
 }
 
 /** Write body for POST /api/screens/{id}/play-page. */
@@ -708,14 +760,21 @@ export interface Screen {
   recovery_pending?: ScreenRecoveryPending;
   /**
    * Present only while archived: what archived the screen. Known values are
-   * project, device_reset, and device_unpair; readers keep a value they do
-   * not know. Every reason keeps the device binding, so unarchive resumes the
-   * display with no re-pairing. Absent on screens archived before reasons
-   * were recorded. Read-only.
+   * project, device_reset, device_unpair, and replaced; readers keep a value
+   * they do not know. Every reason but replaced keeps the device binding, so
+   * unarchive resumes the display with no re-pairing; a replaced screen keeps
+   * none and is deleted, not restored. Absent on screens archived before
+   * reasons were recorded. Read-only.
    */
   archive_reason?: string;
   /** Present only while archived with archive_reason. Instant the screen was archived. Read-only. */
   archived_at?: string;
+  /** Present when archive_reason is replaced: the screen this screen's device moved to (screen replace). Read-only. */
+  replaced_by?: string;
+  /** The reboots and reloads asked of this screen, oldest first, at most 10. Absent when it has none. Read-only: screen reboot and reload add to it, screen command cancel cancels a queued entry. */
+  commands?: ScreenCommand[];
+  /** Present while the screen shows a notice instead of its content (screen suspend). Read-only. */
+  suspension?: ScreenSuspension;
   /**
    * Present while the paired Player cannot show the application or iframe
    * primitives its manifest carries. at is when the condition began. The
@@ -808,7 +867,7 @@ export type ScreenActionSelector =
 /** One fleet action, discriminated by type. New action types are additive. */
 export type ScreenAction =
   | { type: "assign"; playlist_id: string }
-  | { type: "reload" }
+  | ({ type: "reload" } & ScreenCommandWrite)
   | ({ type: "toast" } & ScreenToastWrite)
   | { type: "set_tags"; tags: ScreenTags }
   | { type: "add_tags"; tags: string[] }
@@ -817,7 +876,7 @@ export type ScreenAction =
   | { type: "takeover_clear" }
   | { type: "set_playlist_schedule"; entries: ScreenScheduleEntryWrite[] }
   | { type: "clear_playlist_schedule" }
-  | { type: "reboot" }
+  | ({ type: "reboot" } & ScreenCommandWrite)
   | { type: "display"; power: "on" | "off"; until?: string | null }
   | { type: "display_clear" }
   | { type: "set_display_schedule"; enabled: boolean; windows: ScreenScheduleWindow[] }
@@ -906,6 +965,7 @@ export interface ScreenToastAccepted {
 export interface ScreenReloadAccepted {
   reload_id: string;
   expires_at: string;
+  state: ScreenCommandDelivery;
 }
 
 /** shot_ plus 16 to 64 unpadded base64url characters. */