Add agent URL hyperlinks, replay downloads, and submit_with_replay endpoint

- Agent names link to GitHub/project URL when agent_url is provided
- Replay column shows download links for entries with replays
- New submit_with_replay API endpoint accepts replay file uploads
- Serves replay files from submissions/ directory via allowed_paths
- Added agent_url column to CSV schema

app.py

@@ -45,6 +45,7 @@ DISPLAY_COLUMNS = [
     "Avg Economy",
     "Avg Game Length",
     "Date",
+    "Replay",
 ]
 
 
@@ -57,9 +58,33 @@ def load_data() -> pd.DataFrame:
     df = df.sort_values("score", ascending=False).reset_index(drop=True)
     df.insert(0, "Rank", range(1, len(df) + 1))
 
+    # Build agent name with optional hyperlink
+    if "agent_url" in df.columns:
+        df["Agent"] = df.apply(
+            lambda r: (
+                f'<a href="{r["agent_url"]}" target="_blank">{r["agent_name"]}</a>'
+                if pd.notna(r.get("agent_url")) and str(r["agent_url"]).strip()
+                else r["agent_name"]
+            ),
+            axis=1,
+        )
+    else:
+        df["Agent"] = df["agent_name"]
+
+    # Build replay download link
+    if "replay_url" in df.columns:
+        df["Replay"] = df["replay_url"].apply(
+            lambda u: (
+                f'<a href="/replays/{u}" download title="Download replay">&#11015;</a>'
+                if pd.notna(u) and str(u).strip()
+                else ""
+            )
+        )
+    else:
+        df["Replay"] = ""
+
     # Rename for display
     df = df.rename(columns={
-        "agent_name": "Agent",
         "agent_type": "Type",
         "opponent": "Opponent",
         "games": "Games",
@@ -161,7 +186,7 @@ def save_submission(results: dict) -> None:
     fieldnames = [
         "agent_name", "agent_type", "opponent", "games", "win_rate",
         "score", "avg_kills", "avg_deaths", "kd_ratio", "avg_economy",
-        "avg_game_length", "timestamp", "replay_url",
+        "avg_game_length", "timestamp", "replay_url", "agent_url",
     ]
     with open(csv_path, "a", newline="") as f:
         writer = csv.DictWriter(f, fieldnames=fieldnames)
@@ -235,6 +260,7 @@ def _score_from_submission(data: dict) -> dict:
         "avg_game_length": data.get("ticks", 0),
         "timestamp": data.get("timestamp", datetime.now(timezone.utc).strftime("%Y-%m-%d"))[:10],
         "replay_url": "",
+        "agent_url": data.get("agent_url", ""),
     }
 
 
@@ -291,6 +317,39 @@ def handle_api_submit(json_data: str) -> str:
     )
 
 
+def handle_api_submit_with_replay(json_data: str, replay_file) -> str:
+    """API endpoint: accept JSON + replay file. Used by CLI with --replay."""
+    try:
+        data = json.loads(json_data)
+    except (json.JSONDecodeError, Exception) as e:
+        return f"Invalid JSON: {e}"
+
+    is_valid, error = validate_submission(data)
+    if not is_valid:
+        return f"Validation error: {error}"
+
+    results_row = _score_from_submission(data)
+
+    # Save replay if provided
+    if replay_file is not None:
+        import shutil
+        from datetime import datetime, timezone
+
+        orig = Path(replay_file) if isinstance(replay_file, str) else Path(replay_file.name)
+        ts = datetime.now(timezone.utc).strftime("%Y%m%dT%H%M%SZ")
+        slug = data["agent_name"].replace("/", "_").replace(" ", "_")[:30]
+        replay_name = f"replay-{slug}-{ts}.orarep"
+        shutil.copy2(str(orig), SUBMISSIONS_DIR / replay_name)
+        results_row["replay_url"] = replay_name
+
+    save_submission(results_row)
+
+    return (
+        f"OK: {data['agent_name']} ({data['agent_type']}) "
+        f"vs {data['opponent']}: score {results_row['score']}"
+    )
+
+
 # ── UI ────────────────────────────────────────────────────────────────────────
 
 ABOUT_MD = """
@@ -441,7 +500,7 @@ def build_app() -> gr.Blocks:
                     value=initial_df,
                     datatype=[
                         "number",    # Rank
-                        "str",       # Agent
+                        "html",      # Agent (may contain hyperlink)
                         "html",      # Type (badge)
                         "str",       # Opponent
                         "number",    # Games
@@ -453,6 +512,7 @@ def build_app() -> gr.Blocks:
                         "number",    # Avg Economy
                         "number",    # Avg Game Length
                         "str",       # Date
+                        "html",      # Replay (download link)
                     ],
                     interactive=False,
                     show_label=False,
@@ -498,7 +558,7 @@ def build_app() -> gr.Blocks:
                     outputs=[submit_output, leaderboard],
                 )
 
-                # API endpoint for CLI auto-upload
+                # API endpoint for CLI auto-upload (JSON only)
                 api_json_input = gr.Textbox(visible=False)
                 api_result = gr.Textbox(visible=False)
                 api_btn = gr.Button(visible=False)
@@ -509,6 +569,18 @@ def build_app() -> gr.Blocks:
                     api_name="submit",
                 )
 
+                # API endpoint for CLI upload with replay
+                api_json_input2 = gr.Textbox(visible=False)
+                api_replay_input = gr.File(visible=False)
+                api_result2 = gr.Textbox(visible=False)
+                api_btn2 = gr.Button(visible=False)
+                api_btn2.click(
+                    fn=handle_api_submit_with_replay,
+                    inputs=[api_json_input2, api_replay_input],
+                    outputs=[api_result2],
+                    api_name="submit_with_replay",
+                )
+
                 gr.Markdown(SUBMIT_MD)
 
     return app
@@ -516,4 +588,4 @@ def build_app() -> gr.Blocks:
 
 if __name__ == "__main__":
     app = build_app()
-    app.launch()
+    app.launch(allowed_paths=[str(SUBMISSIONS_DIR)])

data/results.csv

@@ -1,2 +1,2 @@
-agent_name,agent_type,opponent,games,win_rate,score,avg_kills,avg_deaths,kd_ratio,avg_economy,avg_game_length,timestamp,replay_url
-qwen/qwen3-coder-next,LLM,Beginner,1,0.0,18.3,1000,2900,0.34,9050,27349,2026-02-25,
+agent_name,agent_type,opponent,games,win_rate,score,avg_kills,avg_deaths,kd_ratio,avg_economy,avg_game_length,timestamp,replay_url,agent_url
+qwen/qwen3-coder-next,LLM,Beginner,1,0.0,18.3,1000,2900,0.34,9050,27349,2026-02-25,,

tests/test_app.py

@@ -17,6 +17,7 @@ from app import (
     build_app,
     filter_leaderboard,
     handle_api_submit,
+    handle_api_submit_with_replay,
     load_data,
     validate_submission,
 )
@@ -195,3 +196,115 @@ class TestApiSubmit:
         import json
         result = handle_api_submit(json.dumps({"agent_name": "Bot"}))
         assert "Validation error" in result
+
+
+class TestDisplayColumns:
+    """Test display column configuration."""
+
+    def test_replay_in_display_columns(self):
+        assert "Replay" in DISPLAY_COLUMNS
+
+    def test_display_columns_count(self):
+        assert len(DISPLAY_COLUMNS) == 14
+
+
+class TestAgentUrl:
+    """Test agent URL hyperlink rendering."""
+
+    def test_agent_url_in_submission(self):
+        import json
+        import tempfile
+        data = {
+            "agent_name": "DeathBot",
+            "agent_type": "RL",
+            "agent_url": "https://github.com/user/deathbot",
+            "opponent": "Normal",
+            "result": "win",
+            "ticks": 5000,
+            "kills_cost": 3000,
+            "deaths_cost": 1000,
+            "assets_value": 8000,
+        }
+        with tempfile.NamedTemporaryFile(suffix=".csv", delete=False) as f:
+            temp_path = Path(f.name)
+        with patch("app.DATA_PATH", temp_path):
+            result = handle_api_submit(json.dumps(data))
+            assert "OK" in result
+            assert "DeathBot" in result
+        temp_path.unlink(missing_ok=True)
+
+    def test_agent_url_renders_link(self):
+        """When agent_url is set, Agent column should be a hyperlink."""
+        import tempfile
+        csv_content = (
+            "agent_name,agent_type,opponent,games,win_rate,score,"
+            "avg_kills,avg_deaths,kd_ratio,avg_economy,avg_game_length,"
+            "timestamp,replay_url,agent_url\n"
+            "DeathBot,RL,Normal,10,50.0,60.0,"
+            "2000,1500,1.33,9000,15000,"
+            "2026-02-26,,https://github.com/user/deathbot\n"
+        )
+        with tempfile.NamedTemporaryFile(
+            mode="w", suffix=".csv", delete=False
+        ) as f:
+            f.write(csv_content)
+            temp_path = Path(f.name)
+        with patch("app.DATA_PATH", temp_path):
+            df = load_data()
+            assert '<a href="https://github.com/user/deathbot"' in df["Agent"].iloc[0]
+        temp_path.unlink(missing_ok=True)
+
+    def test_no_url_renders_plain_name(self):
+        """When agent_url is empty, Agent column is plain text."""
+        import tempfile
+        csv_content = (
+            "agent_name,agent_type,opponent,games,win_rate,score,"
+            "avg_kills,avg_deaths,kd_ratio,avg_economy,avg_game_length,"
+            "timestamp,replay_url,agent_url\n"
+            "PlainBot,LLM,Easy,5,20.0,30.0,"
+            "1000,2000,0.5,5000,10000,"
+            "2026-02-26,,\n"
+        )
+        with tempfile.NamedTemporaryFile(
+            mode="w", suffix=".csv", delete=False
+        ) as f:
+            f.write(csv_content)
+            temp_path = Path(f.name)
+        with patch("app.DATA_PATH", temp_path):
+            df = load_data()
+            assert df["Agent"].iloc[0] == "PlainBot"
+        temp_path.unlink(missing_ok=True)
+
+
+class TestReplayColumn:
+    """Test replay download link rendering."""
+
+    def test_replay_link_rendered(self):
+        """Replay column shows download link when replay_url is set."""
+        import tempfile
+        csv_content = (
+            "agent_name,agent_type,opponent,games,win_rate,score,"
+            "avg_kills,avg_deaths,kd_ratio,avg_economy,avg_game_length,"
+            "timestamp,replay_url,agent_url\n"
+            "TestBot,LLM,Easy,1,0.0,18.0,"
+            "1000,2000,0.5,5000,10000,"
+            "2026-02-26,replay-test-123.orarep,\n"
+        )
+        with tempfile.NamedTemporaryFile(
+            mode="w", suffix=".csv", delete=False
+        ) as f:
+            f.write(csv_content)
+            temp_path = Path(f.name)
+        with patch("app.DATA_PATH", temp_path):
+            df = load_data()
+            assert "/replays/replay-test-123.orarep" in df["Replay"].iloc[0]
+            assert "download" in df["Replay"].iloc[0]
+        temp_path.unlink(missing_ok=True)
+
+    def test_empty_replay_no_link(self):
+        """Replay column is empty when no replay_url."""
+        df = load_data()
+        if len(df) > 0:
+            # The default test data has no replay
+            replay_val = df["Replay"].iloc[0]
+            assert replay_val == "" or not str(replay_val).strip()