@cloudinary/asset-management-mcp 0.8.0 → 0.9.0-rc.0

package/src/models/uploadrequest.ts

@@ -1,5 +1,6 @@
 /*
  * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+ * @generated-id: 2c1149457ac9
  */
 
 import * as z from "zod";
@@ -16,7 +17,9 @@ export type AutoTranscription = { translate?: Array<string> | undefined };
 
 export const AutoTranscription$zodSchema: z.ZodType<AutoTranscription> = z
   .object({
-    translate: z.array(z.string()).optional(),
+    translate: z.array(z.string()).optional().describe(
+      "Array of target language codes for transcription translation.",
+    ),
   }).describe(
     "Configuration object for automatic video transcription with translation options.",
   );
@@ -166,69 +169,185 @@ export type UploadRequest = {
 };
 
 export const UploadRequest$zodSchema: z.ZodType<UploadRequest> = z.object({
-  access_control: z.array(AccessControlItem$zodSchema).optional(),
-  access_mode: UploadRequestAccessMode$zodSchema.optional(),
-  accessibility_analysis: z.boolean().optional(),
-  allowed_formats: z.string().optional(),
-  api_key: z.string().optional(),
-  asset_folder: z.string().optional(),
-  async: z.boolean().optional(),
-  auto_chaptering: z.boolean().optional(),
-  auto_tagging: z.number().optional(),
+  access_control: z.array(AccessControlItem$zodSchema).optional().describe(
+    "Restricts access to the asset by specifying one or more access types.\nThe asset is restricted unless at least one listed access type is valid.\n",
+  ),
+  access_mode: UploadRequestAccessMode$zodSchema.optional().describe(
+    "Allows the asset to behave as if it's of the authenticated 'type' (see above) while still using the default 'upload' type in delivery URLs. The asset can later be made public by changing its access_mode via the Admin API, without having to update any delivery URLs. Valid values: public, and authenticated.\n",
+  ),
+  accessibility_analysis: z.boolean().optional().describe(
+    "Whether to return return accessibility analysis values for the image.",
+  ),
+  allowed_formats: z.string().optional().describe(
+    "A comma-separated list of file formats that are allowed for uploading. Files of other types will be rejected. The formats can be any combination of image types, video formats or raw file extensions.\nNote: You can also add the `format` parameter to convert other file types instead of rejecting them. In this case, only files that would normally be rejected are converted, any file format allowed for upload wont be converted.\n",
+  ),
+  api_key: z.string().optional().describe(
+    "The API key to use for the request. This is automatically computed by the Cloudinary's SDKs.",
+  ),
+  asset_folder: z.string().optional().describe(
+    "The asset folder to assign to the asset.",
+  ),
+  async: z.boolean().optional().describe(
+    "When set to true, returns the uploaded asset's public_id immediately in the response, before the upload is completed (asynchronously). Default: false.\n",
+  ),
+  auto_chaptering: z.boolean().optional().describe(
+    "Whether to trigger automatic generation of video chapters. Chapters will be generated and saved as a .vtt file with -chapters appended to the public ID of the video. You can enable chapters as part of the Cloudinary Video Player. Relevant for videos only.",
+  ),
+  auto_tagging: z.number().optional().describe(
+    "Automatically assigns tags to an asset according to detected objects or categories with a confidence score higher than the specified value.\nUse together with the detection parameter for:\n- Cloudinary AI Content Analysis\n- Amazon Rekognition Celebrity Detection\nUse together with the categorization parameter for:\n- Google Automatic Video Tagging\n- Google Auto Tagging\n- Imagga Auto Tagging\n- Amazon Rekognition Auto Tagging\n",
+  ),
   auto_transcription: z.union([
     z.boolean(),
     z.lazy(() => AutoTranscription$zodSchema),
   ]).optional(),
-  background_removal: z.string().optional(),
-  backup: z.boolean().optional(),
-  callback: z.string().optional(),
-  categorization: z.string().optional(),
-  cinemagraph_analysis: z.boolean().optional(),
-  colors: z.boolean().default(false),
-  context: z.string().optional(),
-  custom_coordinates: z.string().optional(),
-  detection: z.string().optional(),
-  discard_original_filename: z.boolean().optional(),
-  display_name: z.string().optional(),
-  eager: z.string().optional(),
-  eager_async: z.boolean().optional(),
-  eager_notification_url: z.string().optional(),
-  eval: z.string().optional(),
-  face_coordinates: z.string().optional(),
-  faces: z.boolean().optional(),
-  file: z.string(),
-  filename_override: z.string().optional(),
-  folder: z.string().optional(),
-  format: z.string().optional(),
-  headers: z.string().optional(),
-  invalidate: z.boolean().optional(),
-  media_metadata: z.boolean().optional(),
-  metadata: z.string().optional(),
-  moderation: z.string().optional(),
-  notification_url: z.string().optional(),
-  ocr: z.string().optional(),
-  on_success: z.string().optional(),
-  overwrite: z.boolean().optional(),
-  phash: z.boolean().optional(),
-  proxy: z.string().optional(),
-  public_id: z.string().optional(),
-  public_id_prefix: z.string().optional(),
-  quality_analysis: z.boolean().optional(),
-  raw_convert: z.string().optional(),
-  regions: z.string().optional(),
+  background_removal: z.string().optional().describe(
+    "Automatically remove the background of an image using an add-on.\n- Set to cloudinary_ai to use the deep-learning based Cloudinary AI Background Removal add-on.\n  Optionally append a template suffix (e.g., cloudinary_ai:fine_edges).\n- Note: this feature has been superseded by background removal on the fly.\n- Set to pixelz to use the human-powered Pixelz Remove-The-Background Editing add-on service.\nRelevant for images only.\n",
+  ),
+  backup: z.boolean().optional().describe(
+    "Whether to backup the uploaded asset. When set to true, backs up uploaded assets to a secondary storage bucket.",
+  ),
+  callback: z.string().optional().describe(
+    "A URL to redirect to after the upload/explicit is completed instead of returning the upload response.\nSigned upload result parameters are added to the callback URL. This parameter is ignored for XHR (Ajax XMLHttpRequest) or JavaScript Fetch API upload requests.\nNote: This parameter is relevant for direct uploads from a form in the browser. It is automatically set if you perform direct upload from the browser using Cloudinary's SDKs and the jQuery plugin.\n",
+  ),
+  categorization: z.string().optional().describe(
+    "A comma-separated list of the categorization add-ons to run on the asset.\nSet to google_tagging, google_video_tagging, imagga_tagging and/or aws_rek_tagging\nto automatically classify the scenes of the uploaded asset.\nOptionally append a language code suffix (e.g., google_tagging:fr).\n",
+  ),
+  cinemagraph_analysis: z.boolean().optional().describe(
+    "Whether to return a cinemagraph analysis value for the media asset between 0 and 1, where 0 means the asset is not a cinemagraph and 1 means the asset is a cinemagraph. Relevant for animated images and video only. A static image will return 0.",
+  ),
+  colors: z.boolean().default(false).describe(
+    "Whether to retrieve predominant colors & color histogram of the uploaded image. Note: If all returned colors are opaque, then 6-digit RGB hex values are returned. If one or more colors contain an alpha channel, then 8-digit RGBA hex quadruplet values are returned.",
+  ),
+  context: z.string().optional().describe(
+    "Key-value pairs of general textual context metadata to attach to the asset.",
+  ),
+  custom_coordinates: z.string().optional().describe(
+    "An array of coordinates for custom cropping.",
+  ),
+  detection: z.string().optional().describe(
+    "Invokes the relevant add-on to return a list of detected content.\nSet to:\n- <content-aware model>_[<version>] (e.g. coco_v2) to return a list of detected content using the Cloudinary AI Content Analysis add-on. Can be used together with the auto_tagging parameter to apply tags automatically.\n- captioning to analyze an image and suggest a caption based on the image's contents.\n- iqa to analyze the quality of an image.\n- watermark-detection to detect watermarks in an image.\n- adv_face to return a list of facial attributes using the Advanced Facial Attribute Detection add-on.\n- aws_rek_face to return a list of detected celebrities and facial attributes using the Amazon Rekognition Celebrity Detection add-on. Can be used together with the auto_tagging parameter to apply tags automatically.\n",
+  ),
+  discard_original_filename: z.boolean().optional().describe(
+    "Whether to discard the name of the original uploaded file. Relevant when delivering assets as attachments (setting the flag disposition:attachment in delivery URLs).",
+  ),
+  display_name: z.string().optional().describe("A display name for the asset."),
+  eager: z.string().optional().describe(
+    "A list of transformations to eagerly generate for the asset. Accepts either a single transformation or a pipe-separated list of transformations.",
+  ),
+  eager_async: z.boolean().optional().describe(
+    "Whether to generate the eager transformations asynchronously in the background after the upload request is completed rather than before the upload is completed.",
+  ),
+  eager_notification_url: z.string().optional().describe(
+    "A URL to notify when eager transformations are completed.",
+  ),
+  eval: z.string().optional().describe(
+    "Allows you to modify upload parameters by specifying custom logic with JavaScript. This can be useful for conditionally adding tags, contextual metadata, structured metadata or eager transformations depending on specific criteria of the uploaded file.",
+  ),
+  face_coordinates: z.string().optional().describe(
+    "An array of coordinates representing detected faces in the asset, used for custom cropping or overlays.",
+  ),
+  faces: z.boolean().optional().describe(
+    "Whether to detect faces in the asset.",
+  ),
+  file: z.string().describe(
+    "One of the following:\n- The remote HTTP or HTTPS URL address of an existing file.\n- The Data URI (Base64 encoded), max ~60 MB (62,910,000 chars).\n- The FTP address of an existing file.\n- Local file path starting with file://.\n",
+  ),
+  filename_override: z.string().optional().describe(
+    "Overrides the originally uploaded asset's file name in downloads that use flags like fl_attachment or fl_force_original.",
+  ),
+  folder: z.string().optional().describe(
+    "Folder name where the uploaded asset will be stored. This parameter applies when using the Admin API, or when specifying the upload preset for unsigned uploading with the Upload API.",
+  ),
+  format: z.string().optional().describe(
+    "An optional format to convert the uploaded asset to before saving in the cloud.",
+  ),
+  headers: z.string().optional().describe(
+    "An HTTP header or a list of headers lines for adding as response HTTP headers when delivering the asset to your users. Supported headers: Link, Authorization, X-Robots-Tag.\n",
+  ),
+  invalidate: z.boolean().optional().describe(
+    "Whether to invalidate CDN cache copies of a previously uploaded asset that shares the same public ID. Default: false.\n",
+  ),
+  media_metadata: z.boolean().optional().describe(
+    "Whether to return IPTC, XMP, and detailed Exif metadata of the uploaded asset in the response.\nSupported for images, video, and audio.\n- Returned metadata for images includes: PixelsPerUnitX, PixelsPerUnitY, PixelUnits, Colorspace, and DPI.\n- Returned metadata for audio and video includes: audio_codec, audio_bit_rate, audio_frequency, channels, channel_layout.\n- Additional metadata for video includes: pix_format, codec, level, profile, video_bit_rate, dar.\n",
+  ),
+  metadata: z.string().optional().describe(
+    "Structured metadata to attach to the asset based on the metadata fields defined for your account.",
+  ),
+  moderation: z.string().optional().describe(
+    "For all asset types, set to:\n- manual to add the uploaded asset to a list of pending assets that can be moderated using the Admin API or the Cloudinary Console.\n- perception_point to automatically moderate the uploaded asset using the Perception Point Malware Detection add-on.\n\nFor images only, set to:\n- webpurify to automatically moderate the uploaded image using the WebPurify Image Moderation add-on.\n- aws_rek to automatically moderate the uploaded image using the Amazon Rekognition AI Moderation add-on.\n- duplicate:<threshold> to detect if the same or a similar image already exists using the Cloudinary Duplicate Image Detection add-on. Set threshold to a float greater than 0 and less than or equal to 1.0 to specify how similar an image needs to be in order to be considered a duplicate. Set threshold to 0 to add an image to the index of images that are searched when duplicate detection is invoked for another image.\n\nFor videos only, set to:\n- aws_rek_video to automatically moderate the uploaded video using the Amazon Rekognition Video Moderation add-on.\n- google_video_moderation automatically moderate the uploaded video using the Google AI Video Moderation add-on.\n\nTo request multiple moderations in a single API call:\n- Send the desired list of moderations as a pipe-separated string with manual moderation, if relevant, being last.\n\nNote: Rejected assets are automatically invalidated on the CDN within approximately ten minutes.\n",
+  ),
+  notification_url: z.string().optional().describe(
+    "A URL to notify when the asset is ready.",
+  ),
+  ocr: z.string().optional().describe(
+    "Set to adv_ocr to extract all text elements in an image as well as the bounding box\ncoordinates of each detected element using the OCR text detection and extraction add-on.\nOptionally append options (e.g., adv_ocr:document).\n",
+  ),
+  on_success: z.string().optional().describe(
+    "Allows you to update an asset by specifying custom logic with JavaScript that is executed after the upload to Cloudinary is completed successfully. This can be useful for conditionally adding tags, contextual metadata, and structured metadata, depending on the results of using the detection parameter on upload.",
+  ),
+  overwrite: z.boolean().optional().describe(
+    "Whether to overwrite existing assets with the same public ID. When set to false, return immediately if an asset with the same public ID already exists. Default: true (when using unsigned upload, the default is false and cannot be changed to true).\n",
+  ),
+  phash: z.boolean().optional().describe(
+    "Whether to return the perceptual hash (pHash) on the uploaded image for image similarity detection.\n",
+  ),
+  proxy: z.string().optional().describe(
+    "A proxy to use for fetching remote URLs. The format should be http://hostname:port.",
+  ),
+  public_id: z.string().optional().describe(
+    "The identifier that is used for accessing the uploaded asset. If not specified, a unique ID is generated automatically.",
+  ),
+  public_id_prefix: z.string().optional().describe(
+    "A string or path that's automatically prepended to the public_id with a forward slash. The value can contain the same characters as the public_id including additional forward slashes. This prefix can be useful to provide context and improve the SEO of an asset's filename in the delivery URL, but the value does not impact the location where the asset is stored.",
+  ),
+  quality_analysis: z.boolean().optional().describe(
+    "Whether to return a quality analysis value for the image between 0 and 1, where 0 means the image is blurry and out of focus and 1 means the image is sharp and in focus. Relevant for images only.",
+  ),
+  raw_convert: z.string().optional().describe(
+    "Generates a related file based on the uploaded file.\n- Set to aspose to automatically create a PDF or other image format from a raw Office document using the Aspose Document Conversion add-on. (Asynchronous)\n- Set to google_speech to instruct the Google AI Video Transcription add-on to generate an automatic transcript raw file from an uploaded video. (Asynchronous)\n- Set to extract_text to extract all the text from a PDF file and store it in a raw JSON file with a public ID in the format: [pdf_public_id].extract_text.json. The full URL of the generated JSON file is included in the API response. Unlike the above raw_convert options, this option doesn't require registering for an add-on.(Synchronous)\n- Set to azure_video_indexer to generate AI-powered video insights from Microsoft Azure. (Asynchronous)\n",
+  ),
+  regions: z.string().optional().describe("Regions to detect in the asset."),
   responsive_breakpoints: z.array(z.lazy(() => ResponsiveBreakpoint$zodSchema))
-    .optional(),
-  return_delete_token: z.boolean().optional(),
-  signature: z.string().optional(),
-  tags: z.string().optional(),
-  timestamp: z.int().optional(),
-  transformation: z.string().optional(),
-  type: UploadRequestType$zodSchema.optional(),
-  unique_display_name: z.boolean().optional(),
-  unique_filename: z.boolean().optional(),
-  upload_preset: z.string().optional(),
-  use_asset_folder_as_public_id_prefix: z.boolean().optional(),
-  use_filename: z.boolean().optional(),
-  use_filename_as_display_name: z.boolean().optional(),
-  visual_search: z.boolean().optional(),
+    .optional().describe(
+      "Settings to automatically generate breakpoints for responsive images.",
+    ),
+  return_delete_token: z.boolean().optional().describe(
+    "Whether to return a deletion token in the upload response. The token can be used to delete the uploaded asset within approximately 10 minutes using an unauthenticated API call.",
+  ),
+  signature: z.string().optional().describe(
+    "(Required for signed REST API calls) Used to authenticate the request and based on the parameters you use in the request. When using the Cloudinary SDKs for signed requests, the signature is automatically generated and added to the request. If you manually generate your own signed POST request, you need to manually generate the signature parameter and add it to the request together with the api_key and timestamp parameters.\n",
+  ),
+  tags: z.string().optional().describe(
+    "A comma-separated list of tag names to assign to the asset.",
+  ),
+  timestamp: z.int().optional().describe(
+    "The timestamp to use for the request in unix time. This is automatically computed by the Cloudinary's SDKs.",
+  ),
+  transformation: z.string().optional().describe(
+    "An incoming transformation to run on the uploaded asset before its storage. In contrast to eager, this parameter is applied before the file is stored.",
+  ),
+  type: UploadRequestType$zodSchema.optional().describe(
+    "The delivery type that defines if and how the uploaded asset is available for public delivery. By default, all uploaded assets are public (upload). Possible values are upload, authenticated, private or asset.",
+  ),
+  unique_display_name: z.boolean().optional().describe(
+    "Whether the display name should be unique.",
+  ),
+  unique_filename: z.boolean().optional().describe(
+    "When set to false and used together with use_filename, if an asset with the same file name already exists, no random characters are appended to the file name. Instead, the asset is overwritten. Default: true (random characters are added to the file name if needed).\n",
+  ),
+  upload_preset: z.string().optional().describe(
+    "(Required for unsigned uploading / optional for signed uploading)\nName of an upload preset that you defined for your Cloudinary product environment. An upload preset consists of upload parameters centrally managed using the Admin API or from the Upload Presets page of the Console Settings. An upload preset may be marked as unsigned, which allows unsigned uploading directly from the browser and restricts the optional parameters to: public_id, folder, tags, context, face_coordinates, regions and custom_coordinates.\n",
+  ),
+  use_asset_folder_as_public_id_prefix: z.boolean().optional().describe(
+    "Whether to add the asset_folder value as a prefix to the public_id value (prepended with a forward slash). This ensures that the public ID path will always match the initial asset folder, and can help to retain the behavior that previously existed in fixed folder mode. However, keep in mind that even when this option is used during upload, an asset with a certain public ID path can later be moved to a completely different asset folder hierarchy without impacting the public ID. This option only ensures path matching for the initial upload. Relevant only when public_id_prefix (or folder) has not been separately specified.",
+  ),
+  use_filename: z.boolean().optional().describe(
+    "Whether to use the original file name of the uploaded asset if available for the public ID. The file name is normalized and random characters are appended to ensure uniqueness if the file name already exists. Default: false.\n",
+  ),
+  use_filename_as_display_name: z.boolean().optional().describe(
+    "Whether to automatically assign the original filename of the uploaded asset as the asset's display name. Relevant only if the display_name parameter isn't set.",
+  ),
+  visual_search: z.boolean().optional().describe(
+    "Whether to index the image for use with visual searches. Relevant for images only.",
+  ),
 });

package/src/models/uploadresourcetype.ts

@@ -1,5 +1,6 @@
 /*
  * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+ * @generated-id: 869417d840c4
  */
 
 import * as z from "zod";

package/src/models/uploadresponse.ts

@@ -1,5 +1,6 @@
 /*
  * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+ * @generated-id: 409a2e038ae1
  */
 
 import * as z from "zod";
@@ -62,30 +63,60 @@ export type UploadResponse = {
 };
 
 export const UploadResponse$zodSchema: z.ZodType<UploadResponse> = z.object({
-  api_key: z.string().optional(),
-  asset_id: z.string().optional(),
-  bytes: z.int().optional(),
-  created_at: z.string().optional(),
+  api_key: z.string().optional().describe(
+    "The API key used to upload the file.",
+  ),
+  asset_id: z.string().optional().describe(
+    "The asset ID of the uploaded file. This is the ID of the uploaded file in the Cloudinary database.",
+  ),
+  bytes: z.int().optional().describe("The size of the uploaded file in bytes."),
+  created_at: z.string().optional().describe(
+    "The date and time the file was uploaded.",
+  ),
   eager: z.array(z.lazy(() => Eager$zodSchema)).optional(),
-  etag: z.string().optional(),
-  format: z.string().optional(),
-  grayscale: z.boolean().optional(),
-  height: z.int().optional(),
-  illustration_score: z.number().optional(),
-  image_metadata: z.lazy(() => UploadResponseImageMetadata$zodSchema)
-    .optional(),
-  original_filename: z.string().optional(),
-  pages: z.int().optional(),
-  placeholder: z.boolean().optional(),
-  public_id: z.string().optional(),
-  resource_type: z.string().optional(),
-  secure_url: z.string().optional(),
-  semi_transparent: z.boolean().optional(),
-  signature: z.string().optional(),
-  tags: z.array(z.string()).optional(),
-  type: z.string().optional(),
-  url: z.string().optional(),
-  version: z.int().optional(),
-  version_id: z.string().optional(),
-  width: z.int().optional(),
+  etag: z.string().optional().describe("The ETag of the uploaded file."),
+  format: z.string().optional().describe("The format of the uploaded file."),
+  grayscale: z.boolean().optional().describe(
+    "Whether the uploaded file is grayscale.",
+  ),
+  height: z.int().optional().describe("The height of the uploaded file."),
+  illustration_score: z.number().optional().describe(
+    "The illustration score of the uploaded file.",
+  ),
+  image_metadata: z.lazy(() => UploadResponseImageMetadata$zodSchema).optional()
+    .describe("The image metadata of the uploaded file."),
+  original_filename: z.string().optional().describe(
+    "The original filename of the uploaded file.",
+  ),
+  pages: z.int().optional().describe(
+    "The number of pages in the uploaded file.",
+  ),
+  placeholder: z.boolean().optional().describe(
+    "Whether the uploaded file is a placeholder.",
+  ),
+  public_id: z.string().optional().describe(
+    "The public ID of the uploaded file.",
+  ),
+  resource_type: z.string().optional().describe(
+    "The type of resource that was uploaded.",
+  ),
+  secure_url: z.string().optional().describe(
+    "The secure URL of the uploaded file.",
+  ),
+  semi_transparent: z.boolean().optional().describe(
+    "Whether the uploaded file is semi-transparent.",
+  ),
+  signature: z.string().optional().describe(
+    "The signature of the uploaded file.",
+  ),
+  tags: z.array(z.string()).optional().describe(
+    "The tags of the uploaded file.",
+  ),
+  type: z.string().optional().describe("The type of the uploaded file."),
+  url: z.string().optional().describe("The URL of the uploaded file."),
+  version: z.int().optional().describe("The version of the uploaded file."),
+  version_id: z.string().optional().describe(
+    "The version ID of the uploaded file.",
+  ),
+  width: z.int().optional().describe("The width of the uploaded file."),
 });

package/src/models/usageresponse.ts

@@ -1,5 +1,6 @@
 /*
  * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+ * @generated-id: f8fa3dab0b79
  */
 
 import * as z from "zod";
@@ -7,7 +8,7 @@ import * as z from "zod";
 export type Transformations = { usage?: number | undefined };
 
 export const Transformations$zodSchema: z.ZodType<Transformations> = z.object({
-  usage: z.int().optional(),
+  usage: z.int().optional().describe("Number of transformations used"),
 });
 
 export type Objects = {
@@ -17,9 +18,11 @@ export type Objects = {
 };
 
 export const Objects$zodSchema: z.ZodType<Objects> = z.object({
-  limit: z.int().optional(),
-  usage: z.int().optional(),
-  used_percent: z.number().optional(),
+  limit: z.int().optional().describe("Object limit for the plan"),
+  usage: z.int().optional().describe("Number of objects used"),
+  used_percent: z.number().optional().describe(
+    "Percentage of object limit used",
+  ),
 });
 
 export type Bandwidth = {
@@ -29,9 +32,11 @@ export type Bandwidth = {
 };
 
 export const Bandwidth$zodSchema: z.ZodType<Bandwidth> = z.object({
-  limit: z.int().optional(),
-  usage: z.int().optional(),
-  used_percent: z.number().optional(),
+  limit: z.int().optional().describe("Bandwidth limit for the plan"),
+  usage: z.int().optional().describe("Bandwidth used in bytes"),
+  used_percent: z.number().optional().describe(
+    "Percentage of bandwidth limit used",
+  ),
 });
 
 export type Storage = {
@@ -41,22 +46,24 @@ export type Storage = {
 };
 
 export const Storage$zodSchema: z.ZodType<Storage> = z.object({
-  limit: z.int().optional(),
-  usage: z.int().optional(),
-  used_percent: z.number().optional(),
+  limit: z.int().optional().describe("Storage limit for the plan"),
+  usage: z.int().optional().describe("Storage used in bytes"),
+  used_percent: z.number().optional().describe(
+    "Percentage of storage limit used",
+  ),
 });
 
 export type Impressions = { usage?: number | undefined };
 
 export const Impressions$zodSchema: z.ZodType<Impressions> = z.object({
-  usage: z.int().optional(),
+  usage: z.int().optional().describe("Number of impressions used"),
 });
 
 export type SecondsDelivered = { usage?: number | undefined };
 
 export const SecondsDelivered$zodSchema: z.ZodType<SecondsDelivered> = z.object(
   {
-    usage: z.int().optional(),
+    usage: z.int().optional().describe("Number of seconds delivered"),
   },
 );
 
@@ -72,11 +79,19 @@ export type MediaLimits = {
 };
 
 export const MediaLimits$zodSchema: z.ZodType<MediaLimits> = z.object({
-  asset_max_total_px: z.int().optional(),
-  image_max_px: z.int().optional(),
-  image_max_size_bytes: z.int().optional(),
-  raw_max_size_bytes: z.int().optional(),
-  video_max_size_bytes: z.int().optional(),
+  asset_max_total_px: z.int().optional().describe(
+    "Maximum total pixels for assets",
+  ),
+  image_max_px: z.int().optional().describe("Maximum pixels for images"),
+  image_max_size_bytes: z.int().optional().describe(
+    "Maximum size for images in bytes",
+  ),
+  raw_max_size_bytes: z.int().optional().describe(
+    "Maximum size for raw files in bytes",
+  ),
+  video_max_size_bytes: z.int().optional().describe(
+    "Maximum size for videos in bytes",
+  ),
 }).describe("Upload size and pixel limits");
 
 export type UsageResponse = {
@@ -97,15 +112,21 @@ export type UsageResponse = {
 
 export const UsageResponse$zodSchema: z.ZodType<UsageResponse> = z.object({
   bandwidth: z.lazy(() => Bandwidth$zodSchema).optional(),
-  date_requested: z.iso.datetime({ offset: true }).optional(),
-  derived_resources: z.int().optional(),
+  date_requested: z.iso.datetime({ offset: true }).optional().describe(
+    "The date for which usage was requested",
+  ),
+  derived_resources: z.int().optional().describe("Number of derived resources"),
   impressions: z.lazy(() => Impressions$zodSchema).optional(),
-  last_updated: z.string().date().optional(),
-  media_limits: z.lazy(() => MediaLimits$zodSchema).optional(),
+  last_updated: z.string().date().optional().describe(
+    "When the usage data was last updated",
+  ),
+  media_limits: z.lazy(() => MediaLimits$zodSchema).optional().describe(
+    "Upload size and pixel limits",
+  ),
   objects: z.lazy(() => Objects$zodSchema).optional(),
-  plan: z.string().optional(),
-  requests: z.int().optional(),
-  resources: z.int().optional(),
+  plan: z.string().optional().describe("The current plan name"),
+  requests: z.int().optional().describe("Number of requests made"),
+  resources: z.int().optional().describe("Number of resources stored"),
   seconds_delivered: z.lazy(() => SecondsDelivered$zodSchema).optional(),
   storage: z.lazy(() => Storage$zodSchema).optional(),
   transformations: z.lazy(() => Transformations$zodSchema).optional(),

package/src/models/visualsearchassetsop.ts

@@ -1,5 +1,6 @@
 /*
  * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+ * @generated-id: 71bc31bf8f9d
  */
 
 import * as z from "zod";

package/src/models/visualsearchparametersunion.ts

@@ -1,5 +1,6 @@
 /*
  * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+ * @generated-id: 29a5f4f6c5c6
  */
 
 import * as z from "zod";
@@ -12,8 +13,12 @@ export type VisualSearchParameters3 = {
 export const VisualSearchParameters3$zodSchema: z.ZodType<
   VisualSearchParameters3
 > = z.object({
-  text: z.string(),
-  threshold: z.number().optional(),
+  text: z.string().describe(
+    "A textual description to find visually similar images",
+  ),
+  threshold: z.number().optional().describe(
+    "The minimum similarity score (between 0 and 1.0) that a resource must have to be included in the response",
+  ),
 });
 
 export type VisualSearchParameters2 = {
@@ -24,8 +29,12 @@ export type VisualSearchParameters2 = {
 export const VisualSearchParameters2$zodSchema: z.ZodType<
   VisualSearchParameters2
 > = z.object({
-  image_asset_id: z.string(),
-  threshold: z.number().optional(),
+  image_asset_id: z.string().describe(
+    "The asset ID of an existing image to use as the source for finding visually similar images",
+  ),
+  threshold: z.number().optional().describe(
+    "The minimum similarity score (between 0 and 1.0) that a resource must have to be included in the response",
+  ),
 });
 
 export type VisualSearchParameters1 = {
@@ -36,8 +45,12 @@ export type VisualSearchParameters1 = {
 export const VisualSearchParameters1$zodSchema: z.ZodType<
   VisualSearchParameters1
 > = z.object({
-  image_url: z.string(),
-  threshold: z.number().optional(),
+  image_url: z.string().describe(
+    "The URL of an image to use as the source for finding visually similar images",
+  ),
+  threshold: z.number().optional().describe(
+    "The minimum similarity score (between 0 and 1.0) that a resource must have to be included in the response",
+  ),
 });
 
 /**

package/src/types/async.ts

@@ -1,5 +1,6 @@
 /*
  * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+ * @generated-id: fac8da972f86
  */
 
 export type APICall =

package/src/types/bigint.ts

@@ -1,5 +1,6 @@
 /*
  * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+ * @generated-id: 3ca6e3280e43
  */
 
 import * as z from "zod/v4";

package/src/types/blobs.ts

@@ -1,5 +1,6 @@
 /*
  * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+ * @generated-id: f8ab9b326c86
  */
 
 export function isBlobLike(val: unknown): val is Blob {

package/src/types/enums.ts

@@ -1,5 +1,6 @@
 /*
  * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+ * @generated-id: 4d03ddfe5100
  */
 
 declare const __brand: unique symbol;

package/src/types/fp.ts

@@ -1,5 +1,6 @@
 /*
  * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+ * @generated-id: ae9f0fb8aab6
  */
 
 /**

package/src/types/rfcdate.ts

@@ -1,5 +1,6 @@
 /*
  * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+ * @generated-id: 9eb64906dcd6
  */
 
 const dateRE = /^\d{4}-\d{2}-\d{2}$/;

package/src/types/streams.ts

@@ -1,5 +1,6 @@
 /*
  * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+ * @generated-id: f99be9c4bf14
  */
 
 export function isReadableStream<T = Uint8Array>(