feat: add verbose error display with error codes and debug information

Author: hannesrudolph

src/api/providers/__tests__/bedrock-error-handling.spec.ts

@@ -42,7 +42,13 @@ describe("AwsBedrockHandler Error Handling", () => {
 		name?: string
 		status?: number
 		__type?: string
-		$metadata?: { httpStatusCode?: number }
+		$metadata?: {
+			httpStatusCode?: number
+			requestId?: string
+			extendedRequestId?: string
+			cfId?: string
+			[key: string]: any // Allow additional properties
+		}
 	}): Error => {
 		const error = new Error(options.message || "Test error") as any
 		if (options.name) error.name = options.name
@@ -128,7 +134,7 @@ describe("AwsBedrockHandler Error Handling", () => {
 				const result = await handler.completePrompt("test")
 				expect(result).toContain("throttled or rate limited")
 			} catch (error) {
-				expect(error.message).toContain("throttled or rate limited")
+				expect(error.message).toMatch(/throttled or rate limited/)
 			}
 		})
 
@@ -156,6 +162,37 @@ describe("AwsBedrockHandler Error Handling", () => {
 				}
 			}
 		})
+
+		it("should display verbose error information including codes and metadata", async () => {
+			const verboseError = createMockError({
+				message: "Bedrock is unable to process your request",
+				name: "ThrottlingException",
+				status: 429,
+				$metadata: {
+					httpStatusCode: 429,
+					requestId: "12345-abcde-67890",
+					extendedRequestId: "extended-12345",
+					cfId: "cf-12345",
+				},
+			})
+
+			mockSend.mockRejectedValueOnce(verboseError)
+
+			try {
+				await handler.completePrompt("test")
+				throw new Error("Expected error to be thrown")
+			} catch (error) {
+				// Should contain error codes
+				expect(error.message).toMatch(/\[.*HTTP 429.*AWS ThrottlingException.*\]/)
+				// Should contain the main error message
+				expect(error.message).toContain("throttled or rate limited")
+				// Should contain debug information
+				expect(error.message).toContain("Debug Info:")
+				expect(error.message).toContain("Request ID: 12345-abcde-67890")
+				expect(error.message).toContain("Extended Request ID: extended-12345")
+				expect(error.message).toContain("CloudFront ID: cf-12345")
+			}
+		})
 	})
 
 	describe("Service Quota Exceeded Detection", () => {

src/api/providers/bedrock.ts

@@ -1231,6 +1231,48 @@ Please check:
 			templateVars.modelId = modelConfig.id
 			templateVars.contextWindow = String(modelConfig.info.contextWindow || "unknown")
 
+			// Extract error codes and identifiers for verbose display
+			const errorCodes: string[] = []
+			const errorMeta: string[] = []
+
+			// HTTP Status Code
+			if ((error as any).status) {
+				errorCodes.push(`HTTP ${(error as any).status}`)
+			}
+			if ((error as any).$metadata?.httpStatusCode) {
+				errorCodes.push(`HTTP ${(error as any).$metadata.httpStatusCode}`)
+			}
+
+			// AWS Error Codes
+			if (error.name && error.name !== "Error") {
+				errorCodes.push(`AWS ${error.name}`)
+			}
+			if ((error as any).__type) {
+				errorCodes.push(`Type ${(error as any).__type}`)
+			}
+
+			// Request ID for debugging
+			if ((error as any).$metadata?.requestId) {
+				errorMeta.push(`Request ID: ${(error as any).$metadata.requestId}`)
+			}
+			if ((error as any).requestId) {
+				errorMeta.push(`Request ID: ${(error as any).requestId}`)
+			}
+
+			// Extended Request ID (S3/CloudFront style)
+			if ((error as any).$metadata?.extendedRequestId) {
+				errorMeta.push(`Extended Request ID: ${(error as any).$metadata.extendedRequestId}`)
+			}
+
+			// CF Request ID (CloudFront)
+			if ((error as any).$metadata?.cfId) {
+				errorMeta.push(`CloudFront ID: ${(error as any).$metadata.cfId}`)
+			}
+
+			// Build error code display
+			templateVars.errorCodes = errorCodes.length > 0 ? `[${errorCodes.join(", ")}]` : ""
+			templateVars.errorMetadata = errorMeta.length > 0 ? `\n\nDebug Info:\n${errorMeta.join("\n")}` : ""
+
 			// Format error details
 			const errorDetails: Record<string, any> = {}
 			Object.getOwnPropertyNames(error).forEach((prop) => {
@@ -1275,6 +1317,16 @@ Please check:
 			template = template.replace(new RegExp(`{${key}}`, "g"), value || "")
 		}
 
+		// Add error codes at the beginning if available
+		if (templateVars.errorCodes) {
+			template = `${templateVars.errorCodes} ${template}`
+		}
+
+		// Add metadata at the end if available
+		if (templateVars.errorMetadata) {
+			template = `${template}${templateVars.errorMetadata}`
+		}
+
 		return template
 	}