@hiper2d/ai-agents 0.4.2 → 0.5.1

package/dist/index.mjs

@@ -1830,6 +1830,21 @@ function pcmToWav(pcmData, sampleRate = SAMPLE_RATE) {
   new Uint8Array(buffer, headerSize).set(pcmData);
   return buffer;
 }
+function describeEmptyTtsResponse(response) {
+  const candidate = response?.candidates?.[0];
+  const parts = candidate?.content?.parts ?? [];
+  const bits = [];
+  bits.push(`finishReason=${candidate?.finishReason ?? "none"}`);
+  if (!response?.candidates?.length) bits.push("no candidates");
+  const block = response?.promptFeedback?.blockReason;
+  if (block) bits.push(`blockReason=${block}`);
+  const text = parts.map((p) => typeof p?.text === "string" ? p.text : "").join(" ").trim();
+  if (text) bits.push(`text="${text.slice(0, 120)}"`);
+  const otherMimes = parts.map((p) => p?.inlineData?.mimeType).filter(Boolean);
+  if (otherMimes.length) bits.push(`inlineData=${otherMimes.join(",")}`);
+  if (!parts.length) bits.push("no parts");
+  return bits.join(", ");
+}
 async function generateGoogleTtsAudio(text, apiKey, options) {
   const client = new GoogleGenAI({ apiKey });
   const response = await client.models.generateContent({
@@ -1840,10 +1855,11 @@ async function generateGoogleTtsAudio(text, apiKey, options) {
       speechConfig: { voiceConfig: { prebuiltVoiceConfig: { voiceName: options.voiceName } } }
     }
   });
-  const parts = response.candidates?.[0]?.content?.parts ?? [];
+  const candidate = response.candidates?.[0];
+  const parts = candidate?.content?.parts ?? [];
   const audioPart = parts.find((part) => part.inlineData?.mimeType?.startsWith("audio/"));
   if (!audioPart?.inlineData?.data) {
-    throw new Error("No audio data in Google TTS response");
+    throw new Error(`No audio data in Google TTS response (${describeEmptyTtsResponse(response)})`);
   }
   const pcmData = new Uint8Array(Buffer.from(audioPart.inlineData.data, "base64"));
   const usageMetadata = response.usageMetadata ?? {};
@@ -5093,6 +5109,7 @@ export {
   cleanResponse,
   createCatalog,
   createVoiceAgent,
+  describeEmptyTtsResponse,
   evaluateBudget,
   extractAnthropicTokenUsage,
   extractTokenUsageFromResponse6 as extractAnthropicTokenUsageFromResponse,