@softactivate/adk 1.1.0

package/dist/cjs/auth/refresher/credential_refresher_registry.js

@@ -0,0 +1,68 @@
+/**
+  * @license
+  * Copyright 2026 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_refresher_registry_exports = {};
+__export(credential_refresher_registry_exports, {
+  CredentialRefresherRegistry: () => CredentialRefresherRegistry
+});
+module.exports = __toCommonJS(credential_refresher_registry_exports);
+var import_auth_credential = require("../auth_credential.js");
+/**
+ * @license
+ * Copyright 2026 Google LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+class CredentialRefresherRegistry {
+  constructor() {
+    this.refreshers = {
+      [import_auth_credential.AuthCredentialTypes.API_KEY]: void 0,
+      [import_auth_credential.AuthCredentialTypes.HTTP]: void 0,
+      [import_auth_credential.AuthCredentialTypes.OAUTH2]: void 0,
+      [import_auth_credential.AuthCredentialTypes.OPEN_ID_CONNECT]: void 0,
+      [import_auth_credential.AuthCredentialTypes.SERVICE_ACCOUNT]: void 0
+    };
+  }
+  /**
+   * Register a refresher instance for a credential type.
+   *
+   * @param credentialType The credential type to register for.
+   * @param refresherInstance The refresher instance to register.
+   */
+  register(credentialType, refresherInstance) {
+    this.refreshers[credentialType] = refresherInstance;
+  }
+  /**
+   * Get the refresher instance for a credential type.
+   *
+   * @param credentialType The credential type to get refresher for.
+   * @returns The refresher instance if registered, undefined otherwise.
+   */
+  getRefresher(credentialType) {
+    return this.refreshers[credentialType];
+  }
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  CredentialRefresherRegistry
+});

package/dist/cjs/code_executors/base_code_executor.js

@@ -0,0 +1,92 @@
+/**
+  * @license
+  * Copyright 2026 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_code_executor_exports = {};
+__export(base_code_executor_exports, {
+  BaseCodeExecutor: () => BaseCodeExecutor,
+  isBaseCodeExecutor: () => isBaseCodeExecutor
+});
+module.exports = __toCommonJS(base_code_executor_exports);
+/**
+ * @license
+ * 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.
+     *
+     * Supported data file MimeTypes are [text/csv].
+     * Default to false.
+     */
+    this.optimizeDataFile = false;
+    /**
+     * Whether the code executor is stateful. Default to false.
+     */
+    this.stateful = false;
+    /**
+     * The number of attempts to retry on consecutive code execution errors.
+     * Default to 2.
+     */
+    this.errorRetryAttempts = 2;
+    /**
+     * The list of the enclosing delimiters to identify the code blocks.
+     * For example, the delimiter('```javascript\\n', '\\n```') can be used to
+     * identify code blocks with the following format:
+     *
+     * ```javascript
+     *  console.log("hello")
+     * ```
+     */
+    this.codeBlockDelimiters = [
+      ["```tool_code\n", "\n```"],
+      ["```python\n", "\n```"],
+      ["```javascript\n", "\n```"],
+      ["```typescript\n", "\n```"],
+      ["```bash\n", "\n```"],
+      ["```sh\n", "\n```"]
+    ];
+    /**
+     * The delimiters to format the code execution result.
+     */
+    this.executionResultDelimiters = ["```tool_output\n", "\n```"];
+  }
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  BaseCodeExecutor,
+  isBaseCodeExecutor
+});

package/dist/cjs/code_executors/built_in_code_executor.js

@@ -0,0 +1,74 @@
+/**
+  * @license
+  * Copyright 2026 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 built_in_code_executor_exports = {};
+__export(built_in_code_executor_exports, {
+  BuiltInCodeExecutor: () => BuiltInCodeExecutor,
+  isBuiltInCodeExecutor: () => isBuiltInCodeExecutor
+});
+module.exports = __toCommonJS(built_in_code_executor_exports);
+var import_model_name = require("../utils/model_name.js");
+var import_base_code_executor = require("./base_code_executor.js");
+/**
+ * @license
+ * Copyright 2025 Google LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+var _a, _b;
+const BUILT_IN_CODE_EXECUTOR_SIGNATURE_SYMBOL = Symbol.for(
+  "google.adk.builtInCodeExecutor"
+);
+function isBuiltInCodeExecutor(obj) {
+  return typeof obj === "object" && obj !== null && BUILT_IN_CODE_EXECUTOR_SIGNATURE_SYMBOL in obj && obj[BUILT_IN_CODE_EXECUTOR_SIGNATURE_SYMBOL] === true;
+}
+class BuiltInCodeExecutor extends (_b = import_base_code_executor.BaseCodeExecutor, _a = BUILT_IN_CODE_EXECUTOR_SIGNATURE_SYMBOL, _b) {
+  constructor() {
+    super(...arguments);
+    /** A unique symbol to identify BuiltInCodeExecutor class. */
+    this[_a] = true;
+  }
+  executeCode(_params) {
+    return Promise.resolve({
+      stdout: "",
+      stderr: "",
+      outputFiles: []
+    });
+  }
+  processLlmRequest(llmRequest) {
+    if (llmRequest.model && (0, import_model_name.isGemini2OrAbove)(llmRequest.model)) {
+      llmRequest.config = llmRequest.config || {};
+      llmRequest.config.tools = llmRequest.config.tools || [];
+      llmRequest.config.tools.push({ codeExecution: {} });
+      return;
+    }
+    throw new Error(
+      `Gemini code execution tool is not supported for model ${llmRequest.model}`
+    );
+  }
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  BuiltInCodeExecutor,
+  isBuiltInCodeExecutor
+});

package/dist/cjs/code_executors/code_execution_utils.js

@@ -0,0 +1,161 @@
+/**
+  * @license
+  * Copyright 2026 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 code_execution_utils_exports = {};
+__export(code_execution_utils_exports, {
+  CodeExecutionLanguage: () => CodeExecutionLanguage,
+  FileContentEncoding: () => FileContentEncoding,
+  buildCodeExecutionResultPart: () => buildCodeExecutionResultPart,
+  buildExecutableCodePart: () => buildExecutableCodePart,
+  convertCodeExecutionParts: () => convertCodeExecutionParts,
+  extractCodeAndTruncateContent: () => extractCodeAndTruncateContent,
+  getEncodedFileContent: () => getEncodedFileContent
+});
+module.exports = __toCommonJS(code_execution_utils_exports);
+var import_genai = require("@google/genai");
+var import_lodash_es = require("lodash-es");
+var import_env_aware_utils = require("../utils/env_aware_utils.js");
+/**
+ * @license
+ * Copyright 2025 Google LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+var FileContentEncoding = /* @__PURE__ */ ((FileContentEncoding2) => {
+  FileContentEncoding2["UTF8"] = "utf-8";
+  FileContentEncoding2["BASE64"] = "base64";
+  return FileContentEncoding2;
+})(FileContentEncoding || {});
+var CodeExecutionLanguage = /* @__PURE__ */ ((CodeExecutionLanguage2) => {
+  CodeExecutionLanguage2["UNSPECIFIED"] = "unspecified";
+  CodeExecutionLanguage2["PYTHON"] = "python";
+  CodeExecutionLanguage2["JAVASCRIPT"] = "javascript";
+  CodeExecutionLanguage2["TYPESCRIPT"] = "typescript";
+  CodeExecutionLanguage2["SHELL"] = "shell";
+  CodeExecutionLanguage2["POWERSHELL"] = "powershell";
+  CodeExecutionLanguage2["WINDOWS_CMD"] = "cmd";
+  return CodeExecutionLanguage2;
+})(CodeExecutionLanguage || {});
+function getEncodedFileContent(data) {
+  return (0, import_env_aware_utils.isBase64Encoded)(data) ? data : (0, import_env_aware_utils.base64Encode)(data);
+}
+function extractCodeAndTruncateContent(content, codeBlockDelimiters) {
+  var _a;
+  if (!((_a = content.parts) == null ? void 0 : _a.length)) {
+    return "";
+  }
+  for (let i = 0; i < content.parts.length; i++) {
+    const part = content.parts[i];
+    if (part.executableCode && (i === content.parts.length - 1 || !content.parts[i + 1].codeExecutionResult)) {
+      content.parts = content.parts.slice(0, i + 1);
+      return part.executableCode.code;
+    }
+  }
+  const textParts = content.parts.filter((part) => part.text);
+  if (!textParts.length) {
+    return "";
+  }
+  const firstTextPart = (0, import_lodash_es.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("|");
+  const match = new RegExp(
+    `?<prefix>.*?)(${leadingDelimiterPattern})(?<codeStr>.*?)(${trailingDelimiterPattern})(?<suffix>.*?)$`,
+    "s"
+  ).exec(responseText);
+  const { prefix, codeStr } = (match == null ? void 0 : match.groups) || {};
+  if (!codeStr) {
+    return "";
+  }
+  content.parts = [];
+  if (prefix) {
+    firstTextPart.text = prefix;
+    content.parts.push(firstTextPart);
+  }
+  content.parts.push(buildExecutableCodePart(codeStr));
+  return codeStr;
+}
+function buildExecutableCodePart(code) {
+  return {
+    text: code,
+    executableCode: {
+      code,
+      language: import_genai.Language.PYTHON
+    }
+  };
+}
+function buildCodeExecutionResultPart(codeExecutionResult) {
+  if (codeExecutionResult.stderr) {
+    return {
+      text: codeExecutionResult.stderr,
+      codeExecutionResult: {
+        outcome: import_genai.Outcome.OUTCOME_FAILED
+      }
+    };
+  }
+  const finalResult = [];
+  if (codeExecutionResult.stdout || !codeExecutionResult.outputFiles) {
+    finalResult.push(`Code execution result:
+${codeExecutionResult.stdout}
+`);
+  }
+  if (codeExecutionResult.outputFiles) {
+    finalResult.push(
+      `Saved artifacts:
+` + codeExecutionResult.outputFiles.map((f) => f.name).join(", ")
+    );
+  }
+  return {
+    text: finalResult.join("\n\n"),
+    codeExecutionResult: {
+      outcome: import_genai.Outcome.OUTCOME_OK
+    }
+  };
+}
+function convertCodeExecutionParts(content, codeBlockDelimiter, executionResultDelimiters) {
+  var _a;
+  if (!((_a = content.parts) == null ? void 0 : _a.length)) {
+    return;
+  }
+  const lastPart = content.parts[content.parts.length - 1];
+  if (lastPart.executableCode) {
+    content.parts[content.parts.length - 1] = {
+      text: codeBlockDelimiter[0] + lastPart.executableCode.code + codeBlockDelimiter[1]
+    };
+  } else if (content.parts.length == 1 && lastPart.codeExecutionResult) {
+    content.parts[content.parts.length - 1] = {
+      text: executionResultDelimiters[0] + lastPart.codeExecutionResult.output + executionResultDelimiters[1]
+    };
+    content.role = "user";
+  }
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  CodeExecutionLanguage,
+  FileContentEncoding,
+  buildCodeExecutionResultPart,
+  buildExecutableCodePart,
+  convertCodeExecutionParts,
+  extractCodeAndTruncateContent,
+  getEncodedFileContent
+});

package/dist/cjs/code_executors/code_executor_context.js

@@ -0,0 +1,198 @@
+/**
+  * @license
+  * Copyright 2026 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 code_executor_context_exports = {};
+__export(code_executor_context_exports, {
+  CodeExecutorContext: () => CodeExecutorContext
+});
+module.exports = __toCommonJS(code_executor_context_exports);
+var import_lodash_es = require("lodash-es");
+/**
+ * @license
+ * Copyright 2025 Google LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+const CONTEXT_KEY = "_code_execution_context";
+const SESSION_ID_KEY = "execution_session_id";
+const PROCESSED_FILE_NAMES_KEY = "processed_input_files";
+const INPUT_FILE_KEY = "_code_executor_input_files";
+const ERROR_COUNT_KEY = "_code_executor_error_counts";
+const CODE_EXECUTION_RESULTS_KEY = "_code_execution_results";
+class CodeExecutorContext {
+  constructor(sessionState) {
+    this.sessionState = sessionState;
+    var _a;
+    this.context = (_a = sessionState.get(CONTEXT_KEY)) != null ? _a : {};
+    this.sessionState = sessionState;
+  }
+  /**
+   * Gets the state delta to update in the persistent session state.
+   * @return The state delta to update in the persistent session state.
+   */
+  getStateDelta() {
+    return {
+      [CONTEXT_KEY]: (0, import_lodash_es.cloneDeep)(this.context)
+    };
+  }
+  /**
+   * Gets the execution ID for the code executor.
+   * @return The execution ID for the code executor.
+   */
+  getExecutionId() {
+    if (!(SESSION_ID_KEY in this.context)) {
+      return void 0;
+    }
+    return this.context[SESSION_ID_KEY];
+  }
+  /**
+   * Sets the execution ID for the code executor.
+   * @param executionId The execution ID to set.
+   */
+  setExecutionId(executionId) {
+    this.context[SESSION_ID_KEY] = executionId;
+  }
+  /**
+   * Gets the processed file names from the session state.
+   * @return A list of processed file names in the code executor context.
+   */
+  getProcessedFileNames() {
+    if (!(PROCESSED_FILE_NAMES_KEY in this.context)) {
+      return [];
+    }
+    return this.context[PROCESSED_FILE_NAMES_KEY];
+  }
+  /**
+   * Adds the processed file names to the session state.
+   * @param fileNames The file names to add to the session state.
+   */
+  addProcessedFileNames(fileNames) {
+    if (!(PROCESSED_FILE_NAMES_KEY in this.context)) {
+      this.context[PROCESSED_FILE_NAMES_KEY] = [];
+    }
+    this.context[PROCESSED_FILE_NAMES_KEY].push(...fileNames);
+  }
+  /**
+   * Gets the input files from the session state.
+   * @return A list of input files in the code executor context.
+   */
+  getInputFiles() {
+    if (!(INPUT_FILE_KEY in this.sessionState)) {
+      return [];
+    }
+    return this.sessionState.get(INPUT_FILE_KEY);
+  }
+  /**
+   * Adds the input files to the session state.
+   * @param inputFiles The input files to add to the session state.
+   */
+  addInputFiles(inputFiles) {
+    if (!(INPUT_FILE_KEY in this.sessionState)) {
+      this.sessionState.set(INPUT_FILE_KEY, []);
+    }
+    this.sessionState.get(INPUT_FILE_KEY).push(...inputFiles);
+  }
+  clearInputFiles() {
+    if (INPUT_FILE_KEY in this.sessionState) {
+      this.sessionState.set(INPUT_FILE_KEY, []);
+    }
+    if (PROCESSED_FILE_NAMES_KEY in this.context) {
+      this.context[PROCESSED_FILE_NAMES_KEY] = [];
+    }
+  }
+  /**
+   * Gets the error count from the session state.
+   * @param invocationId The invocation ID to get the error count for.
+   * @return The error count for the given invocation ID.
+   */
+  getErrorCount(invocationId) {
+    if (!(ERROR_COUNT_KEY in this.sessionState)) {
+      return 0;
+    }
+    return this.sessionState.get(ERROR_COUNT_KEY)[invocationId] || 0;
+  }
+  /**
+   * Increments the error count from the session state.
+   * @param invocationId The invocation ID to increment the error count for.
+   */
+  incrementErrorCount(invocationId) {
+    if (!(ERROR_COUNT_KEY in this.sessionState)) {
+      this.sessionState.set(ERROR_COUNT_KEY, {});
+    }
+    this.sessionState.get(ERROR_COUNT_KEY)[invocationId] = this.getErrorCount(invocationId) + 1;
+  }
+  /**
+   * Resets the error count from the session state.
+   * @param invocationId The invocation ID to reset the error count for.
+   */
+  resetErrorCount(invocationId) {
+    if (!(ERROR_COUNT_KEY in this.sessionState)) {
+      return;
+    }
+    const errorCounts = this.sessionState.get(ERROR_COUNT_KEY);
+    if (invocationId in errorCounts) {
+      delete errorCounts[invocationId];
+    }
+  }
+  /**
+   * Updates the code execution result.
+   * @param invocationId The invocation ID to update the code execution result
+   *     for.
+   * @param code The code to execute.
+   * @param resultStdout The standard output of the code execution.
+   * @param resultStderr The standard error of the code execution.
+   */
+  updateCodeExecutionResult({
+    invocationId,
+    code,
+    resultStdout,
+    resultStderr
+  }) {
+    if (!(CODE_EXECUTION_RESULTS_KEY in this.sessionState)) {
+      this.sessionState.set(CODE_EXECUTION_RESULTS_KEY, {});
+    }
+    const codeExecutionResults = this.sessionState.get(
+      CODE_EXECUTION_RESULTS_KEY
+    );
+    if (!(invocationId in codeExecutionResults)) {
+      codeExecutionResults[invocationId] = [];
+    }
+    codeExecutionResults[invocationId].push({
+      code,
+      resultStdout,
+      resultStderr,
+      timestamp: Date.now()
+    });
+  }
+  /**
+   * Gets the code execution context from the session state.
+   * @return The code execution context for the given invocation ID.
+   */
+  getCodeExecutionContext() {
+    return this.sessionState.get(CONTEXT_KEY) || {};
+  }
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  CodeExecutorContext
+});