Link wiki reproductions to the agent wiki explorer

Point agent wiki reproduction links at the in-app agent wiki explorer
(?file=<path>) instead of the issue explorer, so they load reliably. Also
remove the non-working "Open asset" link buttons and add a "Raw markdown"
expander for easy copy-paste of the source document.

Co-authored-by: Cursor <cursoragent@cursor.com>

Author: lukasmasuch

app/agent_wiki_explorer.py

@@ -53,6 +53,9 @@ def _render_markdown_document(document: WikiDocument, markdown_content: str) ->
     else:
         st.info("This document is empty.")
 
+    with st.expander("Raw markdown"):
+        st.code(markdown_content, language="markdown")
+
 
 def _render_image_asset(document: WikiDocument) -> None:
     local_path, local_path_error = get_wiki_document_local_path(document["path"])
@@ -75,12 +78,10 @@ def _render_code_asset(document: WikiDocument, language: str) -> None:
         return
     st.caption(document["path"])
     st.code(document_text, language=language)
-    st.link_button("Open asset", document["raw_url"], width="content")
 
 
-def _render_other_asset(document: WikiDocument) -> None:
+def _render_other_asset() -> None:
     st.info("This asset is not rendered inline.")
-    st.link_button("Open asset", document["raw_url"], width="content")
 
 
 title_row = st.container(horizontal=True, horizontal_alignment="distribute", vertical_alignment="center")
@@ -134,4 +135,4 @@ def _render_other_asset(document: WikiDocument) -> None:
 elif selected_document["extension"] in CODE_LANGUAGE_BY_EXTENSION:
     _render_code_asset(selected_document, CODE_LANGUAGE_BY_EXTENSION[selected_document["extension"]])
 else:
-    _render_other_asset(selected_document)
+    _render_other_asset()

app/issue_explorer.py

@@ -6,7 +6,12 @@
 import streamlit as st
 import streamlit.components.v1 as components
 
-from app.utils.agent_wiki import WikiIssueRepro, fetch_wiki_document_text, fetch_wiki_issue_repros
+from app.utils.agent_wiki import (
+    WikiIssueRepro,
+    build_wiki_explorer_url,
+    fetch_wiki_document_text,
+    fetch_wiki_issue_repros,
+)
 from app.utils.github_utils import get_issue_data
 
 st.set_page_config(page_title="Issue explorer", page_icon="🚧")
@@ -225,7 +230,8 @@ def get_case_source_code(case: IssueCase) -> tuple[str | None, str | None]:
             st.info(
                 f"This reproduction is loaded from the "
                 f"[agent wiki]({wiki_repro['folder_url']}) and has not been reviewed. "
-                f"[View `repro_app.py`]({wiki_repro['repro_app_source_url']}).{verify_suffix}",
+                f"[Open `repro_app.py` in the wiki explorer]"
+                f"({build_wiki_explorer_url(wiki_repro['repro_app_path'])}).{verify_suffix}",
                 icon=":material/menu_book:",
             )
 

app/open_issues.py

@@ -7,7 +7,7 @@
 import pandas as pd
 import streamlit as st
 
-from app.utils.agent_wiki import fetch_wiki_issue_repros, get_synced_wiki_repo_path
+from app.utils.agent_wiki import build_wiki_explorer_url, fetch_wiki_issue_repros, get_synced_wiki_repo_path
 from app.utils.github_utils import fetch_issue_reactions, fetch_issue_view_counts, get_all_github_issues
 from app.utils.issue_formatting import labels_to_type_emoji, reactions_to_str
 
@@ -171,18 +171,22 @@ def initial_query_params(key: str) -> list[str]:
 wiki_repros, wiki_repros_error = fetch_wiki_issue_repros()
 if wiki_repros_error:
     print("Failed to load agent wiki reproductions:", wiki_repros_error, flush=True)
-wiki_repro_issue_numbers = set(wiki_repros)
 
 
 def get_reproducible_example(issue_number: int) -> str | None:
-    """Return a link to the issue explorer if a reproduction is available.
+    """Return a link to the available reproduction for an issue, if any.
 
-    Local reproductions take priority, but issues that only have a reproduction
-    in the agent wiki are linked as well (the issue explorer resolves both).
+    Local reproductions take priority and link to the issue explorer, where they
+    can be run. Issues that only have a reproduction in the agent wiki link to
+    the agent wiki explorer so the repro document can be viewed.
     """
     issue_folder_name = f"gh-{issue_number}"
-    if PATH_TO_ISSUES.joinpath(issue_folder_name).is_dir() or issue_number in wiki_repro_issue_numbers:
+    if PATH_TO_ISSUES.joinpath(issue_folder_name).is_dir():
         return "/?issue=" + issue_folder_name
+
+    wiki_repro = wiki_repros.get(issue_number)
+    if wiki_repro is not None:
+        return build_wiki_explorer_url(wiki_repro["repro_app_path"])
     return None
 
 

app/utils/agent_wiki.py

@@ -20,6 +20,9 @@
 WIKI_RAW_URL_PREFIX = "https://raw.githubusercontent.com/wiki/streamlit/streamlit"
 WIKI_SOURCE_URL_PREFIX = f"https://github.com/{WIKI_REPO}/blob/{WIKI_BRANCH}"
 WIKI_TREE_URL_PREFIX = f"https://github.com/{WIKI_REPO}/tree/{WIKI_BRANCH}"
+# In-app route of the agent wiki explorer page. The explorer selects a document
+# via the `file` query parameter (bound to its selectbox).
+WIKI_EXPLORER_URL_PATH = "/agent_wiki_explorer"
 
 ALLOWED_TOP_LEVEL_SECTIONS = {"issues", "pull-requests", "references"}
 # Top-level sections whose direct children group artifacts by a numeric entity
@@ -158,6 +161,11 @@ def build_wiki_document_query_url(path: str) -> str:
     return f"?doc={quote(path, safe='')}"
 
 
+def build_wiki_explorer_url(path: str) -> str:
+    """Build an in-app link that opens a document in the agent wiki explorer."""
+    return f"{WIKI_EXPLORER_URL_PATH}?file={quote(path, safe='/')}"
+
+
 def get_wiki_section(path: str) -> str:
     return path.split("/", 1)[0] if "/" in path else "(root)"
 

tests/test_agent_wiki.py

@@ -1,5 +1,6 @@
 from app.utils.agent_wiki import (
     build_wiki_documents,
+    build_wiki_explorer_url,
     build_wiki_raw_url,
     build_wiki_tree_url,
     get_wiki_folder,
@@ -56,6 +57,10 @@ def test_build_wiki_tree_url_points_to_folder_on_master() -> None:
     assert build_wiki_tree_url("issues/12345") == "https://github.com/streamlit/streamlit.wiki/tree/master/issues/12345"
 
 
+def test_build_wiki_explorer_url_links_to_explorer_page_with_file_param() -> None:
+    assert build_wiki_explorer_url("issues/12345/repro_app.py") == "/agent_wiki_explorer?file=issues/12345/repro_app.py"
+
+
 def test_resolve_wiki_relative_path_handles_parent_and_root_relative_targets() -> None:
     assert (
         resolve_wiki_relative_path(