@google/adk 0.2.1 → 0.2.3

package/dist/cjs/models/base_llm.js

@@ -24,7 +24,8 @@ var __copyProps = (to, from, except, desc) => {
 var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
 var base_llm_exports = {};
 __export(base_llm_exports, {
-  BaseLlm: () => BaseLlm
+  BaseLlm: () => BaseLlm,
+  isBaseLlm: () => isBaseLlm
 });
 module.exports = __toCommonJS(base_llm_exports);
 var import_client_labels = require("../utils/client_labels.js");
@@ -33,6 +34,12 @@ var import_client_labels = require("../utils/client_labels.js");
  * Copyright 2025 Google LLC
  * SPDX-License-Identifier: Apache-2.0
  */
+var _a;
+const BASE_MODEL_SYMBOL = Symbol.for("google.adk.baseModel");
+function isBaseLlm(obj) {
+  return typeof obj === "object" && obj !== null && BASE_MODEL_SYMBOL in obj && obj[BASE_MODEL_SYMBOL] === true;
+}
+_a = BASE_MODEL_SYMBOL;
 class BaseLlm {
   /**
    * Creates an instance of BaseLLM.
@@ -41,6 +48,10 @@ class BaseLlm {
    *     gemini-1.5-flash-001.
    */
   constructor({ model }) {
+    /**
+     * A unique symbol to identify BaseLlm classes.
+     */
+    this[_a] = true;
     this.model = model;
   }
   get trackingHeaders() {
@@ -57,7 +68,7 @@ class BaseLlm {
    * @param llmRequest LlmRequest, the request to send to the LLM.
    */
   maybeAppendUserContent(llmRequest) {
-    var _a;
+    var _a2;
     if (llmRequest.contents.length === 0) {
       llmRequest.contents.push({
         role: "user",
@@ -66,7 +77,7 @@ class BaseLlm {
         ]
       });
     }
-    if (((_a = llmRequest.contents[llmRequest.contents.length - 1]) == null ? void 0 : _a.role) !== "user") {
+    if (((_a2 = llmRequest.contents[llmRequest.contents.length - 1]) == null ? void 0 : _a2.role) !== "user") {
       llmRequest.contents.push({
         role: "user",
         parts: [{
@@ -82,5 +93,6 @@ class BaseLlm {
 BaseLlm.supportedModels = [];
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {
-  BaseLlm
+  BaseLlm,
+  isBaseLlm
 });

package/dist/cjs/runner/runner.js

@@ -32,6 +32,7 @@ var import_api = require("@opentelemetry/api");
 var import_invocation_context = require("../agents/invocation_context.js");
 var import_llm_agent = require("../agents/llm_agent.js");
 var import_run_config = require("../agents/run_config.js");
+var import_built_in_code_executor = require("../code_executors/built_in_code_executor.js");
 var import_event = require("../events/event.js");
 var import_event_actions = require("../events/event_actions.js");
 var import_plugin_manager = require("../plugins/plugin_manager.js");
@@ -77,6 +78,11 @@ class Runner {
     try {
       const session = await this.sessionService.getSession({ appName: this.appName, userId, sessionId });
       if (!session) {
+        if (!this.appName) {
+          throw new Error(
+            `Session lookup failed: appName must be provided in runner constructor`
+          );
+        }
         throw new Error(`Session not found: ${sessionId}`);
       }
       if (runConfig.supportCfc && this.agent instanceof import_llm_agent.LlmAgent) {
@@ -85,6 +91,9 @@ class Runner {
           throw new Error(`CFC is not supported for model: ${modelName} in agent: ${this.agent.name}`);
         }
       }
+      if (this.agent instanceof import_llm_agent.LlmAgent && !(this.agent.codeExecutor instanceof import_built_in_code_executor.BuiltInCodeExecutor)) {
+        this.agent.codeExecutor = new import_built_in_code_executor.BuiltInCodeExecutor();
+      }
       const invocationContext = new import_invocation_context.InvocationContext({
         artifactService: this.artifactService,
         sessionService: this.sessionService,
@@ -106,7 +115,7 @@ class Runner {
       }
       if (newMessage) {
         if (!((_a = newMessage.parts) == null ? void 0 : _a.length)) {
-          throw new Error("No parts in the new_message.");
+          throw new Error("No parts in the newMessage.");
         }
         if (runConfig.saveInputBlobsAsArtifacts) {
           await this.saveArtifacts(

package/dist/cjs/sessions/in_memory_session_service.js

@@ -5,9 +5,11 @@
   */
 
 "use strict";
+var __create = Object.create;
 var __defProp = Object.defineProperty;
 var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
 var __getOwnPropNames = Object.getOwnPropertyNames;
+var __getProtoOf = Object.getPrototypeOf;
 var __hasOwnProp = Object.prototype.hasOwnProperty;
 var __export = (target, all) => {
   for (var name in all)
@@ -21,13 +23,21 @@ var __copyProps = (to, from, except, desc) => {
   }
   return to;
 };
+var __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__getProtoOf(mod)) : {}, __copyProps(
+  // If the importer is in node compatibility mode or this is not an ESM
+  // file that has been converted to a CommonJS file using a Babel-
+  // compatible transform (i.e. "__esModule" has not been set), then set
+  // "default" to the CommonJS "module.exports" for node compatibility.
+  isNodeMode || !mod || !mod.__esModule ? __defProp(target, "default", { value: mod, enumerable: true }) : target,
+  mod
+));
 var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
 var in_memory_session_service_exports = {};
 __export(in_memory_session_service_exports, {
   InMemorySessionService: () => InMemorySessionService
 });
 module.exports = __toCommonJS(in_memory_session_service_exports);
-var import_deep_clone = require("../utils/deep_clone.js");
+var import_cloneDeep = __toESM(require("lodash-es/cloneDeep.js"), 1);
 var import_env_aware_utils = require("../utils/env_aware_utils.js");
 var import_logger = require("../utils/logger.js");
 var import_base_session_service = require("./base_session_service.js");
@@ -72,7 +82,7 @@ class InMemorySessionService extends import_base_session_service.BaseSessionServ
     }
     this.sessions[appName][userId][session.id] = session;
     return Promise.resolve(
-      this.mergeState(appName, userId, (0, import_deep_clone.deepClone)(session))
+      this.mergeState(appName, userId, (0, import_cloneDeep.default)(session))
     );
   }
   getSession({ appName, userId, sessionId, config }) {
@@ -80,7 +90,7 @@ class InMemorySessionService extends import_base_session_service.BaseSessionServ
       return Promise.resolve(void 0);
     }
     const session = this.sessions[appName][userId][sessionId];
-    const copiedSession = (0, import_deep_clone.deepClone)(session);
+    const copiedSession = (0, import_cloneDeep.default)(session);
     if (config) {
       if (config.numRecentEvents) {
         copiedSession.events = copiedSession.events.slice(-config.numRecentEvents);

package/dist/cjs/sessions/state.js

@@ -33,7 +33,7 @@ module.exports = __toCommonJS(state_exports);
  * SPDX-License-Identifier: Apache-2.0
  */
 class State {
-  constructor(value, delta) {
+  constructor(value = {}, delta = {}) {
     this.value = value;
     this.delta = delta;
   }

package/dist/cjs/tools/agent_tool.js

@@ -124,8 +124,8 @@ class AgentTool extends import_base_tool.BaseTool {
       return "";
     }
     const hasOutputSchema = this.agent instanceof import_llm_agent.LlmAgent && this.agent.outputSchema;
-    const mergetText = lastEvent.content.parts.map((part) => part.text).filter((text) => text).join("\n");
-    return hasOutputSchema ? JSON.parse(mergetText) : mergetText;
+    const mergedText = lastEvent.content.parts.map((part) => part.text).filter((text) => text).join("\n");
+    return hasOutputSchema ? JSON.parse(mergedText) : mergedText;
   }
 }
 // Annotate the CommonJS export names for ESM import in node:

package/dist/cjs/tools/mcp/mcp_session_manager.js

@@ -48,8 +48,14 @@ class MCPSessionManager {
         );
         break;
       case "StreamableHTTPConnectionParams":
+        const transportOptions = this.connectionParams.header ? {
+          requestInit: {
+            headers: this.connectionParams.header
+          }
+        } : void 0;
         await client.connect(new import_streamableHttp.StreamableHTTPClientTransport(
-          new URL(this.connectionParams.url)
+          new URL(this.connectionParams.url),
+          transportOptions
         ));
         break;
       default:

package/dist/cjs/utils/gemini_schema_util.js

@@ -63,6 +63,22 @@ function toGeminiSchema(mcpSchema) {
     return void 0;
   }
   function recursiveConvert(mcp) {
+    if (!mcp.type && mcp.anyOf && Array.isArray(mcp.anyOf)) {
+      const nonNullOption = mcp.anyOf.find((opt) => {
+        const t = opt.type;
+        return t !== "null" && t !== "NULL";
+      });
+      if (nonNullOption) {
+        mcp = nonNullOption;
+      }
+    }
+    if (!mcp.type) {
+      if (mcp.properties || mcp.$ref) {
+        mcp.type = "object";
+      } else if (mcp.items) {
+        mcp.type = "array";
+      }
+    }
     const geminiType = toGeminiType(mcp.type);
     const geminiSchema = { type: geminiType, description: mcp.description };
     if (geminiType === import_genai.Type.OBJECT) {

package/dist/cjs/utils/model_name.js

@@ -26,7 +26,7 @@ var model_name_exports = {};
 __export(model_name_exports, {
   extractModelName: () => extractModelName,
   isGemini1Model: () => isGemini1Model,
-  isGemini2Model: () => isGemini2Model,
+  isGemini2OrAbove: () => isGemini2OrAbove,
   isGeminiModel: () => isGeminiModel
 });
 module.exports = __toCommonJS(model_name_exports);
@@ -47,18 +47,38 @@ function isGeminiModel(modelString) {
   const modelName = extractModelName(modelString);
   return modelName.startsWith("gemini-");
 }
+function parseVersion(versionString) {
+  if (!/^\d+(\.\d+)*$/.test(versionString)) {
+    return { valid: false, major: 0, minor: 0, patch: 0 };
+  }
+  const parts = versionString.split(".").map((part) => parseInt(part, 10));
+  return {
+    valid: true,
+    major: parts[0],
+    minor: parts.length > 1 ? parts[1] : 0,
+    patch: parts.length > 2 ? parts[2] : 0
+  };
+}
 function isGemini1Model(modelString) {
   const modelName = extractModelName(modelString);
   return modelName.startsWith("gemini-1");
 }
-function isGemini2Model(modelString) {
+function isGemini2OrAbove(modelString) {
+  if (!modelString) {
+    return false;
+  }
   const modelName = extractModelName(modelString);
-  return modelName.startsWith("gemini-2");
+  if (!modelName.startsWith("gemini-")) {
+    return false;
+  }
+  const versionString = modelName.slice("gemini-".length).split("-", 1)[0];
+  const parsedVersion = parseVersion(versionString);
+  return parsedVersion.valid && parsedVersion.major >= 2;
 }
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {
   extractModelName,
   isGemini1Model,
-  isGemini2Model,
+  isGemini2OrAbove,
   isGeminiModel
 });

package/dist/cjs/version.js

@@ -32,7 +32,7 @@ module.exports = __toCommonJS(version_exports);
  * Copyright 2025 Google LLC
  * SPDX-License-Identifier: Apache-2.0
  */
-const version = "0.2.1";
+const version = "0.2.3";
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {
   version

package/dist/esm/agents/base_agent.js

@@ -3,12 +3,22 @@
  * Copyright 2025 Google LLC
  * SPDX-License-Identifier: Apache-2.0
  */
+var _a;
 import { trace } from "@opentelemetry/api";
 import { createEvent } from "../events/event.js";
 import { CallbackContext } from "./callback_context.js";
 import { InvocationContext } from "./invocation_context.js";
+const BASE_AGENT_SIGNATURE_SYMBOL = Symbol.for("google.adk.baseAgent");
+function isBaseAgent(obj) {
+  return typeof obj === "object" && obj !== null && BASE_AGENT_SIGNATURE_SYMBOL in obj && obj[BASE_AGENT_SIGNATURE_SYMBOL] === true;
+}
+_a = BASE_AGENT_SIGNATURE_SYMBOL;
 class BaseAgent {
   constructor(config) {
+    /**
+     * A unique symbol to identify ADK agent classes.
+     */
+    this[_a] = true;
     this.name = validateAgentName(config.name);
     this.description = config.description;
     this.parentAgent = config.parentAgent;
@@ -210,5 +220,6 @@ function getCannonicalCallback(callbacks) {
 }
 export {
   BaseAgent,
-  getCannonicalCallback
+  getCannonicalCallback,
+  isBaseAgent
 };

package/dist/esm/agents/content_processor_utils.js

@@ -3,8 +3,8 @@
  * Copyright 2025 Google LLC
  * SPDX-License-Identifier: Apache-2.0
  */
+import cloneDeep from "lodash-es/cloneDeep.js";
 import { createEvent, getFunctionCalls, getFunctionResponses } from "../events/event.js";
-import { deepClone } from "../utils/deep_clone.js";
 import { removeClientFunctionCallId, REQUEST_CONFIRMATION_FUNCTION_CALL_NAME, REQUEST_EUC_FUNCTION_CALL_NAME } from "./functions.js";
 function getContents(events, agentName, currentBranch) {
   var _a, _b, _c;
@@ -30,7 +30,7 @@ function getContents(events, agentName, currentBranch) {
   resultEvents = rearrangeEventsForAsyncFunctionResponsesInHistory(resultEvents);
   const contents = [];
   for (const event of resultEvents) {
-    const content = deepClone(event.content);
+    const content = cloneDeep(event.content);
     removeClientFunctionCallId(content);
     contents.push(content);
   }

package/dist/esm/agents/functions.js

@@ -4,6 +4,7 @@
  * SPDX-License-Identifier: Apache-2.0
  */
 import { createUserContent } from "@google/genai";
+import isEmpty from "lodash-es/isEmpty.js";
 import { createEvent, getFunctionCalls } from "../events/event.js";
 import { mergeEventActions } from "../events/event_actions.js";
 import { ToolContext } from "../tools/tool_context.js";
@@ -13,7 +14,9 @@ const AF_FUNCTION_CALL_ID_PREFIX = "adk-";
 const REQUEST_EUC_FUNCTION_CALL_NAME = "adk_request_credential";
 const REQUEST_CONFIRMATION_FUNCTION_CALL_NAME = "adk_request_confirmation";
 const functionsExportedForTestingOnly = {
-  handleFunctionCallList
+  handleFunctionCallList,
+  generateAuthEvent,
+  generateRequestConfirmationEvent
 };
 function generateClientFunctionCallId() {
   return `${AF_FUNCTION_CALL_ID_PREFIX}${randomUUID()}`;
@@ -52,7 +55,7 @@ function getLongRunningFunctionCalls(functionCalls, toolsDict) {
 }
 function generateAuthEvent(invocationContext, functionResponseEvent) {
   var _a;
-  if (!((_a = functionResponseEvent.actions) == null ? void 0 : _a.requestedAuthConfigs)) {
+  if (!((_a = functionResponseEvent.actions) == null ? void 0 : _a.requestedAuthConfigs) || isEmpty(functionResponseEvent.actions.requestedAuthConfigs)) {
     return void 0;
   }
   const parts = [];
@@ -88,7 +91,7 @@ function generateRequestConfirmationEvent({
   functionResponseEvent
 }) {
   var _a, _b;
-  if (!((_a = functionResponseEvent.actions) == null ? void 0 : _a.requestedToolConfirmations)) {
+  if (!((_a = functionResponseEvent.actions) == null ? void 0 : _a.requestedToolConfirmations) || isEmpty(functionResponseEvent.actions.requestedToolConfirmations)) {
     return;
   }
   const parts = [];