test: cover Agent Ready discovery contracts

Author: Videirafo

examples/safe-agent-api/tests/test_api.py

@@ -10,11 +10,29 @@ def test_playground_is_public_and_self_contained() -> None:
     assert response.status_code == 200
     assert "Safe Agent Playground" in response.text
     assert "/v1/run-demo" in response.text
+    assert "Why this demo exists" in response.text
     assert 'rel="canonical"' in response.text
     assert 'rel="describedby" href="/llms.txt"' in response.text
+    assert 'property="og:title"' in response.text
     assert 'type="application/ld+json"' in response.text
     assert response.headers["x-content-type-options"] == "nosniff"
     assert "connect-src 'self'" in response.headers["content-security-policy"]
+    assert response.headers["x-robots-tag"].startswith("index, follow")
+
+
+def test_head_root_is_supported() -> None:
+    response = client.head("/")
+    assert response.status_code == 200
+    assert response.headers["content-type"].startswith("text/html")
+
+
+def test_root_supports_markdown_content_negotiation() -> None:
+    response = client.get("/", headers={"Accept": "text/markdown"})
+    assert response.status_code == 200
+    assert response.headers["content-type"].startswith("text/markdown")
+    assert "# Safe Agent Playground" in response.text
+    assert "## Sitemap" in response.text
+    assert 'rel="canonical"' in response.headers["link"]
 
 
 def test_health() -> None:
@@ -23,7 +41,7 @@ def test_health() -> None:
     assert response.json() == {
         "status": "ok",
         "service": "safe-agent-api",
-        "version": "0.5.0",
+        "version": "0.6.0",
     }
 
 
@@ -33,6 +51,7 @@ def test_discovery_documents_are_public() -> None:
     assert llms.headers["content-type"].startswith("text/plain")
     assert "# Safe Agent Playground" in llms.text
     assert "/openapi.json" in llms.text
+    assert "/index.md" in llms.text
 
     full = client.get("/llms-full.txt")
     assert full.status_code == 200
@@ -47,6 +66,9 @@ def test_discovery_documents_are_public() -> None:
     assert sitemap_xml.status_code == 200
     assert sitemap_xml.headers["content-type"].startswith("application/xml")
     assert "<urlset" in sitemap_xml.text
+    assert "<lastmod>2026-09-07</lastmod>" in sitemap_xml.text
+    assert "<loc>https://safe-agent-playground.onrender.com/</loc>" in sitemap_xml.text
+    assert "playground.md" not in sitemap_xml.text
 
     sitemap_md = client.get("/sitemap.md")
     assert sitemap_md.status_code == 200
@@ -55,11 +77,19 @@ def test_discovery_documents_are_public() -> None:
     agents = client.get("/AGENTS.md")
     assert agents.status_code == 200
     assert "Model suggestion is not authorization" in agents.text
+    assert "## Installation" in agents.text
+    assert "## Configuration" in agents.text
+    assert "## Usage" in agents.text
+    assert "## Examples" in agents.text
 
-    markdown = client.get("/playground.md")
+    markdown = client.get("/index.md")
     assert markdown.status_code == 200
     assert markdown.headers["content-type"].startswith("text/markdown")
+    assert markdown.text.startswith("---\n")
+    assert "canonical: https://safe-agent-playground.onrender.com/" in markdown.text
+    assert "last_modified: 2026-09-07" in markdown.text
     assert "## Scenarios" in markdown.text
+    assert "## Sitemap" in markdown.text
 
 
 def test_read_is_allowed_in_same_tenant() -> None: