From f460057f5829997349640b76d7b32fdb32157de1 Mon Sep 17 00:00:00 2001 From: Tim O'Farrell Date: Fri, 6 Feb 2026 05:15:02 -0700 Subject: [PATCH] chore: add deprecation notices to all runtime directory files (#12772) Co-authored-by: openhands --- openhands/runtime/__init__.py | 7 +++++++ openhands/runtime/action_execution_server.py | 7 +++++++ openhands/runtime/base.py | 7 +++++++ openhands/runtime/browser/__init__.py | 7 +++++++ openhands/runtime/browser/base64.py | 7 +++++++ openhands/runtime/browser/browser_env.py | 7 +++++++ openhands/runtime/browser/utils.py | 7 +++++++ openhands/runtime/builder/__init__.py | 7 +++++++ openhands/runtime/builder/base.py | 7 +++++++ openhands/runtime/builder/docker.py | 7 +++++++ openhands/runtime/builder/remote.py | 7 +++++++ openhands/runtime/file_viewer_server.py | 7 +++++++ openhands/runtime/impl/__init__.py | 7 +++++++ .../impl/action_execution/action_execution_client.py | 7 +++++++ openhands/runtime/impl/cli/__init__.py | 7 +++++++ openhands/runtime/impl/cli/cli_runtime.py | 7 +++++++ openhands/runtime/impl/docker/containers.py | 7 +++++++ openhands/runtime/impl/docker/docker_runtime.py | 7 +++++++ openhands/runtime/impl/kubernetes/kubernetes_runtime.py | 7 +++++++ openhands/runtime/impl/local/__init__.py | 7 +++++++ openhands/runtime/impl/local/local_runtime.py | 7 +++++++ openhands/runtime/impl/remote/remote_runtime.py | 7 +++++++ openhands/runtime/mcp/proxy/__init__.py | 7 +++++++ openhands/runtime/mcp/proxy/manager.py | 7 +++++++ openhands/runtime/plugins/__init__.py | 7 +++++++ openhands/runtime/plugins/agent_skills/__init__.py | 7 +++++++ openhands/runtime/plugins/agent_skills/agentskills.py | 7 +++++++ .../runtime/plugins/agent_skills/file_editor/__init__.py | 7 +++++++ .../runtime/plugins/agent_skills/file_ops/__init__.py | 7 +++++++ .../runtime/plugins/agent_skills/file_ops/file_ops.py | 7 +++++++ .../runtime/plugins/agent_skills/file_reader/__init__.py | 7 +++++++ .../plugins/agent_skills/file_reader/file_readers.py | 7 +++++++ .../runtime/plugins/agent_skills/repo_ops/__init__.py | 7 +++++++ .../runtime/plugins/agent_skills/repo_ops/repo_ops.py | 7 +++++++ openhands/runtime/plugins/agent_skills/utils/config.py | 7 +++++++ openhands/runtime/plugins/agent_skills/utils/dependency.py | 7 +++++++ openhands/runtime/plugins/jupyter/__init__.py | 7 +++++++ openhands/runtime/plugins/jupyter/execute_server.py | 7 +++++++ openhands/runtime/plugins/requirement.py | 7 +++++++ openhands/runtime/plugins/vscode/__init__.py | 7 +++++++ openhands/runtime/runtime_status.py | 7 +++++++ openhands/runtime/utils/__init__.py | 7 +++++++ openhands/runtime/utils/bash.py | 7 +++++++ openhands/runtime/utils/bash_constants.py | 7 +++++++ openhands/runtime/utils/command.py | 7 +++++++ openhands/runtime/utils/edit.py | 7 +++++++ openhands/runtime/utils/file_viewer.py | 7 +++++++ openhands/runtime/utils/files.py | 7 +++++++ openhands/runtime/utils/git_changes.py | 7 +++++++ openhands/runtime/utils/git_diff.py | 7 +++++++ openhands/runtime/utils/git_handler.py | 7 +++++++ openhands/runtime/utils/log_capture.py | 7 +++++++ openhands/runtime/utils/log_streamer.py | 7 +++++++ openhands/runtime/utils/memory_monitor.py | 7 +++++++ openhands/runtime/utils/port_lock.py | 7 +++++++ openhands/runtime/utils/request.py | 7 +++++++ openhands/runtime/utils/runtime_build.py | 7 +++++++ openhands/runtime/utils/runtime_init.py | 7 +++++++ openhands/runtime/utils/singleton.py | 7 +++++++ openhands/runtime/utils/system.py | 7 +++++++ openhands/runtime/utils/system_stats.py | 7 +++++++ openhands/runtime/utils/tenacity_stop.py | 7 +++++++ openhands/runtime/utils/windows_bash.py | 7 +++++++ openhands/runtime/utils/windows_exceptions.py | 7 +++++++ 64 files changed, 448 insertions(+) diff --git a/openhands/runtime/__init__.py b/openhands/runtime/__init__.py index eabb1c0ee3..f987ad3f2d 100644 --- a/openhands/runtime/__init__.py +++ b/openhands/runtime/__init__.py @@ -1,3 +1,10 @@ +# IMPORTANT: LEGACY V0 CODE - Deprecated since version 1.0.0, scheduled for removal April 1, 2026 +# This file is part of the legacy (V0) implementation of OpenHands and will be removed soon as we complete the migration to V1. +# OpenHands V1 uses the Software Agent SDK for the agentic core and runs a new application server. Please refer to: +# - V1 agentic core (SDK): https://github.com/OpenHands/software-agent-sdk +# - V1 application server (in this repo): openhands/app_server/ +# Unless you are working on deprecation, please avoid extending this legacy file and consult the V1 codepaths above. +# Tag: Legacy-V0 import importlib from openhands.runtime.base import Runtime diff --git a/openhands/runtime/action_execution_server.py b/openhands/runtime/action_execution_server.py index 896b25ffe9..74eed44aa9 100644 --- a/openhands/runtime/action_execution_server.py +++ b/openhands/runtime/action_execution_server.py @@ -1,3 +1,10 @@ +# IMPORTANT: LEGACY V0 CODE - Deprecated since version 1.0.0, scheduled for removal April 1, 2026 +# This file is part of the legacy (V0) implementation of OpenHands and will be removed soon as we complete the migration to V1. +# OpenHands V1 uses the Software Agent SDK for the agentic core and runs a new application server. Please refer to: +# - V1 agentic core (SDK): https://github.com/OpenHands/software-agent-sdk +# - V1 application server (in this repo): openhands/app_server/ +# Unless you are working on deprecation, please avoid extending this legacy file and consult the V1 codepaths above. +# Tag: Legacy-V0 """This is the main file for the runtime client. It is responsible for executing actions received from OpenHands backend and producing observations. diff --git a/openhands/runtime/base.py b/openhands/runtime/base.py index 62ac926921..37951eff33 100644 --- a/openhands/runtime/base.py +++ b/openhands/runtime/base.py @@ -1,3 +1,10 @@ +# IMPORTANT: LEGACY V0 CODE - Deprecated since version 1.0.0, scheduled for removal April 1, 2026 +# This file is part of the legacy (V0) implementation of OpenHands and will be removed soon as we complete the migration to V1. +# OpenHands V1 uses the Software Agent SDK for the agentic core and runs a new application server. Please refer to: +# - V1 agentic core (SDK): https://github.com/OpenHands/software-agent-sdk +# - V1 application server (in this repo): openhands/app_server/ +# Unless you are working on deprecation, please avoid extending this legacy file and consult the V1 codepaths above. +# Tag: Legacy-V0 import asyncio import atexit import copy diff --git a/openhands/runtime/browser/__init__.py b/openhands/runtime/browser/__init__.py index 2687e03c68..c6e285c154 100644 --- a/openhands/runtime/browser/__init__.py +++ b/openhands/runtime/browser/__init__.py @@ -1,3 +1,10 @@ +# IMPORTANT: LEGACY V0 CODE - Deprecated since version 1.0.0, scheduled for removal April 1, 2026 +# This file is part of the legacy (V0) implementation of OpenHands and will be removed soon as we complete the migration to V1. +# OpenHands V1 uses the Software Agent SDK for the agentic core and runs a new application server. Please refer to: +# - V1 agentic core (SDK): https://github.com/OpenHands/software-agent-sdk +# - V1 application server (in this repo): openhands/app_server/ +# Unless you are working on deprecation, please avoid extending this legacy file and consult the V1 codepaths above. +# Tag: Legacy-V0 from openhands.runtime.browser.utils import browse __all__ = ['browse'] diff --git a/openhands/runtime/browser/base64.py b/openhands/runtime/browser/base64.py index c5320aa8b8..05de3dbe86 100644 --- a/openhands/runtime/browser/base64.py +++ b/openhands/runtime/browser/base64.py @@ -1,3 +1,10 @@ +# IMPORTANT: LEGACY V0 CODE - Deprecated since version 1.0.0, scheduled for removal April 1, 2026 +# This file is part of the legacy (V0) implementation of OpenHands and will be removed soon as we complete the migration to V1. +# OpenHands V1 uses the Software Agent SDK for the agentic core and runs a new application server. Please refer to: +# - V1 agentic core (SDK): https://github.com/OpenHands/software-agent-sdk +# - V1 application server (in this repo): openhands/app_server/ +# Unless you are working on deprecation, please avoid extending this legacy file and consult the V1 codepaths above. +# Tag: Legacy-V0 import base64 import io diff --git a/openhands/runtime/browser/browser_env.py b/openhands/runtime/browser/browser_env.py index c8d09d9c2b..bb6219a8a7 100644 --- a/openhands/runtime/browser/browser_env.py +++ b/openhands/runtime/browser/browser_env.py @@ -1,3 +1,10 @@ +# IMPORTANT: LEGACY V0 CODE - Deprecated since version 1.0.0, scheduled for removal April 1, 2026 +# This file is part of the legacy (V0) implementation of OpenHands and will be removed soon as we complete the migration to V1. +# OpenHands V1 uses the Software Agent SDK for the agentic core and runs a new application server. Please refer to: +# - V1 agentic core (SDK): https://github.com/OpenHands/software-agent-sdk +# - V1 application server (in this repo): openhands/app_server/ +# Unless you are working on deprecation, please avoid extending this legacy file and consult the V1 codepaths above. +# Tag: Legacy-V0 import atexit import json import multiprocessing diff --git a/openhands/runtime/browser/utils.py b/openhands/runtime/browser/utils.py index 378e3fea32..ffd92c6ce4 100644 --- a/openhands/runtime/browser/utils.py +++ b/openhands/runtime/browser/utils.py @@ -1,3 +1,10 @@ +# IMPORTANT: LEGACY V0 CODE - Deprecated since version 1.0.0, scheduled for removal April 1, 2026 +# This file is part of the legacy (V0) implementation of OpenHands and will be removed soon as we complete the migration to V1. +# OpenHands V1 uses the Software Agent SDK for the agentic core and runs a new application server. Please refer to: +# - V1 agentic core (SDK): https://github.com/OpenHands/software-agent-sdk +# - V1 application server (in this repo): openhands/app_server/ +# Unless you are working on deprecation, please avoid extending this legacy file and consult the V1 codepaths above. +# Tag: Legacy-V0 import base64 import datetime import os diff --git a/openhands/runtime/builder/__init__.py b/openhands/runtime/builder/__init__.py index fcebb8a240..8398c49f74 100644 --- a/openhands/runtime/builder/__init__.py +++ b/openhands/runtime/builder/__init__.py @@ -1,3 +1,10 @@ +# IMPORTANT: LEGACY V0 CODE - Deprecated since version 1.0.0, scheduled for removal April 1, 2026 +# This file is part of the legacy (V0) implementation of OpenHands and will be removed soon as we complete the migration to V1. +# OpenHands V1 uses the Software Agent SDK for the agentic core and runs a new application server. Please refer to: +# - V1 agentic core (SDK): https://github.com/OpenHands/software-agent-sdk +# - V1 application server (in this repo): openhands/app_server/ +# Unless you are working on deprecation, please avoid extending this legacy file and consult the V1 codepaths above. +# Tag: Legacy-V0 from openhands.runtime.builder.base import RuntimeBuilder from openhands.runtime.builder.docker import DockerRuntimeBuilder diff --git a/openhands/runtime/builder/base.py b/openhands/runtime/builder/base.py index 6bc1155d7f..478dff7357 100644 --- a/openhands/runtime/builder/base.py +++ b/openhands/runtime/builder/base.py @@ -1,3 +1,10 @@ +# IMPORTANT: LEGACY V0 CODE - Deprecated since version 1.0.0, scheduled for removal April 1, 2026 +# This file is part of the legacy (V0) implementation of OpenHands and will be removed soon as we complete the migration to V1. +# OpenHands V1 uses the Software Agent SDK for the agentic core and runs a new application server. Please refer to: +# - V1 agentic core (SDK): https://github.com/OpenHands/software-agent-sdk +# - V1 application server (in this repo): openhands/app_server/ +# Unless you are working on deprecation, please avoid extending this legacy file and consult the V1 codepaths above. +# Tag: Legacy-V0 import abc diff --git a/openhands/runtime/builder/docker.py b/openhands/runtime/builder/docker.py index 5f0fb2027b..4afb5098e2 100644 --- a/openhands/runtime/builder/docker.py +++ b/openhands/runtime/builder/docker.py @@ -1,3 +1,10 @@ +# IMPORTANT: LEGACY V0 CODE - Deprecated since version 1.0.0, scheduled for removal April 1, 2026 +# This file is part of the legacy (V0) implementation of OpenHands and will be removed soon as we complete the migration to V1. +# OpenHands V1 uses the Software Agent SDK for the agentic core and runs a new application server. Please refer to: +# - V1 agentic core (SDK): https://github.com/OpenHands/software-agent-sdk +# - V1 application server (in this repo): openhands/app_server/ +# Unless you are working on deprecation, please avoid extending this legacy file and consult the V1 codepaths above. +# Tag: Legacy-V0 import datetime import os import subprocess diff --git a/openhands/runtime/builder/remote.py b/openhands/runtime/builder/remote.py index 60dee570a8..820b89c3a6 100644 --- a/openhands/runtime/builder/remote.py +++ b/openhands/runtime/builder/remote.py @@ -1,3 +1,10 @@ +# IMPORTANT: LEGACY V0 CODE - Deprecated since version 1.0.0, scheduled for removal April 1, 2026 +# This file is part of the legacy (V0) implementation of OpenHands and will be removed soon as we complete the migration to V1. +# OpenHands V1 uses the Software Agent SDK for the agentic core and runs a new application server. Please refer to: +# - V1 agentic core (SDK): https://github.com/OpenHands/software-agent-sdk +# - V1 application server (in this repo): openhands/app_server/ +# Unless you are working on deprecation, please avoid extending this legacy file and consult the V1 codepaths above. +# Tag: Legacy-V0 import base64 import io import tarfile diff --git a/openhands/runtime/file_viewer_server.py b/openhands/runtime/file_viewer_server.py index dc86e03750..3760016842 100644 --- a/openhands/runtime/file_viewer_server.py +++ b/openhands/runtime/file_viewer_server.py @@ -1,3 +1,10 @@ +# IMPORTANT: LEGACY V0 CODE - Deprecated since version 1.0.0, scheduled for removal April 1, 2026 +# This file is part of the legacy (V0) implementation of OpenHands and will be removed soon as we complete the migration to V1. +# OpenHands V1 uses the Software Agent SDK for the agentic core and runs a new application server. Please refer to: +# - V1 agentic core (SDK): https://github.com/OpenHands/software-agent-sdk +# - V1 application server (in this repo): openhands/app_server/ +# Unless you are working on deprecation, please avoid extending this legacy file and consult the V1 codepaths above. +# Tag: Legacy-V0 """A tiny, isolated server that provides only the /view endpoint from the action execution server. This server has no authentication and only listens to localhost traffic. """ diff --git a/openhands/runtime/impl/__init__.py b/openhands/runtime/impl/__init__.py index 4398d70a3e..00e04d3a38 100644 --- a/openhands/runtime/impl/__init__.py +++ b/openhands/runtime/impl/__init__.py @@ -1,3 +1,10 @@ +# IMPORTANT: LEGACY V0 CODE - Deprecated since version 1.0.0, scheduled for removal April 1, 2026 +# This file is part of the legacy (V0) implementation of OpenHands and will be removed soon as we complete the migration to V1. +# OpenHands V1 uses the Software Agent SDK for the agentic core and runs a new application server. Please refer to: +# - V1 agentic core (SDK): https://github.com/OpenHands/software-agent-sdk +# - V1 application server (in this repo): openhands/app_server/ +# Unless you are working on deprecation, please avoid extending this legacy file and consult the V1 codepaths above. +# Tag: Legacy-V0 """Runtime implementations for OpenHands.""" from openhands.runtime.impl.action_execution.action_execution_client import ( diff --git a/openhands/runtime/impl/action_execution/action_execution_client.py b/openhands/runtime/impl/action_execution/action_execution_client.py index 554a7bfd5b..4598e9e057 100644 --- a/openhands/runtime/impl/action_execution/action_execution_client.py +++ b/openhands/runtime/impl/action_execution/action_execution_client.py @@ -1,3 +1,10 @@ +# IMPORTANT: LEGACY V0 CODE - Deprecated since version 1.0.0, scheduled for removal April 1, 2026 +# This file is part of the legacy (V0) implementation of OpenHands and will be removed soon as we complete the migration to V1. +# OpenHands V1 uses the Software Agent SDK for the agentic core and runs a new application server. Please refer to: +# - V1 agentic core (SDK): https://github.com/OpenHands/software-agent-sdk +# - V1 application server (in this repo): openhands/app_server/ +# Unless you are working on deprecation, please avoid extending this legacy file and consult the V1 codepaths above. +# Tag: Legacy-V0 import os import tempfile import threading diff --git a/openhands/runtime/impl/cli/__init__.py b/openhands/runtime/impl/cli/__init__.py index ae3165ebfb..9b6285357d 100644 --- a/openhands/runtime/impl/cli/__init__.py +++ b/openhands/runtime/impl/cli/__init__.py @@ -1,3 +1,10 @@ +# IMPORTANT: LEGACY V0 CODE - Deprecated since version 1.0.0, scheduled for removal April 1, 2026 +# This file is part of the legacy (V0) implementation of OpenHands and will be removed soon as we complete the migration to V1. +# OpenHands V1 uses the Software Agent SDK for the agentic core and runs a new application server. Please refer to: +# - V1 agentic core (SDK): https://github.com/OpenHands/software-agent-sdk +# - V1 application server (in this repo): openhands/app_server/ +# Unless you are working on deprecation, please avoid extending this legacy file and consult the V1 codepaths above. +# Tag: Legacy-V0 """CLI Runtime implementation for OpenHands.""" from openhands.runtime.impl.cli.cli_runtime import CLIRuntime diff --git a/openhands/runtime/impl/cli/cli_runtime.py b/openhands/runtime/impl/cli/cli_runtime.py index ae4752c2a8..e657c9ffbb 100644 --- a/openhands/runtime/impl/cli/cli_runtime.py +++ b/openhands/runtime/impl/cli/cli_runtime.py @@ -1,3 +1,10 @@ +# IMPORTANT: LEGACY V0 CODE - Deprecated since version 1.0.0, scheduled for removal April 1, 2026 +# This file is part of the legacy (V0) implementation of OpenHands and will be removed soon as we complete the migration to V1. +# OpenHands V1 uses the Software Agent SDK for the agentic core and runs a new application server. Please refer to: +# - V1 agentic core (SDK): https://github.com/OpenHands/software-agent-sdk +# - V1 application server (in this repo): openhands/app_server/ +# Unless you are working on deprecation, please avoid extending this legacy file and consult the V1 codepaths above. +# Tag: Legacy-V0 """This runtime runs commands locally using subprocess and performs file operations using Python's standard library. It does not implement browser functionality. """ diff --git a/openhands/runtime/impl/docker/containers.py b/openhands/runtime/impl/docker/containers.py index 32a5ba1353..29af04ed4a 100644 --- a/openhands/runtime/impl/docker/containers.py +++ b/openhands/runtime/impl/docker/containers.py @@ -1,3 +1,10 @@ +# IMPORTANT: LEGACY V0 CODE - Deprecated since version 1.0.0, scheduled for removal April 1, 2026 +# This file is part of the legacy (V0) implementation of OpenHands and will be removed soon as we complete the migration to V1. +# OpenHands V1 uses the Software Agent SDK for the agentic core and runs a new application server. Please refer to: +# - V1 agentic core (SDK): https://github.com/OpenHands/software-agent-sdk +# - V1 application server (in this repo): openhands/app_server/ +# Unless you are working on deprecation, please avoid extending this legacy file and consult the V1 codepaths above. +# Tag: Legacy-V0 import docker diff --git a/openhands/runtime/impl/docker/docker_runtime.py b/openhands/runtime/impl/docker/docker_runtime.py index 665edbea75..968e338725 100644 --- a/openhands/runtime/impl/docker/docker_runtime.py +++ b/openhands/runtime/impl/docker/docker_runtime.py @@ -1,3 +1,10 @@ +# IMPORTANT: LEGACY V0 CODE - Deprecated since version 1.0.0, scheduled for removal April 1, 2026 +# This file is part of the legacy (V0) implementation of OpenHands and will be removed soon as we complete the migration to V1. +# OpenHands V1 uses the Software Agent SDK for the agentic core and runs a new application server. Please refer to: +# - V1 agentic core (SDK): https://github.com/OpenHands/software-agent-sdk +# - V1 application server (in this repo): openhands/app_server/ +# Unless you are working on deprecation, please avoid extending this legacy file and consult the V1 codepaths above. +# Tag: Legacy-V0 import os import platform import typing diff --git a/openhands/runtime/impl/kubernetes/kubernetes_runtime.py b/openhands/runtime/impl/kubernetes/kubernetes_runtime.py index 0ad2d4efe6..8850cd1fd5 100644 --- a/openhands/runtime/impl/kubernetes/kubernetes_runtime.py +++ b/openhands/runtime/impl/kubernetes/kubernetes_runtime.py @@ -1,3 +1,10 @@ +# IMPORTANT: LEGACY V0 CODE - Deprecated since version 1.0.0, scheduled for removal April 1, 2026 +# This file is part of the legacy (V0) implementation of OpenHands and will be removed soon as we complete the migration to V1. +# OpenHands V1 uses the Software Agent SDK for the agentic core and runs a new application server. Please refer to: +# - V1 agentic core (SDK): https://github.com/OpenHands/software-agent-sdk +# - V1 application server (in this repo): openhands/app_server/ +# Unless you are working on deprecation, please avoid extending this legacy file and consult the V1 codepaths above. +# Tag: Legacy-V0 from functools import lru_cache from typing import Callable from uuid import UUID diff --git a/openhands/runtime/impl/local/__init__.py b/openhands/runtime/impl/local/__init__.py index 92ae64ebb1..0cf2dc4ea8 100644 --- a/openhands/runtime/impl/local/__init__.py +++ b/openhands/runtime/impl/local/__init__.py @@ -1,3 +1,10 @@ +# IMPORTANT: LEGACY V0 CODE - Deprecated since version 1.0.0, scheduled for removal April 1, 2026 +# This file is part of the legacy (V0) implementation of OpenHands and will be removed soon as we complete the migration to V1. +# OpenHands V1 uses the Software Agent SDK for the agentic core and runs a new application server. Please refer to: +# - V1 agentic core (SDK): https://github.com/OpenHands/software-agent-sdk +# - V1 application server (in this repo): openhands/app_server/ +# Unless you are working on deprecation, please avoid extending this legacy file and consult the V1 codepaths above. +# Tag: Legacy-V0 """Local runtime implementation.""" from openhands.runtime.impl.local.local_runtime import LocalRuntime diff --git a/openhands/runtime/impl/local/local_runtime.py b/openhands/runtime/impl/local/local_runtime.py index cf81b222eb..4f7804f705 100644 --- a/openhands/runtime/impl/local/local_runtime.py +++ b/openhands/runtime/impl/local/local_runtime.py @@ -1,3 +1,10 @@ +# IMPORTANT: LEGACY V0 CODE - Deprecated since version 1.0.0, scheduled for removal April 1, 2026 +# This file is part of the legacy (V0) implementation of OpenHands and will be removed soon as we complete the migration to V1. +# OpenHands V1 uses the Software Agent SDK for the agentic core and runs a new application server. Please refer to: +# - V1 agentic core (SDK): https://github.com/OpenHands/software-agent-sdk +# - V1 application server (in this repo): openhands/app_server/ +# Unless you are working on deprecation, please avoid extending this legacy file and consult the V1 codepaths above. +# Tag: Legacy-V0 """This runtime runs the action_execution_server directly on the local machine without Docker.""" import os diff --git a/openhands/runtime/impl/remote/remote_runtime.py b/openhands/runtime/impl/remote/remote_runtime.py index 7cba38a8e2..f851550637 100644 --- a/openhands/runtime/impl/remote/remote_runtime.py +++ b/openhands/runtime/impl/remote/remote_runtime.py @@ -1,3 +1,10 @@ +# IMPORTANT: LEGACY V0 CODE - Deprecated since version 1.0.0, scheduled for removal April 1, 2026 +# This file is part of the legacy (V0) implementation of OpenHands and will be removed soon as we complete the migration to V1. +# OpenHands V1 uses the Software Agent SDK for the agentic core and runs a new application server. Please refer to: +# - V1 agentic core (SDK): https://github.com/OpenHands/software-agent-sdk +# - V1 application server (in this repo): openhands/app_server/ +# Unless you are working on deprecation, please avoid extending this legacy file and consult the V1 codepaths above. +# Tag: Legacy-V0 import json import logging import os diff --git a/openhands/runtime/mcp/proxy/__init__.py b/openhands/runtime/mcp/proxy/__init__.py index 141a22e4ee..ae8d947977 100644 --- a/openhands/runtime/mcp/proxy/__init__.py +++ b/openhands/runtime/mcp/proxy/__init__.py @@ -1,3 +1,10 @@ +# IMPORTANT: LEGACY V0 CODE - Deprecated since version 1.0.0, scheduled for removal April 1, 2026 +# This file is part of the legacy (V0) implementation of OpenHands and will be removed soon as we complete the migration to V1. +# OpenHands V1 uses the Software Agent SDK for the agentic core and runs a new application server. Please refer to: +# - V1 agentic core (SDK): https://github.com/OpenHands/software-agent-sdk +# - V1 application server (in this repo): openhands/app_server/ +# Unless you are working on deprecation, please avoid extending this legacy file and consult the V1 codepaths above. +# Tag: Legacy-V0 """MCP Proxy module for OpenHands.""" from openhands.runtime.mcp.proxy.manager import MCPProxyManager diff --git a/openhands/runtime/mcp/proxy/manager.py b/openhands/runtime/mcp/proxy/manager.py index a9234de30b..21084344eb 100644 --- a/openhands/runtime/mcp/proxy/manager.py +++ b/openhands/runtime/mcp/proxy/manager.py @@ -1,3 +1,10 @@ +# IMPORTANT: LEGACY V0 CODE - Deprecated since version 1.0.0, scheduled for removal April 1, 2026 +# This file is part of the legacy (V0) implementation of OpenHands and will be removed soon as we complete the migration to V1. +# OpenHands V1 uses the Software Agent SDK for the agentic core and runs a new application server. Please refer to: +# - V1 agentic core (SDK): https://github.com/OpenHands/software-agent-sdk +# - V1 application server (in this repo): openhands/app_server/ +# Unless you are working on deprecation, please avoid extending this legacy file and consult the V1 codepaths above. +# Tag: Legacy-V0 """MCP Proxy Manager for OpenHands. This module provides a manager class for handling FastMCP proxy instances, diff --git a/openhands/runtime/plugins/__init__.py b/openhands/runtime/plugins/__init__.py index e8a30ef04a..11f92ef843 100644 --- a/openhands/runtime/plugins/__init__.py +++ b/openhands/runtime/plugins/__init__.py @@ -1,3 +1,10 @@ +# IMPORTANT: LEGACY V0 CODE - Deprecated since version 1.0.0, scheduled for removal April 1, 2026 +# This file is part of the legacy (V0) implementation of OpenHands and will be removed soon as we complete the migration to V1. +# OpenHands V1 uses the Software Agent SDK for the agentic core and runs a new application server. Please refer to: +# - V1 agentic core (SDK): https://github.com/OpenHands/software-agent-sdk +# - V1 application server (in this repo): openhands/app_server/ +# Unless you are working on deprecation, please avoid extending this legacy file and consult the V1 codepaths above. +# Tag: Legacy-V0 # Requirements from openhands.runtime.plugins.agent_skills import ( AgentSkillsPlugin, diff --git a/openhands/runtime/plugins/agent_skills/__init__.py b/openhands/runtime/plugins/agent_skills/__init__.py index 6144abe1e1..7e2808a959 100644 --- a/openhands/runtime/plugins/agent_skills/__init__.py +++ b/openhands/runtime/plugins/agent_skills/__init__.py @@ -1,3 +1,10 @@ +# IMPORTANT: LEGACY V0 CODE - Deprecated since version 1.0.0, scheduled for removal April 1, 2026 +# This file is part of the legacy (V0) implementation of OpenHands and will be removed soon as we complete the migration to V1. +# OpenHands V1 uses the Software Agent SDK for the agentic core and runs a new application server. Please refer to: +# - V1 agentic core (SDK): https://github.com/OpenHands/software-agent-sdk +# - V1 application server (in this repo): openhands/app_server/ +# Unless you are working on deprecation, please avoid extending this legacy file and consult the V1 codepaths above. +# Tag: Legacy-V0 from dataclasses import dataclass from openhands.events.action import Action diff --git a/openhands/runtime/plugins/agent_skills/agentskills.py b/openhands/runtime/plugins/agent_skills/agentskills.py index cef6d88b08..40cb315a28 100644 --- a/openhands/runtime/plugins/agent_skills/agentskills.py +++ b/openhands/runtime/plugins/agent_skills/agentskills.py @@ -1,3 +1,10 @@ +# IMPORTANT: LEGACY V0 CODE - Deprecated since version 1.0.0, scheduled for removal April 1, 2026 +# This file is part of the legacy (V0) implementation of OpenHands and will be removed soon as we complete the migration to V1. +# OpenHands V1 uses the Software Agent SDK for the agentic core and runs a new application server. Please refer to: +# - V1 agentic core (SDK): https://github.com/OpenHands/software-agent-sdk +# - V1 application server (in this repo): openhands/app_server/ +# Unless you are working on deprecation, please avoid extending this legacy file and consult the V1 codepaths above. +# Tag: Legacy-V0 from inspect import signature from openhands.runtime.plugins.agent_skills import file_ops, file_reader diff --git a/openhands/runtime/plugins/agent_skills/file_editor/__init__.py b/openhands/runtime/plugins/agent_skills/file_editor/__init__.py index 971335eeea..67bbdcea4b 100644 --- a/openhands/runtime/plugins/agent_skills/file_editor/__init__.py +++ b/openhands/runtime/plugins/agent_skills/file_editor/__init__.py @@ -1,3 +1,10 @@ +# IMPORTANT: LEGACY V0 CODE - Deprecated since version 1.0.0, scheduled for removal April 1, 2026 +# This file is part of the legacy (V0) implementation of OpenHands and will be removed soon as we complete the migration to V1. +# OpenHands V1 uses the Software Agent SDK for the agentic core and runs a new application server. Please refer to: +# - V1 agentic core (SDK): https://github.com/OpenHands/software-agent-sdk +# - V1 application server (in this repo): openhands/app_server/ +# Unless you are working on deprecation, please avoid extending this legacy file and consult the V1 codepaths above. +# Tag: Legacy-V0 """This file imports a global singleton of the `EditTool` class as well as raw functions that expose its __call__. The implementation of the `EditTool` class can be found at: https://github.com/OpenHands/openhands-aci/. diff --git a/openhands/runtime/plugins/agent_skills/file_ops/__init__.py b/openhands/runtime/plugins/agent_skills/file_ops/__init__.py index 26b38437a4..db75a71ca8 100644 --- a/openhands/runtime/plugins/agent_skills/file_ops/__init__.py +++ b/openhands/runtime/plugins/agent_skills/file_ops/__init__.py @@ -1,3 +1,10 @@ +# IMPORTANT: LEGACY V0 CODE - Deprecated since version 1.0.0, scheduled for removal April 1, 2026 +# This file is part of the legacy (V0) implementation of OpenHands and will be removed soon as we complete the migration to V1. +# OpenHands V1 uses the Software Agent SDK for the agentic core and runs a new application server. Please refer to: +# - V1 agentic core (SDK): https://github.com/OpenHands/software-agent-sdk +# - V1 application server (in this repo): openhands/app_server/ +# Unless you are working on deprecation, please avoid extending this legacy file and consult the V1 codepaths above. +# Tag: Legacy-V0 from openhands.runtime.plugins.agent_skills.file_ops import file_ops from openhands.runtime.plugins.agent_skills.utils.dependency import import_functions diff --git a/openhands/runtime/plugins/agent_skills/file_ops/file_ops.py b/openhands/runtime/plugins/agent_skills/file_ops/file_ops.py index 640fcbb212..c8d3a75eeb 100644 --- a/openhands/runtime/plugins/agent_skills/file_ops/file_ops.py +++ b/openhands/runtime/plugins/agent_skills/file_ops/file_ops.py @@ -1,3 +1,10 @@ +# IMPORTANT: LEGACY V0 CODE - Deprecated since version 1.0.0, scheduled for removal April 1, 2026 +# This file is part of the legacy (V0) implementation of OpenHands and will be removed soon as we complete the migration to V1. +# OpenHands V1 uses the Software Agent SDK for the agentic core and runs a new application server. Please refer to: +# - V1 agentic core (SDK): https://github.com/OpenHands/software-agent-sdk +# - V1 application server (in this repo): openhands/app_server/ +# Unless you are working on deprecation, please avoid extending this legacy file and consult the V1 codepaths above. +# Tag: Legacy-V0 """File operations module for OpenHands agent. This module provides a collection of file manipulation skills that enable the OpenHands diff --git a/openhands/runtime/plugins/agent_skills/file_reader/__init__.py b/openhands/runtime/plugins/agent_skills/file_reader/__init__.py index 70d080a94d..231d6bc8ed 100644 --- a/openhands/runtime/plugins/agent_skills/file_reader/__init__.py +++ b/openhands/runtime/plugins/agent_skills/file_reader/__init__.py @@ -1,3 +1,10 @@ +# IMPORTANT: LEGACY V0 CODE - Deprecated since version 1.0.0, scheduled for removal April 1, 2026 +# This file is part of the legacy (V0) implementation of OpenHands and will be removed soon as we complete the migration to V1. +# OpenHands V1 uses the Software Agent SDK for the agentic core and runs a new application server. Please refer to: +# - V1 agentic core (SDK): https://github.com/OpenHands/software-agent-sdk +# - V1 application server (in this repo): openhands/app_server/ +# Unless you are working on deprecation, please avoid extending this legacy file and consult the V1 codepaths above. +# Tag: Legacy-V0 from openhands.runtime.plugins.agent_skills.file_reader import file_readers from openhands.runtime.plugins.agent_skills.utils.dependency import import_functions diff --git a/openhands/runtime/plugins/agent_skills/file_reader/file_readers.py b/openhands/runtime/plugins/agent_skills/file_reader/file_readers.py index 48aec78ad9..ac928eba9d 100644 --- a/openhands/runtime/plugins/agent_skills/file_reader/file_readers.py +++ b/openhands/runtime/plugins/agent_skills/file_reader/file_readers.py @@ -1,3 +1,10 @@ +# IMPORTANT: LEGACY V0 CODE - Deprecated since version 1.0.0, scheduled for removal April 1, 2026 +# This file is part of the legacy (V0) implementation of OpenHands and will be removed soon as we complete the migration to V1. +# OpenHands V1 uses the Software Agent SDK for the agentic core and runs a new application server. Please refer to: +# - V1 agentic core (SDK): https://github.com/OpenHands/software-agent-sdk +# - V1 application server (in this repo): openhands/app_server/ +# Unless you are working on deprecation, please avoid extending this legacy file and consult the V1 codepaths above. +# Tag: Legacy-V0 """File reader skills for the OpenHands agent. This module provides various functions to parse and extract content from different file types, diff --git a/openhands/runtime/plugins/agent_skills/repo_ops/__init__.py b/openhands/runtime/plugins/agent_skills/repo_ops/__init__.py index d8df644022..1e2268e094 100644 --- a/openhands/runtime/plugins/agent_skills/repo_ops/__init__.py +++ b/openhands/runtime/plugins/agent_skills/repo_ops/__init__.py @@ -1,3 +1,10 @@ +# IMPORTANT: LEGACY V0 CODE - Deprecated since version 1.0.0, scheduled for removal April 1, 2026 +# This file is part of the legacy (V0) implementation of OpenHands and will be removed soon as we complete the migration to V1. +# OpenHands V1 uses the Software Agent SDK for the agentic core and runs a new application server. Please refer to: +# - V1 agentic core (SDK): https://github.com/OpenHands/software-agent-sdk +# - V1 application server (in this repo): openhands/app_server/ +# Unless you are working on deprecation, please avoid extending this legacy file and consult the V1 codepaths above. +# Tag: Legacy-V0 from openhands.runtime.plugins.agent_skills.repo_ops import repo_ops from openhands.runtime.plugins.agent_skills.utils.dependency import import_functions diff --git a/openhands/runtime/plugins/agent_skills/repo_ops/repo_ops.py b/openhands/runtime/plugins/agent_skills/repo_ops/repo_ops.py index 89d1d45534..34d7a65ba1 100644 --- a/openhands/runtime/plugins/agent_skills/repo_ops/repo_ops.py +++ b/openhands/runtime/plugins/agent_skills/repo_ops/repo_ops.py @@ -1,3 +1,10 @@ +# IMPORTANT: LEGACY V0 CODE - Deprecated since version 1.0.0, scheduled for removal April 1, 2026 +# This file is part of the legacy (V0) implementation of OpenHands and will be removed soon as we complete the migration to V1. +# OpenHands V1 uses the Software Agent SDK for the agentic core and runs a new application server. Please refer to: +# - V1 agentic core (SDK): https://github.com/OpenHands/software-agent-sdk +# - V1 application server (in this repo): openhands/app_server/ +# Unless you are working on deprecation, please avoid extending this legacy file and consult the V1 codepaths above. +# Tag: Legacy-V0 from openhands_aci.indexing.locagent.tools import ( explore_tree_structure, get_entity_contents, diff --git a/openhands/runtime/plugins/agent_skills/utils/config.py b/openhands/runtime/plugins/agent_skills/utils/config.py index 6bdf192fe8..948fd4d42e 100644 --- a/openhands/runtime/plugins/agent_skills/utils/config.py +++ b/openhands/runtime/plugins/agent_skills/utils/config.py @@ -1,3 +1,10 @@ +# IMPORTANT: LEGACY V0 CODE - Deprecated since version 1.0.0, scheduled for removal April 1, 2026 +# This file is part of the legacy (V0) implementation of OpenHands and will be removed soon as we complete the migration to V1. +# OpenHands V1 uses the Software Agent SDK for the agentic core and runs a new application server. Please refer to: +# - V1 agentic core (SDK): https://github.com/OpenHands/software-agent-sdk +# - V1 application server (in this repo): openhands/app_server/ +# Unless you are working on deprecation, please avoid extending this legacy file and consult the V1 codepaths above. +# Tag: Legacy-V0 import os from openai import OpenAI diff --git a/openhands/runtime/plugins/agent_skills/utils/dependency.py b/openhands/runtime/plugins/agent_skills/utils/dependency.py index 6143bd93e8..e0889fbb21 100644 --- a/openhands/runtime/plugins/agent_skills/utils/dependency.py +++ b/openhands/runtime/plugins/agent_skills/utils/dependency.py @@ -1,3 +1,10 @@ +# IMPORTANT: LEGACY V0 CODE - Deprecated since version 1.0.0, scheduled for removal April 1, 2026 +# This file is part of the legacy (V0) implementation of OpenHands and will be removed soon as we complete the migration to V1. +# OpenHands V1 uses the Software Agent SDK for the agentic core and runs a new application server. Please refer to: +# - V1 agentic core (SDK): https://github.com/OpenHands/software-agent-sdk +# - V1 application server (in this repo): openhands/app_server/ +# Unless you are working on deprecation, please avoid extending this legacy file and consult the V1 codepaths above. +# Tag: Legacy-V0 from types import ModuleType diff --git a/openhands/runtime/plugins/jupyter/__init__.py b/openhands/runtime/plugins/jupyter/__init__.py index 1baeaabdd2..b5660864bf 100644 --- a/openhands/runtime/plugins/jupyter/__init__.py +++ b/openhands/runtime/plugins/jupyter/__init__.py @@ -1,3 +1,10 @@ +# IMPORTANT: LEGACY V0 CODE - Deprecated since version 1.0.0, scheduled for removal April 1, 2026 +# This file is part of the legacy (V0) implementation of OpenHands and will be removed soon as we complete the migration to V1. +# OpenHands V1 uses the Software Agent SDK for the agentic core and runs a new application server. Please refer to: +# - V1 agentic core (SDK): https://github.com/OpenHands/software-agent-sdk +# - V1 application server (in this repo): openhands/app_server/ +# Unless you are working on deprecation, please avoid extending this legacy file and consult the V1 codepaths above. +# Tag: Legacy-V0 import asyncio import os import subprocess diff --git a/openhands/runtime/plugins/jupyter/execute_server.py b/openhands/runtime/plugins/jupyter/execute_server.py index 6d974b5b75..b96c4e3154 100644 --- a/openhands/runtime/plugins/jupyter/execute_server.py +++ b/openhands/runtime/plugins/jupyter/execute_server.py @@ -1,3 +1,10 @@ +# IMPORTANT: LEGACY V0 CODE - Deprecated since version 1.0.0, scheduled for removal April 1, 2026 +# This file is part of the legacy (V0) implementation of OpenHands and will be removed soon as we complete the migration to V1. +# OpenHands V1 uses the Software Agent SDK for the agentic core and runs a new application server. Please refer to: +# - V1 agentic core (SDK): https://github.com/OpenHands/software-agent-sdk +# - V1 application server (in this repo): openhands/app_server/ +# Unless you are working on deprecation, please avoid extending this legacy file and consult the V1 codepaths above. +# Tag: Legacy-V0 #!/usr/bin/env python3 import asyncio diff --git a/openhands/runtime/plugins/requirement.py b/openhands/runtime/plugins/requirement.py index 706d9b3fae..26446d143e 100644 --- a/openhands/runtime/plugins/requirement.py +++ b/openhands/runtime/plugins/requirement.py @@ -1,3 +1,10 @@ +# IMPORTANT: LEGACY V0 CODE - Deprecated since version 1.0.0, scheduled for removal April 1, 2026 +# This file is part of the legacy (V0) implementation of OpenHands and will be removed soon as we complete the migration to V1. +# OpenHands V1 uses the Software Agent SDK for the agentic core and runs a new application server. Please refer to: +# - V1 agentic core (SDK): https://github.com/OpenHands/software-agent-sdk +# - V1 application server (in this repo): openhands/app_server/ +# Unless you are working on deprecation, please avoid extending this legacy file and consult the V1 codepaths above. +# Tag: Legacy-V0 from abc import abstractmethod from dataclasses import dataclass diff --git a/openhands/runtime/plugins/vscode/__init__.py b/openhands/runtime/plugins/vscode/__init__.py index 865a69c987..80c56fbfa7 100644 --- a/openhands/runtime/plugins/vscode/__init__.py +++ b/openhands/runtime/plugins/vscode/__init__.py @@ -1,3 +1,10 @@ +# IMPORTANT: LEGACY V0 CODE - Deprecated since version 1.0.0, scheduled for removal April 1, 2026 +# This file is part of the legacy (V0) implementation of OpenHands and will be removed soon as we complete the migration to V1. +# OpenHands V1 uses the Software Agent SDK for the agentic core and runs a new application server. Please refer to: +# - V1 agentic core (SDK): https://github.com/OpenHands/software-agent-sdk +# - V1 application server (in this repo): openhands/app_server/ +# Unless you are working on deprecation, please avoid extending this legacy file and consult the V1 codepaths above. +# Tag: Legacy-V0 import asyncio import os import shutil diff --git a/openhands/runtime/runtime_status.py b/openhands/runtime/runtime_status.py index 1c22d4acab..cecae128fd 100644 --- a/openhands/runtime/runtime_status.py +++ b/openhands/runtime/runtime_status.py @@ -1,3 +1,10 @@ +# IMPORTANT: LEGACY V0 CODE - Deprecated since version 1.0.0, scheduled for removal April 1, 2026 +# This file is part of the legacy (V0) implementation of OpenHands and will be removed soon as we complete the migration to V1. +# OpenHands V1 uses the Software Agent SDK for the agentic core and runs a new application server. Please refer to: +# - V1 agentic core (SDK): https://github.com/OpenHands/software-agent-sdk +# - V1 application server (in this repo): openhands/app_server/ +# Unless you are working on deprecation, please avoid extending this legacy file and consult the V1 codepaths above. +# Tag: Legacy-V0 from enum import Enum diff --git a/openhands/runtime/utils/__init__.py b/openhands/runtime/utils/__init__.py index 622a0b6095..3695a3069e 100644 --- a/openhands/runtime/utils/__init__.py +++ b/openhands/runtime/utils/__init__.py @@ -1,3 +1,10 @@ +# IMPORTANT: LEGACY V0 CODE - Deprecated since version 1.0.0, scheduled for removal April 1, 2026 +# This file is part of the legacy (V0) implementation of OpenHands and will be removed soon as we complete the migration to V1. +# OpenHands V1 uses the Software Agent SDK for the agentic core and runs a new application server. Please refer to: +# - V1 agentic core (SDK): https://github.com/OpenHands/software-agent-sdk +# - V1 application server (in this repo): openhands/app_server/ +# Unless you are working on deprecation, please avoid extending this legacy file and consult the V1 codepaths above. +# Tag: Legacy-V0 from openhands.runtime.utils.system import ( display_number_matrix, find_available_tcp_port, diff --git a/openhands/runtime/utils/bash.py b/openhands/runtime/utils/bash.py index 988873ad8a..66bc399a0a 100644 --- a/openhands/runtime/utils/bash.py +++ b/openhands/runtime/utils/bash.py @@ -1,3 +1,10 @@ +# IMPORTANT: LEGACY V0 CODE - Deprecated since version 1.0.0, scheduled for removal April 1, 2026 +# This file is part of the legacy (V0) implementation of OpenHands and will be removed soon as we complete the migration to V1. +# OpenHands V1 uses the Software Agent SDK for the agentic core and runs a new application server. Please refer to: +# - V1 agentic core (SDK): https://github.com/OpenHands/software-agent-sdk +# - V1 application server (in this repo): openhands/app_server/ +# Unless you are working on deprecation, please avoid extending this legacy file and consult the V1 codepaths above. +# Tag: Legacy-V0 import os import re import time diff --git a/openhands/runtime/utils/bash_constants.py b/openhands/runtime/utils/bash_constants.py index 6258014724..2ee33d7d65 100644 --- a/openhands/runtime/utils/bash_constants.py +++ b/openhands/runtime/utils/bash_constants.py @@ -1,3 +1,10 @@ +# IMPORTANT: LEGACY V0 CODE - Deprecated since version 1.0.0, scheduled for removal April 1, 2026 +# This file is part of the legacy (V0) implementation of OpenHands and will be removed soon as we complete the migration to V1. +# OpenHands V1 uses the Software Agent SDK for the agentic core and runs a new application server. Please refer to: +# - V1 agentic core (SDK): https://github.com/OpenHands/software-agent-sdk +# - V1 application server (in this repo): openhands/app_server/ +# Unless you are working on deprecation, please avoid extending this legacy file and consult the V1 codepaths above. +# Tag: Legacy-V0 # Common timeout message that can be used across different timeout scenarios TIMEOUT_MESSAGE_TEMPLATE = ( "You may wait longer to see additional output by sending empty command '', " diff --git a/openhands/runtime/utils/command.py b/openhands/runtime/utils/command.py index affecc2575..d27525f858 100644 --- a/openhands/runtime/utils/command.py +++ b/openhands/runtime/utils/command.py @@ -1,3 +1,10 @@ +# IMPORTANT: LEGACY V0 CODE - Deprecated since version 1.0.0, scheduled for removal April 1, 2026 +# This file is part of the legacy (V0) implementation of OpenHands and will be removed soon as we complete the migration to V1. +# OpenHands V1 uses the Software Agent SDK for the agentic core and runs a new application server. Please refer to: +# - V1 agentic core (SDK): https://github.com/OpenHands/software-agent-sdk +# - V1 application server (in this repo): openhands/app_server/ +# Unless you are working on deprecation, please avoid extending this legacy file and consult the V1 codepaths above. +# Tag: Legacy-V0 import os from openhands.core.config import OpenHandsConfig diff --git a/openhands/runtime/utils/edit.py b/openhands/runtime/utils/edit.py index 7be5897ecf..37075a016a 100644 --- a/openhands/runtime/utils/edit.py +++ b/openhands/runtime/utils/edit.py @@ -1,3 +1,10 @@ +# IMPORTANT: LEGACY V0 CODE - Deprecated since version 1.0.0, scheduled for removal April 1, 2026 +# This file is part of the legacy (V0) implementation of OpenHands and will be removed soon as we complete the migration to V1. +# OpenHands V1 uses the Software Agent SDK for the agentic core and runs a new application server. Please refer to: +# - V1 agentic core (SDK): https://github.com/OpenHands/software-agent-sdk +# - V1 application server (in this repo): openhands/app_server/ +# Unless you are working on deprecation, please avoid extending this legacy file and consult the V1 codepaths above. +# Tag: Legacy-V0 import os import re import tempfile diff --git a/openhands/runtime/utils/file_viewer.py b/openhands/runtime/utils/file_viewer.py index 181e78ddd9..b3eb9b2d60 100644 --- a/openhands/runtime/utils/file_viewer.py +++ b/openhands/runtime/utils/file_viewer.py @@ -1,3 +1,10 @@ +# IMPORTANT: LEGACY V0 CODE - Deprecated since version 1.0.0, scheduled for removal April 1, 2026 +# This file is part of the legacy (V0) implementation of OpenHands and will be removed soon as we complete the migration to V1. +# OpenHands V1 uses the Software Agent SDK for the agentic core and runs a new application server. Please refer to: +# - V1 agentic core (SDK): https://github.com/OpenHands/software-agent-sdk +# - V1 application server (in this repo): openhands/app_server/ +# Unless you are working on deprecation, please avoid extending this legacy file and consult the V1 codepaths above. +# Tag: Legacy-V0 """Utility module for generating file viewer HTML content.""" import base64 diff --git a/openhands/runtime/utils/files.py b/openhands/runtime/utils/files.py index 772293195a..5000bb10a4 100644 --- a/openhands/runtime/utils/files.py +++ b/openhands/runtime/utils/files.py @@ -1,3 +1,10 @@ +# IMPORTANT: LEGACY V0 CODE - Deprecated since version 1.0.0, scheduled for removal April 1, 2026 +# This file is part of the legacy (V0) implementation of OpenHands and will be removed soon as we complete the migration to V1. +# OpenHands V1 uses the Software Agent SDK for the agentic core and runs a new application server. Please refer to: +# - V1 agentic core (SDK): https://github.com/OpenHands/software-agent-sdk +# - V1 application server (in this repo): openhands/app_server/ +# Unless you are working on deprecation, please avoid extending this legacy file and consult the V1 codepaths above. +# Tag: Legacy-V0 import os from pathlib import Path diff --git a/openhands/runtime/utils/git_changes.py b/openhands/runtime/utils/git_changes.py index d53a9e8de4..1a83844cfd 100644 --- a/openhands/runtime/utils/git_changes.py +++ b/openhands/runtime/utils/git_changes.py @@ -1,3 +1,10 @@ +# IMPORTANT: LEGACY V0 CODE - Deprecated since version 1.0.0, scheduled for removal April 1, 2026 +# This file is part of the legacy (V0) implementation of OpenHands and will be removed soon as we complete the migration to V1. +# OpenHands V1 uses the Software Agent SDK for the agentic core and runs a new application server. Please refer to: +# - V1 agentic core (SDK): https://github.com/OpenHands/software-agent-sdk +# - V1 application server (in this repo): openhands/app_server/ +# Unless you are working on deprecation, please avoid extending this legacy file and consult the V1 codepaths above. +# Tag: Legacy-V0 #!/usr/bin/env python3 """Get git changes in the current working directory relative to the remote origin if possible. NOTE: Since this is run as a script, there should be no imports from project files! diff --git a/openhands/runtime/utils/git_diff.py b/openhands/runtime/utils/git_diff.py index eb9cfdf990..b42dc861e4 100644 --- a/openhands/runtime/utils/git_diff.py +++ b/openhands/runtime/utils/git_diff.py @@ -1,3 +1,10 @@ +# IMPORTANT: LEGACY V0 CODE - Deprecated since version 1.0.0, scheduled for removal April 1, 2026 +# This file is part of the legacy (V0) implementation of OpenHands and will be removed soon as we complete the migration to V1. +# OpenHands V1 uses the Software Agent SDK for the agentic core and runs a new application server. Please refer to: +# - V1 agentic core (SDK): https://github.com/OpenHands/software-agent-sdk +# - V1 application server (in this repo): openhands/app_server/ +# Unless you are working on deprecation, please avoid extending this legacy file and consult the V1 codepaths above. +# Tag: Legacy-V0 #!/usr/bin/env python3 """Get git diff in a single git file for the closest git repo in the file system NOTE: Since this is run as a script, there should be no imports from project files! diff --git a/openhands/runtime/utils/git_handler.py b/openhands/runtime/utils/git_handler.py index 000acfb2d0..ba85aa34d1 100644 --- a/openhands/runtime/utils/git_handler.py +++ b/openhands/runtime/utils/git_handler.py @@ -1,3 +1,10 @@ +# IMPORTANT: LEGACY V0 CODE - Deprecated since version 1.0.0, scheduled for removal April 1, 2026 +# This file is part of the legacy (V0) implementation of OpenHands and will be removed soon as we complete the migration to V1. +# OpenHands V1 uses the Software Agent SDK for the agentic core and runs a new application server. Please refer to: +# - V1 agentic core (SDK): https://github.com/OpenHands/software-agent-sdk +# - V1 application server (in this repo): openhands/app_server/ +# Unless you are working on deprecation, please avoid extending this legacy file and consult the V1 codepaths above. +# Tag: Legacy-V0 import json from dataclasses import dataclass from pathlib import Path diff --git a/openhands/runtime/utils/log_capture.py b/openhands/runtime/utils/log_capture.py index 9cca3658c7..9f4edf28bf 100644 --- a/openhands/runtime/utils/log_capture.py +++ b/openhands/runtime/utils/log_capture.py @@ -1,3 +1,10 @@ +# IMPORTANT: LEGACY V0 CODE - Deprecated since version 1.0.0, scheduled for removal April 1, 2026 +# This file is part of the legacy (V0) implementation of OpenHands and will be removed soon as we complete the migration to V1. +# OpenHands V1 uses the Software Agent SDK for the agentic core and runs a new application server. Please refer to: +# - V1 agentic core (SDK): https://github.com/OpenHands/software-agent-sdk +# - V1 application server (in this repo): openhands/app_server/ +# Unless you are working on deprecation, please avoid extending this legacy file and consult the V1 codepaths above. +# Tag: Legacy-V0 import io import logging from contextlib import asynccontextmanager diff --git a/openhands/runtime/utils/log_streamer.py b/openhands/runtime/utils/log_streamer.py index 022b85dfdb..455e87004a 100644 --- a/openhands/runtime/utils/log_streamer.py +++ b/openhands/runtime/utils/log_streamer.py @@ -1,3 +1,10 @@ +# IMPORTANT: LEGACY V0 CODE - Deprecated since version 1.0.0, scheduled for removal April 1, 2026 +# This file is part of the legacy (V0) implementation of OpenHands and will be removed soon as we complete the migration to V1. +# OpenHands V1 uses the Software Agent SDK for the agentic core and runs a new application server. Please refer to: +# - V1 agentic core (SDK): https://github.com/OpenHands/software-agent-sdk +# - V1 application server (in this repo): openhands/app_server/ +# Unless you are working on deprecation, please avoid extending this legacy file and consult the V1 codepaths above. +# Tag: Legacy-V0 import threading from typing import Callable diff --git a/openhands/runtime/utils/memory_monitor.py b/openhands/runtime/utils/memory_monitor.py index fe1209f751..5e2d6e58c8 100644 --- a/openhands/runtime/utils/memory_monitor.py +++ b/openhands/runtime/utils/memory_monitor.py @@ -1,3 +1,10 @@ +# IMPORTANT: LEGACY V0 CODE - Deprecated since version 1.0.0, scheduled for removal April 1, 2026 +# This file is part of the legacy (V0) implementation of OpenHands and will be removed soon as we complete the migration to V1. +# OpenHands V1 uses the Software Agent SDK for the agentic core and runs a new application server. Please refer to: +# - V1 agentic core (SDK): https://github.com/OpenHands/software-agent-sdk +# - V1 application server (in this repo): openhands/app_server/ +# Unless you are working on deprecation, please avoid extending this legacy file and consult the V1 codepaths above. +# Tag: Legacy-V0 """Memory monitoring utilities for the runtime.""" import threading diff --git a/openhands/runtime/utils/port_lock.py b/openhands/runtime/utils/port_lock.py index ea784451c9..0e655fa79a 100644 --- a/openhands/runtime/utils/port_lock.py +++ b/openhands/runtime/utils/port_lock.py @@ -1,3 +1,10 @@ +# IMPORTANT: LEGACY V0 CODE - Deprecated since version 1.0.0, scheduled for removal April 1, 2026 +# This file is part of the legacy (V0) implementation of OpenHands and will be removed soon as we complete the migration to V1. +# OpenHands V1 uses the Software Agent SDK for the agentic core and runs a new application server. Please refer to: +# - V1 agentic core (SDK): https://github.com/OpenHands/software-agent-sdk +# - V1 application server (in this repo): openhands/app_server/ +# Unless you are working on deprecation, please avoid extending this legacy file and consult the V1 codepaths above. +# Tag: Legacy-V0 """File-based port locking system for preventing race conditions in port allocation.""" import os diff --git a/openhands/runtime/utils/request.py b/openhands/runtime/utils/request.py index 4cd50fff80..3c71b28325 100644 --- a/openhands/runtime/utils/request.py +++ b/openhands/runtime/utils/request.py @@ -1,3 +1,10 @@ +# IMPORTANT: LEGACY V0 CODE - Deprecated since version 1.0.0, scheduled for removal April 1, 2026 +# This file is part of the legacy (V0) implementation of OpenHands and will be removed soon as we complete the migration to V1. +# OpenHands V1 uses the Software Agent SDK for the agentic core and runs a new application server. Please refer to: +# - V1 agentic core (SDK): https://github.com/OpenHands/software-agent-sdk +# - V1 application server (in this repo): openhands/app_server/ +# Unless you are working on deprecation, please avoid extending this legacy file and consult the V1 codepaths above. +# Tag: Legacy-V0 import json from typing import Any diff --git a/openhands/runtime/utils/runtime_build.py b/openhands/runtime/utils/runtime_build.py index f4f5d8904e..60be727112 100644 --- a/openhands/runtime/utils/runtime_build.py +++ b/openhands/runtime/utils/runtime_build.py @@ -1,3 +1,10 @@ +# IMPORTANT: LEGACY V0 CODE - Deprecated since version 1.0.0, scheduled for removal April 1, 2026 +# This file is part of the legacy (V0) implementation of OpenHands and will be removed soon as we complete the migration to V1. +# OpenHands V1 uses the Software Agent SDK for the agentic core and runs a new application server. Please refer to: +# - V1 agentic core (SDK): https://github.com/OpenHands/software-agent-sdk +# - V1 application server (in this repo): openhands/app_server/ +# Unless you are working on deprecation, please avoid extending this legacy file and consult the V1 codepaths above. +# Tag: Legacy-V0 import argparse import hashlib import os diff --git a/openhands/runtime/utils/runtime_init.py b/openhands/runtime/utils/runtime_init.py index a042f549d5..31d8128f6d 100644 --- a/openhands/runtime/utils/runtime_init.py +++ b/openhands/runtime/utils/runtime_init.py @@ -1,3 +1,10 @@ +# IMPORTANT: LEGACY V0 CODE - Deprecated since version 1.0.0, scheduled for removal April 1, 2026 +# This file is part of the legacy (V0) implementation of OpenHands and will be removed soon as we complete the migration to V1. +# OpenHands V1 uses the Software Agent SDK for the agentic core and runs a new application server. Please refer to: +# - V1 agentic core (SDK): https://github.com/OpenHands/software-agent-sdk +# - V1 application server (in this repo): openhands/app_server/ +# Unless you are working on deprecation, please avoid extending this legacy file and consult the V1 codepaths above. +# Tag: Legacy-V0 import os import subprocess import sys diff --git a/openhands/runtime/utils/singleton.py b/openhands/runtime/utils/singleton.py index e69de29bb2..bca669783c 100644 --- a/openhands/runtime/utils/singleton.py +++ b/openhands/runtime/utils/singleton.py @@ -0,0 +1,7 @@ +# IMPORTANT: LEGACY V0 CODE - Deprecated since version 1.0.0, scheduled for removal April 1, 2026 +# This file is part of the legacy (V0) implementation of OpenHands and will be removed soon as we complete the migration to V1. +# OpenHands V1 uses the Software Agent SDK for the agentic core and runs a new application server. Please refer to: +# - V1 agentic core (SDK): https://github.com/OpenHands/software-agent-sdk +# - V1 application server (in this repo): openhands/app_server/ +# Unless you are working on deprecation, please avoid extending this legacy file and consult the V1 codepaths above. +# Tag: Legacy-V0 diff --git a/openhands/runtime/utils/system.py b/openhands/runtime/utils/system.py index 171a6575c2..6734ddcb81 100644 --- a/openhands/runtime/utils/system.py +++ b/openhands/runtime/utils/system.py @@ -1,3 +1,10 @@ +# IMPORTANT: LEGACY V0 CODE - Deprecated since version 1.0.0, scheduled for removal April 1, 2026 +# This file is part of the legacy (V0) implementation of OpenHands and will be removed soon as we complete the migration to V1. +# OpenHands V1 uses the Software Agent SDK for the agentic core and runs a new application server. Please refer to: +# - V1 agentic core (SDK): https://github.com/OpenHands/software-agent-sdk +# - V1 application server (in this repo): openhands/app_server/ +# Unless you are working on deprecation, please avoid extending this legacy file and consult the V1 codepaths above. +# Tag: Legacy-V0 import random import socket import time diff --git a/openhands/runtime/utils/system_stats.py b/openhands/runtime/utils/system_stats.py index dda66f907c..bc71ac7db3 100644 --- a/openhands/runtime/utils/system_stats.py +++ b/openhands/runtime/utils/system_stats.py @@ -1,3 +1,10 @@ +# IMPORTANT: LEGACY V0 CODE - Deprecated since version 1.0.0, scheduled for removal April 1, 2026 +# This file is part of the legacy (V0) implementation of OpenHands and will be removed soon as we complete the migration to V1. +# OpenHands V1 uses the Software Agent SDK for the agentic core and runs a new application server. Please refer to: +# - V1 agentic core (SDK): https://github.com/OpenHands/software-agent-sdk +# - V1 application server (in this repo): openhands/app_server/ +# Unless you are working on deprecation, please avoid extending this legacy file and consult the V1 codepaths above. +# Tag: Legacy-V0 """Utilities for getting system resource statistics.""" import time diff --git a/openhands/runtime/utils/tenacity_stop.py b/openhands/runtime/utils/tenacity_stop.py index d9aa83a613..2990f9e02b 100644 --- a/openhands/runtime/utils/tenacity_stop.py +++ b/openhands/runtime/utils/tenacity_stop.py @@ -1,3 +1,10 @@ +# IMPORTANT: LEGACY V0 CODE - Deprecated since version 1.0.0, scheduled for removal April 1, 2026 +# This file is part of the legacy (V0) implementation of OpenHands and will be removed soon as we complete the migration to V1. +# OpenHands V1 uses the Software Agent SDK for the agentic core and runs a new application server. Please refer to: +# - V1 agentic core (SDK): https://github.com/OpenHands/software-agent-sdk +# - V1 application server (in this repo): openhands/app_server/ +# Unless you are working on deprecation, please avoid extending this legacy file and consult the V1 codepaths above. +# Tag: Legacy-V0 from tenacity import RetryCallState from tenacity.stop import stop_base diff --git a/openhands/runtime/utils/windows_bash.py b/openhands/runtime/utils/windows_bash.py index 6771664939..4b93c9a36f 100644 --- a/openhands/runtime/utils/windows_bash.py +++ b/openhands/runtime/utils/windows_bash.py @@ -1,3 +1,10 @@ +# IMPORTANT: LEGACY V0 CODE - Deprecated since version 1.0.0, scheduled for removal April 1, 2026 +# This file is part of the legacy (V0) implementation of OpenHands and will be removed soon as we complete the migration to V1. +# OpenHands V1 uses the Software Agent SDK for the agentic core and runs a new application server. Please refer to: +# - V1 agentic core (SDK): https://github.com/OpenHands/software-agent-sdk +# - V1 application server (in this repo): openhands/app_server/ +# Unless you are working on deprecation, please avoid extending this legacy file and consult the V1 codepaths above. +# Tag: Legacy-V0 """This module provides a Windows-specific implementation for running commands in a PowerShell session using the pythonnet library to interact with the .NET PowerShell SDK directly. This aims to provide a more robust and integrated diff --git a/openhands/runtime/utils/windows_exceptions.py b/openhands/runtime/utils/windows_exceptions.py index 3863af6901..a7c3dab34a 100644 --- a/openhands/runtime/utils/windows_exceptions.py +++ b/openhands/runtime/utils/windows_exceptions.py @@ -1,3 +1,10 @@ +# IMPORTANT: LEGACY V0 CODE - Deprecated since version 1.0.0, scheduled for removal April 1, 2026 +# This file is part of the legacy (V0) implementation of OpenHands and will be removed soon as we complete the migration to V1. +# OpenHands V1 uses the Software Agent SDK for the agentic core and runs a new application server. Please refer to: +# - V1 agentic core (SDK): https://github.com/OpenHands/software-agent-sdk +# - V1 application server (in this repo): openhands/app_server/ +# Unless you are working on deprecation, please avoid extending this legacy file and consult the V1 codepaths above. +# Tag: Legacy-V0 """Custom exceptions for Windows-specific runtime issues."""