feat(studio): trust pass — friendly errors + store clarity + MCP i18n
Second half of the May-2026 trust pass. Drops the wall of gRPC trailers from every error surface and makes the Store honest about what is and isn't installable. Friendly errors: - New `friendlyError(Object, AppLocalizations)` mapper turns GrpcError + arbitrary throwables into a localised headline, optional recovery hint, and a verbatim detail string kept behind a "Show details" expander. Duck-typed on `.code` / `.message` so Studio doesn't have to depend on package:grpc directly. - `FaiErrorBox` gains an `error:` constructor that runs the mapper. Every call site that used to render `snap.error.toString()` (flows, welcome, store) switches to it. - 9 .arb entries per locale cover the gRPC codes we actually emit (INVALID_ARGUMENT, NOT_FOUND, ALREADY_EXISTS, PERMISSION_DENIED, FAILED_PRECONDITION, INTERNAL, UNAVAILABLE, UNAUTHENTICATED) plus copy/details affordances. - `test/friendly_error_test.dart` — 6 unit tests for the mapper. Covers the mapping table, locale-switching, and the non-gRPC fallback so future regressions show up in CI. Capability discovery: - New `HubService.allCapabilities()` reads the kind-aware capability list (wasm + builtin + federated) and returns a Dart-side `CapabilityInfo` value type. The flow page's missing-dependency check uses it so `system.approval` and federated MCP/n8n tools count as "available" — fixes the Run button staying disabled forever. - `HubService.listModules()` filters to kind=wasm so the Modules page doesn't sprout synthetic "system" entries that the operator can't uninstall. Store clarity: - New "Installable only" filter, on by default. Roughly 2/3 of seed entries currently carry `status: planned`; the default view stops being noise. - Featured-strip cards for planned modules now show a "Coming soon" pill instead of an empty action area. - Main-grid cards for non-installable modules dim to 60% opacity so the eye lands on actionable cards first. - Detail-sheet "Nicht installierbar" tooltip → inline hint box. The reason is visible without hovering. MCP localisation: - `_kMcpSuggestions` no longer holds 11 hardcoded English description strings. The `description` field is replaced with a `resolveDescription(AppLocalizations)` lookup that switches on the suggestion `name` to read the matching `mcpSuggestion*Desc` .arb key. EN + DE shipped. - New `FaiEnBadge` widget renders a small `[EN]` pill when the active locale isn't English. Used next to MCP / federated store entries' tagline + description because the server supplies them in English and we can't translate on the fly yet — the badge is the honest signal until the planned `studio.translate` plugin lands. Plus housekeeping: removed the unused `_keepImport` lint escape in the test and the dangling library doc-comment in `format.dart`. Signed-off-by: flemming-it <sf@flemming.it> Signed-off-by: flemming-it <stefan.a.flemming@googlemail.com>
This commit is contained in:
flemming-it
parent
34f2b7b313
commit
c11461b0f9
15 changed files with 1219 additions and 104 deletions
|
|
@ -518,6 +518,108 @@ abstract class AppLocalizations {
|
|||
/// **'Copied'**
|
||||
String get buttonCopied;
|
||||
|
||||
/// No description provided for @buttonShowDetails.
|
||||
///
|
||||
/// In en, this message translates to:
|
||||
/// **'Show details'**
|
||||
String get buttonShowDetails;
|
||||
|
||||
/// No description provided for @buttonHideDetails.
|
||||
///
|
||||
/// In en, this message translates to:
|
||||
/// **'Hide details'**
|
||||
String get buttonHideDetails;
|
||||
|
||||
/// No description provided for @storeInstallableOnly.
|
||||
///
|
||||
/// In en, this message translates to:
|
||||
/// **'Installable only'**
|
||||
String get storeInstallableOnly;
|
||||
|
||||
/// No description provided for @storePillComingSoon.
|
||||
///
|
||||
/// In en, this message translates to:
|
||||
/// **'Coming soon'**
|
||||
String get storePillComingSoon;
|
||||
|
||||
/// No description provided for @storeNotInstallableInline.
|
||||
///
|
||||
/// In en, this message translates to:
|
||||
/// **'This module is on the roadmap (status: {status}). It has no installable bundle yet — follow the repository for updates.'**
|
||||
String storeNotInstallableInline(String status);
|
||||
|
||||
/// No description provided for @mcpSuggestionDeepwikiDesc.
|
||||
///
|
||||
/// In en, this message translates to:
|
||||
/// **'Public HTTPS — GitHub repo documentation search (AI-powered). No Node, no API key.'**
|
||||
String get mcpSuggestionDeepwikiDesc;
|
||||
|
||||
/// No description provided for @mcpSuggestionSemgrepDesc.
|
||||
///
|
||||
/// In en, this message translates to:
|
||||
/// **'Public HTTPS — security scanning for code vulnerabilities. No Node, no API key.'**
|
||||
String get mcpSuggestionSemgrepDesc;
|
||||
|
||||
/// No description provided for @mcpSuggestionFilesystemDesc.
|
||||
///
|
||||
/// In en, this message translates to:
|
||||
/// **'Anthropic — read / write files in /tmp. Edit the path before saving.'**
|
||||
String get mcpSuggestionFilesystemDesc;
|
||||
|
||||
/// No description provided for @mcpSuggestionFetchDesc.
|
||||
///
|
||||
/// In en, this message translates to:
|
||||
/// **'Anthropic — fetch arbitrary HTTP(S) URLs as markdown.'**
|
||||
String get mcpSuggestionFetchDesc;
|
||||
|
||||
/// No description provided for @mcpSuggestionGithubDesc.
|
||||
///
|
||||
/// In en, this message translates to:
|
||||
/// **'Anthropic — issues, PRs, repo files. Needs a GitHub PAT in the env var.'**
|
||||
String get mcpSuggestionGithubDesc;
|
||||
|
||||
/// No description provided for @mcpSuggestionPuppeteerDesc.
|
||||
///
|
||||
/// In en, this message translates to:
|
||||
/// **'Anthropic — headless browser automation for screenshots / scraping.'**
|
||||
String get mcpSuggestionPuppeteerDesc;
|
||||
|
||||
/// No description provided for @mcpSuggestionPostgresDesc.
|
||||
///
|
||||
/// In en, this message translates to:
|
||||
/// **'Anthropic — read-only SQL queries against a Postgres database. Edit the URL.'**
|
||||
String get mcpSuggestionPostgresDesc;
|
||||
|
||||
/// No description provided for @mcpSuggestionSqliteDesc.
|
||||
///
|
||||
/// In en, this message translates to:
|
||||
/// **'Anthropic — query a local SQLite file. Edit the path.'**
|
||||
String get mcpSuggestionSqliteDesc;
|
||||
|
||||
/// No description provided for @mcpSuggestionBraveSearchDesc.
|
||||
///
|
||||
/// In en, this message translates to:
|
||||
/// **'Anthropic — web search via Brave. API key required.'**
|
||||
String get mcpSuggestionBraveSearchDesc;
|
||||
|
||||
/// No description provided for @mcpSuggestionMemoryDesc.
|
||||
///
|
||||
/// In en, this message translates to:
|
||||
/// **'Anthropic — persistent knowledge graph for an agent\'s memory.'**
|
||||
String get mcpSuggestionMemoryDesc;
|
||||
|
||||
/// No description provided for @mcpSuggestionTimeDesc.
|
||||
///
|
||||
/// In en, this message translates to:
|
||||
/// **'Anthropic — current time + timezone conversion.'**
|
||||
String get mcpSuggestionTimeDesc;
|
||||
|
||||
/// No description provided for @mcpServerEnLanguageBadge.
|
||||
///
|
||||
/// In en, this message translates to:
|
||||
/// **'Server text in English — Studio shows it as supplied.'**
|
||||
String get mcpServerEnLanguageBadge;
|
||||
|
||||
/// No description provided for @settingsTitle.
|
||||
///
|
||||
/// In en, this message translates to:
|
||||
|
|
@ -2306,6 +2408,114 @@ abstract class AppLocalizations {
|
|||
/// **'Flow completed with no declared outputs.'**
|
||||
String get flowsNoOutputs;
|
||||
|
||||
/// No description provided for @errGeneric.
|
||||
///
|
||||
/// In en, this message translates to:
|
||||
/// **'Something went wrong.'**
|
||||
String get errGeneric;
|
||||
|
||||
/// No description provided for @errInvalidArgument.
|
||||
///
|
||||
/// In en, this message translates to:
|
||||
/// **'Invalid input.'**
|
||||
String get errInvalidArgument;
|
||||
|
||||
/// No description provided for @errInvalidArgumentHint.
|
||||
///
|
||||
/// In en, this message translates to:
|
||||
/// **'Check the form values and try again.'**
|
||||
String get errInvalidArgumentHint;
|
||||
|
||||
/// No description provided for @errNotFound.
|
||||
///
|
||||
/// In en, this message translates to:
|
||||
/// **'Not found.'**
|
||||
String get errNotFound;
|
||||
|
||||
/// No description provided for @errNotFoundHint.
|
||||
///
|
||||
/// In en, this message translates to:
|
||||
/// **'The item you asked for isn\'t here — it may have been removed or never existed.'**
|
||||
String get errNotFoundHint;
|
||||
|
||||
/// No description provided for @errAlreadyExists.
|
||||
///
|
||||
/// In en, this message translates to:
|
||||
/// **'Already exists.'**
|
||||
String get errAlreadyExists;
|
||||
|
||||
/// No description provided for @errPermissionDenied.
|
||||
///
|
||||
/// In en, this message translates to:
|
||||
/// **'Permission denied.'**
|
||||
String get errPermissionDenied;
|
||||
|
||||
/// No description provided for @errPermissionDeniedHint.
|
||||
///
|
||||
/// In en, this message translates to:
|
||||
/// **'The hub\'s operator policy blocks this action. Check `~/.fai/config.yaml`.'**
|
||||
String get errPermissionDeniedHint;
|
||||
|
||||
/// No description provided for @errFailedPrecondition.
|
||||
///
|
||||
/// In en, this message translates to:
|
||||
/// **'Setup issue blocked this.'**
|
||||
String get errFailedPrecondition;
|
||||
|
||||
/// No description provided for @errFailedPreconditionHint.
|
||||
///
|
||||
/// In en, this message translates to:
|
||||
/// **'The hub couldn\'t proceed because something it needs isn\'t ready. The detail below explains what.'**
|
||||
String get errFailedPreconditionHint;
|
||||
|
||||
/// No description provided for @errInternal.
|
||||
///
|
||||
/// In en, this message translates to:
|
||||
/// **'Unexpected internal error.'**
|
||||
String get errInternal;
|
||||
|
||||
/// No description provided for @errInternalHint.
|
||||
///
|
||||
/// In en, this message translates to:
|
||||
/// **'Check the hub logs at `~/.fai/logs/`. If this repeats, please report it.'**
|
||||
String get errInternalHint;
|
||||
|
||||
/// No description provided for @errUnavailable.
|
||||
///
|
||||
/// In en, this message translates to:
|
||||
/// **'Hub not reachable.'**
|
||||
String get errUnavailable;
|
||||
|
||||
/// No description provided for @errUnavailableHint.
|
||||
///
|
||||
/// In en, this message translates to:
|
||||
/// **'Make sure `fai serve` (or `fai daemon start`) is running and the daemon endpoint matches Studio\'s settings.'**
|
||||
String get errUnavailableHint;
|
||||
|
||||
/// No description provided for @errUnauthenticated.
|
||||
///
|
||||
/// In en, this message translates to:
|
||||
/// **'Authentication required.'**
|
||||
String get errUnauthenticated;
|
||||
|
||||
/// No description provided for @errUnauthenticatedHint.
|
||||
///
|
||||
/// In en, this message translates to:
|
||||
/// **'Set `FAI_REGISTRY_TOKEN` or sign in through Settings before retrying.'**
|
||||
String get errUnauthenticatedHint;
|
||||
|
||||
/// No description provided for @errCopyDetail.
|
||||
///
|
||||
/// In en, this message translates to:
|
||||
/// **'Copy detail'**
|
||||
String get errCopyDetail;
|
||||
|
||||
/// No description provided for @errDetailCopied.
|
||||
///
|
||||
/// In en, this message translates to:
|
||||
/// **'Detail copied to clipboard.'**
|
||||
String get errDetailCopied;
|
||||
|
||||
/// No description provided for @flowsOutputUnknown.
|
||||
///
|
||||
/// In en, this message translates to:
|
||||
|
|
|
|||
Loading…
Add table
Add a link
Reference in a new issue