chore(stream): improve get_final_text() error message

Author: RobertCraigie

src/anthropic/lib/streaming/_beta_messages.py

@@ -101,7 +101,9 @@ def get_final_text(self) -> str:
                 text_blocks.append(block.text)
 
         if not text_blocks:
-            raise RuntimeError("Expected to have received at least 1 text block")
+            raise RuntimeError(
+                f".get_final_text() can only be called when the API returns a `text` content block.\nThe API returned {','.join([b.type for b in message.content])} content block type(s) that you'll have to handle separately"
+            )
 
         return "".join(text_blocks)
 
@@ -239,7 +241,10 @@ async def get_final_text(self) -> str:
                 text_blocks.append(block.text)
 
         if not text_blocks:
-            raise RuntimeError("Expected to have received at least 1 text block")
+            raise RuntimeError(
+                f".get_final_text() can only be called when the API returns a `text` content block.\nThe API returned {','.join([b.type for b in message.content])} content block type(s) that you'll have to handle separately"
+            )
+
 
         return "".join(text_blocks)
 

src/anthropic/lib/streaming/_messages.py

@@ -100,7 +100,9 @@ def get_final_text(self) -> str:
                 text_blocks.append(block.text)
 
         if not text_blocks:
-            raise RuntimeError("Expected to have received at least 1 text block")
+            raise RuntimeError(
+                f".get_final_text() can only be called when the API returns a `text` content block.\nThe API returned {','.join([b.type for b in message.content])} content block type(s) that you'll have to handle separately"
+            )
 
         return "".join(text_blocks)
 
@@ -237,7 +239,9 @@ async def get_final_text(self) -> str:
                 text_blocks.append(block.text)
 
         if not text_blocks:
-            raise RuntimeError("Expected to have received at least 1 text block")
+            raise RuntimeError(
+                f".get_final_text() can only be called when the API returns a `text` content block.\nThe API returned {','.join([b.type for b in message.content])} content block type(s) that you'll have to handle separately"
+            )
 
         return "".join(text_blocks)