Skip to content

docs(verify): map maintenance 2026-11-17 - #6931

Merged
enyst merged 10 commits into
mainfrom
cloud/nifty-ride-p6p1oa
Nov 18, 2026
Merged

enyst merged 10 commits into
mainfrom
cloud/nifty-ride-p6p1oa

Conversation

@enyst

@enyst enyst commented Nov 17, 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@0275e71, after PR #6923.


AGENT:

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

Why

35 commits merged since the maps' baseline (2aae48b). They own paths in 35 of 37 agent-server families and 20 of 21 SDK families, and they add three routes no family owned, so this run is a full pass of both maps rather than a delta.

Summary

Agent-server map: full pass, 2aae48b..0275e71

SDK map: full pass, 2aae48b..0275e71

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
control-agent-server map run --file F40 --fresh --record --keep-going   # likewise F03 F06 F07 F09 F14 F15 F18 F19 F23 F25 F26 F34
sdk-map run --file S16   # likewise S04 S07 S09 S14 (DEEPSEEK_API_KEY set for the live bullets)

Evidence, pinned to enyst/openhands-evidence@8f33a10:

  • README: what each file shows.
  • [agent-server-report-main.md](https://github.com/enyst/openhands-evidence/blob/8f33a10f673cae03559f03fd95f40a3bd65cc658/software-agent-sdk/map-maintenance/2026-11-17/agent-server-report-main.md) and [sdk-report-main.md](https://github.com/enyst/openhands-evidence/blob/8f33a10f673cae03559f03fd95f40a3bd65cc658/software-agent-sdk/map-maintenance/2026-11-17/sdk-report-main.md): every family at 0275e71 before the edits.
  • [agent-server-report-edited.md](https://github.com/enyst/openhands-evidence/blob/8f33a10f673cae03559f03fd95f40a3bd65cc658/software-agent-sdk/map-maintenance/2026-11-17/agent-server-report-edited.md) and [sdk-report-edited.md](https://github.com/enyst/openhands-evidence/blob/8f33a10f673cae03559f03fd95f40a3bd65cc658/software-agent-sdk/map-maintenance/2026-11-17/sdk-report-edited.md): edited families re-run independently.
  • [edited/agent-server/](https://github.com/enyst/openhands-evidence/tree/8f33a10f673cae03559f03fd95f40a3bd65cc658/software-agent-sdk/map-maintenance/2026-11-17/edited/agent-server): transcripts of every changed bullet. For example, F40 is under 20261117-091608-5350-map-f40, and F19 (with the [Bug]: POST /api/conversations/{id}/mcp answers 500 when an added MCP server fails to start #6926 and [Bug]: Runtime-added MCP server tools lose their server prefix after a restart or resume #6927 xfails) is under 20261117-091608-5142-map-f19.
  • [main/agent-server-fails/](https://github.com/enyst/openhands-evidence/tree/8f33a10f673cae03559f03fd95f40a3bd65cc658/software-agent-sdk/map-maintenance/2026-11-17/main/agent-server-fails) and [main/sdk-fails/](https://github.com/enyst/openhands-evidence/tree/8f33a10f673cae03559f03fd95f40a3bd65cc658/software-agent-sdk/map-maintenance/2026-11-17/main/sdk-fails): every failing bullet of the main replay.

Video/Screenshots

Agent Canvas (OpenHands/OpenHands 5ed4ffa), launched on an agent server built from 0275e71:

Type

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

Notes

Evidence lives in enyst/openhands-evidence, not 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:128290f-python

Run

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

All tags pushed for this build

ghcr.io/openhands/agent-server:128290f-golang-amd64
ghcr.io/openhands/agent-server:128290f06efd82b9760bd305d8eb58dcb4164c55-golang-amd64
ghcr.io/openhands/agent-server:cloud-nifty-ride-p6p1oa-golang-amd64
ghcr.io/openhands/agent-server:128290f-golang_tag_1.21-bookworm-amd64
ghcr.io/openhands/agent-server:128290f-golang-arm64
ghcr.io/openhands/agent-server:128290f06efd82b9760bd305d8eb58dcb4164c55-golang-arm64
ghcr.io/openhands/agent-server:cloud-nifty-ride-p6p1oa-golang-arm64
ghcr.io/openhands/agent-server:128290f-golang_tag_1.21-bookworm-arm64
ghcr.io/openhands/agent-server:128290f-java-amd64
ghcr.io/openhands/agent-server:128290f06efd82b9760bd305d8eb58dcb4164c55-java-amd64
ghcr.io/openhands/agent-server:cloud-nifty-ride-p6p1oa-java-amd64
ghcr.io/openhands/agent-server:128290f-eclipse-temurin_tag_17-jdk-amd64
ghcr.io/openhands/agent-server:128290f-java-arm64
ghcr.io/openhands/agent-server:128290f06efd82b9760bd305d8eb58dcb4164c55-java-arm64
ghcr.io/openhands/agent-server:cloud-nifty-ride-p6p1oa-java-arm64
ghcr.io/openhands/agent-server:128290f-eclipse-temurin_tag_17-jdk-arm64
ghcr.io/openhands/agent-server:128290f-python-amd64
ghcr.io/openhands/agent-server:128290f06efd82b9760bd305d8eb58dcb4164c55-python-amd64
ghcr.io/openhands/agent-server:cloud-nifty-ride-p6p1oa-python-amd64
ghcr.io/openhands/agent-server:128290f-python-node-runtime-amd64
ghcr.io/openhands/agent-server:128290f-python-arm64
ghcr.io/openhands/agent-server:128290f06efd82b9760bd305d8eb58dcb4164c55-python-arm64
ghcr.io/openhands/agent-server:cloud-nifty-ride-p6p1oa-python-arm64
ghcr.io/openhands/agent-server:128290f-python-node-runtime-arm64
ghcr.io/openhands/agent-server:128290f-python-minimal-amd64
ghcr.io/openhands/agent-server:128290f06efd82b9760bd305d8eb58dcb4164c55-python-minimal-amd64
ghcr.io/openhands/agent-server:cloud-nifty-ride-p6p1oa-python-minimal-amd64
ghcr.io/openhands/agent-server:128290f-python-node-runtime-minimal-amd64
ghcr.io/openhands/agent-server:128290f-python-minimal-arm64
ghcr.io/openhands/agent-server:128290f06efd82b9760bd305d8eb58dcb4164c55-python-minimal-arm64
ghcr.io/openhands/agent-server:cloud-nifty-ride-p6p1oa-python-minimal-arm64
ghcr.io/openhands/agent-server:128290f-python-node-runtime-minimal-arm64
ghcr.io/openhands/agent-server:128290f-python-slim-amd64
ghcr.io/openhands/agent-server:128290f06efd82b9760bd305d8eb58dcb4164c55-python-slim-amd64
ghcr.io/openhands/agent-server:cloud-nifty-ride-p6p1oa-python-slim-amd64
ghcr.io/openhands/agent-server:128290f-python-node-runtime-slim-amd64
ghcr.io/openhands/agent-server:128290f-python-slim-arm64
ghcr.io/openhands/agent-server:128290f06efd82b9760bd305d8eb58dcb4164c55-python-slim-arm64
ghcr.io/openhands/agent-server:cloud-nifty-ride-p6p1oa-python-slim-arm64
ghcr.io/openhands/agent-server:128290f-python-node-runtime-slim-arm64
ghcr.io/openhands/agent-server:128290f-golang
ghcr.io/openhands/agent-server:128290f06efd82b9760bd305d8eb58dcb4164c55-golang
ghcr.io/openhands/agent-server:cloud-nifty-ride-p6p1oa-golang
ghcr.io/openhands/agent-server:128290f-golang_tag_1.21-bookworm
ghcr.io/openhands/agent-server:128290f-java
ghcr.io/openhands/agent-server:128290f06efd82b9760bd305d8eb58dcb4164c55-java
ghcr.io/openhands/agent-server:cloud-nifty-ride-p6p1oa-java
ghcr.io/openhands/agent-server:128290f-eclipse-temurin_tag_17-jdk
ghcr.io/openhands/agent-server:128290f-python-minimal
ghcr.io/openhands/agent-server:128290f06efd82b9760bd305d8eb58dcb4164c55-python-minimal
ghcr.io/openhands/agent-server:cloud-nifty-ride-p6p1oa-python-minimal
ghcr.io/openhands/agent-server:128290f-python-node-runtime-minimal
ghcr.io/openhands/agent-server:128290f-python-slim
ghcr.io/openhands/agent-server:128290f06efd82b9760bd305d8eb58dcb4164c55-python-slim
ghcr.io/openhands/agent-server:cloud-nifty-ride-p6p1oa-python-slim
ghcr.io/openhands/agent-server:128290f-python-node-runtime-slim
ghcr.io/openhands/agent-server:128290f-python
ghcr.io/openhands/agent-server:128290f06efd82b9760bd305d8eb58dcb4164c55-python
ghcr.io/openhands/agent-server:cloud-nifty-ride-p6p1oa-python
ghcr.io/openhands/agent-server:128290f-python-node-runtime

About Multi-Architecture Support

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

enyst and others added 9 commits November 17, 2026 08:54
…TS clients, public-skills switch, message edits and mentions

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_013ArwwKRe5R7V5KLRSjxeU5
…and decision cards

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_013ArwwKRe5R7V5KLRSjxeU5
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_013ArwwKRe5R7V5KLRSjxeU5
…ram output

A grep observation repeats the absolute workspace path, so a long
SDK_VERIFY_HOME pushed the matched file past the 400-character clip
and S14's search bullet failed on the run directory's length.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_013ArwwKRe5R7V5KLRSjxeU5
…nothing was added

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_013ArwwKRe5R7V5KLRSjxeU5
@github-actions

github-actions Bot commented Nov 17, 2026 •

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 17, 2026 11:13

@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 the current head 5d6c8c9888231b0de2d4df7101eae59dd657ec93 (docs/chore: daily feature-map maintenance for main@0275e714, per #5751). The change belongs in this repository — it updates only the in-repo verify skills (verify-agent-server, verify-sdk), their feature maps/READMEs, and new verify programs; no production code is touched.

Verification performed on this head:

  • control-agent-server map check → ok (38 files, 1046 IDs, no problems); map coverage → ok (219 routes, 209 owned, 209 driven, 0 unowned, 0 owned-but-not-driven, no stale exclusions); sdk-map check → ok (21 files, 496 IDs, 34 untested) — all match the PR description's claims exactly.
  • Cross tests re-run locally: tests/cross/test_verify_sdk_skill.py, test_control_sdk.py, test_verify_agent_server_skill.py → 98 passed.
  • Unit tests cited by the new/changed bullets re-run and passing: ask_user/message_edit/conversation_mentions/mention/MCP (86 passed), terminal test_observation_wait.py (21 passed), goal tests (20 passed). All 432 test-file citations across both maps resolve to existing files; spot-checked cited test functions all exist.
  • New map content grounded against the code at this head: POST /api/conversations/{id}/mcp (mcp_router), the ask_user/answer route and its 400/409/404/422/429 behavior, POST .../events/batch (event_read_router), pending_ask 400 guards on /goal and /goal/resume (event_service.py), skill-body trimming on socket/webhook frames (event_service.py), OH_PUBLIC_SKILLS_ENABLED/OH_PUBLIC_CATALOG_ENABLED and the marketplace disabled flag (skills_router.py, plugins_router.py), GoalAsked/find_pending_ask, AskUserTool/EditMessageTool/mention tools with OH_INTERNAL_SERVER_URL, add_mcp_servers/mcp_startup_budget, max_observation_wait_seconds (incl. isfinite validation), and the TypeScript client methods cited by F34 (batchGetEvents, loadPlugin, answerAskUser, getCommits/getCommitChanges, downloadArchive/downloadArchiveBuffer, InitClient with X-Init-API-Key, ConversationManager.git/AgentServerClient.git) — all exist and behave as the map documents. The false-value list for the env switches matches the pydantic TypeAdapter(bool) parsing (false/off/0/no off; unrecognized keeps it on).
  • README family counts match actual bullet counts for every edited family (e.g. F19 34→41 with the 7 new IDs; new F40 with 10 bullets; SDK S04/S07/S09/S14/S16 counts match); both baselines move to main@0275e714 as proposed.
  • CI on this exact head is green (29 success, 1 skipped), including the OpenAPI breakage check and cross-tests.
  • Issue references check out: #6926 closed (fix #6928), #6927 open (fix #6929), #6907 open; the map marks them as known bugs with xfails/failures accordingly, consistent with the SDK-side linked pairs.

One non-blocking observation, not introduced by this PR: a handful of IDs appear twice within their family files (e.g. F07.reject-non-user, F14.home, F34.version-gate-old) where a Gotcha bullet reuses a sub-feature ID; these duplicates pre-exist at the base and map check passes on them (the README counts unique sub-features), so no action is required in this PR.

No material issues found; the map updates are accurate against the code, the check/coverage gates pass, and the CI is green.

✅ APPROVED

@enyst
enyst merged commit 7dd877e into main Nov 18, 2026
56 checks passed
@enyst
enyst deleted the cloud/nifty-ride-p6p1oa branch November 18, 2026 08:23
@enyst enyst mentioned this pull request Nov 19, 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

2 participants