@google/adk 1.2.0 → 1.3.0

package/dist/web/utils/live_connection_utils.js

@@ -0,0 +1,254 @@
+import {createRequire as topLevelCreateRequire} from 'module';
+const require = topLevelCreateRequire(import.meta.url);
+var __defProp = Object.defineProperty;
+var __getOwnPropSymbols = Object.getOwnPropertySymbols;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __propIsEnum = Object.prototype.propertyIsEnumerable;
+var __defNormalProp = (obj, key, value) => key in obj ? __defProp(obj, key, { enumerable: true, configurable: true, writable: true, value }) : obj[key] = value;
+var __spreadValues = (a, b) => {
+  for (var prop in b || (b = {}))
+    if (__hasOwnProp.call(b, prop))
+      __defNormalProp(a, prop, b[prop]);
+  if (__getOwnPropSymbols)
+    for (var prop of __getOwnPropSymbols(b)) {
+      if (__propIsEnum.call(b, prop))
+        __defNormalProp(a, prop, b[prop]);
+    }
+  return a;
+};
+/**
+ * @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 __spreadValues({
+        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 __spreadValues(__spreadValues({
+          groundingMetadata: serverContent.groundingMetadata
+        }, serverContent.interrupted !== void 0 ? { interrupted: serverContent.interrupted } : {}), this.modelVersion ? { modelVersion: this.modelVersion } : {});
+      }
+      if (content && content.parts) {
+        const llmResponse = __spreadValues(__spreadValues({
+          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 __spreadValues({
+            inputTranscription: {
+              text: serverContent.inputTranscription.text,
+              finished: false
+            },
+            partial: true
+          }, this.modelVersion ? { modelVersion: this.modelVersion } : {});
+        }
+        if (serverContent.inputTranscription.finished) {
+          yield __spreadValues({
+            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 __spreadValues({
+            outputTranscription: {
+              text: serverContent.outputTranscription.text,
+              finished: false
+            },
+            partial: true
+          }, this.modelVersion ? { modelVersion: this.modelVersion } : {});
+        }
+        if (serverContent.outputTranscription.finished) {
+          yield __spreadValues({
+            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 __spreadValues({
+            inputTranscription: {
+              text: this.inputTranscriptionText,
+              finished: true
+            },
+            partial: false
+          }, this.modelVersion ? { modelVersion: this.modelVersion } : {});
+          this.inputTranscriptionText = "";
+        }
+        if (this.outputTranscriptionText) {
+          yield __spreadValues({
+            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 __spreadValues({
+            content: { role: "model", parts: this.toolCallParts }
+          }, this.modelVersion ? { modelVersion: this.modelVersion } : {});
+          this.toolCallParts = [];
+        }
+        const finalResponse = __spreadValues({
+          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 __spreadValues({
+            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 __spreadValues({
+          content: { role: "model", parts: this.toolCallParts }
+        }, this.modelVersion ? { modelVersion: this.modelVersion } : {});
+        this.toolCallParts = [];
+      }
+    }
+    if (message.sessionResumptionUpdate) {
+      yield __spreadValues({
+        liveSessionResumptionUpdate: message.sessionResumptionUpdate
+      }, this.modelVersion ? { modelVersion: this.modelVersion } : {});
+    }
+    if (message.goAway) {
+      yield __spreadValues({
+        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 __spreadValues({
+        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/web/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/web/utils/streaming_utils.js

@@ -78,6 +78,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 = [];
@@ -144,10 +145,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];
@@ -342,7 +346,6 @@ class StreamingResponseAggregator {
   )) {
     this.isProgressiveMode = isProgressiveMode;
     this.lastThoughtSignature = {};
-    this.sawFunctionCall = false;
     this.strategy = this.isProgressiveMode ? new ProgressiveStrategy() : new NonProgressiveStrategy();
   }
   processResponse(response) {
@@ -350,10 +353,7 @@ class StreamingResponseAggregator {
       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;
         }
@@ -394,7 +394,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];
@@ -402,7 +403,7 @@ class StreamingResponseAggregator {
     return {
       content: {
         role: "model",
-        parts: finalParts
+        parts: finalParts != null ? finalParts : []
       },
       groundingMetadata: this.groundingMetadata,
       citationMetadata: this.citationMetadata,

package/dist/web/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/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@google/adk",
-  "version": "1.2.0",
+  "version": "1.3.0",
   "description": "Google ADK JS",
   "author": "Google",
   "license": "Apache-2.0",
@@ -60,6 +60,7 @@
     "@opentelemetry/sdk-metrics": "^2.1.0",
     "@opentelemetry/sdk-trace-base": "^2.1.0",
     "@opentelemetry/sdk-trace-node": "^2.1.0",
+    "adm-zip": "^0.5.17",
     "express": "^4.22.1",
     "google-auth-library": "^10.3.0",
     "js-yaml": "^4.1.1",
@@ -71,6 +72,7 @@
   },
   "devDependencies": {
     "@mikro-orm/sqlite": "^6.6.6",
+    "@types/adm-zip": "^0.5.8",
     "@types/express": "^4.17.25",
     "@types/lodash-es": "^4.17.12",
     "openapi-types": "^12.1.3"