Deprecate old endpoints

Author: chuckbutkus

openhands-agent-server/openhands/agent_server/git_router.py

@@ -10,6 +10,7 @@
 from openhands.sdk.git.git_changes import get_git_changes
 from openhands.sdk.git.git_diff import get_git_diff
 from openhands.sdk.git.models import GitChange, GitDiff
+from openhands.sdk.utils.deprecation import deprecated
 
 
 git_router = APIRouter(prefix="/git", tags=["Git"])
@@ -39,6 +40,15 @@ async def git_changes_query(
 
 
 @git_router.get("/changes/{path:path}")
+@deprecated(
+    deprecated_in="1.15.0",
+    removed_in="1.20.0",
+    details=(
+        "Use the /git/changes endpoint with a query parameter for the path "
+        "instead of a path parameter. This allows for better handling of "
+        "complex paths and is more consistent with other endpoints."
+    ),
+)
 async def git_changes_path(path: str) -> list[GitChange]:
     """Get git changes using path parameter (legacy, for backwards compatibility)."""
     return await _get_git_changes(path)
@@ -53,6 +63,15 @@ async def git_diff_query(
 
 
 @git_router.get("/diff/{path:path}")
+@deprecated(
+    deprecated_in="1.15.0",
+    removed_in="1.20.0",
+    details=(
+        "Use the /git/changes endpoint with a query parameter for the path "
+        "instead of a path parameter. This allows for better handling of "
+        "complex paths and is more consistent with other endpoints."
+    ),
+)
 async def git_diff_path(path: str) -> GitDiff:
     """Get git diff using path parameter (legacy, for backwards compatibility)."""
     return await _get_git_diff(path)