@cloudinary/asset-management-mcp 0.8.1 → 0.9.0

package/src/mcp-server/tools/assetsListRawFiles.ts

@@ -5,38 +5,43 @@
 
 import * as z from "zod";
 import { assetsListRawFiles } from "../../funcs/assetsListRawFiles.js";
-import { Direction$zodSchema } from "../../models/direction.js";
-import { FieldsSpec$zodSchema } from "../../models/fieldsspec.js";
-import { ListStorageType$zodSchema } from "../../models/liststoragetype.js";
+import { DeliveryTypeAll$zodSchema } from "../../models/deliverytypeall.js";
+import { DirectionEnum$zodSchema } from "../../models/directionenum.js";
+import { Fields$zodSchema } from "../../models/fields.js";
 import { formatResult, ToolDefinition } from "../tools.js";
+import { appUri } from "../apps/uri.js";
 
 const args = {
-  type: ListStorageType$zodSchema.optional().describe(
-    `The delivery type. Necessary for prefix filtering.`,
+  type: DeliveryTypeAll$zodSchema.optional().describe(
+    `The delivery type to filter by. When omitted, returns assets of all delivery types.`,
   ),
   prefix: z.string().describe(
-    "A public_id prefix. When specified, all assets with that prefix are returned. When using this, the `type` parameter must also be specified.",
+    "A public_id prefix. When specified, all assets with that prefix are returned.",
   ).optional(),
   public_ids: z.array(z.string()).describe("An array of public IDs to return.")
     .optional(),
-  tags: z.boolean().describe(
-    "Whether to include the list of tag names assigned to each asset. Default: false",
-  ).optional(),
+  tags: z.boolean().default(false).describe(
+    "Whether to include the list of tag names assigned to each asset. Default is false.",
+  ),
   next_cursor: z.string().describe("Cursor for pagination.").optional(),
   max_results: z.int().describe("Maximum number of results to return (1-500).")
     .optional(),
-  direction: Direction$zodSchema.optional().describe(`Sort direction.`),
+  direction: DirectionEnum$zodSchema.optional().describe(
+    `The sort direction for the results. Default is "desc".`,
+  ),
   start_at: z.iso.datetime({ offset: true }).describe(
-    "An ISO-8601 formatted timestamp. When specified, assets created since that timestamp are returned.  Supported only if neither `prefix` nor `public_ids` were passed.",
+    "An ISO-8601 formatted timestamp. When specified, returns resources created since that timestamp. Supported only if neither `prefix` nor `public_ids` were passed.",
   ).optional(),
-  fields: z.array(FieldsSpec$zodSchema).optional(),
+  fields: Fields$zodSchema.optional().describe(
+    `Additional fields to include in the response. The fields public_id and asset_id are always included.`,
+  ),
 };
 
 export const tool$assetsListRawFiles: ToolDefinition<typeof args> = {
   name: "list-files",
   description: `Get raw assets
 
-Retrieves a list of raw assets. Results can be filtered by various criteria like tags, moderation status, prefix, or specific public IDs.
+Retrieves a list of raw assets. Results can be filtered by various criteria like tags, prefix, or specific public IDs.
 `,
   scopes: ["librarian"],
   annotations: {
@@ -46,6 +51,9 @@ Retrieves a list of raw assets. Results can be filtered by various criteria like
     "openWorldHint": false,
     "readOnlyHint": true,
   },
+  _meta: {
+    ui: { resourceUri: appUri("asset-gallery", "list-files") },
+  },
   args,
   tool: async (client, args, ctx) => {
     const [result] = await assetsListRawFiles(

package/src/mcp-server/tools/assetsListResourceTags.ts

@@ -9,9 +9,11 @@ import { ResourceType$zodSchema } from "../../models/resourcetype.js";
 import { formatResult, ToolDefinition } from "../tools.js";
 
 const args = {
-  resource_type: ResourceType$zodSchema.describe(`The type of resource.`),
+  resource_type: ResourceType$zodSchema.describe(
+    `The type of resource (image, video, or raw).`,
+  ),
   prefix: z.string().describe(
-    "The prefix to use if you want to limit the returned tags to those that start with the specified prefix.",
+    "Limit the returned tags to those that start with the specified prefix.",
   ).optional(),
   next_cursor: z.string().describe("Cursor for pagination.").optional(),
   max_results: z.int().describe("Maximum number of results to return (1-500).")

package/src/mcp-server/tools/assetsListVideos.ts

@@ -5,38 +5,43 @@
 
 import * as z from "zod";
 import { assetsListVideos } from "../../funcs/assetsListVideos.js";
-import { Direction$zodSchema } from "../../models/direction.js";
-import { FieldsSpec$zodSchema } from "../../models/fieldsspec.js";
-import { ListStorageType$zodSchema } from "../../models/liststoragetype.js";
+import { DeliveryTypeAll$zodSchema } from "../../models/deliverytypeall.js";
+import { DirectionEnum$zodSchema } from "../../models/directionenum.js";
+import { Fields$zodSchema } from "../../models/fields.js";
 import { formatResult, ToolDefinition } from "../tools.js";
+import { appUri } from "../apps/uri.js";
 
 const args = {
-  type: ListStorageType$zodSchema.optional().describe(
-    `The delivery type. Necessary for prefix filtering.`,
+  type: DeliveryTypeAll$zodSchema.optional().describe(
+    `The delivery type to filter by. When omitted, returns assets of all delivery types.`,
   ),
   prefix: z.string().describe(
-    "A public_id prefix. When specified, all assets with that prefix are returned. When using this, the `type` parameter must also be specified.",
+    "A public_id prefix. When specified, all assets with that prefix are returned.",
   ).optional(),
   public_ids: z.array(z.string()).describe("An array of public IDs to return.")
     .optional(),
-  tags: z.boolean().describe(
-    "Whether to include the list of tag names assigned to each asset. Default: false",
-  ).optional(),
+  tags: z.boolean().default(false).describe(
+    "Whether to include the list of tag names assigned to each asset. Default is false.",
+  ),
   next_cursor: z.string().describe("Cursor for pagination.").optional(),
   max_results: z.int().describe("Maximum number of results to return (1-500).")
     .optional(),
-  direction: Direction$zodSchema.optional().describe(`Sort direction.`),
+  direction: DirectionEnum$zodSchema.optional().describe(
+    `The sort direction for the results. Default is "desc".`,
+  ),
   start_at: z.iso.datetime({ offset: true }).describe(
-    "An ISO-8601 formatted timestamp. When specified, assets created since that timestamp are returned.  Supported only if neither `prefix` nor `public_ids` were passed.",
+    "An ISO-8601 formatted timestamp. When specified, returns resources created since that timestamp. Supported only if neither `prefix` nor `public_ids` were passed.",
   ).optional(),
-  fields: z.array(FieldsSpec$zodSchema).optional(),
+  fields: Fields$zodSchema.optional().describe(
+    `Additional fields to include in the response. The fields public_id and asset_id are always included.`,
+  ),
 };
 
 export const tool$assetsListVideos: ToolDefinition<typeof args> = {
   name: "list-videos",
   description: `Get video assets
 
-Retrieves a list of video assets. Results can be filtered by various criteria like tags, moderation status, prefix, or specific public IDs.
+Retrieves a list of video assets. Results can be filtered by various criteria like tags, prefix, or specific public IDs.
 `,
   scopes: ["librarian"],
   annotations: {
@@ -46,6 +51,9 @@ Retrieves a list of video assets. Results can be filtered by various criteria li
     "openWorldHint": false,
     "readOnlyHint": true,
   },
+  _meta: {
+    ui: { resourceUri: appUri("asset-gallery", "list-videos") },
+  },
   args,
   tool: async (client, args, ctx) => {
     const [result] = await assetsListVideos(

package/src/mcp-server/tools/assetsRenameAsset.ts

@@ -9,8 +9,12 @@ import { ResourceType$zodSchema } from "../../models/resourcetype.js";
 import { formatResult, ToolDefinition } from "../tools.js";
 
 const args = {
-  resource_type: ResourceType$zodSchema.describe(`The type of resource.`),
-  RequestBody: RenameAssetRequestBody$zodSchema,
+  resource_type: ResourceType$zodSchema.describe(
+    `The type of resource (image, video, or raw).`,
+  ),
+  RequestBody: RenameAssetRequestBody$zodSchema.describe(
+    `The rename request parameters.`,
+  ),
 };
 
 export const tool$assetsRenameAsset: ToolDefinition<typeof args> = {

package/src/mcp-server/tools/assetsUpdateResourceByAssetId.ts

@@ -12,7 +12,9 @@ const args = {
   asset_id: z.string().describe(
     "The asset ID of the resource. Must be a 32-character hexadecimal string.",
   ),
-  ResourceUpdateRequest: ResourceUpdateRequest$zodSchema,
+  ResourceUpdateRequest: ResourceUpdateRequest$zodSchema.describe(
+    `The asset attributes to update.`,
+  ),
 };
 
 export const tool$assetsUpdateResourceByAssetId: ToolDefinition<typeof args> = {
@@ -20,7 +22,7 @@ export const tool$assetsUpdateResourceByAssetId: ToolDefinition<typeof args> = {
   description:
     `Updates an existing asset's metadata, tags, and other attributes using its asset ID
 
-Updates one or more attributes of a specified resource (asset) by its asset ID. This enables you to update details of an asset by its unique and immutable identifier, regardless of public ID, display name, asset folder, resource type or deliver type. Note that you can also update many attributes of an existing asset using the explicit method, which is not rate-limited.
+Updates one or more attributes of a specified resource (asset) by its asset ID. This enables you to update details of an asset by its unique and immutable identifier, regardless of public ID, display name, asset folder, resource type or delivery type. Note that you can also update attributes of an existing asset using the explicit API endpoint.
 `,
   scopes: ["librarian"],
   annotations: {

package/src/mcp-server/tools/foldersCreateFolder.ts

@@ -8,7 +8,9 @@ import { foldersCreateFolder } from "../../funcs/foldersCreateFolder.js";
 import { formatResult, ToolDefinition } from "../tools.js";
 
 const args = {
-  folder: z.string(),
+  folder: z.string().describe(
+    "The full path of the folder, including any nested folders. Must not be empty, and must not contain double slashes or leading/trailing slashes.",
+  ),
 };
 
 export const tool$foldersCreateFolder: ToolDefinition<typeof args> = {

package/src/mcp-server/tools/foldersDestroyFolder.ts

@@ -8,7 +8,9 @@ import { foldersDestroyFolder } from "../../funcs/foldersDestroyFolder.js";
 import { formatResult, ToolDefinition } from "../tools.js";
 
 const args = {
-  folder: z.string(),
+  folder: z.string().describe(
+    "The full path of the folder, including any nested folders. Must not be empty, and must not contain double slashes or leading/trailing slashes.",
+  ),
 };
 
 export const tool$foldersDestroyFolder: ToolDefinition<typeof args> = {

package/src/mcp-server/tools/foldersSearchFolders.ts

@@ -5,15 +5,15 @@
 
 import * as z from "zod";
 import { foldersSearchFolders } from "../../funcs/foldersSearchFolders.js";
-import { ExpressionUnion$zodSchema } from "../../models/searchfoldersop.js";
+import { DirectionEnum$zodSchema } from "../../models/directionenum.js";
 import { formatResult, ToolDefinition } from "../tools.js";
 
 const args = {
-  expression: ExpressionUnion$zodSchema.optional().describe(
-    `The (Lucene-like) string expression specifying the search query, or an object for advanced queries. If not passed, returns all folders (up to max_results).`,
-  ),
-  sort_by: z.array(z.string()).describe(
-    "An array of key-value pairs for sorting. Each value is a key and direction (asc/desc).",
+  expression: z.string().describe(
+    "The (Lucene-like) string expression specifying the search query. If not passed, returns all folders (up to max_results).",
+  ).optional(),
+  sort_by: z.array(z.record(z.string(), DirectionEnum$zodSchema)).describe(
+    "Sort order for the results. Each item maps a field name to a direction.",
   ).optional(),
   max_results: z.int().default(50).describe(
     "Maximum number of folders to return (max 500, default 50).",

package/src/mcp-server/tools/foldersUpdateFolder.ts

@@ -5,12 +5,16 @@
 
 import * as z from "zod";
 import { foldersUpdateFolder } from "../../funcs/foldersUpdateFolder.js";
-import { UpdateFolderRequestBody$zodSchema } from "../../models/updatefolderop.js";
+import { MoveFolderRequest$zodSchema } from "../../models/movefolderrequest.js";
 import { formatResult, ToolDefinition } from "../tools.js";
 
 const args = {
-  folder: z.string(),
-  RequestBody: UpdateFolderRequestBody$zodSchema,
+  folder: z.string().describe(
+    "The full path of the folder, including any nested folders. Must not be empty, and must not contain double slashes or leading/trailing slashes.",
+  ),
+  move_folder_request: MoveFolderRequest$zodSchema.describe(
+    `The new folder path.`,
+  ),
 };
 
 export const tool$foldersUpdateFolder: ToolDefinition<typeof args> = {
@@ -32,7 +36,7 @@ Renames or moves an entire folder (along with all assets it contains) to a new l
     const [result] = await foldersUpdateFolder(
       client,
       args.folder,
-      args.RequestBody,
+      args.move_folder_request,
       { fetchOptions: { signal: ctx.signal } },
     ).$inspect();
 

package/src/mcp-server/tools/searchSearchAssets.ts

@@ -6,9 +6,10 @@
 import { searchSearchAssets } from "../../funcs/searchSearchAssets.js";
 import { SearchParameters$zodSchema } from "../../models/searchparameters.js";
 import { formatResult, ToolDefinition } from "../tools.js";
+import { appUri } from "../apps/uri.js";
 
 const args = {
-  request: SearchParameters$zodSchema,
+  request: SearchParameters$zodSchema.describe(`The search query parameters.`),
 };
 
 export const tool$searchSearchAssets: ToolDefinition<typeof args> = {
@@ -30,6 +31,9 @@ Examples: tags:shirt AND uploaded_at>1d, resource_type:image AND bytes>1mb, fold
     "openWorldHint": false,
     "readOnlyHint": true,
   },
+  _meta: {
+    ui: { resourceUri: appUri("asset-gallery", "search-assets") },
+  },
   args,
   tool: async (client, args, ctx) => {
     const [result] = await searchSearchAssets(

package/src/mcp-server/tools/searchVisualSearchAssets.ts

@@ -8,7 +8,9 @@ import { VisualSearchParametersUnion$zodSchema } from "../../models/visualsearch
 import { formatResult, ToolDefinition } from "../tools.js";
 
 const args = {
-  request: VisualSearchParametersUnion$zodSchema,
+  request: VisualSearchParametersUnion$zodSchema.describe(
+    `The visual search parameters.`,
+  ),
 };
 
 export const tool$searchVisualSearchAssets: ToolDefinition<typeof args> = {
@@ -18,7 +20,7 @@ export const tool$searchVisualSearchAssets: ToolDefinition<typeof args> = {
 
 Returns a list of resources that are visually similar to a specified image. You can provide the source image for comparison in one of three ways:
 - Provide a URL of an image
-- Specify the public ID or asset ID of an existing image
+- Specify the asset ID of an existing image
 - Provide a textual description
 `,
   scopes: ["librarian"],

package/src/mcp-server/tools/uploadUpload.ts

@@ -6,18 +6,16 @@
 import { uploadUpload } from "../../funcs/uploadUpload.js";
 import { UploadRequest$zodSchema } from "../../models/uploadrequest.js";
 import { UploadResourceType$zodSchema } from "../../models/uploadresourcetype.js";
+import { appUri } from "../apps/uri.js";
 import { formatResult, ToolDefinition } from "../tools.js";
 
 const args = {
   resource_type: UploadResourceType$zodSchema.default("auto").describe(
-    `The type of resource to upload:
-- "image" for uploading strictly images
-- "video" for uploading strictly videos
-- "raw" for uploading non-media files
-- "auto" for allowing Cloudinary to automatically detect the type of the uploaded file
-`,
+    `The type of resource (image, video, raw, or auto).`,
+  ),
+  upload_request: UploadRequest$zodSchema.describe(
+    `The file to upload and associated parameters.`,
   ),
-  upload_request: UploadRequest$zodSchema,
 };
 
 export const tool$uploadUpload: ToolDefinition<typeof args> = {
@@ -48,6 +46,9 @@ Transform media files using transformation syntax in delivery URLs, which create
     "openWorldHint": false,
     "readOnlyHint": false,
   },
+  _meta: {
+    ui: { resourceUri: appUri("asset-upload", "upload-asset") },
+  },
   args,
   tool: async (client, args, ctx) => {
     const [result] = await uploadUpload(

package/src/mcp-server/tools/usageGetUsage.ts

@@ -8,7 +8,9 @@ import { usageGetUsage } from "../../funcs/usageGetUsage.js";
 import { formatResult, ToolDefinition } from "../tools.js";
 
 const args = {
-  date: z.string().date().optional(),
+  date: z.string().date().describe(
+    "The date for which to retrieve usage details (YYYY-MM-DD). If not specified, returns the current usage.",
+  ).optional(),
 };
 
 export const tool$usageGetUsage: ToolDefinition<typeof args> = {

package/src/mcp-server/tools.ts

@@ -17,6 +17,8 @@ import {
 import * as z from "zod";
 import { CloudinaryAssetMgmtCore } from "../core.js";
 import { ServerRegion$zodSchema } from "../lib/config.js";
+import { enabledAppUriPrefixes, type McpApp } from "./apps/config.js";
+import { shouldForwardToolMeta } from "./apps/tool-hooks.js";
 import { ConsoleLogger } from "./console-logger.js";
 import { MCPServerFlags } from "./flags.js";
 import { MCPScope, mcpScopes } from "./scopes.js";
@@ -80,6 +82,7 @@ export type ToolDefinition<
       openWorldHint: boolean;
       readOnlyHint: boolean;
     };
+    _meta?: Record<string, unknown>;
     tool: (
       client: CloudinaryAssetMgmtCore,
       args: ShapeOutput<Args>,
@@ -98,6 +101,7 @@ export type ToolDefinition<
       openWorldHint: boolean;
       readOnlyHint: boolean;
     };
+    _meta?: Record<string, unknown>;
     tool: (
       client: CloudinaryAssetMgmtCore,
       extra: RequestHandlerExtra<ServerRequest, ServerNotification>,
@@ -137,11 +141,13 @@ export function createRegisterTool(
   allowedTools?: Set<string>,
   dynamic?: boolean,
   annotationFilter?: MCPToolAnnotationFilter,
+  mcpApps?: McpApp[],
 ): [
   <A extends ZodRawShapeCompat | undefined>(tool: ToolDefinition<A>) => void,
   Array<{ name: string; description: string }>,
   Map<string, ToolDefinition<ZodRawShapeCompat | undefined>>,
 ] {
+  const enabledUris = enabledAppUriPrefixes(mcpApps ?? []);
   const tools: Array<{ name: string; description: string }> = [];
   const toolMap = new Map<
     string,
@@ -212,6 +218,9 @@ export function createRegisterTool(
           description: tool.description,
           inputSchema: tool.args,
           annotations: tool.annotations,
+          ...(shouldForwardToolMeta(tool._meta, enabledUris)
+            ? { _meta: tool._meta }
+            : {}),
         },
         async (args, ctx) => {
           return tool.tool(getSDK(), args, ctx);
@@ -223,6 +232,9 @@ export function createRegisterTool(
         {
           description: tool.description,
           annotations: tool.annotations,
+          ...(shouldForwardToolMeta(tool._meta, enabledUris)
+            ? { _meta: tool._meta }
+            : {}),
         },
         async (ctx) => {
           return tool.tool(getSDK(), ctx);
@@ -360,16 +372,16 @@ export function registerDynamicTools(
 
     return { content: [{ type: "text", text: parts.join("\n\n") }] };
   });
-  logger.debug("Registered dynamic meta-tool", { name: "describe_tool" });
+  logger.debug("Registered dynamic meta-tool", { name: "describe_tool_input" });
 
   // 3. execute_tool
   server.registerTool("execute_tool", {
     description:
-      "Execute a tool by name with the provided input parameters. If executing a given tool for the first time, it is recommended to call describe_tool_input first to understand the expected input schema.",
+      "Execute a tool by name with its arguments. If executing a given tool for the first time, it is recommended to call describe_tool_input first to understand the expected `arguments` shape.",
     inputSchema: {
-      tool_name: z.string().describe("The name of the tool to execute"),
-      input: z.record(z.string(), z.unknown()).optional().describe(
-        "Input parameters for the tool as a JSON object",
+      name: z.string().describe("The name of the tool to execute"),
+      arguments: z.looseObject({}).optional().describe(
+        "Arguments for the target tool as a JSON object, matching the schema returned by describe_tool_input.",
       ),
     },
     annotations: {
@@ -380,17 +392,17 @@ export function registerDynamicTools(
       openWorldHint: true,
     },
   }, async (args, ctx) => {
-    const def = toolMap.get(args.tool_name);
+    const def = toolMap.get(args.name);
     if (!def) {
       return {
-        content: [{ type: "text", text: `Unknown tool: ${args.tool_name}` }],
+        content: [{ type: "text", text: `Unknown tool: ${args.name}` }],
         isError: true,
       };
     }
 
     let validatedInput: Record<string, unknown> = {};
     if (def.args) {
-      const vres = z.object(def.args).safeParse(args.input ?? {});
+      const vres = z.object(def.args).safeParse(args.arguments ?? {});
       if (vres.success) {
         validatedInput = vres.data;
       } else {
@@ -400,7 +412,7 @@ export function registerDynamicTools(
           content: [{
             type: "text",
             text:
-              `Invalid input for tool ${args.tool_name}:\n<issues>\n${issues}\n</issues>`,
+              `Invalid input for tool ${args.name}:\n<issues>\n${issues}\n</issues>`,
           }],
           isError: true,
         };
@@ -418,7 +430,7 @@ export function registerDynamicTools(
       return {
         content: [{
           type: "text",
-          text: `Error executing tool ${args.tool_name}: ${message}`,
+          text: `Error executing tool ${args.name}: ${message}`,
         }],
         isError: true,
       };

package/src/models/accesscontrolitem.ts

@@ -23,14 +23,38 @@ export const AccessType$zodSchema = z.enum([
   "anonymous",
 ]).describe("The type of access control to apply to the asset.");
 
+/**
+ * The start date and time when anonymous access becomes available. Accepts ISO 8601 string or Unix timestamp.
+ */
+export type Start = string | number;
+
+export const Start$zodSchema: z.ZodType<Start> = z.union([
+  z.string(),
+  z.int(),
+]).describe(
+  "The start date and time when anonymous access becomes available. Accepts ISO 8601 string or Unix timestamp.",
+);
+
+/**
+ * The end date and time when anonymous access expires. Accepts ISO 8601 string or Unix timestamp.
+ */
+export type End = string | number;
+
+export const End$zodSchema: z.ZodType<End> = z.union([
+  z.string(),
+  z.int(),
+]).describe(
+  "The end date and time when anonymous access expires. Accepts ISO 8601 string or Unix timestamp.",
+);
+
 /**
  * Access control rule that defines when and how the asset can be accessed.
  */
 export type AccessControlItem = {
   access_type: AccessType;
   key?: string | undefined;
-  start?: string | undefined;
-  end?: string | undefined;
+  start?: string | number | undefined;
+  end?: string | number | undefined;
 };
 
 export const AccessControlItem$zodSchema: z.ZodType<AccessControlItem> = z
@@ -38,14 +62,20 @@ export const AccessControlItem$zodSchema: z.ZodType<AccessControlItem> = z
     access_type: AccessType$zodSchema.describe(
       "The type of access control to apply to the asset.",
     ),
-    end: z.string().optional().describe(
-      "The end date and time when anonymous access expires (ISO 8601 format).",
+    end: z.union([
+      z.string(),
+      z.int(),
+    ]).optional().describe(
+      "The end date and time when anonymous access expires. Accepts ISO 8601 string or Unix timestamp.",
     ),
     key: z.string().optional().describe(
       "The authentication key identifier for token-based access. Default key is used if not specified or if set to 'default'.",
     ),
-    start: z.string().optional().describe(
-      "The start date and time when anonymous access becomes available (ISO 8601 format).",
+    start: z.union([
+      z.string(),
+      z.int(),
+    ]).optional().describe(
+      "The start date and time when anonymous access becomes available. Accepts ISO 8601 string or Unix timestamp.",
     ),
   }).describe(
     "Access control rule that defines when and how the asset can be accessed.",

package/src/models/assetdeliverytype.ts

@@ -0,0 +1,22 @@
+/*
+ * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+ * @generated-id: bf0f7e855303
+ */
+
+import * as z from "zod";
+import { ClosedEnum } from "../types/enums.js";
+
+/**
+ * Static asset delivery type.
+ */
+export const AssetDeliveryType = {
+  Asset: "asset",
+} as const;
+/**
+ * Static asset delivery type.
+ */
+export type AssetDeliveryType = ClosedEnum<typeof AssetDeliveryType>;
+
+export const AssetDeliveryType$zodSchema = z.enum([
+  "asset",
+]).describe("Static asset delivery type.");

package/src/models/assignfolderrolesop.ts

@@ -31,7 +31,9 @@ export type AssignFolderRolesRequestRequest = {
 export const AssignFolderRolesRequestRequest$zodSchema: z.ZodType<
   AssignFolderRolesRequestRequest
 > = z.object({
-  assign_folder_roles_request: AssignFolderRolesRequest$zodSchema,
+  assign_folder_roles_request: AssignFolderRolesRequest$zodSchema.describe(
+    "The folder role assignments.",
+  ),
   folder_id: z.string().describe(
     "The immutable identifier of the folder, returned by the Get root folders and Get subfolders endpoints.",
   ),

package/src/models/asyncuploadresponse.ts

@@ -6,7 +6,10 @@
 import * as z from "zod";
 import { ClosedEnum } from "../types/enums.js";
 import { ResourceType, ResourceType$zodSchema } from "./resourcetype.js";
-import { StorageType, StorageType$zodSchema } from "./storagetype.js";
+import {
+  UploadDeliveryType,
+  UploadDeliveryType$zodSchema,
+} from "./uploaddeliverytype.js";
 
 /**
  * The status of the asynchronous upload. Will be 'pending' for async uploads.
@@ -33,7 +36,7 @@ export const AsyncUploadResponseStatus$zodSchema = z.enum([
 export type AsyncUploadResponse = {
   status: AsyncUploadResponseStatus;
   resource_type?: ResourceType | undefined;
-  type: StorageType;
+  type: UploadDeliveryType;
   public_id?: string | undefined;
   batch_id: string;
   requester_ip?: string | undefined;
@@ -56,7 +59,9 @@ export const AsyncUploadResponse$zodSchema: z.ZodType<AsyncUploadResponse> = z
     status: AsyncUploadResponseStatus$zodSchema.describe(
       "The status of the asynchronous upload. Will be 'pending' for async uploads.",
     ),
-    type: StorageType$zodSchema.describe("The storage type of the resource."),
+    type: UploadDeliveryType$zodSchema.describe(
+      "Delivery types accepted by upload and rename operations.",
+    ),
   }).describe(
     "Response returned when an upload is processed asynchronously (async=true)",
   );

package/src/models/backupversionfailure.ts

@@ -0,0 +1,21 @@
+/*
+ * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+ * @generated-id: 1746f046a48e
+ */
+
+import * as z from "zod";
+
+export type BackupVersionFailure = {
+  version_id?: string | undefined;
+  error?: string | undefined;
+};
+
+export const BackupVersionFailure$zodSchema: z.ZodType<BackupVersionFailure> = z
+  .object({
+    error: z.string().optional().describe(
+      "The error message explaining the failure.",
+    ),
+    version_id: z.string().optional().describe(
+      "Hexadecimal version ID; length is a positive multiple of 32 (typically 32 or 64).",
+    ),
+  });

package/src/models/componentsdestroyrequest.ts

@@ -0,0 +1,28 @@
+/*
+ * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+ * @generated-id: a90e8950d8e0
+ */
+
+import * as z from "zod";
+
+export type ComponentsDestroyRequest = {
+  asset_id: string;
+  invalidate?: boolean | undefined;
+  notification_url?: string | undefined;
+  callback?: string | undefined;
+};
+
+export const ComponentsDestroyRequest$zodSchema: z.ZodType<
+  ComponentsDestroyRequest
+> = z.object({
+  asset_id: z.string().describe("A 32-character hexadecimal asset ID."),
+  callback: z.string().optional().describe(
+    "URL for redirect after operation completion.",
+  ),
+  invalidate: z.boolean().optional().describe(
+    "Whether to invalidate CDN cache. Default is false.",
+  ),
+  notification_url: z.string().optional().describe(
+    "URL to receive completion notification.",
+  ),
+});