feat(llm): add LLM profiles

[enyst]

Summary

• integrate LLM profile persistence into LLMRegistry, exposing list/load/save/register/validate helpers with configurable profile directories
• rename the conversation persistence helpers to resolve_llm_profiles / compact_llm_profiles and update ConversationState to use them
• keep the SDK UI-agnostic by dropping the agent_settings shim while reusing the shared profile transforms

Testing

• .venv/bin/python -m pytest tests/sdk/llm/test_llm_registry_profiles.py
• .venv/bin/python -m pytest tests/sdk/conversation/local/test_state_serialization.py

---

Agent Server images for this PR

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

Variants & Base Images

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

Pull (multi-arch manifest)

docker pull ghcr.io/openhands/agent-server:b30b93f-python

Run

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

All tags pushed for this build

ghcr.io/openhands/agent-server:b30b93f-golang
ghcr.io/openhands/agent-server:v1.0.0a4_golang_tag_1.21-bookworm_binary
ghcr.io/openhands/agent-server:b30b93f-java
ghcr.io/openhands/agent-server:v1.0.0a4_eclipse-temurin_tag_17-jdk_binary
ghcr.io/openhands/agent-server:b30b93f-python
ghcr.io/openhands/agent-server:v1.0.0a4_nikolaik_s_python-nodejs_tag_python3.12-nodejs22_binary

The b30b93f tag is a multi-arch manifest (amd64/arm64); your client pulls the right arch automatically.

[github-actions]

Coverage Report •

File	Stmts	Miss	Cover	Missing
openhands-sdk/openhands/sdk/agent
base.py	162	16	90%	145, 151, 169–171, 220, 228–229, 260, 306, 313, 327, 364–365, 375–376
openhands-sdk/openhands/sdk/conversation
state.py	168	33	80%	195, 200–202, 204–205, 211, 236, 281–283, 299–300, 329, 347, 356, 371, 377, 385, 397–410
openhands-sdk/openhands/sdk/conversation/impl
local_conversation.py	163	45	72%	132–133, 138–139, 159, 164, 176, 193, 201–203, 207–208, 258–260, 267, 286–287, 289, 303, 305, 307, 311, 313–315, 317, 319, 325–326, 339–340, 342, 344, 348–351, 373, 375–377, 394, 396
openhands-sdk/openhands/sdk/llm
llm.py	471	184	60%	300, 311, 321, 329, 334–338, 340–341, 348–349, 353–357, 360, 365, 369, 381, 385–387, 391–392, 403, 405, 409, 426, 460, 465, 469, 474, 485, 501, 522, 526, 541, 547–548, 567–568, 576, 601–603, 624–625, 628, 632, 644, 649–652, 659, 662, 670–675, 678, 693, 697–699, 701–702, 707–708, 710, 717, 720–722, 784–787, 792–797, 801–802, 811–813, 816–817, 854–855, 901, 921, 956, 972, 975–977, 980–988, 992–994, 997, 1000–1002, 1009–1010, 1019, 1026–1028, 1032, 1034–1039, 1041–1058, 1061–1065, 1067–1068, 1074–1083, 1096, 1110, 1115, 1129–1130, 1135–1136, 1140, 1142, 1151–1152, 1156, 1161–1162, 1167
llm_registry.py	122	63	48%	90–91, 97, 113, 118, 127–132, 135, 148–149, 154–157, 164–166, 170–173, 175–178, 185–189, 191–195, 197–200, 205–212, 214–216, 244–247, 261–262, 267, 270, 275
TOTAL	10770	4738	56%

[blacksmith-sh]

[Automatic Post]: It has been a while since there was any activity on this PR. @enyst, are you still working on it? If so, please go ahead, if not then please request review, close it, or request that someone else follow up.

[openhands-ai]

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

• GitHub Actions are failing:
  • Pre-commit checks
  • Run tests
  • Check Documented Examples
  • Agent Server

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

@OpenHands please fix the failing actions on PR #795 at branch `agent-sdk-18-profile-manager`

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

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