Skip to content

πŸ™Œ OpenHands: AI-Driven Development

chore: bump openhands SDK to v1.22.1 (#14424)

OpenHands Bot6b6810ce16da
diff --git a/dev_config/python/.pre-commit-config.yaml b/dev_config/python/.pre-commit-config.yaml
index 0fd3c2a8d6..0e09696f7d 100644
--- a/dev_config/python/.pre-commit-config.yaml
+++ b/dev_config/python/.pre-commit-config.yaml
@@ -59,8 +59,8 @@ repos:
types-Markdown,
pydantic,
lxml,
- "openhands-sdk==1.19.1",
- "openhands-tools==1.19.1",
+ "openhands-sdk==1.22.1",
+ "openhands-tools==1.22.1",
"sqlalchemy>=2.0",
]
# To see gaps add `--html-report mypy-report/`
diff --git a/enterprise/poetry.lock b/enterprise/poetry.lock
index 41986f11cc..0ba4c0adca 100644
--- a/enterprise/poetry.lock
+++ b/enterprise/poetry.lock
@@ -4291,6 +4291,24 @@ files = [
{file = "joblib-1.5.3.tar.gz", hash = "sha256:8561a3269e6801106863fd0d6d84bb737be9e7631e33aaed3fb9ce5953688da3"},
]
+[[package]]
+name = "joserfc"
+version = "1.6.5"
+description = "The ultimate Python library for JOSE RFCs, including JWS, JWE, JWK, JWA, JWT"
+optional = false
+python-versions = ">=3.9"
+groups = ["main"]
+files = [
+ {file = "joserfc-1.6.5-py3-none-any.whl", hash = "sha256:e9878a0f8243fe7b95e11fdda81374ca9f7a689e302751579d3dfdeec559675e"},
+ {file = "joserfc-1.6.5.tar.gz", hash = "sha256:1482a7db78fb4602e44ed89e51b599d052e091288c7c532c5b694e20149dec48"},
+]
+
+[package.dependencies]
+cryptography = ">=45.0.1"
+
+[package.extras]
+drafts = ["pycryptodome"]
+
[[package]]
name = "json-repair"
version = "0.58.7"
@@ -6409,14 +6427,14 @@ llama = ["llama-index (>=0.12.29,<0.13.0)", "llama-index-core (>=0.12.29,<0.13.0
[[package]]
name = "openhands-agent-server"
-version = "1.21.1"
+version = "1.22.1"
description = "OpenHands Agent Server - REST/WebSocket interface for OpenHands AI Agent"
optional = false
python-versions = ">=3.12"
groups = ["main"]
files = [
- {file = "openhands_agent_server-1.21.1-py3-none-any.whl", hash = "sha256:08e315fef9996215767f04b44ebb48a12553213af87cc1fa79a06ce8e9c0b108"},
- {file = "openhands_agent_server-1.21.1.tar.gz", hash = "sha256:7e3957e3889bc4e63378a61a3b8e5afb8882261ad7c3b07307b0c0bab473ce81"},
+ {file = "openhands_agent_server-1.22.1-py3-none-any.whl", hash = "sha256:a886e314ef64d209e4acf8fac3ee258feb37f8c5ebac375812d3e96274bfcdfe"},
+ {file = "openhands_agent_server-1.22.1.tar.gz", hash = "sha256:ccf534052fa920a877055e570061ef68a1185850f576e82e11e46171ea63bfd4"},
]
[package.dependencies]
@@ -6479,9 +6497,9 @@ memory-profiler = ">=0.61"
numpy = "*"
openai = "2.24"
openhands-aci = "0.3.3"
-openhands-agent-server = "1.21.1"
-openhands-sdk = "1.21.1"
-openhands-tools = "1.21.1"
+openhands-agent-server = "1.22.1"
+openhands-sdk = "1.22.1"
+openhands-tools = "1.22.1"
opentelemetry-api = ">=1.33.1"
opentelemetry-exporter-otlp-proto-grpc = ">=1.33.1"
orjson = ">=3.11.6"
@@ -6533,14 +6551,14 @@ url = ".."
[[package]]
name = "openhands-sdk"
-version = "1.21.1"
+version = "1.22.1"
description = "OpenHands SDK - Core functionality for building AI agents"
optional = false
python-versions = ">=3.12"
groups = ["main"]
files = [
- {file = "openhands_sdk-1.21.1-py3-none-any.whl", hash = "sha256:028660d3b92f7379c7fc8e07b546ca710506cee2c1925557126958b3f07dd2f2"},
- {file = "openhands_sdk-1.21.1.tar.gz", hash = "sha256:ec3097ca02bd565175f9a414a6791b2c5b88f48ae5f42ee44cb9e619d8b489fa"},
+ {file = "openhands_sdk-1.22.1-py3-none-any.whl", hash = "sha256:0d77190ff1e4f5face22ed284cdc54927e6db708825d6b35c961e9410aebdd52"},
+ {file = "openhands_sdk-1.22.1.tar.gz", hash = "sha256:1b64c5738182d4f22f1fe3ef0a0f0997ebe74c856fef5d1ac4a685945c2f6eca"},
]
[package.dependencies]
@@ -6550,6 +6568,7 @@ fakeredis = {version = ">=2.32.1", extras = ["lua"]}
fastmcp = ">=3.0.0"
filelock = ">=3.20.1"
httpx = {version = ">=0.27.0", extras = ["socks"]}
+joserfc = ">=1.0.0"
litellm = ">=1.83.7"
lmnr = ">=0.7.47"
pillow = ">=12.1.1"
@@ -6564,14 +6583,14 @@ boto3 = ["boto3 (>=1.35.0)"]
[[package]]
name = "openhands-tools"
-version = "1.21.1"
+version = "1.22.1"
description = "OpenHands Tools - Runtime tools for AI agents"
optional = false
python-versions = ">=3.12"
groups = ["main"]
files = [
- {file = "openhands_tools-1.21.1-py3-none-any.whl", hash = "sha256:d606b9aaf8315308ce10bef8a614e7f42ae1eef6f1ecf553d599f6feebf0236d"},
- {file = "openhands_tools-1.21.1.tar.gz", hash = "sha256:046c6d032f738f3f285dd82f8b942483e95a71aa154834112d366cdb1bdc3265"},
+ {file = "openhands_tools-1.22.1-py3-none-any.whl", hash = "sha256:25daab0cf9c3909a21b05e29385e415de157eba975f0b280f2dd3ea1dfafcc3a"},
+ {file = "openhands_tools-1.22.1.tar.gz", hash = "sha256:452761ace7c4906cde889cf6ebf32e94674bf69a9f954423c0243f6b2996fca3"},
]
[package.dependencies]
diff --git a/openhands/app_server/sandbox/sandbox_spec_service.py b/openhands/app_server/sandbox/sandbox_spec_service.py
index 1575390eb4..6949752b4d 100644
--- a/openhands/app_server/sandbox/sandbox_spec_service.py
+++ b/openhands/app_server/sandbox/sandbox_spec_service.py
@@ -13,7 +13,7 @@ from openhands.sdk.utils.models import DiscriminatedUnionMixin
# The version of the agent server to use for deployments.
# Typically this will be the same as the values from the pyproject.toml
-AGENT_SERVER_IMAGE = 'ghcr.io/openhands/agent-server:1.21.1-python'
+AGENT_SERVER_IMAGE = 'ghcr.io/openhands/agent-server:1.22.1-python'
class SandboxSpecService(ABC):
diff --git a/poetry.lock b/poetry.lock
index 0de1cce43a..3ff69b41e7 100644
--- a/poetry.lock
+++ b/poetry.lock
@@ -4056,6 +4056,24 @@ files = [
{file = "joblib-1.5.3.tar.gz", hash = "sha256:8561a3269e6801106863fd0d6d84bb737be9e7631e33aaed3fb9ce5953688da3"},
]
+[[package]]
+name = "joserfc"
+version = "1.6.5"
+description = "The ultimate Python library for JOSE RFCs, including JWS, JWE, JWK, JWA, JWT"
+optional = false
+python-versions = ">=3.9"
+groups = ["main"]
+files = [
+ {file = "joserfc-1.6.5-py3-none-any.whl", hash = "sha256:e9878a0f8243fe7b95e11fdda81374ca9f7a689e302751579d3dfdeec559675e"},
+ {file = "joserfc-1.6.5.tar.gz", hash = "sha256:1482a7db78fb4602e44ed89e51b599d052e091288c7c532c5b694e20149dec48"},
+]
+
+[package.dependencies]
+cryptography = ">=45.0.1"
+
+[package.extras]
+drafts = ["pycryptodome"]
+
[[package]]
name = "json-repair"
version = "0.58.7"
@@ -6169,14 +6187,14 @@ llama = ["llama-index (>=0.12.29,<0.13.0)", "llama-index-core (>=0.12.29,<0.13.0
[[package]]
name = "openhands-agent-server"
-version = "1.21.1"
+version = "1.22.1"
description = "OpenHands Agent Server - REST/WebSocket interface for OpenHands AI Agent"
optional = false
python-versions = ">=3.12"
groups = ["main"]
files = [
- {file = "openhands_agent_server-1.21.1-py3-none-any.whl", hash = "sha256:08e315fef9996215767f04b44ebb48a12553213af87cc1fa79a06ce8e9c0b108"},
- {file = "openhands_agent_server-1.21.1.tar.gz", hash = "sha256:7e3957e3889bc4e63378a61a3b8e5afb8882261ad7c3b07307b0c0bab473ce81"},
+ {file = "openhands_agent_server-1.22.1-py3-none-any.whl", hash = "sha256:a886e314ef64d209e4acf8fac3ee258feb37f8c5ebac375812d3e96274bfcdfe"},
+ {file = "openhands_agent_server-1.22.1.tar.gz", hash = "sha256:ccf534052fa920a877055e570061ef68a1185850f576e82e11e46171ea63bfd4"},
]
[package.dependencies]
@@ -6193,14 +6211,14 @@ wsproto = ">=1.2.0"
[[package]]
name = "openhands-sdk"
-version = "1.21.1"
+version = "1.22.1"
description = "OpenHands SDK - Core functionality for building AI agents"
optional = false
python-versions = ">=3.12"
groups = ["main"]
files = [
- {file = "openhands_sdk-1.21.1-py3-none-any.whl", hash = "sha256:028660d3b92f7379c7fc8e07b546ca710506cee2c1925557126958b3f07dd2f2"},
- {file = "openhands_sdk-1.21.1.tar.gz", hash = "sha256:ec3097ca02bd565175f9a414a6791b2c5b88f48ae5f42ee44cb9e619d8b489fa"},
+ {file = "openhands_sdk-1.22.1-py3-none-any.whl", hash = "sha256:0d77190ff1e4f5face22ed284cdc54927e6db708825d6b35c961e9410aebdd52"},
+ {file = "openhands_sdk-1.22.1.tar.gz", hash = "sha256:1b64c5738182d4f22f1fe3ef0a0f0997ebe74c856fef5d1ac4a685945c2f6eca"},
]
[package.dependencies]
@@ -6210,6 +6228,7 @@ fakeredis = {version = ">=2.32.1", extras = ["lua"]}
fastmcp = ">=3.0.0"
filelock = ">=3.20.1"
httpx = {version = ">=0.27.0", extras = ["socks"]}
+joserfc = ">=1.0.0"
litellm = ">=1.83.7"
lmnr = ">=0.7.47"
pillow = ">=12.1.1"
@@ -6224,14 +6243,14 @@ boto3 = ["boto3 (>=1.35.0)"]
[[package]]
name = "openhands-tools"
-version = "1.21.1"
+version = "1.22.1"
description = "OpenHands Tools - Runtime tools for AI agents"
optional = false
python-versions = ">=3.12"
groups = ["main"]
files = [
- {file = "openhands_tools-1.21.1-py3-none-any.whl", hash = "sha256:d606b9aaf8315308ce10bef8a614e7f42ae1eef6f1ecf553d599f6feebf0236d"},
- {file = "openhands_tools-1.21.1.tar.gz", hash = "sha256:046c6d032f738f3f285dd82f8b942483e95a71aa154834112d366cdb1bdc3265"},
+ {file = "openhands_tools-1.22.1-py3-none-any.whl", hash = "sha256:25daab0cf9c3909a21b05e29385e415de157eba975f0b280f2dd3ea1dfafcc3a"},
+ {file = "openhands_tools-1.22.1.tar.gz", hash = "sha256:452761ace7c4906cde889cf6ebf32e94674bf69a9f954423c0243f6b2996fca3"},
]
[package.dependencies]
@@ -14536,4 +14555,4 @@ cffi = ["cffi (>=1.17,<2.0) ; platform_python_implementation != \"PyPy\" and pyt
[metadata]
lock-version = "2.1"
python-versions = "^3.12,<3.14"
-content-hash = "bc6b7398755252a129caf3011abe7ea70988c205fab08f1e18c15c7dbf3da4e0"
+content-hash = "4d8b8eb2c4338968973606b28811f3330bd70062b66059ee1e9f6e9b494a1f8d"
diff --git a/pyproject.toml b/pyproject.toml
index d8feec9991..8aea30552e 100644
--- a/pyproject.toml
+++ b/pyproject.toml
@@ -58,9 +58,9 @@ dependencies = [
"numpy",
"openai==2.24",
"openhands-aci==0.3.3",
- "openhands-agent-server==1.21.1",
- "openhands-sdk==1.21.1",
- "openhands-tools==1.21.1",
+ "openhands-agent-server==1.22.1",
+ "openhands-sdk==1.22.1",
+ "openhands-tools==1.22.1",
"opentelemetry-api>=1.33.1",
"opentelemetry-exporter-otlp-proto-grpc>=1.33.1",
"orjson>=3.11.6",
@@ -246,9 +246,9 @@ e2b-code-interpreter = { version = "^2.0.0", optional = true }
pybase62 = "^1.0.0"
# V1 dependencies
-openhands-sdk = "1.21.1"
-openhands-agent-server = "1.21.1"
-openhands-tools = "1.21.1"
+openhands-sdk = "==1.22.1"
+openhands-agent-server = "==1.22.1"
+openhands-tools = "==1.22.1"
jwcrypto = ">=1.5.6"
sqlalchemy = { extras = [ "asyncio" ], version = "^2.0.40" }
pg8000 = "^1.31.5"
diff --git a/uv.lock b/uv.lock
index 846fbab7ad..404be28430 100644
--- a/uv.lock
+++ b/uv.lock
@@ -3522,7 +3522,7 @@ wheels = [
[[package]]
name = "openhands-agent-server"
-version = "1.19.1"
+version = "1.22.1"
source = { registry = "https://pypi.org/simple" }
dependencies = [
{ name = "aiosqlite" },
@@ -3536,9 +3536,9 @@ dependencies = [
{ name = "websockets" },
{ name = "wsproto" },
]
-sdist = { url = "https://files.pythonhosted.org/packages/60/11/351784b7c6e92583f9832081e9fd7f82984cc9f3e51bb62511df3a138119/openhands_agent_server-1.19.1.tar.gz", hash = "sha256:0cb8d6a681b0645e1e2391e81466436b5573a56f8985e76620902dab2bcc5092", size = 88827, upload-time = "2026-04-30T17:06:46.015Z" }
+sdist = { url = "https://files.pythonhosted.org/packages/5f/01/a410336b35bd183ca064da45f7f404c8518d613ff18a25496f0abaa1ff29/openhands_agent_server-1.22.1.tar.gz", hash = "sha256:ccf534052fa920a877055e570061ef68a1185850f576e82e11e46171ea63bfd4", size = 124200, upload-time = "2026-05-15T05:00:09.792Z" }
wheels = [
- { url = "https://files.pythonhosted.org/packages/af/5a/d5080844f3bd97c51ad1e24db78520aff6f97458035989a3f16a57503b7d/openhands_agent_server-1.19.1-py3-none-any.whl", hash = "sha256:4c685bcf7f941f087878f51dca2071a110fea360798da4020fc89b034bee7fda", size = 105530, upload-time = "2026-04-30T17:06:48.528Z" },
+ { url = "https://files.pythonhosted.org/packages/e1/be/8cc6e2555dd7ba1c7bb6d0534cf0bcab32eff82cff29592c9247f98854b1/openhands_agent_server-1.22.1-py3-none-any.whl", hash = "sha256:a886e314ef64d209e4acf8fac3ee258feb37f8c5ebac375812d3e96274bfcdfe", size = 146427, upload-time = "2026-05-15T05:00:12.573Z" },
]
[[package]]
@@ -3691,16 +3691,16 @@ requires-dist = [
{ name = "jwcrypto", specifier = ">=1.5.6" },
{ name = "kubernetes", specifier = ">=33.1" },
{ name = "libtmux", specifier = ">=0.46.2" },
- { name = "litellm", specifier = ">=1.83.14,<1.83.15" },
+ { name = "litellm", specifier = ">=1.83.14" },
{ name = "lmnr", specifier = ">=0.7.20" },
{ name = "mcp", specifier = ">=1.25" },
{ name = "memory-profiler", specifier = ">=0.61" },
{ name = "numpy" },
{ name = "openai", specifier = "==2.24" },
{ name = "openhands-aci", specifier = "==0.3.3" },
- { name = "openhands-agent-server", specifier = "==1.19.1" },
- { name = "openhands-sdk", specifier = "==1.19.1" },
- { name = "openhands-tools", specifier = "==1.19.1" },
+ { name = "openhands-agent-server", specifier = "==1.22.1" },
+ { name = "openhands-sdk", specifier = "==1.22.1" },
+ { name = "openhands-tools", specifier = "==1.22.1" },
{ name = "opentelemetry-api", specifier = ">=1.33.1" },
{ name = "opentelemetry-exporter-otlp-proto-grpc", specifier = ">=1.33.1" },
{ name = "orjson", specifier = ">=3.11.6" },
@@ -3777,7 +3777,7 @@ test = [
[[package]]
name = "openhands-sdk"
-version = "1.19.1"
+version = "1.22.1"
source = { registry = "https://pypi.org/simple" }
dependencies = [
{ name = "agent-client-protocol" },
@@ -3786,22 +3786,24 @@ dependencies = [
{ name = "fastmcp" },
{ name = "filelock" },
{ name = "httpx", extra = ["socks"] },
+ { name = "joserfc" },
{ name = "litellm" },
{ name = "lmnr" },
+ { name = "pillow" },
{ name = "pydantic" },
{ name = "python-frontmatter" },
{ name = "python-json-logger" },
{ name = "tenacity" },
{ name = "websockets" },
]
-sdist = { url = "https://files.pythonhosted.org/packages/eb/d6/6785ee1485aa552ebab25ff3afe6e1fa460606bea0c6f089e1adefb1d849/openhands_sdk-1.19.1.tar.gz", hash = "sha256:1e9a758649ae516259c965778b891592c38e232de6bcab53036ba05f6fc53551", size = 410533, upload-time = "2026-04-30T17:06:49.432Z" }
+sdist = { url = "https://files.pythonhosted.org/packages/64/78/355bbfd2994f7ecbeb1643108ca582d4741568d66f2de8bba4a4e71fd68b/openhands_sdk-1.22.1.tar.gz", hash = "sha256:1b64c5738182d4f22f1fe3ef0a0f0997ebe74c856fef5d1ac4a685945c2f6eca", size = 445599, upload-time = "2026-05-15T05:00:16.991Z" }
wheels = [
- { url = "https://files.pythonhosted.org/packages/ef/40/771077b17f429c42d916f913ef42fcf8a7f980112dffd3ef6bede3e6c7ff/openhands_sdk-1.19.1-py3-none-any.whl", hash = "sha256:fd2c7ed11663595f6131b5e1879f636ad1dd4d897490b582509c924ca238a150", size = 513989, upload-time = "2026-04-30T17:06:47.421Z" },
+ { url = "https://files.pythonhosted.org/packages/9d/ba/be74f1a7e0c17e354bbd3c0dbe5b3b449cc108c01e87b46966613413ce11/openhands_sdk-1.22.1-py3-none-any.whl", hash = "sha256:0d77190ff1e4f5face22ed284cdc54927e6db708825d6b35c961e9410aebdd52", size = 553742, upload-time = "2026-05-15T05:00:15.399Z" },
]
[[package]]
name = "openhands-tools"
-version = "1.19.1"
+version = "1.22.1"
source = { registry = "https://pypi.org/simple" }
dependencies = [
{ name = "bashlex" },
@@ -3814,9 +3816,9 @@ dependencies = [
{ name = "pydantic" },
{ name = "tom-swe" },
]
-sdist = { url = "https://files.pythonhosted.org/packages/21/a8/84edceda6a3717e502b8932cffa823f3b3b7932701aa8606c92fc3d1049b/openhands_tools-1.19.1.tar.gz", hash = "sha256:0634a0e24e4fd87f05f902ff97e5cd30dd909d5cb2b137aae4470902f800f3db", size = 131629, upload-time = "2026-04-30T17:06:43.216Z" }
+sdist = { url = "https://files.pythonhosted.org/packages/09/a0/a93516014853bf386156cb7da518be2f3c572181e805d50a5c3bde8ab1dc/openhands_tools-1.22.1.tar.gz", hash = "sha256:452761ace7c4906cde889cf6ebf32e94674bf69a9f954423c0243f6b2996fca3", size = 134057, upload-time = "2026-05-15T05:00:18.632Z" }
wheels = [
- { url = "https://files.pythonhosted.org/packages/04/58/cc921dc110aab691b170fec788901cb502e78c460cc45f344cccb90fe1d4/openhands_tools-1.19.1-py3-none-any.whl", hash = "sha256:695b04399f8f7018aba937d4e0eb97c7caa0111538e9620b46871f5f62726c14", size = 175360, upload-time = "2026-04-30T17:06:45.085Z" },
+ { url = "https://files.pythonhosted.org/packages/1c/b2/5cb51a606b6f4cd9d626646906f8bf9be4213ad815bc1c1304fe1b1712b2/openhands_tools-1.22.1-py3-none-any.whl", hash = "sha256:25daab0cf9c3909a21b05e29385e415de157eba975f0b280f2dd3ea1dfafcc3a", size = 177673, upload-time = "2026-05-15T05:00:13.855Z" },
]
[[package]]