@google/adk 0.2.4 → 0.2.5

package/dist/esm/agents/sequential_agent.js

@@ -3,12 +3,26 @@
  * Copyright 2025 Google LLC
  * SPDX-License-Identifier: Apache-2.0
  */
+var _a, _b;
 import { FunctionTool } from "../tools/function_tool.js";
 import { BaseAgent } from "./base_agent.js";
-import { LlmAgent } from "./llm_agent.js";
+import { isLlmAgent } from "./llm_agent.js";
 import { ReadonlyContext } from "./readonly_context.js";
 const TASK_COMPLETED_TOOL_NAME = "task_completed";
-class SequentialAgent extends 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 = 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)) {
@@ -25,19 +39,25 @@ class SequentialAgent extends 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 LlmAgent) {
-        const agentTools = await subAgent.canonicalTools(new ReadonlyContext(context));
-        const taskCompletedToolAlreadyAdded = agentTools.some((tool) => tool.name === TASK_COMPLETED_TOOL_NAME);
+      if (isLlmAgent(subAgent)) {
+        const agentTools = await subAgent.canonicalTools(
+          new ReadonlyContext(context)
+        );
+        const taskCompletedToolAlreadyAdded = agentTools.some(
+          (tool) => tool.name === TASK_COMPLETED_TOOL_NAME
+        );
         if (!taskCompletedToolAlreadyAdded) {
-          subAgent.tools.push(new 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 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.`;
         }
       }
@@ -50,5 +70,6 @@ class SequentialAgent extends BaseAgent {
   }
 }
 export {
-  SequentialAgent
+  SequentialAgent,
+  isSequentialAgent
 };

package/dist/esm/code_executors/base_code_executor.js

@@ -3,8 +3,16 @@
  * 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.
@@ -42,5 +50,6 @@ class BaseCodeExecutor {
   }
 }
 export {
-  BaseCodeExecutor
+  BaseCodeExecutor,
+  isBaseCodeExecutor
 };

package/dist/esm/code_executors/built_in_code_executor.js

@@ -3,9 +3,19 @@
  * Copyright 2025 Google LLC
  * SPDX-License-Identifier: Apache-2.0
  */
+var _a, _b;
 import { isGemini2OrAbove } from "../utils/model_name.js";
 import { BaseCodeExecutor } from "./base_code_executor.js";
-class BuiltInCodeExecutor extends BaseCodeExecutor {
+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 = 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: "",
@@ -24,5 +34,6 @@ class BuiltInCodeExecutor extends BaseCodeExecutor {
   }
 }
 export {
-  BuiltInCodeExecutor
+  BuiltInCodeExecutor,
+  isBuiltInCodeExecutor
 };

package/dist/esm/common.js

@@ -3,20 +3,39 @@
  * Copyright 2025 Google LLC
  * SPDX-License-Identifier: Apache-2.0
  */
+import { ActiveStreamingTool } from "./agents/active_streaming_tool.js";
 import { BaseAgent, isBaseAgent } from "./agents/base_agent.js";
+import {
+  BaseLlmRequestProcessor,
+  BaseLlmResponseProcessor
+} from "./agents/base_llm_processor.js";
 import { CallbackContext } from "./agents/callback_context.js";
 import { functionsExportedForTestingOnly } from "./agents/functions.js";
 import { InvocationContext } from "./agents/invocation_context.js";
 import { LiveRequestQueue } from "./agents/live_request_queue.js";
-import { LlmAgent } from "./agents/llm_agent.js";
-import { LoopAgent } from "./agents/loop_agent.js";
-import { ParallelAgent } from "./agents/parallel_agent.js";
+import { LlmAgent, isLlmAgent } from "./agents/llm_agent.js";
+import { LoopAgent, isLoopAgent } from "./agents/loop_agent.js";
+import { ParallelAgent, isParallelAgent } from "./agents/parallel_agent.js";
+import { ReadonlyContext } from "./agents/readonly_context.js";
 import { StreamingMode } from "./agents/run_config.js";
-import { SequentialAgent } from "./agents/sequential_agent.js";
+import { SequentialAgent, isSequentialAgent } from "./agents/sequential_agent.js";
 import { InMemoryArtifactService } from "./artifacts/in_memory_artifact_service.js";
+import { AuthCredentialTypes } from "./auth/auth_credential.js";
+import { BaseCodeExecutor } from "./code_executors/base_code_executor.js";
 import { BuiltInCodeExecutor } from "./code_executors/built_in_code_executor.js";
-import { createEvent, getFunctionCalls, getFunctionResponses, hasTrailingCodeExecutionResult, isFinalResponse, stringifyContent } from "./events/event.js";
+import {
+  createEvent,
+  getFunctionCalls,
+  getFunctionResponses,
+  hasTrailingCodeExecutionResult,
+  isFinalResponse,
+  stringifyContent
+} from "./events/event.js";
 import { createEventActions } from "./events/event_actions.js";
+import {
+  BaseExampleProvider,
+  isBaseExampleProvider
+} from "./examples/base_example_provider.js";
 import { InMemoryMemoryService } from "./memory/in_memory_memory_service.js";
 import { BaseLlm, isBaseLlm } from "./models/base_llm.js";
 import { Gemini } from "./models/google_llm.js";
@@ -24,32 +43,45 @@ import { LLMRegistry } from "./models/registry.js";
 import { BasePlugin } from "./plugins/base_plugin.js";
 import { LoggingPlugin } from "./plugins/logging_plugin.js";
 import { PluginManager } from "./plugins/plugin_manager.js";
-import { getAskUserConfirmationFunctionCalls, InMemoryPolicyEngine, PolicyOutcome, REQUEST_CONFIRMATION_FUNCTION_CALL_NAME, SecurityPlugin } from "./plugins/security_plugin.js";
+import {
+  InMemoryPolicyEngine,
+  PolicyOutcome,
+  REQUEST_CONFIRMATION_FUNCTION_CALL_NAME,
+  SecurityPlugin,
+  getAskUserConfirmationFunctionCalls
+} from "./plugins/security_plugin.js";
 import { InMemoryRunner } from "./runner/in_memory_runner.js";
 import { Runner } from "./runner/runner.js";
 import { InMemorySessionService } from "./sessions/in_memory_session_service.js";
 import { createSession } from "./sessions/session.js";
 import { State } from "./sessions/state.js";
-import { AgentTool } from "./tools/agent_tool.js";
-import { BaseTool } from "./tools/base_tool.js";
+import { AgentTool, isAgentTool } from "./tools/agent_tool.js";
+import { BaseTool, isBaseTool } from "./tools/base_tool.js";
 import { BaseToolset } from "./tools/base_toolset.js";
-import { FunctionTool } from "./tools/function_tool.js";
-import { GOOGLE_SEARCH } from "./tools/google_search_tool.js";
+import { FunctionTool, isFunctionTool } from "./tools/function_tool.js";
+import { GOOGLE_SEARCH, GoogleSearchTool } from "./tools/google_search_tool.js";
 import { LongRunningFunctionTool } from "./tools/long_running_tool.js";
 import { ToolConfirmation } from "./tools/tool_confirmation.js";
 import { ToolContext } from "./tools/tool_context.js";
 import { LogLevel, setLogLevel } from "./utils/logger.js";
 import { isGemini2OrAbove } from "./utils/model_name.js";
 import { zodObjectToSchema } from "./utils/simple_zod_to_json.js";
+import { GoogleLLMVariant } from "./utils/variant_utils.js";
 import { version } from "./version.js";
 export * from "./artifacts/base_artifact_service.js";
 export * from "./memory/base_memory_service.js";
 export * from "./sessions/base_session_service.js";
 export * from "./tools/base_tool.js";
 export {
+  ActiveStreamingTool,
   AgentTool,
+  AuthCredentialTypes,
   BaseAgent,
+  BaseCodeExecutor,
+  BaseExampleProvider,
   BaseLlm,
+  BaseLlmRequestProcessor,
+  BaseLlmResponseProcessor,
   BasePlugin,
   BaseTool,
   BaseToolset,
@@ -58,6 +90,8 @@ export {
   FunctionTool,
   GOOGLE_SEARCH,
   Gemini,
+  GoogleLLMVariant,
+  GoogleSearchTool,
   InMemoryArtifactService,
   InMemoryMemoryService,
   InMemoryPolicyEngine,
@@ -75,6 +109,7 @@ export {
   PluginManager,
   PolicyOutcome,
   REQUEST_CONFIRMATION_FUNCTION_CALL_NAME,
+  ReadonlyContext,
   Runner,
   SecurityPlugin,
   SequentialAgent,
@@ -90,10 +125,18 @@ export {
   getFunctionCalls,
   getFunctionResponses,
   hasTrailingCodeExecutionResult,
+  isAgentTool,
   isBaseAgent,
+  isBaseExampleProvider,
   isBaseLlm,
+  isBaseTool,
   isFinalResponse,
+  isFunctionTool,
   isGemini2OrAbove,
+  isLlmAgent,
+  isLoopAgent,
+  isParallelAgent,
+  isSequentialAgent,
   setLogLevel,
   stringifyContent,
   version,

package/dist/esm/examples/base_example_provider.js

@@ -3,8 +3,23 @@
  * 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;
+  }
 }
 export {
-  BaseExampleProvider
+  BaseExampleProvider,
+  isBaseExampleProvider
 };

package/dist/esm/examples/example_util.js

@@ -3,7 +3,9 @@
  * Copyright 2025 Google LLC
  * SPDX-License-Identifier: Apache-2.0
  */
-import { BaseExampleProvider } from "./base_example_provider.js";
+import {
+  isBaseExampleProvider
+} from "./base_example_provider.js";
 const EXAMPLES_INTRO = "<EXAMPLES>\nBegin few-shot\nThe following are examples of user queries and model responses using the available tools.\n\n";
 const EXAMPLES_END = "End few-shot\n<EXAMPLES>";
 const EXAMPLE_START = "EXAMPLE {}:\nBegin example\n";
@@ -65,7 +67,7 @@ function buildExampleSi(examples, query, model) {
   if (Array.isArray(examples)) {
     return convertExamplesToText(examples, model);
   }
-  if (examples instanceof BaseExampleProvider) {
+  if (isBaseExampleProvider(examples)) {
     return convertExamplesToText(examples.getExamples(query), model);
   }
   throw new Error("Invalid example configuration");