Skip to content

fix(web): explain list-agents GitHub errors on workspace page - #636

Open
ryw wants to merge 3 commits into
mainfrom
tembo/actionable-list-agents-error
Open

ryw wants to merge 3 commits into
mainfrom
tembo/actionable-list-agents-error

Conversation

@ryw

@ryw ryw commented Oct 30, 2026

Copy link
Copy Markdown
Member

What changed

The workspace agents page showed the raw code Couldn't list agents: not-found when the connected repo couldn't be read. That message doesn't say what's wrong or how to fix it.

That not-found comes from resolving the branch HEAD (GET /repos/{owner}/{repo}/commits/{branch} in web/src/lib/github.ts). A missing agents/ folder doesn't cause it, because that case lists as empty. So it always means the stored repo, branch or GitHub token no longer matches GitHub. Usually the token lost access (for example, a fine-grained PAT whose repo access or org approval was removed), or the repo or branch was renamed.

The error banner now:

  • names the repo and branch it tried (owner/name@branch)
  • explains each ListAgentsResult error code in plain language
  • links to Settings → Repository for not-found and invalid-token, so an admin can reconnect with a working token

Validation

  • pnpm exec tsc --noEmit passes
  • eslint on the changed page passes

Changelog

  • Added a user-facing entry to CHANGELOG.md and ran pnpm --dir web gen:docs.

Want tembo to make any changes? Add a comment with @tembo and i'll get back to work!

View on Tembo  Review in Tembo  View Agent Settings

ryw and others added 3 commits October 30, 2026 11:42
Co-authored-by: tembo[bot] <208362400+tembo-io[bot]@users.noreply.github.com>
Co-authored-by: tembo[bot] <208362400+tembo-io[bot]@users.noreply.github.com>
Co-authored-by: tembo[bot] <208362400+tembo-io[bot]@users.noreply.github.com>
Copilot AI balanced review requested due to automatic review settings October 30, 2026 15:43
@tembo tembo Bot added the tembo Pull request created by Tembo label Oct 30, 2026

Copilot AI left a comment

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Copilot was unable to review this pull request because the user who requested the review has insufficient remaining quota.

This branch has not been deployed

No deployments
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

tembo Pull request created by Tembo

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants