@google/adk 2.3.0 → 2.5.0

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

@@ -6,28 +6,26 @@ const require = topLevelCreateRequire(import.meta.url);
  * SPDX-License-Identifier: Apache-2.0
  */
 import { GoogleApiTool, isGoogleApiTool } from "./google_api_tool.js";
-import { GoogleApiToolSet, isGoogleApiToolSet } from "./google_api_tool_set.js";
+import { GoogleApiToolset, isGoogleApiToolset } from "./google_api_toolset.js";
 import {
-  bigqueryToolSet,
-  calendarToolSet,
-  docsToolSet,
-  gmailToolSet,
-  sheetsToolSet,
-  slidesToolSet,
-  youtubeToolSet
-} from "./google_api_tool_sets.js";
-import { GoogleApiToOpenApiConverter } from "./googleapi_to_openapi_converter.js";
+  BigQueryToolset,
+  CalendarToolset,
+  DocsToolset,
+  GmailToolset,
+  SheetsToolset,
+  SlidesToolset,
+  YoutubeToolset
+} from "./google_api_toolsets.js";
 export {
-  GoogleApiToOpenApiConverter,
+  BigQueryToolset,
+  CalendarToolset,
+  DocsToolset,
+  GmailToolset,
   GoogleApiTool,
-  GoogleApiToolSet,
-  bigqueryToolSet,
-  calendarToolSet,
-  docsToolSet,
-  gmailToolSet,
+  GoogleApiToolset,
+  SheetsToolset,
+  SlidesToolset,
+  YoutubeToolset,
   isGoogleApiTool,
-  isGoogleApiToolSet,
-  sheetsToolSet,
-  slidesToolSet,
-  youtubeToolSet
+  isGoogleApiToolset
 };

package/dist/esm/tools/load_artifacts_tool.js

@@ -9,6 +9,7 @@ var __name = (target, value) => __defProp(target, "name", { value, configurable:
  */
 import { Type } from "@google/genai";
 import { appendInstructions } from "../models/llm_request.js";
+import { base64Decode } from "../utils/env_aware_utils.js";
 import { logger } from "../utils/logger.js";
 import {
   BaseTool
@@ -24,7 +25,7 @@ function normalizeMimeType(mimeType) {
   if (!mimeType) {
     return void 0;
   }
-  return mimeType.split(";")[0].trim();
+  return mimeType.split(";")[0].trim().toLowerCase();
 }
 __name(normalizeMimeType, "normalizeMimeType");
 function isInlineMimeTypeSupported(mimeType) {
@@ -37,31 +38,44 @@ function isInlineMimeTypeSupported(mimeType) {
   ) || GEMINI_SUPPORTED_INLINE_MIME_TYPES.has(normalized);
 }
 __name(isInlineMimeTypeSupported, "isInlineMimeTypeSupported");
-function asSafePartForLlm(artifact, artifactName) {
+function base64ByteLength(data) {
+  const digits = data.replace(/[=\s]/g, "").length;
+  return Math.floor(digits * 3 / 4);
+}
+__name(base64ByteLength, "base64ByteLength");
+function asSafePartForLlm(artifact, artifactName, options) {
+  if ((options == null ? void 0 : options.inlineMediaAsPlaceholder) && !artifact.inlineData && artifact.fileData) {
+    const fileUri = artifact.fileData.fileUri || "unknown";
+    const mimeType2 = normalizeMimeType(artifact.fileData.mimeType) || "application/octet-stream";
+    return {
+      text: `[Artifact: ${artifactName}, uri: ${fileUri}, type: ${mimeType2}.]`
+    };
+  }
   const inlineData = artifact.inlineData;
   if (!inlineData) {
     return artifact;
   }
-  if (isInlineMimeTypeSupported(inlineData.mimeType)) {
+  if (!(options == null ? void 0 : options.inlineMediaAsPlaceholder) && isInlineMimeTypeSupported(inlineData.mimeType)) {
     return artifact;
   }
   const mimeType = normalizeMimeType(inlineData.mimeType) || "application/octet-stream";
+  const isTextLike = mimeType.startsWith("text/") || TEXT_LIKE_MIME_TYPES.has(mimeType);
   const data = inlineData.data;
-  if (!data) {
+  if (data === void 0 || data === null || !isTextLike && data === "") {
     return {
       text: `[Artifact: ${artifactName}, type: ${mimeType}. No inline data was provided.]`
     };
   }
-  const isTextLike = mimeType.startsWith("text/") || TEXT_LIKE_MIME_TYPES.has(mimeType);
-  const decodedBuffer = Buffer.from(data, "base64");
   if (isTextLike) {
+    if (data === "") {
+      return { text: "" };
+    }
     try {
-      const decoded = decodedBuffer.toString("utf8");
-      return { text: decoded };
+      return { text: base64Decode(data.replace(/-/g, "+").replace(/_/g, "/")) };
     } catch {
     }
   }
-  const sizeKb = decodedBuffer.length / 1024;
+  const sizeKb = base64ByteLength(data) / 1024;
   return {
     text: `[Binary artifact: ${artifactName}, type: ${mimeType}, size: ${sizeKb.toFixed(1)} KB. Content cannot be displayed inline.]`
   };
@@ -188,5 +202,6 @@ let LoadArtifactsTool = _LoadArtifactsTool;
 const LOAD_ARTIFACTS = new LoadArtifactsTool();
 export {
   LOAD_ARTIFACTS,
-  LoadArtifactsTool
+  LoadArtifactsTool,
+  asSafePartForLlm
 };

package/dist/esm/tools/load_memory_tool.js

@@ -13,11 +13,13 @@ import {
   BaseTool
 } from "./base_tool.js";
 const _LoadMemoryTool = class _LoadMemoryTool extends BaseTool {
-  constructor() {
+  constructor(options = {}) {
+    var _a;
     super({
       name: "load_memory",
-      description: "Loads the memory for the current user.\n\nNOTE: Currently this tool only uses text part from the memory."
+      description: "Loads the memory for the current user."
     });
+    this.textOnlyContent = (_a = options.textOnlyContent) != null ? _a : false;
   }
   _getDeclaration() {
     return {
@@ -35,16 +37,13 @@ const _LoadMemoryTool = class _LoadMemoryTool extends BaseTool {
       }
     };
   }
-  async runAsync({
-    args,
-    toolContext
-  }) {
-    try {
-      const query = args["query"];
-      if (!toolContext.invocationContext.memoryService) {
-        throw new Error("Memory service is not initialized.");
-      }
-      const searchMemoryResponse = await toolContext.searchMemory(query);
+  async runAsync({ args, toolContext }) {
+    const query = args["query"];
+    if (!toolContext.invocationContext.memoryService) {
+      throw new Error("Memory service is not initialized.");
+    }
+    const searchMemoryResponse = await toolContext.searchMemory(query);
+    if (this.textOnlyContent) {
       return {
         memories: searchMemoryResponse.memories.map((m) => {
           var _a, _b;
@@ -59,10 +58,10 @@ const _LoadMemoryTool = class _LoadMemoryTool extends BaseTool {
           };
         })
       };
-    } catch (e) {
-      console.error("ERROR in LoadMemoryTool runAsync:", e);
-      throw e;
     }
+    return {
+      memories: searchMemoryResponse.memories
+    };
   }
   async processLlmRequest(request) {
     await super.processLlmRequest(request);

package/dist/esm/tools/mcp/mcp_session_manager.js

@@ -28,6 +28,7 @@ var __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__ge
  * Copyright 2025 Google LLC
  * SPDX-License-Identifier: Apache-2.0
  */
+import { instrumentMcpFetch } from "../../telemetry/api/instrumentation.js";
 import { mergeTrackingHeaders } from "../../utils/client_labels.js";
 import { formatError } from "../../utils/error_utils.js";
 import { logger } from "../../utils/logger.js";
@@ -48,7 +49,8 @@ function buildTransportOptions(params) {
     requestInit: {
       ...transportOptions == null ? void 0 : transportOptions.requestInit,
       headers: mergeTrackingHeaders(callerHeaders)
-    }
+    },
+    fetch: instrumentMcpFetch(transportOptions == null ? void 0 : transportOptions.fetch)
   };
 }
 __name(buildTransportOptions, "buildTransportOptions");
@@ -60,7 +62,8 @@ function buildSseTransportOptions(params) {
     requestInit: {
       ...transportOptions == null ? void 0 : transportOptions.requestInit,
       headers: mergeTrackingHeaders(callerHeaders)
-    }
+    },
+    fetch: instrumentMcpFetch(transportOptions == null ? void 0 : transportOptions.fetch)
   };
 }
 __name(buildSseTransportOptions, "buildSseTransportOptions");
@@ -69,6 +72,23 @@ const _MCPSessionManager = class _MCPSessionManager {
     this.activeSessions = /* @__PURE__ */ new Set();
     this.connectionParams = connectionParams;
   }
+  /**
+   * Builds per-request options for MCP client operations.
+   *
+   * For a stdio connection with a configured `timeout`, the timeout is
+   * converted from seconds to milliseconds. Otherwise the MCP SDK applies its
+   * own default request timeout.
+   *
+   * @param signal Optional abort signal to attach to the request.
+   * @return The request options for the MCP SDK client.
+   */
+  getRequestOptions(signal) {
+    const options = signal !== void 0 ? { signal } : {};
+    if (this.connectionParams.type === "StdioConnectionParams" && this.connectionParams.timeout !== void 0) {
+      options.timeout = this.connectionParams.timeout * 1e3;
+    }
+    return options;
+  }
   async createSession() {
     const { Client } = await loadOptionalPeer(
       MCP_SDK,
@@ -86,7 +106,7 @@ const _MCPSessionManager = class _MCPSessionManager {
             this.connectionParams.serverParams
           );
           transport.onerror = logTransportError;
-          await client.connect(transport);
+          await client.connect(transport, this.getRequestOptions());
           break;
         }
         case "StreamableHTTPConnectionParams": {

package/dist/esm/tools/mcp/mcp_tool.js

@@ -31,9 +31,13 @@ const _MCPTool = class _MCPTool extends BaseTool {
     try {
       const callRequest = {};
       callRequest.params = { name: this.originalName, arguments: request.args };
-      const result = await session.callTool(callRequest.params, void 0, {
-        signal: request.toolContext.abortSignal
-      });
+      const result = await session.callTool(
+        callRequest.params,
+        void 0,
+        this.mcpSessionManager.getRequestOptions(
+          request.toolContext.abortSignal
+        )
+      );
       return result;
     } finally {
       await this.mcpSessionManager.closeSession(session);

package/dist/esm/tools/mcp/mcp_toolset.js

@@ -20,7 +20,10 @@ const _MCPToolset = class _MCPToolset extends BaseToolset {
     const session = await this.mcpSessionManager.createSession();
     let listResult;
     try {
-      listResult = await session.listTools();
+      listResult = await session.listTools(
+        void 0,
+        this.mcpSessionManager.getRequestOptions()
+      );
     } finally {
       await this.mcpSessionManager.closeSession(session);
     }
@@ -35,20 +38,7 @@ const _MCPToolset = class _MCPToolset extends BaseToolset {
       };
       return new MCPTool(toolWithPrefix, this.mcpSessionManager, tool.name);
     });
-    const filter = this.toolFilter;
-    if (!filter || Array.isArray(filter) && filter.length === 0) {
-      return tools;
-    }
-    if (Array.isArray(filter)) {
-      return tools.filter((tool) => filter.includes(tool.name));
-    }
-    if (context) {
-      return tools.filter((tool) => filter(tool, context));
-    }
-    logger.warn(
-      "MCPToolset: a ToolPredicate toolFilter was provided but getTools() was called without a ReadonlyContext. The filter will not be applied."
-    );
-    return tools;
+    return tools.filter((tool) => this.isToolSelected(tool, context));
   }
   /**
    * Lists the names of the resources advertised by the MCP server.
@@ -58,7 +48,10 @@ const _MCPToolset = class _MCPToolset extends BaseToolset {
   async listResources() {
     const session = await this.mcpSessionManager.createSession();
     try {
-      const result = await session.listResources();
+      const result = await session.listResources(
+        void 0,
+        this.mcpSessionManager.getRequestOptions()
+      );
       return result.resources.map((resource) => resource.name);
     } finally {
       await this.mcpSessionManager.closeSession(session);
@@ -75,7 +68,10 @@ const _MCPToolset = class _MCPToolset extends BaseToolset {
     const session = await this.mcpSessionManager.createSession();
     let result;
     try {
-      result = await session.listResources();
+      result = await session.listResources(
+        void 0,
+        this.mcpSessionManager.getRequestOptions()
+      );
     } finally {
       await this.mcpSessionManager.closeSession(session);
     }
@@ -105,9 +101,12 @@ const _MCPToolset = class _MCPToolset extends BaseToolset {
     }
     const session = await this.mcpSessionManager.createSession();
     try {
-      const result = await session.readResource({
-        uri: resourceInfo.uri
-      });
+      const result = await session.readResource(
+        {
+          uri: resourceInfo.uri
+        },
+        this.mcpSessionManager.getRequestOptions()
+      );
       return result.contents;
     } finally {
       await this.mcpSessionManager.closeSession(session);

package/dist/esm/tools/openapi_tool/auth/auth_helpers.js

@@ -12,6 +12,7 @@ import {
   AuthCredentialTypes
 } from "../../../auth/auth_credential.js";
 import { camelCaseKeys } from "../../../utils/case_utils.js";
+import { formatError } from "../../../utils/error_utils.js";
 const INTERNAL_AUTH_PREFIX = "_auth_prefix_vaf_";
 const API_KEY_LOCATIONS = ["header", "query", "cookie"];
 const OPENID_FETCH_TIMEOUT_MS = 1e4;
@@ -165,7 +166,7 @@ function tokenToSchemeCredential(tokenType, location, name, credentialValue) {
   throw new Error(`Invalid security scheme type: ${tokenType}`);
 }
 __name(tokenToSchemeCredential, "tokenToSchemeCredential");
-function serviceAccountDictToSchemeCredential(config, scopes) {
+function serviceAccountRecordToSchemeCredential(config, scopes) {
   const authCredential = {
     authType: AuthCredentialTypes.SERVICE_ACCOUNT,
     serviceAccount: {
@@ -179,7 +180,7 @@ function serviceAccountDictToSchemeCredential(config, scopes) {
   };
   return [bearerJwtScheme(), authCredential];
 }
-__name(serviceAccountDictToSchemeCredential, "serviceAccountDictToSchemeCredential");
+__name(serviceAccountRecordToSchemeCredential, "serviceAccountRecordToSchemeCredential");
 function serviceAccountSchemeCredential(config) {
   const authCredential = {
     authType: AuthCredentialTypes.SERVICE_ACCOUNT,
@@ -188,9 +189,9 @@ function serviceAccountSchemeCredential(config) {
   return [bearerJwtScheme(), authCredential];
 }
 __name(serviceAccountSchemeCredential, "serviceAccountSchemeCredential");
-function openidDictToSchemeCredential(configDict, scopes, credentialDict) {
+function openidRecordToSchemeCredential(configRecord, scopes, credentialRecord) {
   const parsedConfig = OpenIdConnectConfigSchema.safeParse(
-    camelCaseKeys(configDict)
+    camelCaseKeys(configRecord)
   );
   if (!parsedConfig.success) {
     throw new Error(
@@ -198,33 +199,33 @@ function openidDictToSchemeCredential(configDict, scopes, credentialDict) {
     );
   }
   const openidScheme = { ...parsedConfig.data, scopes };
-  const values = Object.values(credentialDict);
+  const values = Object.values(credentialRecord);
   if (values.length === 1) {
     const wrapped = JsonObjectSchema.safeParse(values[0]);
     if (wrapped.success && "client_id" in wrapped.data && "client_secret" in wrapped.data) {
-      credentialDict = wrapped.data;
+      credentialRecord = wrapped.data;
     }
   }
   const missingFields = REQUIRED_CREDENTIAL_FIELDS.filter(
-    (field) => !(field in credentialDict)
+    (field) => !(field in credentialRecord)
   );
   if (missingFields.length > 0) {
     throw new Error(
-      `Missing required fields in credential_dict: ${missingFields.join(", ")}`
+      `Missing required fields in credentialRecord: ${missingFields.join(", ")}`
     );
   }
   const authCredential = {
     authType: AuthCredentialTypes.OPEN_ID_CONNECT,
     oauth2: {
-      clientId: String(credentialDict["client_id"]),
-      clientSecret: String(credentialDict["client_secret"]),
-      redirectUri: "redirect_uri" in credentialDict ? String(credentialDict["redirect_uri"]) : void 0
+      clientId: String(credentialRecord["client_id"]),
+      clientSecret: String(credentialRecord["client_secret"]),
+      redirectUri: "redirect_uri" in credentialRecord ? String(credentialRecord["redirect_uri"]) : void 0
     }
   };
   return [openidScheme, authCredential];
 }
-__name(openidDictToSchemeCredential, "openidDictToSchemeCredential");
-async function openidUrlToSchemeCredential(openidUrl, scopes, credentialDict) {
+__name(openidRecordToSchemeCredential, "openidRecordToSchemeCredential");
+async function openidUrlToSchemeCredential(openidUrl, scopes, credentialRecord) {
   let response;
   try {
     response = await fetch(openidUrl, {
@@ -235,21 +236,21 @@ async function openidUrlToSchemeCredential(openidUrl, scopes, credentialDict) {
     }
   } catch (e) {
     throw new Error(
-      `Failed to fetch OpenID configuration from ${openidUrl}: ${String(e)}`
+      `Failed to fetch OpenID configuration from ${openidUrl}: ${formatError(e)}`
     );
   }
-  let configDict;
+  let configRecord;
   try {
-    configDict = JsonObjectSchema.parse(await response.json());
+    configRecord = JsonObjectSchema.parse(await response.json());
   } catch (e) {
     throw new Error(
-      `Invalid JSON response from OpenID configuration endpoint ${openidUrl}: ${String(e)}`
+      `Invalid JSON response from OpenID configuration endpoint ${openidUrl}: ${formatError(e)}`
     );
   }
-  return openidDictToSchemeCredential(
-    { ...configDict, openIdConnectUrl: openidUrl },
+  return openidRecordToSchemeCredential(
+    { ...configRecord, openIdConnectUrl: openidUrl },
     scopes,
-    credentialDict
+    credentialRecord
   );
 }
 __name(openidUrlToSchemeCredential, "openidUrlToSchemeCredential");
@@ -300,9 +301,9 @@ function parseSecurityScheme(schema, data) {
   return result.data;
 }
 __name(parseSecurityScheme, "parseSecurityScheme");
-function dictToAuthScheme(data) {
+function recordToAuthScheme(data) {
   if (!("type" in data)) {
-    throw new Error("Missing 'type' field in security scheme dictionary.");
+    throw new Error("Missing 'type' field in security scheme object.");
   }
   const securityType = data["type"];
   switch (securityType) {
@@ -318,17 +319,17 @@ function dictToAuthScheme(data) {
       throw new Error(`Invalid security scheme type: ${securityType}`);
   }
 }
-__name(dictToAuthScheme, "dictToAuthScheme");
+__name(recordToAuthScheme, "recordToAuthScheme");
 export {
   INTERNAL_AUTH_PREFIX,
   applyCredential,
   createApiKeyScheme,
   createBearerScheme,
   credentialToParam,
-  dictToAuthScheme,
-  openidDictToSchemeCredential,
+  openidRecordToSchemeCredential,
   openidUrlToSchemeCredential,
-  serviceAccountDictToSchemeCredential,
+  recordToAuthScheme,
+  serviceAccountRecordToSchemeCredential,
   serviceAccountSchemeCredential,
   tokenToSchemeCredential
 };

package/dist/esm/tools/openapi_tool/auth/credential_exchangers/oauth2_exchanger.js

@@ -24,7 +24,7 @@ import { experimental } from "../../../../utils/experimental.js";
 function checkSchemeCredentialType(authScheme, authCredential) {
   if (!authCredential) {
     throw new Error(
-      "auth_credential is empty. Please create AuthCredential using OAuth2Auth."
+      "authCredential is empty. Please create AuthCredential using OAuth2Auth."
     );
   }
   if (authScheme.type !== AuthSchemeType.OPEN_ID_CONNECT && authScheme.type !== AuthSchemeType.OAUTH2) {
@@ -34,7 +34,7 @@ function checkSchemeCredentialType(authScheme, authCredential) {
   }
   if (!authCredential.oauth2 && !authCredential.http) {
     throw new Error(
-      "auth_credential is not configured with oauth2. Please create AuthCredential and set OAuth2Auth."
+      "authCredential is not configured with oauth2. Please create AuthCredential and set OAuth2Auth."
     );
   }
 }
@@ -55,12 +55,12 @@ function generateAuthToken(authCredential) {
 }
 __name(generateAuthToken, "generateAuthToken");
 function exchangeCredential(authScheme, authCredential) {
-  var _a, _b;
+  var _a;
   checkSchemeCredentialType(authScheme, authCredential);
   if (authCredential.http) {
     return authCredential;
   }
-  if (((_a = authCredential.oauth2) == null ? void 0 : _a.accessToken) || ((_b = authCredential.oauth2) == null ? void 0 : _b.refreshToken)) {
+  if ((_a = authCredential.oauth2) == null ? void 0 : _a.accessToken) {
     return generateAuthToken(authCredential);
   }
   return null;

package/dist/esm/tools/openapi_tool/openapi_spec_parser/openapi_spec_parser.js

@@ -29,15 +29,27 @@ const VALID_SCHEMA_TYPES = /* @__PURE__ */ new Set([
   "string"
 ]);
 let OpenApiSpecParser = class {
+  /**
+   * @param options.preservePropertyNames Keeps the original parameter and
+   *     function names instead of converting them to snake_case.
+   * @param options.unconstrainedObjectBodyAsParameter Emits a whole-body
+   *     parameter named `body` when an object request body schema has no
+   *     properties. Defaults to `false`.
+   *     @deprecated Retained for backwards compatibility; empty object schemas
+   *     produce no parameters by default. This option will be removed in a
+   *     future release.
+   */
   constructor(options = {}) {
-    var _a;
+    var _a, _b;
     this.preservePropertyNames = (_a = options.preservePropertyNames) != null ? _a : false;
+    this.unconstrainedObjectBodyAsParameter = (_b = options.unconstrainedObjectBodyAsParameter) != null ? _b : false;
   }
   parse(openapiSpec) {
     const resolvedSpec = resolveReferences(openapiSpec);
     const sanitizedSpec = sanitizeSchemaTypes(resolvedSpec);
     return collectOperations(sanitizedSpec, {
-      preservePropertyNames: this.preservePropertyNames
+      preservePropertyNames: this.preservePropertyNames,
+      unconstrainedObjectBodyAsParameter: this.unconstrainedObjectBodyAsParameter
     });
   }
 };
@@ -172,17 +184,18 @@ function resolveServerUrl(server) {
 }
 __name(resolveServerUrl, "resolveServerUrl");
 function collectOperations(spec, options = {}) {
-  var _a, _b, _c;
+  var _a, _b, _c, _d;
   const preservePropertyNames = (_a = options.preservePropertyNames) != null ? _a : false;
+  const unconstrainedObjectBodyAsParameter = (_b = options.unconstrainedObjectBodyAsParameter) != null ? _b : false;
   const operations = [];
-  const server = (_b = spec.servers) == null ? void 0 : _b[0];
+  const server = (_c = spec.servers) == null ? void 0 : _c[0];
   const baseUrl = server ? resolveServerUrl(server) : "";
   const globalSecurity = spec.security || [];
   let globalSchemeName;
   if (globalSecurity.length > 0) {
     globalSchemeName = Object.keys(globalSecurity[0])[0];
   }
-  const authSchemes = ((_c = spec.components) == null ? void 0 : _c.securitySchemes) || {};
+  const authSchemes = ((_d = spec.components) == null ? void 0 : _d.securitySchemes) || {};
   for (const [path, pathItem] of Object.entries(spec.paths || {})) {
     if (!pathItem) continue;
     const methods = [
@@ -205,7 +218,8 @@ function collectOperations(spec, options = {}) {
         operation.operationId = toSnakeCaseName(`${path}_${method}`);
       }
       const parser = new OperationParser(operation, {
-        preservePropertyNames
+        preservePropertyNames,
+        unconstrainedObjectBodyAsParameter
       });
       let authSchemeName;
       if (operation.security && operation.security.length > 0) {

package/dist/esm/tools/openapi_tool/openapi_spec_parser/operation_parser.js

@@ -34,13 +34,20 @@ let OperationParser = class {
    *     function names instead of converting them to snake_case.
    * @param options.shouldParse Whether to parse the operation during
    *     construction. Defaults to `true`.
+   * @param options.unconstrainedObjectBodyAsParameter Emits a whole-body
+   *     parameter named `body` when an object request body schema has no
+   *     properties. Defaults to `false`.
+   *     @deprecated Retained for backwards compatibility; empty object schemas
+   *     produce no parameters by default. This option will be removed in a
+   *     future release.
    */
   constructor(operation, options = {}) {
     this.params = [];
-    var _a, _b;
+    var _a, _b, _c;
     this.operation = typeof operation === "string" ? JSON.parse(operation) : operation;
     this.preservePropertyNames = (_a = options.preservePropertyNames) != null ? _a : false;
-    if ((_b = options.shouldParse) != null ? _b : true) {
+    this.unconstrainedObjectBodyAsParameter = (_b = options.unconstrainedObjectBodyAsParameter) != null ? _b : false;
+    if ((_c = options.shouldParse) != null ? _c : true) {
       this.processOperationParameters();
       this.processRequestBody();
       this.returnValue = this.processReturnValue();
@@ -60,6 +67,7 @@ let OperationParser = class {
     return renameReservedKeywords(toSnakeCaseName(originalName));
   }
   processOperationParameters() {
+    var _a;
     const parameters = this.operation.parameters || [];
     for (const param of parameters) {
       if ("name" in param) {
@@ -70,9 +78,12 @@ let OperationParser = class {
         this.params.push({
           originalName,
           paramLocation: location,
-          paramSchema: schema,
+          paramSchema: {
+            ...schema,
+            description: schema.description || description || void 0
+          },
           description,
-          required: param.required || false,
+          required: (_a = param.required) != null ? _a : false,
           name: this.getParamName(originalName)
         });
       }
@@ -108,7 +119,7 @@ let OperationParser = class {
               });
             }
           }
-        } else {
+        } else if (this.unconstrainedObjectBodyAsParameter) {
           this.params.push({
             originalName: "",
             paramLocation: "body",
@@ -129,7 +140,7 @@ let OperationParser = class {
         });
       } else {
         this.params.push({
-          originalName: "body",
+          originalName: "",
           paramLocation: "body",
           paramSchema: schema,
           description,