Put core/app.py

core/app.py

@@ -161,7 +161,7 @@ def browser_bin() -> str | None:
         return shutil.which("lightpanda") or None
 
 
-@app.get("/health")
+@app.get("/health", tags=["diagnostics"], summary="What this image actually contains")
 def health():
     try:
         version_info = versions()
@@ -172,24 +172,42 @@ def health():
         "tools": {
             "ffmpeg": shutil.which(FFMPEG) or None,
             "streamlink": shutil.which("streamlink") or None,
-            "yt-dlp": shutil.which("yt-dlp") or None,
-            "any-dl": shutil.which("any-dl") or None,
-            "node": shutil.which("node") or None,
+            "curl_cffi": _curl_cffi_version(),
             "lightpanda": shutil.which("lightpanda") or None,
         },
         "browser": {
             "engine": "lightpanda",
             "path": browser_bin(),
             "binary": "https://github.com/lightpanda-io/browser",
-            "installed_by": "pip (the lightpanda wheel bundles the binary)",
+            "installed_by": "pip (the lightpanda wheel bundles the browser binary)",
             "needed_by": ["streamlink"],
         },
         "versions": version_info,
         "cookies": os.path.isfile("cookies.txt") or os.path.isfile("/data/cookies.txt"),
         "solutions": [s.NAME for s in SOLUTIONS],
+        "endpoints": {
+            "client_side": ["/cdn/formats"],
+            "proxy": ["/stream"],
+            "diagnostic": ["/formats", "/health"],
+        },
+        "removed_rungs": {
+            "yt-dlp": "no working Kick VOD extractor; resolves as [kick:live] and answers 'channel is not currently live'",
+            "streamlink": "rung needed a browser that can clear Kick's JS challenge; this image ships Lightpanda, a different engine",
+            "any-dl": "needs a real Chrome on its command line; this image deliberately ships no Chromium",
+            "note": "each was removed after being measured to fail on every real url while kick-api returned all five renditions",
+        },
     }
 
 
+def _curl_cffi_version() -> str | None:
+    try:
+        import curl_cffi
+
+        return getattr(curl_cffi, "__version__", "unknown")
+    except Exception:  # noqa: BLE001 - reporting only
+        return None
+
+
 @app.get("/formats")
 async def formats(
     url: str = Query(