@cloudinary/asset-management-mcp 0.9.2 → 0.10.0

package/src/models/searchresponse.ts

@@ -57,14 +57,14 @@ export const SearchResponseStatus$zodSchema = z.enum([
 ]).describe("The current status of the asset.");
 
 /**
- * The access mode of the asset.
+ * The access mode of the asset. Null when not explicitly set.
  */
 export const SearchResponseAccessMode = {
   Public: "public",
   Authenticated: "authenticated",
 } as const;
 /**
- * The access mode of the asset.
+ * The access mode of the asset. Null when not explicitly set.
  */
 export type SearchResponseAccessMode = ClosedEnum<
   typeof SearchResponseAccessMode
@@ -73,7 +73,7 @@ export type SearchResponseAccessMode = ClosedEnum<
 export const SearchResponseAccessMode$zodSchema = z.enum([
   "public",
   "authenticated",
-]).describe("The access mode of the asset.");
+]).describe("The access mode of the asset. Null when not explicitly set.");
 
 /**
  * Information about who created the asset.
@@ -149,7 +149,7 @@ export type Resource = {
   asset_folder?: string | undefined;
   filename?: string | undefined;
   display_name?: string | undefined;
-  format?: string | undefined;
+  format?: string | null | undefined;
   version?: number | undefined;
   resource_type?: SearchResponseResourceType | undefined;
   type?: DeliveryTypeAll | undefined;
@@ -157,14 +157,14 @@ export type Resource = {
   uploaded_at?: string | undefined;
   bytes?: number | undefined;
   backup_bytes?: number | undefined;
-  width?: number | undefined;
-  height?: number | undefined;
-  aspect_ratio?: number | undefined;
-  pixels?: number | undefined;
+  width?: number | null | undefined;
+  height?: number | null | undefined;
+  aspect_ratio?: number | null | undefined;
+  pixels?: number | null | undefined;
   url?: string | undefined;
   secure_url?: string | undefined;
   status?: SearchResponseStatus | undefined;
-  access_mode?: SearchResponseAccessMode | undefined;
+  access_mode?: SearchResponseAccessMode | null | undefined;
   access_control?: Array<AccessControlItem> | null | undefined;
   etag?: string | undefined;
   created_by?: CreatedBy | null | undefined;
@@ -181,13 +181,12 @@ export type Resource = {
 export const Resource$zodSchema: z.ZodType<Resource> = z.object({
   access_control: z.array(AccessControlItem$zodSchema).nullable().optional()
     .describe("The access control settings for the asset."),
-  access_mode: SearchResponseAccessMode$zodSchema.optional().describe(
-    "The access mode of the asset.",
-  ),
+  access_mode: SearchResponseAccessMode$zodSchema.nullable().optional()
+    .describe("The access mode of the asset. Null when not explicitly set."),
   accessibility_analysis: z.lazy(() => AccessibilityAnalysis$zodSchema)
     .nullable().optional().describe("Results of accessibility analysis."),
-  aspect_ratio: z.number().optional().describe(
-    "The aspect ratio of the asset (width/height).",
+  aspect_ratio: z.number().nullable().optional().describe(
+    "The aspect ratio of the asset (width/height). Null for non-visual assets (e.g. raw, audio).",
   ),
   asset_folder: z.string().optional().describe(
     "The folder where the asset is stored.",
@@ -215,8 +214,12 @@ export const Resource$zodSchema: z.ZodType<Resource> = z.object({
   filename: z.string().optional().describe(
     "The original filename of the asset.",
   ),
-  format: z.string().optional().describe("The format of the asset."),
-  height: z.int().optional().describe("The height of the asset in pixels."),
+  format: z.string().nullable().optional().describe(
+    "The format of the asset. Null for raw assets, which have no format.",
+  ),
+  height: z.int().nullable().optional().describe(
+    "The height of the asset in pixels. Null for non-visual assets (e.g. raw, audio).",
+  ),
   image_analysis: z.lazy(() => ImageAnalysis$zodSchema).nullable().optional()
     .describe("Results of image analysis."),
   image_metadata: z.lazy(() => SearchResponseImageMetadata$zodSchema).nullable()
@@ -224,8 +227,8 @@ export const Resource$zodSchema: z.ZodType<Resource> = z.object({
   metadata: z.lazy(() => Metadata$zodSchema).nullable().optional().describe(
     "Structured metadata associated with the asset.",
   ),
-  pixels: z.int().optional().describe(
-    "The total number of pixels in the asset.",
+  pixels: z.int().nullable().optional().describe(
+    "The total number of pixels in the asset. Null for non-visual assets (e.g. raw, audio).",
   ),
   public_id: z.string().optional().describe(
     "The public identifier that is used to build the URL.",
@@ -254,7 +257,9 @@ export const Resource$zodSchema: z.ZodType<Resource> = z.object({
     .describe("Information about who uploaded the asset."),
   url: z.string().optional().describe("The HTTP URL for accessing the asset."),
   version: z.int().optional().describe("The version number of the asset."),
-  width: z.int().optional().describe("The width of the asset in pixels."),
+  width: z.int().nullable().optional().describe(
+    "The width of the asset in pixels. Null for non-visual assets (e.g. raw, audio).",
+  ),
 }).describe(
   "Resource fields that can be returned. All fields are optional and can be filtered using the fields parameter.",
 );

package/src/models/storage.ts

@@ -0,0 +1,39 @@
+/*
+ * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+ * @generated-id: 8b534f43f59e
+ */
+
+import * as z from "zod";
+import {
+  ManagedAssetStorage,
+  ManagedAssetStorage$zodSchema,
+} from "./managedassetstorage.js";
+import {
+  TemporaryStorage,
+  TemporaryStorage$zodSchema,
+} from "./temporarystorage.js";
+
+/**
+ * Where a generated asset is stored — mirrors the request `target`,
+ *
+ * @remarks
+ * determined by `storage_type`. `secure_url` is always present.
+ */
+export type Storage =
+  | (ManagedAssetStorage & { storage_type: "managed_asset" })
+  | (TemporaryStorage & { storage_type: "temporary" });
+
+export const Storage$zodSchema: z.ZodType<Storage> = z.union([
+  ManagedAssetStorage$zodSchema.and(
+    z.object({
+      storage_type: z.literal("managed_asset"),
+    }).transform((v) => ({ storage_type: v.storage_type })),
+  ),
+  TemporaryStorage$zodSchema.and(
+    z.object({
+      storage_type: z.literal("temporary"),
+    }).transform((v) => ({ storage_type: v.storage_type })),
+  ),
+]).describe(
+  "Where a generated asset is stored — mirrors the request `target`,\ndetermined by `storage_type`. `secure_url` is always present.\n",
+);

package/src/models/target.ts

@@ -0,0 +1,39 @@
+/*
+ * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+ * @generated-id: f37077ef7c9a
+ */
+
+import * as z from "zod";
+import {
+  ManagedAssetTarget,
+  ManagedAssetTarget$zodSchema,
+} from "./managedassettarget.js";
+import {
+  TemporaryTarget,
+  TemporaryTarget$zodSchema,
+} from "./temporarytarget.js";
+
+/**
+ * Where to store the generated output, determined by `target_type`.
+ *
+ * @remarks
+ * Optional; defaults to a `managed_asset` target when omitted.
+ */
+export type Target =
+  | (ManagedAssetTarget & { target_type: "managed_asset" })
+  | (TemporaryTarget & { target_type: "temporary" });
+
+export const Target$zodSchema: z.ZodType<Target> = z.union([
+  ManagedAssetTarget$zodSchema.and(
+    z.object({
+      target_type: z.literal("managed_asset"),
+    }).transform((v) => ({ target_type: v.target_type })),
+  ),
+  TemporaryTarget$zodSchema.and(
+    z.object({
+      target_type: z.literal("temporary"),
+    }).transform((v) => ({ target_type: v.target_type })),
+  ),
+]).describe(
+  "Where to store the generated output, determined by `target_type`.\nOptional; defaults to a `managed_asset` target when omitted.\n",
+);

package/src/models/task.ts

@@ -0,0 +1,53 @@
+/*
+ * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+ * @generated-id: 9609f5f4adcb
+ */
+
+import * as z from "zod";
+import { GeneratedAsset, GeneratedAsset$zodSchema } from "./generatedasset.js";
+import { Limits, Limits$zodSchema } from "./limits.js";
+import { TaskStatus, TaskStatus$zodSchema } from "./taskstatus.js";
+
+/**
+ * The generated assets. Populated once `status` is `completed`.
+ *
+ * @remarks
+ */
+export type TaskResult = { assets: Array<GeneratedAsset> };
+
+export const TaskResult$zodSchema: z.ZodType<TaskResult> = z.object({
+  assets: z.array(GeneratedAsset$zodSchema).describe(
+    "The generated assets. Currently a single asset is returned.",
+  ),
+}).describe("The generated assets. Populated once `status` is `completed`.\n");
+
+/**
+ * An async generation task. Returned when a generation is accepted (202)
+ *
+ * @remarks
+ * and from GET /tasks/{task_id} as it progresses. The `result` is filled
+ * in once `status` is `completed`.
+ */
+export type Task = {
+  task_id: string;
+  status: TaskStatus;
+  result?: TaskResult | null | undefined;
+  limits?: Limits | undefined;
+};
+
+export const Task$zodSchema: z.ZodType<Task> = z.object({
+  limits: Limits$zodSchema.optional().describe(
+    "Rate limit information for the account's add-on quotas.",
+  ),
+  result: z.lazy(() => TaskResult$zodSchema).nullable().optional().describe(
+    "The generated assets. Populated once `status` is `completed`.\n",
+  ),
+  status: TaskStatus$zodSchema.describe(
+    "The status of an async generation task.\n* `pending`: accepted and queued, not yet started.\n* `processing`: generation is in progress.\n* `completed`: generation finished; `result` is populated.\n* `failed`: generation did not complete successfully.\n",
+  ),
+  task_id: z.string().describe(
+    "Identifier for the async generation task. Use it to poll `GET /generate/{cloud_name}/tasks/{task_id}`.",
+  ),
+}).describe(
+  "An async generation task. Returned when a generation is accepted (202)\nand from GET /tasks/{task_id} as it progresses. The `result` is filled\nin once `status` is `completed`.\n",
+);

package/src/models/taskresponse.ts

@@ -0,0 +1,26 @@
+/*
+ * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+ * @generated-id: b5ae8dfddaea
+ */
+
+import * as z from "zod";
+import { Task, Task$zodSchema } from "./task.js";
+
+/**
+ * Envelope for an async generation task — returned by the accepted (202)
+ *
+ * @remarks
+ * response and by GET /tasks/{task_id}.
+ */
+export type TaskResponse = { data?: Task | undefined; request_id: string };
+
+export const TaskResponse$zodSchema: z.ZodType<TaskResponse> = z.object({
+  data: Task$zodSchema.optional().describe(
+    "An async generation task. Returned when a generation is accepted (202)\nand from GET /tasks/{task_id} as it progresses. The `result` is filled\nin once `status` is `completed`.\n",
+  ),
+  request_id: z.string().describe(
+    "Unique identifier for this request, for correlation and support.",
+  ),
+}).describe(
+  "Envelope for an async generation task — returned by the accepted (202)\nresponse and by GET /tasks/{task_id}.\n",
+);

package/src/models/taskstatus.ts

@@ -0,0 +1,42 @@
+/*
+ * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+ * @generated-id: 53ca97329a8b
+ */
+
+import * as z from "zod";
+import { ClosedEnum } from "../types/enums.js";
+
+/**
+ * The status of an async generation task.
+ *
+ * @remarks
+ * * `pending`: accepted and queued, not yet started.
+ * * `processing`: generation is in progress.
+ * * `completed`: generation finished; `result` is populated.
+ * * `failed`: generation did not complete successfully.
+ */
+export const TaskStatus = {
+  Pending: "pending",
+  Processing: "processing",
+  Completed: "completed",
+  Failed: "failed",
+} as const;
+/**
+ * The status of an async generation task.
+ *
+ * @remarks
+ * * `pending`: accepted and queued, not yet started.
+ * * `processing`: generation is in progress.
+ * * `completed`: generation finished; `result` is populated.
+ * * `failed`: generation did not complete successfully.
+ */
+export type TaskStatus = ClosedEnum<typeof TaskStatus>;
+
+export const TaskStatus$zodSchema = z.enum([
+  "pending",
+  "processing",
+  "completed",
+  "failed",
+]).describe(
+  "The status of an async generation task.\n* `pending`: accepted and queued, not yet started.\n* `processing`: generation is in progress.\n* `completed`: generation finished; `result` is populated.\n* `failed`: generation did not complete successfully.\n",
+);

package/src/models/temporarystorage.ts

@@ -0,0 +1,47 @@
+/*
+ * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+ * @generated-id: edef5e745a76
+ */
+
+import * as z from "zod";
+import { ClosedEnum } from "../types/enums.js";
+
+/**
+ * Discriminator identifying this as temporary storage.
+ */
+export const TemporaryStorageStorageType = {
+  Temporary: "temporary",
+} as const;
+/**
+ * Discriminator identifying this as temporary storage.
+ */
+export type TemporaryStorageStorageType = ClosedEnum<
+  typeof TemporaryStorageStorageType
+>;
+
+export const TemporaryStorageStorageType$zodSchema = z.enum([
+  "temporary",
+]).describe("Discriminator identifying this as temporary storage.");
+
+/**
+ * A generated asset stored as a short-lived asset on the upload service.
+ */
+export type TemporaryStorage = {
+  storage_type: TemporaryStorageStorageType;
+  secure_url: string;
+  expires_at: string;
+};
+
+export const TemporaryStorage$zodSchema: z.ZodType<TemporaryStorage> = z.object(
+  {
+    expires_at: z.iso.datetime({ offset: true }).describe(
+      "Time in UTC when secure_url stops being valid.",
+    ),
+    secure_url: z.string().describe("The URL to fetch the generated asset."),
+    storage_type: TemporaryStorageStorageType$zodSchema.describe(
+      "Discriminator identifying this as temporary storage.",
+    ),
+  },
+).describe(
+  "A generated asset stored as a short-lived asset on the upload service.",
+);

package/src/models/temporarytarget.ts

@@ -0,0 +1,35 @@
+/*
+ * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+ * @generated-id: 3585fffc94ea
+ */
+
+import * as z from "zod";
+import { ClosedEnum } from "../types/enums.js";
+
+/**
+ * Discriminator identifying this as a temporary target.
+ */
+export const TemporaryTargetTargetType = {
+  Temporary: "temporary",
+} as const;
+/**
+ * Discriminator identifying this as a temporary target.
+ */
+export type TemporaryTargetTargetType = ClosedEnum<
+  typeof TemporaryTargetTargetType
+>;
+
+export const TemporaryTargetTargetType$zodSchema = z.enum([
+  "temporary",
+]).describe("Discriminator identifying this as a temporary target.");
+
+/**
+ * Store the output as a short-lived asset on the upload service.
+ */
+export type TemporaryTarget = { target_type: TemporaryTargetTargetType };
+
+export const TemporaryTarget$zodSchema: z.ZodType<TemporaryTarget> = z.object({
+  target_type: TemporaryTargetTargetType$zodSchema.describe(
+    "Discriminator identifying this as a temporary target.",
+  ),
+}).describe("Store the output as a short-lived asset on the upload service.");

package/src/models/textop.ts

@@ -9,13 +9,6 @@ import { ApiError, ApiError$zodSchema } from "./apierror.js";
 import { TextRequest, TextRequest$zodSchema } from "./textrequest.js";
 import { TextResponse, TextResponse$zodSchema } from "./textresponse.js";
 
-export type TextGlobals = { cloud_name?: string | undefined };
-
-export const TextGlobals$zodSchema: z.ZodType<TextGlobals> = z.object({
-  cloud_name: z.string().describe("The cloud name of your product environment.")
-    .optional(),
-});
-
 /**
  * The type of resource to create. Must be "image" for text generation.
  */
@@ -33,6 +26,13 @@ export const TextResourceType$zodSchema = z.enum([
   "The type of resource to create. Must be \"image\" for text generation.",
 );
 
+export type TextGlobals = { cloud_name?: string | undefined };
+
+export const TextGlobals$zodSchema: z.ZodType<TextGlobals> = z.object({
+  cloud_name: z.string().describe("The cloud name of your product environment.")
+    .optional(),
+});
+
 export type TextRequestRequest = {
   resource_type: TextResourceType;
   text_request: TextRequest;

package/src/models/updateresourcebybodyop.ts

@@ -0,0 +1,29 @@
+/*
+ * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+ * @generated-id: 999f90d330ea
+ */
+
+import * as z from "zod";
+import { ApiError, ApiError$zodSchema } from "./apierror.js";
+import {
+  ResourceInternalResponse,
+  ResourceInternalResponse$zodSchema,
+} from "./resourceinternalresponse.js";
+
+export type UpdateResourceByBodyGlobals = { cloud_name?: string | undefined };
+
+export const UpdateResourceByBodyGlobals$zodSchema: z.ZodType<
+  UpdateResourceByBodyGlobals
+> = z.object({
+  cloud_name: z.string().describe("The cloud name of your product environment.")
+    .optional(),
+});
+
+export type UpdateResourceByBodyResponse = ApiError | ResourceInternalResponse;
+
+export const UpdateResourceByBodyResponse$zodSchema: z.ZodType<
+  UpdateResourceByBodyResponse
+> = z.union([
+  ApiError$zodSchema,
+  ResourceInternalResponse$zodSchema,
+]);

package/src/models/uploadchunkop.ts

@@ -31,16 +31,18 @@ export const UploadChunkGlobals$zodSchema: z.ZodType<UploadChunkGlobals> = z
 
 export type UploadChunkRequest = {
   resource_type?: UploadResourceType | undefined;
-  contentRange: string;
+  contentRange?: string | undefined;
   xUniqueUploadId: string;
+  xUploadPartNumber?: number | undefined;
+  xUploadTotalParts?: number | undefined;
   upload_request: UploadRequest;
 };
 
 export const UploadChunkRequest$zodSchema: z.ZodType<UploadChunkRequest> = z
   .object({
     contentRange: z.string().describe(
-      "The range of bytes being uploaded in the current chunk, in the format \"bytes start-end/total\". For example, \"bytes 0-999999/3000000\" indicates the first 1MB chunk of a 3MB file.",
-    ),
+      "The range of bytes being uploaded in the current chunk, in the format \"bytes start-end/total\".\nFor example, \"bytes 0-999999/3000000\" indicates the first 1MB chunk of a 3MB file. Required for the\ndefault uniform-size chunked upload flow. In explicit-order mode (`X-Upload-Part-Number`), this\nheader remains optional; clients do not have to send `Content-Range`, `X-Upload-Part-Number`, and\n`X-Upload-Total-Parts` together on every request—`X-Upload-Total-Parts` may be omitted on some chunks\nsubject to the rules documented on that header.\n",
+    ).optional(),
     resource_type: UploadResourceType$zodSchema.default("auto").describe(
       "The type of resource (image, video, raw, or auto).",
     ),
@@ -50,6 +52,12 @@ export const UploadChunkRequest$zodSchema: z.ZodType<UploadChunkRequest> = z
     xUniqueUploadId: z.string().describe(
       "A unique identifier for the upload. Must be the same for all chunks of the same file.",
     ),
+    xUploadPartNumber: z.int().describe(
+      "The 1-based part number for this chunk when uploading parts of uneven size with explicit\nclient-supplied order. Requires `X-Unique-Upload-Id`. When present, activates explicit-order mode\nand `Content-Range` is optional. Parts must use contiguous indices `1`…`N`, where `N` is the session\ntotal. If `X-Upload-Total-Parts` is omitted on a chunk, the server still enforces `X-Upload-Part-Number ≤ N`\nonce `N` has been learned from any prior chunk for the same upload that supplied `X-Upload-Total-Parts`.\n",
+    ).optional(),
+    xUploadTotalParts: z.int().describe(
+      "Declared session total `N` (optional on chunks where omission is allowed). When present on a chunk,\nit must satisfy either `X-Upload-Part-Number < X-Upload-Total-Parts` (non-terminal) or\n`X-Upload-Part-Number == X-Upload-Total-Parts` (terminal). The same integer `N` must appear whenever\nthis header is sent for a given `X-Unique-Upload-Id` (no conflicting declared totals). Chunks may omit\nthe header entirely until `N` is established; after `N` is known, non-terminal indices may still omit\nit. Once `N` is known for the session, the request for part index `N` (the final part) must include\n`X-Upload-Total-Parts: N`. The upload completes when all parts `1`…`N` have been received.\n",
+    ).optional(),
   });
 
 /**

package/src/models/uploadrequest.ts

@@ -23,34 +23,6 @@ import {
   UploadDeliveryType$zodSchema,
 } from "./uploaddeliverytype.js";
 
-/**
- * Configuration object for automatic video transcription with translation options.
- */
-export type UploadRequestAutoTranscription = {
-  translate?: Array<string> | undefined;
-};
-
-export const UploadRequestAutoTranscription$zodSchema: z.ZodType<
-  UploadRequestAutoTranscription
-> = z.object({
-  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.",
-);
-
-export type UploadRequestAutoTranscriptionUnion =
-  | boolean
-  | UploadRequestAutoTranscription;
-
-export const UploadRequestAutoTranscriptionUnion$zodSchema: z.ZodType<
-  UploadRequestAutoTranscriptionUnion
-> = z.union([
-  z.boolean(),
-  z.lazy(() => UploadRequestAutoTranscription$zodSchema),
-]);
-
 /**
  * Deprecated. Use access_control instead. Allows the asset to behave as if it's of the authenticated delivery type 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.
  *
@@ -80,6 +52,34 @@ export const UploadRequestAccessMode$zodSchema = z.enum([
   "Deprecated. Use access_control instead. Allows the asset to behave as if it's of the authenticated delivery type 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.\n",
 );
 
+/**
+ * Configuration object for automatic video transcription with translation options.
+ */
+export type UploadRequestAutoTranscription = {
+  translate?: Array<string> | undefined;
+};
+
+export const UploadRequestAutoTranscription$zodSchema: z.ZodType<
+  UploadRequestAutoTranscription
+> = z.object({
+  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.",
+);
+
+export type UploadRequestAutoTranscriptionUnion =
+  | boolean
+  | UploadRequestAutoTranscription;
+
+export const UploadRequestAutoTranscriptionUnion$zodSchema: z.ZodType<
+  UploadRequestAutoTranscriptionUnion
+> = z.union([
+  z.boolean(),
+  z.lazy(() => UploadRequestAutoTranscription$zodSchema),
+]);
+
 /**
  * Named region coordinate groups for cropping with region gravity.
  *

package/src/models/urlreference.ts

@@ -0,0 +1,34 @@
+/*
+ * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+ * @generated-id: 84ab494b1c55
+ */
+
+import * as z from "zod";
+import { ClosedEnum } from "../types/enums.js";
+
+/**
+ * Discriminator identifying this as an external-URL reference.
+ */
+export const UrlReferenceSourceType = {
+  Url: "url",
+} as const;
+/**
+ * Discriminator identifying this as an external-URL reference.
+ */
+export type UrlReferenceSourceType = ClosedEnum<typeof UrlReferenceSourceType>;
+
+export const UrlReferenceSourceType$zodSchema = z.enum([
+  "url",
+]).describe("Discriminator identifying this as an external-URL reference.");
+
+/**
+ * A reference to an external image by HTTPS URL.
+ */
+export type UrlReference = { source_type: UrlReferenceSourceType; url: string };
+
+export const UrlReference$zodSchema: z.ZodType<UrlReference> = z.object({
+  source_type: UrlReferenceSourceType$zodSchema.describe(
+    "Discriminator identifying this as an external-URL reference.",
+  ),
+  url: z.string().describe("HTTPS URL of the reference image."),
+}).describe("A reference to an external image by HTTPS URL.");

package/src/models/usageresponse.ts

@@ -39,19 +39,20 @@ export const Bandwidth$zodSchema: z.ZodType<Bandwidth> = z.object({
   ),
 });
 
-export type Storage = {
+export type UsageResponseStorage = {
   usage?: number | undefined;
   limit?: number | undefined;
   used_percent?: number | undefined;
 };
 
-export const Storage$zodSchema: z.ZodType<Storage> = z.object({
-  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 const UsageResponseStorage$zodSchema: z.ZodType<UsageResponseStorage> = z
+  .object({
+    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 };
 
@@ -101,7 +102,7 @@ export type UsageResponse = {
   transformations?: Transformations | undefined;
   objects?: Objects | undefined;
   bandwidth?: Bandwidth | undefined;
-  storage?: Storage | undefined;
+  storage?: UsageResponseStorage | undefined;
   impressions?: Impressions | undefined;
   seconds_delivered?: SecondsDelivered | undefined;
   resources?: number | undefined;
@@ -128,6 +129,6 @@ export const UsageResponse$zodSchema: z.ZodType<UsageResponse> = z.object({
   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(),
+  storage: z.lazy(() => UsageResponseStorage$zodSchema).optional(),
   transformations: z.lazy(() => Transformations$zodSchema).optional(),
 });