@google/adk 2.0.0 → 2.1.0

package/dist/esm/errors/already_exists_error.js

@@ -0,0 +1,23 @@
+import {createRequire as topLevelCreateRequire} from 'module';
+const require = topLevelCreateRequire(import.meta.url);
+var __defProp = Object.defineProperty;
+var __name = (target, value) => __defProp(target, "name", { value, configurable: true });
+/**
+ * @license
+ * Copyright 2026 Google LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+const _AlreadyExistsError = class _AlreadyExistsError extends Error {
+  /**
+   * @param message An optional custom message to describe the error.
+   */
+  constructor(message = "The resource already exists.") {
+    super(message);
+    this.name = "AlreadyExistsError";
+  }
+};
+__name(_AlreadyExistsError, "AlreadyExistsError");
+let AlreadyExistsError = _AlreadyExistsError;
+export {
+  AlreadyExistsError
+};

package/dist/esm/errors/input_validation_error.js

@@ -0,0 +1,23 @@
+import {createRequire as topLevelCreateRequire} from 'module';
+const require = topLevelCreateRequire(import.meta.url);
+var __defProp = Object.defineProperty;
+var __name = (target, value) => __defProp(target, "name", { value, configurable: true });
+/**
+ * @license
+ * Copyright 2026 Google LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+const _InputValidationError = class _InputValidationError extends Error {
+  /**
+   * @param message A message describing why the input is invalid.
+   */
+  constructor(message = "Invalid input.") {
+    super(message);
+    this.name = "InputValidationError";
+  }
+};
+__name(_InputValidationError, "InputValidationError");
+let InputValidationError = _InputValidationError;
+export {
+  InputValidationError
+};

package/dist/{web/auth/refresher/base_credential_refresher.js → esm/errors/not_found_error.js}

@@ -7,14 +7,17 @@ var __name = (target, value) => __defProp(target, "name", { value, configurable:
  * Copyright 2026 Google LLC
  * SPDX-License-Identifier: Apache-2.0
  */
-const _CredentialRefresherError = class _CredentialRefresherError extends Error {
-  constructor(message) {
+const _NotFoundError = class _NotFoundError extends Error {
+  /**
+   * @param message An optional custom message to describe the error.
+   */
+  constructor(message = "The requested item was not found.") {
     super(message);
-    this.name = "CredentialRefresherError";
+    this.name = "NotFoundError";
   }
 };
-__name(_CredentialRefresherError, "CredentialRefresherError");
-let CredentialRefresherError = _CredentialRefresherError;
+__name(_NotFoundError, "NotFoundError");
+let NotFoundError = _NotFoundError;
 export {
-  CredentialRefresherError
+  NotFoundError
 };

package/dist/esm/errors/session_not_found_error.js

@@ -0,0 +1,23 @@
+import {createRequire as topLevelCreateRequire} from 'module';
+const require = topLevelCreateRequire(import.meta.url);
+var __defProp = Object.defineProperty;
+var __name = (target, value) => __defProp(target, "name", { value, configurable: true });
+/**
+ * @license
+ * Copyright 2026 Google LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+const _SessionNotFoundError = class _SessionNotFoundError extends Error {
+  /**
+   * @param message An optional custom message to describe the error.
+   */
+  constructor(message = "Session not found.") {
+    super(message);
+    this.name = "SessionNotFoundError";
+  }
+};
+__name(_SessionNotFoundError, "SessionNotFoundError");
+let SessionNotFoundError = _SessionNotFoundError;
+export {
+  SessionNotFoundError
+};

package/dist/esm/errors/tool_execution_error.js

@@ -0,0 +1,40 @@
+import {createRequire as topLevelCreateRequire} from 'module';
+const require = topLevelCreateRequire(import.meta.url);
+var __defProp = Object.defineProperty;
+var __name = (target, value) => __defProp(target, "name", { value, configurable: true });
+/**
+ * @license
+ * Copyright 2026 Google LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+var ToolErrorType = /* @__PURE__ */ ((ToolErrorType2) => {
+  ToolErrorType2["BAD_REQUEST"] = "BAD_REQUEST";
+  ToolErrorType2["UNAUTHORIZED"] = "UNAUTHORIZED";
+  ToolErrorType2["FORBIDDEN"] = "FORBIDDEN";
+  ToolErrorType2["NOT_FOUND"] = "NOT_FOUND";
+  ToolErrorType2["REQUEST_TIMEOUT"] = "REQUEST_TIMEOUT";
+  ToolErrorType2["INTERNAL_SERVER_ERROR"] = "INTERNAL_SERVER_ERROR";
+  ToolErrorType2["BAD_GATEWAY"] = "BAD_GATEWAY";
+  ToolErrorType2["SERVICE_UNAVAILABLE"] = "SERVICE_UNAVAILABLE";
+  ToolErrorType2["GATEWAY_TIMEOUT"] = "GATEWAY_TIMEOUT";
+  return ToolErrorType2;
+})(ToolErrorType || {});
+const _ToolExecutionError = class _ToolExecutionError extends Error {
+  /**
+   * @param message A message describing the error.
+   * @param errorType The semantic error type (e.g.
+   *   {@link ToolErrorType.REQUEST_TIMEOUT} or `'500'`). Used to populate the
+   *   `error.type` span attribute in OpenTelemetry traces.
+   */
+  constructor(message, errorType) {
+    super(message);
+    this.errorType = errorType;
+    this.name = "ToolExecutionError";
+  }
+};
+__name(_ToolExecutionError, "ToolExecutionError");
+let ToolExecutionError = _ToolExecutionError;
+export {
+  ToolErrorType,
+  ToolExecutionError
+};

package/dist/esm/events/event.js

@@ -10,7 +10,7 @@ var __name = (target, value) => __defProp(target, "name", { value, configurable:
 import { randomUUID } from "../utils/env_aware_utils.js";
 import { toCamelCase, toSnakeCase } from "../utils/object_notation_utils.js";
 import { createEventActions } from "./event_actions.js";
-const EVENT_SIGNATURE_SYMBOL = Symbol.for("google.adk.event");
+const EVENT_SIGNATURE_SYMBOL = /* @__PURE__ */ Symbol.for("google.adk.event");
 function createEvent(params = {}) {
   return {
     ...params,

package/dist/esm/events/event_actions.js

@@ -7,6 +7,7 @@ var __name = (target, value) => __defProp(target, "name", { value, configurable:
  * Copyright 2026 Google LLC
  * SPDX-License-Identifier: Apache-2.0
  */
+import { isEmpty } from "lodash-es";
 import { carryDeltaStamps } from "../sessions/state_write_order.js";
 function createEventActions(state = {}) {
   return {
@@ -18,6 +19,10 @@ function createEventActions(state = {}) {
   };
 }
 __name(createEventActions, "createEventActions");
+function isDefaultEventActions(actions) {
+  return isEmpty(actions.stateDelta) && isEmpty(actions.artifactDelta) && isEmpty(actions.requestedAuthConfigs) && isEmpty(actions.requestedToolConfirmations) && actions.skipSummarization === void 0 && actions.transferToAgent === void 0 && actions.escalate === void 0;
+}
+__name(isDefaultEventActions, "isDefaultEventActions");
 function mergeEventActions(sources, target) {
   const result = createEventActions();
   if (target) {
@@ -56,5 +61,6 @@ function mergeEventActions(sources, target) {
 __name(mergeEventActions, "mergeEventActions");
 export {
   createEventActions,
+  isDefaultEventActions,
   mergeEventActions
 };

package/dist/esm/examples/base_example_provider.js

@@ -8,7 +8,7 @@ var __name = (target, value) => __defProp(target, "name", { value, configurable:
  * SPDX-License-Identifier: Apache-2.0
  */
 var _a;
-const BASE_EXAMPLE_PROVIDER_SIGNATURE_SYMBOL = Symbol.for(
+const BASE_EXAMPLE_PROVIDER_SIGNATURE_SYMBOL = /* @__PURE__ */ Symbol.for(
   "google.adk.baseExampleProvider"
 );
 function isBaseExampleProvider(obj) {

package/dist/esm/index.js

@@ -5,6 +5,8 @@ const require = topLevelCreateRequire(import.meta.url);
  * Copyright 2025 Google LLC
  * SPDX-License-Identifier: Apache-2.0
  */
+import { installNodeLogger } from "./utils/logger_node.js";
+installNodeLogger();
 export * from "./a2a/index.js";
 import { InvocationContext } from "./agents/invocation_context.js";
 import { FileArtifactService } from "./artifacts/file_artifact_service.js";
@@ -14,24 +16,43 @@ import {
   AgentEngineSandboxCodeExecutor
 } from "./code_executors/agent_engine_sandbox_code_executor.js";
 import { CodeExecutionLanguage } from "./code_executors/code_execution_utils.js";
+import {
+  ContainerCodeExecutor
+} from "./code_executors/container_code_executor.js";
 import {
   UnsafeLocalCodeExecutor
 } from "./code_executors/unsafe_local_code_executor.js";
 export * from "./common.js";
 import { LocalEnvironment } from "./environment/local_environment.js";
+import { VertexAiMemoryBankService } from "./memory/vertex_ai_memory_bank_service.js";
+import { VertexAiRagMemoryService } from "./memory/vertex_ai_rag_memory_service.js";
 import { DatabaseSessionService } from "./sessions/database_session_service.js";
 import { getSessionServiceFromUri } from "./sessions/registry.js";
 import { VertexAiSessionService } from "./sessions/vertex_ai_session_service.js";
+import { GCPSkillRegistry } from "./skills/gcp_skill_registry.js";
 import {
   loadAllSkillsInDir,
   loadSkillFromDir,
+  loadSkillFromZipBuffer,
   validateSkillDir
 } from "./skills/loader.js";
+import { LOAD_WEB_PAGE, loadWebPage } from "./tools/load_web_page.js";
+import { OpenApiSpecParser } from "./tools/openapi_tool/openapi_spec_parser/openapi_spec_parser.js";
+import { OperationParser } from "./tools/openapi_tool/openapi_spec_parser/operation_parser.js";
+import { ToolAuthHandler } from "./tools/openapi_tool/openapi_spec_parser/tool_auth_handler.js";
+import { OpenAPIToolset } from "./tools/openapi_tool/openapi_toolset.js";
+import {
+  createRestApiTool,
+  RestApiTool
+} from "./tools/openapi_tool/rest_api_tool.js";
+import { FilesRetrieval } from "./tools/retrieval/files_retrieval.js";
+import { LoadSkillResourceTool } from "./tools/skill/load_skill_resource_tool.js";
 import {
   RunSkillInlineScriptErrorCode,
   RunSkillInlineScriptTool
 } from "./tools/skill/run_skill_inline_script_tool.js";
 import { RunSkillScriptTool } from "./tools/skill/run_skill_script_tool.js";
+import { SkillToolset } from "./tools/skill/skill_toolset.js";
 export * from "./integrations/agent_registry/agent_registry.js";
 export * from "./telemetry/google_cloud.js";
 export * from "./telemetry/setup.js";
@@ -39,19 +60,35 @@ export * from "./tools/mcp/index.js";
 export {
   AgentEngineSandboxCodeExecutor,
   CodeExecutionLanguage,
+  ContainerCodeExecutor,
   DatabaseSessionService,
   FileArtifactService,
+  FilesRetrieval,
+  GCPSkillRegistry,
   GcsArtifactService,
   InvocationContext,
+  LOAD_WEB_PAGE,
+  LoadSkillResourceTool,
   LocalEnvironment,
+  OpenAPIToolset,
+  OpenApiSpecParser,
+  OperationParser,
+  RestApiTool,
   RunSkillInlineScriptErrorCode,
   RunSkillInlineScriptTool,
   RunSkillScriptTool,
+  SkillToolset,
+  ToolAuthHandler,
   UnsafeLocalCodeExecutor,
+  VertexAiMemoryBankService,
+  VertexAiRagMemoryService,
   VertexAiSessionService,
+  createRestApiTool,
   getArtifactServiceFromUri,
   getSessionServiceFromUri,
   loadAllSkillsInDir,
   loadSkillFromDir,
+  loadSkillFromZipBuffer,
+  loadWebPage,
   validateSkillDir
 };

package/dist/esm/index_web.js

@@ -5,4 +5,6 @@ const require = topLevelCreateRequire(import.meta.url);
  * Copyright 2025 Google LLC
  * SPDX-License-Identifier: Apache-2.0
  */
+import { installBrowserLogger } from "./utils/logger_browser.js";
+installBrowserLogger();
 export * from "./common.js";

package/dist/esm/integrations/agent_registry/agent_registry.js

@@ -318,8 +318,9 @@ const _AgentRegistry = class _AgentRegistry {
       capabilities: {
         streaming: false
       },
-      defaultInputModes: ["text"],
-      defaultOutputModes: ["text"]
+      // The A2A spec defines the default modes as media types.
+      defaultInputModes: ["text/plain"],
+      defaultOutputModes: ["text/plain"]
     };
     return new RemoteA2AAgent({
       name,

package/dist/esm/memory/rag_memory_transcript.js

@@ -0,0 +1,106 @@
+import {createRequire as topLevelCreateRequire} from 'module';
+const require = topLevelCreateRequire(import.meta.url);
+var __defProp = Object.defineProperty;
+var __name = (target, value) => __defProp(target, "name", { value, configurable: true });
+/**
+ * @license
+ * Copyright 2026 Google LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+const SOURCE_DISPLAY_NAME_PREFIX = "adk-memory-v1.";
+const SOURCE_DISPLAY_NAME_SEGMENTS = 3;
+const MILLISECONDS_PER_SECOND = 1e3;
+function encodeSegment(value) {
+  return Buffer.from(value, "utf-8").toString("base64url");
+}
+__name(encodeSegment, "encodeSegment");
+function decodeSegment(segment) {
+  if (!segment) {
+    return void 0;
+  }
+  const decoded = Buffer.from(segment, "base64url").toString("utf-8");
+  return encodeSegment(decoded) === segment ? decoded : void 0;
+}
+__name(decodeSegment, "decodeSegment");
+function buildSourceDisplayName(appName, userId, sessionId) {
+  const segments = [appName, userId, sessionId].map(encodeSegment);
+  return SOURCE_DISPLAY_NAME_PREFIX + segments.join(".");
+}
+__name(buildSourceDisplayName, "buildSourceDisplayName");
+function parseSourceDisplayName(displayName) {
+  const isPrefixed = displayName.startsWith(SOURCE_DISPLAY_NAME_PREFIX);
+  const raw = isPrefixed ? displayName.slice(SOURCE_DISPLAY_NAME_PREFIX.length) : displayName;
+  const parts = raw.split(".");
+  if (parts.length !== SOURCE_DISPLAY_NAME_SEGMENTS) {
+    return void 0;
+  }
+  if (!isPrefixed) {
+    return { appName: parts[0], userId: parts[1], sessionId: parts[2] };
+  }
+  const [appName, userId, sessionId] = parts.map(decodeSegment);
+  if (appName === void 0 || userId === void 0 || sessionId === void 0) {
+    return void 0;
+  }
+  return { appName, userId, sessionId };
+}
+__name(parseSourceDisplayName, "parseSourceDisplayName");
+function serializeSessionTranscript(session) {
+  var _a, _b, _c;
+  const lines = [];
+  for (const event of session.events) {
+    const texts = [];
+    for (const part of (_b = (_a = event.content) == null ? void 0 : _a.parts) != null ? _b : []) {
+      if (part.text) {
+        texts.push(part.text.replaceAll("\n", " "));
+      }
+    }
+    if (texts.length === 0) {
+      continue;
+    }
+    lines.push(
+      JSON.stringify({
+        author: (_c = event.author) != null ? _c : "",
+        timestamp: event.timestamp / MILLISECONDS_PER_SECOND,
+        text: texts.join(".")
+      })
+    );
+  }
+  return lines.join("\n");
+}
+__name(serializeSessionTranscript, "serializeSessionTranscript");
+function parseTranscriptLine(line) {
+  let parsed;
+  try {
+    parsed = JSON.parse(line);
+  } catch {
+    return void 0;
+  }
+  if (parsed === null || typeof parsed !== "object") {
+    return void 0;
+  }
+  const record = parsed;
+  const seconds = typeof record["timestamp"] === "number" ? record["timestamp"] : 0;
+  return {
+    author: typeof record["author"] === "string" ? record["author"] : "",
+    timestamp: seconds * MILLISECONDS_PER_SECOND,
+    text: typeof record["text"] === "string" ? record["text"] : ""
+  };
+}
+__name(parseTranscriptLine, "parseTranscriptLine");
+function parseTranscriptEvents(text) {
+  const events = [];
+  for (const line of text.split("\n")) {
+    const event = parseTranscriptLine(line);
+    if (event) {
+      events.push(event);
+    }
+  }
+  return events;
+}
+__name(parseTranscriptEvents, "parseTranscriptEvents");
+export {
+  buildSourceDisplayName,
+  parseSourceDisplayName,
+  parseTranscriptEvents,
+  serializeSessionTranscript
+};

package/dist/esm/memory/vertex_ai_memory_bank_service.js

@@ -213,7 +213,7 @@ const _VertexAiMemoryBankService = class _VertexAiMemoryBankService {
         config
       };
       const operation = await this.memories.createInternal(params);
-      logger.info("Create memory response received.");
+      logger.debug("Create memory response received.");
       logger.debug(`Create memory response: ${JSON.stringify(operation)}`);
     }
   }
@@ -237,7 +237,7 @@ const _VertexAiMemoryBankService = class _VertexAiMemoryBankService {
         config
       };
       const operation = await this.memories.generateInternal(params);
-      logger.info("Generate direct memory response received.");
+      logger.debug("Generate direct memory response received.");
       logger.debug(
         `Generate direct memory response: ${JSON.stringify(operation)}`
       );

package/dist/esm/memory/vertex_ai_rag_api.js

@@ -0,0 +1,93 @@
+import {createRequire as topLevelCreateRequire} from 'module';
+const require = topLevelCreateRequire(import.meta.url);
+var __defProp = Object.defineProperty;
+var __name = (target, value) => __defProp(target, "name", { value, configurable: true });
+/**
+ * @license
+ * Copyright 2026 Google LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import { GoogleAuth } from "google-auth-library";
+const CLOUD_PLATFORM_SCOPE = "https://www.googleapis.com/auth/cloud-platform";
+const _VertexRagApiClient = class _VertexRagApiClient {
+  constructor(options) {
+    this.host = `https://${options.location}-aiplatform.googleapis.com`;
+    this.auth = new GoogleAuth({ scopes: [CLOUD_PLATFORM_SCOPE] });
+  }
+  /** Lists one page of the files in a corpus. */
+  async listRagFiles(params) {
+    const query = new URLSearchParams({ pageSize: String(params.pageSize) });
+    if (params.pageToken) {
+      query.set("pageToken", params.pageToken);
+    }
+    const url = `${this.host}/v1/${params.ragCorpus}/ragFiles?${query.toString()}`;
+    return this.send(url, {
+      method: "GET",
+      headers: await this.authHeaders(url)
+    });
+  }
+  /** Uploads `content` into a corpus as one RAG file. */
+  async uploadRagFile(params) {
+    const url = `${this.host}/upload/v1/${params.ragCorpus}/ragFiles:upload`;
+    const metadata = JSON.stringify({
+      ragFile: { displayName: params.displayName },
+      // Empty message: the corpus default chunking applies. The reference SDK
+      // omits this key unless chunking is configured, so it is optional here.
+      uploadRagFileConfig: {}
+    });
+    const body = new FormData();
+    body.append(
+      "metadata",
+      new Blob([metadata], { type: "application/json; charset=UTF-8" })
+    );
+    body.append(
+      "file",
+      new Blob([params.content], { type: "text/plain; charset=UTF-8" }),
+      "content.txt"
+    );
+    const headers = await this.authHeaders(url);
+    headers.set("X-Goog-Upload-Protocol", "multipart");
+    const response = await this.send(url, {
+      method: "POST",
+      headers,
+      body
+    });
+    if (response.error) {
+      throw new Error(
+        `Vertex AI RAG file upload was rejected: ${JSON.stringify(response.error)}`
+      );
+    }
+  }
+  /** Runs a retrieval query over a corpus. */
+  async retrieveContexts(params) {
+    const url = `${this.host}/v1/${params.parent}:retrieveContexts`;
+    const headers = await this.authHeaders(url);
+    headers.set("Content-Type", "application/json");
+    return this.send(url, {
+      method: "POST",
+      headers,
+      body: JSON.stringify({
+        vertexRagStore: params.vertexRagStore,
+        query: params.query
+      })
+    });
+  }
+  async authHeaders(url) {
+    const client = await this.auth.getClient();
+    return client.getRequestHeaders(url);
+  }
+  async send(url, init) {
+    const response = await fetch(url, init);
+    if (!response.ok) {
+      throw new Error(
+        `Vertex AI RAG request failed with status ${response.status}: ${await response.text()}`
+      );
+    }
+    return await response.json();
+  }
+};
+__name(_VertexRagApiClient, "VertexRagApiClient");
+let VertexRagApiClient = _VertexRagApiClient;
+export {
+  VertexRagApiClient
+};