Re-vendor the contract and say the Player reloads once.

screen reload no longer mentions a reload grant. The vendored OpenAPI includes the current reload description and the runtime screen-label route.

Author: gersham

README.md

@@ -212,8 +212,8 @@ screenrig screen unarchive scr_LOBBY
 `screen reload` asks a screen's player to reload once and returns a
 `reload_id` and `expires_at` ten minutes later. A web player reloads at its
 next page boundary; a native player reconnects, refetches its manifest, and
-checks for an update. Only a player that registered reload support acts on it,
-and a player ignores a reload within ten minutes of the last one it acted on.
+checks for an update. The Player reloads once, and ignores a reload within
+ten minutes of the last one it acted on.
 It works on active and archived screens and does not change the screen
 revision; a screen still waiting to pair answers `resource_conflict`.
 

assets/playlist-write-v2.schema.json

@@ -1,5 +1,5 @@
 {
-  "$comment": "Generated by screenrig-protocol-gen from api/openapi.yaml; sha256=e23482fb68e67eced6ea15f19b6c55f595349e0687535dc991e953708ab12631. 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=0fc1acc2d940c07e1d80d1edd24ca0316d574a33c321d1151bc8e06d1be938ca. 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=e23482fb68e67eced6ea15f19b6c55f595349e0687535dc991e953708ab12631. 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=0fc1acc2d940c07e1d80d1edd24ca0316d574a33c321d1151bc8e06d1be938ca. 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/cli-commands/guidance.ts

@@ -128,7 +128,7 @@ export function registerGuidance(root: Command): void {
     "screen show": "An archived screen shows archive_reason and archived_at when the server reports them: account (an account or dashboard archive), device_reset (the player was reset on the display), or device_unpair (a paired browser unpaired itself). Every archive keeps the display's binding, so screen unarchive re-admits the same key and a display that still holds it resumes with no re-pairing. A display reset on the device may start pairing with a new key; that pairing can appear here as recovery_pending, and screen recover moves this screen to the new key (the screen stays archived until screen unarchive). applications_unsupported means the paired player cannot show application or iframe primitives; its manifest is unchanged and the player skips them.",
     "screen archive": "Archiving removes the screen from the default list, releases its screen quota, and darkens the display, but keeps the display's binding: the player stays connected, never re-pairs, and resumes on screen unarchive. Whoever holds the display's key can still connect while it is archived. To retire hardware for good, leave the screen archived or move the screen to new hardware with screen recover, which retires the old key.",
     "screen unarchive": "Restores a screen archived for any reason, including one archived because its player was reset on the display (device_reset) or a paired browser unpaired itself (device_unpair). It re-admits the same display key, so a display that still holds it resumes with no re-pairing; the screen must still fit the account's screen quota. A key retired by a confirmed screen recover stays retired.",
-    "screen reload": "Sends the screen's player one reload request, valid for ten minutes, and returns its reload_id and expires_at. A web player reloads at its next page boundary; a native player reconnects, refetches its manifest, and checks for an update. Only a player that registered reload support acts on it, and a player ignores a reload within ten minutes of the last one it acted on. Works on active and archived screens; a screen still waiting to pair answers resource_conflict. The screen revision does not change. Repeat with the same --idempotency-key to get the original reload_id back instead of sending another.",
+    "screen reload": "Sends the screen's player one reload request, valid for ten minutes, and returns its reload_id and expires_at. A web player reloads at its next page boundary; a native player reconnects, refetches its manifest, and checks for an update. A player ignores a reload within ten minutes of the last one it acted on. Works on active and archived screens; a screen still waiting to pair answers resource_conflict. The screen revision does not change. Repeat with the same --idempotency-key to get the original reload_id back instead of sending another.",
     "screen screenshot": "Requests, waits for, and downloads a screenshot. Default wait is 35000 ms and polling interval is 500 ms. Stdout reports the saved path, never image bytes. Inspect the downloaded image to assess playback.",
     "kv get": "Returns bytes as data.value_base64, including JSON values. Decode base64 and parse JSON only when data.content_type indicates JSON. kv list omits values.",
     "kv set": "--json-value encodes JSON directly. --file reads a local file or stdin with -; --value-base64 accepts canonical padded base64, including empty bytes. Byte modes default to application/octet-stream; --content-type overrides it. JSON mode also accepts an explicit application/json. Omit --expect-rev to create or overwrite; supply it to reject concurrent changes.",

src/cli.test.ts

@@ -5783,7 +5783,7 @@ test("screen reload posts the reload route with an idempotency key and returns r
     assert.equal(guarded.code, ExitCode.Success, guarded.stdout);
     assert.equal(reloadCalls().at(-1)?.headers?.["if-match"], `"${archivedScreen.revision}"`);
     assert.match(guarded.stdout, /^Reload accepted\nscreen_id: scr_PAIRINGAAAAAAAAAAAAAAAA\nreload_id: \S+\nexpires_at: 2026-08-14T17:10:00\.000Z\n/);
-    assert.match(guarded.stdout, /granted reload-v1/);
+    assert.match(guarded.stdout, /The Player reloads once/);
 
     const stale = await withRuntime(
       ["--json", "screen", "reload", "scr_PAIRINGAAAAAAAAAAAAAAAA", "--expect-rev", String(archivedScreen.revision - 1)],

src/commands.ts

@@ -4310,7 +4310,7 @@ export const handleScreenReload = commandHandler(async (args, runtime, resolved)
         ["reload_id", accepted.reload_id],
         ["expires_at", accepted.expires_at],
       ]),
-      "A Player granted reload-v1 reloads once; a Player without the grant, or one that reloaded in the last ten minutes, ignores it.",
+      "The Player reloads once; a Player that reloaded in the last ten minutes ignores it.",
     ].join("\n"),
   };
 }, true);

vendor/manifest.json

@@ -12,13 +12,13 @@
       "path": "assets/playlist-write.schema.json",
       "source": "packages/protocol/schema/playlist-write.schema.json",
       "bytes": 25438,
-      "sha256": "913551056ef0e0123814e84571efc87c98a9cb804f84354cc1842bb68c7d6227"
+      "sha256": "bff02c544c8840d2baff25dfd57a89c628f64037e4d9861088498504a6106f6e"
     },
     {
       "path": "assets/playlist-write-v2.schema.json",
       "source": "packages/protocol/schema/playlist-write-v2.schema.json",
       "bytes": 26480,
-      "sha256": "e75b142235ee0782fabd3af709faff1a69766838d5b3f9d1a292f0eac309391e"
+      "sha256": "d6d34d9738db10e371a39c04865967131b44c032475b2f2311f3062139216657"
     },
     {
       "path": "src/generated/playlist-write-semantics.ts",
@@ -29,14 +29,14 @@
     {
       "path": "vendor/protocol/openapi.gen.ts",
       "source": "packages/protocol/src/openapi.gen.ts",
-      "bytes": 72814,
-      "sha256": "31dcb5275264b3d39a02d838f936efd79b7543c72602b4de0e9a561cb99ecbef"
+      "bytes": 73078,
+      "sha256": "1317cef5e245f4b76aa50f86fa9faa5caeb75ed0a6cec2547b478864522b81b7"
     },
     {
       "path": "vendor/openapi.yaml",
       "source": "api/openapi.yaml",
-      "bytes": 474702,
-      "sha256": "e23482fb68e67eced6ea15f19b6c55f595349e0687535dc991e953708ab12631"
+      "bytes": 476356,
+      "sha256": "0fc1acc2d940c07e1d80d1edd24ca0316d574a33c321d1151bc8e06d1be938ca"
     },
     {
       "path": "assets/screenrig.runtime.js",