fix(connectors): route all amd-gaia.ai URLs through /docs/ prefix#1061
Merged
Conversation
Mintlify serves connector pages, guides, and SDK reference under /docs/. The Agent UI splash, custom-agent error guidance, BuilderAgent template doc-comments, installer error messages, and WebUI metadata all hardcoded bare paths (e.g. /connectors/google, /guides/agent-ui, /reference/ troubleshooting) that 404 in production. Verified live: every bare-path URL returns 404, every /docs/-prefixed equivalent returns 200. Reported as the Google connector "Learn More" link in #1058. Expanded after a live HTTP probe surfaced 12 other broken URLs in src/gaia/ with the same root cause. Adds two regression tests so this bug class stays dead: - tests/unit/connectors/test_catalog_docs_url.py walks the connector registry and asserts each docs_url resolves to a real docs/connectors/<slug>.mdx file (catches missing /docs/ prefix, slug typos, and deleted pages in one assertion). - tests/unit/test_amd_gaia_urls.py scans every .py/.tsx/.ts/.js/.json/.md file under src/gaia/ for https://amd-gaia.ai/<path> literals and asserts each either uses /docs/ or is on a small site-root allowlist (install scripts, bare root). Closes #1058.
3 tasks
kovtcharov-amd
approved these changes
May 15, 2026
antmikinka
pushed a commit
to antmikinka/gaia
that referenced
this pull request
May 15, 2026
# GAIA v0.18.1 Release Notes GAIA v0.18.1 is a patch release covering two regressions reported after v0.18.0. The first is a sweep of broken `amd-gaia.ai/...` documentation links across connector cards, the Agent UI splash, the agent registry, the installer, and BuilderAgent templates — every link was missing the `/docs/` prefix the Mintlify site serves all content under, so 12 in-product "Learn More" / troubleshooting URLs were silently 404'ing. The second is a CSS class typo in the Agent UI `ChatView` top navbar that broke the right-side flex container, stacking the action icons vertically instead of laying them out horizontally. **Why upgrade:** - **Documentation links resolve again** — every `amd-gaia.ai/...` URL surfaced by GAIA (connector catalog, Agent UI server splash, agent registry error guidance, BuilderAgent templates, installer messages, WebUI metadata) now routes through the `/docs/` prefix Mintlify expects. Two regression tests prevent the prefix from silently dropping again. - **Agent UI navbar action icons render horizontally** — the right-side container of the `ChatView` top navbar referenced a CSS class that didn't exist (`chat-header-right` vs the defined `task-header-right`), so the action icons stacked vertically at all viewport widths. The one-line rename restores `display: flex`. ## Key Changes Both changes in v0.18.1 are bug fixes targeting regressions reported after v0.18.0 shipped. - **Broken `amd-gaia.ai` documentation links across multiple surfaces** (PR [amd#1061](amd#1061), closes [amd#1058](amd#1058)) — Every "Learn More", troubleshooting, and SDK doc link in `src/gaia/` was pointing at a bare `https://amd-gaia.ai/<path>` URL that 404'd, because the Mintlify Documentation tab serves all content under `/docs/`. The fix inserts the missing `/docs/` prefix across all 12 affected locations — the connector catalog, the Agent UI server splash, agent registry error guidance, BuilderAgent template doc-comments, installer messages, and WebUI metadata — and adds `tests/unit/test_amd_gaia_urls.py` plus `tests/unit/connectors/test_catalog_docs_url.py` so the prefix can't silently drop again. - **Agent UI top-navbar action icons stacked vertically** (PR [amd#1060](amd#1060), fixes [amd#1059](amd#1059)) — The right-side container of `ChatView`'s top navbar (`<div className="chat-header-right">`) referenced a CSS class that didn't exist; the correctly defined rule providing `display: flex` is `.task-header-right`. Renaming the one JSX `className` restores the horizontal layout at all viewport widths without touching any other file. ## Full Changelog **2 commits** since v0.18.0: - `ae94190a` — fix(connectors): route all amd-gaia.ai URLs through /docs/ prefix (amd#1061) - `896dc203` — fix(webui): restore flex layout on top navbar right container (amd#1060) Full Changelog: [v0.18.0...v0.18.1](amd/gaia@v0.18.0...v0.18.1) ## Release checklist - [x] `util/validate_release_notes.py docs/releases/v0.18.1.mdx` passes - [x] `src/gaia/version.py` → `0.18.1` - [x] `src/gaia/apps/webui/package.json` → `0.18.1` - [x] Navbar label in `docs/docs.json` → `v0.18.1 · Lemonade 10.2.0` - [x] All 2 commits in range (v0.18.0..HEAD) are represented in the notes - [ ] Review from @kovtcharov-amd addressed
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Every "Learn More" / troubleshooting / SDK doc link in
src/gaia/was sending users to a barehttps://amd-gaia.ai/<path>URL that 404s. The Mintlify Documentation tab serves all content under/docs/, so links likeamd-gaia.ai/connectors/googleoramd-gaia.ai/guides/agent-uisilently broke for anyone who followed them. This PR inserts the missing/docs/prefix across all 12 affected locations (connector catalog, Agent UI server splash, agent registry error guidance, BuilderAgent template doc-comments, installer messages, and WebUI metadata), and adds two regression tests to prevent recurrence.Closes #1058
Test plan
PYTHONPATH=src python -m pytest tests/unit/test_amd_gaia_urls.py tests/unit/connectors/test_catalog_docs_url.py tests/unit/agents/test_builder_agent.py -xvs— all passpython util/lint.py --all— all 6 checks passgaia chat --ui→ Settings → Connectors → "Learn More" on Google card openshttps://amd-gaia.ai/docs/connectors/google(no 404)https://amd-gaia.ai/docs/connectors/github