Container snapshots/restore feature and other critical bug fixes

.devcontainer/README.MD

@@ -0,0 +1 @@
+The files in this directory configure a development container that can be used for development on Windows using Microsoft's "Dev Containers" extension for VS Code.

.devcontainer/devcontainer.json

@@ -0,0 +1,23 @@
+{
+	"name": "OpenHands Codespaces",
+	/* Doesn't work because Dockerfile uses HEREDOCS (currently not supported by Dev Containers)
+	"build": {
+		"dockerfile": "../containers/dev/Dockerfile"
+	},
+	*/
+	"image": "mcr.microsoft.com/devcontainers/universal",
+	"runArgs": [
+		"--name=openhands-dev-container",
+		"--network=host"
+	],
+	"customizations":{
+		"vscode":{
+			"extensions": [
+				"ms-python.python"
+			]
+		}
+	},
+	"onCreateCommand": "sh ./.devcontainer/on_create.sh",
+	"postCreateCommand": "yes | make build",
+	"postStartCommand": "bash ./.devcontainer/on_run.sh"
+}

.devcontainer/on_create.sh

@@ -0,0 +1,18 @@
+#!/usr/bin/env bash
+sudo apt update
+sudo apt install -y netcat
+sudo add-apt-repository -y ppa:deadsnakes/ppa
+curl -sSL https://install.python-poetry.org | python3.12 -
+
+# WAS working:
+#sudo add-apt-repository -y ppa:deadsnakes/ppa \
+#    && apt-get update \
+#    && apt-get install -y python3.12 python3.12-venv python3.12-dev python3-pip \
+#    && ln -s /usr/bin/python3.12 /usr/bin/python
+
+# See: https://github.com/SmartManoj/Kevin/issues/122#issuecomment-2540482254
+git config --global --add safe.directory /workspaces/OpenHands
+
+# Global .gitignore for VS Code
+echo ".history/" > ~/.gitignore_global
+git config --global core.excludesfile ~/.gitignore_global

.devcontainer/on_run.sh

@@ -0,0 +1,4 @@
+#!/usr/bin/env bash
+#USE_HOST_NETWORK=True nohup bash -c '(litellm --config my-configs/litellm.yaml &) ; make run' &> output.log &
+export USE_HOST_NETWORK=True
+bash -c '(nohup bash -c "make run") &> output.log'

openhands/core/config/sandbox_config.py

@@ -63,6 +63,6 @@ class SandboxConfig(BaseModel):
     close_delay: int = Field(default=15)
     remote_runtime_resource_factor: int = Field(default=1)
     enable_gpu: bool = Field(default=False)
-    docker_runtime_kwargs: str | None = Field(default=None)
+    docker_runtime_kwargs: dict | None = Field(default=None)
 
     model_config = {'extra': 'forbid'}

openhands/runtime/impl/docker/docker_runtime.py

@@ -310,18 +310,26 @@ def _attach_to_container(self):
         self.container = self.docker_client.containers.get(self.container_name)
         if self.container.status == 'exited':
             self.container.start()
+
         config = self.container.attrs['Config']
         for env_var in config['Env']:
             if env_var.startswith('port='):
                 self._host_port = int(env_var.split('port=')[1])
                 self._container_port = self._host_port
             elif env_var.startswith('VSCODE_PORT='):
                 self._vscode_port = int(env_var.split('VSCODE_PORT=')[1])
+        else:
+            # fallback if host network is used
+            self._container_port = int(self.container.attrs['Args'][9])
+
         self._app_ports = []
-        for exposed_port in config['ExposedPorts'].keys():
-            exposed_port = int(exposed_port.split('/tcp')[0])
-            if exposed_port != self._host_port and exposed_port != self._vscode_port:
-                self._app_ports.append(exposed_port)
+        exposed_ports = config.get('ExposedPorts')
+        if exposed_ports:
+            for exposed_port in exposed_ports.keys():
+                exposed_port = int(exposed_port.split('/tcp')[0])
+                if exposed_port != self._host_port and exposed_port != self._vscode_port:
+                    self._app_ports.append(exposed_port)
+
         self.api_url = f'{self.config.sandbox.local_runtime_url}:{self._container_port}'
         self.log(
             'debug',