π OpenHands: AI-Driven Development
chore: bump agent-server to 1.56.0 (#18670)
OpenHands Botd01d491d1bd0
diff --git a/.agents/skills/local-stack-runtime/references/guide.md b/.agents/skills/local-stack-runtime/references/guide.mdindex 2c753d8e0b..badf0ed477 100644--- a/.agents/skills/local-stack-runtime/references/guide.md+++ b/.agents/skills/local-stack-runtime/references/guide.md@@ -92,10 +92,10 @@ 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.55.1")+ - `OH_AGENT_SERVER_VERSION` β specific PyPI version (e.g., "1.56.0")- `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.55.1` for agent-server SDK libraries+ - Default: released PyPI version `1.56.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.svgnew file mode 100644index 0000000000..9ca5725607--- /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.55.1 -> 1.56.0</text>+ <text x="24" y="104" font-family="monospace" font-size="15" fill="#e6edf3">@openhands/typescript-client: 1.55.1 -> 1.56.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.56.0</text>+</svg>diff --git a/__tests__/scripts/dev-safe.test.ts b/__tests__/scripts/dev-safe.test.tsindex 5e24264c46..c5fccd8049 100644--- a/__tests__/scripts/dev-safe.test.ts+++ b/__tests__/scripts/dev-safe.test.ts@@ -514,20 +514,20 @@ describe("buildAgentServerCommand", () => {// Defaults to the released PyPI version with all SDK packages pinned to same versionexpect(cmd.args).toEqual(["--from",- "openhands-agent-server==1.55.1",+ "openhands-agent-server==1.56.0","--with",- "openhands-sdk==1.55.1",+ "openhands-sdk==1.56.0","--with",- "openhands-tools==1.55.1",+ "openhands-tools==1.56.0","--with",- "openhands-workspace==1.55.1",+ "openhands-workspace==1.56.0","--with","posthog>=6,<7","agent-server","--import-modules","canvas_ui_tool",]);- expect(cmd.source).toBe("PyPI (1.55.1, default)");+ expect(cmd.source).toBe("PyPI (1.56.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.jsonindex d8292086fb..7badc27c8c 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.55.1",+ "agentServer": "1.56.0","agentCanvas": "1.28.0",- "automation": "1.21.0"+ "automation": "1.22.0"},"compatibility": {"minimumAgentServer": "1.51.0"diff --git a/package-lock.json b/package-lock.jsonindex e0ae5681a4..fd1a5209c4 100644--- a/package-lock.json+++ b/package-lock.json@@ -13,8 +13,8 @@"@heroui/react": "2.8.10","@microlink/react-json-view": "1.31.25","@monaco-editor/react": "4.7.0",- "@openhands/extensions": "0.30.0",- "@openhands/typescript-client": "1.55.1",+ "@openhands/extensions": "0.31.0",+ "@openhands/typescript-client": "1.56.0","@react-router/node": "7.18.2","@react-router/serve": "7.18.2","@tailwindcss/vite": "4.3.3",@@ -4138,9 +4138,9 @@"license": "MIT"},"node_modules/@openhands/extensions": {- "version": "0.30.0",- "resolved": "https://registry.npmjs.org/@openhands/extensions/-/extensions-0.30.0.tgz",- "integrity": "sha512-lPyH0iqSow+ARTX4cumR75e3BJmuqpj2YbKm1cqDcI1SQDXfDTr+/wSVH9dQsOmddEP4Zn+uMoLXpKSO/moonA==",+ "version": "0.31.0",+ "resolved": "https://registry.npmjs.org/@openhands/extensions/-/extensions-0.31.0.tgz",+ "integrity": "sha512-F7oApEoq6XZ6+mXP8kny81jmgiXmwuZXmKID/zcXJGYTAxdAxjfrocUFqpWna0qejjpaQR80SA/Mf70klHHMYw==","license": "MIT","engines": {"node": ">=18.20.0"@@ -4152,9 +4152,9 @@}},"node_modules/@openhands/typescript-client": {- "version": "1.55.1",- "resolved": "https://registry.npmjs.org/@openhands/typescript-client/-/typescript-client-1.55.1.tgz",- "integrity": "sha512-/m/7fyJSUNngMf153KakUnlNKtJfeEHYWerDhUdVTL5UKFjE5BnPrt81y0nCDnrGTBTwjE3ZiswsrhzziRMyTw==",+ "version": "1.56.0",+ "resolved": "https://registry.npmjs.org/@openhands/typescript-client/-/typescript-client-1.56.0.tgz",+ "integrity": "sha512-oAySgDdio20LC07XyXEbRz9Nhz3ghMztnpfgVvl89UIXA5NLUwfVw4V7xQ/v8dYRL+QNLWQkfhh0brIPQ5XqZA==","license": "MIT","dependencies": {"@openrouter/sdk": "^1.2.11",diff --git a/package.json b/package.jsonindex a0129aaa44..fe60127fc5 100644--- a/package.json+++ b/package.json@@ -23,8 +23,8 @@"@heroui/react": "2.8.10","@microlink/react-json-view": "1.31.25","@monaco-editor/react": "4.7.0",- "@openhands/extensions": "0.30.0",- "@openhands/typescript-client": "1.55.1",+ "@openhands/extensions": "0.31.0",+ "@openhands/typescript-client": "1.56.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.mjsindex 7220fb5176..9b4ce9a00d 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.55.1 node scripts/check-sdk-version-sync.mjs+ * EXPECTED_SDK_VERSION=1.56.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.55.1"}}'+ -d '{"event_type": "sdk-version-check", "client_payload": {"version": "1.56.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.55.1,<2.0.0"- * "openhands-tools==1.55.1"- * "openhands-workspace (>=1.55.1)"+ * "openhands-sdk>=1.56.0,<2.0.0"+ * "openhands-tools==1.56.0"+ * "openhands-workspace (>=1.56.0)"*/function parseSdkVersionsFromRequiresDist(requiresDist) {const versions = {};@@ -316,7 +316,7 @@ function parseSdkVersionsFromRequiresDist(requiresDist) {}// Extract the version number - look for patterns like:- // ">=1.55.1", "==1.55.1", "(>=1.55.1)", "~=1.55.1"+ // ">=1.56.0", "==1.56.0", "(>=1.56.0)", "~=1.56.0"// After the package name and before any comma or closing parenconst versionPattern = /[><=~!]+\s*([0-9]+(?:\.[0-9]+)*)/;const match = dep.match(versionPattern);diff --git a/scripts/dev-safe.mjs b/scripts/dev-safe.mjsindex 5a3db207ad..f6c19b3958 100644--- a/scripts/dev-safe.mjs+++ b/scripts/dev-safe.mjs@@ -417,7 +417,7 @@ export const AGENT_SERVER_IMPORT_MODULES = "canvas_ui_tool";* 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.55.1")+ * - OH_AGENT_SERVER_VERSION: Specific PyPI version (e.g., "1.56.0")** If none are set, defaults to the released version specified by* DEFAULT_AGENT_SERVER_VERSION. Set OH_AGENT_SERVER_GIT_REF to use adiff --git a/src/mocks/agent-profiles-handlers.ts b/src/mocks/agent-profiles-handlers.tsindex 9b1b8e1891..d71f7d4cf8 100644--- a/src/mocks/agent-profiles-handlers.ts+++ b/src/mocks/agent-profiles-handlers.ts@@ -56,7 +56,6 @@ function makeOpenHandsProfile(agent_kind: "openhands",llm_profile_ref: "default",agent: "CodeActAgent",- skills: [],system_message_suffix: null,condenser: null,verification: DEFAULT_VERIFICATION,