feat(studio): friendlyError catches hub-specific patterns
Some checks failed
Security / Security check (push) Failing after 1s
Some checks failed
Security / Security check (push) Failing after 1s
Generic gRPC-code mapping was right but not specific enough.
A flow failing with an approval-timeout used to land on
'Deadline exceeded — try again later'; now it reads 'Freigabe-
Timeout abgelaufen — entweder timeout_seconds erhöhen oder
den Reviewer informieren.'
New pattern matchers in _matchHubPattern, runs before the
gRPC-code switch. Six FlowExecutionError shapes covered:
- approval rejected ("rejected by")
- approval timeout
- output too large ("exceeding the X MB cap")
- host service not declared
- missing value reference
- MCP endpoint unreachable
- capability not installed (NotFound fallback)
Every match comes with a localised hint pointing at the
concrete fix path (audit log / timeout config / Integrations
panel / Text-tab Fix button).
Five new tests pin the matchers — would catch a silent
regression when the hub renames a variant Display string.
All 11 friendly_error tests + 19 Studio tests green.
Signed-off-by: flemming-it <stefan.a.flemming@googlemail.com>
This commit is contained in:
flemming-it
parent
28fafce7dc
commit
971196518c
8 changed files with 370 additions and 4 deletions
|
|
@ -30,6 +30,20 @@
|
|||
"welcomeDocApprovalsTitle": "Freigaben",
|
||||
"welcomeDocApprovalsBlurb": "Human-in-the-Loop-Checkpoints — wann nutzen, wie das Audit-Log sie protokolliert.",
|
||||
"helpTooltip": "Hilfe",
|
||||
"errApprovalRejected": "Freigabe vom Reviewer abgelehnt.",
|
||||
"errApprovalRejectedHint": "Der Reviewer hat den Step abgelehnt. Begründung steht im Audit-Log.",
|
||||
"errApprovalTimedOut": "Freigabe-Timeout abgelaufen.",
|
||||
"errApprovalTimedOutHint": "Es wurde nicht rechtzeitig entschieden. Entweder `timeout_seconds` am Freigabe-Step erhöhen oder den Reviewer informieren.",
|
||||
"errOutputTooLarge": "Step-Output hat die Größenbegrenzung überschritten.",
|
||||
"errOutputTooLargeHint": "Entweder Output kürzen (Text truncaten, Bytes komprimieren) oder `max_output_size_mb` in der Operator-Config erhöhen.",
|
||||
"errServiceUnavailableForStep": "Host-Service nicht konfiguriert.",
|
||||
"errServiceUnavailableForStepHint": "Das Modul braucht einen Service (z.B. ollama, playwright), den der Operator nicht deklariert hat. Trage ihn unter `services:` in ~/.fai/config.yaml ein.",
|
||||
"errMissingValue": "Pflichtwert fehlt.",
|
||||
"errMissingValueHint": "Der Step erwartet eine Eingabe, die nicht verdrahtet ist — entweder zur Laufzeit liefern oder den vorgelagerten `$ref` korrigieren.",
|
||||
"errMcpUnreachable": "MCP-Endpunkt nicht erreichbar.",
|
||||
"errMcpUnreachableHint": "Der MCP-Server hat nicht geantwortet. Endpunkt in Einstellungen → Integrationen prüfen und sicherstellen, dass er läuft.",
|
||||
"errCapabilityNotInstalled": "Benötigte Capability nicht installiert.",
|
||||
"errCapabilityNotInstalledHint": "Im Text-Tab des Flows klickst du auf den Fix-Button — der installiert die Capability, sofern sie im Store ist.",
|
||||
"welcomeDocClose": "Schließen",
|
||||
"welcomeDocFailedToLoad": "Doku konnte nicht geladen werden: {error}",
|
||||
"@welcomeDocFailedToLoad": {
|
||||
|
|
|
|||
|
|
@ -33,6 +33,20 @@
|
|||
"welcomeDocApprovalsTitle": "Approvals",
|
||||
"welcomeDocApprovalsBlurb": "Human-in-the-loop checkpoints — when to use them, how the audit log records them.",
|
||||
"helpTooltip": "Help",
|
||||
"errApprovalRejected": "Approval rejected by reviewer.",
|
||||
"errApprovalRejectedHint": "The reviewer marked this step as rejected. Check the audit log for the reviewer's reason.",
|
||||
"errApprovalTimedOut": "Approval timed out.",
|
||||
"errApprovalTimedOutHint": "No reviewer decided within the configured time. Raise `timeout_seconds` on the approval step or alert the reviewer.",
|
||||
"errOutputTooLarge": "Step output exceeded the size limit.",
|
||||
"errOutputTooLargeHint": "Either trim the output (truncate text, downsample bytes) or raise `max_output_size_mb` in the operator config.",
|
||||
"errServiceUnavailableForStep": "Host service not configured.",
|
||||
"errServiceUnavailableForStepHint": "The module requires a service (e.g. ollama, playwright) the operator hasn't declared. Add it under `services:` in ~/.fai/config.yaml.",
|
||||
"errMissingValue": "Required value is missing.",
|
||||
"errMissingValueHint": "The step expected an input that wasn't wired up — either supply it at run time or fix the upstream `$ref`.",
|
||||
"errMcpUnreachable": "MCP endpoint unreachable.",
|
||||
"errMcpUnreachableHint": "The MCP server didn't respond. Check the endpoint in Settings → Integrations and confirm it's running.",
|
||||
"errCapabilityNotInstalled": "Required capability is not installed.",
|
||||
"errCapabilityNotInstalledHint": "Open the flow's Text tab — the analyzer's Fix button installs the capability if it's in the store.",
|
||||
"welcomeDocClose": "Close",
|
||||
"welcomeDocFailedToLoad": "Could not load documentation: {error}",
|
||||
"@welcomeDocFailedToLoad": {
|
||||
|
|
|
|||
|
|
@ -278,6 +278,90 @@ abstract class AppLocalizations {
|
|||
/// **'Help'**
|
||||
String get helpTooltip;
|
||||
|
||||
/// No description provided for @errApprovalRejected.
|
||||
///
|
||||
/// In en, this message translates to:
|
||||
/// **'Approval rejected by reviewer.'**
|
||||
String get errApprovalRejected;
|
||||
|
||||
/// No description provided for @errApprovalRejectedHint.
|
||||
///
|
||||
/// In en, this message translates to:
|
||||
/// **'The reviewer marked this step as rejected. Check the audit log for the reviewer\'s reason.'**
|
||||
String get errApprovalRejectedHint;
|
||||
|
||||
/// No description provided for @errApprovalTimedOut.
|
||||
///
|
||||
/// In en, this message translates to:
|
||||
/// **'Approval timed out.'**
|
||||
String get errApprovalTimedOut;
|
||||
|
||||
/// No description provided for @errApprovalTimedOutHint.
|
||||
///
|
||||
/// In en, this message translates to:
|
||||
/// **'No reviewer decided within the configured time. Raise `timeout_seconds` on the approval step or alert the reviewer.'**
|
||||
String get errApprovalTimedOutHint;
|
||||
|
||||
/// No description provided for @errOutputTooLarge.
|
||||
///
|
||||
/// In en, this message translates to:
|
||||
/// **'Step output exceeded the size limit.'**
|
||||
String get errOutputTooLarge;
|
||||
|
||||
/// No description provided for @errOutputTooLargeHint.
|
||||
///
|
||||
/// In en, this message translates to:
|
||||
/// **'Either trim the output (truncate text, downsample bytes) or raise `max_output_size_mb` in the operator config.'**
|
||||
String get errOutputTooLargeHint;
|
||||
|
||||
/// No description provided for @errServiceUnavailableForStep.
|
||||
///
|
||||
/// In en, this message translates to:
|
||||
/// **'Host service not configured.'**
|
||||
String get errServiceUnavailableForStep;
|
||||
|
||||
/// No description provided for @errServiceUnavailableForStepHint.
|
||||
///
|
||||
/// In en, this message translates to:
|
||||
/// **'The module requires a service (e.g. ollama, playwright) the operator hasn\'t declared. Add it under `services:` in ~/.fai/config.yaml.'**
|
||||
String get errServiceUnavailableForStepHint;
|
||||
|
||||
/// No description provided for @errMissingValue.
|
||||
///
|
||||
/// In en, this message translates to:
|
||||
/// **'Required value is missing.'**
|
||||
String get errMissingValue;
|
||||
|
||||
/// No description provided for @errMissingValueHint.
|
||||
///
|
||||
/// In en, this message translates to:
|
||||
/// **'The step expected an input that wasn\'t wired up — either supply it at run time or fix the upstream `\$ref`.'**
|
||||
String get errMissingValueHint;
|
||||
|
||||
/// No description provided for @errMcpUnreachable.
|
||||
///
|
||||
/// In en, this message translates to:
|
||||
/// **'MCP endpoint unreachable.'**
|
||||
String get errMcpUnreachable;
|
||||
|
||||
/// No description provided for @errMcpUnreachableHint.
|
||||
///
|
||||
/// In en, this message translates to:
|
||||
/// **'The MCP server didn\'t respond. Check the endpoint in Settings → Integrations and confirm it\'s running.'**
|
||||
String get errMcpUnreachableHint;
|
||||
|
||||
/// No description provided for @errCapabilityNotInstalled.
|
||||
///
|
||||
/// In en, this message translates to:
|
||||
/// **'Required capability is not installed.'**
|
||||
String get errCapabilityNotInstalled;
|
||||
|
||||
/// No description provided for @errCapabilityNotInstalledHint.
|
||||
///
|
||||
/// In en, this message translates to:
|
||||
/// **'Open the flow\'s Text tab — the analyzer\'s Fix button installs the capability if it\'s in the store.'**
|
||||
String get errCapabilityNotInstalledHint;
|
||||
|
||||
/// No description provided for @welcomeDocClose.
|
||||
///
|
||||
/// In en, this message translates to:
|
||||
|
|
|
|||
|
|
@ -111,6 +111,57 @@ class AppLocalizationsDe extends AppLocalizations {
|
|||
@override
|
||||
String get helpTooltip => 'Hilfe';
|
||||
|
||||
@override
|
||||
String get errApprovalRejected => 'Freigabe vom Reviewer abgelehnt.';
|
||||
|
||||
@override
|
||||
String get errApprovalRejectedHint =>
|
||||
'Der Reviewer hat den Step abgelehnt. Begründung steht im Audit-Log.';
|
||||
|
||||
@override
|
||||
String get errApprovalTimedOut => 'Freigabe-Timeout abgelaufen.';
|
||||
|
||||
@override
|
||||
String get errApprovalTimedOutHint =>
|
||||
'Es wurde nicht rechtzeitig entschieden. Entweder `timeout_seconds` am Freigabe-Step erhöhen oder den Reviewer informieren.';
|
||||
|
||||
@override
|
||||
String get errOutputTooLarge =>
|
||||
'Step-Output hat die Größenbegrenzung überschritten.';
|
||||
|
||||
@override
|
||||
String get errOutputTooLargeHint =>
|
||||
'Entweder Output kürzen (Text truncaten, Bytes komprimieren) oder `max_output_size_mb` in der Operator-Config erhöhen.';
|
||||
|
||||
@override
|
||||
String get errServiceUnavailableForStep => 'Host-Service nicht konfiguriert.';
|
||||
|
||||
@override
|
||||
String get errServiceUnavailableForStepHint =>
|
||||
'Das Modul braucht einen Service (z.B. ollama, playwright), den der Operator nicht deklariert hat. Trage ihn unter `services:` in ~/.fai/config.yaml ein.';
|
||||
|
||||
@override
|
||||
String get errMissingValue => 'Pflichtwert fehlt.';
|
||||
|
||||
@override
|
||||
String get errMissingValueHint =>
|
||||
'Der Step erwartet eine Eingabe, die nicht verdrahtet ist — entweder zur Laufzeit liefern oder den vorgelagerten `\$ref` korrigieren.';
|
||||
|
||||
@override
|
||||
String get errMcpUnreachable => 'MCP-Endpunkt nicht erreichbar.';
|
||||
|
||||
@override
|
||||
String get errMcpUnreachableHint =>
|
||||
'Der MCP-Server hat nicht geantwortet. Endpunkt in Einstellungen → Integrationen prüfen und sicherstellen, dass er läuft.';
|
||||
|
||||
@override
|
||||
String get errCapabilityNotInstalled =>
|
||||
'Benötigte Capability nicht installiert.';
|
||||
|
||||
@override
|
||||
String get errCapabilityNotInstalledHint =>
|
||||
'Im Text-Tab des Flows klickst du auf den Fix-Button — der installiert die Capability, sofern sie im Store ist.';
|
||||
|
||||
@override
|
||||
String get welcomeDocClose => 'Schließen';
|
||||
|
||||
|
|
|
|||
|
|
@ -111,6 +111,56 @@ class AppLocalizationsEn extends AppLocalizations {
|
|||
@override
|
||||
String get helpTooltip => 'Help';
|
||||
|
||||
@override
|
||||
String get errApprovalRejected => 'Approval rejected by reviewer.';
|
||||
|
||||
@override
|
||||
String get errApprovalRejectedHint =>
|
||||
'The reviewer marked this step as rejected. Check the audit log for the reviewer\'s reason.';
|
||||
|
||||
@override
|
||||
String get errApprovalTimedOut => 'Approval timed out.';
|
||||
|
||||
@override
|
||||
String get errApprovalTimedOutHint =>
|
||||
'No reviewer decided within the configured time. Raise `timeout_seconds` on the approval step or alert the reviewer.';
|
||||
|
||||
@override
|
||||
String get errOutputTooLarge => 'Step output exceeded the size limit.';
|
||||
|
||||
@override
|
||||
String get errOutputTooLargeHint =>
|
||||
'Either trim the output (truncate text, downsample bytes) or raise `max_output_size_mb` in the operator config.';
|
||||
|
||||
@override
|
||||
String get errServiceUnavailableForStep => 'Host service not configured.';
|
||||
|
||||
@override
|
||||
String get errServiceUnavailableForStepHint =>
|
||||
'The module requires a service (e.g. ollama, playwright) the operator hasn\'t declared. Add it under `services:` in ~/.fai/config.yaml.';
|
||||
|
||||
@override
|
||||
String get errMissingValue => 'Required value is missing.';
|
||||
|
||||
@override
|
||||
String get errMissingValueHint =>
|
||||
'The step expected an input that wasn\'t wired up — either supply it at run time or fix the upstream `\$ref`.';
|
||||
|
||||
@override
|
||||
String get errMcpUnreachable => 'MCP endpoint unreachable.';
|
||||
|
||||
@override
|
||||
String get errMcpUnreachableHint =>
|
||||
'The MCP server didn\'t respond. Check the endpoint in Settings → Integrations and confirm it\'s running.';
|
||||
|
||||
@override
|
||||
String get errCapabilityNotInstalled =>
|
||||
'Required capability is not installed.';
|
||||
|
||||
@override
|
||||
String get errCapabilityNotInstalledHint =>
|
||||
'Open the flow\'s Text tab — the analyzer\'s Fix button installs the capability if it\'s in the store.';
|
||||
|
||||
@override
|
||||
String get welcomeDocClose => 'Close';
|
||||
|
||||
|
|
|
|||
Loading…
Add table
Add a link
Reference in a new issue