feat: add errorCode field to global settings and related components for improved error handling (#504)

Author: unknownzjc

packages/types/src/global-settings.ts

@@ -156,6 +156,8 @@ export const globalSettingsSchema = z.object({
 	hasOpenedModeSelector: z.boolean().optional(),
 	lastModeExportPath: z.string().optional(),
 	lastModeImportPath: z.string().optional(),
+
+	errorCode: z.record(z.string(), z.record(z.string(), z.string())).optional(),
 })
 
 export type GlobalSettings = z.infer<typeof globalSettingsSchema>
@@ -328,6 +330,8 @@ export const EVALS_SETTINGS: RooCodeSettings = {
 	mode: "code", // "architect",
 
 	customModes: [],
+
+	errorCode: {},
 }
 
 export const EVALS_TIMEOUT = 5 * 60 * 1_000

pnpm-lock.yaml

@@ -1,6 +1,7 @@
 import axios from "axios"
 import { jwtDecode } from "jwt-decode"
 import crypto from "crypto"
+import retry from "async-retry"
 
 import { t } from "../../../i18n"
 import { ClineProvider } from "../../webview/ClineProvider"
@@ -47,12 +48,22 @@ export class ErrorCodeManager {
 	 */
 	public async refreshErrorCodes(): Promise<void> {
 		try {
-			// Clear existing error code mapping
-			this.errorMap = {}
-			// Get remote error codes
-			const remoteErrorMap = await this.fetchRemoteCodes()
-			this.errorMap = remoteErrorMap
+			await retry(
+				async () => {
+					// Clear existing error code mapping
+					this.errorMap = {}
+					// Get remote error codes
+					const remoteErrorMap = await this.fetchRemoteCodes()
+					this.errorMap = remoteErrorMap
+					this.provider.setValue("errorCode", remoteErrorMap)
+				},
+				{
+					retries: 2,
+				},
+			)
 		} catch (error) {
+			const { errorCode } = await this.provider.getState()
+			this.errorMap = (errorCode ?? {}) as IErrorMap
 			console.error("Failed to refresh error codes:", error)
 		}
 	}
@@ -65,7 +76,7 @@ export class ErrorCodeManager {
 		try {
 			const { language, apiConfiguration } = await this.provider.getState()
 			const baseUrl = apiConfiguration.zgsmBaseUrl || ZgsmAuthConfig.getInstance().getDefaultApiBaseUrl()
-			const response = await axios.get(`${baseUrl}/shenma/api/v1/error-code/error_codes_${language}.json`)
+			const response = await axios.get(`${baseUrl}/costrict/error-code/error_codes_${language}.json`)
 			return response.data
 		} catch (error) {
 			console.error("Failed to fetch remote error codes:", error)
@@ -124,7 +135,7 @@ export class ErrorCodeManager {
 		let status = error.status as number
 		const { code, headers } = error
 		const requestId = headers?.get("x-request-id") ?? null
-		const { apiConfiguration } = await this.provider.getState()
+		const { apiConfiguration, errorCode } = await this.provider.getState()
 		const { zgsmApiKeyExpiredAt, zgsmApiKeyUpdatedAt, isOldModeLoginState } = this.parseZgsmTokenInfo(
 			apiConfiguration.zgsmAccessToken,
 		)
@@ -159,7 +170,8 @@ export class ErrorCodeManager {
 			"quota-manager.voucher_expired",
 		]
 		if (code) {
-			let { message, solution } = this.errorMap[code] || this.unknownError
+			const errorMap = Object.keys(this.errorMap).length > 0 ? this.errorMap : (errorCode ?? {}) // Use fetched error codes or fallback to provider state
+			let { message, solution } = errorMap[code] || this.unknownError
 			if (authRequiredCodes.includes(code)) {
 				rawError = message
 				message = defaultError["401"].message

src/core/costrict/error-code/ErrorCodeManager.ts

@@ -2248,6 +2248,7 @@ export class ClineProvider
 				// 	return false
 				// }
 			})(),
+			errorCode: stateValues.errorCode ?? {},
 		}
 	}
 

src/core/webview/ClineProvider.ts

@@ -576,6 +576,7 @@ describe("ClineProvider", () => {
 			remoteControlEnabled: false,
 			taskSyncEnabled: false,
 			featureRoomoteControlEnabled: false,
+			errorCode: {},
 		}
 
 		const message: ExtensionMessage = {

src/core/webview/__tests__/ClineProvider.spec.ts

@@ -726,6 +726,7 @@
 		"@roo-code/types": "workspace:^",
 		"@vscode/codicons": "^0.0.36",
 		"async-mutex": "^0.5.0",
+		"async-retry": "^1.3.3",
 		"axios": "^1.12.0",
 		"cheerio": "^1.0.0",
 		"chokidar": "^4.0.3",
@@ -796,6 +797,7 @@
 		"@roo-code/build": "workspace:^",
 		"@roo-code/config-eslint": "workspace:^",
 		"@roo-code/config-typescript": "workspace:^",
+		"@types/async-retry": "^1.4.9",
 		"@types/clone-deep": "^4.0.4",
 		"@types/debug": "^4.1.12",
 		"@types/diff": "^5.2.1",

src/package.json

@@ -316,6 +316,7 @@ export type ExtensionState = Pick<
 	| "openRouterImageGenerationSelectedModel"
 	| "includeTaskHistoryInEnhance"
 	| "reasoningBlockCollapsed"
+	| "errorCode"
 > & {
 	version: string
 	clineMessages: ClineMessage[]