Skip to content

πŸ™Œ OpenHands: AI-Driven Development

chore: bump released agent runtime dependencies (#17489)

Graham Neubig06ae3cfa1ee6
diff --git a/.github/workflows/docker.yml b/.github/workflows/docker.yml
index 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.md
index 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.tsx
index 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.ts
index 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.ts
index 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 version
expect(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.ts
index 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.json
index 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/Dockerfile
index 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_VERSION
ARG AUTOMATION_VERSION
# ── Stage 1: Build frontend ──────────────────────────────────────────────────
@@ -73,6 +74,7 @@ RUN node -e " \
FROM ${AGENT_SERVER_IMAGE} AS final
ARG AUTOMATION_VERSION
+ARG AGENT_SERVER_VERSION
ARG AGENT_SERVER_SDK_GIT_REF=""
ARG OPENHANDS_BUILD_GIT_SHA=unknown
ARG 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.sh
index 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 @@ fi
export 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:-}" ]; then
if [ -n "${VITE_POSTHOG_API_KEY:-}" ]; then
diff --git a/package-lock.json b/package-lock.json
index 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.json
index 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.mjs
index 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 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 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 a
diff --git a/scripts/docker-build.mjs b/scripts/docker-build.mjs
index 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}`,