@paean-ai/adk 0.2.24 → 0.2.25

package/dist/cjs/models/google_llm.js

@@ -131,7 +131,7 @@ class Gemini extends import_base_llm.BaseLlm {
    * @yields LlmResponse: The model response.
    */
   async *generateContentAsync(llmRequest, stream = false) {
-    var _a, _b, _c, _d, _e, _f, _g, _h, _i, _j, _k, _l;
+    var _a, _b, _c, _d, _e, _f, _g, _h, _i, _j, _k, _l, _m, _n, _o, _p, _q;
     this.preprocessRequest(llmRequest);
     this.maybeAppendUserContent(llmRequest);
     import_logger.logger.info(
@@ -154,6 +154,7 @@ class Gemini extends import_base_llm.BaseLlm {
       let text = "";
       let usageMetadata;
       let lastResponse;
+      let pendingFCResponse = null;
       for await (const response of streamResult) {
         lastResponse = response;
         const llmResponse = (0, import_llm_response.createLlmResponse)(response);
@@ -182,7 +183,9 @@ class Gemini extends import_base_llm.BaseLlm {
           } else {
             text += firstPart.text;
           }
-          llmResponse.partial = true;
+          if (!hasFunctionCalls) {
+            llmResponse.partial = true;
+          }
           if (this.isGemini3Preview && hasFunctionCalls) {
             thoughtText = "";
             thoughtSignature = void 0;
@@ -252,18 +255,43 @@ class Gemini extends import_base_llm.BaseLlm {
               }
             }
           }
-          const partsWithSig = llmResponse.content.parts.filter(
+        }
+        if (hasFunctionCalls) {
+          if (pendingFCResponse && ((_i = pendingFCResponse.content) == null ? void 0 : _i.parts)) {
+            const newFCParts = (((_j = llmResponse.content) == null ? void 0 : _j.parts) || []).filter(
+              (p) => p.functionCall
+            );
+            pendingFCResponse.content.parts.push(...newFCParts);
+            pendingFCResponse.usageMetadata = llmResponse.usageMetadata;
+          } else {
+            pendingFCResponse = llmResponse;
+          }
+          continue;
+        }
+        if (pendingFCResponse) {
+          if (!((_l = (_k = llmResponse.content) == null ? void 0 : _k.parts) == null ? void 0 : _l.length)) {
+            continue;
+          }
+          yield pendingFCResponse;
+          pendingFCResponse = null;
+        }
+        yield llmResponse;
+      }
+      if (pendingFCResponse) {
+        if (this.isGemini3Preview && ((_m = pendingFCResponse.content) == null ? void 0 : _m.parts)) {
+          const partsWithSig = pendingFCResponse.content.parts.filter(
             (p) => p.thoughtSignature
           ).length;
           if (partsWithSig === 0) {
             import_logger.logger.warn(
-              `[Gemini3] No thoughtSignature on function call parts \u2014 may cause 400 on next request`
+              `[Gemini3] No thoughtSignature on merged function call parts \u2014 may cause 400 on next request`
             );
           }
         }
-        yield llmResponse;
+        yield pendingFCResponse;
+        pendingFCResponse = null;
       }
-      if ((text || thoughtText) && ((_j = (_i = lastResponse == null ? void 0 : lastResponse.candidates) == null ? void 0 : _i[0]) == null ? void 0 : _j.finishReason) === import_genai.FinishReason.STOP) {
+      if ((text || thoughtText) && ((_o = (_n = lastResponse == null ? void 0 : lastResponse.candidates) == null ? void 0 : _n[0]) == null ? void 0 : _o.finishReason) === import_genai.FinishReason.STOP) {
         const parts = [];
         if (thoughtText) {
           const thoughtPart = { text: thoughtText, thought: true };
@@ -285,12 +313,12 @@ class Gemini extends import_base_llm.BaseLlm {
       }
     } else {
       const response = await this.apiClient.models.generateContent({
-        model: (_k = llmRequest.model) != null ? _k : this.model,
+        model: (_p = llmRequest.model) != null ? _p : this.model,
         contents: llmRequest.contents,
         config: llmRequest.config
       });
       const llmResponse = (0, import_llm_response.createLlmResponse)(response);
-      if (this.isGemini3Preview && ((_l = llmResponse.content) == null ? void 0 : _l.parts)) {
+      if (this.isGemini3Preview && ((_q = llmResponse.content) == null ? void 0 : _q.parts)) {
         let thoughtSig;
         let hasThoughtPartWithSignature = false;
         for (const part of llmResponse.content.parts) {

package/dist/esm/agents/functions.js

@@ -89,6 +89,9 @@ function generateAuthEvent(invocationContext, functionResponseEvent) {
     longRunningToolIds.add(requestEucFunctionCall.id);
     parts.push({ functionCall: requestEucFunctionCall });
   }
+  if (parts.length === 0) {
+    return void 0;
+  }
   return createEvent({
     invocationId: invocationContext.invocationId,
     author: invocationContext.agent.name,
@@ -130,6 +133,9 @@ function generateRequestConfirmationEvent({
     longRunningToolIds.add(requestConfirmationFunctionCall.id);
     parts.push({ functionCall: requestConfirmationFunctionCall });
   }
+  if (parts.length === 0) {
+    return void 0;
+  }
   return createEvent({
     invocationId: invocationContext.invocationId,
     author: invocationContext.agent.name,
@@ -193,8 +199,9 @@ async function handleFunctionCallList({
       }
     );
     if (!toolAndContext) {
+      const argsPreview = functionCall.args ? JSON.stringify(functionCall.args).substring(0, 300) : "(none)";
       logger.warn(
-        `Function "${functionCall.name}" not found in toolsDict (${Object.keys(toolsDict).length} tools registered).`
+        `Function "${functionCall.name}" not found in toolsDict (${Object.keys(toolsDict).length} tools registered). Args: ${argsPreview}`
       );
       const errorResponseEvent = createEvent({
         invocationId: invocationContext.invocationId,
@@ -243,6 +250,10 @@ async function handleFunctionCallList({
           toolContext
         );
       } catch (e) {
+        const argsPreview = JSON.stringify(functionArgs).substring(0, 500);
+        logger.error(
+          `Tool execution error: "${tool.name}" threw ${e instanceof Error ? e.message : String(e)}. Args: ${argsPreview}`
+        );
         if (e instanceof Error) {
           const onToolErrorResponse = await invocationContext.pluginManager.runOnToolErrorCallback(
             {

package/dist/esm/agents/llm_agent.js

@@ -899,12 +899,12 @@ const _LlmAgent = class _LlmAgent extends BaseAgent {
         consecutiveErrors++;
         if (consecutiveErrors <= _LlmAgent.MAX_AGENT_LOOP_ERROR_RETRIES) {
           logger.warn(
-            `[runAsyncImpl] Error event (${lastEvent.errorCode}), retrying agent loop (${consecutiveErrors}/${_LlmAgent.MAX_AGENT_LOOP_ERROR_RETRIES})`
+            `[runAsyncImpl] Error event (${lastEvent.errorCode}: ${lastEvent.errorMessage || "no message"}), retrying agent loop (${consecutiveErrors}/${_LlmAgent.MAX_AGENT_LOOP_ERROR_RETRIES})`
           );
           continue;
         }
         logger.error(
-          `[runAsyncImpl] Max agent-loop error retries exhausted for ${lastEvent.errorCode}`
+          `[runAsyncImpl] Max agent-loop error retries exhausted for ${lastEvent.errorCode}: ${lastEvent.errorMessage || "no message"}`
         );
         break;
       }
@@ -993,7 +993,7 @@ const _LlmAgent = class _LlmAgent extends BaseAgent {
     }
   }
   async *postprocess(invocationContext, llmRequest, llmResponse, modelResponseEvent) {
-    var _a, _b;
+    var _a, _b, _c, _d, _e, _f, _g, _h, _i;
     for (const processor of this.responseProcessors) {
       for await (const event of processor.runAsync(invocationContext, llmResponse)) {
         yield event;
@@ -1002,6 +1002,27 @@ const _LlmAgent = class _LlmAgent extends BaseAgent {
     if (!llmResponse.content && !llmResponse.errorCode && !llmResponse.interrupted) {
       return;
     }
+    if (llmResponse.content && !llmResponse.errorCode) {
+      if (!llmResponse.content.parts || llmResponse.content.parts.length === 0) {
+        logger.debug(
+          `[postprocess] Skipping LLM response with no parts (role=${llmResponse.content.role})`
+        );
+        return;
+      }
+      const allEmpty = llmResponse.content.parts.every(
+        (p) => {
+          if (p.functionCall || p.functionResponse || p.executableCode || p.codeExecutionResult) return false;
+          if ("text" in p && typeof p.text === "string" && p.text.length > 0) return false;
+          return true;
+        }
+      );
+      if (allEmpty) {
+        logger.debug(
+          `[postprocess] Skipping empty-content LLM response (${llmResponse.content.parts.length} empty parts)`
+        );
+        return;
+      }
+    }
     const mergedEvent = createEvent({
       ...modelResponseEvent,
       ...llmResponse
@@ -1023,8 +1044,11 @@ const _LlmAgent = class _LlmAgent extends BaseAgent {
         }
       }
     }
+    logger.debug(
+      `[postprocess] Yielding mergedEvent: role=${(_b = mergedEvent.content) == null ? void 0 : _b.role}, parts=${(_d = (_c = mergedEvent.content) == null ? void 0 : _c.parts) == null ? void 0 : _d.length}, hasFCs=${((_e = getFunctionCalls(mergedEvent)) == null ? void 0 : _e.length) || 0}, partial=${mergedEvent.partial}`
+    );
     yield mergedEvent;
-    if (!((_b = getFunctionCalls(mergedEvent)) == null ? void 0 : _b.length)) {
+    if (!((_f = getFunctionCalls(mergedEvent)) == null ? void 0 : _f.length)) {
       return;
     }
     const functionResponseEvent = await handleFunctionCallsAsync({
@@ -1049,6 +1073,9 @@ const _LlmAgent = class _LlmAgent extends BaseAgent {
     if (toolConfirmationEvent) {
       yield toolConfirmationEvent;
     }
+    logger.debug(
+      `[postprocess] Yielding functionResponseEvent: role=${(_g = functionResponseEvent.content) == null ? void 0 : _g.role}, parts=${(_i = (_h = functionResponseEvent.content) == null ? void 0 : _h.parts) == null ? void 0 : _i.length}`
+    );
     yield functionResponseEvent;
     const nextAgentName = functionResponseEvent.actions.transferToAgent;
     if (nextAgentName) {
@@ -1130,7 +1157,7 @@ const _LlmAgent = class _LlmAgent extends BaseAgent {
           if (llmResponse.errorCode && _LlmAgent.LLM_RETRYABLE_ERROR_CODES.has(llmResponse.errorCode) && !contentYielded && attempt < maxRetries) {
             shouldRetry = true;
             logger.warn(
-              `[callLlmAsync] Transient LLM error: ${llmResponse.errorCode}, usage: ${JSON.stringify(llmResponse.usageMetadata)}`
+              `[callLlmAsync] Transient LLM error: ${llmResponse.errorCode}${llmResponse.errorMessage ? ": " + llmResponse.errorMessage : ""}, finishReason: ${llmResponse.finishReason || "none"}, usage: ${JSON.stringify(llmResponse.usageMetadata)}`
             );
             break;
           }

package/dist/esm/events/event.js

@@ -5,7 +5,7 @@
  */
 import { createEventActions } from "./event_actions.js";
 function createEvent(params = {}) {
-  return {
+  const event = {
     ...params,
     id: params.id || createNewEventId(),
     invocationId: params.invocationId || "",
@@ -15,6 +15,7 @@ function createEvent(params = {}) {
     branch: params.branch,
     timestamp: params.timestamp || Date.now()
   };
+  return event;
 }
 function isFinalResponse(event) {
   if (event.actions.skipSummarization || event.longRunningToolIds && event.longRunningToolIds.length > 0) {