Add demo script sample payloads

Co-authored-by: Codex <codex@openai.com>

SUBMISSION.md

@@ -44,7 +44,8 @@ The prototype is designed for a live hackathon demo: every model-facing path has
 - `/api/demo-script`: repeatable judge runbook and API checks.
 - `/api/image-descriptions`: generated article image descriptions for reader mode.
 
+The POST checks in `/api/demo-script` include sample JSON bodies for `/api/reader-brain` and `/api/speak`.
+
 ## Reliability notes
 
 The demo remains navigable when local models are unavailable. The reader brain falls back to deterministic narration, image descriptions fall back to cached alt text, speech falls back to browser speech plus transcript, and generated images fall back to bundled article assets. Fallback states are labeled instead of hidden.
-

app.py

@@ -240,8 +240,27 @@ def demo_script_core() -> dict[str, Any]:
             {"method": "GET", "path": "/api/runtime-status", "expect": "online or fallback-ready runtime labels"},
             {"method": "GET", "path": "/api/accessibility-audit", "expect": "all reader-mode checks pass"},
             {"method": "GET", "path": "/api/image-descriptions", "expect": "three article image descriptions"},
-            {"method": "POST", "path": "/api/reader-brain", "expect": "concise narration or fallback narration"},
-            {"method": "POST", "path": "/api/speak", "expect": "Kokoro audio or audible browser fallback path"},
+            {
+                "method": "POST",
+                "path": "/api/reader-brain",
+                "expect": "concise narration or fallback narration",
+                "sample_body": {
+                    "node_type": "heading",
+                    "text": "The model map",
+                    "position": "item 4 of 10",
+                    "mode": "narrate",
+                },
+            },
+            {
+                "method": "POST",
+                "path": "/api/speak",
+                "expect": "Kokoro audio or audible browser fallback path",
+                "sample_body": {
+                    "text": "Heading. The model map.",
+                    "voice": READER_SETTINGS["default_voice"],
+                    "speed": READER_SETTINGS["default_speed"],
+                },
+            },
         ],
     }
 

scripts/verify.py

@@ -290,6 +290,13 @@ def verify_routes() -> None:
         any(item["path"] == "/api/accessibility-audit" for item in demo_payload["api_checks"]),
         "Demo script should include the accessibility audit check",
     )
+    reader_check = next(item for item in demo_payload["api_checks"] if item["path"] == "/api/reader-brain")
+    speech_check = next(item for item in demo_payload["api_checks"] if item["path"] == "/api/speak")
+    assert_true(reader_check["sample_body"]["mode"] == "narrate", "Reader-brain demo check should include a sample body")
+    assert_true(
+        speech_check["sample_body"]["voice"] == app.READER_SETTINGS["default_voice"],
+        "Speech demo check should use the default reader voice",
+    )
 
     audit = client.get("/api/accessibility-audit")
     assert_true(audit.status_code == 200, "Accessibility audit route should return 200")