@google/adk 0.2.0 → 0.2.2

package/README.md

@@ -1,9 +1,3 @@
 # @google/adk
 
-> [!CAUTION]
-> **API Stability:** Mostly stable, but expect potential breaking changes
-> before 1.0.
-> **Production Use:** Not recommended yet. Use at your own risk.
-> **Collaboration:** General contributions are closed (issues/PRs). We are,
-> however, accepting organized teams that can follow our coding standards and
-> planning. Please contact us if you are interested.
+Please see README for adk-js at https://github.com/google/adk-js

package/dist/cjs/agents/base_agent.js

@@ -25,7 +25,8 @@ var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: tru
 var base_agent_exports = {};
 __export(base_agent_exports, {
   BaseAgent: () => BaseAgent,
-  getCannonicalCallback: () => getCannonicalCallback
+  getCannonicalCallback: () => getCannonicalCallback,
+  isBaseAgent: () => isBaseAgent
 });
 module.exports = __toCommonJS(base_agent_exports);
 var import_api = require("@opentelemetry/api");
@@ -37,8 +38,18 @@ var import_invocation_context = require("./invocation_context.js");
  * Copyright 2025 Google LLC
  * SPDX-License-Identifier: Apache-2.0
  */
+var _a;
+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;
@@ -241,5 +252,6 @@ function getCannonicalCallback(callbacks) {
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {
   BaseAgent,
-  getCannonicalCallback
+  getCannonicalCallback,
+  isBaseAgent
 });

package/dist/cjs/agents/content_processor_utils.js

@@ -28,8 +28,8 @@ __export(content_processor_utils_exports, {
   getCurrentTurnContents: () => getCurrentTurnContents
 });
 module.exports = __toCommonJS(content_processor_utils_exports);
+var import_lodash = require("lodash");
 var import_event = require("../events/event.js");
-var import_deep_clone = require("../utils/deep_clone.js");
 var import_functions = require("./functions.js");
 /**
  * @license
@@ -60,7 +60,7 @@ function getContents(events, agentName, currentBranch) {
   resultEvents = rearrangeEventsForAsyncFunctionResponsesInHistory(resultEvents);
   const contents = [];
   for (const event of resultEvents) {
-    const content = (0, import_deep_clone.deepClone)(event.content);
+    const content = (0, import_lodash.cloneDeep)(event.content);
     (0, import_functions.removeClientFunctionCallId)(content);
     contents.push(content);
   }

package/dist/cjs/agents/functions.js

@@ -39,6 +39,7 @@ __export(functions_exports, {
 });
 module.exports = __toCommonJS(functions_exports);
 var import_genai = require("@google/genai");
+var import_lodash = require("lodash");
 var import_event = require("../events/event.js");
 var import_event_actions = require("../events/event_actions.js");
 var import_tool_context = require("../tools/tool_context.js");
@@ -53,7 +54,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}${(0, import_env_aware_utils.randomUUID)()}`;
@@ -92,7 +95,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) || (0, import_lodash.isEmpty)(functionResponseEvent.actions.requestedAuthConfigs)) {
     return void 0;
   }
   const parts = [];
@@ -128,7 +131,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) || (0, import_lodash.isEmpty)(functionResponseEvent.actions.requestedToolConfirmations)) {
     return;
   }
   const parts = [];

package/dist/cjs/agents/llm_agent.js

@@ -25,18 +25,27 @@ var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: tru
 var llm_agent_exports = {};
 __export(llm_agent_exports, {
   LlmAgent: () => LlmAgent,
-  REQUEST_CONFIRMATION_LLM_REQUEST_PROCESSOR: () => REQUEST_CONFIRMATION_LLM_REQUEST_PROCESSOR
+  REQUEST_CONFIRMATION_LLM_REQUEST_PROCESSOR: () => REQUEST_CONFIRMATION_LLM_REQUEST_PROCESSOR,
+  responseProcessor: () => responseProcessor
 });
 module.exports = __toCommonJS(llm_agent_exports);
+var import_lodash = require("lodash");
 var import_zod = require("zod");
+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_code_execution_utils = require("../code_executors/code_execution_utils.js");
+var import_code_executor_context = require("../code_executors/code_executor_context.js");
 var import_event = require("../events/event.js");
+var import_event_actions = require("../events/event_actions.js");
 var import_base_llm = require("../models/base_llm.js");
 var import_llm_request = require("../models/llm_request.js");
 var import_registry = require("../models/registry.js");
+var import_state = require("../sessions/state.js");
 var import_base_tool = require("../tools/base_tool.js");
 var import_function_tool = require("../tools/function_tool.js");
 var import_tool_confirmation = require("../tools/tool_confirmation.js");
 var import_tool_context = require("../tools/tool_context.js");
+var import_env_aware_utils = require("../utils/env_aware_utils.js");
 var import_logger = require("../utils/logger.js");
 var import_base_agent = require("./base_agent.js");
 var import_base_llm_processor = require("./base_llm_processor.js");
@@ -353,6 +362,321 @@ class RequestConfirmationLlmRequestProcessor extends import_base_llm_processor.B
   }
 }
 const REQUEST_CONFIRMATION_LLM_REQUEST_PROCESSOR = new RequestConfirmationLlmRequestProcessor();
+class CodeExecutionRequestProcessor extends import_base_llm_processor.BaseLlmRequestProcessor {
+  async *runAsync(invocationContext, llmRequest) {
+    if (!(invocationContext.agent instanceof LlmAgent)) {
+      return;
+    }
+    if (!invocationContext.agent.codeExecutor) {
+      return;
+    }
+    for await (const event of runPreProcessor(invocationContext, llmRequest)) {
+      yield event;
+    }
+    if (!(invocationContext.agent.codeExecutor instanceof import_base_code_executor.BaseCodeExecutor)) {
+      return;
+    }
+    for (const content of llmRequest.contents) {
+      const delimeters = invocationContext.agent.codeExecutor.codeBlockDelimiters.length ? invocationContext.agent.codeExecutor.codeBlockDelimiters[0] : ["", ""];
+      const codeExecutionParts = (0, import_code_execution_utils.convertCodeExecutionParts)(
+        content,
+        delimeters,
+        invocationContext.agent.codeExecutor.executionResultDelimiters
+      );
+    }
+  }
+}
+const DATA_FILE_UTIL_MAP = {
+  "text/csv": {
+    extension: ".csv",
+    loaderCodeTemplate: "pd.read_csv('{filename}')"
+  }
+};
+const DATA_FILE_HELPER_LIB = `
+import pandas as pd
+
+def explore_df(df: pd.DataFrame) -> None:
+  """Prints some information about a pandas DataFrame."""
+
+  with pd.option_context(
+      'display.max_columns', None, 'display.expand_frame_repr', False
+  ):
+    # Print the column names to never encounter KeyError when selecting one.
+    df_dtypes = df.dtypes
+
+    # Obtain information about data types and missing values.
+    df_nulls = (len(df) - df.isnull().sum()).apply(
+        lambda x: f'{x} / {df.shape[0]} non-null'
+    )
+
+    # Explore unique total values in columns using \`.unique()\`.
+    df_unique_count = df.apply(lambda x: len(x.unique()))
+
+    # Explore unique values in columns using \`.unique()\`.
+    df_unique = df.apply(lambda x: crop(str(list(x.unique()))))
+
+    df_info = pd.concat(
+        (
+            df_dtypes.rename('Dtype'),
+            df_nulls.rename('Non-Null Count'),
+            df_unique_count.rename('Unique Values Count'),
+            df_unique.rename('Unique Values'),
+        ),
+        axis=1,
+    )
+    df_info.index.name = 'Columns'
+    print(f"""Total rows: {df.shape[0]}
+Total columns: {df.shape[1]}
+
+{df_info}""")
+`;
+class CodeExecutionResponseProcessor {
+  /**
+   * Processes the LLM response asynchronously.
+   *
+   * @param invocationContext The invocation context
+   * @param llmResponse The LLM response to process
+   * @returns An async generator yielding events
+   */
+  async *runAsync(invocationContext, llmResponse) {
+    if (llmResponse.partial) {
+      return;
+    }
+    for await (const event of runPostProcessor(invocationContext, llmResponse)) {
+      yield event;
+    }
+  }
+}
+const responseProcessor = new CodeExecutionResponseProcessor();
+async function* runPreProcessor(invocationContext, llmRequest) {
+  const agent = invocationContext.agent;
+  if (!(agent instanceof LlmAgent)) {
+    return;
+  }
+  const codeExecutor = agent.codeExecutor;
+  if (!codeExecutor || !(codeExecutor instanceof import_base_code_executor.BaseCodeExecutor)) {
+    return;
+  }
+  if (codeExecutor instanceof import_built_in_code_executor.BuiltInCodeExecutor) {
+    codeExecutor.processLlmRequest(llmRequest);
+    return;
+  }
+  if (!codeExecutor.optimizeDataFile) {
+    return;
+  }
+  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));
+  for (const file of filesToProcess) {
+    const codeStr = getDataFilePreprocessingCode(file);
+    if (!codeStr) {
+      return;
+    }
+    const codeContent = {
+      role: "model",
+      parts: [
+        { text: `Processing input file: \`${file.name}\`` },
+        (0, import_code_execution_utils.buildExecutableCodePart)(codeStr)
+      ]
+    };
+    llmRequest.contents.push((0, import_lodash.cloneDeep)(codeContent));
+    yield (0, import_event.createEvent)({
+      invocationId: invocationContext.invocationId,
+      author: agent.name,
+      branch: invocationContext.branch,
+      content: codeContent
+    });
+    const executionId = getOrSetExecutionId(invocationContext, codeExecutorContext);
+    const codeExecutionResult = await codeExecutor.executeCode({
+      invocationContext,
+      codeExecutionInput: {
+        code: codeStr,
+        inputFiles: [file],
+        executionId
+      }
+    });
+    codeExecutorContext.updateCodeExecutionResult({
+      invocationId: invocationContext.invocationId,
+      code: codeStr,
+      resultStdout: codeExecutionResult.stdout,
+      resultStderr: codeExecutionResult.stderr
+    });
+    codeExecutorContext.addProcessedFileNames([file.name]);
+    const executionResultEvent = await postProcessCodeExecutionResult(
+      invocationContext,
+      codeExecutorContext,
+      codeExecutionResult
+    );
+    yield executionResultEvent;
+    llmRequest.contents.push((0, import_lodash.cloneDeep)(executionResultEvent.content));
+  }
+}
+async function* runPostProcessor(invocationContext, llmResponse) {
+  const agent = invocationContext.agent;
+  if (!(agent instanceof LlmAgent)) {
+    return;
+  }
+  const codeExecutor = agent.codeExecutor;
+  if (!codeExecutor || !(codeExecutor instanceof import_base_code_executor.BaseCodeExecutor)) {
+    return;
+  }
+  if (!llmResponse || !llmResponse.content) {
+    return;
+  }
+  if (codeExecutor instanceof import_built_in_code_executor.BuiltInCodeExecutor) {
+    return;
+  }
+  const codeExecutorContext = new import_code_executor_context.CodeExecutorContext(new import_state.State(invocationContext.session.state));
+  if (codeExecutorContext.getErrorCount(invocationContext.invocationId) >= codeExecutor.errorRetryAttempts) {
+    return;
+  }
+  const responseContent = llmResponse.content;
+  const codeStr = (0, import_code_execution_utils.extractCodeAndTruncateContent)(
+    responseContent,
+    codeExecutor.codeBlockDelimiters
+  );
+  if (!codeStr) {
+    return;
+  }
+  yield (0, import_event.createEvent)({
+    invocationId: invocationContext.invocationId,
+    author: agent.name,
+    branch: invocationContext.branch,
+    content: responseContent
+  });
+  const executionId = getOrSetExecutionId(invocationContext, codeExecutorContext);
+  const codeExecutionResult = await codeExecutor.executeCode({
+    invocationContext,
+    codeExecutionInput: {
+      code: codeStr,
+      inputFiles: codeExecutorContext.getInputFiles(),
+      executionId
+    }
+  });
+  codeExecutorContext.updateCodeExecutionResult({
+    invocationId: invocationContext.invocationId,
+    code: codeStr,
+    resultStdout: codeExecutionResult.stdout,
+    resultStderr: codeExecutionResult.stderr
+  });
+  yield await postProcessCodeExecutionResult(
+    invocationContext,
+    codeExecutorContext,
+    codeExecutionResult
+  );
+  llmResponse.content = null;
+}
+function extractAndReplaceInlineFiles(codeExecutorContext, llmRequest) {
+  var _a;
+  const allInputFiles = codeExecutorContext.getInputFiles();
+  const savedFileNames = new Set(allInputFiles.map((f) => f.name));
+  for (let i = 0; i < llmRequest.contents.length; i++) {
+    const content = llmRequest.contents[i];
+    if (content.role !== "user" || !content.parts) {
+      continue;
+    }
+    for (let j = 0; j < content.parts.length; j++) {
+      const part = content.parts[j];
+      const mimeType = (_a = part.inlineData) == null ? void 0 : _a.mimeType;
+      if (!mimeType || !part.inlineData || !DATA_FILE_UTIL_MAP[mimeType]) {
+        continue;
+      }
+      const fileName = `data_${i + 1}_${j + 1}${DATA_FILE_UTIL_MAP[mimeType].extension}`;
+      part.text = `
+Available file: \`${fileName}\`
+`;
+      const file = {
+        name: fileName,
+        content: (0, import_env_aware_utils.base64Decode)(part.inlineData.data),
+        mimeType
+      };
+      if (!savedFileNames.has(fileName)) {
+        codeExecutorContext.addInputFiles([file]);
+        allInputFiles.push(file);
+      }
+    }
+  }
+  return allInputFiles;
+}
+function getOrSetExecutionId(invocationContext, codeExecutorContext) {
+  var _a;
+  const agent = invocationContext.agent;
+  if (!(agent instanceof LlmAgent) || !((_a = agent.codeExecutor) == null ? void 0 : _a.stateful)) {
+    return void 0;
+  }
+  let executionId = codeExecutorContext.getExecutionId();
+  if (!executionId) {
+    executionId = invocationContext.session.id;
+    codeExecutorContext.setExecutionId(executionId);
+  }
+  return executionId;
+}
+async function postProcessCodeExecutionResult(invocationContext, codeExecutorContext, codeExecutionResult) {
+  if (!invocationContext.artifactService) {
+    throw new Error("Artifact service is not initialized.");
+  }
+  const resultContent = {
+    role: "model",
+    parts: [(0, import_code_execution_utils.buildCodeExecutionResultPart)(codeExecutionResult)]
+  };
+  const eventActions = (0, import_event_actions.createEventActions)({ stateDelta: codeExecutorContext.getStateDelta() });
+  if (codeExecutionResult.stderr) {
+    codeExecutorContext.incrementErrorCount(invocationContext.invocationId);
+  } else {
+    codeExecutorContext.resetErrorCount(invocationContext.invocationId);
+  }
+  for (const outputFile of codeExecutionResult.outputFiles) {
+    const version = await invocationContext.artifactService.saveArtifact({
+      appName: invocationContext.appName || "",
+      userId: invocationContext.userId || "",
+      sessionId: invocationContext.session.id,
+      filename: outputFile.name,
+      artifact: {
+        inlineData: { data: outputFile.content, mimeType: outputFile.mimeType }
+      }
+    });
+    eventActions.artifactDelta[outputFile.name] = version;
+  }
+  return (0, import_event.createEvent)({
+    invocationId: invocationContext.invocationId,
+    author: invocationContext.agent.name,
+    branch: invocationContext.branch,
+    content: resultContent,
+    actions: eventActions
+  });
+}
+function getDataFilePreprocessingCode(file) {
+  function getNormalizedFileName(fileName) {
+    const [varName2] = fileName.split(".");
+    let normalizedName = varName2.replace(/[^a-zA-Z0-9_]/g, "_");
+    if (/^\d/.test(normalizedName)) {
+      normalizedName = "_" + normalizedName;
+    }
+    return normalizedName;
+  }
+  if (!DATA_FILE_UTIL_MAP[file.mimeType]) {
+    return void 0;
+  }
+  const varName = getNormalizedFileName(file.name);
+  const loaderCode = DATA_FILE_UTIL_MAP[file.mimeType].loaderCodeTemplate.replace(
+    "{filename}",
+    file.name
+  );
+  return `
+${DATA_FILE_HELPER_LIB}
+
+# Load the dataframe.
+${varName} = ${loaderCode}
+
+# Use \`explore_df\` to guide my analysis.
+explore_df(${varName})
+`;
+}
+const CODE_EXECUTION_REQUEST_PROCESSOR = new CodeExecutionRequestProcessor();
 class LlmAgent extends import_base_agent.BaseAgent {
   constructor(config) {
     var _a, _b, _c, _d, _e, _f, _g, _h, _i;
@@ -372,12 +696,14 @@ class LlmAgent extends import_base_agent.BaseAgent {
     this.afterModelCallback = config.afterModelCallback;
     this.beforeToolCallback = config.beforeToolCallback;
     this.afterToolCallback = config.afterToolCallback;
+    this.codeExecutor = config.codeExecutor;
     this.requestProcessors = (_g = config.requestProcessors) != null ? _g : [
       BASIC_LLM_REQUEST_PROCESSOR,
       IDENTITY_LLM_REQUEST_PROCESSOR,
       INSTRUCTIONS_LLM_REQUEST_PROCESSOR,
       REQUEST_CONFIRMATION_LLM_REQUEST_PROCESSOR,
-      CONTENT_REQUEST_PROCESSOR
+      CONTENT_REQUEST_PROCESSOR,
+      CODE_EXECUTION_REQUEST_PROCESSOR
     ];
     this.responseProcessors = (_h = config.responseProcessors) != null ? _h : [];
     const agentTransferDisabled = this.disallowTransferToParent && this.disallowTransferToPeers && !((_i = this.subAgents) == null ? void 0 : _i.length);
@@ -427,7 +753,7 @@ class LlmAgent extends import_base_agent.BaseAgent {
    * When not set, the agent will inherit the model from its ancestor.
    */
   get canonicalModel() {
-    if (this.model instanceof import_base_llm.BaseLlm) {
+    if ((0, import_base_llm.isBaseLlm)(this.model)) {
       return this.model;
     }
     if (typeof this.model === "string" && this.model) {
@@ -861,5 +1187,6 @@ class LlmAgent extends import_base_agent.BaseAgent {
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {
   LlmAgent,
-  REQUEST_CONFIRMATION_LLM_REQUEST_PROCESSOR
+  REQUEST_CONFIRMATION_LLM_REQUEST_PROCESSOR,
+  responseProcessor
 });

package/dist/cjs/auth/exchanger/base_credential_exchanger.js

@@ -0,0 +1,40 @@
+/**
+  * @license
+  * Copyright 2025 Google LLC
+  * SPDX-License-Identifier: Apache-2.0
+  */
+
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+var base_credential_exchanger_exports = {};
+__export(base_credential_exchanger_exports, {
+  CredentialExchangeError: () => CredentialExchangeError
+});
+module.exports = __toCommonJS(base_credential_exchanger_exports);
+/**
+ * @license
+ * Copyright 2025 Google LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+class CredentialExchangeError extends Error {
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  CredentialExchangeError
+});

package/dist/cjs/auth/exchanger/credential_exchanger_registry.js

@@ -0,0 +1,59 @@
+/**
+  * @license
+  * Copyright 2025 Google LLC
+  * SPDX-License-Identifier: Apache-2.0
+  */
+
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+var credential_exchanger_registry_exports = {};
+__export(credential_exchanger_registry_exports, {
+  CredentialExchangerRegistry: () => CredentialExchangerRegistry
+});
+module.exports = __toCommonJS(credential_exchanger_registry_exports);
+/**
+ * @license
+ * Copyright 2025 Google LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+class CredentialExchangerRegistry {
+  constructor() {
+    this.exchangers = {};
+  }
+  /**
+   * Register an exchanger instance for a credential type.
+   * @param credentialType - The credential type to register for.
+   * @param exchangerInstance - The exchanger instance to register.
+   */
+  register(credentialType, exchangerInstance) {
+    this.exchangers[credentialType] = exchangerInstance;
+  }
+  /**
+   * Get the exchanger instance for a credential type.
+   * @param credentialType - The credential type to get exchanger for.
+   * @returns The exchanger instance if registered, undefined otherwise.
+   */
+  getExchanger(credentialType) {
+    return this.exchangers[credentialType];
+  }
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  CredentialExchangerRegistry
+});

package/dist/cjs/code_executors/code_execution_utils.js

@@ -32,7 +32,7 @@ __export(code_execution_utils_exports, {
 });
 module.exports = __toCommonJS(code_execution_utils_exports);
 var import_genai = require("@google/genai");
-var import_deep_clone = require("../utils/deep_clone.js");
+var import_lodash = require("lodash");
 var import_env_aware_utils = require("../utils/env_aware_utils.js");
 /**
  * @license
@@ -58,7 +58,7 @@ function extractCodeAndTruncateContent(content, codeBlockDelimiters) {
   if (!textParts.length) {
     return "";
   }
-  const firstTextPart = (0, import_deep_clone.deepClone)(textParts[0]);
+  const firstTextPart = (0, import_lodash.cloneDeep)(textParts[0]);
   const responseText = textParts.map((part) => part.text).join("\n");
   const leadingDelimiterPattern = codeBlockDelimiters.map((d) => d[0]).join("|");
   const trailingDelimiterPattern = codeBlockDelimiters.map((d) => d[1]).join("|");

package/dist/cjs/code_executors/code_executor_context.js

@@ -27,7 +27,7 @@ __export(code_executor_context_exports, {
   CodeExecutorContext: () => CodeExecutorContext
 });
 module.exports = __toCommonJS(code_executor_context_exports);
-var import_deep_clone = require("../utils/deep_clone.js");
+var import_lodash = require("lodash");
 /**
  * @license
  * Copyright 2025 Google LLC
@@ -52,7 +52,7 @@ class CodeExecutorContext {
    */
   getStateDelta() {
     return {
-      [CONTEXT_KEY]: (0, import_deep_clone.deepClone)(this.context)
+      [CONTEXT_KEY]: (0, import_lodash.cloneDeep)(this.context)
     };
   }
   /**

package/dist/cjs/common.js

@@ -31,6 +31,7 @@ __export(common_exports, {
   BasePlugin: () => import_base_plugin.BasePlugin,
   BaseTool: () => import_base_tool.BaseTool,
   BaseToolset: () => import_base_toolset.BaseToolset,
+  BuiltInCodeExecutor: () => import_built_in_code_executor.BuiltInCodeExecutor,
   CallbackContext: () => import_callback_context.CallbackContext,
   FunctionTool: () => import_function_tool.FunctionTool,
   GOOGLE_SEARCH: () => import_google_search_tool.GOOGLE_SEARCH,
@@ -67,6 +68,8 @@ __export(common_exports, {
   getFunctionCalls: () => import_event.getFunctionCalls,
   getFunctionResponses: () => import_event.getFunctionResponses,
   hasTrailingCodeExecutionResult: () => import_event.hasTrailingCodeExecutionResult,
+  isBaseAgent: () => import_base_agent.isBaseAgent,
+  isBaseLlm: () => import_base_llm.isBaseLlm,
   isFinalResponse: () => import_event.isFinalResponse,
   setLogLevel: () => import_logger.setLogLevel,
   stringifyContent: () => import_event.stringifyContent,
@@ -85,6 +88,7 @@ var import_parallel_agent = require("./agents/parallel_agent.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_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_in_memory_memory_service = require("./memory/in_memory_memory_service.js");
@@ -128,6 +132,7 @@ __reExport(common_exports, require("./tools/base_tool.js"), module.exports);
   BasePlugin,
   BaseTool,
   BaseToolset,
+  BuiltInCodeExecutor,
   CallbackContext,
   FunctionTool,
   GOOGLE_SEARCH,
@@ -164,6 +169,8 @@ __reExport(common_exports, require("./tools/base_tool.js"), module.exports);
   getFunctionCalls,
   getFunctionResponses,
   hasTrailingCodeExecutionResult,
+  isBaseAgent,
+  isBaseLlm,
   isFinalResponse,
   setLogLevel,
   stringifyContent,