π OpenHands: AI-Driven Development
chore: bump released agent runtime dependencies (#17489)
Graham Neubig06ae3cfa1ee6
diff --git a/.github/workflows/docker.yml b/.github/workflows/docker.ymlindex cd18509e26..eabe69d117 100644--- a/.github/workflows/docker.yml+++ b/.github/workflows/docker.yml@@ -196,6 +196,7 @@ jobs:tags: ${{ steps.prep.outputs.tags }}build-args: |AGENT_SERVER_IMAGE=${{ steps.prep.outputs.agent_server_image }}+ AGENT_SERVER_VERSION=${{ steps.config.outputs.agent_server_version }}AUTOMATION_VERSION=${{ steps.prep.outputs.automation_version }}AGENT_CANVAS_VERSION=${{ steps.config.outputs.agent_canvas_version }}OPENHANDS_BUILD_GIT_SHA=${{ env.RELEVANT_SHA }}diff --git a/AGENTS.md b/AGENTS.mdindex 0f5b14a943..06b1c07274 100644--- a/AGENTS.md+++ b/AGENTS.md@@ -581,10 +581,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.48.0")+ - `OH_AGENT_SERVER_VERSION` β specific PyPI version (e.g., "1.49.1")- `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.48.0` for agent-server SDK libraries+ - Default: released PyPI version `1.49.1` 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/__tests__/components/automations/recommended-automations.test.tsx b/__tests__/components/automations/recommended-automations.test.tsxindex 5a40b24af2..fb30753b5a 100644--- a/__tests__/components/automations/recommended-automations.test.tsx+++ b/__tests__/components/automations/recommended-automations.test.tsx@@ -154,7 +154,7 @@ function settingsWithGithubMcp() {function continueGithubResponderLocally() {fireEvent.click(- screen.getByTestId("recommended-automation-card-github-pr-reviewer"),+ screen.getByTestId("recommended-automation-card-github-repo-monitor"),);const continueButton = screen.getByTestId("responder-deployment-continue-local",@@ -215,6 +215,7 @@ describe("recommended automations", () => {"slack-standup-digest","linear-triage-assistant","linear-issue-to-github-pr",+ "gitlab-issue-to-mr","linear-issue-to-gitlab-mr","linear-issue-to-bitbucket-pr","jira-issue-to-pr",@@ -222,6 +223,8 @@ describe("recommended automations", () => {"jira-issue-to-gitlab-mr","research-brief-writer","jira-issue-to-bitbucket-pr",+ "github-delivery-watchdog",+ "github-issue-triage","upstream-fork-sync","incident-retrospective-drafter",]);@@ -247,7 +250,7 @@ describe("recommended automations", () => {expect(betaHeading).toHaveTextContent(I18nKey.RECOMMENDED_AUTOMATIONS$BETA_LABEL,);- expect(within(betaHeading).getByText("13")).toBeInTheDocument();+ expect(within(betaHeading).getByText("16")).toBeInTheDocument();const betaSection = screen.getByTestId("recommended-automations-beta-section",@@ -630,7 +633,7 @@ describe("recommended automations", () => {renderLauncher();fireEvent.click(- screen.getByTestId("recommended-automation-card-github-pr-reviewer"),+ screen.getByTestId("recommended-automation-card-github-repo-monitor"),);fireEvent.click(screen.getByTestId("responder-deployment-continue-local"));@@ -680,7 +683,7 @@ describe("recommended automations", () => {await waitFor(() =>expect(mockNavigate).toHaveBeenCalledWith(- "/automations/new/github-pr-reviewer",+ "/automations/new/github-repo-monitor",),);expect(mockCreateSecret).not.toHaveBeenCalled();@@ -864,7 +867,7 @@ describe("recommended automations", () => {renderLauncher();fireEvent.click(- screen.getByTestId("recommended-automation-card-github-pr-reviewer"),+ screen.getByTestId("recommended-automation-card-github-repo-monitor"),);fireEvent.click(screen.getByTestId("responder-deployment-continue-local"));@@ -880,12 +883,12 @@ describe("recommended automations", () => {renderLauncher();fireEvent.click(- screen.getByTestId("recommended-automation-card-github-pr-reviewer"),+ screen.getByTestId("recommended-automation-card-github-repo-monitor"),);fireEvent.click(screen.getByTestId("responder-deployment-continue-local"));// The launch is now in flight; re-selecting the card must not launch again.fireEvent.click(- screen.getByTestId("recommended-automation-card-github-pr-reviewer"),+ screen.getByTestId("recommended-automation-card-github-repo-monitor"),);await waitFor(() => expect(mockNavigate).toHaveBeenCalledTimes(1));@@ -958,7 +961,7 @@ describe("recommended automations", () => {renderLauncher();fireEvent.click(- screen.getByTestId("recommended-automation-card-github-pr-reviewer"),+ screen.getByTestId("recommended-automation-card-github-repo-monitor"),);fireEvent.click(screen.getByTestId("responder-deployment-continue-local"));await screen.findByTestId("mcp-install-modal");@@ -971,7 +974,7 @@ describe("recommended automations", () => {await waitFor(() => expect(createSpy).toHaveBeenCalledTimes(1));await waitFor(() =>expect(mockNavigate).toHaveBeenCalledWith(- "/automations/new/github-pr-reviewer",+ "/automations/new/github-repo-monitor",),);});@@ -982,7 +985,7 @@ describe("recommended automations", () => {renderLauncher();fireEvent.click(- screen.getByTestId("recommended-automation-card-github-pr-reviewer"),+ screen.getByTestId("recommended-automation-card-github-repo-monitor"),);fireEvent.click(screen.getByTestId("responder-deployment-open-openhands-cloud"),diff --git a/__tests__/manifests/automation-setup.test.ts b/__tests__/manifests/automation-setup.test.tsindex bce1e3781a..cea7af550b 100644--- a/__tests__/manifests/automation-setup.test.ts+++ b/__tests__/manifests/automation-setup.test.ts@@ -418,6 +418,7 @@ describe("deriveErrorMap", () => {"trigger.schedule": ["schedule"],"trigger.timezone": ["timezone"],"template.config.repos": ["repositories"],+ "template.config.github_token_secret": ["githubTokenSecret"],"template.config.trigger_label": ["triggerLabel"],"template.config.review_tone": ["reviewTone"],});diff --git a/__tests__/scripts/dev-safe.test.ts b/__tests__/scripts/dev-safe.test.tsindex a108ae51a6..a48780e54c 100644--- a/__tests__/scripts/dev-safe.test.ts+++ b/__tests__/scripts/dev-safe.test.ts@@ -492,13 +492,13 @@ describe("buildAgentServerCommand", () => {// Defaults to the released PyPI version with all SDK packages pinned to same versionexpect(cmd.args).toEqual(["--from",- "openhands-agent-server==1.48.0",+ "openhands-agent-server==1.49.1","--with",- "openhands-sdk==1.48.0",+ "openhands-sdk==1.49.1","--with",- "openhands-tools==1.48.0",+ "openhands-tools==1.49.1","--with",- "openhands-workspace==1.48.0",+ "openhands-workspace==1.49.1","--with","agent-client-protocol<0.11","--with",@@ -507,7 +507,7 @@ describe("buildAgentServerCommand", () => {"--import-modules","canvas_ui_tool",]);- expect(cmd.source).toBe("PyPI (1.48.0, default)");+ expect(cmd.source).toBe("PyPI (1.49.1, default)");});it("uses specific PyPI version when OH_AGENT_SERVER_VERSION is set with all packages pinned", () => {diff --git a/__tests__/utils/responder-deployment.test.ts b/__tests__/utils/responder-deployment.test.tsindex ea1cb22604..58f41ce011 100644--- a/__tests__/utils/responder-deployment.test.ts+++ b/__tests__/utils/responder-deployment.test.ts@@ -12,7 +12,7 @@ const automationById = (id: string) =>describe("isResponderAutomation", () => {it("matches pure GitHub/Slack automations and excludes multi-tool or other integrations", () => {// Arrange / Act / Assert β representative pure GitHub/Slack responders.- expect(isResponderAutomation(automationById("github-pr-reviewer"))).toBe(+ expect(isResponderAutomation(automationById("github-repo-monitor"))).toBe(true,);expect(isResponderAutomation(automationById("slack-channel-monitor"))).toBe(diff --git a/config/defaults.json b/config/defaults.jsonindex 9a459a6e24..73f3d6da99 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.48.0",+ "agentServer": "1.49.1","agentCanvas": "1.19.0",- "automation": "1.12.1"+ "automation": "1.13.1"},"compatibility": {"minimumAgentServer": "1.28.0"diff --git a/docker/Dockerfile b/docker/Dockerfileindex 662be11716..06f2d7199b 100644--- a/docker/Dockerfile+++ b/docker/Dockerfile@@ -21,6 +21,7 @@# node scripts/docker-build.mjs (recommended, reads JSON for you)# docker build --build-arg AGENT_SERVER_IMAGE=... --build-arg AUTOMATION_VERSION=... -f docker/Dockerfile .ARG AGENT_SERVER_IMAGE+ARG AGENT_SERVER_VERSIONARG AUTOMATION_VERSION# ββ Stage 1: Build frontend ββββββββββββββββββββββββββββββββββββββββββββββββββ@@ -73,6 +74,7 @@ RUN node -e " \FROM ${AGENT_SERVER_IMAGE} AS finalARG AUTOMATION_VERSION+ARG AGENT_SERVER_VERSIONARG AGENT_SERVER_SDK_GIT_REF=""ARG OPENHANDS_BUILD_GIT_SHA=unknownARG OPENHANDS_BUILD_GIT_REF=unknown@@ -101,12 +103,11 @@ RUN if command -v apt-get >/dev/null 2>&1; then \rm -rf /var/lib/apt/lists/*; \fi-# Install automation server via pip.-# Shared deps (openhands-sdk, fastapi, uvicorn, pydantic, httpx, β¦) are-# already satisfied by the agent-server base image, so only automation--# specific packages (asyncpg, sqlalchemy, boto3, gcloud, β¦) are added.-RUN uv pip install --system "openhands-automation==${AUTOMATION_VERSION}" 2>/dev/null \- || pip install --no-cache-dir "openhands-automation==${AUTOMATION_VERSION}"+# Install automation server and the tool models its SDK clients deserialize.+# Match openhands-tools to the SDK already provided by the agent-server image,+# just as the local Canvas launcher does.+RUN uv pip install --system "openhands-automation==${AUTOMATION_VERSION}" "openhands-tools==${AGENT_SERVER_VERSION}" 2>/dev/null \+ || pip install --no-cache-dir "openhands-automation==${AUTOMATION_VERSION}" "openhands-tools==${AGENT_SERVER_VERSION}"RUN if [ -n "${AGENT_SERVER_SDK_GIT_REF}" ]; then \BASE_GIT_URL="git+https://github.com/OpenHands/software-agent-sdk@${AGENT_SERVER_SDK_GIT_REF}" && \diff --git a/docker/entrypoint.sh b/docker/entrypoint.shindex 36da7ea00e..b96fa4d0fc 100644--- a/docker/entrypoint.sh+++ b/docker/entrypoint.sh@@ -42,6 +42,8 @@# Setting this enables local-mode auth so the session# API key is validated internally instead of against the# OpenHands cloud API.+# AUTOMATION_KV_SECRET β Signing key for scoped automation KV tokens+# (defaults to the shared session API key).# FILE_STORE β Storage backend for automation tarballs (default: local).# Without this the automation backend may fall back to# S3/GCS which fails without cloud credentials.@@ -219,6 +221,7 @@ fiexport OPENHANDS_AUTOMATION_API_KEY="${OPENHANDS_AUTOMATION_API_KEY:-${EFFECTIVE_SESSION_KEY}}"export AUTOMATION_LOCAL_API_KEY="${AUTOMATION_LOCAL_API_KEY:-${EFFECTIVE_SESSION_KEY}}"export AUTOMATION_AGENT_SERVER_API_KEY="${AUTOMATION_AGENT_SERVER_API_KEY:-${EFFECTIVE_SESSION_KEY}}"+export AUTOMATION_KV_SECRET="${AUTOMATION_KV_SECRET:-${EFFECTIVE_SESSION_KEY}}"export OPENHANDS_REMOTE_WS_READY_REQUIRED="${OPENHANDS_REMOTE_WS_READY_REQUIRED:-false}"if [ -z "${AUTOMATION_POSTHOG_API_KEY:-}" ]; thenif [ -n "${VITE_POSTHOG_API_KEY:-}" ]; thendiff --git a/package-lock.json b/package-lock.jsonindex 6f57d704ac..8ea3b0e0c9 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.20.0",- "@openhands/typescript-client": "1.48.0",+ "@openhands/extensions": "0.22.1",+ "@openhands/typescript-client": "1.49.1","@react-router/node": "7.18.2","@react-router/serve": "7.18.2","@tailwindcss/vite": "4.3.3",@@ -4164,9 +4164,9 @@"license": "MIT"},"node_modules/@openhands/extensions": {- "version": "0.20.0",- "resolved": "https://registry.npmjs.org/@openhands/extensions/-/extensions-0.20.0.tgz",- "integrity": "sha512-1FdkXr4GOUgJ/Pvh3X0obIDghquHYOAK0iJqfsBydEnjdiYUytQ1bLcY30DuuZqggEpKN0jeUVKhHwFMLMSVZQ==",+ "version": "0.22.1",+ "resolved": "https://registry.npmjs.org/@openhands/extensions/-/extensions-0.22.1.tgz",+ "integrity": "sha512-Y2wBBrQSODpLc12VE4w4rc0V972bOLb7fWxfVitzos+Cjq0RNDoFg60lyQErabGLV0gFlp/0Vd9jkYRGYtwqyw==","license": "MIT","engines": {"node": ">=18.20.0"@@ -4178,9 +4178,9 @@}},"node_modules/@openhands/typescript-client": {- "version": "1.48.0",- "resolved": "https://registry.npmjs.org/@openhands/typescript-client/-/typescript-client-1.48.0.tgz",- "integrity": "sha512-2D0mMSUHWcolhksBmwFdOW749kk+btP4tBBbTbiJR26bu+k3EoPLoyWFWx9bGEH5zz2eH31vPii+KD2to7l48g==",+ "version": "1.49.1",+ "resolved": "https://registry.npmjs.org/@openhands/typescript-client/-/typescript-client-1.49.1.tgz",+ "integrity": "sha512-IGLws4cPh4GipnNpx70ayz5SSD/bj+zfPlwjzwfwlsztFX+QrQluUcPv2FQ4ydeIe5HgUfl2SFyZxJ1vZBneXw==","license": "MIT","dependencies": {"@openrouter/sdk": "^1.2.11",diff --git a/package.json b/package.jsonindex 662f151f09..192467335a 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.20.0",- "@openhands/typescript-client": "1.48.0",+ "@openhands/extensions": "0.22.1",+ "@openhands/typescript-client": "1.49.1","@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 a8c0d48800..97242d78c4 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.48.0 node scripts/check-sdk-version-sync.mjs+ * EXPECTED_SDK_VERSION=1.49.1 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.48.0"}}'+ -d '{"event_type": "sdk-version-check", "client_payload": {"version": "1.49.1"}}'`);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.48.0,<2.0.0"- * "openhands-tools==1.48.0"- * "openhands-workspace (>=1.48.0)"+ * "openhands-sdk>=1.49.1,<2.0.0"+ * "openhands-tools==1.49.1"+ * "openhands-workspace (>=1.49.1)"*/function parseSdkVersionsFromRequiresDist(requiresDist) {const versions = {};@@ -316,7 +316,7 @@ function parseSdkVersionsFromRequiresDist(requiresDist) {}// Extract the version number - look for patterns like:- // ">=1.48.0", "==1.48.0", "(>=1.48.0)", "~=1.48.0"+ // ">=1.49.1", "==1.49.1", "(>=1.49.1)", "~=1.49.1"// 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 c78952da97..4d4d642707 100644--- a/scripts/dev-safe.mjs+++ b/scripts/dev-safe.mjs@@ -421,7 +421,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.48.0")+ * - OH_AGENT_SERVER_VERSION: Specific PyPI version (e.g., "1.49.1")** 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/scripts/docker-build.mjs b/scripts/docker-build.mjsindex 66a411c95d..1fed04f2ef 100644--- a/scripts/docker-build.mjs+++ b/scripts/docker-build.mjs@@ -24,6 +24,7 @@ const config = JSON.parse();const agentServerImage = `${config.images.agentServer}:${config.versions.agentServer}-python`;+const agentServerVersion = config.versions.agentServer;const automationVersion = config.versions.automation;const canvasBasePath = config.paths.canvasBasePath;@@ -50,6 +51,8 @@ const cmd = ["--build-arg",`AGENT_SERVER_IMAGE=${agentServerImage}`,"--build-arg",+ `AGENT_SERVER_VERSION=${agentServerVersion}`,+ "--build-arg",`AUTOMATION_VERSION=${automationVersion}`,"--build-arg",`VITE_BASE_PATH=${canvasBasePath}`,