@google/adk 2.1.0 → 2.2.0

package/dist/cjs/a2a/agent_card.js

@@ -213,6 +213,14 @@ async function buildLLMAgentSkills(agent) {
       }
     }
   }
+  if (agent.codeExecutor) {
+    skills.push({
+      id: `${agent.name}-code-executor`,
+      name: "code-execution",
+      description: "Can execute code",
+      tags: ["llm", "code_execution"]
+    });
+  }
   return skills;
 }
 __name(buildLLMAgentSkills, "buildLLMAgentSkills");

package/dist/cjs/a2a/agent_executor.js

@@ -85,7 +85,10 @@ const _A2AAgentExecutor = class _A2AAgentExecutor {
         await this.publishFinalTaskStatus({
           executorContext,
           eventBus,
-          event: unansweredRequestEvent
+          event: {
+            ...unansweredRequestEvent,
+            metadata: (0, import_metadata_converter_utils.getA2ASessionMetadata)(executorContext)
+          }
         });
         return;
       }
@@ -94,14 +97,16 @@ const _A2AAgentExecutor = class _A2AAgentExecutor {
           (0, import_a2a_event.createTask)({
             taskId: ctx.taskId,
             contextId: ctx.contextId,
-            message: a2aUserMessage
+            message: a2aUserMessage,
+            metadata: (0, import_metadata_converter_utils.getA2ASessionMetadata)(executorContext)
           })
         );
       }
       eventBus.publish(
         (0, import_a2a_event.createTaskWorkingEvent)({
           taskId: ctx.taskId,
-          contextId: ctx.contextId
+          contextId: ctx.contextId,
+          metadata: (0, import_metadata_converter_utils.getA2ASessionMetadata)(executorContext)
         })
       );
       const adkEvents = [];

package/dist/cjs/agents/llm_agent.js

@@ -40,6 +40,7 @@ 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_registry = require("../models/registry.js");
+var import_built_in_planner = require("../planners/built_in_planner.js");
 var import_base_tool = require("../tools/base_tool.js");
 var import_logger = require("../utils/logger.js");
 var import_output_schema_utils = require("../utils/output_schema_utils.js");
@@ -59,6 +60,7 @@ var import_context_compactor_request_processor = require("./processors/context_c
 var import_identity_llm_request_processor = require("./processors/identity_llm_request_processor.js");
 var import_instructions_llm_request_processor = require("./processors/instructions_llm_request_processor.js");
 var import_interactions_request_processor = require("./processors/interactions_request_processor.js");
+var import_nl_planning_processor = require("./processors/nl_planning_processor.js");
 var import_request_confirmation_llm_request_processor = require("./processors/request_confirmation_llm_request_processor.js");
 var import_request_input_llm_request_processor = require("./processors/request_input_llm_request_processor.js");
 var import_tool_filter_request_processor = require("./processors/tool_filter_request_processor.js");
@@ -166,6 +168,7 @@ const _LlmAgent = class _LlmAgent extends (_b = import_base_agent.BaseAgent, _a
     this.beforeToolCallback = config.beforeToolCallback;
     this.afterToolCallback = config.afterToolCallback;
     this.codeExecutor = config.codeExecutor;
+    this.planner = config.planner;
     this.requestProcessors = (_i = config.requestProcessors) != null ? _i : [
       import_basic_llm_request_processor.BASIC_LLM_REQUEST_PROCESSOR,
       import_auth_preprocessor.AUTH_PREPROCESSOR,
@@ -174,6 +177,10 @@ const _LlmAgent = class _LlmAgent extends (_b = import_base_agent.BaseAgent, _a
       import_request_confirmation_llm_request_processor.REQUEST_CONFIRMATION_LLM_REQUEST_PROCESSOR,
       import_request_input_llm_request_processor.REQUEST_INPUT_LLM_REQUEST_PROCESSOR,
       import_content_request_processor.CONTENT_REQUEST_PROCESSOR,
+      // Planning clears the thought flags that the planning response
+      // processor sets, so it must run after the contents are built and
+      // before code execution rewrites them.
+      import_nl_planning_processor.NL_PLANNING_REQUEST_PROCESSOR,
       import_interactions_request_processor.INTERACTIONS_REQUEST_PROCESSOR,
       import_code_execution_request_processor.CODE_EXECUTION_REQUEST_PROCESSOR,
       import_tool_filter_request_processor.TOOL_FILTER_REQUEST_PROCESSOR
@@ -194,7 +201,9 @@ const _LlmAgent = class _LlmAgent extends (_b = import_base_agent.BaseAgent, _a
         );
       }
     }
-    this.responseProcessors = (_j = config.responseProcessors) != null ? _j : [];
+    this.responseProcessors = (_j = config.responseProcessors) != null ? _j : [
+      import_nl_planning_processor.NL_PLANNING_RESPONSE_PROCESSOR
+    ];
     const agentTransferDisabled = this.disallowTransferToParent && this.disallowTransferToPeers && !((_k = this.subAgents) == null ? void 0 : _k.length);
     if (!agentTransferDisabled) {
       this.requestProcessors.push(import_agent_transfer_llm_request_processor.AGENT_TRANSFER_LLM_REQUEST_PROCESSOR);
@@ -213,6 +222,11 @@ const _LlmAgent = class _LlmAgent extends (_b = import_base_agent.BaseAgent, _a
           "Response schema must be set via LlmAgent.output_schema."
         );
       }
+      if (config.generateContentConfig.thinkingConfig && (0, import_built_in_planner.isBuiltInPlanner)(this.planner) && this.planner.thinkingConfig) {
+        import_logger.logger.warn(
+          `Agent ${this.name}: both generateContentConfig.thinkingConfig and planner.thinkingConfig are set. The planner's thinkingConfig takes precedence.`
+        );
+      }
     } else {
       this.generateContentConfig = {};
     }

package/dist/cjs/agents/processors/content_processor_utils.js

@@ -43,6 +43,7 @@ var import_functions = require("../functions.js");
  * Copyright 2025 Google LLC
  * SPDX-License-Identifier: Apache-2.0
  */
+const UNSTRINGIFIABLE_VALUE = "<unstringifiable value>";
 function removeClientFunctionCallId(content) {
   var _a, _b, _c, _d, _e;
   for (const part of (_a = content == null ? void 0 : content.parts) != null ? _a : []) {
@@ -406,9 +407,16 @@ function safeStringify(obj) {
     return obj;
   }
   try {
-    return JSON.stringify(obj);
-  } catch (_e) {
+    const json = JSON.stringify(obj);
+    if (typeof json === "string") {
+      return json;
+    }
+  } catch {
+  }
+  try {
     return String(obj);
+  } catch {
+    return UNSTRINGIFIABLE_VALUE;
   }
 }
 __name(safeStringify, "safeStringify");

package/dist/cjs/agents/processors/nl_planning_processor.js

@@ -0,0 +1,114 @@
+/**
+  * @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 nl_planning_processor_exports = {};
+__export(nl_planning_processor_exports, {
+  NL_PLANNING_REQUEST_PROCESSOR: () => NL_PLANNING_REQUEST_PROCESSOR,
+  NL_PLANNING_RESPONSE_PROCESSOR: () => NL_PLANNING_RESPONSE_PROCESSOR,
+  NlPlanningRequestProcessor: () => NlPlanningRequestProcessor,
+  NlPlanningResponseProcessor: () => NlPlanningResponseProcessor
+});
+module.exports = __toCommonJS(nl_planning_processor_exports);
+var import_llm_request = require("../../models/llm_request.js");
+var import_base_planner = require("../../planners/base_planner.js");
+var import_built_in_planner = require("../../planners/built_in_planner.js");
+var import_context = require("../context.js");
+var import_llm_agent = require("../llm_agent.js");
+var import_readonly_context = require("../readonly_context.js");
+var import_base_llm_processor = require("./base_llm_processor.js");
+/**
+ * @license
+ * Copyright 2026 Google LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+function getPlanner(invocationContext) {
+  const agent = invocationContext.agent;
+  if (!(0, import_llm_agent.isLlmAgent)(agent) || !(0, import_base_planner.isBasePlanner)(agent.planner)) {
+    return void 0;
+  }
+  return agent.planner;
+}
+__name(getPlanner, "getPlanner");
+function removeThought(part) {
+  const { thought: _thought, ...rest } = part;
+  return rest;
+}
+__name(removeThought, "removeThought");
+function removeThoughtFromContents(contents) {
+  return contents.map(
+    (content) => content.parts ? { ...content, parts: content.parts.map(removeThought) } : content
+  );
+}
+__name(removeThoughtFromContents, "removeThoughtFromContents");
+const _NlPlanningRequestProcessor = class _NlPlanningRequestProcessor extends import_base_llm_processor.BaseLlmRequestProcessor {
+  // eslint-disable-next-line require-yield -- this processor only mutates the request and has no event to emit
+  async *runAsync(invocationContext, llmRequest) {
+    const planner = getPlanner(invocationContext);
+    if (!planner) {
+      return;
+    }
+    if ((0, import_built_in_planner.isBuiltInPlanner)(planner)) {
+      planner.applyThinkingConfig(llmRequest);
+    }
+    const planningInstruction = planner.buildPlanningInstruction(
+      new import_readonly_context.ReadonlyContext(invocationContext),
+      llmRequest
+    );
+    if (planningInstruction) {
+      (0, import_llm_request.appendInstructions)(llmRequest, [planningInstruction]);
+    }
+    llmRequest.contents = removeThoughtFromContents(llmRequest.contents);
+  }
+};
+__name(_NlPlanningRequestProcessor, "NlPlanningRequestProcessor");
+let NlPlanningRequestProcessor = _NlPlanningRequestProcessor;
+const _NlPlanningResponseProcessor = class _NlPlanningResponseProcessor extends import_base_llm_processor.BaseLlmResponseProcessor {
+  // eslint-disable-next-line require-yield -- this processor only rewrites the response and has no event to emit
+  async *runAsync(invocationContext, llmResponse) {
+    var _a, _b;
+    const planner = getPlanner(invocationContext);
+    if (!planner || !((_b = (_a = llmResponse.content) == null ? void 0 : _a.parts) == null ? void 0 : _b.length)) {
+      return;
+    }
+    const processedParts = planner.processPlanningResponse(
+      new import_context.Context({ invocationContext }),
+      llmResponse.content.parts
+    );
+    if (processedParts !== void 0) {
+      llmResponse.content = { ...llmResponse.content, parts: processedParts };
+    }
+  }
+};
+__name(_NlPlanningResponseProcessor, "NlPlanningResponseProcessor");
+let NlPlanningResponseProcessor = _NlPlanningResponseProcessor;
+const NL_PLANNING_REQUEST_PROCESSOR = new NlPlanningRequestProcessor();
+const NL_PLANNING_RESPONSE_PROCESSOR = new NlPlanningResponseProcessor();
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  NL_PLANNING_REQUEST_PROCESSOR,
+  NL_PLANNING_RESPONSE_PROCESSOR,
+  NlPlanningRequestProcessor,
+  NlPlanningResponseProcessor
+});

package/dist/cjs/artifacts/gcs_artifact_service.js

@@ -82,9 +82,7 @@ const _GcsArtifactService = class _GcsArtifactService {
         version
       })
     );
-    const customMetadata = {
-      ...request.customMetadata
-    };
+    const customMetadata = stringifyMetadataValues(request.customMetadata);
     if (request.artifact.inlineData) {
       if (request.artifact.inlineData.displayName) {
         customMetadata[GCS_DISPLAY_NAME_METADATA_KEY] = request.artifact.inlineData.displayName;
@@ -208,10 +206,9 @@ const _GcsArtifactService = class _GcsArtifactService {
     const [files] = await bucket.getFiles({ prefix: searchPrefix });
     const versions = [];
     for (const file of files) {
-      const version = file.name.split("/").pop();
-      const v = parseInt(version, 10);
-      if (!isNaN(v)) {
-        versions.push(v);
+      const suffix = file.name.slice(searchPrefix.length);
+      if (/^\d+$/.test(suffix)) {
+        versions.push(Number(suffix));
       }
     }
     return versions.sort((a, b) => a - b);
@@ -277,6 +274,15 @@ function getFileName({
   return version !== void 0 ? `${prefix}/${version}` : prefix;
 }
 __name(getFileName, "getFileName");
+function stringifyMetadataValues(customMetadata) {
+  return Object.fromEntries(
+    Object.entries(customMetadata != null ? customMetadata : {}).map(([key, value]) => [
+      key,
+      String(value)
+    ])
+  );
+}
+__name(stringifyMetadataValues, "stringifyMetadataValues");
 function extractArtifactKeys(files, fileNamePrefix, keyPrefix = "") {
   const keys = /* @__PURE__ */ new Set();
   for (const file of files) {

package/dist/cjs/auth/auth_credential.js

@@ -9,6 +9,7 @@ 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 });
@@ -24,7 +25,8 @@ var __copyProps = (to, from, except, desc) => {
 var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
 var auth_credential_exports = {};
 __export(auth_credential_exports, {
-  AuthCredentialTypes: () => AuthCredentialTypes
+  AuthCredentialTypes: () => AuthCredentialTypes,
+  isAuthCredential: () => isAuthCredential
 });
 module.exports = __toCommonJS(auth_credential_exports);
 /**
@@ -40,7 +42,15 @@ var AuthCredentialTypes = /* @__PURE__ */ ((AuthCredentialTypes2) => {
   AuthCredentialTypes2["SERVICE_ACCOUNT"] = "serviceAccount";
   return AuthCredentialTypes2;
 })(AuthCredentialTypes || {});
+const AUTH_CREDENTIAL_TYPES = new Set(
+  Object.values(AuthCredentialTypes)
+);
+function isAuthCredential(value) {
+  return typeof value === "object" && value !== null && "authType" in value && AUTH_CREDENTIAL_TYPES.has(value.authType);
+}
+__name(isAuthCredential, "isAuthCredential");
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {
-  AuthCredentialTypes
+  AuthCredentialTypes,
+  isAuthCredential
 });

package/dist/cjs/code_executors/code_execution_utils.js

@@ -148,9 +148,9 @@ function convertCodeExecutionParts(content, codeBlockDelimiter, executionResultD
       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]
-    };
+    const output = lastPart.codeExecutionResult.output;
+    const text = output == null ? "" : executionResultDelimiters[0] + output + executionResultDelimiters[1];
+    content.parts[content.parts.length - 1] = { text };
     content.role = "user";
   }
 }

package/dist/cjs/common.js

@@ -49,6 +49,7 @@ __export(common_exports, {
   BaseLlmRequestProcessor: () => import_base_llm_processor.BaseLlmRequestProcessor,
   BaseLlmResponseProcessor: () => import_base_llm_processor.BaseLlmResponseProcessor,
   BaseNode: () => import_workflow.BaseNode,
+  BasePlanner: () => import_base_planner.BasePlanner,
   BasePlugin: () => import_base_plugin.BasePlugin,
   BaseRetrievalTool: () => import_base_retrieval_tool.BaseRetrievalTool,
   BaseSessionService: () => import_base_session_service.BaseSessionService,
@@ -56,8 +57,10 @@ __export(common_exports, {
   BaseToolset: () => import_base_toolset.BaseToolset,
   BranchPath: () => import_workflow.BranchPath,
   BuiltInCodeExecutor: () => import_built_in_code_executor.BuiltInCodeExecutor,
+  BuiltInPlanner: () => import_built_in_planner.BuiltInPlanner,
   BuiltInTool: () => import_built_in_tool.BuiltInTool,
   CONTENT_REQUEST_PROCESSOR: () => import_content_request_processor.CONTENT_REQUEST_PROCESSOR,
+  CallbackContext: () => import_tool_context.CallbackContext,
   ChromeBuiltInLlm: () => import_chrome_prompt_llm.ChromeBuiltInLlm,
   ChromeModelUnavailableError: () => import_chrome_prompt_llm.ChromeModelUnavailableError,
   CodeExecutionLanguage: () => import_code_execution_utils.CodeExecutionLanguage,
@@ -132,6 +135,7 @@ __export(common_exports, {
   PRELOAD_MEMORY: () => import_preload_memory_tool.PRELOAD_MEMORY,
   ParallelAgent: () => import_parallel_agent.ParallelAgent,
   ParallelWorker: () => import_workflow.ParallelWorker,
+  PlanReActPlanner: () => import_plan_re_act_planner.PlanReActPlanner,
   PluginManager: () => import_plugin_manager.PluginManager,
   PolicyOutcome: () => import_security_plugin.PolicyOutcome,
   PreloadMemoryTool: () => import_preload_memory_tool.PreloadMemoryTool,
@@ -161,6 +165,7 @@ __export(common_exports, {
   Task: () => import_task.Task,
   TokenBasedContextCompactor: () => import_token_based_context_compactor.TokenBasedContextCompactor,
   ToolConfirmation: () => import_tool_confirmation.ToolConfirmation,
+  ToolContext: () => import_tool_context.ToolContext,
   ToolErrorType: () => import_tool_execution_error.ToolErrorType,
   ToolExecutionError: () => import_tool_execution_error.ToolExecutionError,
   ToolNode: () => import_workflow.ToolNode,
@@ -169,8 +174,11 @@ __export(common_exports, {
   TruncatingContextCompactor: () => import_truncating_context_compactor.TruncatingContextCompactor,
   URL_CONTEXT: () => import_url_context_tool.URL_CONTEXT,
   UrlContextTool: () => import_url_context_tool.UrlContextTool,
+  VertexAiExampleStore: () => import_example.VertexAiExampleStore,
   VertexAiSearchTool: () => import_vertex_ai_search_tool.VertexAiSearchTool,
   VertexRagRetrievalTool: () => import_vertex_rag_retrieval_tool.VertexRagRetrievalTool,
+  WebMCPTool: () => import_webmcp_tool.WebMCPTool,
+  WebMCPToolset: () => import_webmcp_toolset.WebMCPToolset,
   Workflow: () => import_workflow.Workflow,
   WorkflowNode: () => import_workflow.WorkflowNode,
   asRunnableRoot: () => import_workflow.asRunnableRoot,
@@ -194,6 +202,7 @@ __export(common_exports, {
   getFunctionCalls: () => import_event.getFunctionCalls,
   getFunctionResponses: () => import_event.getFunctionResponses,
   getLogger: () => import_logger.getLogger,
+  getModelContext: () => import_webmcp_types.getModelContext,
   getPendingUserInputRequests: () => import_user_input_request.getPendingUserInputRequests,
   getUserChoiceTool: () => import_get_user_choice_tool.getUserChoiceTool,
   getUserInputRequests: () => import_user_input_request.getUserInputRequests,
@@ -201,16 +210,21 @@ __export(common_exports, {
   hasTrailingCodeExecutionResult: () => import_event.hasTrailingCodeExecutionResult,
   isAgentTool: () => import_agent_tool.isAgentTool,
   isApp: () => import_app.isApp,
+  isAuthCredential: () => import_auth_credential.isAuthCredential,
   isBaseAgent: () => import_base_agent.isBaseAgent,
   isBaseExampleProvider: () => import_base_example_provider.isBaseExampleProvider,
   isBaseLlm: () => import_base_llm.isBaseLlm,
+  isBasePlanner: () => import_base_planner.isBasePlanner,
   isBaseTool: () => import_base_tool.isBaseTool,
   isBaseToolset: () => import_base_toolset.isBaseToolset,
+  isBuiltInPlanner: () => import_built_in_planner.isBuiltInPlanner,
   isCompactedEvent: () => import_compacted_event.isCompactedEvent,
   isFinalResponse: () => import_event.isFinalResponse,
   isFunctionTool: () => import_function_tool.isFunctionTool,
   isGemini2OrAbove: () => import_model_name.isGemini2OrAbove,
+  isGemini35LiveTranslate: () => import_model_name.isGemini35LiveTranslate,
   isGemini3xFlashLive: () => import_model_name.isGemini3xFlashLive,
+  isGemini3xLive: () => import_model_name.isGemini3xLive,
   isIntentMismatchError: () => import_tool_confirmation.isIntentMismatchError,
   isLlmAgent: () => import_llm_agent.isLlmAgent,
   isLoopAgent: () => import_loop_agent.isLoopAgent,
@@ -230,12 +244,15 @@ __export(common_exports, {
   isSessionArtifactService: () => import_session_artifact_service.isSessionArtifactService,
   isStateSchemaError: () => import_state.isStateSchemaError,
   isToolNotFound: () => import_functions.isToolNotFound,
+  isWebMCPSupported: () => import_webmcp_types.isWebMCPSupported,
   isWorkflow: () => import_workflow.isWorkflow,
+  logger: () => import_logger.logger,
   node: () => import_workflow.node,
   normalizeRetryExceptions: () => import_workflow.normalizeRetryExceptions,
   populateClientFunctionCallId: () => import_event.populateClientFunctionCallId,
   prepareRetryConfig: () => import_workflow.prepareRetryConfig,
   pruneThoughts: () => import_event.pruneThoughts,
+  renameReservedKeywords: () => import_case_utils.renameReservedKeywords,
   requestInputTool: () => import_request_input_tool.requestInputTool,
   requireAgent: () => import_invocation_context.requireAgent,
   requiresUserInput: () => import_user_input_request.requiresUserInput,
@@ -246,6 +263,7 @@ __export(common_exports, {
   setLogger: () => import_logger.setLogger,
   stringifyContent: () => import_event.stringifyContent,
   stripAdkIdentityPreamble: () => import_chrome_prompt_llm.stripAdkIdentityPreamble,
+  toSnakeCaseName: () => import_case_utils.toSnakeCaseName,
   toStructuredEvents: () => import_structured_events.toStructuredEvents,
   validateAppName: () => import_app.validateAppName,
   version: () => import_version.version,
@@ -306,6 +324,7 @@ var import_event = require("./events/event.js");
 var import_event_actions = require("./events/event_actions.js");
 var import_structured_events = require("./events/structured_events.js");
 var import_base_example_provider = require("./examples/base_example_provider.js");
+var import_example = require("./examples/example.js");
 var import_in_memory_memory_service = require("./memory/in_memory_memory_service.js");
 var import_apigee_llm = require("./models/apigee_llm.js");
 var import_base_llm = require("./models/base_llm.js");
@@ -313,6 +332,9 @@ var import_chrome_prompt_llm = require("./models/chrome_prompt_llm.js");
 var import_google_llm = require("./models/google_llm.js");
 var import_registry = require("./models/registry.js");
 var import_routed_llm = require("./models/routed_llm.js");
+var import_base_planner = require("./planners/base_planner.js");
+var import_built_in_planner = require("./planners/built_in_planner.js");
+var import_plan_re_act_planner = require("./planners/plan_re_act_planner.js");
 var import_reflect_retry_utils = require("./plugins/_reflect_retry_utils.js");
 var import_base_plugin = require("./plugins/base_plugin.js");
 var import_global_instruction_plugin = require("./plugins/global_instruction_plugin.js");
@@ -349,10 +371,15 @@ var import_request_input_tool = require("./tools/request_input_tool.js");
 var import_base_retrieval_tool = require("./tools/retrieval/base_retrieval_tool.js");
 var import_llama_index_retrieval = require("./tools/retrieval/llama_index_retrieval.js");
 var import_tool_confirmation = require("./tools/tool_confirmation.js");
+var import_tool_context = require("./tools/tool_context.js");
 var import_url_context_tool = require("./tools/url_context_tool.js");
 var import_vertex_ai_search_tool = require("./tools/vertex_ai_search_tool.js");
 var import_vertex_rag_retrieval_tool = require("./tools/vertex_rag_retrieval_tool.js");
+var import_webmcp_tool = require("./tools/webmcp/webmcp_tool.js");
+var import_webmcp_toolset = require("./tools/webmcp/webmcp_toolset.js");
+var import_webmcp_types = require("./tools/webmcp/webmcp_types.js");
 var import_async_queue = require("./utils/async_queue.js");
+var import_case_utils = require("./utils/case_utils.js");
 var import_client_labels = require("./utils/client_labels.js");
 var import_logger = require("./utils/logger.js");
 var import_model_name = require("./utils/model_name.js");
@@ -406,6 +433,7 @@ __reExport(common_exports, require("./tools/base_tool.js"), module.exports);
   BaseLlmRequestProcessor,
   BaseLlmResponseProcessor,
   BaseNode,
+  BasePlanner,
   BasePlugin,
   BaseRetrievalTool,
   BaseSessionService,
@@ -413,8 +441,10 @@ __reExport(common_exports, require("./tools/base_tool.js"), module.exports);
   BaseToolset,
   BranchPath,
   BuiltInCodeExecutor,
+  BuiltInPlanner,
   BuiltInTool,
   CONTENT_REQUEST_PROCESSOR,
+  CallbackContext,
   ChromeBuiltInLlm,
   ChromeModelUnavailableError,
   CodeExecutionLanguage,
@@ -489,6 +519,7 @@ __reExport(common_exports, require("./tools/base_tool.js"), module.exports);
   PRELOAD_MEMORY,
   ParallelAgent,
   ParallelWorker,
+  PlanReActPlanner,
   PluginManager,
   PolicyOutcome,
   PreloadMemoryTool,
@@ -518,6 +549,7 @@ __reExport(common_exports, require("./tools/base_tool.js"), module.exports);
   Task,
   TokenBasedContextCompactor,
   ToolConfirmation,
+  ToolContext,
   ToolErrorType,
   ToolExecutionError,
   ToolNode,
@@ -526,8 +558,11 @@ __reExport(common_exports, require("./tools/base_tool.js"), module.exports);
   TruncatingContextCompactor,
   URL_CONTEXT,
   UrlContextTool,
+  VertexAiExampleStore,
   VertexAiSearchTool,
   VertexRagRetrievalTool,
+  WebMCPTool,
+  WebMCPToolset,
   Workflow,
   WorkflowNode,
   asRunnableRoot,
@@ -551,6 +586,7 @@ __reExport(common_exports, require("./tools/base_tool.js"), module.exports);
   getFunctionCalls,
   getFunctionResponses,
   getLogger,
+  getModelContext,
   getPendingUserInputRequests,
   getUserChoiceTool,
   getUserInputRequests,
@@ -558,16 +594,21 @@ __reExport(common_exports, require("./tools/base_tool.js"), module.exports);
   hasTrailingCodeExecutionResult,
   isAgentTool,
   isApp,
+  isAuthCredential,
   isBaseAgent,
   isBaseExampleProvider,
   isBaseLlm,
+  isBasePlanner,
   isBaseTool,
   isBaseToolset,
+  isBuiltInPlanner,
   isCompactedEvent,
   isFinalResponse,
   isFunctionTool,
   isGemini2OrAbove,
+  isGemini35LiveTranslate,
   isGemini3xFlashLive,
+  isGemini3xLive,
   isIntentMismatchError,
   isLlmAgent,
   isLoopAgent,
@@ -587,12 +628,15 @@ __reExport(common_exports, require("./tools/base_tool.js"), module.exports);
   isSessionArtifactService,
   isStateSchemaError,
   isToolNotFound,
+  isWebMCPSupported,
   isWorkflow,
+  logger,
   node,
   normalizeRetryExceptions,
   populateClientFunctionCallId,
   prepareRetryConfig,
   pruneThoughts,
+  renameReservedKeywords,
   requestInputTool,
   requireAgent,
   requiresUserInput,
@@ -603,6 +647,7 @@ __reExport(common_exports, require("./tools/base_tool.js"), module.exports);
   setLogger,
   stringifyContent,
   stripAdkIdentityPreamble,
+  toSnakeCaseName,
   toStructuredEvents,
   validateAppName,
   version,

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
+});