From f8b7a76fa42e8b679c71faaf3af3963d84a6a721 Mon Sep 17 00:00:00 2001 From: Cesare Bernardis Date: Thu, 18 Dec 2025 16:22:34 +0100 Subject: [PATCH 1/5] Making language spec default page vary based on type of documentation --- .../source/_components/all_components.json | 10 +++++++ docs/pyagentspec/source/agentspec/index.rst | 26 +++++++++++++------ docs/pyagentspec/source/conf.py | 18 +++++++++---- 3 files changed, 41 insertions(+), 13 deletions(-) diff --git a/docs/pyagentspec/source/_components/all_components.json b/docs/pyagentspec/source/_components/all_components.json index 92b31b8e..883e5d18 100644 --- a/docs/pyagentspec/source/_components/all_components.json +++ b/docs/pyagentspec/source/_components/all_components.json @@ -275,5 +275,15 @@ {"path": "pyagentspec.a2aagent.A2AConnectionConfig"}, {"path": "pyagentspec.a2aagent.A2ASessionParameters"} ] + }, + { + "name": "Adapters", + "path": "adapters", + "classes": [ + {"path": "pyagentspec.adapters.autogen.AgentSpecExporter"}, + {"path": "pyagentspec.adapters.autogen.AgentSpecLoader"}, + {"path": "pyagentspec.adapters.langgraph.AgentSpecExporter"}, + {"path": "pyagentspec.adapters.langgraph.AgentSpecLoader"} + ] } ] diff --git a/docs/pyagentspec/source/agentspec/index.rst b/docs/pyagentspec/source/agentspec/index.rst index 9cb6cc5d..8daa2d4a 100644 --- a/docs/pyagentspec/source/agentspec/index.rst +++ b/docs/pyagentspec/source/agentspec/index.rst @@ -19,13 +19,23 @@ or create them from object representations with the assurance of conformance to You can download the Agent Spec technical report at the following :download:`link <../_static/agentspec_technical_report.pdf>`. -You can also find the nightly version of the Agent Spec language specification -with all the latest updates at :ref:`this link`. +.. only:: stable -.. toctree:: - :maxdepth: 2 + .. toctree:: + :maxdepth: 2 - Introduction, motivation & vision - Language specification (v25.4.1) - Positioning in the agentic ecosystem - Tracing + Introduction, motivation & vision + Language specification (v25.4.1) + Positioning in the agentic ecosystem + Tracing + +.. only:: dev + + .. toctree:: + :maxdepth: 2 + + Introduction, motivation & vision + Language specification (v25.4.1) + Language specification (under development) + Positioning in the agentic ecosystem + Tracing diff --git a/docs/pyagentspec/source/conf.py b/docs/pyagentspec/source/conf.py index d5587b2d..54ca1f9a 100644 --- a/docs/pyagentspec/source/conf.py +++ b/docs/pyagentspec/source/conf.py @@ -37,10 +37,6 @@ with open(Path(__file__).parents[3] / "VERSION", "r") as f: version_file = f.read().strip() -# The IDE complains, but the tags set exists -# We add stable as current version, we might add the version switch in the future -tags.add("stable") # type: ignore - # The full version, including alpha/beta/rc tags. release = pyagentspec.__version__ @@ -57,6 +53,13 @@ else: docs_version = stable_release +# The IDE complains, but the tags set exists +# We add stable as current version, we might add the version switch in the future +if docs_version == "dev": + tags.add("dev") # type: ignore +else: + tags.add("stable") # type: ignore + # -- General configuration --------------------------------------------------- # Add any Sphinx extension module names here, as strings. They can be @@ -79,6 +82,11 @@ "sphinx_design", ] +if docs_version == "dev": + language_spec_file = "language_spec_nightly" +else: + language_spec_file = f"language_spec_{docs_version.replace('.', '_')}" + # Set the variables that should be replaced in the substitution-extensions directives rst_prolog = f""" .. |release| replace:: {release} @@ -128,7 +136,7 @@ autodoc_typehints = "description" # Redirects -rediraffe_redirects = {"agentspec/language_spec.rst": "agentspec/language_spec_25_4_1.rst"} +rediraffe_redirects = {"agentspec/language_spec.rst": f"agentspec/{language_spec_file}.rst"} # -- Options for HTML output ------------------------------------------------- From e8576938170d90e79d66f6b824d25d668c85c4fb Mon Sep 17 00:00:00 2001 From: Cesare Bernardis Date: Thu, 18 Dec 2025 16:50:25 +0100 Subject: [PATCH 2/5] Add AG-UI to collaborations --- .../source/_static/icons/agui-icon.svg | 4 ++++ .../source/ecosystem/collaborations.rst | 16 ++++++++++++++++ 2 files changed, 20 insertions(+) create mode 100644 docs/pyagentspec/source/_static/icons/agui-icon.svg diff --git a/docs/pyagentspec/source/_static/icons/agui-icon.svg b/docs/pyagentspec/source/_static/icons/agui-icon.svg new file mode 100644 index 00000000..c897dee1 --- /dev/null +++ b/docs/pyagentspec/source/_static/icons/agui-icon.svg @@ -0,0 +1,4 @@ + + + + AG-UI Protocol diff --git a/docs/pyagentspec/source/ecosystem/collaborations.rst b/docs/pyagentspec/source/ecosystem/collaborations.rst index 66c8a666..ac1dd8b7 100644 --- a/docs/pyagentspec/source/ecosystem/collaborations.rst +++ b/docs/pyagentspec/source/ecosystem/collaborations.rst @@ -8,6 +8,9 @@ Agent Spec Collaborations .. |agntcy-icon| image:: ../_static/icons/agntcy-icon.svg :width: 200px +.. |agui-icon| image:: ../_static/icons/agui-icon.svg + :width: 200px + Open Agent Specification is partnering with leading open-source AI Agent initiatives to advance new frontiers like **deep observability**, **autonomous agent discovery**, and standardized, @@ -30,3 +33,16 @@ event-driven **UI interactions** across every surface. instantiate new agents with minimal effort. :bdg-success:`agent discovery` :bdg-info:`agent deployment` + + + .. grid-item-card:: |agui-icon| + :link: https://docs.ag-ui.com/introduction + :link-alt: AG-UI CopilotKit integration with Agent Spec + + **AG-UI** + + The integration of AG-UI with Open Agent Spec allows developers to easily + connect any AG-UI-compatible frontend with Agent Spec, enabling users to + load any Agent Spec config file, choosing a supported runtime to execute it. + + :bdg-success:`agent discovery` :bdg-info:`agent deployment` From d0a8765aa4d5de1b7ce12e5876f7b8e14b0f502a Mon Sep 17 00:00:00 2001 From: Cesare Bernardis Date: Thu, 18 Dec 2025 18:03:21 +0100 Subject: [PATCH 3/5] Update installation instructions --- docs/pyagentspec/source/installation.rst | 62 +++++++++++++++++++----- 1 file changed, 50 insertions(+), 12 deletions(-) diff --git a/docs/pyagentspec/source/installation.rst b/docs/pyagentspec/source/installation.rst index d8365f95..3ced39e3 100644 --- a/docs/pyagentspec/source/installation.rst +++ b/docs/pyagentspec/source/installation.rst @@ -3,28 +3,66 @@ Installation ============ -You can find all versions and supported platforms of |project| in the :package_index:`\ `. +.. only:: stable -To install version |package_name| |stable_release|, run: + You can find all versions and supported platforms of |project| in the :package_index:`\ `. -.. code-block:: bash - :substitutions: + For example, if you want to install |package_name| |stable_release|: + + .. code-block:: bash + :substitutions: + + pip install "|package_name|==|stable_release|" + + Installing with ``pip`` pulls prebuilt binary wheels on supported platforms. + + .. only:: builder_html - pip install "|package_name|==|stable_release|" + The list below shows the package versions used in the CI environment, with Business Approval requests filed for each as part of the release process. + :download:`constraints.txt <../../../pyagentspec/constraints/constraints.txt>` -Installing with ``pip`` pulls prebuilt binary wheels on supported platforms. + If you want to install |project| with exactly these package versions, download the file and run: -.. only:: builder_html + .. code-block:: bash + :substitutions: + + pip install "|package_name|==|stable_release|" -c constraints.txt + +.. only:: dev + + 1. Clone the `repository `_. + + .. code-block:: bash + :substitutions: + + git clone git@github.com:oracle/agent-spec.git + + .. tip:: + If you face any problem, check with the Agent Spec team. + + Next, install PyAgentSpec directly from source. + + 1. Create a fresh Python environment for building and running Agent Spec assistants: + + .. code-block:: bash + :substitutions: + + python3.10 -m venv + source /bin/activate + + 2. Move to the *agent-spec/pyagentspec* directory: + + .. code-block:: bash + :substitutions: - The list of package versions used in the internal CI is available at: - :download:`constraints.txt <../../../pyagentspec/constraints/constraints.txt>` + cd agent-spec/pyagentspec - To install |project| using these exact versions, download the file and run: + 3. Install ``pyagentspec``: .. code-block:: bash - :substitutions: + :substitutions: - pip install "|package_name|==|stable_release|" -c constraints.txt + bash install-dev.sh Extra dependencies ------------------ From 717123c4d616124a410a2b52b4b0d3f0adfd9540 Mon Sep 17 00:00:00 2001 From: Cesare Bernardis Date: Thu, 18 Dec 2025 18:45:29 +0100 Subject: [PATCH 4/5] Update svg --- docs/pyagentspec/source/_static/icons/agui-icon.svg | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/pyagentspec/source/_static/icons/agui-icon.svg b/docs/pyagentspec/source/_static/icons/agui-icon.svg index c897dee1..114de96c 100644 --- a/docs/pyagentspec/source/_static/icons/agui-icon.svg +++ b/docs/pyagentspec/source/_static/icons/agui-icon.svg @@ -1,4 +1,4 @@ - AG-UI Protocol + AG-UI Protocol From 8e9fe51b148d165d9fa906d9be954fefa7bc5ed2 Mon Sep 17 00:00:00 2001 From: Cesare Bernardis Date: Fri, 19 Dec 2025 15:31:35 +0100 Subject: [PATCH 5/5] Update docs/pyagentspec/source/ecosystem/collaborations.rst Co-authored-by: Paul Cayet --- docs/pyagentspec/source/ecosystem/collaborations.rst | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/pyagentspec/source/ecosystem/collaborations.rst b/docs/pyagentspec/source/ecosystem/collaborations.rst index ac1dd8b7..be1f35da 100644 --- a/docs/pyagentspec/source/ecosystem/collaborations.rst +++ b/docs/pyagentspec/source/ecosystem/collaborations.rst @@ -45,4 +45,4 @@ event-driven **UI interactions** across every surface. connect any AG-UI-compatible frontend with Agent Spec, enabling users to load any Agent Spec config file, choosing a supported runtime to execute it. - :bdg-success:`agent discovery` :bdg-info:`agent deployment` + :bdg-success:`agentic frontends`