@google/adk 2.0.0 → 2.2.0

package/dist/cjs/examples/example.js

@@ -9,6 +9,11 @@ var __defProp = Object.defineProperty;
 var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
 var __getOwnPropNames = Object.getOwnPropertyNames;
 var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __name = (target, value) => __defProp(target, "name", { value, configurable: true });
+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))
@@ -19,9 +24,96 @@ var __copyProps = (to, from, except, desc) => {
 };
 var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
 var example_exports = {};
+__export(example_exports, {
+  VertexAiExampleStore: () => VertexAiExampleStore
+});
 module.exports = __toCommonJS(example_exports);
+var import_base_example_provider = require("./base_example_provider.js");
 /**
  * @license
  * Copyright 2025 Google LLC
  * SPDX-License-Identifier: Apache-2.0
  */
+const SIMILARITY_SCORE_THRESHOLD = 0.5;
+const DEFAULT_TOP_K = 10;
+const _VertexAiExampleStore = class _VertexAiExampleStore extends import_base_example_provider.BaseExampleProvider {
+  /**
+   * Initializes the VertexAiExampleStore.
+   *
+   * @param examplesStoreName The resource name of the vertex example store, in
+   *   the format of
+   *   `projects/{project}/locations/{location}/exampleStores/{example_store}`.
+   * @param apiClient A client that reaches the Vertex AI Example Store API.
+   *   adk-js does not bundle the `vertexai` dependency the Python SDK relies
+   *   on, so the caller supplies this client.
+   */
+  constructor(examplesStoreName, apiClient) {
+    super();
+    this.examplesStoreName = examplesStoreName;
+    this.apiClient = apiClient;
+  }
+  /**
+   * Retrieves relevant examples from the Vertex AI Example Store for the given
+   * query.
+   */
+  async getExamples(query) {
+    var _a, _b, _c, _d, _e, _f, _g, _h, _i;
+    const request = {
+      storedContentsExampleParameters: {
+        contentSearchKey: {
+          contents: [{ role: "user", parts: [{ text: query }] }],
+          searchKeyGenerationMethod: { lastEntry: {} }
+        }
+      },
+      topK: DEFAULT_TOP_K,
+      exampleStore: this.examplesStoreName
+    };
+    const response = await this.apiClient.searchExamples(request);
+    const returnedExamples = [];
+    for (const result of (_a = response.results) != null ? _a : []) {
+      if (((_b = result.similarityScore) != null ? _b : 0) < SIMILARITY_SCORE_THRESHOLD) {
+        continue;
+      }
+      const storedExample = (_c = result.example) == null ? void 0 : _c.storedContentsExample;
+      const expectedContents = ((_e = (_d = storedExample == null ? void 0 : storedExample.contentsExample) == null ? void 0 : _d.expectedContents) != null ? _e : []).map((entry) => entry.content).filter((content) => content !== void 0);
+      const expectedOutput = [];
+      for (const content of expectedContents) {
+        const expectedParts = [];
+        for (const part of (_f = content.parts) != null ? _f : []) {
+          if (part.text) {
+            expectedParts.push({ text: part.text });
+          } else if (part.functionCall) {
+            expectedParts.push({
+              functionCall: {
+                name: part.functionCall.name,
+                args: { ...(_g = part.functionCall.args) != null ? _g : {} }
+              }
+            });
+          } else if (part.functionResponse) {
+            expectedParts.push({
+              functionResponse: {
+                name: part.functionResponse.name,
+                response: { ...(_h = part.functionResponse.response) != null ? _h : {} }
+              }
+            });
+          }
+        }
+        expectedOutput.push({ role: content.role, parts: expectedParts });
+      }
+      returnedExamples.push({
+        input: {
+          role: "user",
+          parts: [{ text: (_i = storedExample == null ? void 0 : storedExample.searchKey) != null ? _i : "" }]
+        },
+        output: expectedOutput
+      });
+    }
+    return returnedExamples;
+  }
+};
+__name(_VertexAiExampleStore, "VertexAiExampleStore");
+let VertexAiExampleStore = _VertexAiExampleStore;
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  VertexAiExampleStore
+});

package/dist/cjs/examples/example_util.js

@@ -25,10 +25,14 @@ var __copyProps = (to, from, except, desc) => {
 var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
 var example_util_exports = {};
 __export(example_util_exports, {
+  _getLatestMessageFromUser: () => _getLatestMessageFromUser,
   buildExampleSi: () => buildExampleSi,
-  convertExamplesToText: () => convertExamplesToText
+  convertExamplesToText: () => convertExamplesToText,
+  getLatestMessageFromUser: () => getLatestMessageFromUser
 });
 module.exports = __toCommonJS(example_util_exports);
+var import_event = require("../events/event.js");
+var import_logger = require("../utils/logger.js");
 var import_base_example_provider = require("./base_example_provider.js");
 /**
  * @license
@@ -93,18 +97,38 @@ function convertExamplesToText(examples, model) {
   return `${EXAMPLES_INTRO}${examplesStr}${EXAMPLES_END}`;
 }
 __name(convertExamplesToText, "convertExamplesToText");
-function buildExampleSi(examples, query, model) {
+function getLatestMessageFromUser(session) {
+  var _a, _b;
+  const events = session.events;
+  if (!events || events.length === 0) {
+    return "";
+  }
+  const event = events[events.length - 1];
+  if (event.author === "user" && (0, import_event.getFunctionResponses)(event).length === 0) {
+    if (((_a = event.content) == null ? void 0 : _a.parts) && ((_b = event.content.parts[0]) == null ? void 0 : _b.text)) {
+      return event.content.parts[0].text;
+    } else {
+      import_logger.logger.warn("No message from user for fetching example.");
+    }
+  }
+  return "";
+}
+__name(getLatestMessageFromUser, "getLatestMessageFromUser");
+const _getLatestMessageFromUser = getLatestMessageFromUser;
+async function buildExampleSi(examples, query, model) {
   if (Array.isArray(examples)) {
     return convertExamplesToText(examples, model);
   }
   if ((0, import_base_example_provider.isBaseExampleProvider)(examples)) {
-    return convertExamplesToText(examples.getExamples(query), model);
+    return convertExamplesToText(await examples.getExamples(query), model);
   }
   throw new Error("Invalid example configuration");
 }
 __name(buildExampleSi, "buildExampleSi");
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {
+  _getLatestMessageFromUser,
   buildExampleSi,
-  convertExamplesToText
+  convertExamplesToText,
+  getLatestMessageFromUser
 });

package/dist/cjs/examples/index.js

@@ -0,0 +1,39 @@
+/**
+  * @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 __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 __reExport = (target, mod, secondTarget) => (__copyProps(target, mod, "default"), secondTarget && __copyProps(secondTarget, mod, "default"));
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+var examples_exports = {};
+module.exports = __toCommonJS(examples_exports);
+__reExport(examples_exports, require("./base_example_provider.js"), module.exports);
+__reExport(examples_exports, require("./example.js"), module.exports);
+__reExport(examples_exports, require("./example_util.js"), module.exports);
+__reExport(examples_exports, require("./vertex_ai_example_store.js"), module.exports);
+/**
+ * @license
+ * Copyright 2025 Google LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  ...require("./base_example_provider.js"),
+  ...require("./example.js"),
+  ...require("./example_util.js"),
+  ...require("./vertex_ai_example_store.js")
+});

package/dist/cjs/examples/vertex_ai_example_store.js

@@ -0,0 +1,39 @@
+/**
+  * @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 vertex_ai_example_store_exports = {};
+__export(vertex_ai_example_store_exports, {
+  VertexAiExampleStore: () => import_example.VertexAiExampleStore
+});
+module.exports = __toCommonJS(vertex_ai_example_store_exports);
+var import_example = require("./example.js");
+/**
+ * @license
+ * Copyright 2025 Google LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  VertexAiExampleStore
+});

package/dist/cjs/index.js

@@ -26,24 +26,61 @@ var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: tru
 var index_exports = {};
 __export(index_exports, {
   AgentEngineSandboxCodeExecutor: () => import_agent_engine_sandbox_code_executor.AgentEngineSandboxCodeExecutor,
+  AuthCredentialMissingError: () => import_base_auth_credential_exchanger.AuthCredentialMissingError,
+  AutoAuthCredentialExchanger: () => import_auto_auth_credential_exchanger.AutoAuthCredentialExchanger,
+  BaseAuthCredentialExchanger: () => import_base_auth_credential_exchanger.BaseAuthCredentialExchanger,
   CodeExecutionLanguage: () => import_code_execution_utils.CodeExecutionLanguage,
+  ContainerCodeExecutor: () => import_container_code_executor.ContainerCodeExecutor,
   DatabaseSessionService: () => import_database_session_service.DatabaseSessionService,
   FileArtifactService: () => import_file_artifact_service.FileArtifactService,
+  FilesRetrieval: () => import_files_retrieval.FilesRetrieval,
+  GCPSkillRegistry: () => import_gcp_skill_registry.GCPSkillRegistry,
   GcsArtifactService: () => import_gcs_artifact_service.GcsArtifactService,
+  INTERNAL_AUTH_PREFIX: () => import_auth_helpers.INTERNAL_AUTH_PREFIX,
   InvocationContext: () => import_invocation_context.InvocationContext,
+  LOAD_WEB_PAGE: () => import_load_web_page.LOAD_WEB_PAGE,
+  LoadSkillResourceTool: () => import_load_skill_resource_tool.LoadSkillResourceTool,
   LocalEnvironment: () => import_local_environment.LocalEnvironment,
+  OAuth2BearerExchanger: () => import_oauth2_exchanger.OAuth2BearerExchanger,
+  OpenAPIToolset: () => import_openapi_toolset.OpenAPIToolset,
+  OpenApiSpecParser: () => import_openapi_spec_parser.OpenApiSpecParser,
+  OperationParser: () => import_operation_parser.OperationParser,
+  RestApiTool: () => import_rest_api_tool.RestApiTool,
   RunSkillInlineScriptErrorCode: () => import_run_skill_inline_script_tool.RunSkillInlineScriptErrorCode,
   RunSkillInlineScriptTool: () => import_run_skill_inline_script_tool.RunSkillInlineScriptTool,
   RunSkillScriptTool: () => import_run_skill_script_tool.RunSkillScriptTool,
+  ServiceAccountCredentialExchanger: () => import_service_account_exchanger.ServiceAccountCredentialExchanger,
+  SkillToolset: () => import_skill_toolset.SkillToolset,
+  ToolAuthHandler: () => import_tool_auth_handler.ToolAuthHandler,
+  ToolContextCredentialStore: () => import_tool_auth_handler.ToolContextCredentialStore,
   UnsafeLocalCodeExecutor: () => import_unsafe_local_code_executor.UnsafeLocalCodeExecutor,
+  VertexAiMemoryBankService: () => import_vertex_ai_memory_bank_service.VertexAiMemoryBankService,
+  VertexAiRagMemoryService: () => import_vertex_ai_rag_memory_service.VertexAiRagMemoryService,
   VertexAiSessionService: () => import_vertex_ai_session_service.VertexAiSessionService,
+  createApiParameter: () => import_common.createApiParameter,
+  createRestApiTool: () => import_rest_api_tool.createRestApiTool,
+  createRestApiToolFromJson: () => import_rest_api_tool.createRestApiToolFromJson,
+  credentialToParam: () => import_auth_helpers.credentialToParam,
+  dictToAuthScheme: () => import_auth_helpers.dictToAuthScheme,
+  exchangeCredential: () => import_oauth2_exchanger.exchangeCredential,
+  generateParamDoc: () => import_common.generateParamDoc,
+  generateReturnDoc: () => import_common.generateReturnDoc,
   getArtifactServiceFromUri: () => import_registry.getArtifactServiceFromUri,
   getSessionServiceFromUri: () => import_registry2.getSessionServiceFromUri,
+  getTypeHint: () => import_common.getTypeHint,
   loadAllSkillsInDir: () => import_loader.loadAllSkillsInDir,
   loadSkillFromDir: () => import_loader.loadSkillFromDir,
+  loadSkillFromZipBuffer: () => import_loader.loadSkillFromZipBuffer,
+  loadWebPage: () => import_load_web_page.loadWebPage,
+  openidDictToSchemeCredential: () => import_auth_helpers.openidDictToSchemeCredential,
+  openidUrlToSchemeCredential: () => import_auth_helpers.openidUrlToSchemeCredential,
+  serviceAccountDictToSchemeCredential: () => import_auth_helpers.serviceAccountDictToSchemeCredential,
+  serviceAccountSchemeCredential: () => import_auth_helpers.serviceAccountSchemeCredential,
+  tokenToSchemeCredential: () => import_auth_helpers.tokenToSchemeCredential,
   validateSkillDir: () => import_loader.validateSkillDir
 });
 module.exports = __toCommonJS(index_exports);
+var import_logger_node = require("./utils/logger_node.js");
 __reExport(index_exports, require("./a2a/index.js"), module.exports);
 var import_invocation_context = require("./agents/invocation_context.js");
 var import_file_artifact_service = require("./artifacts/file_artifact_service.js");
@@ -51,15 +88,34 @@ var import_gcs_artifact_service = require("./artifacts/gcs_artifact_service.js")
 var import_registry = require("./artifacts/registry.js");
 var import_agent_engine_sandbox_code_executor = require("./code_executors/agent_engine_sandbox_code_executor.js");
 var import_code_execution_utils = require("./code_executors/code_execution_utils.js");
+var import_container_code_executor = require("./code_executors/container_code_executor.js");
 var import_unsafe_local_code_executor = require("./code_executors/unsafe_local_code_executor.js");
 __reExport(index_exports, require("./common.js"), module.exports);
 var import_local_environment = require("./environment/local_environment.js");
+var import_vertex_ai_memory_bank_service = require("./memory/vertex_ai_memory_bank_service.js");
+var import_vertex_ai_rag_memory_service = require("./memory/vertex_ai_rag_memory_service.js");
 var import_database_session_service = require("./sessions/database_session_service.js");
 var import_registry2 = require("./sessions/registry.js");
 var import_vertex_ai_session_service = require("./sessions/vertex_ai_session_service.js");
+var import_gcp_skill_registry = require("./skills/gcp_skill_registry.js");
 var import_loader = require("./skills/loader.js");
+var import_load_web_page = require("./tools/load_web_page.js");
+var import_auth_helpers = require("./tools/openapi_tool/auth/auth_helpers.js");
+var import_auto_auth_credential_exchanger = require("./tools/openapi_tool/auth/credential_exchangers/auto_auth_credential_exchanger.js");
+var import_base_auth_credential_exchanger = require("./tools/openapi_tool/auth/credential_exchangers/base_auth_credential_exchanger.js");
+var import_oauth2_exchanger = require("./tools/openapi_tool/auth/credential_exchangers/oauth2_exchanger.js");
+var import_service_account_exchanger = require("./tools/openapi_tool/auth/credential_exchangers/service_account_exchanger.js");
+var import_common = require("./tools/openapi_tool/common/common.js");
+var import_openapi_spec_parser = require("./tools/openapi_tool/openapi_spec_parser/openapi_spec_parser.js");
+var import_operation_parser = require("./tools/openapi_tool/openapi_spec_parser/operation_parser.js");
+var import_tool_auth_handler = require("./tools/openapi_tool/openapi_spec_parser/tool_auth_handler.js");
+var import_openapi_toolset = require("./tools/openapi_tool/openapi_toolset.js");
+var import_rest_api_tool = require("./tools/openapi_tool/rest_api_tool.js");
+var import_files_retrieval = require("./tools/retrieval/files_retrieval.js");
+var import_load_skill_resource_tool = require("./tools/skill/load_skill_resource_tool.js");
 var import_run_skill_inline_script_tool = require("./tools/skill/run_skill_inline_script_tool.js");
 var import_run_skill_script_tool = require("./tools/skill/run_skill_script_tool.js");
+var import_skill_toolset = require("./tools/skill/skill_toolset.js");
 __reExport(index_exports, require("./integrations/agent_registry/agent_registry.js"), module.exports);
 __reExport(index_exports, require("./telemetry/google_cloud.js"), module.exports);
 __reExport(index_exports, require("./telemetry/setup.js"), module.exports);
@@ -69,24 +125,61 @@ __reExport(index_exports, require("./tools/mcp/index.js"), module.exports);
  * Copyright 2025 Google LLC
  * SPDX-License-Identifier: Apache-2.0
  */
+(0, import_logger_node.installNodeLogger)();
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {
   AgentEngineSandboxCodeExecutor,
+  AuthCredentialMissingError,
+  AutoAuthCredentialExchanger,
+  BaseAuthCredentialExchanger,
   CodeExecutionLanguage,
+  ContainerCodeExecutor,
   DatabaseSessionService,
   FileArtifactService,
+  FilesRetrieval,
+  GCPSkillRegistry,
   GcsArtifactService,
+  INTERNAL_AUTH_PREFIX,
   InvocationContext,
+  LOAD_WEB_PAGE,
+  LoadSkillResourceTool,
   LocalEnvironment,
+  OAuth2BearerExchanger,
+  OpenAPIToolset,
+  OpenApiSpecParser,
+  OperationParser,
+  RestApiTool,
   RunSkillInlineScriptErrorCode,
   RunSkillInlineScriptTool,
   RunSkillScriptTool,
+  ServiceAccountCredentialExchanger,
+  SkillToolset,
+  ToolAuthHandler,
+  ToolContextCredentialStore,
   UnsafeLocalCodeExecutor,
+  VertexAiMemoryBankService,
+  VertexAiRagMemoryService,
   VertexAiSessionService,
+  createApiParameter,
+  createRestApiTool,
+  createRestApiToolFromJson,
+  credentialToParam,
+  dictToAuthScheme,
+  exchangeCredential,
+  generateParamDoc,
+  generateReturnDoc,
   getArtifactServiceFromUri,
   getSessionServiceFromUri,
+  getTypeHint,
   loadAllSkillsInDir,
   loadSkillFromDir,
+  loadSkillFromZipBuffer,
+  loadWebPage,
+  openidDictToSchemeCredential,
+  openidUrlToSchemeCredential,
+  serviceAccountDictToSchemeCredential,
+  serviceAccountSchemeCredential,
+  tokenToSchemeCredential,
   validateSkillDir,
   ...require("./a2a/index.js"),
   ...require("./common.js"),

package/dist/cjs/index_web.js

@@ -21,12 +21,14 @@ var __reExport = (target, mod, secondTarget) => (__copyProps(target, mod, "defau
 var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
 var index_web_exports = {};
 module.exports = __toCommonJS(index_web_exports);
+var import_logger_browser = require("./utils/logger_browser.js");
 __reExport(index_web_exports, require("./common.js"), module.exports);
 /**
  * @license
  * Copyright 2025 Google LLC
  * SPDX-License-Identifier: Apache-2.0
  */
+(0, import_logger_browser.installBrowserLogger)();
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {
   ...require("./common.js")

package/dist/cjs/integrations/agent_registry/agent_registry.js

@@ -342,8 +342,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 import_a2a_remote_agent.RemoteA2AAgent({
       name,

package/dist/cjs/memory/rag_memory_transcript.js

@@ -0,0 +1,136 @@
+/**
+  * @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 __name = (target, value) => __defProp(target, "name", { value, configurable: true });
+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 rag_memory_transcript_exports = {};
+__export(rag_memory_transcript_exports, {
+  buildSourceDisplayName: () => buildSourceDisplayName,
+  parseSourceDisplayName: () => parseSourceDisplayName,
+  parseTranscriptEvents: () => parseTranscriptEvents,
+  serializeSessionTranscript: () => serializeSessionTranscript
+});
+module.exports = __toCommonJS(rag_memory_transcript_exports);
+/**
+ * @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");
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  buildSourceDisplayName,
+  parseSourceDisplayName,
+  parseTranscriptEvents,
+  serializeSessionTranscript
+});

package/dist/cjs/memory/vertex_ai_memory_bank_service.js

@@ -63,7 +63,7 @@ const ENABLE_CONSOLIDATION_KEY = "enable_consolidation";
 const MAX_DIRECT_MEMORIES_PER_GENERATE_CALL = 5;
 function shouldFilterOutEvent(content) {
   return !((content == null ? void 0 : content.parts) || []).some(
-    (p) => p.text || p.inlineData || p.fileData
+    (p) => p.text || p.inlineData || p.fileData || p.functionCall || p.functionResponse || p.executableCode || p.codeExecutionResult || p.toolCall || p.toolResponse
   );
 }
 __name(shouldFilterOutEvent, "shouldFilterOutEvent");
@@ -149,6 +149,15 @@ const _VertexAiMemoryBankService = class _VertexAiMemoryBankService {
   }
   /**
    * Adds explicit memory items using Vertex Memory Bank.
+   *
+   * When a `MemoryEntry.id` is set, it is forwarded as the `memoryId` of the
+   * created memory, so the caller picks the last component of the memory
+   * resource name instead of letting the service generate one. An explicit
+   * `customMetadata['memoryId']` takes precedence over `MemoryEntry.id`.
+   *
+   * The id is forwarded unvalidated, so an id the API rejects fails the create
+   * call. Vertex accepts up to 63 characters from `[a-z0-9-]`, starting with a
+   * letter and ending with a letter or number.
    */
   async addMemory(request) {
     if (isConsolidationEnabled(request.customMetadata)) {
@@ -224,7 +233,8 @@ const _VertexAiMemoryBankService = class _VertexAiMemoryBankService {
       const memoryRevisionLabels = revisionLabelsForMemory(memory);
       const config = buildCreateMemoryConfig({
         customMetadata: memoryMetadata,
-        memoryRevisionLabels
+        memoryRevisionLabels,
+        memoryId: memory.id
       });
       const params = {
         name: `reasoningEngines/${this.agentEngineId}`,
@@ -236,7 +246,7 @@ const _VertexAiMemoryBankService = class _VertexAiMemoryBankService {
         config
       };
       const operation = await this.memories.createInternal(params);
-      import_logger.logger.info("Create memory response received.");
+      import_logger.logger.debug("Create memory response received.");
       import_logger.logger.debug(`Create memory response: ${JSON.stringify(operation)}`);
     }
   }
@@ -260,7 +270,7 @@ const _VertexAiMemoryBankService = class _VertexAiMemoryBankService {
         config
       };
       const operation = await this.memories.generateInternal(params);
-      import_logger.logger.info("Generate direct memory response received.");
+      import_logger.logger.debug("Generate direct memory response received.");
       import_logger.logger.debug(
         `Generate direct memory response: ${JSON.stringify(operation)}`
       );
@@ -325,6 +335,9 @@ function buildCreateMemoryConfig(params) {
       };
     }
   }
+  if (params.memoryId !== void 0 && config["memoryId"] === void 0) {
+    config["memoryId"] = params.memoryId;
+  }
   const revisionLabels = {
     ...customRevisionLabels,
     ...params.memoryRevisionLabels
@@ -458,9 +471,8 @@ function mergeCustomMetadataForMemory(params) {
   if (params.customMetadata) {
     Object.assign(mergedMetadata, params.customMetadata);
   }
-  const memoryWithMetadata = params.memory;
-  if (memoryWithMetadata.customMetadata) {
-    Object.assign(mergedMetadata, memoryWithMetadata.customMetadata);
+  if (params.memory.customMetadata) {
+    Object.assign(mergedMetadata, params.memory.customMetadata);
   }
   if (Object.keys(mergedMetadata).length === 0) {
     return void 0;