Skip to content

Docs - Language spec page redirect #34

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Draft
cesarebernardis wants to merge 1 commit into
base: gh-pages
Choose a base branch
from
+278 −58
Draft

Docs - Language spec page redirect #34

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
1 commit
Select commit
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
1 change: 1 addition & 0 deletions development/_downloads/f19b8bcca917257b409d935580c6e8a9/constraints.txt
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -2,6 +2,7 @@ jsonschema==4.23.0
pydantic==2.12.4
pyyaml==6.0.3
httpx==0.28.1
urllib3==2.6.2
Copy link
Member

@ElayachiFouad ElayachiFouad Dec 19, 2025

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

is this a third party dependency?

Copy link
Contributor

@dhilloulinoracle dhilloulinoracle Dec 19, 2025

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

no, 4th party of langchain and other adapters

Copy link
Member

@ElayachiFouad ElayachiFouad Dec 19, 2025

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

i believe it should be removed from the constraints file and keep it only in the setup.py since we define only the third party dependencies (that we have BA for) in the constraints file


# AutoGen adapter
autogen-core==0.7.4
Expand Down
2 changes: 1 addition & 1 deletion development/_rediraffe_redirected.json
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -1 +1 @@
{"agentspec/language_spec.rst": "agentspec/language_spec_25_4_1.rst"}
{"agentspec/language_spec.rst": "agentspec/language_spec_nightly.rst"}
26 changes: 18 additions & 8 deletions development/_sources/agentspec/index.rst.txt
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -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<agentspecspec_nightly>`.
.. only:: stable

.. toctree::
:maxdepth: 2
.. toctree::
:maxdepth: 2

Introduction, motivation & vision <intro_and_motivation>
Language specification (v25.4.1) <language_spec_25_4_1>
Positioning in the agentic ecosystem <positioning>
Tracing <tracing>
Introduction, motivation & vision <intro_and_motivation>
Language specification (v25.4.1) <language_spec_25_4_1>
Positioning in the agentic ecosystem <positioning>
Tracing <tracing>

.. only:: dev

.. toctree::
:maxdepth: 2

Introduction, motivation & vision <intro_and_motivation>
Language specification (v25.4.1) <language_spec_25_4_1>
Language specification (under development) <language_spec_nightly>
Positioning in the agentic ecosystem <positioning>
Tracing <tracing>
8 changes: 4 additions & 4 deletions development/_sources/api/index.rst.txt
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -290,14 +290,14 @@ Click on the components and section names to access the complete API documentati

========================================================= =============================================================

:class:`pyagentspec.adapters.langgraph.AgentSpecExporter` :docstring:`pyagentspec.adapters.langgraph.AgentSpecExporter`

:class:`pyagentspec.adapters.langgraph.AgentSpecLoader` :docstring:`pyagentspec.adapters.langgraph.AgentSpecLoader`

:class:`pyagentspec.adapters.autogen.AgentSpecExporter` :docstring:`pyagentspec.adapters.autogen.AgentSpecExporter`

:class:`pyagentspec.adapters.autogen.AgentSpecLoader` :docstring:`pyagentspec.adapters.autogen.AgentSpecLoader`

:class:`pyagentspec.adapters.langgraph.AgentSpecExporter` :docstring:`pyagentspec.adapters.langgraph.AgentSpecExporter`

:class:`pyagentspec.adapters.langgraph.AgentSpecLoader` :docstring:`pyagentspec.adapters.langgraph.AgentSpecLoader`

========================================================= =============================================================


Expand Down
2 changes: 1 addition & 1 deletion development/_sources/ecosystem/collaborations.rst.txt
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -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:`agent discovery` :bdg-info:`agent deployment`
62 changes: 50 additions & 12 deletions development/_sources/installation.rst.txt
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -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 <https://github.com/oracle/agent-spec>`_.

.. 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 <venv_name>
source <venv_name>/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
------------------
Expand Down
1 change: 1 addition & 0 deletions development/adapters/autogen.html
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -342,6 +342,7 @@
<li class="toctree-l1 has-children"><a class="reference internal" href="../agentspec/index.html">Agent Spec Specification</a><details><summary><span class="toctree-toggle" role="presentation"><i class="fa-solid fa-chevron-down"></i></span></summary><ul>
<li class="toctree-l2"><a class="reference internal" href="../agentspec/intro_and_motivation.html">Introduction, motivation &amp; vision</a></li>
<li class="toctree-l2"><a class="reference internal" href="../agentspec/language_spec_25_4_1.html">Language specification (v25.4.1)</a></li>
<li class="toctree-l2"><a class="reference internal" href="../agentspec/language_spec_nightly.html">Language specification (under development)</a></li>
<li class="toctree-l2"><a class="reference internal" href="../agentspec/positioning.html">Positioning in the agentic ecosystem</a></li>
<li class="toctree-l2"><a class="reference internal" href="../agentspec/tracing.html">Tracing</a></li>
</ul>
Expand Down
1 change: 1 addition & 0 deletions development/adapters/langgraph.html
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -342,6 +342,7 @@
<li class="toctree-l1 has-children"><a class="reference internal" href="../agentspec/index.html">Agent Spec Specification</a><details><summary><span class="toctree-toggle" role="presentation"><i class="fa-solid fa-chevron-down"></i></span></summary><ul>
<li class="toctree-l2"><a class="reference internal" href="../agentspec/intro_and_motivation.html">Introduction, motivation &amp; vision</a></li>
<li class="toctree-l2"><a class="reference internal" href="../agentspec/language_spec_25_4_1.html">Language specification (v25.4.1)</a></li>
<li class="toctree-l2"><a class="reference internal" href="../agentspec/language_spec_nightly.html">Language specification (under development)</a></li>
<li class="toctree-l2"><a class="reference internal" href="../agentspec/positioning.html">Positioning in the agentic ecosystem</a></li>
<li class="toctree-l2"><a class="reference internal" href="../agentspec/tracing.html">Tracing</a></li>
</ul>
Expand Down
1 change: 1 addition & 0 deletions development/adapters/wayflow.html
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -342,6 +342,7 @@
<li class="toctree-l1 has-children"><a class="reference internal" href="../agentspec/index.html">Agent Spec Specification</a><details><summary><span class="toctree-toggle" role="presentation"><i class="fa-solid fa-chevron-down"></i></span></summary><ul>
<li class="toctree-l2"><a class="reference internal" href="../agentspec/intro_and_motivation.html">Introduction, motivation &amp; vision</a></li>
<li class="toctree-l2"><a class="reference internal" href="../agentspec/language_spec_25_4_1.html">Language specification (v25.4.1)</a></li>
<li class="toctree-l2"><a class="reference internal" href="../agentspec/language_spec_nightly.html">Language specification (under development)</a></li>
<li class="toctree-l2"><a class="reference internal" href="../agentspec/positioning.html">Positioning in the agentic ecosystem</a></li>
<li class="toctree-l2"><a class="reference internal" href="../agentspec/tracing.html">Tracing</a></li>
</ul>
Expand Down
10 changes: 8 additions & 2 deletions development/agentspec/index.html
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -338,6 +338,7 @@
<li class="toctree-l1 current active has-children"><a class="current reference internal" href="#">Agent Spec Specification</a><details open="open"><summary><span class="toctree-toggle" role="presentation"><i class="fa-solid fa-chevron-down"></i></span></summary><ul>
<li class="toctree-l2"><a class="reference internal" href="intro_and_motivation.html">Introduction, motivation &amp; vision</a></li>
<li class="toctree-l2"><a class="reference internal" href="language_spec_25_4_1.html">Language specification (v25.4.1)</a></li>
<li class="toctree-l2"><a class="reference internal" href="language_spec_nightly.html">Language specification (under development)</a></li>
<li class="toctree-l2"><a class="reference internal" href="positioning.html">Positioning in the agentic ecosystem</a></li>
<li class="toctree-l2"><a class="reference internal" href="tracing.html">Tracing</a></li>
</ul>
Expand Down Expand Up @@ -479,8 +480,6 @@
Agent Spec would be supported by SDKs in various languages (e.g. Python) to be able to serialize/deserialize Agents to yaml,
or create them from object representations with the assurance of conformance to the specification.</p>
<p>You can download the Agent Spec technical report at the following <a class="reference download internal" download="" href="../_downloads/9bed8c437b5139f7c816476b7e2c20f1/agentspec_technical_report.pdf"><code class="xref download docutils literal notranslate"><span class="pre">link</span></code></a>.</p>
<p>You can also find the nightly version of the Agent Spec language specification
with all the latest updates at <a class="reference internal" href="language_spec_nightly.html#agentspecspec-nightly"><span class="std std-ref">this link</span></a>.</p>
<div class="toctree-wrapper compound">
<ul>
<li class="toctree-l1"><a class="reference internal" href="intro_and_motivation.html">Introduction, motivation &amp; vision</a><ul>
Expand All @@ -496,6 +495,13 @@
<li class="toctree-l2"><a class="reference internal" href="language_spec_25_4_1.html#sdks-for-consuming-producing-agent-spec">SDKs for consuming/producing Agent Spec</a></li>
</ul>
</li>
<li class="toctree-l1"><a class="reference internal" href="language_spec_nightly.html">Language specification (under development)</a><ul>
<li class="toctree-l2"><a class="reference internal" href="language_spec_nightly.html#language-specification">Language specification</a></li>
<li class="toctree-l2"><a class="reference internal" href="language_spec_nightly.html#language-examples">Language examples</a></li>
<li class="toctree-l2"><a class="reference internal" href="language_spec_nightly.html#generated-json-language-spec">(Generated) JSON Language spec</a></li>
<li class="toctree-l2"><a class="reference internal" href="language_spec_nightly.html#sdks-for-consuming-producing-agent-spec">SDKs for consuming/producing Agent Spec</a></li>
</ul>
</li>
<li class="toctree-l1"><a class="reference internal" href="positioning.html">Positioning in the agentic ecosystem</a></li>
<li class="toctree-l1"><a class="reference internal" href="tracing.html">Tracing</a><ul>
<li class="toctree-l2"><a class="reference internal" href="tracing.html#overview">Overview</a></li>
Expand Down
1 change: 1 addition & 0 deletions development/agentspec/intro_and_motivation.html
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -342,6 +342,7 @@
<li class="toctree-l1 current active has-children"><a class="reference internal" href="index.html">Agent Spec Specification</a><details open="open"><summary><span class="toctree-toggle" role="presentation"><i class="fa-solid fa-chevron-down"></i></span></summary><ul class="current">
<li class="toctree-l2 current active"><a class="current reference internal" href="#">Introduction, motivation &amp; vision</a></li>
<li class="toctree-l2"><a class="reference internal" href="language_spec_25_4_1.html">Language specification (v25.4.1)</a></li>
<li class="toctree-l2"><a class="reference internal" href="language_spec_nightly.html">Language specification (under development)</a></li>
<li class="toctree-l2"><a class="reference internal" href="positioning.html">Positioning in the agentic ecosystem</a></li>
<li class="toctree-l2"><a class="reference internal" href="tracing.html">Tracing</a></li>
</ul>
Expand Down
6 changes: 3 additions & 3 deletions development/agentspec/language_spec.html
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -2,14 +2,14 @@
<html>
<head>
<noscript>
<meta http-equiv="refresh" content="0; url=language_spec_25_4_1.html"/>
<meta http-equiv="refresh" content="0; url=language_spec_nightly.html"/>
</noscript>
</head>
<body>
<script>
window.location.href = 'language_spec_25_4_1.html' + (window.location.search || '') + (window.location.hash || '');
window.location.href = 'language_spec_nightly.html' + (window.location.search || '') + (window.location.hash || '');
</script>
<p>You should have been redirected.</p>
<a href="language_spec_25_4_1.html">If not, click here to continue.</a>
<a href="language_spec_nightly.html">If not, click here to continue.</a>
</body>
</html>
1 change: 1 addition & 0 deletions development/agentspec/language_spec_25_4_1.html
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -342,6 +342,7 @@
<li class="toctree-l1 current active has-children"><a class="reference internal" href="index.html">Agent Spec Specification</a><details open="open"><summary><span class="toctree-toggle" role="presentation"><i class="fa-solid fa-chevron-down"></i></span></summary><ul class="current">
<li class="toctree-l2"><a class="reference internal" href="intro_and_motivation.html">Introduction, motivation &amp; vision</a></li>
<li class="toctree-l2 current active"><a class="current reference internal" href="#">Language specification (v25.4.1)</a></li>
<li class="toctree-l2"><a class="reference internal" href="language_spec_nightly.html">Language specification (under development)</a></li>
<li class="toctree-l2"><a class="reference internal" href="positioning.html">Positioning in the agentic ecosystem</a></li>
<li class="toctree-l2"><a class="reference internal" href="tracing.html">Tracing</a></li>
</ul>
Expand Down
Loading