@google/adk 0.2.4 → 0.2.5

package/dist/web/agents/llm_agent.js

@@ -36,16 +36,33 @@ var __forAwait = (obj, it, method) => (it = obj[__knownSymbol("asyncIterator")])
  * Copyright 2025 Google LLC
  * SPDX-License-Identifier: Apache-2.0
  */
+var _a, _b;
 import { cloneDeep } from "lodash-es";
 import { z } from "zod";
-import { BaseCodeExecutor } from "../code_executors/base_code_executor.js";
-import { BuiltInCodeExecutor } from "../code_executors/built_in_code_executor.js";
-import { buildCodeExecutionResultPart, buildExecutableCodePart, convertCodeExecutionParts, extractCodeAndTruncateContent } from "../code_executors/code_execution_utils.js";
+import {
+  isBaseCodeExecutor
+} from "../code_executors/base_code_executor.js";
+import { isBuiltInCodeExecutor } from "../code_executors/built_in_code_executor.js";
+import {
+  buildCodeExecutionResultPart,
+  buildExecutableCodePart,
+  convertCodeExecutionParts,
+  extractCodeAndTruncateContent
+} from "../code_executors/code_execution_utils.js";
 import { CodeExecutorContext } from "../code_executors/code_executor_context.js";
-import { createEvent, createNewEventId, getFunctionCalls, getFunctionResponses, isFinalResponse } from "../events/event.js";
+import {
+  createEvent,
+  createNewEventId,
+  getFunctionCalls,
+  getFunctionResponses,
+  isFinalResponse
+} from "../events/event.js";
 import { createEventActions } from "../events/event_actions.js";
 import { isBaseLlm } from "../models/base_llm.js";
-import { appendInstructions, setOutputSchema } from "../models/llm_request.js";
+import {
+  appendInstructions,
+  setOutputSchema
+} from "../models/llm_request.js";
 import { LLMRegistry } from "../models/registry.js";
 import { State } from "../sessions/state.js";
 import { BaseTool } from "../tools/base_tool.js";
@@ -55,10 +72,23 @@ import { ToolContext } from "../tools/tool_context.js";
 import { base64Decode } from "../utils/env_aware_utils.js";
 import { logger } from "../utils/logger.js";
 import { BaseAgent } from "./base_agent.js";
-import { BaseLlmRequestProcessor } from "./base_llm_processor.js";
+import {
+  BaseLlmRequestProcessor
+} from "./base_llm_processor.js";
 import { CallbackContext } from "./callback_context.js";
-import { getContents, getCurrentTurnContents } from "./content_processor_utils.js";
-import { generateAuthEvent, generateRequestConfirmationEvent, getLongRunningFunctionCalls, handleFunctionCallList, handleFunctionCallsAsync, populateClientFunctionCallId, REQUEST_CONFIRMATION_FUNCTION_CALL_NAME } from "./functions.js";
+import {
+  getContents,
+  getCurrentTurnContents
+} from "./content_processor_utils.js";
+import {
+  generateAuthEvent,
+  generateRequestConfirmationEvent,
+  getLongRunningFunctionCalls,
+  handleFunctionCallList,
+  handleFunctionCallsAsync,
+  populateClientFunctionCallId,
+  REQUEST_CONFIRMATION_FUNCTION_CALL_NAME
+} from "./functions.js";
 import { injectSessionState } from "./instructions.js";
 import { ReadonlyContext } from "./readonly_context.js";
 import { StreamingMode } from "./run_config.js";
@@ -72,13 +102,13 @@ async function convertToolUnionToTools(toolUnion, context) {
 class BasicLlmRequestProcessor extends BaseLlmRequestProcessor {
   runAsync(invocationContext, llmRequest) {
     return __asyncGenerator(this, null, function* () {
-      var _a;
+      var _a2;
       const agent = invocationContext.agent;
-      if (!(agent instanceof LlmAgent)) {
+      if (!isLlmAgent(agent)) {
         return;
       }
       llmRequest.model = agent.canonicalModel.model;
-      llmRequest.config = __spreadValues({}, (_a = agent.generateContentConfig) != null ? _a : {});
+      llmRequest.config = __spreadValues({}, (_a2 = agent.generateContentConfig) != null ? _a2 : {});
       if (agent.outputSchema) {
         setOutputSchema(llmRequest, agent.outputSchema);
       }
@@ -119,7 +149,7 @@ class InstructionsLlmRequestProcessor extends BaseLlmRequestProcessor {
         return;
       }
       const rootAgent = agent.rootAgent;
-      if (rootAgent instanceof LlmAgent && rootAgent.globalInstruction) {
+      if (isLlmAgent(rootAgent) && rootAgent.globalInstruction) {
         const { instruction, requireStateInjection } = yield new __await(rootAgent.canonicalGlobalInstruction(
           new ReadonlyContext(invocationContext)
         ));
@@ -153,7 +183,7 @@ class ContentRequestProcessor {
   runAsync(invocationContext, llmRequest) {
     return __asyncGenerator(this, null, function* () {
       const agent = invocationContext.agent;
-      if (!agent || !(agent instanceof LlmAgent)) {
+      if (!agent || !isLlmAgent(agent)) {
         return;
       }
       if (agent.includeContents === "default") {
@@ -225,7 +255,7 @@ class AgentTransferLlmRequestProcessor extends BaseLlmRequestProcessor {
   getTransferTargets(agent) {
     const targets = [];
     targets.push(...agent.subAgents);
-    if (!agent.parentAgent || !(agent.parentAgent instanceof LlmAgent)) {
+    if (!agent.parentAgent || !isLlmAgent(agent.parentAgent)) {
       return targets;
     }
     if (!agent.disallowTransferToParent) {
@@ -247,7 +277,7 @@ class RequestConfirmationLlmRequestProcessor extends BaseLlmRequestProcessor {
   runAsync(invocationContext, llmRequest) {
     return __asyncGenerator(this, null, function* () {
       const agent = invocationContext.agent;
-      if (!(agent instanceof LlmAgent)) {
+      if (!isLlmAgent(agent)) {
         return;
       }
       const events = invocationContext.session.events;
@@ -273,7 +303,9 @@ class RequestConfirmationLlmRequestProcessor extends BaseLlmRequestProcessor {
           foundConfirmation = true;
           let toolConfirmation = null;
           if (functionResponse.response && Object.keys(functionResponse.response).length === 1 && "response" in functionResponse.response) {
-            toolConfirmation = JSON.parse(functionResponse.response["response"]);
+            toolConfirmation = JSON.parse(
+              functionResponse.response["response"]
+            );
           } else if (functionResponse.response) {
             toolConfirmation = new ToolConfirmation({
               hint: functionResponse.response["hint"],
@@ -337,8 +369,12 @@ class RequestConfirmationLlmRequestProcessor extends BaseLlmRequestProcessor {
         if (Object.keys(toolsToResumeWithConfirmation).length === 0) {
           continue;
         }
-        const toolsList = yield new __await(agent.canonicalTools(new ReadonlyContext(invocationContext)));
-        const toolsDict = Object.fromEntries(toolsList.map((tool) => [tool.name, tool]));
+        const toolsList = yield new __await(agent.canonicalTools(
+          new ReadonlyContext(invocationContext)
+        ));
+        const toolsDict = Object.fromEntries(
+          toolsList.map((tool) => [tool.name, tool])
+        );
         const functionResponseEvent = yield new __await(handleFunctionCallList({
           invocationContext,
           functionCalls: Object.values(toolsToResumeWithArgs),
@@ -381,7 +417,7 @@ class CodeExecutionRequestProcessor extends BaseLlmRequestProcessor {
             throw error[0];
         }
       }
-      if (!(invocationContext.agent.codeExecutor instanceof BaseCodeExecutor)) {
+      if (!isBaseCodeExecutor(invocationContext.agent.codeExecutor)) {
         return;
       }
       for (const content of llmRequest.contents) {
@@ -416,7 +452,10 @@ class CodeExecutionResponseProcessor {
         return;
       }
       try {
-        for (var iter = __forAwait(runPostProcessor(invocationContext, llmResponse)), more, temp, error; more = !(temp = yield new __await(iter.next())).done; more = false) {
+        for (var iter = __forAwait(runPostProcessor(
+          invocationContext,
+          llmResponse
+        )), more, temp, error; more = !(temp = yield new __await(iter.next())).done; more = false) {
           const event = temp.value;
           yield event;
         }
@@ -437,27 +476,36 @@ const responseProcessor = new CodeExecutionResponseProcessor();
 function runPreProcessor(invocationContext, llmRequest) {
   return __asyncGenerator(this, null, function* () {
     const agent = invocationContext.agent;
-    if (!(agent instanceof LlmAgent)) {
+    if (!isLlmAgent(agent)) {
       return;
     }
     const codeExecutor = agent.codeExecutor;
-    if (!codeExecutor || !(codeExecutor instanceof BaseCodeExecutor)) {
+    if (!codeExecutor || !isBaseCodeExecutor(codeExecutor)) {
       return;
     }
-    if (codeExecutor instanceof BuiltInCodeExecutor) {
+    if (isBuiltInCodeExecutor(codeExecutor)) {
       codeExecutor.processLlmRequest(llmRequest);
       return;
     }
     if (!codeExecutor.optimizeDataFile) {
       return;
     }
-    const codeExecutorContext = new CodeExecutorContext(new State(invocationContext.session.state));
+    const codeExecutorContext = new CodeExecutorContext(
+      new State(invocationContext.session.state)
+    );
     if (codeExecutorContext.getErrorCount(invocationContext.invocationId) >= codeExecutor.errorRetryAttempts) {
       return;
     }
-    const allInputFiles = extractAndReplaceInlineFiles(codeExecutorContext, llmRequest);
-    const processedFileNames = new Set(codeExecutorContext.getProcessedFileNames());
-    const filesToProcess = allInputFiles.filter((f) => !processedFileNames.has(f.name));
+    const allInputFiles = extractAndReplaceInlineFiles(
+      codeExecutorContext,
+      llmRequest
+    );
+    const processedFileNames = new Set(
+      codeExecutorContext.getProcessedFileNames()
+    );
+    const filesToProcess = allInputFiles.filter(
+      (f) => !processedFileNames.has(f.name)
+    );
     for (const file of filesToProcess) {
       const codeStr = getDataFilePreprocessingCode(file);
       if (!codeStr) {
@@ -477,7 +525,10 @@ function runPreProcessor(invocationContext, llmRequest) {
         branch: invocationContext.branch,
         content: codeContent
       });
-      const executionId = getOrSetExecutionId(invocationContext, codeExecutorContext);
+      const executionId = getOrSetExecutionId(
+        invocationContext,
+        codeExecutorContext
+      );
       const codeExecutionResult = yield new __await(codeExecutor.executeCode({
         invocationContext,
         codeExecutionInput: {
@@ -506,20 +557,22 @@ function runPreProcessor(invocationContext, llmRequest) {
 function runPostProcessor(invocationContext, llmResponse) {
   return __asyncGenerator(this, null, function* () {
     const agent = invocationContext.agent;
-    if (!(agent instanceof LlmAgent)) {
+    if (!isLlmAgent(agent)) {
       return;
     }
     const codeExecutor = agent.codeExecutor;
-    if (!codeExecutor || !(codeExecutor instanceof BaseCodeExecutor)) {
+    if (!codeExecutor || !isBaseCodeExecutor(codeExecutor)) {
       return;
     }
     if (!llmResponse || !llmResponse.content) {
       return;
     }
-    if (codeExecutor instanceof BuiltInCodeExecutor) {
+    if (isBuiltInCodeExecutor(codeExecutor)) {
       return;
     }
-    const codeExecutorContext = new CodeExecutorContext(new State(invocationContext.session.state));
+    const codeExecutorContext = new CodeExecutorContext(
+      new State(invocationContext.session.state)
+    );
     if (codeExecutorContext.getErrorCount(invocationContext.invocationId) >= codeExecutor.errorRetryAttempts) {
       return;
     }
@@ -537,7 +590,10 @@ function runPostProcessor(invocationContext, llmResponse) {
       branch: invocationContext.branch,
       content: responseContent
     });
-    const executionId = getOrSetExecutionId(invocationContext, codeExecutorContext);
+    const executionId = getOrSetExecutionId(
+      invocationContext,
+      codeExecutorContext
+    );
     const codeExecutionResult = yield new __await(codeExecutor.executeCode({
       invocationContext,
       codeExecutionInput: {
@@ -561,7 +617,7 @@ function runPostProcessor(invocationContext, llmResponse) {
   });
 }
 function extractAndReplaceInlineFiles(codeExecutorContext, llmRequest) {
-  var _a;
+  var _a2;
   const allInputFiles = codeExecutorContext.getInputFiles();
   const savedFileNames = new Set(allInputFiles.map((f) => f.name));
   for (let i = 0; i < llmRequest.contents.length; i++) {
@@ -571,7 +627,7 @@ function extractAndReplaceInlineFiles(codeExecutorContext, llmRequest) {
     }
     for (let j = 0; j < content.parts.length; j++) {
       const part = content.parts[j];
-      const mimeType = (_a = part.inlineData) == null ? void 0 : _a.mimeType;
+      const mimeType = (_a2 = part.inlineData) == null ? void 0 : _a2.mimeType;
       if (!mimeType || !part.inlineData || !DATA_FILE_UTIL_MAP[mimeType]) {
         continue;
       }
@@ -591,9 +647,9 @@ function extractAndReplaceInlineFiles(codeExecutorContext, llmRequest) {
   return allInputFiles;
 }
 function getOrSetExecutionId(invocationContext, codeExecutorContext) {
-  var _a;
+  var _a2;
   const agent = invocationContext.agent;
-  if (!(agent instanceof LlmAgent) || !((_a = agent.codeExecutor) == null ? void 0 : _a.stateful)) {
+  if (!isLlmAgent(agent) || !((_a2 = agent.codeExecutor) == null ? void 0 : _a2.stateful)) {
     return void 0;
   }
   let executionId = codeExecutorContext.getExecutionId();
@@ -611,7 +667,9 @@ async function postProcessCodeExecutionResult(invocationContext, codeExecutorCon
     role: "model",
     parts: [buildCodeExecutionResultPart(codeExecutionResult)]
   };
-  const eventActions = createEventActions({ stateDelta: codeExecutorContext.getStateDelta() });
+  const eventActions = createEventActions({
+    stateDelta: codeExecutorContext.getStateDelta()
+  });
   if (codeExecutionResult.stderr) {
     codeExecutorContext.incrementErrorCount(invocationContext.invocationId);
   } else {
@@ -650,20 +708,23 @@ function getDataFilePreprocessingCode(file) {
     return void 0;
   }
   const varName = getNormalizedFileName(file.name);
-  const loaderCode = DATA_FILE_UTIL_MAP[file.mimeType].loaderCodeTemplate.replace(
-    "{filename}",
-    file.name
-  );
+  const loaderCode = DATA_FILE_UTIL_MAP[file.mimeType].loaderCodeTemplate.replace("{filename}", file.name);
   return "\n".concat(DATA_FILE_HELPER_LIB, "\n\n# Load the dataframe.\n").concat(varName, " = ").concat(loaderCode, "\n\n# Use `explore_df` to guide my analysis.\nexplore_df(").concat(varName, ")\n");
 }
 const CODE_EXECUTION_REQUEST_PROCESSOR = new CodeExecutionRequestProcessor();
-class LlmAgent extends BaseAgent {
+const LLM_AGENT_SIGNATURE_SYMBOL = Symbol.for("google.adk.llmAgent");
+function isLlmAgent(obj) {
+  return typeof obj === "object" && obj !== null && LLM_AGENT_SIGNATURE_SYMBOL in obj && obj[LLM_AGENT_SIGNATURE_SYMBOL] === true;
+}
+class LlmAgent extends (_b = BaseAgent, _a = LLM_AGENT_SIGNATURE_SYMBOL, _b) {
   constructor(config) {
-    var _a, _b, _c, _d, _e, _f, _g, _h, _i;
+    var _a2, _b2, _c, _d, _e, _f, _g, _h, _i;
     super(config);
+    /** A unique symbol to identify ADK LLM agent class. */
+    this[_a] = true;
     this.model = config.model;
-    this.instruction = (_a = config.instruction) != null ? _a : "";
-    this.globalInstruction = (_b = config.globalInstruction) != null ? _b : "";
+    this.instruction = (_a2 = config.instruction) != null ? _a2 : "";
+    this.globalInstruction = (_b2 = config.globalInstruction) != null ? _b2 : "";
     this.tools = (_c = config.tools) != null ? _c : [];
     this.generateContentConfig = config.generateContentConfig;
     this.disallowTransferToParent = (_d = config.disallowTransferToParent) != null ? _d : false;
@@ -741,7 +802,7 @@ class LlmAgent extends BaseAgent {
     }
     let ancestorAgent = this.parentAgent;
     while (ancestorAgent) {
-      if (ancestorAgent instanceof LlmAgent) {
+      if (isLlmAgent(ancestorAgent)) {
         return ancestorAgent.canonicalModel;
       }
       ancestorAgent = ancestorAgent.parentAgent;
@@ -749,12 +810,12 @@ class LlmAgent extends BaseAgent {
     throw new Error("No model found for ".concat(this.name, "."));
   }
   /**
-   * The resolved self.instruction field to construct instruction for this
+   * The resolved instruction field to construct instruction for this
    * agent.
    *
    * This method is only for use by Agent Development Kit.
    * @param context The context to retrieve the session state.
-   * @returns The resolved self.instruction field.
+   * @returns The resolved instruction field.
    */
   async canonicalInstruction(context) {
     if (typeof this.instruction === "string") {
@@ -766,11 +827,11 @@ class LlmAgent extends BaseAgent {
     };
   }
   /**
-   * The resolved self.instruction field to construct global instruction.
+   * The resolved globalInstruction field to construct global instruction.
    *
    * This method is only for use by Agent Development Kit.
    * @param context The context to retrieve the session state.
-   * @returns The resolved self.global_instruction field.
+   * @returns The resolved globalInstruction field.
    */
   async canonicalGlobalInstruction(context) {
     if (typeof this.globalInstruction === "string") {
@@ -782,7 +843,7 @@ class LlmAgent extends BaseAgent {
     };
   }
   /**
-   * The resolved self.tools field as a list of BaseTool based on the context.
+   * The resolved tools field as a list of BaseTool based on the context.
    *
    * This method is only for use by Agent Development Kit.
    */
@@ -810,7 +871,7 @@ class LlmAgent extends BaseAgent {
     return [callback];
   }
   /**
-   * The resolved self.before_model_callback field as a list of
+   * The resolved beforeModelCallback field as a list of
    * SingleBeforeModelCallback.
    *
    * This method is only for use by Agent Development Kit.
@@ -819,7 +880,7 @@ class LlmAgent extends BaseAgent {
     return LlmAgent.normalizeCallbackArray(this.beforeModelCallback);
   }
   /**
-   * The resolved self.after_model_callback field as a list of
+   * The resolved afterModelCallback field as a list of
    * SingleAfterModelCallback.
    *
    * This method is only for use by Agent Development Kit.
@@ -828,7 +889,7 @@ class LlmAgent extends BaseAgent {
     return LlmAgent.normalizeCallbackArray(this.afterModelCallback);
   }
   /**
-   * The resolved self.before_tool_callback field as a list of
+   * The resolved beforeToolCallback field as a list of
    * BeforeToolCallback.
    *
    * This method is only for use by Agent Development Kit.
@@ -837,7 +898,7 @@ class LlmAgent extends BaseAgent {
     return LlmAgent.normalizeCallbackArray(this.beforeToolCallback);
   }
   /**
-   * The resolved self.after_tool_callback field as a list of AfterToolCallback.
+   * The resolved afterToolCallback field as a list of AfterToolCallback.
    *
    * This method is only for use by Agent Development Kit.
    */
@@ -854,7 +915,7 @@ class LlmAgent extends BaseAgent {
    * @param event The event to process.
    */
   maybeSaveOutputToState(event) {
-    var _a, _b;
+    var _a2, _b2;
     if (event.author !== this.name) {
       logger.debug(
         "Skipping output save for agent ".concat(this.name, ": event authored by ").concat(event.author)
@@ -873,7 +934,7 @@ class LlmAgent extends BaseAgent {
       );
       return;
     }
-    if (!((_b = (_a = event.content) == null ? void 0 : _a.parts) == null ? void 0 : _b.length)) {
+    if (!((_b2 = (_a2 = event.content) == null ? void 0 : _a2.parts) == null ? void 0 : _b2.length)) {
       logger.debug(
         "Skipping output save for agent ".concat(this.name, ": event content is empty")
       );
@@ -965,7 +1026,10 @@ class LlmAgent extends BaseAgent {
       };
       for (const processor of this.requestProcessors) {
         try {
-          for (var iter = __forAwait(processor.runAsync(invocationContext, llmRequest)), more, temp, error; more = !(temp = yield new __await(iter.next())).done; more = false) {
+          for (var iter = __forAwait(processor.runAsync(
+            invocationContext,
+            llmRequest
+          )), more, temp, error; more = !(temp = yield new __await(iter.next())).done; more = false) {
             const event = temp.value;
             yield event;
           }
@@ -1042,10 +1106,13 @@ class LlmAgent extends BaseAgent {
   }
   postprocess(invocationContext, llmRequest, llmResponse, modelResponseEvent) {
     return __asyncGenerator(this, null, function* () {
-      var _a;
+      var _a2;
       for (const processor of this.responseProcessors) {
         try {
-          for (var iter = __forAwait(processor.runAsync(invocationContext, llmResponse)), more, temp, error; more = !(temp = yield new __await(iter.next())).done; more = false) {
+          for (var iter = __forAwait(processor.runAsync(
+            invocationContext,
+            llmResponse
+          )), more, temp, error; more = !(temp = yield new __await(iter.next())).done; more = false) {
             const event = temp.value;
             yield event;
           }
@@ -1074,7 +1141,7 @@ class LlmAgent extends BaseAgent {
         }
       }
       yield mergedEvent;
-      if (!((_a = getFunctionCalls(mergedEvent)) == null ? void 0 : _a.length)) {
+      if (!((_a2 = getFunctionCalls(mergedEvent)) == null ? void 0 : _a2.length)) {
         return;
       }
       const functionResponseEvent = yield new __await(handleFunctionCallsAsync({
@@ -1087,7 +1154,10 @@ class LlmAgent extends BaseAgent {
       if (!functionResponseEvent) {
         return;
       }
-      const authEvent = generateAuthEvent(invocationContext, functionResponseEvent);
+      const authEvent = generateAuthEvent(
+        invocationContext,
+        functionResponseEvent
+      );
       if (authEvent) {
         yield authEvent;
       }
@@ -1143,7 +1213,7 @@ class LlmAgent extends BaseAgent {
   }
   callLlmAsync(invocationContext, llmRequest, modelResponseEvent) {
     return __asyncGenerator(this, null, function* () {
-      var _a, _b, _c, _d, _e;
+      var _a2, _b2, _c, _d, _e;
       const beforeModelResponse = yield new __await(this.handleBeforeModelCallback(
         invocationContext,
         llmRequest,
@@ -1153,8 +1223,8 @@ class LlmAgent extends BaseAgent {
         yield beforeModelResponse;
         return;
       }
-      (_a = llmRequest.config) != null ? _a : llmRequest.config = {};
-      (_c = (_b = llmRequest.config).labels) != null ? _c : _b.labels = {};
+      (_a2 = llmRequest.config) != null ? _a2 : llmRequest.config = {};
+      (_c = (_b2 = llmRequest.config).labels) != null ? _c : _b2.labels = {};
       if (!llmRequest.config.labels[ADK_AGENT_NAME_LABEL_KEY]) {
         llmRequest.config.labels[ADK_AGENT_NAME_LABEL_KEY] = this.name;
       }
@@ -1197,17 +1267,22 @@ class LlmAgent extends BaseAgent {
     });
   }
   async handleBeforeModelCallback(invocationContext, llmRequest, modelResponseEvent) {
-    const callbackContext = new CallbackContext(
-      { invocationContext, eventActions: modelResponseEvent.actions }
-    );
-    const beforeModelCallbackResponse = await invocationContext.pluginManager.runBeforeModelCallback(
-      { callbackContext, llmRequest }
-    );
+    const callbackContext = new CallbackContext({
+      invocationContext,
+      eventActions: modelResponseEvent.actions
+    });
+    const beforeModelCallbackResponse = await invocationContext.pluginManager.runBeforeModelCallback({
+      callbackContext,
+      llmRequest
+    });
     if (beforeModelCallbackResponse) {
       return beforeModelCallbackResponse;
     }
     for (const callback of this.canonicalBeforeModelCallbacks) {
-      const callbackResponse = await callback({ context: callbackContext, request: llmRequest });
+      const callbackResponse = await callback({
+        context: callbackContext,
+        request: llmRequest
+      });
       if (callbackResponse) {
         return callbackResponse;
       }
@@ -1215,17 +1290,22 @@ class LlmAgent extends BaseAgent {
     return void 0;
   }
   async handleAfterModelCallback(invocationContext, llmResponse, modelResponseEvent) {
-    const callbackContext = new CallbackContext(
-      { invocationContext, eventActions: modelResponseEvent.actions }
-    );
-    const afterModelCallbackResponse = await invocationContext.pluginManager.runAfterModelCallback(
-      { callbackContext, llmResponse }
-    );
+    const callbackContext = new CallbackContext({
+      invocationContext,
+      eventActions: modelResponseEvent.actions
+    });
+    const afterModelCallbackResponse = await invocationContext.pluginManager.runAfterModelCallback({
+      callbackContext,
+      llmResponse
+    });
     if (afterModelCallbackResponse) {
       return afterModelCallbackResponse;
     }
     for (const callback of this.canonicalAfterModelCallbacks) {
-      const callbackResponse = await callback({ context: callbackContext, response: llmResponse });
+      const callbackResponse = await callback({
+        context: callbackContext,
+        response: llmResponse
+      });
       if (callbackResponse) {
         return callbackResponse;
       }
@@ -1251,9 +1331,10 @@ class LlmAgent extends BaseAgent {
           }
         }
       } catch (modelError) {
-        const callbackContext = new CallbackContext(
-          { invocationContext, eventActions: modelResponseEvent.actions }
-        );
+        const callbackContext = new CallbackContext({
+          invocationContext,
+          eventActions: modelResponseEvent.actions
+        });
         if (modelError instanceof Error) {
           const onModelErrorCallbackResponse = yield new __await(invocationContext.pluginManager.runOnModelErrorCallback({
             callbackContext,
@@ -1286,5 +1367,6 @@ class LlmAgent extends BaseAgent {
 export {
   LlmAgent,
   REQUEST_CONFIRMATION_LLM_REQUEST_PROCESSOR,
+  isLlmAgent,
   responseProcessor
 };

package/dist/web/agents/loop_agent.js

@@ -20,12 +20,21 @@ var __forAwait = (obj, it, method) => (it = obj[__knownSymbol("asyncIterator")])
  * Copyright 2025 Google LLC
  * SPDX-License-Identifier: Apache-2.0
  */
+var _a, _b;
 import { BaseAgent } from "./base_agent.js";
-class LoopAgent extends BaseAgent {
+const LOOP_AGENT_SIGNATURE_SYMBOL = Symbol.for("google.adk.loopAgent");
+function isLoopAgent(obj) {
+  return typeof obj === "object" && obj !== null && LOOP_AGENT_SIGNATURE_SYMBOL in obj && obj[LOOP_AGENT_SIGNATURE_SYMBOL] === true;
+}
+class LoopAgent extends (_b = BaseAgent, _a = LOOP_AGENT_SIGNATURE_SYMBOL, _b) {
   constructor(config) {
-    var _a;
+    var _a2;
     super(config);
-    this.maxIterations = (_a = config.maxIterations) != null ? _a : Number.MAX_SAFE_INTEGER;
+    /**
+     * A unique symbol to identify ADK loop agent class.
+     */
+    this[_a] = true;
+    this.maxIterations = (_a2 = config.maxIterations) != null ? _a2 : Number.MAX_SAFE_INTEGER;
   }
   runAsyncImpl(context) {
     return __asyncGenerator(this, null, function* () {
@@ -67,5 +76,6 @@ class LoopAgent extends BaseAgent {
   }
 }
 export {
-  LoopAgent
+  LoopAgent,
+  isLoopAgent
 };

package/dist/web/agents/parallel_agent.js

@@ -20,9 +20,21 @@ var __forAwait = (obj, it, method) => (it = obj[__knownSymbol("asyncIterator")])
  * Copyright 2025 Google LLC
  * SPDX-License-Identifier: Apache-2.0
  */
+var _a, _b;
 import { BaseAgent } from "./base_agent.js";
 import { InvocationContext } from "./invocation_context.js";
-class ParallelAgent extends BaseAgent {
+const PARALLEL_AGENT_SIGNATURE_SYMBOL = Symbol.for("google.adk.parallelAgent");
+function isParallelAgent(obj) {
+  return typeof obj === "object" && obj !== null && PARALLEL_AGENT_SIGNATURE_SYMBOL in obj && obj[PARALLEL_AGENT_SIGNATURE_SYMBOL] === true;
+}
+class ParallelAgent extends (_b = BaseAgent, _a = PARALLEL_AGENT_SIGNATURE_SYMBOL, _b) {
+  constructor() {
+    super(...arguments);
+    /**
+     * A unique symbol to identify ADK parallel agent class.
+     */
+    this[_a] = true;
+  }
   runAsyncImpl(context) {
     return __asyncGenerator(this, null, function* () {
       const agentRuns = this.subAgents.map(
@@ -79,5 +91,6 @@ function mergeAgentRuns(agentRuns) {
   });
 }
 export {
-  ParallelAgent
+  ParallelAgent,
+  isParallelAgent
 };

package/dist/web/agents/readonly_context.js

@@ -30,7 +30,10 @@ class ReadonlyContext {
    * The state of the current session.
    */
   get state() {
-    return new State(this.invocationContext.session.state, {});
+    return new State(
+      this.invocationContext.session.state,
+      {}
+    );
   }
 }
 export {