@google/adk 1.2.0 → 1.3.0

package/dist/esm/utils/live_connection_utils.js

@@ -0,0 +1,256 @@
+import {createRequire as topLevelCreateRequire} from 'module';
+const require = topLevelCreateRequire(import.meta.url);
+/**
+ * @license
+ * Copyright 2026 Google LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import { isGemini3xFlashLive } from "./model_name.js";
+class LiveResponseAggregator {
+  constructor(modelVersion) {
+    this.modelVersion = modelVersion;
+    this.text = "";
+    this.isThought = false;
+    this.toolCallParts = [];
+    this.pendingGroundingMetadata = void 0;
+    this.inputTranscriptionText = "";
+    this.outputTranscriptionText = "";
+  }
+  *processMessage(message) {
+    if (message.usageMetadata) {
+      yield {
+        usageMetadata: message.usageMetadata,
+        ...this.modelVersion ? { modelVersion: this.modelVersion } : {}
+      };
+    }
+    if (message.serverContent) {
+      const serverContent = message.serverContent;
+      const content = serverContent.modelTurn;
+      if (serverContent.groundingMetadata) {
+        this.pendingGroundingMetadata = serverContent.groundingMetadata;
+      }
+      if (!(content && content.parts) && serverContent.groundingMetadata && !serverContent.turnComplete) {
+        yield {
+          groundingMetadata: serverContent.groundingMetadata,
+          ...serverContent.interrupted !== void 0 ? { interrupted: serverContent.interrupted } : {},
+          ...this.modelVersion ? { modelVersion: this.modelVersion } : {}
+        };
+      }
+      if (content && content.parts) {
+        const llmResponse = {
+          content,
+          ...serverContent.interrupted !== void 0 ? { interrupted: serverContent.interrupted } : {},
+          ...this.modelVersion ? { modelVersion: this.modelVersion } : {}
+        };
+        if (!serverContent.turnComplete && serverContent.groundingMetadata) {
+          llmResponse.groundingMetadata = serverContent.groundingMetadata;
+        }
+        const hasInlineData = content.parts.some((p) => p.inlineData);
+        for (const part of content.parts) {
+          if (part.text) {
+            const currentIsThought = !!part.thought;
+            if (this.text && currentIsThought !== this.isThought) {
+              yield this.buildFullTextResponse(this.text, this.isThought);
+              this.text = "";
+              this.isThought = false;
+            }
+            this.text += part.text;
+            this.isThought = currentIsThought;
+            llmResponse.partial = true;
+          }
+        }
+        if (this.text && !content.parts.some((p) => p.text) && !hasInlineData) {
+          yield this.buildFullTextResponse(this.text, this.isThought);
+          this.text = "";
+          this.isThought = false;
+        }
+        yield llmResponse;
+      }
+      if (serverContent.inputTranscription) {
+        if (serverContent.inputTranscription.text) {
+          this.inputTranscriptionText += serverContent.inputTranscription.text;
+          yield {
+            inputTranscription: {
+              text: serverContent.inputTranscription.text,
+              finished: false
+            },
+            partial: true,
+            ...this.modelVersion ? { modelVersion: this.modelVersion } : {}
+          };
+        }
+        if (serverContent.inputTranscription.finished) {
+          yield {
+            inputTranscription: {
+              text: this.inputTranscriptionText,
+              finished: true
+            },
+            partial: false,
+            ...this.modelVersion ? { modelVersion: this.modelVersion } : {}
+          };
+          this.inputTranscriptionText = "";
+        }
+      }
+      if (serverContent.outputTranscription) {
+        if (serverContent.outputTranscription.text) {
+          this.outputTranscriptionText += serverContent.outputTranscription.text;
+          yield {
+            outputTranscription: {
+              text: serverContent.outputTranscription.text,
+              finished: false
+            },
+            partial: true,
+            ...this.modelVersion ? { modelVersion: this.modelVersion } : {}
+          };
+        }
+        if (serverContent.outputTranscription.finished) {
+          yield {
+            outputTranscription: {
+              text: this.outputTranscriptionText,
+              finished: true
+            },
+            partial: false,
+            ...this.modelVersion ? { modelVersion: this.modelVersion } : {}
+          };
+          this.outputTranscriptionText = "";
+        }
+      }
+      if (serverContent.interrupted || serverContent.turnComplete || serverContent.generationComplete) {
+        if (this.inputTranscriptionText) {
+          yield {
+            inputTranscription: {
+              text: this.inputTranscriptionText,
+              finished: true
+            },
+            partial: false,
+            ...this.modelVersion ? { modelVersion: this.modelVersion } : {}
+          };
+          this.inputTranscriptionText = "";
+        }
+        if (this.outputTranscriptionText) {
+          yield {
+            outputTranscription: {
+              text: this.outputTranscriptionText,
+              finished: true
+            },
+            partial: false,
+            ...this.modelVersion ? { modelVersion: this.modelVersion } : {}
+          };
+          this.outputTranscriptionText = "";
+        }
+      }
+      if (serverContent.turnComplete) {
+        let gMetadataToYield = this.pendingGroundingMetadata;
+        if (this.text) {
+          yield this.buildFullTextResponse(
+            this.text,
+            this.isThought,
+            gMetadataToYield
+          );
+          this.text = "";
+          this.isThought = false;
+          gMetadataToYield = void 0;
+        }
+        if (this.toolCallParts.length > 0) {
+          yield {
+            content: { role: "model", parts: this.toolCallParts },
+            ...this.modelVersion ? { modelVersion: this.modelVersion } : {}
+          };
+          this.toolCallParts = [];
+        }
+        const finalResponse = {
+          turnComplete: true,
+          ...this.modelVersion ? { modelVersion: this.modelVersion } : {}
+        };
+        if (serverContent.interrupted !== void 0) {
+          finalResponse.interrupted = serverContent.interrupted;
+        }
+        const finalGrounding = serverContent.groundingMetadata || gMetadataToYield;
+        if (finalGrounding !== void 0 && finalGrounding !== null) {
+          finalResponse.groundingMetadata = finalGrounding;
+        }
+        yield finalResponse;
+      }
+      if (serverContent.interrupted) {
+        if (this.text) {
+          yield this.buildFullTextResponse(this.text, this.isThought);
+          this.text = "";
+          this.isThought = false;
+        } else {
+          yield {
+            interrupted: serverContent.interrupted,
+            ...this.modelVersion ? { modelVersion: this.modelVersion } : {}
+          };
+        }
+      }
+    }
+    if (message.toolCall) {
+      if (this.text) {
+        yield this.buildFullTextResponse(this.text, this.isThought);
+        this.text = "";
+        this.isThought = false;
+      }
+      if (message.toolCall.functionCalls) {
+        this.toolCallParts.push(
+          ...message.toolCall.functionCalls.map((fc) => ({
+            functionCall: fc
+          }))
+        );
+      }
+      const isGemini3x = isGemini3xFlashLive(this.modelVersion);
+      if (isGemini3x && this.toolCallParts.length > 0) {
+        yield {
+          content: { role: "model", parts: this.toolCallParts },
+          ...this.modelVersion ? { modelVersion: this.modelVersion } : {}
+        };
+        this.toolCallParts = [];
+      }
+    }
+    if (message.sessionResumptionUpdate) {
+      yield {
+        liveSessionResumptionUpdate: message.sessionResumptionUpdate,
+        ...this.modelVersion ? { modelVersion: this.modelVersion } : {}
+      };
+    }
+    if (message.goAway) {
+      yield {
+        goAway: message.goAway,
+        ...this.modelVersion ? { modelVersion: this.modelVersion } : {}
+      };
+    }
+  }
+  /**
+   * Flushes any remaining aggregated components when the connection is closed.
+   */
+  *close() {
+    if (this.toolCallParts.length > 0) {
+      yield {
+        content: { role: "model", parts: this.toolCallParts },
+        ...this.modelVersion ? { modelVersion: this.modelVersion } : {}
+      };
+      this.toolCallParts = [];
+    }
+  }
+  buildFullTextResponse(text, isThought, groundingMetadata) {
+    const part = { text };
+    if (isThought) {
+      part.thought = true;
+    }
+    const response = {
+      content: {
+        role: "model",
+        parts: [part]
+      },
+      partial: false
+    };
+    if (groundingMetadata !== void 0 && groundingMetadata !== null) {
+      response.groundingMetadata = groundingMetadata;
+    }
+    if (this.modelVersion) {
+      response.modelVersion = this.modelVersion;
+    }
+    return response;
+  }
+}
+export {
+  LiveResponseAggregator
+};

package/dist/esm/utils/model_name.js

@@ -46,6 +46,13 @@ function isGemini2OrAbove(modelString) {
   const parsedVersion = parseVersion(versionString);
   return parsedVersion.valid && parsedVersion.major >= 2;
 }
+function isGemini3xFlashLive(modelString) {
+  if (!modelString) {
+    return false;
+  }
+  const modelName = extractModelName(modelString);
+  return modelName.startsWith("gemini-3.") && modelName.includes("-flash-live");
+}
 function isGeminiModelIdCheckDisabled() {
   return getBooleanEnvVar("ADK_DISABLE_GEMINI_MODEL_ID_CHECK");
 }
@@ -53,6 +60,7 @@ export {
   extractModelName,
   isGemini1Model,
   isGemini2OrAbove,
+  isGemini3xFlashLive,
   isGeminiModel,
   isGeminiModelIdCheckDisabled
 };

package/dist/esm/utils/streaming_utils.js

@@ -12,6 +12,7 @@ import { JSONPath } from "jsonpath-plus";
 import { generateClientFunctionCallId } from "../agents/functions.js";
 import { FeatureName, isFeatureEnabled } from "../features/feature_registry.js";
 import { createLlmResponse } from "../models/llm_response.js";
+const UNSAFE_PROPERTY_KEYS = /* @__PURE__ */ new Set(["__proto__", "constructor", "prototype"]);
 class ProgressiveStrategy {
   constructor() {
     this.partsSequence = [];
@@ -78,10 +79,13 @@ class ProgressiveStrategy {
     const pathParts = JSONPath.toPathArray(jsonPath).filter(
       (p) => p !== "$" && p !== "$["
     );
+    if (pathParts.some((part) => UNSAFE_PROPERTY_KEYS.has(String(part)))) {
+      return;
+    }
     let current = this.currentFcArgs;
     for (let i = 0; i < pathParts.length - 1; i++) {
       const part = pathParts[i];
-      if (!(part in current)) {
+      if (!Object.prototype.hasOwnProperty.call(current, part)) {
         current[part] = {};
       }
       current = current[part];
@@ -273,17 +277,13 @@ class StreamingResponseAggregator {
   )) {
     this.isProgressiveMode = isProgressiveMode;
     this.lastThoughtSignature = {};
-    this.sawFunctionCall = false;
     this.strategy = this.isProgressiveMode ? new ProgressiveStrategy() : new NonProgressiveStrategy();
   }
   async *processResponse(response) {
     var _a, _b;
     const llmResponse = createLlmResponse(response);
     const parts = (_b = (_a = llmResponse.content) == null ? void 0 : _a.parts) != null ? _b : [];
-    if (parts.some((part) => part.functionCall)) {
-      this.sawFunctionCall = true;
-    }
-    if (this.sawFunctionCall && llmResponse.finishReason === FinishReason.STOP && parts.length > 0 && parts.every(isEmptyContentPart)) {
+    if (parts.every(isEmptyContentPart) && (llmResponse.finishReason === void 0 || llmResponse.finishReason === FinishReason.STOP)) {
       if (llmResponse.usageMetadata) {
         this.usageMetadata = llmResponse.usageMetadata;
       }
@@ -323,7 +323,8 @@ class StreamingResponseAggregator {
   close() {
     var _a, _b, _c;
     const finalParts = this.strategy.close();
-    if (!finalParts) {
+    const hasMetadata = this.usageMetadata !== void 0 || this.groundingMetadata !== void 0 || this.citationMetadata !== void 0;
+    if (!finalParts && !hasMetadata) {
       return void 0;
     }
     const candidate = (_b = (_a = this.response) == null ? void 0 : _a.candidates) == null ? void 0 : _b[0];
@@ -331,7 +332,7 @@ class StreamingResponseAggregator {
     return {
       content: {
         role: "model",
-        parts: finalParts
+        parts: finalParts != null ? finalParts : []
       },
       groundingMetadata: this.groundingMetadata,
       citationMetadata: this.citationMetadata,

package/dist/esm/version.js

@@ -5,7 +5,7 @@ const require = topLevelCreateRequire(import.meta.url);
  * Copyright 2025 Google LLC
  * SPDX-License-Identifier: Apache-2.0
  */
-const version = "1.2.0";
+const version = "1.3.0";
 export {
   version
 };

package/dist/types/a2a/a2a_remote_agent_utils.d.ts

@@ -13,26 +13,51 @@ export interface UserFunctionCall {
     contextId: string;
 }
 /**
- * Returns a UserFunctionCall when the event at index has a FunctionResponse.
+ * Returns a UserFunctionCall when the event at `index` contains a
+ * FunctionResponse that can be traced back to a preceding FunctionCall event.
+ *
+ * @param session - The session whose event history to inspect.
+ * @param index - Index of the candidate event to examine.
+ * @returns The matching `UserFunctionCall`, or `undefined` if the event at
+ *   `index` is not a user function-response event or has no preceding call.
  */
 export declare function getUserFunctionCallAt(session: Session, index: number): UserFunctionCall | undefined;
 /**
  * Checks if an event contains a function call with the given ID.
+ *
+ * @param event - The event to inspect.
+ * @param callId - The function call ID to look for.
+ * @returns `true` if a part in the event has a matching `functionCall.id`.
  */
 export declare function isFunctionCallEvent(event: AdkEvent, callId: string): boolean;
 /**
  * Finds the first part with a FunctionResponse and returns the call ID.
+ *
+ * @param event - The event to inspect.
+ * @returns The `id` of the first FunctionResponse part, or `undefined` if
+ *   none is found.
  */
 export declare function getFunctionResponseCallId(event: AdkEvent): string | undefined;
 /**
- * Returns content parts for all events not present in the remote session
- * and a2a contextId if found in a remote agent event metadata.
+ * Returns A2A content parts for all events not yet seen by the remote agent,
+ * along with the A2A context ID found in the most recent remote agent event.
+ *
+ * @param ctx - The current invocation context, used to identify the remote
+ *   agent's authored events.
+ * @param session - The local session whose event history to diff.
+ * @returns An object with the missing `parts` and an optional `contextId`.
  */
 export declare function toMissingRemoteSessionParts(ctx: InvocationContext, session: Session): {
     parts: A2APart[];
     contextId?: string;
 };
 /**
- * Wraps an agent event as a user message for context.
+ * Wraps an agent event as a user message so it can be sent as context to a
+ * remote agent that only accepts user-role messages.
+ *
+ * @param ctx - The current invocation context.
+ * @param agentEvent - The agent-authored event to reframe as a user message.
+ * @returns A new event with `author: 'user'` whose parts summarise the
+ *   original agent event's text, function calls, and function responses.
  */
 export declare function presentAsUserMessage(ctx: InvocationContext, agentEvent: AdkEvent): AdkEvent;

package/dist/types/a2a/event_converter_utils.d.ts

@@ -8,6 +8,12 @@ import { Event as AdkEvent } from '../events/event.js';
 import { A2AEvent } from './a2a_event.js';
 /**
  * Converts a session Event to an A2A Message.
+ *
+ * @param event - The ADK event to convert.
+ * @param appName - The name of the ADK application.
+ * @param userId - The ID of the current user.
+ * @param sessionId - The ID of the current session.
+ * @returns An A2A message with the event's parts and metadata.
  */
 export declare function toA2AMessage(event: AdkEvent, { appName, userId, sessionId, }: {
     appName: string;
@@ -15,6 +21,13 @@ export declare function toA2AMessage(event: AdkEvent, { appName, userId, session
     sessionId: string;
 }): Message;
 /**
- * Converts an A2A Event to a Session Event.
+ * Converts an A2A Event to an ADK Session Event.
+ *
+ * @param event - The A2A event to convert (message, task, artifact update, or
+ *   status update).
+ * @param invocationId - The ADK invocation ID to attach to the resulting event.
+ * @param agentName - The name of the agent to use as the event author.
+ * @returns The converted ADK event, or `undefined` if the A2A event type
+ *   produces no content.
  */
 export declare function toAdkEvent(event: A2AEvent, invocationId: string, agentName: string): AdkEvent | undefined;

package/dist/types/a2a/metadata_converter_utils.d.ts

@@ -39,10 +39,19 @@ export declare enum AdkMetadataKeys {
 }
 /**
  * Creates ADK Event metadata from an A2A Event.
+ *
+ * @param a2aEvent - The A2A event to extract metadata from.
+ * @returns A record containing the ADK task ID and context ID keys.
  */
 export declare function getAdkEventMetadata(a2aEvent: A2AEvent): Record<string, unknown>;
 /**
  * Creates A2A Event metadata from an ADK Event.
+ *
+ * @param adkEvent - The ADK event to extract metadata from.
+ * @param appName - The name of the ADK application.
+ * @param userId - The ID of the current user.
+ * @param sessionId - The ID of the current session.
+ * @returns A record of A2A metadata keys populated from the ADK event.
  */
 export declare function getA2AEventMetadata(adkEvent: AdkEvent, { appName, userId, sessionId, }: {
     appName: string;
@@ -51,6 +60,11 @@ export declare function getA2AEventMetadata(adkEvent: AdkEvent, { appName, userI
 }): Record<string, unknown>;
 /**
  * Creates A2A Session metadata from ADK Event invocation metadata.
+ *
+ * @param appName - The name of the ADK application.
+ * @param userId - The ID of the current user.
+ * @param sessionId - The ID of the current session.
+ * @returns A record of A2A metadata keys for app name, user ID, and session ID.
  */
 export declare function getA2ASessionMetadata({ appName, userId, sessionId, }: {
     appName: string;
@@ -59,5 +73,9 @@ export declare function getA2ASessionMetadata({ appName, userId, sessionId, }: {
 }): Record<string, unknown>;
 /**
  * Creates A2A Event metadata from ADK Event actions.
+ *
+ * @param actions - The ADK event actions to extract escalation and transfer
+ *   metadata from.
+ * @returns A record with escalate and transfer-to-agent A2A metadata keys.
  */
 export declare function getA2AEventMetadataFromActions(actions: AdkEventActions): Record<string, unknown>;

package/dist/types/a2a/part_converter_utils.d.ts

@@ -6,43 +6,88 @@
 import { DataPart as A2ADataPart, FilePart as A2AFilePart, Part as A2APart, TextPart as A2ATextPart, Message } from '@a2a-js/sdk';
 import { Content as GenAIContent, Part as GenAIPart } from '@google/genai';
 /**
- * Converts GenAI Parts to A2A Parts.
+ * Converts an array of GenAI Parts to A2A Parts.
+ *
+ * @param parts - The GenAI parts to convert. Defaults to an empty array.
+ * @param longRunningToolIDs - IDs of function calls that are long-running.
+ * @returns An array of A2A parts.
  */
 export declare function toA2AParts(parts?: GenAIPart[], longRunningToolIDs?: string[]): A2APart[];
 /**
- * Converts a GenAI Part to an A2A Part.
+ * Converts a single GenAI Part to the appropriate A2A Part type.
+ *
+ * @param part - The GenAI part to convert.
+ * @param longRunningToolIDs - IDs of function calls that are long-running.
+ * @returns The corresponding A2A part (text, file, or data).
  */
 export declare function toA2APart(part: GenAIPart, longRunningToolIDs?: string[]): A2APart;
 /**
  * Converts a GenAI Text Part to an A2A Text Part.
+ *
+ * @param part - The GenAI part containing a text field.
+ * @returns An A2A text part, with thought metadata attached if applicable.
  */
 export declare function toA2ATextPart(part: GenAIPart): A2APart;
 /**
  * Converts a GenAI File Part to an A2A File Part.
+ *
+ * @param part - The GenAI part containing `fileData` or `inlineData`.
+ * @returns An A2A file part with URI or bytes depending on the source.
+ * @throws {Error} If the part contains neither `fileData` nor `inlineData`.
  */
 export declare function toA2AFilePart(part: GenAIPart): A2APart;
 /**
- * Converts a GenAI Data Part to an A2A Data Part.
+ * Converts a GenAI Data Part (function call/response or code) to an A2A Data Part.
+ *
+ * @param part - The GenAI part containing structured data.
+ * @param longRunningToolIDs - IDs of function calls that are long-running.
+ * @returns An A2A data part with the appropriate type metadata.
  */
 export declare function toA2ADataPart(part: GenAIPart, longRunningToolIDs?: string[]): A2APart;
+/**
+ * Converts an A2A Message to a GenAI Content object.
+ *
+ * @param a2aMessage - The A2A message to convert.
+ * @returns A GenAI user or model content object based on the message role.
+ */
 export declare function toGenAIContent(a2aMessage: Message): GenAIContent;
 /**
- * Converts an A2A Part to a GenAI Part.
+ * Converts an array of A2A Parts to GenAI Parts.
+ *
+ * @param a2aParts - The A2A parts to convert.
+ * @returns An array of GenAI parts.
  */
 export declare function toGenAIParts(a2aParts: A2APart[]): GenAIPart[];
 /**
- * Converts an A2A Part to a GenAI Part.
+ * Converts a single A2A Part to the appropriate GenAI Part type.
+ *
+ * @param a2aPart - The A2A part to convert.
+ * @returns The corresponding GenAI part.
+ * @throws {Error} If the A2A part has an unrecognized `kind`.
  */
 export declare function toGenAIPart(a2aPart: A2APart): GenAIPart;
 /**
  * Converts an A2A Text Part to a GenAI Part.
+ *
+ * @param a2aPart - The A2A text part to convert.
+ * @returns A GenAI part with `text` and optional `thought` flag.
  */
 export declare function toGenAIPartText(a2aPart: A2ATextPart): GenAIPart;
 /**
  * Converts an A2A File Part to a GenAI Part.
+ *
+ * @param a2aPart - The A2A file part containing bytes or a URI.
+ * @returns A GenAI part with `inlineData` or `fileData` depending on the
+ *   source, with optional video metadata attached.
+ * @throws {Error} If the file part contains neither bytes nor a URI.
  */
 export declare function toGenAIPartFile(a2aPart: A2AFilePart): GenAIPart;
 /**
- * Converts an A2A Data Part to a GenAI Part.
+ * Converts an A2A Data Part to the appropriate GenAI Part.
+ *
+ * @param a2aPart - The A2A data part containing structured data and type metadata.
+ * @returns A GenAI part with the appropriate function call, function response,
+ *   or code execution fields, falling back to a JSON text part if the type is
+ *   unrecognized.
  */
 export declare function toGenAIPartData(a2aPart: A2ADataPart): GenAIPart;

package/dist/types/agents/invocation_context.d.ts

@@ -12,7 +12,6 @@ import { BaseSessionService } from '../sessions/base_session_service.js';
 import { Session } from '../sessions/session.js';
 import { ActiveStreamingTool } from './active_streaming_tool.js';
 import { BaseAgent } from './base_agent.js';
-import { LiveRequestQueue } from './live_request_queue.js';
 import { RunConfig } from './run_config.js';
 import { TranscriptionEntry } from './transcription_entry.js';
 /**
@@ -31,7 +30,6 @@ export interface InvocationContextParams {
     endInvocation?: boolean;
     transcriptionCache?: TranscriptionEntry[];
     runConfig?: RunConfig;
-    liveRequestQueue?: LiveRequestQueue;
     activeStreamingTools?: Record<string, ActiveStreamingTool>;
     pluginManager: PluginManager;
     abortSignal?: AbortSignal;
@@ -124,10 +122,6 @@ export declare class InvocationContext {
      * this invocation.
      */
     private readonly invocationCostManager;
-    /**
-     * The queue to receive live requests.
-     */
-    liveRequestQueue?: LiveRequestQueue;
     /**
      * The running streaming tools of this invocation.
      */
@@ -136,9 +130,6 @@ export declare class InvocationContext {
      * The manager for keeping track of plugins in this invocation.
      */
     pluginManager: PluginManager;
-    /**
-     * The abort signal for the invocation.
-     */
     readonly abortSignal?: AbortSignal;
     /**
      * @param params The parameters for creating an invocation context.

package/dist/types/agents/llm_agent.d.ts

@@ -327,6 +327,20 @@ export declare class LlmAgent extends BaseAgent {
     private maybeSaveOutputToState;
     protected runAsyncImpl(context: InvocationContext): AsyncGenerator<Event, void, void>;
     protected runLiveImpl(context: InvocationContext): AsyncGenerator<Event, void, void>;
+    /**
+     * Runs the bidirectional (live) flow for this agent.
+     *
+     * Establishes a live connection to the model, drains the invocation's
+     * `liveRequestQueue` into the connection on a parallel task, and yields
+     * events derived from server messages until the queue closes, the model
+     * finishes, or an agent transfer occurs.
+     *
+     * If the live connection drops (network failure, server `goAway`) and a
+     * session resumption handle has been observed, the flow transparently
+     * reconnects using that handle up to {@link MAX_LIVE_RECONNECT_ATTEMPTS}
+     * times. Subsequent reconnects skip `sendHistory` because the server
+     * already holds the conversation state associated with the handle.
+     */
     private runLiveFlow;
     private runOneStepAsync;
     private postprocess;

package/dist/types/agents/processors/agent_transfer_llm_request_processor.d.ts

@@ -7,9 +7,23 @@ import { Event } from '../../events/event.js';
 import { LlmRequest } from '../../models/llm_request.js';
 import { InvocationContext } from '../invocation_context.js';
 import { BaseLlmRequestProcessor } from './base_llm_processor.js';
+/**
+ * Augments the {@link LlmRequest} to support agent transfer. When the current
+ * agent has reachable transfer targets (sub-agents, peer agents, or a parent
+ * agent), this processor registers a `transfer_to_agent` function tool and
+ * appends instructions describing each candidate so the model can choose to
+ * hand off control.
+ */
 export declare class AgentTransferLlmRequestProcessor extends BaseLlmRequestProcessor {
     private readonly toolName;
     private readonly tool;
+    /**
+     * Appends transfer instructions and registers the `transfer_to_agent` tool
+     * when the agent has reachable transfer targets.
+     *
+     * @param invocationContext - The current invocation context.
+     * @param llmRequest - The request to augment with transfer instructions and the transfer tool.
+     */
     runAsync(invocationContext: InvocationContext, llmRequest: LlmRequest): AsyncGenerator<Event, void, void>;
     private buildTargetAgentsInfo;
     private buildTargetAgentsInstructions;

package/dist/types/agents/processors/basic_llm_request_processor.d.ts

@@ -13,6 +13,13 @@ import { BaseLlmRequestProcessor } from './base_llm_processor.js';
  * connect settings.
  */
 export declare class BasicLlmRequestProcessor extends BaseLlmRequestProcessor {
+    /**
+     * Populates model name, generation config, output schema, and live connect
+     * settings on the request from the agent and run config.
+     *
+     * @param invocationContext - The current invocation context.
+     * @param llmRequest - The request object to populate in place.
+     */
     runAsync(invocationContext: InvocationContext, llmRequest: LlmRequest): AsyncGenerator<Event, void, void>;
 }
 export declare const BASIC_LLM_REQUEST_PROCESSOR: BasicLlmRequestProcessor;