@google/adk 2.0.0 → 2.1.0

package/dist/web/tools/enterprise_web_search_tool.js

@@ -1,60 +0,0 @@
-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 {
-  isGemini1Model,
-  isGeminiModel,
-  isGeminiModelIdCheckDisabled
-} from "../utils/model_name.js";
-import { BaseTool } from "./base_tool.js";
-function applyEnterpriseWebSearch(llmRequest) {
-  if (!llmRequest.model) {
-    return;
-  }
-  const modelCheckDisabled = isGeminiModelIdCheckDisabled();
-  llmRequest.config = llmRequest.config || {};
-  llmRequest.config.tools = llmRequest.config.tools || [];
-  if (isGeminiModel(llmRequest.model) || modelCheckDisabled) {
-    if (isGemini1Model(llmRequest.model) && llmRequest.config.tools.length > 0) {
-      throw new Error(
-        "Enterprise Web Search tool cannot be used with other tools in Gemini 1.x."
-      );
-    }
-    llmRequest.config.tools.push({ enterpriseWebSearch: {} });
-    return;
-  }
-  throw new Error(
-    "Enterprise Web Search tool is not supported for model ".concat(llmRequest.model)
-  );
-}
-__name(applyEnterpriseWebSearch, "applyEnterpriseWebSearch");
-const _EnterpriseWebSearchTool = class _EnterpriseWebSearchTool extends BaseTool {
-  constructor() {
-    super({
-      name: "enterprise_web_search",
-      description: "Enterprise Web Search Tool"
-    });
-  }
-  runAsync() {
-    return Promise.resolve();
-  }
-  async processLlmRequest({
-    llmRequest
-  }) {
-    applyEnterpriseWebSearch(llmRequest);
-  }
-};
-__name(_EnterpriseWebSearchTool, "EnterpriseWebSearchTool");
-let EnterpriseWebSearchTool = _EnterpriseWebSearchTool;
-const ENTERPRISE_WEB_SEARCH = new EnterpriseWebSearchTool();
-export {
-  ENTERPRISE_WEB_SEARCH,
-  EnterpriseWebSearchTool,
-  applyEnterpriseWebSearch
-};

package/dist/web/tools/example_tool.js

@@ -1,46 +0,0 @@
-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 { buildExampleSi } from "../examples/example_util.js";
-import { appendInstructions } from "../models/llm_request.js";
-import {
-  BaseTool
-} from "./base_tool.js";
-const _ExampleTool = class _ExampleTool extends BaseTool {
-  constructor(examples) {
-    super({
-      // Name and description are not used because this tool only changes
-      // llmRequest.
-      name: "example_tool",
-      description: "example tool"
-    });
-    this.examples = examples;
-  }
-  async runAsync(_request) {
-    throw new Error("ExampleTool should not be called by model");
-  }
-  async processLlmRequest({
-    toolContext,
-    llmRequest
-  }) {
-    var _a, _b;
-    const parts = (_a = toolContext.userContent) == null ? void 0 : _a.parts;
-    if (!parts || !((_b = parts[0]) == null ? void 0 : _b.text)) {
-      return;
-    }
-    appendInstructions(llmRequest, [
-      buildExampleSi(this.examples, parts[0].text, llmRequest.model)
-    ]);
-  }
-};
-__name(_ExampleTool, "ExampleTool");
-let ExampleTool = _ExampleTool;
-export {
-  ExampleTool
-};

package/dist/web/tools/exit_loop_tool.js

@@ -1,47 +0,0 @@
-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";
-const _ExitLoopTool = class _ExitLoopTool extends BaseTool {
-  /** Creates an ExitLoopTool with its fixed name and description. */
-  constructor() {
-    super({
-      name: "exit_loop",
-      description: "Exits the loop.\n\nCall this function only when you are instructed to do so."
-    });
-  }
-  /** Returns the function declaration for this tool. */
-  _getDeclaration() {
-    return {
-      name: this.name,
-      description: this.description
-    };
-  }
-  /**
-   * Sets `escalate` and `skipSummarization` on the event actions, signalling
-   * the {@link LoopAgent} to stop iterating.
-   *
-   * @param request The tool request containing the current tool context.
-   * @returns An empty string response.
-   */
-  async runAsync({
-    toolContext
-  }) {
-    toolContext.actions.escalate = true;
-    toolContext.actions.skipSummarization = true;
-    return "";
-  }
-};
-__name(_ExitLoopTool, "ExitLoopTool");
-let ExitLoopTool = _ExitLoopTool;
-const EXIT_LOOP = new ExitLoopTool();
-export {
-  EXIT_LOOP,
-  ExitLoopTool
-};

package/dist/web/tools/finish_task_tool.js

@@ -1,92 +0,0 @@
-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 `".concat(this.name, "()` failed due to missing required ") + "parameters: ".concat(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/web/tools/forwarding_artifact_service.js

@@ -1,51 +0,0 @@
-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
- */
-const _ForwardingArtifactService = class _ForwardingArtifactService {
-  constructor(toolContext) {
-    this.toolContext = toolContext;
-    this.invocationContext = toolContext.invocationContext;
-  }
-  async saveArtifact(request) {
-    return this.toolContext.saveArtifact(request.filename, request.artifact);
-  }
-  async loadArtifact(request) {
-    return this.toolContext.loadArtifact(request.filename, request.version);
-  }
-  async listArtifactKeys(_request) {
-    return this.toolContext.listArtifacts();
-  }
-  getArtifactService() {
-    const service = this.invocationContext.artifactService;
-    if (!service) {
-      throw new Error("Artifact service is not initialized.");
-    }
-    return service;
-  }
-  async deleteArtifact(request) {
-    return this.getArtifactService().deleteArtifact(request.filename);
-  }
-  async listVersions(request) {
-    return this.getArtifactService().listVersions(request.filename);
-  }
-  async listArtifactVersions(request) {
-    return this.getArtifactService().listArtifactVersions(request.filename);
-  }
-  async getArtifactVersion(request) {
-    return this.getArtifactService().getArtifactVersion({
-      filename: request.filename,
-      version: request.version
-    });
-  }
-};
-__name(_ForwardingArtifactService, "ForwardingArtifactService");
-let ForwardingArtifactService = _ForwardingArtifactService;
-export {
-  ForwardingArtifactService
-};

package/dist/web/tools/function_tool.js

@@ -1,151 +0,0 @@
-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
- */
-var _a, _b;
-import { Type } from "@google/genai";
-import { isZodObject, zodObjectToSchema } from "../utils/simple_zod_to_json.js";
-import { BaseTool } from "./base_tool.js";
-function toSchema(parameters) {
-  if (parameters === void 0) {
-    return { type: Type.OBJECT, properties: {} };
-  }
-  if (isZodObject(parameters)) {
-    return zodObjectToSchema(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;
-}
-__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, _b2;
-    const name = (_a2 = options.name) != null ? _a2 : options.execute.name;
-    if (!name) {
-      throw new Error(
-        "Tool name cannot be empty. Either name the `execute` function or provide a `name`."
-      );
-    }
-    super({
-      name,
-      description: options.description,
-      isLongRunning: options.isLongRunning
-    });
-    /** A unique symbol to identify ADK function tool class. */
-    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,
-   * and parameter schema.
-   */
-  _getDeclaration() {
-    return {
-      name: this.name,
-      description: this.description,
-      parameters: toSchema(this.parameters)
-    };
-  }
-  /**
-   * Validates the model-provided arguments against the parameter schema and
-   * invokes the user-defined `execute` function.
-   *
-   * @param req The tool request containing arguments and tool context.
-   * @returns A promise resolving to the function's return value.
-   */
-  async runAsync(req) {
-    try {
-      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 '".concat(this.name, "': ").concat(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 '".concat(this.name, "' requires confirmation but no tool context was provided.")
-      );
-    }
-    if (!toolContext.toolConfirmation) {
-      toolContext.requestConfirmation({
-        hint: "Please approve or reject the tool call ".concat(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/web/tools/get_user_choice_tool.js

@@ -1,27 +0,0 @@
-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
-};

package/dist/web/tools/google_maps_grounding_tool.js

@@ -1,59 +0,0 @@
-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 {
-  isGemini1Model,
-  isGeminiModel,
-  isGeminiModelIdCheckDisabled
-} from "../utils/model_name.js";
-import { BaseTool } from "./base_tool.js";
-function applyGoogleMapsGrounding(llmRequest) {
-  if (!llmRequest.model) {
-    return;
-  }
-  const modelCheckDisabled = isGeminiModelIdCheckDisabled();
-  llmRequest.config = llmRequest.config || {};
-  llmRequest.config.tools = llmRequest.config.tools || [];
-  if (isGemini1Model(llmRequest.model)) {
-    throw new Error(
-      "Google Maps grounding tool cannot be used with Gemini 1.x models."
-    );
-  }
-  if (isGeminiModel(llmRequest.model) || modelCheckDisabled) {
-    llmRequest.config.tools.push({
-      googleMaps: {}
-    });
-    return;
-  }
-  throw new Error(
-    "Google maps tool is not supported for model ".concat(llmRequest.model)
-  );
-}
-__name(applyGoogleMapsGrounding, "applyGoogleMapsGrounding");
-const _GoogleMapsGroundingTool = class _GoogleMapsGroundingTool extends BaseTool {
-  constructor() {
-    super({ name: "google_maps", description: "Google Maps Grounding Tool" });
-  }
-  runAsync() {
-    return Promise.resolve();
-  }
-  async processLlmRequest({
-    llmRequest
-  }) {
-    applyGoogleMapsGrounding(llmRequest);
-  }
-};
-__name(_GoogleMapsGroundingTool, "GoogleMapsGroundingTool");
-let GoogleMapsGroundingTool = _GoogleMapsGroundingTool;
-const GOOGLE_MAPS_GROUNDING = new GoogleMapsGroundingTool();
-export {
-  GOOGLE_MAPS_GROUNDING,
-  GoogleMapsGroundingTool,
-  applyGoogleMapsGrounding
-};

package/dist/web/tools/google_search_tool.js

@@ -1,55 +0,0 @@
-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
- */
-import { isGemini1Model, isGeminiModel } from "../utils/model_name.js";
-import { BaseTool } from "./base_tool.js";
-const _GoogleSearchTool = class _GoogleSearchTool extends BaseTool {
-  constructor() {
-    super({ name: "google_search", description: "Google Search Tool" });
-  }
-  runAsync() {
-    return Promise.resolve();
-  }
-  async processLlmRequest({
-    llmRequest
-  }) {
-    if (!llmRequest.model) {
-      return;
-    }
-    llmRequest.config = llmRequest.config || {};
-    llmRequest.config.tools = llmRequest.config.tools || [];
-    if (isGemini1Model(llmRequest.model)) {
-      if (llmRequest.config.tools.length > 0) {
-        throw new Error(
-          "Google search tool can not be used with other tools in Gemini 1.x."
-        );
-      }
-      llmRequest.config.tools.push({
-        googleSearchRetrieval: {}
-      });
-      return;
-    }
-    if (isGeminiModel(llmRequest.model)) {
-      llmRequest.config.tools.push({
-        googleSearch: {}
-      });
-      return;
-    }
-    throw new Error(
-      "Google search tool is not supported for model ".concat(llmRequest.model)
-    );
-  }
-};
-__name(_GoogleSearchTool, "GoogleSearchTool");
-let GoogleSearchTool = _GoogleSearchTool;
-const GOOGLE_SEARCH = new GoogleSearchTool();
-export {
-  GOOGLE_SEARCH,
-  GoogleSearchTool
-};