@google/adk 0.2.4 → 0.2.5

package/dist/cjs/agents/sequential_agent.js

@@ -24,7 +24,8 @@ var __copyProps = (to, from, except, desc) => {
 var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
 var sequential_agent_exports = {};
 __export(sequential_agent_exports, {
-  SequentialAgent: () => SequentialAgent
+  SequentialAgent: () => SequentialAgent,
+  isSequentialAgent: () => isSequentialAgent
 });
 module.exports = __toCommonJS(sequential_agent_exports);
 var import_function_tool = require("../tools/function_tool.js");
@@ -36,8 +37,22 @@ var import_readonly_context = require("./readonly_context.js");
  * Copyright 2025 Google LLC
  * SPDX-License-Identifier: Apache-2.0
  */
+var _a, _b;
 const TASK_COMPLETED_TOOL_NAME = "task_completed";
-class SequentialAgent extends import_base_agent.BaseAgent {
+const SEQUENTIAL_AGENT_SIGNATURE_SYMBOL = Symbol.for(
+  "google.adk.sequentialAgent"
+);
+function isSequentialAgent(obj) {
+  return typeof obj === "object" && obj !== null && SEQUENTIAL_AGENT_SIGNATURE_SYMBOL in obj && obj[SEQUENTIAL_AGENT_SIGNATURE_SYMBOL] === true;
+}
+class SequentialAgent extends (_b = import_base_agent.BaseAgent, _a = SEQUENTIAL_AGENT_SIGNATURE_SYMBOL, _b) {
+  constructor() {
+    super(...arguments);
+    /**
+     * A unique symbol to identify ADK sequential agent class.
+     */
+    this[_a] = true;
+  }
   async *runAsyncImpl(context) {
     for (const subAgent of this.subAgents) {
       for await (const event of subAgent.runAsync(context)) {
@@ -54,19 +69,25 @@ class SequentialAgent extends import_base_agent.BaseAgent {
    * the model can call this function to signal that it's finished the task and
    * we can move on to the next agent.
    *
-   * @param context: The invocation context of the agent.
+   * @param context The invocation context of the agent.
    */
   async *runLiveImpl(context) {
     for (const subAgent of this.subAgents) {
-      if (subAgent instanceof import_llm_agent.LlmAgent) {
-        const agentTools = await subAgent.canonicalTools(new import_readonly_context.ReadonlyContext(context));
-        const taskCompletedToolAlreadyAdded = agentTools.some((tool) => tool.name === TASK_COMPLETED_TOOL_NAME);
+      if ((0, import_llm_agent.isLlmAgent)(subAgent)) {
+        const agentTools = await subAgent.canonicalTools(
+          new import_readonly_context.ReadonlyContext(context)
+        );
+        const taskCompletedToolAlreadyAdded = agentTools.some(
+          (tool) => tool.name === TASK_COMPLETED_TOOL_NAME
+        );
         if (!taskCompletedToolAlreadyAdded) {
-          subAgent.tools.push(new import_function_tool.FunctionTool({
-            name: TASK_COMPLETED_TOOL_NAME,
-            description: `Signals that the model has successfully completed the user's question or task.`,
-            execute: () => "Task completion signaled."
-          }));
+          subAgent.tools.push(
+            new import_function_tool.FunctionTool({
+              name: TASK_COMPLETED_TOOL_NAME,
+              description: `Signals that the model has successfully completed the user's question or task.`,
+              execute: () => "Task completion signaled."
+            })
+          );
           subAgent.instruction += `If you finished the user's request according to its description, call the ${TASK_COMPLETED_TOOL_NAME} function to exit so the next agents can take over. When calling this function, do not generate any text other than the function call.`;
         }
       }
@@ -80,5 +101,6 @@ class SequentialAgent extends import_base_agent.BaseAgent {
 }
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {
-  SequentialAgent
+  SequentialAgent,
+  isSequentialAgent
 });

package/dist/cjs/code_executors/base_code_executor.js

@@ -24,7 +24,8 @@ var __copyProps = (to, from, except, desc) => {
 var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
 var base_code_executor_exports = {};
 __export(base_code_executor_exports, {
-  BaseCodeExecutor: () => BaseCodeExecutor
+  BaseCodeExecutor: () => BaseCodeExecutor,
+  isBaseCodeExecutor: () => isBaseCodeExecutor
 });
 module.exports = __toCommonJS(base_code_executor_exports);
 /**
@@ -32,8 +33,16 @@ module.exports = __toCommonJS(base_code_executor_exports);
  * Copyright 2025 Google LLC
  * SPDX-License-Identifier: Apache-2.0
  */
+var _a;
+const BASE_CODE_EXECUTOR_SIGNATURE_SYMBOL = Symbol.for("google.adk.baseCodeExecutor");
+function isBaseCodeExecutor(obj) {
+  return typeof obj === "object" && obj !== null && BASE_CODE_EXECUTOR_SIGNATURE_SYMBOL in obj && obj[BASE_CODE_EXECUTOR_SIGNATURE_SYMBOL] === true;
+}
+_a = BASE_CODE_EXECUTOR_SIGNATURE_SYMBOL;
 class BaseCodeExecutor {
   constructor() {
+    /** A unique symbol to identify BaseCodeExecutor class. */
+    this[_a] = true;
     /**
      * If true, extract and process data files from the model request
      * and attach them to the code executor.
@@ -72,5 +81,6 @@ class BaseCodeExecutor {
 }
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {
-  BaseCodeExecutor
+  BaseCodeExecutor,
+  isBaseCodeExecutor
 });

package/dist/cjs/code_executors/built_in_code_executor.js

@@ -24,7 +24,8 @@ var __copyProps = (to, from, except, desc) => {
 var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
 var built_in_code_executor_exports = {};
 __export(built_in_code_executor_exports, {
-  BuiltInCodeExecutor: () => BuiltInCodeExecutor
+  BuiltInCodeExecutor: () => BuiltInCodeExecutor,
+  isBuiltInCodeExecutor: () => isBuiltInCodeExecutor
 });
 module.exports = __toCommonJS(built_in_code_executor_exports);
 var import_model_name = require("../utils/model_name.js");
@@ -34,7 +35,17 @@ var import_base_code_executor = require("./base_code_executor.js");
  * Copyright 2025 Google LLC
  * SPDX-License-Identifier: Apache-2.0
  */
-class BuiltInCodeExecutor extends import_base_code_executor.BaseCodeExecutor {
+var _a, _b;
+const BUILT_IN_CODE_EXECUTOR_SIGNATURE_SYMBOL = Symbol.for("google.adk.builtInCodeExecutor");
+function isBuiltInCodeExecutor(obj) {
+  return typeof obj === "object" && obj !== null && BUILT_IN_CODE_EXECUTOR_SIGNATURE_SYMBOL in obj && obj[BUILT_IN_CODE_EXECUTOR_SIGNATURE_SYMBOL] === true;
+}
+class BuiltInCodeExecutor extends (_b = import_base_code_executor.BaseCodeExecutor, _a = BUILT_IN_CODE_EXECUTOR_SIGNATURE_SYMBOL, _b) {
+  constructor() {
+    super(...arguments);
+    /** A unique symbol to identify BuiltInCodeExecutor class. */
+    this[_a] = true;
+  }
   executeCode(params) {
     return Promise.resolve({
       stdout: "",
@@ -54,5 +65,6 @@ class BuiltInCodeExecutor extends import_base_code_executor.BaseCodeExecutor {
 }
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {
-  BuiltInCodeExecutor
+  BuiltInCodeExecutor,
+  isBuiltInCodeExecutor
 });

package/dist/cjs/common.js

@@ -25,9 +25,15 @@ var __reExport = (target, mod, secondTarget) => (__copyProps(target, mod, "defau
 var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
 var common_exports = {};
 __export(common_exports, {
+  ActiveStreamingTool: () => import_active_streaming_tool.ActiveStreamingTool,
   AgentTool: () => import_agent_tool.AgentTool,
+  AuthCredentialTypes: () => import_auth_credential.AuthCredentialTypes,
   BaseAgent: () => import_base_agent.BaseAgent,
+  BaseCodeExecutor: () => import_base_code_executor.BaseCodeExecutor,
+  BaseExampleProvider: () => import_base_example_provider.BaseExampleProvider,
   BaseLlm: () => import_base_llm.BaseLlm,
+  BaseLlmRequestProcessor: () => import_base_llm_processor.BaseLlmRequestProcessor,
+  BaseLlmResponseProcessor: () => import_base_llm_processor.BaseLlmResponseProcessor,
   BasePlugin: () => import_base_plugin.BasePlugin,
   BaseTool: () => import_base_tool.BaseTool,
   BaseToolset: () => import_base_toolset.BaseToolset,
@@ -36,6 +42,8 @@ __export(common_exports, {
   FunctionTool: () => import_function_tool.FunctionTool,
   GOOGLE_SEARCH: () => import_google_search_tool.GOOGLE_SEARCH,
   Gemini: () => import_google_llm.Gemini,
+  GoogleLLMVariant: () => import_variant_utils.GoogleLLMVariant,
+  GoogleSearchTool: () => import_google_search_tool.GoogleSearchTool,
   InMemoryArtifactService: () => import_in_memory_artifact_service.InMemoryArtifactService,
   InMemoryMemoryService: () => import_in_memory_memory_service.InMemoryMemoryService,
   InMemoryPolicyEngine: () => import_security_plugin.InMemoryPolicyEngine,
@@ -53,6 +61,7 @@ __export(common_exports, {
   PluginManager: () => import_plugin_manager.PluginManager,
   PolicyOutcome: () => import_security_plugin.PolicyOutcome,
   REQUEST_CONFIRMATION_FUNCTION_CALL_NAME: () => import_security_plugin.REQUEST_CONFIRMATION_FUNCTION_CALL_NAME,
+  ReadonlyContext: () => import_readonly_context.ReadonlyContext,
   Runner: () => import_runner.Runner,
   SecurityPlugin: () => import_security_plugin.SecurityPlugin,
   SequentialAgent: () => import_sequential_agent.SequentialAgent,
@@ -68,17 +77,27 @@ __export(common_exports, {
   getFunctionCalls: () => import_event.getFunctionCalls,
   getFunctionResponses: () => import_event.getFunctionResponses,
   hasTrailingCodeExecutionResult: () => import_event.hasTrailingCodeExecutionResult,
+  isAgentTool: () => import_agent_tool.isAgentTool,
   isBaseAgent: () => import_base_agent.isBaseAgent,
+  isBaseExampleProvider: () => import_base_example_provider.isBaseExampleProvider,
   isBaseLlm: () => import_base_llm.isBaseLlm,
+  isBaseTool: () => import_base_tool.isBaseTool,
   isFinalResponse: () => import_event.isFinalResponse,
+  isFunctionTool: () => import_function_tool.isFunctionTool,
   isGemini2OrAbove: () => import_model_name.isGemini2OrAbove,
+  isLlmAgent: () => import_llm_agent.isLlmAgent,
+  isLoopAgent: () => import_loop_agent.isLoopAgent,
+  isParallelAgent: () => import_parallel_agent.isParallelAgent,
+  isSequentialAgent: () => import_sequential_agent.isSequentialAgent,
   setLogLevel: () => import_logger.setLogLevel,
   stringifyContent: () => import_event.stringifyContent,
   version: () => import_version.version,
   zodObjectToSchema: () => import_simple_zod_to_json.zodObjectToSchema
 });
 module.exports = __toCommonJS(common_exports);
+var import_active_streaming_tool = require("./agents/active_streaming_tool.js");
 var import_base_agent = require("./agents/base_agent.js");
+var import_base_llm_processor = require("./agents/base_llm_processor.js");
 var import_callback_context = require("./agents/callback_context.js");
 var import_functions = require("./agents/functions.js");
 var import_invocation_context = require("./agents/invocation_context.js");
@@ -86,12 +105,16 @@ var import_live_request_queue = require("./agents/live_request_queue.js");
 var import_llm_agent = require("./agents/llm_agent.js");
 var import_loop_agent = require("./agents/loop_agent.js");
 var import_parallel_agent = require("./agents/parallel_agent.js");
+var import_readonly_context = require("./agents/readonly_context.js");
 var import_run_config = require("./agents/run_config.js");
 var import_sequential_agent = require("./agents/sequential_agent.js");
 var import_in_memory_artifact_service = require("./artifacts/in_memory_artifact_service.js");
+var import_auth_credential = require("./auth/auth_credential.js");
+var import_base_code_executor = require("./code_executors/base_code_executor.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_base_example_provider = require("./examples/base_example_provider.js");
 var import_in_memory_memory_service = require("./memory/in_memory_memory_service.js");
 var import_base_llm = require("./models/base_llm.js");
 var import_google_llm = require("./models/google_llm.js");
@@ -116,6 +139,7 @@ var import_tool_context = require("./tools/tool_context.js");
 var import_logger = require("./utils/logger.js");
 var import_model_name = require("./utils/model_name.js");
 var import_simple_zod_to_json = require("./utils/simple_zod_to_json.js");
+var import_variant_utils = require("./utils/variant_utils.js");
 var import_version = require("./version.js");
 __reExport(common_exports, require("./artifacts/base_artifact_service.js"), module.exports);
 __reExport(common_exports, require("./memory/base_memory_service.js"), module.exports);
@@ -128,9 +152,15 @@ __reExport(common_exports, require("./tools/base_tool.js"), module.exports);
  */
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {
+  ActiveStreamingTool,
   AgentTool,
+  AuthCredentialTypes,
   BaseAgent,
+  BaseCodeExecutor,
+  BaseExampleProvider,
   BaseLlm,
+  BaseLlmRequestProcessor,
+  BaseLlmResponseProcessor,
   BasePlugin,
   BaseTool,
   BaseToolset,
@@ -139,6 +169,8 @@ __reExport(common_exports, require("./tools/base_tool.js"), module.exports);
   FunctionTool,
   GOOGLE_SEARCH,
   Gemini,
+  GoogleLLMVariant,
+  GoogleSearchTool,
   InMemoryArtifactService,
   InMemoryMemoryService,
   InMemoryPolicyEngine,
@@ -156,6 +188,7 @@ __reExport(common_exports, require("./tools/base_tool.js"), module.exports);
   PluginManager,
   PolicyOutcome,
   REQUEST_CONFIRMATION_FUNCTION_CALL_NAME,
+  ReadonlyContext,
   Runner,
   SecurityPlugin,
   SequentialAgent,
@@ -171,10 +204,18 @@ __reExport(common_exports, require("./tools/base_tool.js"), module.exports);
   getFunctionCalls,
   getFunctionResponses,
   hasTrailingCodeExecutionResult,
+  isAgentTool,
   isBaseAgent,
+  isBaseExampleProvider,
   isBaseLlm,
+  isBaseTool,
   isFinalResponse,
+  isFunctionTool,
   isGemini2OrAbove,
+  isLlmAgent,
+  isLoopAgent,
+  isParallelAgent,
+  isSequentialAgent,
   setLogLevel,
   stringifyContent,
   version,

package/dist/cjs/examples/base_example_provider.js

@@ -24,7 +24,8 @@ var __copyProps = (to, from, except, desc) => {
 var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
 var base_example_provider_exports = {};
 __export(base_example_provider_exports, {
-  BaseExampleProvider: () => BaseExampleProvider
+  BaseExampleProvider: () => BaseExampleProvider,
+  isBaseExampleProvider: () => isBaseExampleProvider
 });
 module.exports = __toCommonJS(base_example_provider_exports);
 /**
@@ -32,9 +33,24 @@ module.exports = __toCommonJS(base_example_provider_exports);
  * Copyright 2025 Google LLC
  * SPDX-License-Identifier: Apache-2.0
  */
+var _a;
+const BASE_EXAMPLE_PROVIDER_SIGNATURE_SYMBOL = Symbol.for(
+  "google.adk.baseExampleProvider"
+);
+function isBaseExampleProvider(obj) {
+  return typeof obj === "object" && obj !== null && BASE_EXAMPLE_PROVIDER_SIGNATURE_SYMBOL in obj && obj[BASE_EXAMPLE_PROVIDER_SIGNATURE_SYMBOL] === true;
+}
+_a = BASE_EXAMPLE_PROVIDER_SIGNATURE_SYMBOL;
 class BaseExampleProvider {
+  constructor() {
+    /**
+     * A unique symbol to identify ADK example provider classes.
+     */
+    this[_a] = true;
+  }
 }
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {
-  BaseExampleProvider
+  BaseExampleProvider,
+  isBaseExampleProvider
 });

package/dist/cjs/examples/example_util.js

@@ -95,7 +95,7 @@ function buildExampleSi(examples, query, model) {
   if (Array.isArray(examples)) {
     return convertExamplesToText(examples, model);
   }
-  if (examples instanceof import_base_example_provider.BaseExampleProvider) {
+  if ((0, import_base_example_provider.isBaseExampleProvider)(examples)) {
     return convertExamplesToText(examples.getExamples(query), model);
   }
   throw new Error("Invalid example configuration");