From d9cfa115bed37c6036734ec3ab5ad1cbbda6f36a Mon Sep 17 00:00:00 2001
From: Drew Brown <drew@drewburr.com>
Date: Sun, 8 Mar 2026 15:34:01 -0500
Subject: [PATCH] fix(ai): improve error details in response.failed handler
 (#1956)

---
 packages/ai/src/providers/openai-responses-shared.ts | 9 ++++++++-
 1 file changed, 8 insertions(+), 1 deletion(-)

diff --git a/packages/ai/src/providers/openai-responses-shared.ts b/packages/ai/src/providers/openai-responses-shared.ts
index 10ac5ee1..8084159b 100644
--- a/packages/ai/src/providers/openai-responses-shared.ts
+++ b/packages/ai/src/providers/openai-responses-shared.ts
@@ -469,7 +469,14 @@ export async function processResponsesStream<TApi extends Api>(
 		} else if (event.type === "error") {
 			throw new Error(`Error Code ${event.code}: ${event.message}` || "Unknown error");
 		} else if (event.type === "response.failed") {
-			throw new Error("Unknown error");
+			const error = event.response?.error;
+			const details = event.response?.incomplete_details;
+			const msg = error
+				? `${error.code || "unknown"}: ${error.message || "no message"}`
+				: details?.reason
+					? `incomplete: ${details.reason}`
+					: "Unknown error (no error details in response)";
+			throw new Error(msg);
 		}
 	}
 }