Skip to content

πŸ™Œ OpenHands: AI-Driven Development

chore: bump agent-server SDK to 1.33.0 and automation to 1.1.4 (#1622)

simonrosenbergebeaca4f4d35
diff --git a/.github/workflows/mock-llm-e2e.yml b/.github/workflows/mock-llm-e2e.yml
index 86465f91cb..b3c2767dfa 100644
--- a/.github/workflows/mock-llm-e2e.yml
+++ b/.github/workflows/mock-llm-e2e.yml
@@ -108,7 +108,7 @@ jobs:
- name: Install openhands-sdk (for mock LLM server)
env:
AGENT_SERVER_VERSION: ${{ steps.defaults.outputs.agent_server_version }}
- # Pin agent-client-protocol to the range openhands-sdk 1.32.0 is
+ # Pin agent-client-protocol to the range openhands-sdk 1.33.0 is
# compatible with. acp 0.11.0 reordered the ACP prompt() args and
# breaks the SDK's ACP client; the mock ACP server runs from this
# venv, so keep it on the same acp version as the agent-server.
diff --git a/AGENTS.md b/AGENTS.md
index f6ce2cb4bb..aacf30709b 100644
--- a/AGENTS.md
+++ b/AGENTS.md
@@ -517,10 +517,10 @@ When adding code that needs a new string, decide up front which rule it falls un
- `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.32.0")
+ - `OH_AGENT_SERVER_VERSION` β€” specific PyPI version (e.g., "1.33.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.32.0` for agent-server SDK libraries
+ - Default: released PyPI version `1.33.0` for agent-server SDK libraries
- Security: `scripts/dev-safe.mjs` and `scripts/dev-with-automation.mjs` auto-generate random API keys when needed and persist the defaults so static builds, localStorage, and restarted services stay in sync:
- `SESSION_API_KEY` β€” 64-character hex (256-bit) for agent-server API authentication; persisted at `~/.openhands/agent-canvas/session-api-key.txt` unless overridden via env var
diff --git a/__tests__/scripts/dev-safe.test.ts b/__tests__/scripts/dev-safe.test.ts
index 2ee0e85458..1085c8cb95 100644
--- a/__tests__/scripts/dev-safe.test.ts
+++ b/__tests__/scripts/dev-safe.test.ts
@@ -389,18 +389,18 @@ describe("buildAgentServerCommand", () => {
// Defaults to the released PyPI version with all SDK packages pinned to same version
expect(cmd.args).toEqual([
"--from",
- "openhands-agent-server==1.32.0",
+ "openhands-agent-server==1.33.0",
"--with",
- "openhands-sdk==1.32.0",
+ "openhands-sdk==1.33.0",
"--with",
- "openhands-tools==1.32.0",
+ "openhands-tools==1.33.0",
"--with",
- "openhands-workspace==1.32.0",
+ "openhands-workspace==1.33.0",
"--with",
"agent-client-protocol<0.11",
"agent-server",
]);
- expect(cmd.source).toBe("PyPI (1.32.0, default)");
+ expect(cmd.source).toBe("PyPI (1.33.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 7f120a4524..65ecdb29c6 100644
--- a/config/defaults.json
+++ b/config/defaults.json
@@ -2,9 +2,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.32.0",
+ "agentServer": "1.33.0",
"agentCanvas": "1.1.0",
- "automation": "1.1.3"
+ "automation": "1.1.4"
},
"compatibility": {
@@ -12,7 +12,7 @@
},
"constraints": {
- "_comment": "Temporary upper bound on the agent-client-protocol (acp) transitive dependency. openhands-sdk 1.32.0 requires agent-client-protocol>=0.10.1 with no upper bound, but acp 0.11.0 reordered the ACP prompt() arguments and breaks the SDK's ACP client (a PromptRequest validation error surfaces as 'ACP error: 2 validation errors for PromptRequest'). Pin acp <0.11 until a fixed openhands-sdk ships. Consumed by scripts/dev-safe.mjs (agent-server uvx install) and .github/workflows/mock-llm-e2e.yml (mock ACP server venv).",
+ "_comment": "Temporary upper bound on the agent-client-protocol (acp) transitive dependency. openhands-sdk 1.33.0 requires agent-client-protocol>=0.10.1 with no upper bound, but acp 0.11.0 reordered the ACP prompt() arguments and breaks the SDK's ACP client (a PromptRequest validation error surfaces as 'ACP error: 2 validation errors for PromptRequest'). Pin acp <0.11 until a fixed openhands-sdk ships. Consumed by scripts/dev-safe.mjs (agent-server uvx install) and .github/workflows/mock-llm-e2e.yml (mock ACP server venv).",
"agentClientProtocol": "agent-client-protocol<0.11"
},
diff --git a/scripts/check-sdk-version-sync.mjs b/scripts/check-sdk-version-sync.mjs
index 52ba4273b5..0248be8be8 100644
--- a/scripts/check-sdk-version-sync.mjs
+++ b/scripts/check-sdk-version-sync.mjs
@@ -19,7 +19,7 @@
*
* Usage:
* node scripts/check-sdk-version-sync.mjs
- * EXPECTED_SDK_VERSION=1.32.0 node scripts/check-sdk-version-sync.mjs
+ * EXPECTED_SDK_VERSION=1.33.0 node scripts/check-sdk-version-sync.mjs
* node scripts/check-sdk-version-sync.mjs --check-pypi
*
* Environment variables:
@@ -78,7 +78,7 @@ Triggering from other repos:
-H "Authorization: token \$GITHUB_TOKEN" \\
-H "Accept: application/vnd.github.v3+json" \\
https://api.github.com/repos/OpenHands/agent-canvas/dispatches \\
- -d '{"event_type": "sdk-version-check", "client_payload": {"version": "1.32.0"}}'
+ -d '{"event_type": "sdk-version-check", "client_payload": {"version": "1.33.0"}}'
`);
process.exit(0);
}
@@ -260,9 +260,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.32.0,<2.0.0"
- * "openhands-tools==1.32.0"
- * "openhands-workspace (>=1.32.0)"
+ * "openhands-sdk>=1.33.0,<2.0.0"
+ * "openhands-tools==1.33.0"
+ * "openhands-workspace (>=1.33.0)"
*/
function parseSdkVersionsFromRequiresDist(requiresDist) {
const versions = {};
@@ -276,7 +276,7 @@ function parseSdkVersionsFromRequiresDist(requiresDist) {
}
// Extract the version number - look for patterns like:
- // ">=1.32.0", "==1.32.0", "(>=1.32.0)", "~=1.32.0"
+ // ">=1.33.0", "==1.33.0", "(>=1.33.0)", "~=1.33.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 7cb685764d..449dfd9f13 100644
--- a/scripts/dev-safe.mjs
+++ b/scripts/dev-safe.mjs
@@ -48,7 +48,7 @@ const LOCAL_AGENT_SERVER_SUBDIRS = [
"openhands-workspace",
];
const DEFAULT_AGENT_SERVER_VERSION = SHARED_DEFAULTS.versions.agentServer;
-// Temporary transitive-dep pin: openhands-sdk 1.32.0 leaves agent-client-protocol
+// Temporary transitive-dep pin: openhands-sdk 1.33.0 leaves agent-client-protocol
// unbounded (>=0.10.1), but acp 0.11.0 reordered the ACP prompt() args and breaks
// the SDK's ACP client. Hold acp <0.11 until a fixed SDK ships. See config/defaults.json.
const AGENT_CLIENT_PROTOCOL_CONSTRAINT =
@@ -399,7 +399,7 @@ export function validateFrontendDependencies(
* 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.32.0")
+ * - OH_AGENT_SERVER_VERSION: Specific PyPI version (e.g., "1.33.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