π OpenHands: AI-Driven Development
fix: use versioned release tags for agent-server Docker images (#338)
Rohit Malhotrac0bc27c0caa8
diff --git a/AGENTS.md b/AGENTS.mdindex 99a3f1e055..6650696082 100644--- a/AGENTS.md+++ b/AGENTS.md@@ -103,6 +103,11 @@- `OH_SECRET_KEY` β secret key for settings encryption; uses a static default for local dev since it's needed for reading persisted encrypted values across restarts- `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.22.0` for agent-server SDK libraries+- `scripts/dev-docker.mjs` runs the agent-server inside a Docker container instead of via `uvx`. The default image uses versioned release tags:+ - `DEFAULT_AGENT_SERVER_TAG` β uses format `v{version}-python` (e.g., `v1.22.0-python`) for reproducibility+ - Should stay in sync with `DEFAULT_AGENT_SERVER_VERSION` in `dev-safe.mjs` for consistency between Docker and non-Docker dev modes+ - `OH_AGENT_SERVER_GIT_REF` β override to use a git ref-based tag (e.g., `main` β `main-python`, `abc1234` β `abc1234-python`)+ - Docker images are published from https://github.com/OpenHands/software-agent-sdk via the Agent Server workflow to `ghcr.io/openhands/agent-server`- Security: Both `scripts/dev-safe.mjs` and `scripts/dev-with-automation.mjs` auto-generate random API keys on each startup for better security isolation:- `SESSION_API_KEY` β 64-character hex (256-bit) for agent-server API authentication; auto-generated per session unless overridden via env var- `AUTOMATION_LOCAL_API_KEY` β 64-character hex for automation backend auth; auto-generated per session unless overriddendiff --git a/scripts/dev-docker.mjs b/scripts/dev-docker.mjsindex 96179f317f..dc0ec35850 100644--- a/scripts/dev-docker.mjs+++ b/scripts/dev-docker.mjs@@ -68,8 +68,10 @@ const CONTAINER_LOCAL_SDK_DIR = "/agent-server-src";// Docker image for the agent-server.const AGENT_SERVER_REPO = "ghcr.io/openhands/agent-server";-// Default tag used when OH_AGENT_SERVER_GIT_REF is not set. Update to upgrade.-const DEFAULT_AGENT_SERVER_TAG = "0924962-python";+// Default tag used when OH_AGENT_SERVER_GIT_REF is not set.+// Should match DEFAULT_AGENT_SERVER_VERSION in dev-safe.mjs for consistency.+// Format: v{version}-python (e.g., v1.22.0-python) for released versions.+const DEFAULT_AGENT_SERVER_TAG = "v1.22.0-python";const CONTAINER_NAME = "agent-canvas-dev-agent-server";// Default secret key matches dev-safe.mjs so persisted settings stay