Thanks to visit codestin.com
Credit goes to github.com

Skip to content

fix(connectors): route all amd-gaia.ai URLs through /docs/ prefix#1061

Merged
itomek merged 1 commit into
mainfrom
1058-bug-google-connector-docs-url-broken
May 15, 2026
Merged

fix(connectors): route all amd-gaia.ai URLs through /docs/ prefix#1061
itomek merged 1 commit into
mainfrom
1058-bug-google-connector-docs-url-broken

Conversation

@itomek

@itomek itomek commented May 15, 2026

Copy link
Copy Markdown
Collaborator

Every "Learn More" / troubleshooting / SDK doc link in src/gaia/ was sending users to a bare https://amd-gaia.ai/<path> URL that 404s. The Mintlify Documentation tab serves all content under /docs/, so links like amd-gaia.ai/connectors/google or amd-gaia.ai/guides/agent-ui silently 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 pass
  • python util/lint.py --all — all 6 checks pass
  • Manual: gaia chat --ui → Settings → Connectors → "Learn More" on Google card opens https://amd-gaia.ai/docs/connectors/google (no 404)
  • Manual: same for GitHub connector card → https://amd-gaia.ai/docs/connectors/github

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.
@itomek itomek requested a review from kovtcharov-amd as a code owner May 15, 2026 17:10
@itomek itomek linked an issue May 15, 2026 that may be closed by this pull request
3 tasks
@github-actions github-actions Bot added tests Test changes agents labels May 15, 2026
@itomek itomek added this pull request to the merge queue May 15, 2026
Merged via the queue into main with commit ae94190 May 15, 2026
37 of 38 checks passed
@itomek itomek deleted the 1058-bug-google-connector-docs-url-broken branch May 15, 2026 17:35
@itomek itomek mentioned this pull request May 15, 2026
6 tasks
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
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

agents tests Test changes

Projects

None yet

Development

Successfully merging this pull request may close these issues.

[Bug]: Google Connector docs URL broken

2 participants