@google/adk 2.2.1 → 2.3.0

package/dist/cjs/tools/google_api_tool/google_api_tool_sets.js

@@ -0,0 +1,58 @@
+/**
+  * @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 google_api_tool_sets_exports = {};
+__export(google_api_tool_sets_exports, {
+  bigqueryToolSet: () => bigqueryToolSet,
+  calendarToolSet: () => calendarToolSet,
+  docsToolSet: () => docsToolSet,
+  gmailToolSet: () => gmailToolSet,
+  sheetsToolSet: () => sheetsToolSet,
+  slidesToolSet: () => slidesToolSet,
+  youtubeToolSet: () => youtubeToolSet
+});
+module.exports = __toCommonJS(google_api_tool_sets_exports);
+var import_google_api_tool_set = require("./google_api_tool_set.js");
+/**
+ * @license
+ * Copyright 2026 Google LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+const calendarToolSet = (0, import_google_api_tool_set.createLazyGoogleApiToolSet)("calendar", "v3");
+const bigqueryToolSet = (0, import_google_api_tool_set.createLazyGoogleApiToolSet)("bigquery", "v2");
+const gmailToolSet = (0, import_google_api_tool_set.createLazyGoogleApiToolSet)("gmail", "v1");
+const youtubeToolSet = (0, import_google_api_tool_set.createLazyGoogleApiToolSet)("youtube", "v3");
+const slidesToolSet = (0, import_google_api_tool_set.createLazyGoogleApiToolSet)("slides", "v1");
+const sheetsToolSet = (0, import_google_api_tool_set.createLazyGoogleApiToolSet)("sheets", "v4");
+const docsToolSet = (0, import_google_api_tool_set.createLazyGoogleApiToolSet)("docs", "v1");
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  bigqueryToolSet,
+  calendarToolSet,
+  docsToolSet,
+  gmailToolSet,
+  sheetsToolSet,
+  slidesToolSet,
+  youtubeToolSet
+});

package/dist/cjs/tools/google_api_tool/googleapi_to_openapi_converter.js

@@ -0,0 +1,440 @@
+/**
+  * @license
+  * Copyright 2026 Google LLC
+  * SPDX-License-Identifier: Apache-2.0
+  */
+
+"use strict";
+var __create = Object.create;
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __getProtoOf = Object.getPrototypeOf;
+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 __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__getProtoOf(mod)) : {}, __copyProps(
+  // If the importer is in node compatibility mode or this is not an ESM
+  // file that has been converted to a CommonJS file using a Babel-
+  // compatible transform (i.e. "__esModule" has not been set), then set
+  // "default" to the CommonJS "module.exports" for node compatibility.
+  isNodeMode || !mod || !mod.__esModule ? __defProp(target, "default", { value: mod, enumerable: true }) : target,
+  mod
+));
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+var __decorateClass = (decorators, target, key, kind) => {
+  var result = kind > 1 ? void 0 : kind ? __getOwnPropDesc(target, key) : target;
+  for (var i = decorators.length - 1, decorator; i >= 0; i--)
+    if (decorator = decorators[i])
+      result = (kind ? decorator(target, key, result) : decorator(result)) || result;
+  if (kind && result) __defProp(target, key, result);
+  return result;
+};
+var googleapi_to_openapi_converter_exports = {};
+__export(googleapi_to_openapi_converter_exports, {
+  GoogleApiToOpenApiConverter: () => GoogleApiToOpenApiConverter,
+  convertInfo: () => convertInfo,
+  convertMethods: () => convertMethods,
+  convertOperation: () => convertOperation,
+  convertParameterSchema: () => convertParameterSchema,
+  convertResources: () => convertResources,
+  convertSchemaObject: () => convertSchemaObject,
+  convertSchemas: () => convertSchemas,
+  convertSecuritySchemes: () => convertSecuritySchemes,
+  convertServers: () => convertServers,
+  extractPathParameters: () => extractPathParameters,
+  normalizeGoogleSchemaRef: () => normalizeGoogleSchemaRef
+});
+module.exports = __toCommonJS(googleapi_to_openapi_converter_exports);
+var fs = __toESM(require("node:fs"), 1);
+var import_experimental = require("../../utils/experimental.js");
+var import_logger = require("../../utils/logger.js");
+/**
+ * @license
+ * Copyright 2026 Google LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+const GOOGLE_DISCOVERY_BASE_URL = "https://www.googleapis.com/discovery/v1/apis";
+const GOOGLE_OAUTH2_AUTH_URL = "https://accounts.google.com/o/oauth2/auth";
+const GOOGLE_OAUTH2_TOKEN_URL = "https://oauth2.googleapis.com/token";
+function normalizeGoogleSchemaRef(ref) {
+  if (ref.startsWith("#")) {
+    return `#/components/schemas/${ref.slice(1)}`;
+  }
+  return `#/components/schemas/${ref}`;
+}
+__name(normalizeGoogleSchemaRef, "normalizeGoogleSchemaRef");
+function convertInfo(googleApiSpec, openapiSpec, apiName, apiVersion) {
+  var _a, _b, _c, _d;
+  openapiSpec.info = {
+    title: (_a = googleApiSpec.title) != null ? _a : `${apiName} API`,
+    description: (_b = googleApiSpec.description) != null ? _b : "",
+    version: (_c = googleApiSpec.version) != null ? _c : apiVersion,
+    contact: {},
+    termsOfService: (_d = googleApiSpec.documentationLink) != null ? _d : ""
+  };
+  const docsLink = googleApiSpec.documentationLink;
+  if (docsLink) {
+    openapiSpec.externalDocs = {
+      description: "API Documentation",
+      url: docsLink
+    };
+  }
+}
+__name(convertInfo, "convertInfo");
+function convertServers(googleApiSpec, openapiSpec, apiName, apiVersion) {
+  var _a, _b;
+  let baseUrl = `${(_a = googleApiSpec.rootUrl) != null ? _a : ""}${(_b = googleApiSpec.servicePath) != null ? _b : ""}`;
+  if (baseUrl.endsWith("/")) {
+    baseUrl = baseUrl.slice(0, -1);
+  }
+  openapiSpec.servers = [
+    {
+      url: baseUrl,
+      description: `${apiName} ${apiVersion} API`
+    }
+  ];
+}
+__name(convertServers, "convertServers");
+function convertSecuritySchemes(googleApiSpec, openapiSpec) {
+  var _a, _b, _c, _d, _e;
+  openapiSpec.components = (_a = openapiSpec.components) != null ? _a : {};
+  openapiSpec.components.securitySchemes = (_b = openapiSpec.components.securitySchemes) != null ? _b : {};
+  const oauth2 = (_c = googleApiSpec.auth) == null ? void 0 : _c.oauth2;
+  const hasOauth2 = oauth2 !== void 0 && Object.keys(oauth2).length > 0;
+  const formattedScopes = {};
+  if (hasOauth2) {
+    const scopes = (_d = oauth2.scopes) != null ? _d : {};
+    for (const [scope, scopeInfo] of Object.entries(scopes)) {
+      formattedScopes[scope] = (_e = scopeInfo.description) != null ? _e : "";
+    }
+    openapiSpec.components.securitySchemes["oauth2"] = {
+      type: "oauth2",
+      description: "OAuth 2.0 authentication",
+      flows: {
+        authorizationCode: {
+          authorizationUrl: GOOGLE_OAUTH2_AUTH_URL,
+          tokenUrl: GOOGLE_OAUTH2_TOKEN_URL,
+          scopes: formattedScopes
+        }
+      }
+    };
+  }
+  openapiSpec.components.securitySchemes["apiKey"] = {
+    type: "apiKey",
+    in: "query",
+    name: "key",
+    description: "API key for accessing this API"
+  };
+  openapiSpec.security = [
+    hasOauth2 ? { oauth2: Object.keys(formattedScopes) } : {},
+    { apiKey: [] }
+  ];
+}
+__name(convertSecuritySchemes, "convertSecuritySchemes");
+function convertSchemaObject(schemaDef) {
+  var _a;
+  const result = {};
+  if (schemaDef.type !== void 0) {
+    const gtype = schemaDef.type;
+    if (gtype === "object") {
+      result["type"] = "object";
+      if (schemaDef.properties !== void 0) {
+        const properties = {};
+        for (const [propName, propDef] of Object.entries(
+          schemaDef.properties
+        )) {
+          properties[propName] = convertSchemaObject(propDef);
+        }
+        result["properties"] = properties;
+      }
+      const requiredFields = [];
+      for (const [propName, propDef] of Object.entries(
+        (_a = schemaDef.properties) != null ? _a : {}
+      )) {
+        if (propDef.required) {
+          requiredFields.push(propName);
+        }
+      }
+      if (requiredFields.length > 0) {
+        result["required"] = requiredFields;
+      }
+    } else if (gtype === "array") {
+      result["type"] = "array";
+      if (schemaDef.items !== void 0) {
+        result["items"] = convertSchemaObject(schemaDef.items);
+      }
+    } else if (gtype === "any") {
+      result["oneOf"] = [
+        { type: "object" },
+        { type: "array" },
+        { type: "string" },
+        { type: "number" },
+        { type: "boolean" },
+        { type: "null" }
+      ];
+    } else {
+      result["type"] = gtype;
+    }
+  }
+  if (schemaDef.$ref !== void 0) {
+    result["$ref"] = normalizeGoogleSchemaRef(schemaDef.$ref);
+  }
+  if (schemaDef.format !== void 0) {
+    result["format"] = schemaDef.format;
+  }
+  if (schemaDef.enum !== void 0) {
+    result["enum"] = schemaDef.enum;
+  }
+  if (schemaDef.description !== void 0) {
+    result["description"] = schemaDef.description;
+  }
+  if (schemaDef.pattern !== void 0) {
+    result["pattern"] = schemaDef.pattern;
+  }
+  if (schemaDef.default !== void 0) {
+    result["default"] = schemaDef.default;
+  }
+  return result;
+}
+__name(convertSchemaObject, "convertSchemaObject");
+function convertSchemas(googleApiSpec, openapiSpec) {
+  var _a, _b, _c;
+  openapiSpec.components = (_a = openapiSpec.components) != null ? _a : {};
+  openapiSpec.components.schemas = (_b = openapiSpec.components.schemas) != null ? _b : {};
+  const schemas = (_c = googleApiSpec.schemas) != null ? _c : {};
+  for (const [schemaName, schemaDef] of Object.entries(schemas)) {
+    openapiSpec.components.schemas[schemaName] = convertSchemaObject(schemaDef);
+  }
+}
+__name(convertSchemas, "convertSchemas");
+function extractPathParameters(path) {
+  const params = [];
+  for (const match of path.matchAll(/\{\+?([^{}]+)\}/g)) {
+    params.push(match[1]);
+  }
+  return params;
+}
+__name(extractPathParameters, "extractPathParameters");
+function convertParameterSchema(paramData) {
+  var _a;
+  const schema = {
+    type: (_a = paramData.type) != null ? _a : "string"
+  };
+  if (paramData.enum !== void 0) {
+    schema["enum"] = paramData.enum;
+  }
+  if (paramData.format !== void 0) {
+    schema["format"] = paramData.format;
+  }
+  if (paramData.default !== void 0) {
+    schema["default"] = paramData.default;
+  }
+  if (paramData.pattern !== void 0) {
+    schema["pattern"] = paramData.pattern;
+  }
+  return schema;
+}
+__name(convertParameterSchema, "convertParameterSchema");
+function convertOperation(methodData, pathParams) {
+  var _a, _b, _c, _d, _e, _f, _g, _h, _i, _j;
+  const parameters = [];
+  for (const paramName of pathParams) {
+    parameters.push({
+      name: paramName,
+      in: "path",
+      required: true,
+      schema: { type: "string" }
+    });
+  }
+  const pathParamSet = new Set(pathParams);
+  for (const [paramName, paramData] of Object.entries(
+    (_a = methodData.parameters) != null ? _a : {}
+  )) {
+    if (pathParamSet.has(paramName)) {
+      continue;
+    }
+    const location = (_b = paramData.location) != null ? _b : "query";
+    parameters.push({
+      name: paramName,
+      in: location,
+      description: (_c = paramData.description) != null ? _c : "",
+      required: location === "path" ? true : (_d = paramData.required) != null ? _d : false,
+      schema: convertParameterSchema(paramData)
+    });
+  }
+  const response200 = {
+    description: "Successful operation"
+  };
+  const responseRef = (_e = methodData.response) == null ? void 0 : _e.$ref;
+  if (responseRef) {
+    response200.content = {
+      "application/json": {
+        schema: { $ref: normalizeGoogleSchemaRef(responseRef) }
+      }
+    };
+  }
+  const operation = {
+    operationId: (_f = methodData.id) != null ? _f : "",
+    summary: (_g = methodData.description) != null ? _g : "",
+    description: (_h = methodData.description) != null ? _h : "",
+    parameters,
+    responses: {
+      "200": response200,
+      "400": { description: "Bad request" },
+      "401": { description: "Unauthorized" },
+      "403": { description: "Forbidden" },
+      "404": { description: "Not found" },
+      "500": { description: "Server error" }
+    }
+  };
+  const requestRef = (_i = methodData.request) == null ? void 0 : _i.$ref;
+  if (requestRef) {
+    operation.requestBody = {
+      description: "Request body",
+      content: {
+        "application/json": {
+          schema: { $ref: normalizeGoogleSchemaRef(requestRef) }
+        }
+      },
+      required: true
+    };
+  }
+  const scopes = (_j = methodData.scopes) != null ? _j : [];
+  if (scopes.length > 0) {
+    operation.security = [{ oauth2: scopes }];
+  }
+  return operation;
+}
+__name(convertOperation, "convertOperation");
+function convertMethods(methods, _resourcePath, openapiSpec) {
+  var _a, _b;
+  for (const methodData of Object.values(methods)) {
+    const httpMethod = ((_a = methodData.httpMethod) != null ? _a : "GET").toLowerCase();
+    let restPath = ((_b = methodData.path) != null ? _b : "/").replace(
+      /\{\+([^{}]+)\}/g,
+      (_match, paramName) => `{${paramName}}`
+    );
+    if (!restPath.startsWith("/")) {
+      restPath = `/${restPath}`;
+    }
+    const pathParams = extractPathParameters(restPath);
+    if (!openapiSpec.paths[restPath]) {
+      openapiSpec.paths[restPath] = {};
+    }
+    const pathItem = openapiSpec.paths[restPath];
+    pathItem[httpMethod] = convertOperation(methodData, pathParams);
+  }
+}
+__name(convertMethods, "convertMethods");
+function convertResources(resources, openapiSpec, parentPath = "") {
+  var _a;
+  for (const [resourceName, resourceData] of Object.entries(resources)) {
+    const resourcePath = `${parentPath}/${resourceName}`;
+    convertMethods((_a = resourceData.methods) != null ? _a : {}, resourcePath, openapiSpec);
+    if (resourceData.resources && Object.keys(resourceData.resources).length > 0) {
+      convertResources(resourceData.resources, openapiSpec, resourcePath);
+    }
+  }
+}
+__name(convertResources, "convertResources");
+let GoogleApiToOpenApiConverter = class {
+  constructor(apiName, apiVersion) {
+    this.googleApiSpec = null;
+    this.apiName = apiName;
+    this.apiVersion = apiVersion;
+    this.openapiSpec = {
+      openapi: "3.0.0",
+      info: {},
+      servers: [],
+      paths: {},
+      components: { schemas: {}, securitySchemes: {} }
+    };
+  }
+  async fetchGoogleApiSpec() {
+    try {
+      import_logger.logger.debug(
+        `Fetching Google API spec for ${this.apiName} ${this.apiVersion}`
+      );
+      const url = `${GOOGLE_DISCOVERY_BASE_URL}/${encodeURIComponent(this.apiName)}/${encodeURIComponent(this.apiVersion)}/rest`;
+      const response = await globalThis.fetch(url);
+      if (response.status >= 400) {
+        throw new Error(
+          `HTTP Error ${response.status}: Failed to fetch Google API spec for ${this.apiName} ${this.apiVersion}`
+        );
+      }
+      const spec = await response.json();
+      if (!spec || typeof spec !== "object" || Object.keys(spec).length === 0) {
+        throw new Error("Failed to retrieve API specification");
+      }
+      this.googleApiSpec = spec;
+      import_logger.logger.debug(`Successfully fetched ${this.apiName} API specification`);
+    } catch (error) {
+      import_logger.logger.error(
+        `Error fetching API spec: ${error instanceof Error ? error.message : String(error)}`
+      );
+      throw error;
+    }
+  }
+  async convert() {
+    var _a, _b, _c;
+    if (!this.googleApiSpec) {
+      await this.fetchGoogleApiSpec();
+    }
+    const spec = (_a = this.googleApiSpec) != null ? _a : {};
+    convertInfo(spec, this.openapiSpec, this.apiName, this.apiVersion);
+    convertServers(spec, this.openapiSpec, this.apiName, this.apiVersion);
+    convertSecuritySchemes(spec, this.openapiSpec);
+    convertSchemas(spec, this.openapiSpec);
+    convertResources((_b = spec.resources) != null ? _b : {}, this.openapiSpec);
+    convertMethods((_c = spec.methods) != null ? _c : {}, "/", this.openapiSpec);
+    return this.openapiSpec;
+  }
+  saveOpenapiSpec(outputPath) {
+    fs.writeFileSync(
+      outputPath,
+      JSON.stringify(this.openapiSpec, null, 2),
+      "utf-8"
+    );
+    import_logger.logger.info(`OpenAPI specification saved to ${outputPath}`);
+  }
+};
+__name(GoogleApiToOpenApiConverter, "GoogleApiToOpenApiConverter");
+__decorateClass([
+  import_experimental.experimental
+], GoogleApiToOpenApiConverter.prototype, "fetchGoogleApiSpec", 1);
+__decorateClass([
+  import_experimental.experimental
+], GoogleApiToOpenApiConverter.prototype, "convert", 1);
+__decorateClass([
+  import_experimental.experimental
+], GoogleApiToOpenApiConverter.prototype, "saveOpenapiSpec", 1);
+GoogleApiToOpenApiConverter = __decorateClass([
+  import_experimental.experimental
+], GoogleApiToOpenApiConverter);
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  GoogleApiToOpenApiConverter,
+  convertInfo,
+  convertMethods,
+  convertOperation,
+  convertParameterSchema,
+  convertResources,
+  convertSchemaObject,
+  convertSchemas,
+  convertSecuritySchemes,
+  convertServers,
+  extractPathParameters,
+  normalizeGoogleSchemaRef
+});

package/dist/cjs/tools/google_api_tool/index.js

@@ -0,0 +1,64 @@
+/**
+  * @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 google_api_tool_exports = {};
+__export(google_api_tool_exports, {
+  GoogleApiToOpenApiConverter: () => import_googleapi_to_openapi_converter.GoogleApiToOpenApiConverter,
+  GoogleApiTool: () => import_google_api_tool.GoogleApiTool,
+  GoogleApiToolSet: () => import_google_api_tool_set.GoogleApiToolSet,
+  bigqueryToolSet: () => import_google_api_tool_sets.bigqueryToolSet,
+  calendarToolSet: () => import_google_api_tool_sets.calendarToolSet,
+  docsToolSet: () => import_google_api_tool_sets.docsToolSet,
+  gmailToolSet: () => import_google_api_tool_sets.gmailToolSet,
+  isGoogleApiTool: () => import_google_api_tool.isGoogleApiTool,
+  isGoogleApiToolSet: () => import_google_api_tool_set.isGoogleApiToolSet,
+  sheetsToolSet: () => import_google_api_tool_sets.sheetsToolSet,
+  slidesToolSet: () => import_google_api_tool_sets.slidesToolSet,
+  youtubeToolSet: () => import_google_api_tool_sets.youtubeToolSet
+});
+module.exports = __toCommonJS(google_api_tool_exports);
+var import_google_api_tool = require("./google_api_tool.js");
+var import_google_api_tool_set = require("./google_api_tool_set.js");
+var import_google_api_tool_sets = require("./google_api_tool_sets.js");
+var import_googleapi_to_openapi_converter = require("./googleapi_to_openapi_converter.js");
+/**
+ * @license
+ * Copyright 2026 Google LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  GoogleApiToOpenApiConverter,
+  GoogleApiTool,
+  GoogleApiToolSet,
+  bigqueryToolSet,
+  calendarToolSet,
+  docsToolSet,
+  gmailToolSet,
+  isGoogleApiTool,
+  isGoogleApiToolSet,
+  sheetsToolSet,
+  slidesToolSet,
+  youtubeToolSet
+});