feat(ai): improve error handling

lib/deep-research.ts

@@ -126,7 +126,7 @@ export function generateSearchQueries({
     system: systemPrompt(),
     prompt,
     onError({ error }) {
-      throw error
+      throwAiError('generateSearchQueries', error)
     },
   })
 }
@@ -174,7 +174,7 @@ function processSearchResult({
     system: systemPrompt(),
     prompt,
     onError({ error }) {
-      throw error
+      throwAiError('processSearchResult', error)
     },
   })
 }
@@ -204,7 +204,7 @@ export function writeFinalReport({
     system: systemPrompt(),
     prompt: _prompt,
     onError({ error }) {
-      throw error
+      throwAiError('writeFinalReport', error)
     },
   })
 }

lib/feedback.ts

@@ -37,8 +37,7 @@ export function generateFeedback({
     system: systemPrompt(),
     prompt,
     onError({ error }) {
-      console.error(`generateFeedback`, error)
-      throw error
+      throwAiError('generateFeedback', error)
     },
   })
 

utils/errors.ts

@@ -0,0 +1,27 @@
+import { APICallError } from 'ai'
+
+/**
+ * Parse an error thrown by the AI SDK, and re-throw it with a human-readable message
+ */
+export function throwAiError(operation: string, error: unknown) {
+  if (APICallError.isInstance(error)) {
+    let message = error.message
+    if (error.statusCode) message += ` (${error.statusCode})`
+    if (error.cause) message += `\nCause: ${error.cause}`
+    if (error.responseBody) message += `\nResponse: ${error.responseBody}`
+    if (error.url) message += `\nURL: ${error.url}`
+
+    console.error(`[${operation}]`, error, {
+      statusCode: error.statusCode,
+      response: error.responseBody,
+      cause: error.cause,
+      stack: error.stack,
+      isRetryable: error.isRetryable,
+      url: error.url,
+    })
+    throw new Error(message)
+  } else {
+    console.error(`[${operation}]`, error)
+  }
+  throw error
+}