version switcher

* version switcher

* fix switcher bug

Author: soufianeamini

docs/pyagentspec/source/_static/landing.css

@@ -111,7 +111,6 @@ p.detail-title {
 }
 
 a {
-  display: inline !important;
   color:#f29111;
 }
 

docs/pyagentspec/source/conf.py

@@ -17,6 +17,7 @@
 import os
 import sys
 from pathlib import Path
+from typing import Any
 
 from sphinx.application import Sphinx
 
@@ -40,9 +41,6 @@
 # We add stable as current version, we might add the version switch in the future
 tags.add("stable")  # type: ignore
 
-# The short X.Y version.
-version = ".".join(pyagentspec.__version__.split(".")[:2])
-
 # The full version, including alpha/beta/rc tags.
 release = pyagentspec.__version__
 
@@ -51,6 +49,14 @@
 if stable_release is None:
     raise Exception("Error: STABLE_RELEASE environment variable is not set.")
 
+docs_version = os.getenv("DOCS_VERSION")
+
+if not docs_version:
+    if any(x in release for x in (".dev", "a", "b", "rc")):
+        docs_version = "dev"
+    else:
+        docs_version = stable_release
+
 # -- General configuration ---------------------------------------------------
 
 # Add any Sphinx extension module names here, as strings. They can be
@@ -148,7 +154,11 @@
     "pygments_light_style": "xcode",  # for light mode
     "pygments_dark_style": "monokai",  # for dark mode
     "navbar_align": "left",
-    "navbar_start": ["navbar-logo"],
+    "navbar_start": ["navbar-logo", "version-switcher"],
+    "switcher": {
+        "json_url": "https://oracle.github.io/agent-spec/switcher.json",
+        "version_match": docs_version,
+    },
     "navbar_center": [
         "navbar-new"
     ],  # Custom top navigation - defined in the template, navbar-new.html, in the _templates dir.
@@ -179,7 +189,7 @@
 copybutton_prompt_is_regexp = True
 
 
-def autodoc_skip_member(app: Sphinx, what, name, obj, skip, options):
+def autodoc_skip_member(app: Sphinx, what, name, obj, skip, options):  # type: ignore
     """
     Skips showing an attribute as a member if it is already in the list of parameters.
     This prevents duplicated fields in Pydantic / dataclasses.
@@ -191,7 +201,7 @@ def autodoc_skip_member(app: Sphinx, what, name, obj, skip, options):
     return skip
 
 
-def setup(app: Sphinx):
+def setup(app: Sphinx) -> dict[str, Any]:
     app.connect("autodoc-skip-member", autodoc_skip_member)
     app.add_js_file("js/fix-navigation.js")