Skip to content

πŸ™Œ OpenHands: AI-Driven Development

chore: bump agent-server to 1.57.0 (#18774)

OpenHands Botfcc15b45b9da
diff --git a/.agents/skills/local-stack-runtime/references/guide.md b/.agents/skills/local-stack-runtime/references/guide.md
index 906065c61d..ee9950ac29 100644
--- a/.agents/skills/local-stack-runtime/references/guide.md
+++ b/.agents/skills/local-stack-runtime/references/guide.md
@@ -93,11 +93,11 @@ you are running inside of β€” NOT the automation backend.
- `scripts/dev-safe.mjs` uses `uvx` for temporary agent-server installation β€” no permanent `uv tool install` needed. Environment variables (highest precedence first):
- `OH_AGENT_SERVER_LOCAL_PATH` β€” absolute path to a local `software-agent-sdk` checkout. Runs the local checkout via `uvx` with `--with-editable` for `openhands-sdk`/`openhands-tools`/`openhands-workspace` and `--reinstall` for `openhands-agent-server`, so SDK edits are picked up on restart. Highest precedence.
- `OH_AGENT_SERVER_GIT_REF` β€” git commit SHA or branch name (takes precedence over version)
- - `OH_AGENT_SERVER_VERSION` β€” specific PyPI version (e.g., "1.56.0")
+ - `OH_AGENT_SERVER_VERSION` β€” specific PyPI version (e.g., "1.57.0")
- `UV_PYTHON` β€” Python version or range uvx may use for agent-server and automation. Defaults to `python.uvxRequest` in `config/defaults.json` (`>=3.12,<3.15`), so a machine with no supported Python downloads the newest 3.14 instead of the newest CPython, whose wheels the SDK's compiled dependencies lag behind (#18654).
- `OH_SECRET_KEY` β€” secret key for settings encryption; auto-generated and persisted to `~/.openhands/agent-canvas/secret-key.txt` on first run (same file Docker uses), ensuring dev mode and Docker share the same key when both mount the same `~/.openhands` directory. Override with the env var to pin a specific key.
- `SESSION_API_KEY` / `OH_SESSION_API_KEYS_0` / `VITE_SESSION_API_KEY` β€” session API key for agent-server authentication; auto-generated using `crypto.randomBytes(32)` if not set, passed to both agent-server (`OH_SESSION_API_KEYS_0`) and frontend (`VITE_SESSION_API_KEY`)
- - Default: released PyPI version `1.56.0` for agent-server SDK libraries
+ - Default: released PyPI version `1.57.0` for agent-server SDK libraries
- Security: launchers generate and persist a 64-character session API key at `~/.openhands/agent-canvas/session-api-key.txt` unless overridden. The agent-server and automation backend share that session key. `OH_SECRET_KEY` protects settings encryption and is persisted separately at `~/.openhands/agent-canvas/secret-key.txt`.
- `scripts/dev-safe.mjs` should fail fast if `uvx` cannot be spawned (for example missing PATH entries).
diff --git a/.pr/sdk-version-bump.svg b/.pr/sdk-version-bump.svg
new file mode 100644
index 0000000000..02415b0cd9
--- /dev/null
+++ b/.pr/sdk-version-bump.svg
@@ -0,0 +1,7 @@
+<svg xmlns="http://www.w3.org/2000/svg" width="620" height="260" viewBox="0 0 620 260">
+ <rect width="100%" height="100%" fill="#0d1117"/>
+ <text x="24" y="40" font-family="monospace" font-size="18" fill="#3fb950">SDK version bump evidence</text>
+ <text x="24" y="76" font-family="monospace" font-size="15" fill="#e6edf3">versions.agentServer: 1.56.0 -> 1.57.0</text>
+ <text x="24" y="104" font-family="monospace" font-size="15" fill="#e6edf3">@openhands/typescript-client: 1.56.0 -> 1.57.0</text>
+ <text x="24" y="132" font-family="monospace" font-size="15" fill="#e6edf3">package.json/package-lock.json + doc/test literals synced to 1.57.0</text>
+</svg>
diff --git a/__tests__/scripts/dev-safe.test.ts b/__tests__/scripts/dev-safe.test.ts
index a3e3fdf823..be8d8d8249 100644
--- a/__tests__/scripts/dev-safe.test.ts
+++ b/__tests__/scripts/dev-safe.test.ts
@@ -544,20 +544,20 @@ describe("buildAgentServerCommand", () => {
"--python",
">=3.12,<3.15",
"--from",
- "openhands-agent-server==1.56.0",
+ "openhands-agent-server==1.57.0",
"--with",
- "openhands-sdk==1.56.0",
+ "openhands-sdk==1.57.0",
"--with",
- "openhands-tools==1.56.0",
+ "openhands-tools==1.57.0",
"--with",
- "openhands-workspace==1.56.0",
+ "openhands-workspace==1.57.0",
"--with",
"posthog>=6,<7",
"agent-server",
"--import-modules",
"canvas_ui_tool",
]);
- expect(cmd.source).toBe("PyPI (1.56.0, default)");
+ expect(cmd.source).toBe("PyPI (1.57.0, default)");
});
it("uses specific PyPI version when OH_AGENT_SERVER_VERSION is set with all packages pinned", () => {
diff --git a/config/defaults.json b/config/defaults.json
index 6c6ed9302c..8da623237e 100644
--- a/config/defaults.json
+++ b/config/defaults.json
@@ -1,9 +1,9 @@
{
"_comment": "Single source of truth for version pins, ports, paths, and defaults shared across the npm and Docker install paths. Read by scripts/dev-safe.mjs, scripts/dev-with-automation.mjs, docker/entrypoint.sh (via generated defaults.env), and .github/workflows/docker.yml.",
"versions": {
- "agentServer": "1.56.0",
+ "agentServer": "1.57.0",
"agentCanvas": "1.30.0",
- "automation": "1.22.0"
+ "automation": "1.23.2"
},
"compatibility": {
"minimumAgentServer": "1.55.0"
diff --git a/package-lock.json b/package-lock.json
index 95e964032f..95b86a402c 100644
--- a/package-lock.json
+++ b/package-lock.json
@@ -14,7 +14,7 @@
"@microlink/react-json-view": "1.31.25",
"@monaco-editor/react": "4.7.0",
"@openhands/extensions": "0.33.0",
- "@openhands/typescript-client": "1.56.0",
+ "@openhands/typescript-client": "1.57.0",
"@react-router/node": "7.18.2",
"@react-router/serve": "7.18.2",
"@tailwindcss/vite": "4.3.3",
@@ -4152,9 +4152,9 @@
}
},
"node_modules/@openhands/typescript-client": {
- "version": "1.56.0",
- "resolved": "https://registry.npmjs.org/@openhands/typescript-client/-/typescript-client-1.56.0.tgz",
- "integrity": "sha512-oAySgDdio20LC07XyXEbRz9Nhz3ghMztnpfgVvl89UIXA5NLUwfVw4V7xQ/v8dYRL+QNLWQkfhh0brIPQ5XqZA==",
+ "version": "1.57.0",
+ "resolved": "https://registry.npmjs.org/@openhands/typescript-client/-/typescript-client-1.57.0.tgz",
+ "integrity": "sha512-H5rc1VSdzSKw0Qrko41omPlM+ofGszfJAvf/bqhL/lyMnEvQFI5fpO5l6DrqVqyHIkPo5A8dpJcWhoglddQAsw==",
"license": "MIT",
"dependencies": {
"@openrouter/sdk": "^1.2.11",
diff --git a/package.json b/package.json
index 4f9b7bc59d..1acfc75b68 100644
--- a/package.json
+++ b/package.json
@@ -24,7 +24,7 @@
"@microlink/react-json-view": "1.31.25",
"@monaco-editor/react": "4.7.0",
"@openhands/extensions": "0.33.0",
- "@openhands/typescript-client": "1.56.0",
+ "@openhands/typescript-client": "1.57.0",
"@react-router/node": "7.18.2",
"@react-router/serve": "7.18.2",
"@tailwindcss/vite": "4.3.3",
diff --git a/scripts/check-sdk-version-sync.mjs b/scripts/check-sdk-version-sync.mjs
index 9b4ce9a00d..71dd2a8c39 100644
--- a/scripts/check-sdk-version-sync.mjs
+++ b/scripts/check-sdk-version-sync.mjs
@@ -26,7 +26,7 @@
*
* Usage:
* node scripts/check-sdk-version-sync.mjs
- * EXPECTED_SDK_VERSION=1.56.0 node scripts/check-sdk-version-sync.mjs
+ * EXPECTED_SDK_VERSION=1.57.0 node scripts/check-sdk-version-sync.mjs
* node scripts/check-sdk-version-sync.mjs --check-pypi
*
* Environment variables:
@@ -85,7 +85,7 @@ Triggering from other repos:
-H "Authorization: token \$GITHUB_TOKEN" \\
-H "Accept: application/vnd.github.v3+json" \\
https://api.github.com/repos/OpenHands/OpenHands/dispatches \\
- -d '{"event_type": "sdk-version-check", "client_payload": {"version": "1.56.0"}}'
+ -d '{"event_type": "sdk-version-check", "client_payload": {"version": "1.57.0"}}'
`);
process.exit(0);
}
@@ -300,9 +300,9 @@ async function fetchPyPIDependencies(packageName, version) {
* Parse PyPI requires_dist array and extract SDK package versions
*
* PyPI returns dependencies in PEP 508 format like:
- * "openhands-sdk>=1.56.0,<2.0.0"
- * "openhands-tools==1.56.0"
- * "openhands-workspace (>=1.56.0)"
+ * "openhands-sdk>=1.57.0,<2.0.0"
+ * "openhands-tools==1.57.0"
+ * "openhands-workspace (>=1.57.0)"
*/
function parseSdkVersionsFromRequiresDist(requiresDist) {
const versions = {};
@@ -316,7 +316,7 @@ function parseSdkVersionsFromRequiresDist(requiresDist) {
}
// Extract the version number - look for patterns like:
- // ">=1.56.0", "==1.56.0", "(>=1.56.0)", "~=1.56.0"
+ // ">=1.57.0", "==1.57.0", "(>=1.57.0)", "~=1.57.0"
// After the package name and before any comma or closing paren
const versionPattern = /[><=~!]+\s*([0-9]+(?:\.[0-9]+)*)/;
const match = dep.match(versionPattern);
diff --git a/scripts/dev-safe.mjs b/scripts/dev-safe.mjs
index 3438155981..e3401391a9 100644
--- a/scripts/dev-safe.mjs
+++ b/scripts/dev-safe.mjs
@@ -442,7 +442,7 @@ export function buildUvxPythonArgs(env = process.env) {
* edits are picked up without a manual reinstall. The agent-server itself
* is rebuilt from local source on each invocation (--reinstall).
* - OH_AGENT_SERVER_GIT_REF: Git commit SHA or branch name
- * - OH_AGENT_SERVER_VERSION: Specific PyPI version (e.g., "1.56.0")
+ * - OH_AGENT_SERVER_VERSION: Specific PyPI version (e.g., "1.57.0")
*
* If none are set, defaults to the released version specified by
* DEFAULT_AGENT_SERVER_VERSION. Set OH_AGENT_SERVER_GIT_REF to use a