Skip to content

docs(verify): map maintenance 2026-11-15 - #6869

Merged
enyst merged 2 commits into
mainfrom
cloud/nifty-ride-nkv0sb
Nov 16, 2026
Merged

enyst merged 2 commits into
mainfrom
cloud/nifty-ride-nkv0sb

Conversation

@enyst

@enyst enyst commented Nov 15, 2026 •

Copy link
Copy Markdown
Member

HUMAN:

Engel Nyst (@enyst) set up a daily automation that keeps the verify-agent-server and verify-sdk feature maps current. This PR is its run for main@2aae48b, after PR #5765.


AGENT:

I'm an AI agent helping Engel Nyst (@enyst) with project work.

Why

Daily delta pass over both feature maps for the 15 commits in 3c66af1d..2aae48b6 (11 product PRs). The map changes below come from live runs on main at 2aae48b, plus an independent re-run of every edited family.

Summary

Agent-server map (verify-agent-server): delta pass, 3c66af1d..2aae48b6

SDK map (verify-sdk): delta pass, 3c66af1d..2aae48b6

Both maps

Issue Number

#5751

How to Test

uv sync --dev
export PATH="$PWD/.agents/skills/verify-agent-server/scripts:$PWD/.agents/skills/verify-sdk/scripts:$PATH"
control-agent-server map check && control-agent-server map coverage && sdk-map check
for f in F02 F07 F10 F19 F30 F31; do control-agent-server map run --file $f --fresh --record --keep-going; done
for s in S01 S02 S04 S05 S20; do sdk-map run --file $s; done   # DEEPSEEK_API_KEY for the live bullets

Evidence, pinned to evidence commit bf2271de54196a4763857efe2fe42ef7cf0ae702:

  • Reports:
    • [agent-server main run](https://github.com/enyst/openhands-evidence/blob/bf2271de54196a4763857efe2fe42ef7cf0ae702/software-agent-sdk/map-maintenance/2026-11-15/agent-server-report-main.md)
    • [SDK main run](https://github.com/enyst/openhands-evidence/blob/bf2271de54196a4763857efe2fe42ef7cf0ae702/software-agent-sdk/map-maintenance/2026-11-15/sdk-report-main.md)
    • [agent-server edited re-run](https://github.com/enyst/openhands-evidence/blob/bf2271de54196a4763857efe2fe42ef7cf0ae702/software-agent-sdk/map-maintenance/2026-11-15/agent-server-report-edited.md)
    • [SDK edited re-run](https://github.com/enyst/openhands-evidence/blob/bf2271de54196a4763857efe2fe42ef7cf0ae702/software-agent-sdk/map-maintenance/2026-11-15/sdk-report-edited.md)
  • [F02.workspace-session-plain-http](https://github.com/enyst/openhands-evidence/blob/bf2271de54196a4763857efe2fe42ef7cf0ae702/software-agent-sdk/map-maintenance/2026-11-15/edited/transcripts/F02-auth-and-sessions-22-plain-http-to-a-non-loopback-host-f02-wo.json): the lax and none cookie headers.
  • F07.snapshot-compact-stats, [main xpass](https://github.com/enyst/openhands-evidence/blob/bf2271de54196a4763857efe2fe42ef7cf0ae702/software-agent-sdk/map-maintenance/2026-11-15/main/transcripts/F07-session-socket-20-compact-snapshot-stats-f07-snapshot-comp.json) and [edited pass](https://github.com/enyst/openhands-evidence/blob/bf2271de54196a4763857efe2fe42ef7cf0ae702/software-agent-sdk/map-maintenance/2026-11-15/edited/transcripts/F07-session-socket-20-compact-snapshot-stats-f07-snapshot-comp.json): the snapshot without per-call lists, and REST with empty lists.
  • F19, the redirect route and its validation:
    • [route](https://github.com/enyst/openhands-evidence/blob/bf2271de54196a4763857efe2fe42ef7cf0ae702/software-agent-sdk/map-maintenance/2026-11-15/edited/transcripts/F19-mcp-23-redirect-to-the-agent-server-s-own-route.json)
    • [unknown state](https://github.com/enyst/openhands-evidence/blob/bf2271de54196a4763857efe2fe42ef7cf0ae702/software-agent-sdk/map-maintenance/2026-11-15/edited/transcripts/F19-mcp-24-unknown-sign-ins-on-the-redirect-route-f.json)
    • [callback_base_url](https://github.com/enyst/openhands-evidence/blob/bf2271de54196a4763857efe2fe42ef7cf0ae702/software-agent-sdk/map-maintenance/2026-11-15/edited/transcripts/F19-mcp-25-callback-base-url-validation-f19-oauth-c.json)
    • [web_url precedence](https://github.com/enyst/openhands-evidence/blob/bf2271de54196a4763857efe2fe42ef7cf0ae702/software-agent-sdk/map-maintenance/2026-11-15/edited/transcripts/F19-mcp-26-web-url-wins-over-the-request-f19-oauth-.json)
    • [public redirect](https://github.com/enyst/openhands-evidence/blob/bf2271de54196a4763857efe2fe42ef7cf0ae702/software-agent-sdk/map-maintenance/2026-11-15/edited/transcripts/F19-mcp-22-redirect-uri-on-the-public-origin-f19-oa.json)
  • Fixed-bug flips:
    • [F10.ask-agent-usage-saved](https://github.com/enyst/openhands-evidence/blob/bf2271de54196a4763857efe2fe42ef7cf0ae702/software-agent-sdk/map-maintenance/2026-11-15/edited/transcripts/F10-fork-navigate-condense-ask-26-ask-usage-on-get-and-after-a-restart-f10.json)
    • [F30.chat-reuse-paused](https://github.com/enyst/openhands-evidence/blob/bf2271de54196a4763857efe2fe42ef7cf0ae702/software-agent-sdk/map-maintenance/2026-11-15/edited/transcripts/F30-openai-gateway-18-continue-a-paused-conversation-f30-chat-.json)
    • [F31.lease-zombie-owner-takeover](https://github.com/enyst/openhands-evidence/blob/bf2271de54196a4763857efe2fe42ef7cf0ae702/software-agent-sdk/map-maintenance/2026-11-15/edited/transcripts/F31-persistence-and-limits-05-zombie-owner-takeover-f31-lease-zombie-o.json)
  • F30.chat-usage-per-request, [main fail (drift)](https://github.com/enyst/openhands-evidence/blob/bf2271de54196a4763857efe2fe42ef7cf0ae702/software-agent-sdk/map-maintenance/2026-11-15/main/transcripts/F30-openai-gateway-14-usage-per-request-f30-chat-usage-per-req.json) and [edited pass](https://github.com/enyst/openhands-evidence/blob/bf2271de54196a4763857efe2fe42ef7cf0ae702/software-agent-sdk/map-maintenance/2026-11-15/edited/transcripts/F30-openai-gateway-14-usage-per-request-f30-chat-usage-per-req.json).
  • SDK edited transcripts (S01, S02, S04, S05, S20).
  • Bug [Bug]: LLM calls that run out of retries on quick timeouts are reported as a hard LLM timeout and classified config/settings (regression from #6822) #6864 evidence: [enyst/openhands-evidence@b50ebd4](https://github.com/enyst/openhands-evidence/blob/b50ebd464f326b70f83fd8ae96e14476c567b650/software-agent-sdk/bugs/2026-11-15/quick-timeout-summary/README.md)

Video/Screenshots

Agent Canvas (OpenHands/OpenHands main 02c438a) launched on an agent-server built from this pass's checkout (2aae48b):

#6221, MCP OAuth (Canvas F17): the provider's consent page shows the redirect URI on the backend origin, /api/mcp/oauth/redirect.
[F17 OAuth redirect URI](https://raw.githubusercontent.com/enyst/openhands-evidence/bf2271de54196a4763857efe2fe42ef7cf0ae702/software-agent-sdk/map-maintenance/2026-11-15/ui/F17.install-unsupported_oauth-popup-authorize.png)

#6221, a completed OAuth install against a local OAuth MCP server (Canvas F17): the server is installed and reachable.
[F17 OAuth server installed](https://raw.githubusercontent.com/enyst/openhands-evidence/bf2271de54196a4763857efe2fe42ef7cf0ae702/software-agent-sdk/map-maintenance/2026-11-15/ui/F17.custom-add-remote_oauth-server-installed-tested.png)

#6823, snapshot-form stats (Canvas F07.display-cost): the usage panel keeps non-zero totals after a backend restart.
[F07 usage after restart](https://raw.githubusercontent.com/enyst/openhands-evidence/bf2271de54196a4763857efe2fe42ef7cf0ae702/software-agent-sdk/map-maintenance/2026-11-15/ui/F07.display-cost_usage-after-server-restart.png)

#6760, workspace cookie on loopback (Canvas F08): the file preview loads. The plain-HTTP non-loopback browser path could not be driven, because the stack binds 127.0.0.1; it was checked at header level in F02.
[F08 preview](https://raw.githubusercontent.com/enyst/openhands-evidence/bf2271de54196a4763857efe2fe42ef7cf0ae702/software-agent-sdk/map-maintenance/2026-11-15/ui/F08.files-rich-plain_html-preview-cookie.png)

Design Doc

Not applicable: map maintenance only, no product change.

Type

  • Bug fix
  • Feature
  • Refactor
  • Breaking change
  • Docs / chore

Notes

The map edits touch only the two skills' directories. Nothing is added under .pr/.


Generated by Claude Code


🐳 Agent Server images for this PR — GHCR package, pull/run commands, and all pushed tags (click to expand)

• 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-slim amd64, arm64 python-node-runtime Link
python-minimal amd64, arm64 python-node-runtime Link
python amd64, arm64 python-node-runtime 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:ede5eb7-python

Run

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

All tags pushed for this build

ghcr.io/openhands/agent-server:ede5eb7-golang-amd64
ghcr.io/openhands/agent-server:ede5eb7d1db8b14aece16ef9677e4203876b1670-golang-amd64
ghcr.io/openhands/agent-server:cloud-nifty-ride-nkv0sb-golang-amd64
ghcr.io/openhands/agent-server:ede5eb7-golang_tag_1.21-bookworm-amd64
ghcr.io/openhands/agent-server:ede5eb7-golang-arm64
ghcr.io/openhands/agent-server:ede5eb7d1db8b14aece16ef9677e4203876b1670-golang-arm64
ghcr.io/openhands/agent-server:cloud-nifty-ride-nkv0sb-golang-arm64
ghcr.io/openhands/agent-server:ede5eb7-golang_tag_1.21-bookworm-arm64
ghcr.io/openhands/agent-server:ede5eb7-java-amd64
ghcr.io/openhands/agent-server:ede5eb7d1db8b14aece16ef9677e4203876b1670-java-amd64
ghcr.io/openhands/agent-server:cloud-nifty-ride-nkv0sb-java-amd64
ghcr.io/openhands/agent-server:ede5eb7-eclipse-temurin_tag_17-jdk-amd64
ghcr.io/openhands/agent-server:ede5eb7-java-arm64
ghcr.io/openhands/agent-server:ede5eb7d1db8b14aece16ef9677e4203876b1670-java-arm64
ghcr.io/openhands/agent-server:cloud-nifty-ride-nkv0sb-java-arm64
ghcr.io/openhands/agent-server:ede5eb7-eclipse-temurin_tag_17-jdk-arm64
ghcr.io/openhands/agent-server:ede5eb7-python-amd64
ghcr.io/openhands/agent-server:ede5eb7d1db8b14aece16ef9677e4203876b1670-python-amd64
ghcr.io/openhands/agent-server:cloud-nifty-ride-nkv0sb-python-amd64
ghcr.io/openhands/agent-server:ede5eb7-python-node-runtime-amd64
ghcr.io/openhands/agent-server:ede5eb7-python-arm64
ghcr.io/openhands/agent-server:ede5eb7d1db8b14aece16ef9677e4203876b1670-python-arm64
ghcr.io/openhands/agent-server:cloud-nifty-ride-nkv0sb-python-arm64
ghcr.io/openhands/agent-server:ede5eb7-python-node-runtime-arm64
ghcr.io/openhands/agent-server:ede5eb7-python-minimal-amd64
ghcr.io/openhands/agent-server:ede5eb7d1db8b14aece16ef9677e4203876b1670-python-minimal-amd64
ghcr.io/openhands/agent-server:cloud-nifty-ride-nkv0sb-python-minimal-amd64
ghcr.io/openhands/agent-server:ede5eb7-python-node-runtime-minimal-amd64
ghcr.io/openhands/agent-server:ede5eb7-python-minimal-arm64
ghcr.io/openhands/agent-server:ede5eb7d1db8b14aece16ef9677e4203876b1670-python-minimal-arm64
ghcr.io/openhands/agent-server:cloud-nifty-ride-nkv0sb-python-minimal-arm64
ghcr.io/openhands/agent-server:ede5eb7-python-node-runtime-minimal-arm64
ghcr.io/openhands/agent-server:ede5eb7-python-slim-amd64
ghcr.io/openhands/agent-server:ede5eb7d1db8b14aece16ef9677e4203876b1670-python-slim-amd64
ghcr.io/openhands/agent-server:cloud-nifty-ride-nkv0sb-python-slim-amd64
ghcr.io/openhands/agent-server:ede5eb7-python-node-runtime-slim-amd64
ghcr.io/openhands/agent-server:ede5eb7-python-slim-arm64
ghcr.io/openhands/agent-server:ede5eb7d1db8b14aece16ef9677e4203876b1670-python-slim-arm64
ghcr.io/openhands/agent-server:cloud-nifty-ride-nkv0sb-python-slim-arm64
ghcr.io/openhands/agent-server:ede5eb7-python-node-runtime-slim-arm64
ghcr.io/openhands/agent-server:ede5eb7-golang
ghcr.io/openhands/agent-server:ede5eb7d1db8b14aece16ef9677e4203876b1670-golang
ghcr.io/openhands/agent-server:cloud-nifty-ride-nkv0sb-golang
ghcr.io/openhands/agent-server:ede5eb7-golang_tag_1.21-bookworm
ghcr.io/openhands/agent-server:ede5eb7-java
ghcr.io/openhands/agent-server:ede5eb7d1db8b14aece16ef9677e4203876b1670-java
ghcr.io/openhands/agent-server:cloud-nifty-ride-nkv0sb-java
ghcr.io/openhands/agent-server:ede5eb7-eclipse-temurin_tag_17-jdk
ghcr.io/openhands/agent-server:ede5eb7-python-minimal
ghcr.io/openhands/agent-server:ede5eb7d1db8b14aece16ef9677e4203876b1670-python-minimal
ghcr.io/openhands/agent-server:cloud-nifty-ride-nkv0sb-python-minimal
ghcr.io/openhands/agent-server:ede5eb7-python-node-runtime-minimal
ghcr.io/openhands/agent-server:ede5eb7-python-slim
ghcr.io/openhands/agent-server:ede5eb7d1db8b14aece16ef9677e4203876b1670-python-slim
ghcr.io/openhands/agent-server:cloud-nifty-ride-nkv0sb-python-slim
ghcr.io/openhands/agent-server:ede5eb7-python-node-runtime-slim
ghcr.io/openhands/agent-server:ede5eb7-python
ghcr.io/openhands/agent-server:ede5eb7d1db8b14aece16ef9677e4203876b1670-python
ghcr.io/openhands/agent-server:cloud-nifty-ride-nkv0sb-python
ghcr.io/openhands/agent-server:ede5eb7-python-node-runtime

About Multi-Architecture Support

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

enyst and others added 2 commits November 15, 2026 09:17
@github-actions

Copy link
Copy Markdown
Contributor

REST API breakage checks (OpenAPI) — ✅ PASSED

Result: ✅ PASSED

Action log

@enyst
enyst requested a review from all-hands-bot November 15, 2026 10:01

@all-hands-bot all-hands-bot left a comment

Copy link
Copy Markdown
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

This review was posted by an AI agent (OpenHands).

Reviewed as a fresh pass on head ede5eb7d against the repo guidance (AGENTS.md, .agents/skills/custom-codereview-guide.md).

Scope: The change is confined to the repository-owned verification skills (.agents/skills/verify-agent-server/, .agents/skills/verify-sdk/) — feature-map documentation, recipes, and verification programs for the daily map-maintenance pass. No product code, API surface, CI, or compatibility surface is touched, so this belongs in this repository; docs/chore is the right classification.

Verification performed on this head:

  • tests/cross/test_verify_sdk_skill.py tests/cross/test_verify_agent_server_skill.py: 93 passed, matching the PR's claim.
  • control-agent-server map check ok (35 files, 1007 ids — agrees with the README index count), map coverage ok (0 unowned routes), sdk-map check ok.
  • Spot-checked the map's behavioral claims against the product code at this baseline; all consistent: plain-HTTP SameSite=lax cookie minting in auth_router.py (#6760), the /api/mcp/oauth/redirect route and callback_base_url validation in mcp_router.py (#6221), the LLM request failed: ... structured retry-log line and the 2×timeout retry budget plus exhausted-timeout summary in retry_mixin.py (#6198, #6822), content-free completions raising LLMNoResponseError inside the retry boundary with the finish_reason="length" exemption in llm.py (#6178), owner_started_at zombie/pid-reuse lease takeover in conversation_lease.py (#6827), snapshot-context stats dropping per-call lists on the wire while base_state.json keeps them (#6823), and cipher/secrets inheritance on fork() in local_conversation.py (#5765).
  • Cross-checked linked GitHub state: every bug whose known-failure marker was dropped (#6741, #6826, #6828, #6842, #6844) is closed with its fix merged. The two open bugs the map now documents (#6864 quick-timeout classification, #6848 pause-during-startup) are correctly recorded as Known failures with reproductions, open fix PRs (#6866, #6849), and current readiness labels — documenting reality is the maintenance pass's job, not a defect here.

Findings: None. No material correctness, security, compatibility, or acceptance-criterion issue on the current head. The new recipes are exercised by the passing cross tests, and the baseline move to 2aae48b6 follows the map's documented maintenance convention.

✅ APPROVED

@enyst
enyst merged commit 2a462e2 into main Nov 16, 2026
53 checks passed
@enyst
enyst deleted the cloud/nifty-ride-nkv0sb branch November 16, 2026 20:42
@enyst enyst mentioned this pull request Nov 17, 2026
1 of 5 tasks
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants