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/_static/icons/agui-icon.svg b/docs/pyagentspec/source/_static/icons/agui-icon.svg
new file mode 100644
index 00000000..114de96c
--- /dev/null
+++ b/docs/pyagentspec/source/_static/icons/agui-icon.svg
@@ -0,0 +1,4 @@
+
+
+
+
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 -------------------------------------------------
diff --git a/docs/pyagentspec/source/ecosystem/collaborations.rst b/docs/pyagentspec/source/ecosystem/collaborations.rst
index 66c8a666..be1f35da 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:`agentic frontends`
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
------------------