Switch LLM profiles

[enyst]

Summary

• add runtime LLM profile switching support for local conversations
• document the workflow and provide an example script
• describe constraints around inline mode and idle status

Testing

• unit tests via pre-commit hooks

---

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:4075571-python

Run

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

All tags pushed for this build

ghcr.io/openhands/agent-server:4075571-golang-amd64
ghcr.io/openhands/agent-server:v1.0.0a5_golang_tag_1.21-bookworm_binary-amd64
ghcr.io/openhands/agent-server:4075571-golang-arm64
ghcr.io/openhands/agent-server:v1.0.0a5_golang_tag_1.21-bookworm_binary-arm64
ghcr.io/openhands/agent-server:4075571-java-amd64
ghcr.io/openhands/agent-server:v1.0.0a5_eclipse-temurin_tag_17-jdk_binary-amd64
ghcr.io/openhands/agent-server:4075571-java-arm64
ghcr.io/openhands/agent-server:v1.0.0a5_eclipse-temurin_tag_17-jdk_binary-arm64
ghcr.io/openhands/agent-server:4075571-python-amd64
ghcr.io/openhands/agent-server:v1.0.0a5_nikolaik_s_python-nodejs_tag_python3.12-nodejs22_binary-amd64
ghcr.io/openhands/agent-server:4075571-python-arm64
ghcr.io/openhands/agent-server:v1.0.0a5_nikolaik_s_python-nodejs_tag_python3.12-nodejs22_binary-arm64
ghcr.io/openhands/agent-server:4075571-golang
ghcr.io/openhands/agent-server:4075571-java
ghcr.io/openhands/agent-server:4075571-python

About Multi-Architecture Support

• Each variant tag (e.g., 4075571-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., 4075571-python-amd64) are also available if needed

[github-actions]

Coverage Report •

File	Stmts	Miss	Cover	Missing
openhands-sdk/openhands/sdk/agent
base.py	167	25	85%	156, 162, 180–182, 211–212, 218–220, 233, 241–242, 273, 319, 326, 335–337, 347, 384–385, 395–396, 427
openhands-sdk/openhands/sdk/conversation
state.py	180	47	73%	195, 200–202, 204–205, 211, 236, 281–283, 299–300, 307–308, 312, 316, 318–324, 326–328, 355, 373, 382, 397, 403, 411, 423–436
openhands-sdk/openhands/sdk/conversation/impl
local_conversation.py	184	51	72%	142–143, 148–149, 174, 179, 184–187, 204, 221, 229–231, 235–236, 288–289, 292, 299, 320–322, 324, 340, 342, 344, 348, 350–352, 354, 356, 362–363, 376–377, 379, 381, 385–388, 406, 414, 416–418, 436, 438
openhands-sdk/openhands/sdk/llm
llm.py	468	191	59%	328, 343, 348–352, 354–355, 362–363, 367–371, 374, 379, 383, 387, 391–393, 397–398, 409–410, 412–413, 417, 434, 459, 464, 468, 473, 493, 522, 543, 547, 562, 568–569, 588–589, 597, 622–627, 648–649, 652, 656, 668, 673–676, 683, 686, 694–699, 703–706, 708, 721, 725–727, 729–730, 735–736, 738, 745, 748–753, 821–824, 829–833, 835–840, 842–844, 853–855, 858–859, 900–901, 904–907, 948, 962, 1012, 1015–1017, 1020–1028, 1032–1034, 1037, 1040–1042, 1049–1050, 1059, 1066–1068, 1072, 1074–1079, 1081–1098, 1101–1105, 1107–1108, 1114–1123, 1136, 1150, 1155
llm_registry.py	135	75	44%	90–91, 97, 113, 118, 127–132, 135, 148–149, 154–155, 157–160, 162–166, 170, 175–178, 185–187, 191–194, 196–199, 206–210, 212–216, 218–221, 226–233, 235–237, 265–268, 282–283, 288, 291, 296
TOTAL	11854	5527	53%

[openhands-ai]

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

• GitHub Actions are failing:
  • Pre-commit checks
  • Check Documented Examples

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

@OpenHands please fix the failing actions on PR #1049 at branch `agent-sdk-26-llm-switch`

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

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