@google/adk 1.5.0 → 2.0.0

package/dist/esm/telemetry/tracing.js

@@ -1,5 +1,7 @@
 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 2025 Google LLC
@@ -15,6 +17,12 @@ const GEN_AI_TOOL_CALL_ID = "gen_ai.tool.call.id";
 const GEN_AI_TOOL_DESCRIPTION = "gen_ai.tool.description";
 const GEN_AI_TOOL_NAME = "gen_ai.tool.name";
 const GEN_AI_TOOL_TYPE = "gen_ai.tool.type";
+const ADK_WORKFLOW_NAME = "adk.workflow.name";
+const ADK_NODE_PATH = "adk.node.path";
+const ADK_NODE_RUN_ID = "adk.node.run_id";
+const ADK_NODE_ATTEMPT = "adk.node.attempt";
+const ADK_NODE_STATUS = "adk.node.status";
+const ADK_NODE_INTERRUPT_COUNT = "adk.node.interrupt_count";
 const tracer = trace.getTracer("gcp.vertex.agent", version);
 function safeJsonSerialize(obj) {
   try {
@@ -23,6 +31,7 @@ function safeJsonSerialize(obj) {
     return "<not serializable>";
   }
 }
+__name(safeJsonSerialize, "safeJsonSerialize");
 function traceAgentInvocation({
   agent,
   invocationContext
@@ -37,6 +46,41 @@ function traceAgentInvocation({
     [GEN_AI_CONVERSATION_ID]: invocationContext.session.id
   });
 }
+__name(traceAgentInvocation, "traceAgentInvocation");
+function traceWorkflowInvocation({
+  workflowName,
+  nodePath,
+  sessionId
+}) {
+  const span = trace.getActiveSpan();
+  if (!span) return;
+  span.setAttributes({
+    [GEN_AI_OPERATION_NAME]: "invoke_workflow",
+    [GEN_AI_CONVERSATION_ID]: sessionId,
+    [ADK_WORKFLOW_NAME]: workflowName,
+    [ADK_NODE_PATH]: nodePath
+  });
+}
+__name(traceWorkflowInvocation, "traceWorkflowInvocation");
+function traceNodeExecution({
+  nodePath,
+  runId,
+  attempt,
+  status,
+  interruptCount
+}) {
+  const span = trace.getActiveSpan();
+  if (!span) return;
+  span.setAttributes({
+    [GEN_AI_OPERATION_NAME]: "execute_node",
+    [ADK_NODE_PATH]: nodePath,
+    [ADK_NODE_RUN_ID]: runId,
+    [ADK_NODE_ATTEMPT]: attempt,
+    [ADK_NODE_STATUS]: status,
+    [ADK_NODE_INTERRUPT_COUNT]: interruptCount
+  });
+}
+__name(traceNodeExecution, "traceNodeExecution");
 function traceToolCall({
   tool,
   args,
@@ -78,6 +122,7 @@ function traceToolCall({
     "gcp.vertex.agent.tool_response": shouldAddRequestResponseToSpans() ? safeJsonSerialize(toolResponse) : "{}"
   });
 }
+__name(traceToolCall, "traceToolCall");
 function traceMergedToolCalls({
   responseEventId,
   functionResponseEvent
@@ -101,28 +146,30 @@ function traceMergedToolCalls({
     shouldAddRequestResponseToSpans() ? safeJsonSerialize(functionResponseEvent) : "{}"
   );
 }
+__name(traceMergedToolCalls, "traceMergedToolCalls");
 function traceCallLlm({
   invocationContext,
   eventId,
   llmRequest,
   llmResponse
 }) {
-  var _a, _b, _c;
+  var _a, _b, _c, _d;
   const span = trace.getActiveSpan();
   if (!span) return;
   span.setAttributes({
     "gen_ai.system": "gcp.vertex.agent",
     "gen_ai.request.model": llmRequest.model,
+    ...((_a = invocationContext.agent) == null ? void 0 : _a.name) ? { [GEN_AI_AGENT_NAME]: invocationContext.agent.name } : {},
     "gcp.vertex.agent.invocation_id": invocationContext.invocationId,
     "gcp.vertex.agent.session_id": invocationContext.session.id,
     "gcp.vertex.agent.event_id": eventId,
     // Consider removing once GenAI SDK provides a way to record this info.
     "gcp.vertex.agent.llm_request": shouldAddRequestResponseToSpans() ? safeJsonSerialize(buildLlmRequestForTrace(llmRequest)) : "{}"
   });
-  if ((_a = llmRequest.config) == null ? void 0 : _a.topP) {
+  if ((_b = llmRequest.config) == null ? void 0 : _b.topP) {
     span.setAttribute("gen_ai.request.top_p", llmRequest.config.topP);
   }
-  if (((_b = llmRequest.config) == null ? void 0 : _b.maxOutputTokens) !== void 0) {
+  if (((_c = llmRequest.config) == null ? void 0 : _c.maxOutputTokens) !== void 0) {
     span.setAttribute(
       "gen_ai.request.max_tokens",
       llmRequest.config.maxOutputTokens
@@ -138,7 +185,7 @@ function traceCallLlm({
       llmResponse.usageMetadata.promptTokenCount || 0
     );
   }
-  if ((_c = llmResponse.usageMetadata) == null ? void 0 : _c.candidatesTokenCount) {
+  if ((_d = llmResponse.usageMetadata) == null ? void 0 : _d.candidatesTokenCount) {
     span.setAttribute(
       "gen_ai.usage.output_tokens",
       llmResponse.usageMetadata.candidatesTokenCount
@@ -149,6 +196,7 @@ function traceCallLlm({
     span.setAttribute("gen_ai.response.finish_reasons", [finishReasonValue]);
   }
 }
+__name(traceCallLlm, "traceCallLlm");
 function traceSendData({
   invocationContext,
   eventId,
@@ -165,6 +213,7 @@ function traceSendData({
     shouldAddRequestResponseToSpans() ? safeJsonSerialize(data) : "{}"
   );
 }
+__name(traceSendData, "traceSendData");
 function buildLlmRequestForTrace(llmRequest) {
   const result = {
     model: llmRequest.model,
@@ -183,6 +232,7 @@ function buildLlmRequestForTrace(llmRequest) {
   });
   return result;
 }
+__name(buildLlmRequestForTrace, "buildLlmRequestForTrace");
 function bindOtelContextToAsyncGenerator(ctx, generator) {
   return {
     // Bind the next() method to execute within the provided context
@@ -200,20 +250,25 @@ function bindOtelContextToAsyncGenerator(ctx, generator) {
     }
   };
 }
+__name(bindOtelContextToAsyncGenerator, "bindOtelContextToAsyncGenerator");
 function runAsyncGeneratorWithOtelContext(otelContext, generatorFnContext, generatorFn) {
   const generator = generatorFn.call(generatorFnContext);
   return bindOtelContextToAsyncGenerator(otelContext, generator);
 }
+__name(runAsyncGeneratorWithOtelContext, "runAsyncGeneratorWithOtelContext");
 function shouldAddRequestResponseToSpans() {
   const envValue = process.env.ADK_CAPTURE_MESSAGE_CONTENT_IN_SPANS || "true";
   return envValue === "true" || envValue === "1";
 }
+__name(shouldAddRequestResponseToSpans, "shouldAddRequestResponseToSpans");
 export {
   runAsyncGeneratorWithOtelContext,
   traceAgentInvocation,
   traceCallLlm,
   traceMergedToolCalls,
+  traceNodeExecution,
   traceSendData,
   traceToolCall,
+  traceWorkflowInvocation,
   tracer
 };

package/dist/esm/tools/agent_tool.js

@@ -1,5 +1,7 @@
 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 2025 Google LLC
@@ -19,7 +21,8 @@ const AGENT_TOOL_SIGNATURE_SYMBOL = Symbol.for("google.adk.agentTool");
 function isAgentTool(obj) {
   return typeof obj === "object" && obj !== null && AGENT_TOOL_SIGNATURE_SYMBOL in obj && obj[AGENT_TOOL_SIGNATURE_SYMBOL] === true;
 }
-class AgentTool extends (_b = BaseTool, _a = AGENT_TOOL_SIGNATURE_SYMBOL, _b) {
+__name(isAgentTool, "isAgentTool");
+const _AgentTool = class _AgentTool extends (_b = BaseTool, _a = AGENT_TOOL_SIGNATURE_SYMBOL, _b) {
   constructor(config) {
     super({
       name: config.agent.name,
@@ -124,7 +127,9 @@ class AgentTool extends (_b = BaseTool, _a = AGENT_TOOL_SIGNATURE_SYMBOL, _b) {
     const mergedText = lastEvent.content.parts.filter((part) => !part.thought).map((part) => part.text).filter((text) => text).join("\n");
     return hasOutputSchema ? JSON.parse(mergedText) : mergedText;
   }
-}
+};
+__name(_AgentTool, "AgentTool");
+let AgentTool = _AgentTool;
 export {
   AgentTool,
   isAgentTool

package/dist/esm/tools/base_tool.js

@@ -1,5 +1,7 @@
 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 2025 Google LLC
@@ -11,8 +13,9 @@ const BASE_TOOL_SIGNATURE_SYMBOL = Symbol.for("google.adk.baseTool");
 function isBaseTool(obj) {
   return typeof obj === "object" && obj !== null && BASE_TOOL_SIGNATURE_SYMBOL in obj && obj[BASE_TOOL_SIGNATURE_SYMBOL] === true;
 }
+__name(isBaseTool, "isBaseTool");
 _a = BASE_TOOL_SIGNATURE_SYMBOL;
-class BaseTool {
+const _BaseTool = class _BaseTool {
   /**
    * Base constructor for a tool.
    *
@@ -42,6 +45,23 @@ class BaseTool {
   _getDeclaration() {
     return void 0;
   }
+  /**
+   * Whether this tool needs a human to approve `args` before it runs.
+   *
+   * The gate itself lives in the tool that owns it (see `FunctionTool`), but
+   * the resume path has to ask the same question a turn later, to check that an
+   * approval it is about to honour belongs to a tool that gates at all. A tool
+   * that never gates returns false here, which is the safe default: an approval
+   * naming it is meaningless and gets rejected rather than executed. Mirrors
+   * Python's `BaseTool.check_require_confirmation`.
+   *
+   * @param _args The arguments the tool would run with.
+   * @param _toolContext The context of the call, when there is one.
+   * @return Whether the call requires confirmation.
+   */
+  async checkRequireConfirmation(_args, _toolContext) {
+    return false;
+  }
   /**
    * Processes the outgoing LLM request for this tool.
    *
@@ -80,13 +100,16 @@ class BaseTool {
   get apiVariant() {
     return getGoogleLlmVariant();
   }
-}
+};
+__name(_BaseTool, "BaseTool");
+let BaseTool = _BaseTool;
 function findToolWithFunctionDeclarations(llmRequest) {
   var _a2;
   return (((_a2 = llmRequest.config) == null ? void 0 : _a2.tools) || []).find(
     (tool) => "functionDeclarations" in tool
   );
 }
+__name(findToolWithFunctionDeclarations, "findToolWithFunctionDeclarations");
 export {
   BaseTool,
   isBaseTool

package/dist/esm/tools/base_toolset.js

@@ -1,5 +1,7 @@
 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 2025 Google LLC
@@ -10,8 +12,9 @@ const BASE_TOOLSET_SIGNATURE_SYMBOL = Symbol.for("google.adk.baseToolset");
 function isBaseToolset(obj) {
   return typeof obj === "object" && obj !== null && BASE_TOOLSET_SIGNATURE_SYMBOL in obj && obj[BASE_TOOLSET_SIGNATURE_SYMBOL] === true;
 }
+__name(isBaseToolset, "isBaseToolset");
 _a = BASE_TOOLSET_SIGNATURE_SYMBOL;
-class BaseToolset {
+const _BaseToolset = class _BaseToolset {
   constructor(toolFilter, prefix) {
     this.toolFilter = toolFilter;
     this.prefix = prefix;
@@ -50,7 +53,9 @@ class BaseToolset {
    */
   async processLlmRequest(toolContext, llmRequest) {
   }
-}
+};
+__name(_BaseToolset, "BaseToolset");
+let BaseToolset = _BaseToolset;
 export {
   BaseToolset,
   isBaseToolset

package/dist/esm/tools/consolidate_context_tool.js

@@ -1,5 +1,7 @@
 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
@@ -7,7 +9,7 @@ const require = topLevelCreateRequire(import.meta.url);
  */
 import { Type } from "@google/genai";
 import { BaseTool } from "./base_tool.js";
-class ConsolidateContextTool extends BaseTool {
+const _ConsolidateContextTool = class _ConsolidateContextTool extends BaseTool {
   constructor() {
     super({
       name: "consolidate_context",
@@ -45,7 +47,9 @@ class ConsolidateContextTool extends BaseTool {
       message: "Context consolidation requested."
     };
   }
-}
+};
+__name(_ConsolidateContextTool, "ConsolidateContextTool");
+let ConsolidateContextTool = _ConsolidateContextTool;
 export {
   ConsolidateContextTool
 };

package/dist/esm/tools/enterprise_web_search_tool.js

@@ -1,5 +1,7 @@
 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
@@ -31,7 +33,8 @@ function applyEnterpriseWebSearch(llmRequest) {
     `Enterprise Web Search tool is not supported for model ${llmRequest.model}`
   );
 }
-class EnterpriseWebSearchTool extends BaseTool {
+__name(applyEnterpriseWebSearch, "applyEnterpriseWebSearch");
+const _EnterpriseWebSearchTool = class _EnterpriseWebSearchTool extends BaseTool {
   constructor() {
     super({
       name: "enterprise_web_search",
@@ -46,7 +49,9 @@ class EnterpriseWebSearchTool extends BaseTool {
   }) {
     applyEnterpriseWebSearch(llmRequest);
   }
-}
+};
+__name(_EnterpriseWebSearchTool, "EnterpriseWebSearchTool");
+let EnterpriseWebSearchTool = _EnterpriseWebSearchTool;
 const ENTERPRISE_WEB_SEARCH = new EnterpriseWebSearchTool();
 export {
   ENTERPRISE_WEB_SEARCH,

package/dist/esm/tools/example_tool.js

@@ -1,5 +1,7 @@
 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
@@ -10,7 +12,7 @@ import { appendInstructions } from "../models/llm_request.js";
 import {
   BaseTool
 } from "./base_tool.js";
-class ExampleTool extends BaseTool {
+const _ExampleTool = class _ExampleTool extends BaseTool {
   constructor(examples) {
     super({
       // Name and description are not used because this tool only changes
@@ -36,7 +38,9 @@ class ExampleTool extends BaseTool {
       buildExampleSi(this.examples, parts[0].text, llmRequest.model)
     ]);
   }
-}
+};
+__name(_ExampleTool, "ExampleTool");
+let ExampleTool = _ExampleTool;
 export {
   ExampleTool
 };

package/dist/esm/tools/exit_loop_tool.js

@@ -1,12 +1,14 @@
 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 { BaseTool } from "./base_tool.js";
-class ExitLoopTool extends BaseTool {
+const _ExitLoopTool = class _ExitLoopTool extends BaseTool {
   /** Creates an ExitLoopTool with its fixed name and description. */
   constructor() {
     super({
@@ -35,7 +37,9 @@ class ExitLoopTool extends BaseTool {
     toolContext.actions.skipSummarization = true;
     return "";
   }
-}
+};
+__name(_ExitLoopTool, "ExitLoopTool");
+let ExitLoopTool = _ExitLoopTool;
 const EXIT_LOOP = new ExitLoopTool();
 export {
   EXIT_LOOP,

package/dist/esm/tools/finish_task_tool.js

@@ -0,0 +1,92 @@
+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 { Type } from "@google/genai";
+import { appendInstructions } from "../models/llm_request.js";
+import {
+  BaseTool
+} from "./base_tool.js";
+const FINISH_TASK_TOOL_NAME = "finish_task";
+const FINISH_TASK_SUCCESS_RESULT = "Task completed.";
+const DEFAULT_TASK_OUTPUT_SCHEMA = {
+  type: Type.OBJECT,
+  properties: {
+    result: {
+      type: Type.STRING,
+      description: "A brief summary of what the agent accomplished."
+    }
+  },
+  required: ["result"]
+};
+const _FinishTaskTool = class _FinishTaskTool extends BaseTool {
+  constructor(outputSchema) {
+    const schema = outputSchema != null ? outputSchema : DEFAULT_TASK_OUTPUT_SCHEMA;
+    let description = "Signal that this agent has completed its delegated task. Call this when you have finished your delegated task.";
+    if (outputSchema) {
+      description += " Pass the required output data in the parameters.";
+    }
+    super({ name: FINISH_TASK_TOOL_NAME, description });
+    this.outputSchema = schema;
+    this.wrapperKey = schema.type === Type.OBJECT ? void 0 : "result";
+  }
+  _getDeclaration() {
+    const parameters = this.wrapperKey ? {
+      type: Type.OBJECT,
+      properties: { [this.wrapperKey]: this.outputSchema },
+      required: [this.wrapperKey]
+    } : this.outputSchema;
+    return { name: this.name, description: this.description, parameters };
+  }
+  async processLlmRequest(request) {
+    await super.processLlmRequest(request);
+    appendInstructions(request.llmRequest, [
+      "Do NOT call `finish_task` prematurely. Use your available tools to fully complete every aspect of the task first. If the task is unclear, ask the user for clarification before proceeding. Once the task is fully complete, call `finish_task` by itself with no accompanying text output."
+    ]);
+  }
+  /**
+   * Extracts the task output from a `finish_task` call's arguments, applying the
+   * wrapper-key unwrapping when the schema is a non-object.
+   */
+  extractOutput(args) {
+    if (this.wrapperKey) {
+      return args[this.wrapperKey];
+    }
+    return args;
+  }
+  async runAsync({ args }) {
+    const value = this.wrapperKey ? args[this.wrapperKey] : args;
+    const missing = this.missingRequiredKeys(value);
+    if (missing.length > 0) {
+      return {
+        error: `Invoking \`${this.name}()\` failed due to missing required parameters: ${missing.join(", ")}. You could retry calling this tool, but it is IMPORTANT for you to provide all the mandatory parameters with correct types.`
+      };
+    }
+    return FINISH_TASK_SUCCESS_RESULT;
+  }
+  /** Returns any `required` keys the schema declares that are absent. */
+  missingRequiredKeys(value) {
+    var _a;
+    const required = this.wrapperKey ? value === void 0 || value === null ? [this.wrapperKey] : [] : (_a = this.outputSchema.required) != null ? _a : [];
+    if (this.wrapperKey) {
+      return required;
+    }
+    if (typeof value !== "object" || value === null) {
+      return required;
+    }
+    const obj = value;
+    return required.filter((key) => obj[key] === void 0);
+  }
+};
+__name(_FinishTaskTool, "FinishTaskTool");
+let FinishTaskTool = _FinishTaskTool;
+export {
+  FINISH_TASK_SUCCESS_RESULT,
+  FINISH_TASK_TOOL_NAME,
+  FinishTaskTool
+};

package/dist/esm/tools/forwarding_artifact_service.js

@@ -1,11 +1,13 @@
 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 2025 Google LLC
  * SPDX-License-Identifier: Apache-2.0
  */
-class ForwardingArtifactService {
+const _ForwardingArtifactService = class _ForwardingArtifactService {
   constructor(toolContext) {
     this.toolContext = toolContext;
     this.invocationContext = toolContext.invocationContext;
@@ -41,7 +43,9 @@ class ForwardingArtifactService {
       version: request.version
     });
   }
-}
+};
+__name(_ForwardingArtifactService, "ForwardingArtifactService");
+let ForwardingArtifactService = _ForwardingArtifactService;
 export {
   ForwardingArtifactService
 };

package/dist/esm/tools/function_tool.js

@@ -1,5 +1,7 @@
 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 2025 Google LLC
@@ -18,17 +20,19 @@ function toSchema(parameters) {
   }
   return parameters;
 }
+__name(toSchema, "toSchema");
 const FUNCTION_TOOL_SIGNATURE_SYMBOL = Symbol.for("google.adk.functionTool");
 function isFunctionTool(obj) {
   return typeof obj === "object" && obj !== null && FUNCTION_TOOL_SIGNATURE_SYMBOL in obj && obj[FUNCTION_TOOL_SIGNATURE_SYMBOL] === true;
 }
-class FunctionTool extends (_b = BaseTool, _a = FUNCTION_TOOL_SIGNATURE_SYMBOL, _b) {
+__name(isFunctionTool, "isFunctionTool");
+const _FunctionTool = class _FunctionTool extends (_b = BaseTool, _a = FUNCTION_TOOL_SIGNATURE_SYMBOL, _b) {
   /**
    * The constructor acts as the user-friendly factory.
    * @param options The configuration for the tool.
    */
   constructor(options) {
-    var _a2;
+    var _a2, _b2;
     const name = (_a2 = options.name) != null ? _a2 : options.execute.name;
     if (!name) {
       throw new Error(
@@ -44,6 +48,7 @@ class FunctionTool extends (_b = BaseTool, _a = FUNCTION_TOOL_SIGNATURE_SYMBOL,
     this[_a] = true;
     this.execute = options.execute;
     this.parameters = options.parameters;
+    this.requireConfirmation = (_b2 = options.requireConfirmation) != null ? _b2 : false;
   }
   /**
    * Returns the function declaration derived from the tool's name, description,
@@ -65,20 +70,81 @@ class FunctionTool extends (_b = BaseTool, _a = FUNCTION_TOOL_SIGNATURE_SYMBOL,
    */
   async runAsync(req) {
     try {
-      let validatedArgs = req.args;
-      if (isZodObject(this.parameters)) {
-        validatedArgs = this.parameters.parse(req.args);
-      }
-      return await this.execute(
+      const validatedArgs = this.validateArgs(req.args);
+      const pending = await this.checkConfirmation(
         validatedArgs,
         req.toolContext
       );
+      if (pending !== void 0) {
+        return pending;
+      }
+      return await this.execute(validatedArgs, req.toolContext);
     } catch (error) {
       const errorMessage = error instanceof Error ? error.message : String(error);
       throw new Error(`Error in tool '${this.name}': ${errorMessage}`);
     }
   }
-}
+  /**
+   * Whether this call is gated on human approval — the static flag, or the
+   * predicate evaluated against the validated arguments.
+   *
+   * @param args The arguments the tool would run with.
+   * @param toolContext The context of the call, when there is one.
+   * @return Whether the call requires confirmation.
+   */
+  async checkRequireConfirmation(args, toolContext) {
+    if (typeof this.requireConfirmation !== "function") {
+      return this.requireConfirmation;
+    }
+    return this.requireConfirmation(this.validateArgs(args), toolContext);
+  }
+  /** Parses `args` against the parameter schema, when one is declared. */
+  validateArgs(args) {
+    if (isZodObject(this.parameters)) {
+      return this.parameters.parse(args);
+    }
+    return args;
+  }
+  /** Resolves `requireConfirmation`, which may be a flag or a predicate. */
+  async evaluateRequireConfirmation(input, toolContext) {
+    return typeof this.requireConfirmation === "function" ? this.requireConfirmation(input, toolContext) : this.requireConfirmation;
+  }
+  /**
+   * Evaluates the confirmation gate. Returns `undefined` if the tool may
+   * proceed; otherwise returns the function response payload to surface instead
+   * of running (a request-for-confirmation on the first pass, or a rejection
+   * once the user declined).
+   */
+  async checkConfirmation(input, toolContext) {
+    const requireConfirmation = await this.evaluateRequireConfirmation(
+      input,
+      toolContext
+    );
+    if (!requireConfirmation) {
+      return void 0;
+    }
+    if (!toolContext) {
+      throw new Error(
+        `Tool '${this.name}' requires confirmation but no tool context was provided.`
+      );
+    }
+    if (!toolContext.toolConfirmation) {
+      toolContext.requestConfirmation({
+        hint: `Please approve or reject the tool call ${this.name}() by responding with a FunctionResponse with an expected ToolConfirmation payload.`
+      });
+      toolContext.actions.skipSummarization = true;
+      return {
+        error: "This tool call requires confirmation, please approve or reject."
+      };
+    }
+    if (!toolContext.toolConfirmation.confirmed) {
+      return { error: "This tool call is rejected." };
+    }
+    return void 0;
+  }
+};
+__name(_FunctionTool, "FunctionTool");
+let FunctionTool = _FunctionTool;
 export {
   FunctionTool,
   isFunctionTool

package/dist/esm/tools/get_user_choice_tool.js

@@ -0,0 +1,27 @@
+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 { z } from "zod";
+import { LongRunningFunctionTool } from "./long_running_tool.js";
+const getUserChoiceTool = new LongRunningFunctionTool({
+  name: "get_user_choice",
+  description: "Presents a list of options to the user and awaits their selection.",
+  parameters: z.object({
+    options: z.array(z.string()).describe("List of options to present to the user.")
+  }),
+  execute: /* @__PURE__ */ __name(async (input, context) => {
+    if (context) {
+      context.actions.skipSummarization = true;
+    }
+    return null;
+  }, "execute")
+});
+export {
+  getUserChoiceTool
+};