feat(explorer): brand the UI as AgentEnv Explorer and link the framework docs

src/agent_env/explorer/app.py

@@ -196,11 +196,11 @@ async def _not_found(request, exc: NotFoundError):
 
     # The five (id, version) collections behind Task/Env/Agent/Universe/Evals Hub.
     # Universes Hub reads /artifacts?type=environment_universe — no route of its own.
-    app.include_router(versioned_router(prefix=f"{API}/artifacts", tag="artifacts", collection="artifacts"))
-    app.include_router(versioned_router(prefix=f"{API}/envs", tag="envs", collection="envs"))
-    app.include_router(versioned_router(prefix=f"{API}/tasks", tag="tasks", collection="tasks"))
-    app.include_router(versioned_router(prefix=f"{API}/agents", tag="agents", collection="a2a_agents"))
-    app.include_router(versioned_router(prefix=f"{API}/evals", tag="evals", collection="evals"))
+    app.include_router(versioned_router(prefix=f"{API}/artifacts", tag="artifacts", collection="artifacts", noun="artifact"))
+    app.include_router(versioned_router(prefix=f"{API}/envs", tag="envs", collection="envs", noun="environment"))
+    app.include_router(versioned_router(prefix=f"{API}/tasks", tag="tasks", collection="tasks", noun="task"))
+    app.include_router(versioned_router(prefix=f"{API}/agents", tag="agents", collection="a2a_agents", noun="agent"))
+    app.include_router(versioned_router(prefix=f"{API}/evals", tag="evals", collection="evals", noun="eval"))
     app.include_router(runs_router.router)
     app.include_router(objects_router.router)
     app.include_router(conversations_router.router)
@@ -224,12 +224,12 @@ def _health() -> dict:
             "runner": get_runner().type,
         }
 
-    app.get("/health")(_health)
+    app.get("/health", summary="Health")(_health)
 
     static = static_dir or settings["static_dir"] or packaged_ui_dir()
     if not (static and Path(static).is_dir()):
         # Serve health at "/" only when no UI is mounted (else the SPA owns "/").
-        app.get("/")(_health)
+        app.get("/", include_in_schema=False)(_health)
 
     if static and Path(static).is_dir():
         _mount_spa(app, Path(static))

src/agent_env/explorer/openapi_docs.py

@@ -207,9 +207,9 @@ def enrich_openapi_schema(schema: dict[str, Any]) -> dict[str, Any]:
             "this install — including any added through .agentenv/config.toml."
         ),
         "counts": {
-            "artifacts": len(primitives["artifacts"]),
-            "envs": len(primitives["envs"]),
-            "taskSteps": len(primitives["taskSteps"]),
+            "artifactTypes": len(primitives["artifacts"]),
+            "envTypes": len(primitives["envs"]),
+            "taskStepTypes": len(primitives["taskSteps"]),
             "operations": sum(
                 1
                 for ops in (schema.get("paths") or {}).values()

src/agent_env/explorer/routers/common.py

@@ -100,13 +100,15 @@ def versioned_router(
     prefix: str,
     tag: str,
     collection: str,
+    noun: str,
     id_field: str = "id",
 ) -> APIRouter:
     """List / get / versions over one ``(id, version)`` collection (artifacts, envs, tasks,
-    agents, evals)."""
+    agents, evals). ``noun`` names the entity in each route's summary, which the Docs nav
+    lists without its path."""
     router = APIRouter(prefix=prefix, tags=[tag])
 
-    @router.get("", response_model=PaginatedResponse)
+    @router.get("", response_model=PaginatedResponse, summary=f"List {noun.title()}s")
     def list_items(
         limit: int = Query(50, ge=1, le=500),
         offset: int = Query(0, ge=0),
@@ -147,7 +149,7 @@ def list_items(
             has_more=offset + len(items) < total,
         )
 
-    @router.get("/{entity_id}")
+    @router.get("/{entity_id}", summary=f"Get {noun.title()}")
     def get_item(entity_id: str, version: Optional[int] = None) -> dict:
         store = docs()
         if version is not None:
@@ -159,7 +161,7 @@ def get_item(entity_id: str, version: Optional[int] = None) -> dict:
             raise HTTPException(status_code=404, detail=f"{tag} {entity_id} not found")
         return _enrich_universe(doc, store, collection)
 
-    @router.get("/{entity_id}/versions")
+    @router.get("/{entity_id}/versions", summary=f"List {noun.title()} Versions")
     def list_versions(
         entity_id: str,
         limit: int = Query(100, ge=1, le=500),