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
|
|
@ -1023,11 +1023,12 @@ class _AddMcpClientDialogState extends State<_AddMcpClientDialog> {
|
|||
/// Pick a suggestion → fill the form. Operators still hit
|
||||
/// "Add + discover" so nothing happens unprompted.
|
||||
void _applySuggestion(_McpSuggestion s) {
|
||||
final l = AppLocalizations.of(context)!;
|
||||
setState(() {
|
||||
_name.text = s.name;
|
||||
_endpoint.text = s.endpoint;
|
||||
_apiKey.text = s.apiKeyEnv;
|
||||
_desc.text = s.description;
|
||||
_desc.text = s.resolveDescription(l);
|
||||
});
|
||||
}
|
||||
|
||||
|
|
@ -1770,36 +1771,73 @@ class _McpSuggestion {
|
|||
final IconData icon;
|
||||
final String endpoint;
|
||||
final String apiKeyEnv;
|
||||
final String description;
|
||||
/// Localizable description. Use [resolveDescription] to fetch
|
||||
/// the actual text in the active locale — the const list
|
||||
/// can't hold a closure that takes [AppLocalizations], and
|
||||
/// hardcoding English here is what got us into the
|
||||
/// untranslated-helper-text bug.
|
||||
String resolveDescription(AppLocalizations l) =>
|
||||
_suggestionDescription(l, name);
|
||||
const _McpSuggestion({
|
||||
required this.name,
|
||||
required this.icon,
|
||||
required this.endpoint,
|
||||
required this.apiKeyEnv,
|
||||
required this.description,
|
||||
});
|
||||
}
|
||||
|
||||
/// Localizable lookup of an MCP-suggestion description. Keyed
|
||||
/// on the same suggestion `name` field as the list below. New
|
||||
/// suggestions need a matching .arb entry; the default-case
|
||||
/// returns an empty string so an unconfigured suggestion fails
|
||||
/// silently instead of leaking a key into the UI.
|
||||
String _suggestionDescription(AppLocalizations l, String name) {
|
||||
switch (name) {
|
||||
case 'deepwiki':
|
||||
return l.mcpSuggestionDeepwikiDesc;
|
||||
case 'semgrep':
|
||||
return l.mcpSuggestionSemgrepDesc;
|
||||
case 'filesystem':
|
||||
return l.mcpSuggestionFilesystemDesc;
|
||||
case 'fetch':
|
||||
return l.mcpSuggestionFetchDesc;
|
||||
case 'github':
|
||||
return l.mcpSuggestionGithubDesc;
|
||||
case 'puppeteer':
|
||||
return l.mcpSuggestionPuppeteerDesc;
|
||||
case 'postgres':
|
||||
return l.mcpSuggestionPostgresDesc;
|
||||
case 'sqlite':
|
||||
return l.mcpSuggestionSqliteDesc;
|
||||
case 'brave-search':
|
||||
return l.mcpSuggestionBraveSearchDesc;
|
||||
case 'memory':
|
||||
return l.mcpSuggestionMemoryDesc;
|
||||
case 'time':
|
||||
return l.mcpSuggestionTimeDesc;
|
||||
default:
|
||||
return '';
|
||||
}
|
||||
}
|
||||
|
||||
const _kMcpSuggestions = <_McpSuggestion>[
|
||||
// ── HTTPS / streamable-HTTP servers (no Node, no API key) ──
|
||||
// Same set Studio promotes as one-click cards in the Today
|
||||
// hero — listed here so the operator finds them even after
|
||||
// the hero gets dismissed.
|
||||
// Descriptions are resolved via [_McpSuggestion.resolveDescription]
|
||||
// against the active locale — see `mcpSuggestion*Desc` keys in
|
||||
// app_en.arb / app_de.arb. Adding a suggestion here means
|
||||
// adding a matching key in both .arb files plus a case to
|
||||
// `_suggestionDescription` above.
|
||||
_McpSuggestion(
|
||||
name: 'deepwiki',
|
||||
icon: Icons.menu_book_outlined,
|
||||
endpoint: 'https://mcp.deepwiki.com/mcp',
|
||||
apiKeyEnv: '',
|
||||
description:
|
||||
'Public HTTPS — GitHub repo documentation search (AI-powered). No Node, no API key.',
|
||||
),
|
||||
_McpSuggestion(
|
||||
name: 'semgrep',
|
||||
icon: Icons.security,
|
||||
endpoint: 'https://mcp.semgrep.ai/mcp',
|
||||
apiKeyEnv: '',
|
||||
description:
|
||||
'Public HTTPS — security scanning for code vulnerabilities. No Node, no API key.',
|
||||
),
|
||||
// ── stdio servers (require Node + npx) ───────────────────
|
||||
_McpSuggestion(
|
||||
|
|
@ -1807,30 +1845,24 @@ const _kMcpSuggestions = <_McpSuggestion>[
|
|||
icon: Icons.folder_outlined,
|
||||
endpoint: 'stdio://npx -y @modelcontextprotocol/server-filesystem /tmp',
|
||||
apiKeyEnv: '',
|
||||
description:
|
||||
'Anthropic — read/write files in /tmp. Edit the path before saving.',
|
||||
),
|
||||
_McpSuggestion(
|
||||
name: 'fetch',
|
||||
icon: Icons.cloud_download_outlined,
|
||||
endpoint: 'stdio://npx -y @modelcontextprotocol/server-fetch',
|
||||
apiKeyEnv: '',
|
||||
description: 'Anthropic — fetch arbitrary HTTP(S) URLs as markdown.',
|
||||
),
|
||||
_McpSuggestion(
|
||||
name: 'github',
|
||||
icon: Icons.code,
|
||||
endpoint: 'stdio://npx -y @modelcontextprotocol/server-github',
|
||||
apiKeyEnv: 'GITHUB_PERSONAL_ACCESS_TOKEN',
|
||||
description:
|
||||
'Anthropic — issues, PRs, repo files. Needs a GitHub PAT in the env var.',
|
||||
),
|
||||
_McpSuggestion(
|
||||
name: 'puppeteer',
|
||||
icon: Icons.web,
|
||||
endpoint: 'stdio://npx -y @modelcontextprotocol/server-puppeteer',
|
||||
apiKeyEnv: '',
|
||||
description: 'Anthropic — headless browser automation for screenshots / scraping.',
|
||||
),
|
||||
_McpSuggestion(
|
||||
name: 'postgres',
|
||||
|
|
@ -1838,8 +1870,6 @@ const _kMcpSuggestions = <_McpSuggestion>[
|
|||
endpoint:
|
||||
'stdio://npx -y @modelcontextprotocol/server-postgres postgresql://user:pw@host/db',
|
||||
apiKeyEnv: '',
|
||||
description:
|
||||
'Anthropic — read-only SQL queries against a Postgres database. Edit the URL.',
|
||||
),
|
||||
_McpSuggestion(
|
||||
name: 'sqlite',
|
||||
|
|
@ -1847,27 +1877,23 @@ const _kMcpSuggestions = <_McpSuggestion>[
|
|||
endpoint:
|
||||
'stdio://npx -y @modelcontextprotocol/server-sqlite --db-path /tmp/db.sqlite',
|
||||
apiKeyEnv: '',
|
||||
description: 'Anthropic — query a local SQLite file. Edit the path.',
|
||||
),
|
||||
_McpSuggestion(
|
||||
name: 'brave-search',
|
||||
icon: Icons.search,
|
||||
endpoint: 'stdio://npx -y @modelcontextprotocol/server-brave-search',
|
||||
apiKeyEnv: 'BRAVE_API_KEY',
|
||||
description: 'Anthropic — web search via Brave. API key required.',
|
||||
),
|
||||
_McpSuggestion(
|
||||
name: 'memory',
|
||||
icon: Icons.psychology_outlined,
|
||||
endpoint: 'stdio://npx -y @modelcontextprotocol/server-memory',
|
||||
apiKeyEnv: '',
|
||||
description: 'Anthropic — persistent knowledge graph for an agent\'s memory.',
|
||||
),
|
||||
_McpSuggestion(
|
||||
name: 'time',
|
||||
icon: Icons.schedule,
|
||||
endpoint: 'stdio://npx -y @modelcontextprotocol/server-time',
|
||||
apiKeyEnv: '',
|
||||
description: 'Anthropic — current time + timezone conversion.',
|
||||
),
|
||||
];
|
||||
|
|
|
|||
Loading…
Add table
Add a link
Reference in a new issue