More efficient websocket based implementation for async bash execution

[tofarr]

Summary

Currently when starting a Sandbox in the App Server we execute a number of bash commands related to git - Cloning repositories and running setup scripts. This means we get a lot of noise in the Agent Server as the app server polls it to determine whether these commands have completed:

Instead of polling, lets just use the websocket implementation instead:

Checklist

• If the PR is changing/adding functionality, are there tests to reflect this?
• If there is an example, have you run the example to make sure that it works?
• If there are instructions on how to run the code, have you followed the instructions and made sure that it works?
• If the feature is significant enough to require documentation, is there a PR open on the OpenHands/docs repository with the same branch name?
• Is the github CI passing?

---

Agent Server images for this PR

• GHCR package: https://github.com/OpenHands/agent-sdk/pkgs/container/agent-server

Variants & Base Images

Variant	Architectures	Base Image	Docs / Tags
java	amd64, arm64	eclipse-temurin:17-jdk	Link
python	amd64, arm64	nikolaik/python-nodejs:python3.12-nodejs22	Link
golang	amd64, arm64	golang:1.21-bookworm	Link

Pull (multi-arch manifest)

# Each variant is a multi-arch manifest supporting both amd64 and arm64
docker pull ghcr.io/openhands/agent-server:1023802-python

Run

docker run -it --rm \
  -p 8000:8000 \
  --name agent-server-1023802-python \
  ghcr.io/openhands/agent-server:1023802-python

All tags pushed for this build

ghcr.io/openhands/agent-server:1023802-golang-amd64
ghcr.io/openhands/agent-server:1023802-golang_tag_1.21-bookworm-amd64
ghcr.io/openhands/agent-server:1023802-golang-arm64
ghcr.io/openhands/agent-server:1023802-golang_tag_1.21-bookworm-arm64
ghcr.io/openhands/agent-server:1023802-java-amd64
ghcr.io/openhands/agent-server:1023802-eclipse-temurin_tag_17-jdk-amd64
ghcr.io/openhands/agent-server:1023802-java-arm64
ghcr.io/openhands/agent-server:1023802-eclipse-temurin_tag_17-jdk-arm64
ghcr.io/openhands/agent-server:1023802-python-amd64
ghcr.io/openhands/agent-server:1023802-nikolaik_s_python-nodejs_tag_python3.12-nodejs22-amd64
ghcr.io/openhands/agent-server:1023802-python-arm64
ghcr.io/openhands/agent-server:1023802-nikolaik_s_python-nodejs_tag_python3.12-nodejs22-arm64
ghcr.io/openhands/agent-server:1023802-golang
ghcr.io/openhands/agent-server:1023802-java
ghcr.io/openhands/agent-server:1023802-python

About Multi-Architecture Support

• Each variant tag (e.g., 1023802-python) is a multi-arch manifest supporting both amd64 and arm64
• Docker automatically pulls the correct architecture for your platform
• Individual architecture tags (e.g., 1023802-python-amd64) are also available if needed

[openhands-ai]

Looks like there are a few issues preventing this PR from being merged!

• GitHub Actions are failing:
  • Run tests

If you'd like me to help, just leave a comment, like

@OpenHands please fix the failing actions on PR #1587 at branch `efficient-async`

Feel free to include any additional details that might help me get this PR into a better state.

_{^{You can manage your notification settings}}

[github-actions]

Coverage Report •

File	Stmts	Miss	Cover	Missing
openhands-agent-server/openhands/agent_server
sockets.py	99	49	50%	50–51, 57–59, 68–70, 76–78, 83–84, 86–87, 101–102, 104–105, 107–109, 112, 114–117, 119–120, 122–126, 128–131, 133–134, 137, 144–145, 159–163, 173
openhands-sdk/openhands/sdk/utils
models.py	137	47	65%	42–43, 49, 51, 59–63, 86, 92, 134–136, 139, 142, 146, 156, 213, 219–222, 224–225, 228, 231–235, 238–242, 244, 266, 279–280, 282–284, 286, 290, 292, 296
openhands-sdk/openhands/sdk/workspace/remote
async_remote_workspace.py	86	63	26%	27–32, 36–37, 43–44, 47–48, 51–57, 78–79, 82–84, 99–102, 106–125, 128–129, 131, 155–157, 175–177, 191–193, 207–209
TOTAL	14547	6913	52%

[h-openhands]

Thank you! 🙏

[hieptl]

Thank you! 🙏