Published June 4, 2026
| Version v1.25.0
Software
Open
OpenHands/software-agent-sdk: v1.25.0
Authors/Creators
- Xingyao Wang1
- Engel Nyst
- simonrosenberg
- Graham Neubig2
- Vasco Schiavo3
- Juan Michelini
- Tim O'Farrell
- Robert Brennan4
- Rohit Malhotra5
- Calvin Smith
- OpenHands Bot
- Ryan H. Tran
- Hiep Le
- John-Mason P. Shackelford3
- aivong-openhands
- Aman Pandey
- OpenHands6
- Manojkumar Palanisamy
- Dinmukhamed Mailibay7
- PiteXChen8
- Jamie Chicago
- Nelson Spence9
- Alona
- Cesar Garcia
- Chris Bagwell
- Jathin Sreenivas10
- Ray Myers3
- LuneZ9911
- chuckbutkus
- 1. OpenHands / All Hands AI
- 2. Carnegie Mellon University / OpenHands
- 3. @OpenHands
- 4. OpenHands
- 5. Carnegie Mellon University
- 6. @all-hands-ai
- 7. @lmnr-ai
- 8. xxx
- 9. @Project-Navi
- 10. Amazon
- 11. -
Description
What's Changed
- feat(hooks): add HookType.AGENT for agent-based hook evaluation by @burakkeless in https://github.com/OpenHands/software-agent-sdk/pull/3052
- Upgrade LiteLLM to 1.84.1 by @neubig in https://github.com/OpenHands/software-agent-sdk/pull/3233
- fix(terminal): reduce tmux session viewport by @serejaris in https://github.com/OpenHands/software-agent-sdk/pull/3394
- [codex] Accept ACP user messages during async turns by @neubig in https://github.com/OpenHands/software-agent-sdk/pull/3376
- Register claude-opus-4-8 in SDK model lists by @juanmichelini in https://github.com/OpenHands/software-agent-sdk/pull/3424
- fix(llm): strip temperature/top_p for claude-opus-4-8 by @juanmichelini in https://github.com/OpenHands/software-agent-sdk/pull/3427
- fix: drop invalid bare claude-opus-4-5 from OpenHands verified models by @hieptl in https://github.com/OpenHands/software-agent-sdk/pull/3421
- Fix RemoteConversation FINISHED stop-hook race by @neubig in https://github.com/OpenHands/software-agent-sdk/pull/3191
- ci(agent-server): add stress-test job; fix sub-second bash event ordering by @VascoSch92 in https://github.com/OpenHands/software-agent-sdk/pull/3203
- docs(sdk): document FIFOLock held across arun()'s await (Q4 of #3341) by @VascoSch92 in https://github.com/OpenHands/software-agent-sdk/pull/3400
- fix(acp): decrypt dict-shaped secrets on cipher round-trip + consolidate by @simonrosenberg in https://github.com/OpenHands/software-agent-sdk/pull/3422
- chore(deps): bump idna from 3.10 to 3.15 by @dependabot[bot] in https://github.com/OpenHands/software-agent-sdk/pull/3337
- feat(sdk): deprecate no-op _return_metrics LLM param (Q1 of #3341) by @VascoSch92 in https://github.com/OpenHands/software-agent-sdk/pull/3432
- feat(agent-server): RFC 7386 merge-patch unset for PATCH /api/settings by @simonrosenberg in https://github.com/OpenHands/software-agent-sdk/pull/3431
- test(stress): bump concurrent conversations wall_time_factor to 4.0 by @VascoSch92 in https://github.com/OpenHands/software-agent-sdk/pull/3434
- Revert "fix(llm): strip temperature/top_p for claude-opus-4-8 (#3427)" by @juanmichelini in https://github.com/OpenHands/software-agent-sdk/pull/3441
- fix(sdk): count tools for condenser token limits by @neubig in https://github.com/OpenHands/software-agent-sdk/pull/3445
- chore: remove dead async title generation helpers by @VascoSch92 in https://github.com/OpenHands/software-agent-sdk/pull/3447
- Add nemotron-3-ultra-550b-a55b model config by @juanmichelini in https://github.com/OpenHands/software-agent-sdk/pull/3251
- fix(release-binaries): use macos-15-intel and make publishing resilient by @VascoSch92 in https://github.com/OpenHands/software-agent-sdk/pull/3454
- fix(sdk): add missing @observe spans on async agent/conversation paths by @VascoSch92 in https://github.com/OpenHands/software-agent-sdk/pull/3451
- fix(sdk): keep cancelled token observable after arun() interrupt by @VascoSch92 in https://github.com/OpenHands/software-agent-sdk/pull/3395
- chore(sdk): remove dead Tool.acall method (Q1 of #3341) by @VascoSch92 in https://github.com/OpenHands/software-agent-sdk/pull/3456
- refactor(llm): dedupe _transport_call/_atransport_call twins (#3341 Q5.iii) by @VascoSch92 in https://github.com/OpenHands/software-agent-sdk/pull/3455
- feat: send x-litellm-session-id header for conversation-level routing affinity by @csmith49 in https://github.com/OpenHands/software-agent-sdk/pull/3437
- fix(sdk): use dedicated ThreadPoolExecutor per aexecute_batch (Q3 of #3341) by @VascoSch92 in https://github.com/OpenHands/software-agent-sdk/pull/3419
- Lazy watermark-based View cache on ConversationState by @csmith49 in https://github.com/OpenHands/software-agent-sdk/pull/3335
- Revert removal of ToolDefinition.acall by @enyst in https://github.com/OpenHands/software-agent-sdk/pull/3466
- fix(acp): surface structured errors on ACP spawn/auth/init failure by @simonrosenberg in https://github.com/OpenHands/software-agent-sdk/pull/3462
- refactor(acp): dedup tool-call progress at the source (O(n²)→O(1)) by @simonrosenberg in https://github.com/OpenHands/software-agent-sdk/pull/3465
- fix(acp): route provider creds through secret_registry; deprecate acp_env by @simonrosenberg in https://github.com/OpenHands/software-agent-sdk/pull/3464
- Fix nemotron-3-ultra-550b-a55b LiteLLM proxy model name by @juanmichelini in https://github.com/OpenHands/software-agent-sdk/pull/3468
- Add MiniMax M3 model configuration by @juanmichelini in https://github.com/OpenHands/software-agent-sdk/pull/3460
- docs(run-eval): guide reviewer/QA bot to not block on transient 'Invalid model name' preflight by @juanmichelini in https://github.com/OpenHands/software-agent-sdk/pull/3473
- Remove amber-vector-3542 from resolve model config by @juanmichelini in https://github.com/OpenHands/software-agent-sdk/pull/3471
- Add gpt-oss-120b model by @juanmichelini in https://github.com/OpenHands/software-agent-sdk/pull/3058
- fix(agent-server): bump pinned codex-acp 0.11.1 → 0.15.0 by @simonrosenberg in https://github.com/OpenHands/software-agent-sdk/pull/3478
- fix(acp): mask injected secrets in tool-call output and streamed text by @simonrosenberg in https://github.com/OpenHands/software-agent-sdk/pull/3463
- fix: prevent deep-merge when switching agent_kind settings variant by @simonrosenberg in https://github.com/OpenHands/software-agent-sdk/pull/3483
- feat(acp): materialise reserved file-content auth secrets (Codex auth.json, Gemini Vertex SA) by @simonrosenberg in https://github.com/OpenHands/software-agent-sdk/pull/3474
- perf(sdk): cache deserialized events in EventLog to eliminate O(N²) per-step cost by @csmith49 in https://github.com/OpenHands/software-agent-sdk/pull/3263
- fix(sdk): avoid switch_llm deadlock when the run loop holds the state lock by @VascoSch92 in https://github.com/OpenHands/software-agent-sdk/pull/3486
- docs(run-eval): require maintainer approval before editing verified_models.py by @juanmichelini in https://github.com/OpenHands/software-agent-sdk/pull/3479
- feat(acp): per-conversation CLI data-dir isolation for grouped sandboxes by @simonrosenberg in https://github.com/OpenHands/software-agent-sdk/pull/3492
- fix(acp): set codex base URL via openai_base_url config (codex ignores OPENAI_BASE_URL) by @simonrosenberg in https://github.com/OpenHands/software-agent-sdk/pull/3493
- feat(run-eval): add gemini-3.5-flash model configuration by @juanmichelini in https://github.com/OpenHands/software-agent-sdk/pull/3481
- fix(step-3.7-flash): stretch retry envelope to weather StepFun 10 RPM cap by @juanmichelini in https://github.com/OpenHands/software-agent-sdk/pull/3497
- docs(agents): add explicit comments policy to AGENTS.md by @juanmichelini in https://github.com/OpenHands/software-agent-sdk/pull/3502
- feat(acp): launch pinned pre-installed CLI binary instead of npx by @simonrosenberg in https://github.com/OpenHands/software-agent-sdk/pull/3490
- feat(acp): acp_resume_session_id (durable resume) + acp_isolate_data_dir on ACPAgentSettings by @simonrosenberg in https://github.com/OpenHands/software-agent-sdk/pull/3506
- feat(sdk): forward MCP servers to the ACP subprocess by @simonrosenberg in https://github.com/OpenHands/software-agent-sdk/pull/3458
- feat(settings): add verification.critic_api_key with fallback to LLM key by @xingyaoww in https://github.com/OpenHands/software-agent-sdk/pull/3494
- fix: remove the LLM settings->profile auto-migration by @VascoSch92 in https://github.com/OpenHands/software-agent-sdk/pull/3507
- fix(conversation): run ACP cold-start off the event loop in arun() by @simonrosenberg in https://github.com/OpenHands/software-agent-sdk/pull/3510
- Release v1.25.0 by @all-hands-bot in https://github.com/OpenHands/software-agent-sdk/pull/3509
New Contributors
- @burakkeless made their first contribution in https://github.com/OpenHands/software-agent-sdk/pull/3052
- @serejaris made their first contribution in https://github.com/OpenHands/software-agent-sdk/pull/3394
Full Changelog: https://github.com/OpenHands/software-agent-sdk/compare/v1.24.0...v1.25.0
Files
OpenHands/software-agent-sdk-v1.25.0.zip
Additional details
Related works
- Is supplement to
- Software: https://github.com/OpenHands/software-agent-sdk/tree/v1.25.0 (URL)
Software
- Repository URL
- https://github.com/OpenHands/software-agent-sdk