@google/adk 1.1.0 → 1.3.0

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/partial_copy.js

@@ -0,0 +1,23 @@
+import {createRequire as topLevelCreateRequire} from 'module';
+const require = topLevelCreateRequire(import.meta.url);
+/**
+ * @license
+ * Copyright 2026 Google LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+function partialCopy(source, targetKeys) {
+  const result = {};
+  const sourceAsUnknown = source;
+  targetKeys.forEach((key) => {
+    const keyStr = key;
+    if (keyStr in source) {
+      result[key] = sourceAsUnknown[keyStr];
+    } else {
+      result[key] = void 0;
+    }
+  });
+  return result;
+}
+export {
+  partialCopy
+};

package/dist/esm/utils/streaming_utils.js

@@ -12,15 +12,9 @@ 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";
-class StreamingResponseAggregator {
-  constructor(isProgressiveMode = isFeatureEnabled(
-    FeatureName.PROGRESSIVE_SSE_STREAMING
-  )) {
-    this.isProgressiveMode = isProgressiveMode;
-    // For non-progressive SSE streaming mode
-    this.text = "";
-    this.thoughtText = "";
-    // For progressive SSE streaming mode: accumulate parts in order
+const UNSAFE_PROPERTY_KEYS = /* @__PURE__ */ new Set(["__proto__", "constructor", "prototype"]);
+class ProgressiveStrategy {
+  constructor() {
     this.partsSequence = [];
     this.currentTextBuffer = "";
     this.currentFcArgs = {};
@@ -85,10 +79,13 @@ class StreamingResponseAggregator {
     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];
@@ -147,11 +144,6 @@ class StreamingResponseAggregator {
     if (!fc) {
       return;
     }
-    if (part.thoughtSignature) {
-      this.lastThoughtSignature = part.thoughtSignature;
-    } else if (this.lastThoughtSignature) {
-      part.thoughtSignature = this.lastThoughtSignature.toString();
-    }
     if (fc.partialArgs || fc.willContinue) {
       if (!fc.id && !this.currentFcId) {
         fc.id = generateClientFunctionCallId();
@@ -170,63 +162,103 @@ class StreamingResponseAggregator {
       }
     }
   }
-  async *processResponse(response) {
-    var _a, _b, _c;
-    this.response = response;
-    const llmResponse = createLlmResponse(response);
-    this.usageMetadata = llmResponse.usageMetadata;
-    if (llmResponse.groundingMetadata) {
-      this.groundingMetadata = llmResponse.groundingMetadata;
-    }
-    if (llmResponse.citationMetadata) {
-      this.citationMetadata = llmResponse.citationMetadata;
-    }
-    if (llmResponse.finishReason) {
-      this.finishReason = llmResponse.finishReason;
-    }
+  async *processResponse(llmResponse) {
+    var _a;
     if (llmResponse.content && llmResponse.content.parts) {
       for (const part of llmResponse.content.parts) {
-        if (part.thoughtSignature) {
-          this.lastThoughtSignature = part.thoughtSignature;
-        } else if (part.functionCall && this.lastThoughtSignature) {
-          part.thoughtSignature = this.lastThoughtSignature.toString();
+        if (part.text) {
+          const isThought = (_a = part.thought) != null ? _a : false;
+          if (this.currentTextBuffer && isThought !== this.currentTextIsThought) {
+            this.flushTextBufferToSequence();
+          }
+          if (!this.currentTextBuffer) {
+            this.currentTextIsThought = isThought;
+          }
+          this.currentTextBuffer += part.text;
+        } else if (part.functionCall) {
+          this.processFunctionCallPart(part);
+        } else {
+          this.flushTextBufferToSequence();
+          this.partsSequence.push(part);
         }
       }
     }
-    if (this.isProgressiveMode) {
-      if (llmResponse.content && llmResponse.content.parts) {
-        for (const part of llmResponse.content.parts) {
-          if (part.text) {
-            const isThought = (_a = part.thought) != null ? _a : false;
-            if (this.currentTextBuffer && isThought !== this.currentTextIsThought) {
-              this.flushTextBufferToSequence();
-            }
-            if (!this.currentTextBuffer) {
-              this.currentTextIsThought = isThought;
-            }
-            this.currentTextBuffer += part.text;
-          } else if (part.functionCall) {
-            this.processFunctionCallPart(part);
+    llmResponse.partial = true;
+    yield llmResponse;
+  }
+  close() {
+    this.flushTextBufferToSequence();
+    this.flushFunctionCallToSequence();
+    const finalParts = this.partsSequence;
+    if (finalParts.length === 0) {
+      return void 0;
+    }
+    return finalParts;
+  }
+}
+class NonProgressiveStrategy {
+  constructor() {
+    this.text = "";
+    this.thoughtText = "";
+  }
+  async *processResponse(llmResponse) {
+    var _a;
+    if ((_a = llmResponse.content) == null ? void 0 : _a.parts) {
+      const nonTextParts = [];
+      let sawTextPart = false;
+      for (const part of llmResponse.content.parts) {
+        if (typeof part.text === "string") {
+          sawTextPart = true;
+          if (part.thought) {
+            this.thoughtText += part.text;
           } else {
-            this.flushTextBufferToSequence();
-            this.partsSequence.push(part);
+            this.text += part.text;
           }
+          continue;
+        }
+        if (part.functionCall && !part.functionCall.id) {
+          part.functionCall.id = generateClientFunctionCallId();
         }
+        nonTextParts.push(part);
       }
-      llmResponse.partial = true;
-      yield llmResponse;
-      return;
-    }
-    if (llmResponse.content && llmResponse.content.parts && typeof ((_b = llmResponse.content.parts[0]) == null ? void 0 : _b.text) === "string") {
-      const part0 = llmResponse.content.parts[0];
-      const partText = part0.text || "";
-      if (part0.thought) {
-        this.thoughtText += partText;
-      } else {
-        this.text += partText;
+      if (nonTextParts.length > 0) {
+        if (this.thoughtText || this.text) {
+          const parts = [];
+          if (this.thoughtText) {
+            parts.push({ text: this.thoughtText, thought: true });
+          }
+          if (this.text) {
+            parts.push({ text: this.text });
+          }
+          yield {
+            content: {
+              role: "model",
+              parts
+            },
+            usageMetadata: llmResponse.usageMetadata,
+            partial: false
+          };
+          this.thoughtText = "";
+          this.text = "";
+        }
+        yield {
+          ...llmResponse,
+          content: {
+            role: llmResponse.content.role,
+            parts: nonTextParts
+          },
+          partial: false
+        };
+        return;
+      }
+      if (sawTextPart) {
+        llmResponse.partial = true;
       }
-      llmResponse.partial = true;
-    } else if ((this.thoughtText || this.text) && (!llmResponse.content || !llmResponse.content.parts || !((_c = llmResponse.content.parts[0]) == null ? void 0 : _c.inlineData))) {
+    }
+    yield llmResponse;
+  }
+  close() {
+    if (this.text || this.thoughtText) {
       const parts = [];
       if (this.thoughtText) {
         parts.push({ text: this.thoughtText, thought: true });
@@ -234,74 +266,88 @@ class StreamingResponseAggregator {
       if (this.text) {
         parts.push({ text: this.text });
       }
-      yield {
-        content: {
-          role: "model",
-          parts
-        },
-        usageMetadata: llmResponse.usageMetadata,
-        partial: false
-      };
-      this.thoughtText = "";
-      this.text = "";
+      return parts;
     }
-    yield llmResponse;
+    return void 0;
   }
-  close() {
+}
+class StreamingResponseAggregator {
+  constructor(isProgressiveMode = isFeatureEnabled(
+    FeatureName.PROGRESSIVE_SSE_STREAMING
+  )) {
+    this.isProgressiveMode = isProgressiveMode;
+    this.lastThoughtSignature = {};
+    this.strategy = this.isProgressiveMode ? new ProgressiveStrategy() : new NonProgressiveStrategy();
+  }
+  async *processResponse(response) {
     var _a, _b;
-    if (!((_a = this.response) == null ? void 0 : _a.candidates) || this.response.candidates.length === 0) {
+    const llmResponse = createLlmResponse(response);
+    const parts = (_b = (_a = llmResponse.content) == null ? void 0 : _a.parts) != null ? _b : [];
+    if (parts.every(isEmptyContentPart) && (llmResponse.finishReason === void 0 || llmResponse.finishReason === FinishReason.STOP)) {
+      if (llmResponse.usageMetadata) {
+        this.usageMetadata = llmResponse.usageMetadata;
+      }
+      if (llmResponse.groundingMetadata) {
+        this.groundingMetadata = llmResponse.groundingMetadata;
+      }
+      if (llmResponse.citationMetadata) {
+        this.citationMetadata = llmResponse.citationMetadata;
+      }
+      if (llmResponse.finishReason) {
+        this.finishReason = llmResponse.finishReason;
+      }
       return;
     }
-    if (this.isProgressiveMode) {
-      this.flushTextBufferToSequence();
-      this.flushFunctionCallToSequence();
-      const finalParts = this.partsSequence;
-      if (finalParts.length === 0) {
-        return;
-      }
-      const candidate = this.response.candidates[0];
-      const finishReason = (_b = this.finishReason) != null ? _b : candidate.finishReason;
-      return {
-        content: {
-          role: "model",
-          parts: finalParts
-        },
-        groundingMetadata: this.groundingMetadata,
-        citationMetadata: this.citationMetadata,
-        errorCode: finishReason === FinishReason.STOP ? void 0 : finishReason,
-        errorMessage: finishReason === FinishReason.STOP ? void 0 : candidate.finishMessage,
-        usageMetadata: this.usageMetadata,
-        finishReason,
-        partial: false
-      };
+    this.response = response;
+    this.usageMetadata = llmResponse.usageMetadata;
+    if (llmResponse.groundingMetadata) {
+      this.groundingMetadata = llmResponse.groundingMetadata;
     }
-    if ((this.text || this.thoughtText) && this.response.candidates && this.response.candidates.length > 0) {
-      const parts = [];
-      if (this.thoughtText) {
-        parts.push({ text: this.thoughtText, thought: true });
-      }
-      if (this.text) {
-        parts.push({ text: this.text });
+    if (llmResponse.citationMetadata) {
+      this.citationMetadata = llmResponse.citationMetadata;
+    }
+    if (llmResponse.finishReason) {
+      this.finishReason = llmResponse.finishReason;
+    }
+    if (llmResponse.content && llmResponse.content.parts) {
+      for (const part of llmResponse.content.parts) {
+        if (part.thoughtSignature) {
+          this.lastThoughtSignature.value = part.thoughtSignature;
+        } else if (part.functionCall && this.lastThoughtSignature.value) {
+          part.thoughtSignature = this.lastThoughtSignature.value.toString();
+        }
       }
-      const candidate = this.response.candidates[0];
-      const finishReason = candidate.finishReason;
-      return {
-        content: {
-          role: "model",
-          parts
-        },
-        groundingMetadata: this.groundingMetadata,
-        citationMetadata: this.citationMetadata,
-        errorCode: finishReason === FinishReason.STOP ? void 0 : finishReason,
-        errorMessage: finishReason === FinishReason.STOP ? void 0 : candidate.finishMessage,
-        usageMetadata: this.usageMetadata,
-        finishReason,
-        partial: false
-      };
     }
-    return void 0;
+    yield* this.strategy.processResponse(llmResponse);
+  }
+  close() {
+    var _a, _b, _c;
+    const finalParts = this.strategy.close();
+    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];
+    const finishReason = (_c = this.finishReason) != null ? _c : candidate == null ? void 0 : candidate.finishReason;
+    return {
+      content: {
+        role: "model",
+        parts: finalParts != null ? finalParts : []
+      },
+      groundingMetadata: this.groundingMetadata,
+      citationMetadata: this.citationMetadata,
+      errorCode: finishReason === FinishReason.STOP ? void 0 : finishReason,
+      errorMessage: finishReason === FinishReason.STOP ? void 0 : candidate == null ? void 0 : candidate.finishMessage,
+      usageMetadata: this.usageMetadata,
+      finishReason,
+      partial: false
+    };
   }
 }
+function isEmptyContentPart(part) {
+  return !part.functionCall && !part.functionResponse && !part.fileData && !part.inlineData && !part.executableCode && !part.codeExecutionResult && (!part.text || part.text === "");
+}
 export {
-  StreamingResponseAggregator
+  StreamingResponseAggregator,
+  isEmptyContentPart
 };

package/dist/esm/utils/vertex_ai_utils.js

@@ -0,0 +1,22 @@
+import {createRequire as topLevelCreateRequire} from 'module';
+const require = topLevelCreateRequire(import.meta.url);
+/**
+ * @license
+ * Copyright 2026 Google LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import { getBooleanEnvVar } from "./env_aware_utils.js";
+function getExpressModeApiKey(project, location, expressModeApiKey) {
+  if ((project || location) && expressModeApiKey) {
+    throw new Error(
+      "Cannot specify project or location and expressModeApiKey. Either use project and location, or just the expressModeApiKey."
+    );
+  }
+  if (getBooleanEnvVar("GOOGLE_GENAI_USE_VERTEXAI")) {
+    return expressModeApiKey || process.env.GOOGLE_API_KEY;
+  }
+  return void 0;
+}
+export {
+  getExpressModeApiKey
+};

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.1.0";
+const version = "1.3.0";
 export {
   version
 };

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

@@ -16,11 +16,25 @@ export type A2AStreamEventData = Message | Task | TaskStatusUpdateEvent | TaskAr
 /**
  * Callback called before sending a request to the remote agent.
  * Allows modifying the request parameters.
+ *
+ * @param ctx - The current invocation context, providing access to session
+ *   state, agent metadata, and services.
+ * @param params - The A2A message send parameters that will be sent to the
+ *   remote agent. Mutations to this object are reflected in the outgoing
+ *   request.
+ * @returns A Promise or void. Returning a rejected Promise aborts the request.
  */
 export type BeforeA2ARequestCallback = (ctx: InvocationContext, params: MessageSendParams) => Promise<void> | void;
 /**
  * Callback called after receiving a response from the remote agent.
  * Allows inspecting or modifying the response.
+ *
+ * @param ctx - The current invocation context, providing access to session
+ *   state, agent metadata, and services.
+ * @param resp - The raw A2A stream event data received from the remote agent,
+ *   before conversion to an ADK event.
+ * @returns A Promise or void. Returning a rejected Promise stops further
+ *   processing of the response.
  */
 export type AfterA2ARequestCallback = (ctx: InvocationContext, resp: A2AStreamEventData) => Promise<void> | void;
 /**

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;