@google/adk 0.2.4 → 0.2.5

package/dist/cjs/agents/base_agent.js

@@ -55,7 +55,9 @@ class BaseAgent {
     this.parentAgent = config.parentAgent;
     this.subAgents = config.subAgents || [];
     this.rootAgent = getRootAgent(this);
-    this.beforeAgentCallback = getCannonicalCallback(config.beforeAgentCallback);
+    this.beforeAgentCallback = getCannonicalCallback(
+      config.beforeAgentCallback
+    );
     this.afterAgentCallback = getCannonicalCallback(config.afterAgentCallback);
     this.setParentAgentForSubAgents();
   }
@@ -217,7 +219,9 @@ class BaseAgent {
   setParentAgentForSubAgents() {
     for (const subAgent of this.subAgents) {
       if (subAgent.parentAgent) {
-        throw new Error(`Agent "${subAgent.name}" already has a parent agent, current parent: "${subAgent.parentAgent.name}", trying to add: "${this.name}"`);
+        throw new Error(
+          `Agent "${subAgent.name}" already has a parent agent, current parent: "${subAgent.parentAgent.name}", trying to add: "${this.name}"`
+        );
       }
       subAgent.parentAgent = this;
     }
@@ -225,7 +229,9 @@ class BaseAgent {
 }
 function validateAgentName(name) {
   if (!isIdentifier(name)) {
-    throw new Error(`Found invalid agent name: "${name}". Agent name must be a valid identifier. It should start with a letter (a-z, A-Z) or an underscore (_), and can only contain letters, digits (0-9), and underscores.`);
+    throw new Error(
+      `Found invalid agent name: "${name}". Agent name must be a valid identifier. It should start with a letter (a-z, A-Z) or an underscore (_), and can only contain letters, digits (0-9), and underscores.`
+    );
   }
   if (name === "user") {
     throw new Error(

package/dist/cjs/agents/invocation_context.js

@@ -47,7 +47,9 @@ class InvocationCostManager {
   incrementAndEnforceLlmCallsLimit(runConfig) {
     this.numberOfLlmCalls++;
     if (runConfig && runConfig.maxLlmCalls > 0 && this.numberOfLlmCalls > runConfig.maxLlmCalls) {
-      throw new Error(`Max number of llm calls limit of ${runConfig.maxLlmCalls} exceeded`);
+      throw new Error(
+        `Max number of llm calls limit of ${runConfig.maxLlmCalls} exceeded`
+      );
     }
   }
 }

package/dist/cjs/agents/llm_agent.js

@@ -26,6 +26,7 @@ var llm_agent_exports = {};
 __export(llm_agent_exports, {
   LlmAgent: () => LlmAgent,
   REQUEST_CONFIRMATION_LLM_REQUEST_PROCESSOR: () => REQUEST_CONFIRMATION_LLM_REQUEST_PROCESSOR,
+  isLlmAgent: () => isLlmAgent,
   responseProcessor: () => responseProcessor
 });
 module.exports = __toCommonJS(llm_agent_exports);
@@ -60,6 +61,7 @@ var import_run_config = require("./run_config.js");
  * Copyright 2025 Google LLC
  * SPDX-License-Identifier: Apache-2.0
  */
+var _a, _b;
 const ADK_AGENT_NAME_LABEL_KEY = "adk_agent_name";
 async function convertToolUnionToTools(toolUnion, context) {
   if (toolUnion instanceof import_base_tool.BaseTool) {
@@ -69,13 +71,13 @@ async function convertToolUnionToTools(toolUnion, context) {
 }
 class BasicLlmRequestProcessor extends import_base_llm_processor.BaseLlmRequestProcessor {
   async *runAsync(invocationContext, llmRequest) {
-    var _a;
+    var _a2;
     const agent = invocationContext.agent;
-    if (!(agent instanceof LlmAgent)) {
+    if (!isLlmAgent(agent)) {
       return;
     }
     llmRequest.model = agent.canonicalModel.model;
-    llmRequest.config = { ...(_a = agent.generateContentConfig) != null ? _a : {} };
+    llmRequest.config = { ...(_a2 = agent.generateContentConfig) != null ? _a2 : {} };
     if (agent.outputSchema) {
       (0, import_llm_request.setOutputSchema)(llmRequest, agent.outputSchema);
     }
@@ -112,7 +114,7 @@ class InstructionsLlmRequestProcessor extends import_base_llm_processor.BaseLlmR
       return;
     }
     const rootAgent = agent.rootAgent;
-    if (rootAgent instanceof LlmAgent && rootAgent.globalInstruction) {
+    if (isLlmAgent(rootAgent) && rootAgent.globalInstruction) {
       const { instruction, requireStateInjection } = await rootAgent.canonicalGlobalInstruction(
         new import_readonly_context.ReadonlyContext(invocationContext)
       );
@@ -144,7 +146,7 @@ const INSTRUCTIONS_LLM_REQUEST_PROCESSOR = new InstructionsLlmRequestProcessor()
 class ContentRequestProcessor {
   async *runAsync(invocationContext, llmRequest) {
     const agent = invocationContext.agent;
-    if (!agent || !(agent instanceof LlmAgent)) {
+    if (!agent || !isLlmAgent(agent)) {
       return;
     }
     if (agent.includeContents === "default") {
@@ -232,7 +234,7 @@ to your parent agent.
   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) {
@@ -253,7 +255,7 @@ class RequestConfirmationLlmRequestProcessor extends import_base_llm_processor.B
   /** Handles tool confirmation information to build the LLM request. */
   async *runAsync(invocationContext, llmRequest) {
     const agent = invocationContext.agent;
-    if (!(agent instanceof LlmAgent)) {
+    if (!isLlmAgent(agent)) {
       return;
     }
     const events = invocationContext.session.events;
@@ -279,7 +281,9 @@ class RequestConfirmationLlmRequestProcessor extends import_base_llm_processor.B
         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 import_tool_confirmation.ToolConfirmation({
             hint: functionResponse.response["hint"],
@@ -343,8 +347,12 @@ class RequestConfirmationLlmRequestProcessor extends import_base_llm_processor.B
       if (Object.keys(toolsToResumeWithConfirmation).length === 0) {
         continue;
       }
-      const toolsList = await agent.canonicalTools(new import_readonly_context.ReadonlyContext(invocationContext));
-      const toolsDict = Object.fromEntries(toolsList.map((tool) => [tool.name, tool]));
+      const toolsList = await agent.canonicalTools(
+        new import_readonly_context.ReadonlyContext(invocationContext)
+      );
+      const toolsDict = Object.fromEntries(
+        toolsList.map((tool) => [tool.name, tool])
+      );
       const functionResponseEvent = await (0, import_functions.handleFunctionCallList)({
         invocationContext,
         functionCalls: Object.values(toolsToResumeWithArgs),
@@ -373,7 +381,7 @@ class CodeExecutionRequestProcessor extends import_base_llm_processor.BaseLlmReq
     for await (const event of runPreProcessor(invocationContext, llmRequest)) {
       yield event;
     }
-    if (!(invocationContext.agent.codeExecutor instanceof import_base_code_executor.BaseCodeExecutor)) {
+    if (!(0, import_base_code_executor.isBaseCodeExecutor)(invocationContext.agent.codeExecutor)) {
       return;
     }
     for (const content of llmRequest.contents) {
@@ -442,7 +450,10 @@ class CodeExecutionResponseProcessor {
     if (llmResponse.partial) {
       return;
     }
-    for await (const event of runPostProcessor(invocationContext, llmResponse)) {
+    for await (const event of runPostProcessor(
+      invocationContext,
+      llmResponse
+    )) {
       yield event;
     }
   }
@@ -450,27 +461,36 @@ class CodeExecutionResponseProcessor {
 const responseProcessor = new CodeExecutionResponseProcessor();
 async function* runPreProcessor(invocationContext, llmRequest) {
   const agent = invocationContext.agent;
-  if (!(agent instanceof LlmAgent)) {
+  if (!isLlmAgent(agent)) {
     return;
   }
   const codeExecutor = agent.codeExecutor;
-  if (!codeExecutor || !(codeExecutor instanceof import_base_code_executor.BaseCodeExecutor)) {
+  if (!codeExecutor || !(0, import_base_code_executor.isBaseCodeExecutor)(codeExecutor)) {
     return;
   }
-  if (codeExecutor instanceof import_built_in_code_executor.BuiltInCodeExecutor) {
+  if ((0, import_built_in_code_executor.isBuiltInCodeExecutor)(codeExecutor)) {
     codeExecutor.processLlmRequest(llmRequest);
     return;
   }
   if (!codeExecutor.optimizeDataFile) {
     return;
   }
-  const codeExecutorContext = new import_code_executor_context.CodeExecutorContext(new import_state.State(invocationContext.session.state));
+  const codeExecutorContext = new import_code_executor_context.CodeExecutorContext(
+    new import_state.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) {
@@ -490,7 +510,10 @@ async function* runPreProcessor(invocationContext, llmRequest) {
       branch: invocationContext.branch,
       content: codeContent
     });
-    const executionId = getOrSetExecutionId(invocationContext, codeExecutorContext);
+    const executionId = getOrSetExecutionId(
+      invocationContext,
+      codeExecutorContext
+    );
     const codeExecutionResult = await codeExecutor.executeCode({
       invocationContext,
       codeExecutionInput: {
@@ -517,20 +540,22 @@ async function* runPreProcessor(invocationContext, llmRequest) {
 }
 async function* runPostProcessor(invocationContext, llmResponse) {
   const agent = invocationContext.agent;
-  if (!(agent instanceof LlmAgent)) {
+  if (!isLlmAgent(agent)) {
     return;
   }
   const codeExecutor = agent.codeExecutor;
-  if (!codeExecutor || !(codeExecutor instanceof import_base_code_executor.BaseCodeExecutor)) {
+  if (!codeExecutor || !(0, import_base_code_executor.isBaseCodeExecutor)(codeExecutor)) {
     return;
   }
   if (!llmResponse || !llmResponse.content) {
     return;
   }
-  if (codeExecutor instanceof import_built_in_code_executor.BuiltInCodeExecutor) {
+  if ((0, import_built_in_code_executor.isBuiltInCodeExecutor)(codeExecutor)) {
     return;
   }
-  const codeExecutorContext = new import_code_executor_context.CodeExecutorContext(new import_state.State(invocationContext.session.state));
+  const codeExecutorContext = new import_code_executor_context.CodeExecutorContext(
+    new import_state.State(invocationContext.session.state)
+  );
   if (codeExecutorContext.getErrorCount(invocationContext.invocationId) >= codeExecutor.errorRetryAttempts) {
     return;
   }
@@ -548,7 +573,10 @@ async function* runPostProcessor(invocationContext, llmResponse) {
     branch: invocationContext.branch,
     content: responseContent
   });
-  const executionId = getOrSetExecutionId(invocationContext, codeExecutorContext);
+  const executionId = getOrSetExecutionId(
+    invocationContext,
+    codeExecutorContext
+  );
   const codeExecutionResult = await codeExecutor.executeCode({
     invocationContext,
     codeExecutionInput: {
@@ -571,7 +599,7 @@ async function* runPostProcessor(invocationContext, llmResponse) {
   llmResponse.content = null;
 }
 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++) {
@@ -581,7 +609,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;
       }
@@ -603,9 +631,9 @@ Available file: \`${fileName}\`
   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();
@@ -623,7 +651,9 @@ async function postProcessCodeExecutionResult(invocationContext, codeExecutorCon
     role: "model",
     parts: [(0, import_code_execution_utils.buildCodeExecutionResultPart)(codeExecutionResult)]
   };
-  const eventActions = (0, import_event_actions.createEventActions)({ stateDelta: codeExecutorContext.getStateDelta() });
+  const eventActions = (0, import_event_actions.createEventActions)({
+    stateDelta: codeExecutorContext.getStateDelta()
+  });
   if (codeExecutionResult.stderr) {
     codeExecutorContext.incrementErrorCount(invocationContext.invocationId);
   } else {
@@ -662,10 +692,7 @@ 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 `
 ${DATA_FILE_HELPER_LIB}
 
@@ -677,13 +704,19 @@ explore_df(${varName})
 `;
 }
 const CODE_EXECUTION_REQUEST_PROCESSOR = new CodeExecutionRequestProcessor();
-class LlmAgent extends import_base_agent.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 = import_base_agent.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;
@@ -761,7 +794,7 @@ class LlmAgent extends import_base_agent.BaseAgent {
     }
     let ancestorAgent = this.parentAgent;
     while (ancestorAgent) {
-      if (ancestorAgent instanceof LlmAgent) {
+      if (isLlmAgent(ancestorAgent)) {
         return ancestorAgent.canonicalModel;
       }
       ancestorAgent = ancestorAgent.parentAgent;
@@ -769,12 +802,12 @@ class LlmAgent extends import_base_agent.BaseAgent {
     throw new Error(`No model found for ${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") {
@@ -786,11 +819,11 @@ class LlmAgent extends import_base_agent.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") {
@@ -802,7 +835,7 @@ class LlmAgent extends import_base_agent.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.
    */
@@ -830,7 +863,7 @@ class LlmAgent extends import_base_agent.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.
@@ -839,7 +872,7 @@ class LlmAgent extends import_base_agent.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.
@@ -848,7 +881,7 @@ class LlmAgent extends import_base_agent.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.
@@ -857,7 +890,7 @@ class LlmAgent extends import_base_agent.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.
    */
@@ -874,7 +907,7 @@ class LlmAgent extends import_base_agent.BaseAgent {
    * @param event The event to process.
    */
   maybeSaveOutputToState(event) {
-    var _a, _b;
+    var _a2, _b2;
     if (event.author !== this.name) {
       import_logger.logger.debug(
         `Skipping output save for agent ${this.name}: event authored by ${event.author}`
@@ -893,7 +926,7 @@ class LlmAgent extends import_base_agent.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)) {
       import_logger.logger.debug(
         `Skipping output save for agent ${this.name}: event content is empty`
       );
@@ -953,7 +986,10 @@ class LlmAgent extends import_base_agent.BaseAgent {
       liveConnectConfig: {}
     };
     for (const processor of this.requestProcessors) {
-      for await (const event of processor.runAsync(invocationContext, llmRequest)) {
+      for await (const event of processor.runAsync(
+        invocationContext,
+        llmRequest
+      )) {
         yield event;
       }
     }
@@ -993,9 +1029,12 @@ class LlmAgent extends import_base_agent.BaseAgent {
     }
   }
   async *postprocess(invocationContext, llmRequest, llmResponse, modelResponseEvent) {
-    var _a;
+    var _a2;
     for (const processor of this.responseProcessors) {
-      for await (const event of processor.runAsync(invocationContext, llmResponse)) {
+      for await (const event of processor.runAsync(
+        invocationContext,
+        llmResponse
+      )) {
         yield event;
       }
     }
@@ -1016,7 +1055,7 @@ class LlmAgent extends import_base_agent.BaseAgent {
       }
     }
     yield mergedEvent;
-    if (!((_a = (0, import_event.getFunctionCalls)(mergedEvent)) == null ? void 0 : _a.length)) {
+    if (!((_a2 = (0, import_event.getFunctionCalls)(mergedEvent)) == null ? void 0 : _a2.length)) {
       return;
     }
     const functionResponseEvent = await (0, import_functions.handleFunctionCallsAsync)({
@@ -1029,7 +1068,10 @@ class LlmAgent extends import_base_agent.BaseAgent {
     if (!functionResponseEvent) {
       return;
     }
-    const authEvent = (0, import_functions.generateAuthEvent)(invocationContext, functionResponseEvent);
+    const authEvent = (0, import_functions.generateAuthEvent)(
+      invocationContext,
+      functionResponseEvent
+    );
     if (authEvent) {
       yield authEvent;
     }
@@ -1071,7 +1113,7 @@ class LlmAgent extends import_base_agent.BaseAgent {
     return agentToRun;
   }
   async *callLlmAsync(invocationContext, llmRequest, modelResponseEvent) {
-    var _a, _b, _c, _d, _e;
+    var _a2, _b2, _c, _d, _e;
     const beforeModelResponse = await this.handleBeforeModelCallback(
       invocationContext,
       llmRequest,
@@ -1081,8 +1123,8 @@ class LlmAgent extends import_base_agent.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;
     }
@@ -1112,17 +1154,22 @@ class LlmAgent extends import_base_agent.BaseAgent {
     }
   }
   async handleBeforeModelCallback(invocationContext, llmRequest, modelResponseEvent) {
-    const callbackContext = new import_callback_context.CallbackContext(
-      { invocationContext, eventActions: modelResponseEvent.actions }
-    );
-    const beforeModelCallbackResponse = await invocationContext.pluginManager.runBeforeModelCallback(
-      { callbackContext, llmRequest }
-    );
+    const callbackContext = new import_callback_context.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;
       }
@@ -1130,17 +1177,22 @@ class LlmAgent extends import_base_agent.BaseAgent {
     return void 0;
   }
   async handleAfterModelCallback(invocationContext, llmResponse, modelResponseEvent) {
-    const callbackContext = new import_callback_context.CallbackContext(
-      { invocationContext, eventActions: modelResponseEvent.actions }
-    );
-    const afterModelCallbackResponse = await invocationContext.pluginManager.runAfterModelCallback(
-      { callbackContext, llmResponse }
-    );
+    const callbackContext = new import_callback_context.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;
       }
@@ -1153,9 +1205,10 @@ class LlmAgent extends import_base_agent.BaseAgent {
         yield response;
       }
     } catch (modelError) {
-      const callbackContext = new import_callback_context.CallbackContext(
-        { invocationContext, eventActions: modelResponseEvent.actions }
-      );
+      const callbackContext = new import_callback_context.CallbackContext({
+        invocationContext,
+        eventActions: modelResponseEvent.actions
+      });
       if (modelError instanceof Error) {
         const onModelErrorCallbackResponse = await invocationContext.pluginManager.runOnModelErrorCallback({
           callbackContext,
@@ -1188,5 +1241,6 @@ class LlmAgent extends import_base_agent.BaseAgent {
 0 && (module.exports = {
   LlmAgent,
   REQUEST_CONFIRMATION_LLM_REQUEST_PROCESSOR,
+  isLlmAgent,
   responseProcessor
 });

package/dist/cjs/agents/loop_agent.js

@@ -24,7 +24,8 @@ var __copyProps = (to, from, except, desc) => {
 var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
 var loop_agent_exports = {};
 __export(loop_agent_exports, {
-  LoopAgent: () => LoopAgent
+  LoopAgent: () => LoopAgent,
+  isLoopAgent: () => isLoopAgent
 });
 module.exports = __toCommonJS(loop_agent_exports);
 var import_base_agent = require("./base_agent.js");
@@ -33,11 +34,20 @@ var import_base_agent = require("./base_agent.js");
  * Copyright 2025 Google LLC
  * SPDX-License-Identifier: Apache-2.0
  */
-class LoopAgent extends import_base_agent.BaseAgent {
+var _a, _b;
+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 = import_base_agent.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;
   }
   async *runAsyncImpl(context) {
     let iteration = 0;
@@ -64,5 +74,6 @@ class LoopAgent extends import_base_agent.BaseAgent {
 }
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {
-  LoopAgent
+  LoopAgent,
+  isLoopAgent
 });

package/dist/cjs/agents/parallel_agent.js

@@ -24,7 +24,8 @@ var __copyProps = (to, from, except, desc) => {
 var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
 var parallel_agent_exports = {};
 __export(parallel_agent_exports, {
-  ParallelAgent: () => ParallelAgent
+  ParallelAgent: () => ParallelAgent,
+  isParallelAgent: () => isParallelAgent
 });
 module.exports = __toCommonJS(parallel_agent_exports);
 var import_base_agent = require("./base_agent.js");
@@ -34,7 +35,19 @@ var import_invocation_context = require("./invocation_context.js");
  * Copyright 2025 Google LLC
  * SPDX-License-Identifier: Apache-2.0
  */
-class ParallelAgent extends import_base_agent.BaseAgent {
+var _a, _b;
+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 = import_base_agent.BaseAgent, _a = PARALLEL_AGENT_SIGNATURE_SYMBOL, _b) {
+  constructor() {
+    super(...arguments);
+    /**
+     * A unique symbol to identify ADK parallel agent class.
+     */
+    this[_a] = true;
+  }
   async *runAsyncImpl(context) {
     const agentRuns = this.subAgents.map(
       (subAgent) => subAgent.runAsync(
@@ -74,5 +87,6 @@ async function* mergeAgentRuns(agentRuns) {
 }
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {
-  ParallelAgent
+  ParallelAgent,
+  isParallelAgent
 });

package/dist/cjs/agents/readonly_context.js

@@ -59,7 +59,10 @@ class ReadonlyContext {
    * The state of the current session.
    */
   get state() {
-    return new import_state.State(this.invocationContext.session.state, {});
+    return new import_state.State(
+      this.invocationContext.session.state,
+      {}
+    );
   }
 }
 // Annotate the CommonJS export names for ESM import in node: