From 34343f801fa2e599c70b9e7e9ba6baaa35c7e3cc Mon Sep 17 00:00:00 2001 From: Edgar Arakelyan Date: Wed, 18 Nov 2026 12:48:31 -0800 Subject: [PATCH] build(agents): the bundled agents take the protocol whose extension routes take the control token Each agent folder now requires agentenv-framework-protocol 0.1.582 or newer. A folder's image installs the newest protocol at or above its floor and is rebuilt only when the folder changes, so an image built before 0.1.582 keeps its extension routes open. Raising the floor changes every folder, so every image is built again with the guard. Co-Authored-By: Claude Opus 5.5 --- src/agent_env/agents/agents/browser-use/requirements.txt | 6 ++++-- src/agent_env/agents/agents/claude-code/requirements.txt | 7 +++---- src/agent_env/agents/agents/codex/requirements.txt | 6 +++--- src/agent_env/agents/agents/gemini/requirements.txt | 6 +++--- src/agent_env/agents/agents/hermes/requirements.txt | 6 +++--- src/agent_env/agents/agents/letta-code/requirements.txt | 6 +++--- src/agent_env/agents/agents/opencode/requirements.txt | 6 +++--- src/agent_env/agents/agents/openhands/requirements.txt | 6 +++--- src/agent_env/agents/agents/pi/requirements.txt | 6 ++++-- src/agent_env/agents/agents/proxy/requirements.txt | 5 +++-- src/agent_env/agents/agents/pydantic-ai/requirements.txt | 6 +++--- tst/unit/agents/claude_code/test_image_contract.py | 2 +- tst/unit/agents/codex/test_image_contract.py | 2 +- tst/unit/agents/gemini/test_image_contract.py | 2 +- tst/unit/agents/opencode/test_image_contract.py | 2 +- 15 files changed, 39 insertions(+), 35 deletions(-) diff --git a/src/agent_env/agents/agents/browser-use/requirements.txt b/src/agent_env/agents/agents/browser-use/requirements.txt index 021f2b90d..5d00eb18f 100644 --- a/src/agent_env/agents/agents/browser-use/requirements.txt +++ b/src/agent_env/agents/agents/browser-use/requirements.txt @@ -1,2 +1,4 @@ -# The image installs the newest agentenv-framework-protocol at or above this floor; a release doesn't pin it. -agentenv-framework-protocol[agent]>=0.1.350 +# The image installs the newest agentenv-framework-protocol at or above this floor; a release doesn't pin it, so the +# image is built again only when this folder changes. The floor is the first whose extension routes take the agent's +# control token; raise it when the agent needs a newer protocol. +agentenv-framework-protocol[agent]>=0.1.582 diff --git a/src/agent_env/agents/agents/claude-code/requirements.txt b/src/agent_env/agents/agents/claude-code/requirements.txt index 6053dbde7..5d00eb18f 100644 --- a/src/agent_env/agents/agents/claude-code/requirements.txt +++ b/src/agent_env/agents/agents/claude-code/requirements.txt @@ -1,5 +1,4 @@ # The image installs the newest agentenv-framework-protocol at or above this floor; a release doesn't pin it, so the -# image is built again only when this folder changes. The floor is the first that serves clock/v1's sync_time on an -# agent whose image runs the clock follower (agentenv_protocol.a2a_agent.clock), which this image does; raise it when -# the agent needs a newer protocol. -agentenv-framework-protocol[agent]>=0.1.575 +# image is built again only when this folder changes. The floor is the first whose extension routes take the agent's +# control token; raise it when the agent needs a newer protocol. +agentenv-framework-protocol[agent]>=0.1.582 diff --git a/src/agent_env/agents/agents/codex/requirements.txt b/src/agent_env/agents/agents/codex/requirements.txt index bffd99699..1fbb1f06a 100644 --- a/src/agent_env/agents/agents/codex/requirements.txt +++ b/src/agent_env/agents/agents/codex/requirements.txt @@ -1,7 +1,7 @@ # The image installs the newest agentenv-framework-protocol at or above this floor; a release doesn't pin it, so the -# image is built again only when this folder changes. The floor is the first that serves peer-agents/v1's tools, which -# the agent advertises without handlers of its own; raise it when the agent needs a newer protocol. -agentenv-framework-protocol[agent]>=0.1.351 +# image is built again only when this folder changes. The floor is the first whose extension routes take the agent's +# control token; raise it when the agent needs a newer protocol. +agentenv-framework-protocol[agent]>=0.1.582 tomli-w==1.2.0 # The CA certificates an installed agent's CLI trusts on a target that has none of its own; unpinned, so each build # takes the newest. diff --git a/src/agent_env/agents/agents/gemini/requirements.txt b/src/agent_env/agents/agents/gemini/requirements.txt index 464574902..5d00eb18f 100644 --- a/src/agent_env/agents/agents/gemini/requirements.txt +++ b/src/agent_env/agents/agents/gemini/requirements.txt @@ -1,4 +1,4 @@ # The image installs the newest agentenv-framework-protocol at or above this floor; a release doesn't pin it, so the -# image is built again only when this folder changes. The floor is the first that serves peer-agents/v1's tools, which -# the agent advertises without handlers of its own; raise it when the agent needs a newer protocol. -agentenv-framework-protocol[agent]>=0.1.351 +# image is built again only when this folder changes. The floor is the first whose extension routes take the agent's +# control token; raise it when the agent needs a newer protocol. +agentenv-framework-protocol[agent]>=0.1.582 diff --git a/src/agent_env/agents/agents/hermes/requirements.txt b/src/agent_env/agents/agents/hermes/requirements.txt index 30c7f3a44..32d7191b3 100644 --- a/src/agent_env/agents/agents/hermes/requirements.txt +++ b/src/agent_env/agents/agents/hermes/requirements.txt @@ -1,5 +1,5 @@ # The image installs the newest agentenv-framework-protocol at or above this floor; a release doesn't pin it, so the -# image is built again only when this folder changes. The floor is the first that serves peer-agents/v1's tools, which -# the agent advertises without handlers of its own; raise it when the agent needs a newer protocol. -agentenv-framework-protocol[agent]>=0.1.351 +# image is built again only when this folder changes. The floor is the first whose extension routes take the agent's +# control token; raise it when the agent needs a newer protocol. +agentenv-framework-protocol[agent]>=0.1.582 jsonschema>=4.18,<5 diff --git a/src/agent_env/agents/agents/letta-code/requirements.txt b/src/agent_env/agents/agents/letta-code/requirements.txt index bed7e8952..dbfbd05ae 100644 --- a/src/agent_env/agents/agents/letta-code/requirements.txt +++ b/src/agent_env/agents/agents/letta-code/requirements.txt @@ -1,6 +1,6 @@ # The image installs the newest agentenv-framework-protocol at or above this floor; a release doesn't pin it, so the -# image is built again only when this folder changes. The floor is the first that serves peer-agents/v1's tools, which -# the agent advertises without handlers of its own; raise it when the agent needs a newer protocol. -agentenv-framework-protocol[agent]>=0.1.351 +# image is built again only when this folder changes. The floor is the first whose extension routes take the agent's +# control token; raise it when the agent needs a newer protocol. +agentenv-framework-protocol[agent]>=0.1.582 jsonschema>=4.18,<5 aiohttp>=3.9,<4 diff --git a/src/agent_env/agents/agents/opencode/requirements.txt b/src/agent_env/agents/agents/opencode/requirements.txt index 30c7f3a44..32d7191b3 100644 --- a/src/agent_env/agents/agents/opencode/requirements.txt +++ b/src/agent_env/agents/agents/opencode/requirements.txt @@ -1,5 +1,5 @@ # The image installs the newest agentenv-framework-protocol at or above this floor; a release doesn't pin it, so the -# image is built again only when this folder changes. The floor is the first that serves peer-agents/v1's tools, which -# the agent advertises without handlers of its own; raise it when the agent needs a newer protocol. -agentenv-framework-protocol[agent]>=0.1.351 +# image is built again only when this folder changes. The floor is the first whose extension routes take the agent's +# control token; raise it when the agent needs a newer protocol. +agentenv-framework-protocol[agent]>=0.1.582 jsonschema>=4.18,<5 diff --git a/src/agent_env/agents/agents/openhands/requirements.txt b/src/agent_env/agents/agents/openhands/requirements.txt index d218e6533..a6fc7be6e 100644 --- a/src/agent_env/agents/agents/openhands/requirements.txt +++ b/src/agent_env/agents/agents/openhands/requirements.txt @@ -1,6 +1,6 @@ # The image installs the newest agentenv-framework-protocol at or above this floor; a release doesn't pin it, so the -# image is built again only when this folder changes. The floor is the first that serves peer-agents/v1, which the -# agent leaves to the SDK; raise it when the agent needs a newer protocol. -agentenv-framework-protocol[agent]>=0.1.351 +# image is built again only when this folder changes. The floor is the first whose extension routes take the agent's +# control token; raise it when the agent needs a newer protocol. +agentenv-framework-protocol[agent]>=0.1.582 openhands-sdk==1.58.2 openhands-tools==1.58.2 diff --git a/src/agent_env/agents/agents/pi/requirements.txt b/src/agent_env/agents/agents/pi/requirements.txt index 8d60e277c..5d00eb18f 100644 --- a/src/agent_env/agents/agents/pi/requirements.txt +++ b/src/agent_env/agents/agents/pi/requirements.txt @@ -1,2 +1,4 @@ -# The image installs the newest agentenv-framework-protocol at or above this floor; a release doesn't pin it. -agentenv-framework-protocol[agent]>=0.1.305 +# The image installs the newest agentenv-framework-protocol at or above this floor; a release doesn't pin it, so the +# image is built again only when this folder changes. The floor is the first whose extension routes take the agent's +# control token; raise it when the agent needs a newer protocol. +agentenv-framework-protocol[agent]>=0.1.582 diff --git a/src/agent_env/agents/agents/proxy/requirements.txt b/src/agent_env/agents/agents/proxy/requirements.txt index dfa7130a1..5d00eb18f 100644 --- a/src/agent_env/agents/agents/proxy/requirements.txt +++ b/src/agent_env/agents/agents/proxy/requirements.txt @@ -1,3 +1,4 @@ # The image installs the newest agentenv-framework-protocol at or above this floor; a release doesn't pin it, so the -# image is built again only when this folder changes. The floor is the first that ships ProxyAgent and proxy/v1. -agentenv-framework-protocol[agent]>=0.1.370 +# image is built again only when this folder changes. The floor is the first whose extension routes take the agent's +# control token; raise it when the agent needs a newer protocol. +agentenv-framework-protocol[agent]>=0.1.582 diff --git a/src/agent_env/agents/agents/pydantic-ai/requirements.txt b/src/agent_env/agents/agents/pydantic-ai/requirements.txt index cb95b7956..43d2dac10 100644 --- a/src/agent_env/agents/agents/pydantic-ai/requirements.txt +++ b/src/agent_env/agents/agents/pydantic-ai/requirements.txt @@ -1,6 +1,6 @@ # The image installs the newest agentenv-framework-protocol at or above this floor; a release doesn't pin it, so the -# image is built again only when this folder changes. The floor is the first that serves peer-agents/v1, which the -# agent leaves to the SDK; raise it when the agent needs a newer protocol. -agentenv-framework-protocol[agent]>=0.1.351 +# image is built again only when this folder changes. The floor is the first whose extension routes take the agent's +# control token; raise it when the agent needs a newer protocol. +agentenv-framework-protocol[agent]>=0.1.582 pydantic-ai-slim[mcp,openai]==2.61.0 pydantic-ai-harness[coder,skills]==0.61.0 diff --git a/tst/unit/agents/claude_code/test_image_contract.py b/tst/unit/agents/claude_code/test_image_contract.py index 1bd602caf..833e5775c 100644 --- a/tst/unit/agents/claude_code/test_image_contract.py +++ b/tst/unit/agents/claude_code/test_image_contract.py @@ -38,7 +38,7 @@ def test_the_image_installs_the_protocol_alone_from_its_requirements(): requirements = [line for line in (AGENT_DIR / "requirements.txt").read_text().splitlines() if line and not line.startswith("#")] - assert requirements == ["agentenv-framework-protocol[agent]>=0.1.575"] + assert requirements == ["agentenv-framework-protocol[agent]>=0.1.582"] def test_the_image_gives_the_model_node_alone_from_a_pinned_image(): diff --git a/tst/unit/agents/codex/test_image_contract.py b/tst/unit/agents/codex/test_image_contract.py index eec0cd5d3..350cfbf1e 100644 --- a/tst/unit/agents/codex/test_image_contract.py +++ b/tst/unit/agents/codex/test_image_contract.py @@ -54,7 +54,7 @@ def test_the_requirements_are_the_protocol_floor_the_config_writer_and_the_ca_bu requirements = [line for line in (AGENT_DIR / "requirements.txt").read_text().splitlines() if line and not line.startswith("#")] - assert requirements == ["agentenv-framework-protocol[agent]>=0.1.351", "tomli-w==1.2.0", "certifi"] + assert requirements == ["agentenv-framework-protocol[agent]>=0.1.582", "tomli-w==1.2.0", "certifi"] def test_the_image_gives_the_models_python_the_document_libraries(): diff --git a/tst/unit/agents/gemini/test_image_contract.py b/tst/unit/agents/gemini/test_image_contract.py index a982e3620..df35bf148 100644 --- a/tst/unit/agents/gemini/test_image_contract.py +++ b/tst/unit/agents/gemini/test_image_contract.py @@ -54,7 +54,7 @@ def test_the_image_installs_the_protocol_alone_from_its_requirements(): requirements = [line for line in (AGENT_DIR / "requirements.txt").read_text().splitlines() if line and not line.startswith("#")] - assert requirements == ["agentenv-framework-protocol[agent]>=0.1.351"] + assert requirements == ["agentenv-framework-protocol[agent]>=0.1.582"] def test_the_image_gives_the_models_python_the_document_libraries(): diff --git a/tst/unit/agents/opencode/test_image_contract.py b/tst/unit/agents/opencode/test_image_contract.py index 1ada56bdf..3c7d8c68b 100644 --- a/tst/unit/agents/opencode/test_image_contract.py +++ b/tst/unit/agents/opencode/test_image_contract.py @@ -50,7 +50,7 @@ def test_the_requirements_are_the_protocol_floor_and_the_output_format_validator requirements = [line for line in (AGENT_DIR / "requirements.txt").read_text().splitlines() if line and not line.startswith("#")] - assert requirements == ["agentenv-framework-protocol[agent]>=0.1.351", "jsonschema>=4.18,<5"] + assert requirements == ["agentenv-framework-protocol[agent]>=0.1.582", "jsonschema>=4.18,<5"] def test_node_is_pinned_by_version_and_checksum_for_the_image_and_an_install():