@hiper2d/ai-agents 0.5.0 → 0.5.2

package/dist/index.mjs

@@ -714,9 +714,11 @@ var ModelInvalidResponseError = class extends ModelError {
   }
 };
 var ModelRefusalError = class extends ModelError {
-  constructor(modelType, message = `${modelType} refused to answer (stop_reason: refusal)`) {
+  reason;
+  constructor(modelType, message = `${modelType} refused to answer (stop_reason: refusal)`, reason) {
     super(message, modelType);
     this.name = "ModelRefusalError";
+    this.reason = reason;
   }
 };
 
@@ -1830,6 +1832,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 +1857,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 ?? {};
@@ -2638,7 +2656,7 @@ ${schemaDescription}`;
         throw new Error(this.errorMessages.apiError(apiError));
       }
       if (response.stop_reason === "refusal") {
-        throw new ModelRefusalError(this.model);
+        throw new ModelRefusalError(this.model, void 0, "refusal");
       }
       if (!("content" in response) || !Array.isArray(response.content) || response.content.length === 0) {
         throw new Error(this.errorMessages.emptyResponse);
@@ -2732,7 +2750,7 @@ ${schemaDescription}`;
         throw new Error(this.errorMessages.apiError(apiError));
       }
       if (response.stop_reason === "refusal") {
-        throw new ModelRefusalError(this.model);
+        throw new ModelRefusalError(this.model, void 0, "refusal");
       }
       if (!("content" in response) || !Array.isArray(response.content) || response.content.length === 0) {
         throw new Error(this.errorMessages.emptyResponse);
@@ -2788,6 +2806,45 @@ ${schemaDescription}`;
 
 // src/agents/google-agent.ts
 import { GoogleGenAI as GoogleGenAI3 } from "@google/genai";
+var GEMINI_REFUSAL_FINISH_REASONS = /* @__PURE__ */ new Set([
+  "SAFETY",
+  "RECITATION",
+  "BLOCKLIST",
+  "PROHIBITED_CONTENT",
+  "SPII",
+  "IMAGE_SAFETY",
+  "IMAGE_PROHIBITED_CONTENT",
+  "IMAGE_RECITATION"
+]);
+function throwForEmptyGeminiResponse(model, response, fallback) {
+  const blockReason = response?.promptFeedback?.blockReason;
+  const candidate = response?.candidates?.[0];
+  const finishReason = candidate?.finishReason;
+  const finishMessage = candidate?.finishMessage;
+  const ratings = (candidate?.safetyRatings ?? response?.promptFeedback?.safetyRatings ?? []).filter((r) => r?.blocked || r?.probability && r.probability !== "NEGLIGIBLE");
+  const ratingText = ratings.length ? `; safetyRatings: ${ratings.map((r) => `${r.category}=${r.probability ?? (r.blocked ? "blocked" : "?")}`).join(", ")}` : "";
+  if (blockReason) {
+    throw new ModelRefusalError(
+      model,
+      `${model} refused the prompt (blockReason: ${blockReason}${finishMessage ? `, ${finishMessage}` : ""}${ratingText})`,
+      blockReason
+    );
+  }
+  if (finishReason && GEMINI_REFUSAL_FINISH_REASONS.has(finishReason)) {
+    throw new ModelRefusalError(
+      model,
+      `${model} refused to answer (finishReason: ${finishReason}${finishMessage ? `, ${finishMessage}` : ""}${ratingText})`,
+      finishReason
+    );
+  }
+  if (finishReason === "MAX_TOKENS") {
+    throw new ModelInvalidResponseError(model, "empty response, finishReason MAX_TOKENS (thinking consumed the whole output budget)", true);
+  }
+  const bits = [`finishReason=${finishReason ?? "none"}`];
+  if (!response?.candidates?.length) bits.push("no candidates");
+  if (finishMessage) bits.push(`finishMessage="${finishMessage}"`);
+  throw new Error(`${fallback} (${bits.join(", ")})`);
+}
 var GoogleAgent = class extends AbstractAgent {
   client;
   defaultConfig = {
@@ -2799,7 +2856,7 @@ var GoogleAgent = class extends AbstractAgent {
   };
   // Error message templates
   errorMessages = {
-    emptyResponse: "Empty response from Google API - check logs for detailed response info",
+    emptyResponse: "Empty response from Google API",
     invalidFormat: "Invalid response format from Google API",
     apiError: (error) => `Failed to get response from Google API: ${error instanceof Error ? error.message : String(error)}`,
     unsupportedRole: (role) => `Unsupported role type: ${role}`
@@ -2971,7 +3028,7 @@ var GoogleAgent = class extends AbstractAgent {
       }
       this.logger(`Zod schema response received - hasText: ${!!response.text}, textLength: ${response.text ? response.text.length : 0}`);
       if (!response.text) {
-        throw new Error(this.errorMessages.emptyResponse);
+        throwForEmptyGeminiResponse(this.model, response, this.errorMessages.emptyResponse);
       }
       const parsedData = parseAndValidateLlmJson(response.text, zodSchema, (m) => this.logger(m));
       if (parsedData) {
@@ -3059,7 +3116,7 @@ var GoogleAgent = class extends AbstractAgent {
       }
       this.logger(`Plain text response received - hasText: ${!!response.text}, textLength: ${response.text ? response.text.length : 0}`);
       if (!response.text) {
-        throw new Error(this.errorMessages.emptyResponse);
+        throwForEmptyGeminiResponse(this.model, response, this.errorMessages.emptyResponse);
       }
       this.logReply(response.text, thinkingContent || void 0, tokenUsage);
       return [response.text, thinkingContent, tokenUsage, googleThoughtSignature || void 0];
@@ -5093,6 +5150,7 @@ export {
   cleanResponse,
   createCatalog,
   createVoiceAgent,
+  describeEmptyTtsResponse,
   evaluateBudget,
   extractAnthropicTokenUsage,
   extractTokenUsageFromResponse6 as extractAnthropicTokenUsageFromResponse,