Cairn
NousResearch/hermes-agent

Gateway restart port race and API server handoff

Cluster 91547 · gateway. Data as of

Nothing open on GitHub. Fix merged in #115347 on 18 Sep 2026. Check it covers your case.

The short answer

0open issues
0open PRs
4items grouped
Known?
Yes. 4 related items grouped here, 1 issue already closed.
Fix event
A fix was merged to main in PR #115347. Check it covers your case. No release data is tracked.
Tracker
The maintainers' tracker marks this resolved, deciding PR #115347. That is separate from the fix event.
Still open
Nothing open on GitHub.

These items concern a race condition where the gateway restart process conflicts with its own port, leaving the API server unavailable or the gateway running indefinitely. The work involves retrying on EADDRINUSE and ensuring the replacement process waits for the API server port to be ready before starting.

Open issues0

No open issues.

Open PRs0

No open pull requests.

Fixes on record

Merged to main. A stamp counts the issues a fix is linked to.

  • #115347 gateway restart no longer loses the api_server port; a parked platform reports degraded (#91547, salvage #92060 #113455)

    merged to main

    files: contributors/emails/[redacted:email], gateway/platforms/api_server.py, gateway/run_shutdown.py, gateway/run_startup.py, gateway/status.py, hermes_cli/gateway.py, hermes_cli/gateway_windows.py, hermes_cli/web_routers/status.py, tests/gateway/test_runner_startup_failures.py, tests/gateway/test_startup_failed_platform_reports_degraded.py, tests/gateway/test_status.py, tests/hermes_cli/test_gateway.py, tests/hermes_cli/test_gateway_service.py

2 PRs closed without merging

From the close comments: merged via another change 1 · superseded by another PR 1

  • #92060 fix(gateway): wait for api_server port before a replacement starts · superseded by another PR → #115347
  • #96419 fix(api-server): retry EADDRINUSE briefly across gateway restart handoff · merged via another change → #115347, #91547
Closed issues · 1
  • Closed#91547`hermes gateway restart` races its own port, then runs indefinitely with no API server
How this cluster was grouped
  • Link evidence (structural links throughout): every member is connected by structural evidence: shared changed files, or a closing/superseded reference.
  • Pairwise link density 0.50: the share of item pairs that carry a link, counting a structural link in full and a relevance-only link at 0.36. 1.00 means every pair is linked.

Pick up a Lab task

Check whether a fix covers the open issues here, with your own agent. Bring back evidence for maintainers.

Open the Lab

At a glance

Subsystem
gateway
Merged PRs
#115347
Closed issues
1
Attempts
2 PRs closed without merging
Fix link checked
18 Sep 2026

For your agent

The same facts, typed.

cluster/91547.json
cluster/91547.md