fix(FR-2586): clearer error when app launch fails due to access key mismatch by yomybaby · Pull Request #7409 · lablup/backend.ai-webui

yomybaby · 2026-05-14T03:06:11Z

Summary

When an app launch fails because the manager cannot find the session (HTTP 404 / "session not found"), the most common root cause is an access key mismatch — the session was created under a different access key than the one currently in use. Previously the WebUI surfaced the raw manager error, which read as a generic "session not found" and gave the user no idea what to do.

This change detects the 404 + "session ... not found" response coming back from startService in useBackendAIAppLauncher and replaces it with a user-friendly message that explains the likely cause and the two recovery paths:

Switch back to the original access key, or
Create a new session under the current access key.

Implementation

react/src/hooks/useBackendAIAppLauncher.tsx: added isSessionNotFoundError(err) helper that matches statusCode === 404 plus a substring match on the error's title field only (containing "session" and "not found"), and gated a friendlier AppLaunchError on it in the _resolveV2ProxyUri catch block.
resources/i18n/*.json: added session.appLauncher.SessionNotAccessible. All 22 locales populated with native translations.

The message is intentionally phrased as "likely" rather than asserting AK mismatch, because a 404 from startService could in rare cases also surface for a session that was genuinely removed between session-list render and app-launch click. Either way, the suggested recovery steps are valid.

Test Plan

Switch to a session created under a different access key, click an app — friendly error appears in the notification.
Launch an app on a normal session — no behavior change, app launches as before.
Trigger a non-404 launch failure (e.g. proxy down) — original error message still surfaces unchanged.

yomybaby · 2026-05-14T03:06:25Z

fix(FR-2586): clearer error when app launch fails due to access key mismatch #7409 👈 (View in Graphite)
main

How to use the Graphite Merge Queue

Add either label to this PR to merge it via the merge queue:

flow:merge-queue - adds this PR to the back of the merge queue
flow:hotfix - for urgent changes, fast-track this PR to the front of the merge queue

You must have a Graphite account in order to use the merge queue. Sign up using this link.

_{An organization admin has required the Graphite Merge Queue in this repository.} _{Please do not merge from GitHub as this will restart CI on PRs being processed by the merge queue.}

This stack of pull requests is managed by Graphite. Learn more about stacking.

github-actions · 2026-05-14T03:08:59Z

Coverage Report for react-coverage (./react)

Status	Category	Percentage	Covered / Total
🔵	Lines	6.45%	1783 / 27637
🔵	Statements	5.3%	1978 / 37274
🔵	Functions	5.18%	296 / 5714
🔵	Branches	3.71%	1293 / 34795

File Coverage

File	Stmts	Branches	Functions	Lines	Uncovered Lines
Changed Files
react/src/hooks/useBackendAIAppLauncher.tsx	0%	0%	0%	0%	13-1067

Generated in workflow #714 for commit 7956c51 by the Vitest Coverage Report Action

Copilot

Pull request overview

Improves the app-launch UX by translating a common manager-side “session not found” (404) failure into a more actionable, user-facing message that explains the likely access-key mismatch and recovery steps.

Changes:

Added a isSessionNotFoundError(err) classifier in useBackendAIAppLauncher and throws a friendlier AppLaunchError for that case.
Added a new i18n string key session.appLauncher.SessionNotAccessible across locale JSON files.

Reviewed changes

Copilot reviewed 22 out of 22 changed files in this pull request and generated 11 comments.

Show a summary per file

File	Description
react/src/hooks/useBackendAIAppLauncher.tsx	Detects 404 “session not found” errors during app launch and replaces them with a clearer, localized message.
resources/i18n/en.json	Adds English string for `session.appLauncher.SessionNotAccessible`.
resources/i18n/de.json	Adds German translation for `SessionNotAccessible`.
resources/i18n/el.json	Adds `SessionNotAccessible` (currently English text in Greek locale).
resources/i18n/es.json	Adds Spanish translation for `SessionNotAccessible`.
resources/i18n/fi.json	Adds `SessionNotAccessible` (currently English text in Finnish locale).
resources/i18n/fr.json	Adds French translation for `SessionNotAccessible`.
resources/i18n/id.json	Adds `SessionNotAccessible` (currently English text in Indonesian locale).
resources/i18n/it.json	Adds Italian translation for `SessionNotAccessible`.
resources/i18n/ja.json	Adds Japanese translation for `SessionNotAccessible`.
resources/i18n/ko.json	Adds Korean translation for `SessionNotAccessible`.
resources/i18n/mn.json	Adds `SessionNotAccessible` (currently English text in Mongolian locale).
resources/i18n/ms.json	Adds `SessionNotAccessible` (currently English text in Malay locale).
resources/i18n/pl.json	Adds `SessionNotAccessible` (currently English text in Polish locale).
resources/i18n/pt-BR.json	Adds Portuguese (Brazil) translation for `SessionNotAccessible`.
resources/i18n/pt.json	Adds Portuguese translation for `SessionNotAccessible`.
resources/i18n/ru.json	Adds Russian translation for `SessionNotAccessible`.
resources/i18n/th.json	Adds `SessionNotAccessible` (currently English text in Thai locale).
resources/i18n/tr.json	Adds `SessionNotAccessible` (currently English text in Turkish locale).
resources/i18n/vi.json	Adds `SessionNotAccessible` (currently English text in Vietnamese locale).
resources/i18n/zh-CN.json	Adds Simplified Chinese translation for `SessionNotAccessible`.
resources/i18n/zh-TW.json	Adds Traditional Chinese translation for `SessionNotAccessible`.

graphite-app · 2026-05-14T08:15:21Z

Merge activity

May 14, 8:15 AM UTC: yomybaby added this pull request to the Graphite merge queue.
May 14, 8:17 AM UTC: Merged by the Graphite merge queue.

…ismatch (#7409) Resolves #6732 (FR-2586) ![image.png](https://app.graphite.com/user-attachments/assets/22043874-b36a-4373-9628-92ce4226a699.png) ## Summary When an app launch fails because the manager cannot find the session (HTTP 404 / "session not found"), the most common root cause is an access key mismatch — the session was created under a different access key than the one currently in use. Previously the WebUI surfaced the raw manager error, which read as a generic "session not found" and gave the user no idea what to do. This change detects the 404 + "session ... not found" response coming back from `startService` in `useBackendAIAppLauncher` and replaces it with a user-friendly message that explains the likely cause and the two recovery paths: - Switch back to the original access key, or - Create a new session under the current access key. ## Implementation - `react/src/hooks/useBackendAIAppLauncher.tsx`: added `isSessionNotFoundError(err)` helper that matches `statusCode === 404` plus a substring match on the error's `title` field only (containing "session" and "not found"), and gated a friendlier `AppLaunchError` on it in the `_resolveV2ProxyUri` catch block. - `resources/i18n/*.json`: added `session.appLauncher.SessionNotAccessible`. All 22 locales populated with native translations. The message is intentionally phrased as "likely" rather than asserting AK mismatch, because a 404 from `startService` could in rare cases also surface for a session that was genuinely removed between session-list render and app-launch click. Either way, the suggested recovery steps are valid. ## Test Plan - [ ] Switch to a session created under a different access key, click an app — friendly error appears in the notification. - [ ] Launch an app on a normal session — no behavior change, app launches as before. - [ ] Trigger a non-404 launch failure (e.g. proxy down) — original error message still surfaces unchanged.

github-actions Bot assigned yomybaby May 14, 2026

github-actions Bot added area:ux UI / UX issue. area:i18n Localization size:M 30~100 LoC labels May 14, 2026

yomybaby marked this pull request as ready for review May 14, 2026 03:19

Copilot AI review requested due to automatic review settings May 14, 2026 03:19

Copilot started reviewing on behalf of yomybaby May 14, 2026 03:20 View session

Copilot AI reviewed May 14, 2026

View reviewed changes

yomybaby force-pushed the 05-14-fix_fr-2586_clearer_error_app_launch_access_key_mismatch branch 2 times, most recently from a65b8fc to c7f53b0 Compare May 14, 2026 08:10

graphite-app Bot force-pushed the 05-14-fix_fr-2586_clearer_error_app_launch_access_key_mismatch branch from c7f53b0 to 7956c51 Compare May 14, 2026 08:16

graphite-app Bot merged commit 7956c51 into main May 14, 2026
11 checks passed

graphite-app Bot deleted the 05-14-fix_fr-2586_clearer_error_app_launch_access_key_mismatch branch May 14, 2026 08:17

This was referenced May 15, 2026

Disable session row actions when access key differs from current user's keypair #7423

Open

fix(FR-2899): disable session row actions on access key mismatch #7424

Open

Provide feedback

Saved searches

Use saved searches to filter your results more quickly

fix(FR-2586): clearer error when app launch fails due to access key mismatch#7409

fix(FR-2586): clearer error when app launch fails due to access key mismatch#7409
graphite-app[bot] merged 1 commit into
mainfrom
05-14-fix_fr-2586_clearer_error_app_launch_access_key_mismatch

yomybaby commented May 14, 2026 •

edited

Loading

Uh oh!

yomybaby commented May 14, 2026

Uh oh!

github-actions Bot commented May 14, 2026 •

edited

Loading

Uh oh!

Copilot AI left a comment

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

graphite-app Bot commented May 14, 2026 •

edited

Loading

Uh oh!

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

2 participants

Conversation

yomybaby commented May 14, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Summary

Implementation

Test Plan

Uh oh!

yomybaby commented May 14, 2026

How to use the Graphite Merge Queue

Uh oh!

github-actions Bot commented May 14, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Coverage Report for react-coverage (./react)

Uh oh!

Copilot AI left a comment

Choose a reason for hiding this comment

Pull request overview

Reviewed changes

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

graphite-app Bot commented May 14, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Merge activity

Uh oh!

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

2 participants

yomybaby commented May 14, 2026 •

edited

Loading

github-actions Bot commented May 14, 2026 •

edited

Loading

graphite-app Bot commented May 14, 2026 •

edited

Loading