João Salavisa
51 lines
2.2 KiB
TypeScript
51 lines
2.2 KiB
TypeScript
/**
|
|
* Distinguishes genuine workspace/environment-setup failures from downstream
|
|
* agent / API errors so the FAILED status banner shows an accurate label.
|
|
*
|
|
* "Environment setup failed" is a frontend-only label — the backend never
|
|
* emits it. Historically the banner showed it for *any* failure with an error
|
|
* message, which mislabeled agent/API errors (auth, rate limit, the
|
|
* thinking-blocks 400, etc.) as setup failures. We now only claim setup
|
|
* failure when the message matches a known setup signature; everything else
|
|
* keeps the accurate generic FAILED label and surfaces the raw message in the
|
|
* expandable details.
|
|
*
|
|
* Labels travel as catalog keys, not resolved copy: this module is imported at
|
|
* module scope, so a `t()` here would freeze at the boot locale.
|
|
*/
|
|
|
|
export const ENVIRONMENT_SETUP_FAILED_KEY = "task:environmentSetupFailed";
|
|
|
|
// Signatures emitted while preparing the workspace / launching the executor,
|
|
// before the agent process is meaningfully running. Sourced from the Go
|
|
// backend: `environment preparation failed:` (manager_launch.go), the launch
|
|
// race ("already has an agent running" / "race resolved during register"),
|
|
// container launch failures, and branch/fresh-branch prep errors.
|
|
// i18n-exempt: substrings matched against backend error text, not copy.
|
|
const SETUP_FAILURE_SIGNATURES = [
|
|
"environment preparation failed",
|
|
"failed to launch container",
|
|
"already has an agent running",
|
|
"race resolved during register",
|
|
"failed to prepare",
|
|
];
|
|
|
|
export function isEnvironmentSetupError(message: string | undefined | null): boolean {
|
|
if (!message) return false;
|
|
const lower = message.toLowerCase();
|
|
return SETUP_FAILURE_SIGNATURES.some((sig) => lower.includes(sig));
|
|
}
|
|
|
|
/**
|
|
* Resolves the catalog key for the label shown in the FAILED status banner.
|
|
* Returns the "Environment setup failed" key only for genuine setup failures;
|
|
* otherwise the caller's fallback key (the generic "Agent has encountered an
|
|
* error").
|
|
*/
|
|
export function resolveAgentErrorLabelKey(
|
|
errorMessage: string | undefined | null,
|
|
fallbackKey: string,
|
|
): string {
|
|
return isEnvironmentSetupError(errorMessage) ? ENVIRONMENT_SETUP_FAILED_KEY : fallbackKey;
|
|
}
|