Skip to content

fix: restore missing /api/ping status route#3

Open
DiamondEyesFox wants to merge 1 commit intooutsourc-e:mainfrom
DiamondEyesFox:codex/pr-api-ping
Open

fix: restore missing /api/ping status route#3
DiamondEyesFox wants to merge 1 commit intooutsourc-e:mainfrom
DiamondEyesFox:codex/pr-api-ping

Conversation

@DiamondEyesFox
Copy link
Copy Markdown

Summary

  • add a Workspace /api/ping compatibility route using the existing Hermes gateway probe
  • preserve the response shape current chat and settings callers already expect
  • restore status checks without requiring a client rewrite

Testing

  • npm run build

Mamidi7 added a commit to Mamidi7/hermes-workspace that referenced this pull request Mar 25, 2026
- Add /api/ping route - lightweight gateway health probe compatible with
  legacy ping callers (restores functionality from PR outsourc-e#3 by DiamondEyesFox)
- Add /api/diagnostics route - comprehensive endpoint-by-endpoint health check
  with actionable hints so users can self-diagnose connection issues
- Rewrite normalizeHermesErrorMessage() in send-stream.ts to return specific,
  actionable error messages for each failure mode:
  - ECONNREFUSED / network unreachable -> "Cannot reach Hermes gateway..."
  - 401 Unauthorized -> "Hermes authentication failed..."
  - 403 Forbidden -> "Access forbidden..."
  - 404 Not Found -> "Hermes endpoint not found... outdated version?"
  - 503 Sessions API unavailable -> upgrade instructions
  - Generic stream errors -> include the raw message
- Add README troubleshooting section covering:
  - "Failed to send message - Hermes Stream Error" with /api/diagnostics link
  - "Terminal doesn't accept keyboard input"
  - "I set a custom API URL but chat still fails" (explains the two-URL architecture)
  - "Agent thinks but never shows a reply"
  - curl commands for manual endpoint testing
- Add Troubleshooting & Debugging section to CONTRIBUTING.md with:
  - Debugging path for stream errors
  - Key files reference table
  - Browser DevTools instructions
  - Terminal debugging notes

Fixes Issue outsourc-e#2: "Hermes Stream Error" + terminal input not working
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.

1 participant