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

package/bin/mcp-server.js

@@ -13959,13 +13959,71 @@ var init_config = __esm(() => {
   ]).describe("Regional endpoint selection");
   SDK_METADATA = {
     language: "typescript",
-    openapiDocVersion: "0.4.0",
-    sdkVersion: "0.9.0-rc.0",
-    genVersion: "2.879.11",
-    userAgent: "speakeasy-sdk/mcp-typescript 0.9.0-rc.0 2.879.11 0.4.0 @cloudinary/asset-management-mcp"
+    openapiDocVersion: "0.5.1",
+    sdkVersion: "0.9.1",
+    genVersion: "2.881.4",
+    userAgent: "speakeasy-sdk/mcp-typescript 0.9.1 2.881.4 0.5.1 @cloudinary/asset-management-mcp"
   };
 });
 
+// src/mcp-server/apps/uri.ts
+function appUri(app, toolName) {
+  return `${ROOT}/${app}/${toolName}.html`;
+}
+function appUriTemplate(app) {
+  return `${ROOT}/${app}/{tool}.html`;
+}
+function appUriPrefix(app) {
+  return `${ROOT}/${app}/`;
+}
+function injectToolName(html, toolName) {
+  if (!toolName)
+    return html;
+  const inject = `<script>window.__MCP_TOOL_NAME__=${JSON.stringify(toolName)};</script>`;
+  return html.replace("</head>", `${inject}</head>`);
+}
+var MCP_APP_MIME_TYPE = "text/html;profile=mcp-app", ROOT = "ui://cloudinary";
+
+// src/mcp-server/apps/config.ts
+function parseMcpAppsList(value) {
+  const parts = value.split(",").map((s) => s.trim()).filter(Boolean);
+  if (parts.length === 0)
+    return [...MCP_APPS];
+  if (parts.length === 1) {
+    const v2 = parts[0].toLowerCase();
+    if (v2 === "all" || v2 === "true")
+      return [...MCP_APPS];
+    if (v2 === "none" || v2 === "false")
+      return [];
+  }
+  for (const p of parts) {
+    if (!MCP_APPS.includes(p)) {
+      throw new Error(`Invalid mcp-apps value: "${p}". Valid: ${MCP_APPS.join(", ")}, all/true, none/false`);
+    }
+  }
+  return parts;
+}
+function resolveMcpApps(flag) {
+  if (flag !== undefined)
+    return flag;
+  const env = process.env["CLOUDINARY_MCP_APPS"];
+  if (env != null)
+    return parseMcpAppsList(env);
+  return [...DEFAULT_MCP_APPS];
+}
+function enabledAppUriPrefixes(apps) {
+  return apps.map(appUriPrefix);
+}
+var MCP_APPS, DEFAULT_MCP_APPS;
+var init_config2 = __esm(() => {
+  MCP_APPS = [
+    "asset-gallery",
+    "asset-details",
+    "asset-upload"
+  ];
+  DEFAULT_MCP_APPS = [];
+});
+
 // src/mcp-server/console-logger.ts
 function createConsoleLogger(level) {
   const min = consoleLoggerLevels.indexOf(level);
@@ -61841,6 +61899,221 @@ var init_completable = __esm(() => {
     McpZodTypeKind2["Completable"] = "McpCompletable";
   })(McpZodTypeKind || (McpZodTypeKind = {}));
 });
+
+// node_modules/@modelcontextprotocol/sdk/dist/esm/shared/uriTemplate.js
+class UriTemplate {
+  static isTemplate(str) {
+    return /\{[^}\s]+\}/.test(str);
+  }
+  static validateLength(str, max, context) {
+    if (str.length > max) {
+      throw new Error(`${context} exceeds maximum length of ${max} characters (got ${str.length})`);
+    }
+  }
+  get variableNames() {
+    return this.parts.flatMap((part) => typeof part === "string" ? [] : part.names);
+  }
+  constructor(template) {
+    UriTemplate.validateLength(template, MAX_TEMPLATE_LENGTH, "Template");
+    this.template = template;
+    this.parts = this.parse(template);
+  }
+  toString() {
+    return this.template;
+  }
+  parse(template) {
+    const parts = [];
+    let currentText = "";
+    let i = 0;
+    let expressionCount = 0;
+    while (i < template.length) {
+      if (template[i] === "{") {
+        if (currentText) {
+          parts.push(currentText);
+          currentText = "";
+        }
+        const end = template.indexOf("}", i);
+        if (end === -1)
+          throw new Error("Unclosed template expression");
+        expressionCount++;
+        if (expressionCount > MAX_TEMPLATE_EXPRESSIONS) {
+          throw new Error(`Template contains too many expressions (max ${MAX_TEMPLATE_EXPRESSIONS})`);
+        }
+        const expr = template.slice(i + 1, end);
+        const operator = this.getOperator(expr);
+        const exploded = expr.includes("*");
+        const names = this.getNames(expr);
+        const name = names[0];
+        for (const name2 of names) {
+          UriTemplate.validateLength(name2, MAX_VARIABLE_LENGTH, "Variable name");
+        }
+        parts.push({ name, operator, names, exploded });
+        i = end + 1;
+      } else {
+        currentText += template[i];
+        i++;
+      }
+    }
+    if (currentText) {
+      parts.push(currentText);
+    }
+    return parts;
+  }
+  getOperator(expr) {
+    const operators = ["+", "#", ".", "/", "?", "&"];
+    return operators.find((op) => expr.startsWith(op)) || "";
+  }
+  getNames(expr) {
+    const operator = this.getOperator(expr);
+    return expr.slice(operator.length).split(",").map((name) => name.replace("*", "").trim()).filter((name) => name.length > 0);
+  }
+  encodeValue(value, operator) {
+    UriTemplate.validateLength(value, MAX_VARIABLE_LENGTH, "Variable value");
+    if (operator === "+" || operator === "#") {
+      return encodeURI(value);
+    }
+    return encodeURIComponent(value);
+  }
+  expandPart(part, variables) {
+    if (part.operator === "?" || part.operator === "&") {
+      const pairs = part.names.map((name) => {
+        const value2 = variables[name];
+        if (value2 === undefined)
+          return "";
+        const encoded2 = Array.isArray(value2) ? value2.map((v2) => this.encodeValue(v2, part.operator)).join(",") : this.encodeValue(value2.toString(), part.operator);
+        return `${name}=${encoded2}`;
+      }).filter((pair) => pair.length > 0);
+      if (pairs.length === 0)
+        return "";
+      const separator = part.operator === "?" ? "?" : "&";
+      return separator + pairs.join("&");
+    }
+    if (part.names.length > 1) {
+      const values2 = part.names.map((name) => variables[name]).filter((v2) => v2 !== undefined);
+      if (values2.length === 0)
+        return "";
+      return values2.map((v2) => Array.isArray(v2) ? v2[0] : v2).join(",");
+    }
+    const value = variables[part.name];
+    if (value === undefined)
+      return "";
+    const values = Array.isArray(value) ? value : [value];
+    const encoded = values.map((v2) => this.encodeValue(v2, part.operator));
+    switch (part.operator) {
+      case "":
+        return encoded.join(",");
+      case "+":
+        return encoded.join(",");
+      case "#":
+        return "#" + encoded.join(",");
+      case ".":
+        return "." + encoded.join(".");
+      case "/":
+        return "/" + encoded.join("/");
+      default:
+        return encoded.join(",");
+    }
+  }
+  expand(variables) {
+    let result = "";
+    let hasQueryParam = false;
+    for (const part of this.parts) {
+      if (typeof part === "string") {
+        result += part;
+        continue;
+      }
+      const expanded = this.expandPart(part, variables);
+      if (!expanded)
+        continue;
+      if ((part.operator === "?" || part.operator === "&") && hasQueryParam) {
+        result += expanded.replace("?", "&");
+      } else {
+        result += expanded;
+      }
+      if (part.operator === "?" || part.operator === "&") {
+        hasQueryParam = true;
+      }
+    }
+    return result;
+  }
+  escapeRegExp(str) {
+    return str.replace(/[.*+?^${}()|[\]\\]/g, "\\$&");
+  }
+  partToRegExp(part) {
+    const patterns = [];
+    for (const name2 of part.names) {
+      UriTemplate.validateLength(name2, MAX_VARIABLE_LENGTH, "Variable name");
+    }
+    if (part.operator === "?" || part.operator === "&") {
+      for (let i = 0;i < part.names.length; i++) {
+        const name2 = part.names[i];
+        const prefix = i === 0 ? "\\" + part.operator : "&";
+        patterns.push({
+          pattern: prefix + this.escapeRegExp(name2) + "=([^&]+)",
+          name: name2
+        });
+      }
+      return patterns;
+    }
+    let pattern;
+    const name = part.name;
+    switch (part.operator) {
+      case "":
+        pattern = part.exploded ? "([^/,]+(?:,[^/,]+)*)" : "([^/,]+)";
+        break;
+      case "+":
+      case "#":
+        pattern = "(.+)";
+        break;
+      case ".":
+        pattern = "\\.([^/,]+)";
+        break;
+      case "/":
+        pattern = "/" + (part.exploded ? "([^/,]+(?:,[^/,]+)*)" : "([^/,]+)");
+        break;
+      default:
+        pattern = "([^/]+)";
+    }
+    patterns.push({ pattern, name });
+    return patterns;
+  }
+  match(uri) {
+    UriTemplate.validateLength(uri, MAX_TEMPLATE_LENGTH, "URI");
+    let pattern = "^";
+    const names = [];
+    for (const part of this.parts) {
+      if (typeof part === "string") {
+        pattern += this.escapeRegExp(part);
+      } else {
+        const patterns = this.partToRegExp(part);
+        for (const { pattern: partPattern, name } of patterns) {
+          pattern += partPattern;
+          names.push({ name, exploded: part.exploded });
+        }
+      }
+    }
+    pattern += "$";
+    UriTemplate.validateLength(pattern, MAX_REGEX_LENGTH, "Generated regex pattern");
+    const regex = new RegExp(pattern);
+    const match = uri.match(regex);
+    if (!match)
+      return null;
+    const result = {};
+    for (let i = 0;i < names.length; i++) {
+      const { name, exploded } = names[i];
+      const value = match[i + 1];
+      const cleanName = name.replace("*", "");
+      if (exploded && value.includes(",")) {
+        result[cleanName] = value.split(",");
+      } else {
+        result[cleanName] = value;
+      }
+    }
+    return result;
+  }
+}
+var MAX_TEMPLATE_LENGTH = 1e6, MAX_VARIABLE_LENGTH = 1e6, MAX_TEMPLATE_EXPRESSIONS = 1e4, MAX_REGEX_LENGTH = 1e6;
+
 // node_modules/@modelcontextprotocol/sdk/dist/esm/shared/toolNameValidation.js
 function validateToolName(name) {
   const warnings = [];
@@ -62564,6 +62837,22 @@ class McpServer {
     }
   }
 }
+
+class ResourceTemplate {
+  constructor(uriTemplate, _callbacks) {
+    this._callbacks = _callbacks;
+    this._uriTemplate = typeof uriTemplate === "string" ? new UriTemplate(uriTemplate) : uriTemplate;
+  }
+  get uriTemplate() {
+    return this._uriTemplate;
+  }
+  get listCallback() {
+    return this._callbacks.list;
+  }
+  completeCallback(variable) {
+    return this._callbacks.complete?.[variable];
+  }
+}
 function isZodTypeLike(value) {
   return value !== null && typeof value === "object" && "parse" in value && typeof value.parse === "function" && "safeParse" in value && typeof value.safeParse === "function";
 }
@@ -63827,8 +64116,6 @@ async function logResponse(logger, res, req) {
       logger.log(await res.clone().json());
       break;
     case (matchContentType(res, "application/jsonl") || jsonlLikeContentTypeRE.test(ct)):
-      logger.log(await res.clone().text());
-      break;
     case matchContentType(res, "text/event-stream"):
       logger.log(`<${contentType}>`);
       break;
@@ -63982,6 +64269,17 @@ function createRegisterResourceTemplate(logger, server, getSDK, allowedScopes) {
 }
 var init_resources = () => {};
 
+// src/mcp-server/apps/tool-hooks.ts
+function shouldForwardToolMeta(meta3, enabledUriPrefixes) {
+  if (!meta3)
+    return false;
+  const ui = meta3.ui;
+  const uri = ui && typeof ui.resourceUri === "string" ? ui.resourceUri : undefined;
+  if (!uri)
+    return true;
+  return enabledUriPrefixes.some((p) => uri.startsWith(p));
+}
+
 // src/mcp-server/tools.ts
 function buildAnnotationFilter(annotations) {
   const filter = {};
@@ -64013,7 +64311,8 @@ async function formatResult(response) {
   }
   return response.ok ? { content } : { content, isError: true };
 }
-function createRegisterTool(logger, server, getSDK, allowedScopes, allowedTools, dynamic, annotationFilter) {
+function createRegisterTool(logger, server, getSDK, allowedScopes, allowedTools, dynamic, annotationFilter, mcpApps) {
+  const enabledUris = enabledAppUriPrefixes(mcpApps ?? []);
   const tools = [];
   const toolMap = new Map;
   const registerTool = (tool) => {
@@ -64053,7 +64352,7 @@ function createRegisterTool(logger, server, getSDK, allowedScopes, allowedTools,
         description: tool.description,
         inputSchema: tool.args,
         annotations: tool.annotations,
-        ...tool._meta ? { _meta: tool._meta } : {}
+        ...shouldForwardToolMeta(tool._meta, enabledUris) ? { _meta: tool._meta } : {}
       }, async (args, ctx) => {
         return tool.tool(getSDK(), args, ctx);
       });
@@ -64061,7 +64360,7 @@ function createRegisterTool(logger, server, getSDK, allowedScopes, allowedTools,
       server.registerTool(tool.name, {
         description: tool.description,
         annotations: tool.annotations,
-        ...tool._meta ? { _meta: tool._meta } : {}
+        ...shouldForwardToolMeta(tool._meta, enabledUris) ? { _meta: tool._meta } : {}
       }, async (ctx) => {
         return tool.tool(getSDK(), ctx);
       });
@@ -64166,12 +64465,12 @@ function registerDynamicTools(logger, server, getSDK, toolMap, allowedScopes) {
 
 `) }] };
   });
-  logger.debug("Registered dynamic meta-tool", { name: "describe_tool" });
+  logger.debug("Registered dynamic meta-tool", { name: "describe_tool_input" });
   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.",
+    description: "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: string2().describe("The name of the tool to execute"),
-      input: record(string2(), unknown()).optional().describe("Input parameters for the tool as a JSON object")
+      name: string2().describe("The name of the tool to execute"),
+      arguments: looseObject({}).optional().describe("Arguments for the target tool as a JSON object, matching the schema returned by describe_tool_input.")
     },
     annotations: {
       title: "Execute Tool",
@@ -64181,16 +64480,16 @@ function registerDynamicTools(logger, server, getSDK, toolMap, allowedScopes) {
       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 = {};
     if (def.args) {
-      const vres = object(def.args).safeParse(args.input ?? {});
+      const vres = object(def.args).safeParse(args.arguments ?? {});
       if (vres.success) {
         validatedInput = vres.data;
       } else {
@@ -64198,7 +64497,7 @@ function registerDynamicTools(logger, server, getSDK, toolMap, allowedScopes) {
         return {
           content: [{
             type: "text",
-            text: `Invalid input for tool ${args.tool_name}:
+            text: `Invalid input for tool ${args.name}:
 <issues>
 ${issues}
 </issues>`
@@ -64218,7 +64517,7 @@ ${issues}
       return {
         content: [{
           type: "text",
-          text: `Error executing tool ${args.tool_name}: ${message}`
+          text: `Error executing tool ${args.name}: ${message}`
         }],
         isError: true
       };
@@ -64288,6 +64587,7 @@ var init_tools = __esm(() => {
   init_zod();
   init_core3();
   init_config();
+  init_config2();
   init_scopes();
   init_shared();
   VALID_ANNOTATIONS = [
@@ -64353,6 +64653,27 @@ function ERR2(error48) {
 }
 
 // src/lib/schemas.ts
+function collectExtraKeys(obj, extrasKey, optional3) {
+  return obj.transform((val) => {
+    const extras = {};
+    const { shape } = obj;
+    for (const [key] of Object.entries(val)) {
+      if (key in shape) {
+        continue;
+      }
+      const v2 = val[key];
+      if (typeof v2 === "undefined") {
+        continue;
+      }
+      extras[key] = v2;
+      delete val[key];
+    }
+    if (optional3 && Object.keys(extras).length === 0) {
+      return val;
+    }
+    return { ...val, [extrasKey]: extras };
+  });
+}
 function safeParse4(rawValue, fn, errorMessage) {
   try {
     return OK3(fn(rawValue));
@@ -64522,127 +64843,253 @@ var init_apierror = __esm(() => {
   });
 });
 
-// src/models/archivestoragetype.ts
-var ArchiveStorageType$zodSchema;
-var init_archivestoragetype = __esm(() => {
+// src/models/accesscontrolitem.ts
+var AccessType$zodSchema, Start$zodSchema, End$zodSchema, AccessControlItem$zodSchema;
+var init_accesscontrolitem = __esm(() => {
   init_zod();
-  ArchiveStorageType$zodSchema = _enum2([
+  AccessType$zodSchema = _enum2([
+    "token",
+    "anonymous"
+  ]).describe("The type of access control to apply to the asset.");
+  Start$zodSchema = union([
+    string2(),
+    int()
+  ]).describe("The start date and time when anonymous access becomes available. Accepts ISO 8601 string or Unix timestamp.");
+  End$zodSchema = union([
+    string2(),
+    int()
+  ]).describe("The end date and time when anonymous access expires. Accepts ISO 8601 string or Unix timestamp.");
+  AccessControlItem$zodSchema = object({
+    access_type: AccessType$zodSchema.describe("The type of access control to apply to the asset."),
+    end: union([
+      string2(),
+      int()
+    ]).optional().describe("The end date and time when anonymous access expires. Accepts ISO 8601 string or Unix timestamp."),
+    key: string2().optional().describe("The authentication key identifier for token-based access. Default key is used if not specified or if set to 'default'."),
+    start: union([
+      string2(),
+      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.");
+});
+
+// src/models/assetdeliverytype.ts
+var AssetDeliveryType$zodSchema;
+var init_assetdeliverytype = __esm(() => {
+  init_zod();
+  AssetDeliveryType$zodSchema = _enum2([
+    "asset"
+  ]).describe("Static asset delivery type.");
+});
+
+// src/models/fetchdeliverytype.ts
+var FetchDeliveryType$zodSchema;
+var init_fetchdeliverytype = __esm(() => {
+  init_zod();
+  FetchDeliveryType$zodSchema = _enum2([
+    "fetch",
+    "url2png"
+  ]).describe("Fetch-based delivery types for assets retrieved from remote URLs.");
+});
+
+// src/models/manageddeliverytype.ts
+var ManagedDeliveryType$zodSchema;
+var init_manageddeliverytype = __esm(() => {
+  init_zod();
+  ManagedDeliveryType$zodSchema = _enum2([
     "upload",
     "private",
-    "authenticated",
-    "fetch"
-  ]).describe("The storage type of resources to include in the archive.");
+    "authenticated"
+  ]).describe("Managed delivery types for assets uploaded and stored by Cloudinary.");
 });
 
-// src/models/resourcetype.ts
-var ResourceType$zodSchema;
-var init_resourcetype = __esm(() => {
+// src/models/socialdeliverytype.ts
+var SocialDeliveryType$zodSchema;
+var init_socialdeliverytype = __esm(() => {
   init_zod();
-  ResourceType$zodSchema = _enum2([
-    "image",
-    "video",
-    "raw"
-  ]).describe("The type of resource.");
+  SocialDeliveryType$zodSchema = _enum2([
+    "facebook",
+    "twitter",
+    "twitter_name",
+    "instagram",
+    "instagram_name",
+    "gravatar",
+    "youtube",
+    "hulu",
+    "vimeo",
+    "animoto",
+    "dailymotion",
+    "worldstarhiphop"
+  ]).describe("Delivery types for assets fetched from third-party platforms.");
+});
+
+// src/models/explicitdeliverytype.ts
+var ExplicitDeliveryType$zodSchema;
+var init_explicitdeliverytype = __esm(() => {
+  init_zod();
+  init_assetdeliverytype();
+  init_fetchdeliverytype();
+  init_manageddeliverytype();
+  init_socialdeliverytype();
+  ExplicitDeliveryType$zodSchema = union([
+    ManagedDeliveryType$zodSchema,
+    AssetDeliveryType$zodSchema,
+    FetchDeliveryType$zodSchema,
+    SocialDeliveryType$zodSchema
+  ]).describe("Delivery types accepted by the explicit operation.");
+});
+
+// src/models/responsivebreakpoint.ts
+var ResponsiveBreakpoint$zodSchema;
+var init_responsivebreakpoint = __esm(() => {
+  init_zod();
+  ResponsiveBreakpoint$zodSchema = object({
+    bytes_step: int().optional().describe("The minimum byte size difference between consecutive breakpoint images."),
+    create_derived: boolean2().optional().describe("Whether to generate and store the derived images. Default is true."),
+    max_images: int().optional().describe("The maximum number of breakpoint images to generate."),
+    max_width: int().optional().describe("The maximum width for responsive breakpoint images."),
+    min_width: int().optional().describe("The minimum width for responsive breakpoint images."),
+    transformation: string2().optional().describe("A transformation string to apply before generating breakpoints.")
+  });
 });
 
-// src/models/uploadresponse.ts
-var UploadResponseImageMetadata$zodSchema, Eager$zodSchema, UploadResponse$zodSchema;
-var init_uploadresponse = __esm(() => {
+// src/models/structuredmetadatavalue.ts
+var StructuredMetadataValue$zodSchema;
+var init_structuredmetadatavalue = __esm(() => {
   init_zod();
-  UploadResponseImageMetadata$zodSchema = object({}).describe("The image metadata of the uploaded file.");
-  Eager$zodSchema = object({
-    bytes: int().optional(),
-    format: string2().optional(),
-    height: int().optional(),
-    secure_url: string2().optional(),
-    transformation: string2().optional(),
-    url: string2().optional(),
-    width: int().optional()
-  });
-  UploadResponse$zodSchema = object({
-    api_key: string2().optional().describe("The API key used to upload the file."),
-    asset_id: string2().optional().describe("The asset ID of the uploaded file. This is the ID of the uploaded file in the Cloudinary database."),
-    bytes: int().optional().describe("The size of the uploaded file in bytes."),
-    created_at: string2().optional().describe("The date and time the file was uploaded."),
-    eager: array(lazy(() => Eager$zodSchema)).optional(),
-    etag: string2().optional().describe("The ETag of the uploaded file."),
-    format: string2().optional().describe("The format of the uploaded file."),
-    grayscale: boolean2().optional().describe("Whether the uploaded file is grayscale."),
-    height: int().optional().describe("The height of the uploaded file."),
-    illustration_score: number2().optional().describe("The illustration score of the uploaded file."),
-    image_metadata: lazy(() => UploadResponseImageMetadata$zodSchema).optional().describe("The image metadata of the uploaded file."),
-    original_filename: string2().optional().describe("The original filename of the uploaded file."),
-    pages: int().optional().describe("The number of pages in the uploaded file."),
-    placeholder: boolean2().optional().describe("Whether the uploaded file is a placeholder."),
-    public_id: string2().optional().describe("The public ID of the uploaded file."),
-    resource_type: string2().optional().describe("The type of resource that was uploaded."),
-    secure_url: string2().optional().describe("The secure URL of the uploaded file."),
-    semi_transparent: boolean2().optional().describe("Whether the uploaded file is semi-transparent."),
-    signature: string2().optional().describe("The signature of the uploaded file."),
-    tags: array(string2()).optional().describe("The tags of the uploaded file."),
-    type: string2().optional().describe("The type of the uploaded file."),
-    url: string2().optional().describe("The URL of the uploaded file."),
-    version: int().optional().describe("The version of the uploaded file."),
-    version_id: string2().optional().describe("The version ID of the uploaded file."),
-    width: int().optional().describe("The width of the uploaded file.")
-  });
+  StructuredMetadataValue$zodSchema = union([
+    string2(),
+    int(),
+    array(string2())
+  ]);
 });
 
-// src/models/explicitassetop.ts
-var ExplicitAssetGlobals$zodSchema, ExplicitAssetAutoTranscription$zodSchema, ExplicitAssetAutoTranscriptionUnion$zodSchema, ExplicitAssetResponsiveBreakpoint$zodSchema, QualityOverride$zodSchema, ExplicitAssetRequestBody$zodSchema, ExplicitAssetRequest$zodSchema, ExplicitAssetResponse$zodSchema;
-var init_explicitassetop = __esm(() => {
+// src/models/structuredmetadataparam.ts
+var StructuredMetadataParam$zodSchema;
+var init_structuredmetadataparam = __esm(() => {
   init_zod();
-  init_apierror();
-  init_archivestoragetype();
-  init_resourcetype();
-  init_uploadresponse();
-  ExplicitAssetGlobals$zodSchema = object({
-    cloud_name: string2().describe("The cloud name of your product environment.").optional()
-  });
-  ExplicitAssetAutoTranscription$zodSchema = object({
+  init_structuredmetadatavalue();
+  StructuredMetadataParam$zodSchema = union([
+    string2(),
+    record(string2(), StructuredMetadataValue$zodSchema)
+  ]).describe(`A pipe-separated list or a map of custom metadata fields (by external_id) and the values to assign to each of them. The = " and | characters can be supported as values when escaped with a prepended backslash (\\). For a multi-select field, you can set a maximum of 3000 different metadata values on an asset.
+`);
+});
+
+// src/models/tagsparam.ts
+var TagsParam$zodSchema;
+var init_tagsparam = __esm(() => {
+  init_zod();
+  TagsParam$zodSchema = union([
+    string2(),
+    array(string2())
+  ]).describe("A comma-separated list of tag names, or an array of tag names.");
+});
+
+// src/models/explicitrequest.ts
+var ExplicitRequestAutoTranscription$zodSchema, ExplicitRequestAutoTranscriptionUnion$zodSchema, ExplicitRequestAccessMode$zodSchema, ExplicitRequestRegions$zodSchema, ExplicitRequestResponsiveBreakpoints$zodSchema, QualityOverride$zodSchema, ExplicitRequest$zodSchema;
+var init_explicitrequest = __esm(() => {
+  init_zod();
+  init_accesscontrolitem();
+  init_explicitdeliverytype();
+  init_responsivebreakpoint();
+  init_structuredmetadataparam();
+  init_tagsparam();
+  ExplicitRequestAutoTranscription$zodSchema = object({
     translate: array(string2()).optional().describe("Array of target language codes for transcription translation.")
   }).describe("Configuration object for automatic video transcription with translation options.");
-  ExplicitAssetAutoTranscriptionUnion$zodSchema = union([
+  ExplicitRequestAutoTranscriptionUnion$zodSchema = union([
     boolean2(),
-    lazy(() => ExplicitAssetAutoTranscription$zodSchema)
+    lazy(() => ExplicitRequestAutoTranscription$zodSchema)
   ]);
-  ExplicitAssetResponsiveBreakpoint$zodSchema = object({
-    bytes_step: int().optional(),
-    create_derived: boolean2().optional(),
-    max_images: int().optional(),
-    max_width: int().optional(),
-    min_width: int().optional(),
-    transformation: string2().optional()
-  });
+  ExplicitRequestAccessMode$zodSchema = _enum2([
+    "public",
+    "authenticated"
+  ]).describe(`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.
+`);
+  ExplicitRequestRegions$zodSchema = union([
+    string2(),
+    record(string2(), array(array(int())))
+  ]).describe(`Named region coordinate groups for cropping with region gravity.
+Can be a JSON-encoded string or an object. Each region name may contain
+only letters, numbers, or hyphens, and must have at least two coordinate pairs.
+`);
+  ExplicitRequestResponsiveBreakpoints$zodSchema = union([
+    array(ResponsiveBreakpoint$zodSchema),
+    ResponsiveBreakpoint$zodSchema
+  ]).describe("Settings to automatically generate breakpoints for responsive images.");
   QualityOverride$zodSchema = union([
     string2(),
     int()
   ]).describe("Override the quality setting for this asset.");
-  ExplicitAssetRequestBody$zodSchema = object({
-    accessibility_analysis: boolean2().optional().describe("Whether to return return accessibility analysis values for the image."),
-    api_key: string2().optional().describe("The API key to use for the request. This is automatically computed by the Cloudinary's SDKs."),
+  ExplicitRequest$zodSchema = object({
+    access_control: array(AccessControlItem$zodSchema).optional().describe(`Restricts access to the asset by specifying one or more access types.
+The asset is restricted unless at least one listed access type is valid.
+`),
+    access_mode: ExplicitRequestAccessMode$zodSchema.optional().describe(`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.
+`),
+    accessibility_analysis: boolean2().optional().describe("Whether to return accessibility analysis values for the image."),
+    allowed_formats: string2().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 won't be converted.\n"),
     asset_folder: string2().optional().describe("The asset folder to assign to the asset."),
     async: boolean2().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.
 `),
     auto_chaptering: boolean2().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: number2().optional().describe(`Automatically assigns tags to an asset according to detected objects or categories with a confidence score higher than the specified value.
+Use together with the detection parameter for:
+- Cloudinary AI Content Analysis
+- Amazon Rekognition Celebrity Detection
+Use together with the categorization parameter for:
+- Google Automatic Video Tagging
+- Google Auto Tagging
+- Imagga Auto Tagging
+- Amazon Rekognition Auto Tagging
+`),
     auto_transcription: union([
       boolean2(),
-      lazy(() => ExplicitAssetAutoTranscription$zodSchema)
+      lazy(() => ExplicitRequestAutoTranscription$zodSchema)
     ]).optional(),
+    background_removal: string2().optional().describe(`Automatically remove the background of an image using an add-on.
+- Set to cloudinary_ai to use the deep-learning based Cloudinary AI Background Removal add-on.
+  Optionally append a template suffix (e.g., cloudinary_ai:fine_edges).
+- Note: this feature has been superseded by background removal on the fly.
+- Set to pixelz to use the human-powered Pixelz Remove-The-Background Editing add-on service.
+Relevant for images only.
+`),
+    backup: boolean2().optional().describe("Whether to backup the uploaded asset. When set to true, backs up uploaded assets to a secondary storage bucket."),
     callback: string2().optional().describe(`A URL to redirect to after the upload/explicit is completed instead of returning the upload response.
 Signed upload result parameters are added to the callback URL. This parameter is ignored for XHR (Ajax XMLHttpRequest) or JavaScript Fetch API upload requests.
 Note: 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.
+`),
+    categorization: string2().optional().describe(`A comma-separated list of the categorization add-ons to run on the asset.
+Set to google_tagging, google_video_tagging, imagga_tagging and/or aws_rek_tagging
+to automatically classify the scenes of the uploaded asset.
+Optionally append a language code suffix (e.g., google_tagging:fr).
 `),
     cinemagraph_analysis: boolean2().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."),
+    clear_invalid: boolean2().default(false).describe("Whether to clear metadata field values that have become invalid due to a change in metadata rules. If false, the API returns an error if any existing metadata value is no longer valid. Default: false."),
     colors: boolean2().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: string2().optional().describe("Key-value pairs of general textual context metadata to attach to the asset."),
-    custom_coordinates: string2().optional().describe("An array of coordinates for custom cropping."),
+    context: string2().optional().describe('A pipe-separated list of key-value pairs of general textual context metadata to attach to the asset (e.g., "alt=My image|caption=Nice photo"). The =, ", and | characters can be escaped with a prepending backslash (\\).'),
+    custom_coordinates: string2().optional().describe("Custom coordinates as comma-separated values, with multiple coordinates separated by pipes."),
+    detection: string2().optional().describe(`Invokes the relevant add-on to return a list of detected content.
+Set to:
+- <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.
+- captioning to analyze an image and suggest a caption based on the image's contents.
+- iqa to analyze the quality of an image.
+- watermark-detection to detect watermarks in an image.
+- adv_face to return a list of facial attributes using the Advanced Facial Attribute Detection add-on.
+- 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.
+`),
+    discard_original_filename: boolean2().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: string2().optional().describe("A display name for the asset."),
     eager: string2().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: boolean2().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: string2().optional().describe("A URL to notify when eager transformations are completed."),
-    face_coordinates: string2().optional().describe("An array of coordinates representing detected faces in the asset, used for custom cropping or overlays."),
+    eval: string2().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: string2().optional().describe("Face coordinates as comma-separated values, with multiple faces separated by pipes."),
     faces: boolean2().optional().describe("Whether to detect faces in the asset."),
+    filename_override: string2().optional().describe("Overrides the originally uploaded asset's file name in downloads that use flags like fl_attachment or fl_force_original."),
+    folder: string2().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: string2().optional().describe("An optional format to convert the uploaded asset to before saving in the cloud."),
     headers: string2().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.
 `),
     invalidate: boolean2().optional().describe(`Whether to invalidate CDN cache copies of a previously uploaded asset that shares the same public ID. Default: false.
@@ -64653,7 +65100,8 @@ Supported for images, video, and audio.
 - Returned metadata for audio and video includes: audio_codec, audio_bit_rate, audio_frequency, channels, channel_layout.
 - Additional metadata for video includes: pix_format, codec, level, profile, video_bit_rate, dar.
 `),
-    metadata: string2().optional().describe("Structured metadata to attach to the asset based on the metadata fields defined for your account."),
+    metadata: StructuredMetadataParam$zodSchema.optional().describe(`A pipe-separated list or a map of custom metadata fields (by external_id) and the values to assign to each of them. The = " and | characters can be supported as values when escaped with a prepended backslash (\\). For a multi-select field, you can set a maximum of 3000 different metadata values on an asset.
+`),
     moderation: string2().optional().describe(`For all asset types, set to:
 - manual to add the uploaded asset to a list of pending assets that can be moderated using the Admin API or the Cloudinary Console.
 - perception_point to automatically moderate the uploaded asset using the Perception Point Malware Detection add-on.
@@ -64673,28 +65121,163 @@ To request multiple moderations in a single API call:
 Note: Rejected assets are automatically invalidated on the CDN within approximately ten minutes.
 `),
     notification_url: string2().optional().describe("A URL to notify when the asset is ready."),
+    ocr: string2().optional().describe(`Set to adv_ocr to extract all text elements in an image as well as the bounding box
+coordinates of each detected element using the OCR text detection and extraction add-on.
+Optionally append options (e.g., adv_ocr:document).
+`),
+    on_success: string2().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: boolean2().optional().describe(`When applying eager for already existing video transformations, this setting indicates whether to force the existing derived video resources to be regenerated. Default for videos: false.
 Note: When specifying existing eager transformations for images, corresponding derived images are always regenerated.
 `),
     phash: boolean2().optional().describe(`Whether to return the perceptual hash (pHash) on the uploaded image for image similarity detection.
 `),
+    proxy: string2().optional().describe("A proxy to use for fetching remote URLs. The format should be http://hostname:port."),
     public_id: string2().describe("The public ID of the existing asset to apply operations on."),
+    public_id_prefix: string2().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: boolean2().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."),
     quality_override: union([
       string2(),
       int()
     ]).optional().describe("Override the quality setting for this asset."),
-    regions: string2().optional().describe("Regions to detect in the asset."),
-    responsive_breakpoints: array(lazy(() => ExplicitAssetResponsiveBreakpoint$zodSchema)).optional().describe("Settings to automatically generate breakpoints for responsive images."),
-    signature: string2().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.
+    raw_convert: string2().optional().describe(`Generates a related file based on the uploaded file.
+- 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)
+- 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)
+- 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)
+- Set to azure_video_indexer to generate AI-powered video insights from Microsoft Azure. (Asynchronous)
 `),
-    tags: string2().optional().describe("A comma-separated list of tag names to assign to the asset."),
-    timestamp: int().optional().describe("The timestamp to use for the request in unix time. This is automatically computed by the Cloudinary's SDKs."),
-    type: ArchiveStorageType$zodSchema.optional().describe("The storage type of resources to include in the archive.")
+    regions: union([
+      string2(),
+      record(string2(), array(array(int())))
+    ]).optional().describe(`Named region coordinate groups for cropping with region gravity.
+Can be a JSON-encoded string or an object. Each region name may contain
+only letters, numbers, or hyphens, and must have at least two coordinate pairs.
+`),
+    responsive_breakpoints: union([
+      array(ResponsiveBreakpoint$zodSchema),
+      ResponsiveBreakpoint$zodSchema
+    ]).optional().describe("Settings to automatically generate breakpoints for responsive images."),
+    return_delete_token: boolean2().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."),
+    tags: TagsParam$zodSchema.optional().describe("A comma-separated list of tag names, or an array of tag names."),
+    transformation: string2().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: ExplicitDeliveryType$zodSchema.optional().describe("Delivery types accepted by the explicit operation."),
+    unique_display_name: boolean2().optional().describe("Whether the display name should be unique."),
+    unique_filename: boolean2().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).
+`),
+    upload_preset: string2().optional().describe("Name 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."),
+    use_asset_folder_as_public_id_prefix: boolean2().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: boolean2().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.
+`),
+    use_filename_as_display_name: boolean2().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: boolean2().optional().describe("Whether to index the image for use with visual searches. Relevant for images only.")
+  }).describe("Common parameters for configuring an asset, including transformation, tagging, metadata, and moderation options.");
+});
+
+// src/models/resourcetype.ts
+var ResourceType$zodSchema;
+var init_resourcetype = __esm(() => {
+  init_zod();
+  ResourceType$zodSchema = _enum2([
+    "image",
+    "video",
+    "raw"
+  ]).describe("The type of resource.");
+});
+
+// src/models/contextfullresponse.ts
+var ContextFullResponse$zodSchema, ContextFullResponse$zodSchemaOutbound;
+var init_contextfullresponse = __esm(() => {
+  init_zod();
+  init_schemas4();
+  ContextFullResponse$zodSchema = collectExtraKeys(object({
+    custom: record(string2(), string2()).optional().describe("User-defined contextual metadata as key-value pairs.")
+  }).describe("Contextual metadata grouped by kind. Custom user context appears under the 'custom' key. Other context kinds may also appear as additional keys.").catchall(record(string2(), string2())), "AdditionalProperties", true);
+  ContextFullResponse$zodSchemaOutbound = object({
+    AdditionalProperties: record(string2(), record(string2(), string2())).optional(),
+    custom: record(string2(), string2()).optional()
+  }).describe("Contextual metadata grouped by kind. Custom user context appears under the 'custom' key. Other context kinds may also appear as additional keys.").transform((v2) => {
+    const { AdditionalProperties, ...rest } = v2;
+    return {
+      ...rest,
+      ...AdditionalProperties
+    };
+  });
+});
+
+// src/models/coordinatesresponse.ts
+var CoordinatesResponse$zodSchema;
+var init_coordinatesresponse = __esm(() => {
+  init_zod();
+  CoordinatesResponse$zodSchema = object({
+    custom: array(array(number2())).optional().describe("Custom coordinate rectangles [x, y, width, height]."),
+    faces: array(array(int())).optional().describe("Detected face coordinate rectangles [x, y, width, height].")
+  }).describe("Coordinate data for faces and custom regions.");
+});
+
+// src/models/uploadresponse.ts
+var UploadResponseImageMetadata$zodSchema, Eager$zodSchema, UploadResponse$zodSchema;
+var init_uploadresponse = __esm(() => {
+  init_zod();
+  init_contextfullresponse();
+  init_coordinatesresponse();
+  UploadResponseImageMetadata$zodSchema = object({}).describe("The image metadata of the uploaded file.");
+  Eager$zodSchema = object({
+    bytes: int().optional(),
+    format: string2().optional(),
+    height: int().optional(),
+    secure_url: string2().optional(),
+    transformation: string2().optional(),
+    url: string2().optional(),
+    width: int().optional()
+  });
+  UploadResponse$zodSchema = object({
+    api_key: string2().optional().describe("The API key used to upload the file."),
+    asset_folder: string2().nullable().optional().describe("The asset folder where the file is stored."),
+    asset_id: string2().optional().describe("A 32-character hexadecimal asset ID."),
+    bytes: int().optional().describe("The size of the uploaded file in bytes."),
+    context: ContextFullResponse$zodSchema.nullable().optional().describe("Contextual metadata grouped by kind. Custom user context appears under the 'custom' key. Other context kinds may also appear as additional keys."),
+    coordinates: CoordinatesResponse$zodSchema.nullable().optional().describe("Coordinate data for faces and custom regions."),
+    created_at: exports_iso.datetime({ offset: true }).optional().describe("The date and time the file was uploaded."),
+    display_name: string2().optional().describe("The display name of the uploaded file."),
+    eager: array(lazy(() => Eager$zodSchema)).optional(),
+    etag: string2().optional().describe("The ETag of the uploaded file."),
+    faces: array(array(int())).nullable().optional().describe("Detected face coordinate rectangles [x, y, width, height]."),
+    format: string2().optional().describe("The format of the uploaded file."),
+    grayscale: boolean2().optional().describe("Whether the uploaded file is grayscale."),
+    height: int().optional().describe("The height of the uploaded file."),
+    illustration_score: number2().optional().describe("The illustration score of the uploaded file."),
+    image_metadata: lazy(() => UploadResponseImageMetadata$zodSchema).optional().describe("The image metadata of the uploaded file."),
+    metadata: record(string2(), any()).optional().describe("Structured metadata associated with the uploaded file."),
+    original_filename: string2().optional().describe("The original filename of the uploaded file."),
+    pages: int().optional().describe("The number of pages in the uploaded file."),
+    placeholder: boolean2().optional().describe("Whether the uploaded file is a placeholder."),
+    public_id: string2().optional().describe("The public ID of the uploaded file."),
+    resource_type: string2().optional().describe("The type of resource that was uploaded."),
+    secure_url: string2().optional().describe("The secure URL of the uploaded file."),
+    semi_transparent: boolean2().optional().describe("Whether the uploaded file is semi-transparent."),
+    signature: string2().optional().describe("The signature of the uploaded file."),
+    tags: array(string2()).nullable().optional().describe("Tag names assigned to the asset."),
+    type: string2().optional().describe("The type of the uploaded file."),
+    url: string2().optional().describe("The URL of the uploaded file."),
+    version: int().optional().describe("The version of the uploaded file."),
+    version_id: string2().optional().describe("Hexadecimal version ID; length is a positive multiple of 32 (typically 32 or 64)."),
+    width: int().optional().describe("The width of the uploaded file.")
+  });
+});
+
+// src/models/explicitassetop.ts
+var ExplicitAssetGlobals$zodSchema, ExplicitAssetRequest$zodSchema, ExplicitAssetResponse$zodSchema;
+var init_explicitassetop = __esm(() => {
+  init_zod();
+  init_apierror();
+  init_explicitrequest();
+  init_resourcetype();
+  init_uploadresponse();
+  ExplicitAssetGlobals$zodSchema = object({
+    cloud_name: string2().describe("The cloud name of your product environment.").optional()
   });
   ExplicitAssetRequest$zodSchema = object({
-    RequestBody: lazy(() => ExplicitAssetRequestBody$zodSchema),
-    resource_type: ResourceType$zodSchema.describe("The type of resource.")
+    explicit_request: ExplicitRequest$zodSchema.describe("The asset and operations to apply."),
+    resource_type: ResourceType$zodSchema.describe("The type of resource (image, video, or raw).")
   });
   ExplicitAssetResponse$zodSchema = union([
     ApiError$zodSchema,
@@ -64729,20 +65312,22 @@ var init_async = __esm(() => {
 });
 
 // src/funcs/assetsExplicitAsset.ts
-function assetsExplicitAsset(client$, resource_type, RequestBody, options) {
-  return new APIPromise($do(client$, resource_type, RequestBody, options));
+function assetsExplicitAsset(client$, resource_type, explicit_request, options) {
+  return new APIPromise($do(client$, resource_type, explicit_request, options));
 }
-async function $do(client$, resource_type, RequestBody, options) {
+async function $do(client$, resource_type, explicit_request, options) {
   const input$ = {
     resource_type,
-    RequestBody
+    explicit_request
   };
   const parsed$ = safeParse4(input$, (value$) => ExplicitAssetRequest$zodSchema.parse(value$), "Input validation failed");
   if (!parsed$.ok) {
     return [parsed$, { status: "invalid" }];
   }
   const payload$ = parsed$.value;
-  const body$ = encodeJSON("body", payload$.RequestBody, { explode: true });
+  const body$ = encodeJSON("body", payload$.explicit_request, {
+    explode: true
+  });
   const pathParams$ = {
     cloud_name: encodeSimple("cloud_name", client$._options.cloud_name, {
       explode: false,
@@ -64815,94 +65400,138 @@ var init_assetsExplicitAsset = __esm(() => {
   init_async();
 });
 
-// src/models/accesscontrolitem.ts
-var AccessType$zodSchema, AccessControlItem$zodSchema;
-var init_accesscontrolitem = __esm(() => {
+// src/models/generateddeliverytype.ts
+var GeneratedDeliveryType$zodSchema;
+var init_generateddeliverytype = __esm(() => {
   init_zod();
-  AccessType$zodSchema = _enum2([
-    "token",
-    "anonymous"
-  ]).describe("The type of access control to apply to the asset.");
-  AccessControlItem$zodSchema = object({
-    access_type: AccessType$zodSchema.describe("The type of access control to apply to the asset."),
-    end: string2().optional().describe("The end date and time when anonymous access expires (ISO 8601 format)."),
-    key: string2().optional().describe("The authentication key identifier for token-based access. Default key is used if not specified or if set to 'default'."),
-    start: string2().optional().describe("The start date and time when anonymous access becomes available (ISO 8601 format).")
-  }).describe("Access control rule that defines when and how the asset can be accessed.");
+  GeneratedDeliveryType$zodSchema = _enum2([
+    "multi",
+    "sprite",
+    "text",
+    "list"
+  ]).describe("Delivery types for assets generated by Cloudinary operations.");
+});
+
+// src/models/deliverytypeall.ts
+var DeliveryTypeAllEnum$zodSchema, DeliveryTypeAll$zodSchema;
+var init_deliverytypeall = __esm(() => {
+  init_zod();
+  init_assetdeliverytype();
+  init_fetchdeliverytype();
+  init_generateddeliverytype();
+  init_manageddeliverytype();
+  init_socialdeliverytype();
+  DeliveryTypeAllEnum$zodSchema = _enum2([
+    "media_optimization"
+  ]);
+  DeliveryTypeAll$zodSchema = union([
+    ManagedDeliveryType$zodSchema,
+    AssetDeliveryType$zodSchema,
+    FetchDeliveryType$zodSchema,
+    SocialDeliveryType$zodSchema,
+    GeneratedDeliveryType$zodSchema,
+    DeliveryTypeAllEnum$zodSchema
+  ]).describe("All supported delivery types.");
 });
 
 // src/models/info.ts
-var InfoContext2$zodSchema, InfoContext1$zodSchema, Context$zodSchema, Moderation$zodSchema, RelatedAsset$zodSchema, Derivative$zodSchema, Info$zodSchema;
+var InfoModeration$zodSchema, RelatedAsset$zodSchema, LastUpdated$zodSchema, Derived$zodSchema, Version$zodSchema, InfoInfo$zodSchema, Derivative$zodSchema, Info$zodSchema;
 var init_info = __esm(() => {
   init_zod();
   init_accesscontrolitem();
-  InfoContext2$zodSchema = object({
-    key: string2().optional(),
-    value: string2().optional()
-  });
-  InfoContext1$zodSchema = object({
-    custom: record(string2(), any()).optional()
-  });
-  Context$zodSchema = union([
-    lazy(() => InfoContext1$zodSchema),
-    array(lazy(() => InfoContext2$zodSchema))
-  ]).describe("Included if 'context=true' parameter is used. Can be object with custom properties or array of key-value pairs.");
-  Moderation$zodSchema = object({
+  init_contextfullresponse();
+  init_coordinatesresponse();
+  init_deliverytypeall();
+  InfoModeration$zodSchema = object({
     kind: string2().optional(),
     status: string2().optional(),
     updated_at: exports_iso.datetime({ offset: true }).optional()
   });
   RelatedAsset$zodSchema = object({});
+  LastUpdated$zodSchema = object({
+    access_control_updated_at: exports_iso.datetime({ offset: true }).optional(),
+    context_updated_at: exports_iso.datetime({ offset: true }).optional(),
+    metadata_updated_at: exports_iso.datetime({ offset: true }).optional(),
+    public_id_updated_at: exports_iso.datetime({ offset: true }).optional(),
+    tags_updated_at: exports_iso.datetime({ offset: true }).optional(),
+    updated_at: exports_iso.datetime({ offset: true }).optional()
+  });
+  Derived$zodSchema = object({
+    bytes: int().optional(),
+    format: string2().optional(),
+    id: string2().optional(),
+    secure_url: string2().optional(),
+    transformation: string2().optional(),
+    url: string2().optional()
+  });
+  Version$zodSchema = object({
+    format: string2().nullable().optional(),
+    restorable: boolean2().optional(),
+    size: int().optional(),
+    time: exports_iso.datetime({ offset: true }).optional(),
+    version: string2().optional(),
+    version_id: string2().optional().describe("Hexadecimal version ID; length is a positive multiple of 32 (typically 32 or 64).")
+  });
+  InfoInfo$zodSchema = object({}).describe("Additional asset information (visual search, recognized people, etc.)");
   Derivative$zodSchema = object({
-    id: string2().optional().describe("The unique identifier of the derived resource"),
-    secure_url: string2().optional().describe("The secure URL for accessing the derived resource"),
-    transformation: string2().optional().describe("The transformation string that was applied"),
-    transformation_signature: string2().optional().describe("The unique signature of the transformation")
+    id: string2().optional().describe("The unique identifier of the derived resource."),
+    secure_url: string2().optional().describe("The secure URL for accessing the derived resource."),
+    transformation: string2().optional().describe("The transformation string that was applied."),
+    transformation_signature: string2().optional().describe("The unique signature of the transformation.")
   });
   Info$zodSchema = object({
     access_control: array(AccessControlItem$zodSchema).nullable().optional(),
     animated: boolean2().nullable().optional().describe("Whether the asset is animated (e.g., GIF, animated WebP). Null for non-animated assets."),
     aspect_ratio: number2().nullable().optional(),
     asset_folder: string2().optional(),
-    asset_id: string2().optional(),
+    asset_id: string2().optional().describe("A 32-character hexadecimal asset ID."),
     backup: boolean2().optional(),
     backup_bytes: int().optional(),
     bytes: int().optional(),
-    context: union([
-      lazy(() => InfoContext1$zodSchema),
-      array(lazy(() => InfoContext2$zodSchema))
-    ]).nullable().optional().describe("Included if 'context=true' parameter is used. Can be object with custom properties or array of key-value pairs."),
+    colors: array(array(any())).optional(),
+    context: ContextFullResponse$zodSchema.nullable().optional().describe("Included if 'context=true' parameter is used."),
+    coordinates: CoordinatesResponse$zodSchema.nullable().optional().describe("Face and custom coordinate data. Included if 'coordinates=true' parameter is used."),
     created_at: exports_iso.datetime({ offset: true }).optional(),
     derivatives: array(lazy(() => Derivative$zodSchema)).nullable().optional().describe("Included if 'derived=true' parameter is used. Null when no derivatives exist."),
+    derived: array(lazy(() => Derived$zodSchema)).optional(),
     display_name: string2().optional(),
     duration: number2().nullable().optional().describe("Duration in seconds for video/audio assets. Null for images."),
     etag: string2().optional(),
+    faces: array(array(int())).nullable().optional().describe("Detected face rectangles. Included if 'faces=true' parameter is used."),
     filename: string2().optional(),
     folder: string2().optional(),
     format: string2().optional(),
+    grayscale: boolean2().optional(),
     height: int().nullable().optional(),
+    illustration_score: number2().optional(),
+    info: lazy(() => InfoInfo$zodSchema).optional().describe("Additional asset information (visual search, recognized people, etc.)"),
+    last_updated: lazy(() => LastUpdated$zodSchema).nullable().optional(),
     metadata: record(string2(), any()).optional(),
-    moderation: array(lazy(() => Moderation$zodSchema)).optional().describe("Included if 'moderations=true' parameter is used."),
+    moderation: array(lazy(() => InfoModeration$zodSchema)).optional().describe("Included if 'moderations=true' parameter is used."),
     moderation_kind: string2().optional().describe("The type of moderation applied to the asset."),
     moderation_status: string2().optional().describe("The current status of the moderation process for the asset."),
+    next_cursor: string2().optional().describe("Cursor for paginating derived assets."),
     pixels: int().nullable().optional(),
+    predominant: record(string2(), array(array(any()))).optional(),
     public_id: string2().optional(),
     related_assets: array(lazy(() => RelatedAsset$zodSchema)).nullable().optional().describe("Related assets linked to this resource. Null when none linked."),
     resource_subtype: string2().nullable().optional().describe("The subtype of the resource (e.g., for video). Null when not applicable."),
     resource_type: string2().optional(),
     secure_url: string2().optional(),
+    semi_transparent: boolean2().optional(),
     status: string2().optional(),
     substatus: string2().nullable().optional().describe("The substatus of the resource. Null when not set."),
     tags: array(string2()).nullable().optional().describe("Included if 'tags=true' parameter is used."),
-    type: string2().optional(),
+    type: DeliveryTypeAll$zodSchema.optional().describe("All supported delivery types."),
     uploaded_at: exports_iso.datetime({ offset: true }).optional(),
     url: string2().optional(),
     version: int().optional(),
+    versions: array(lazy(() => Version$zodSchema)).optional(),
     width: int().nullable().optional()
   });
 });
 
-// src/mcp-server/widgets/widget-shared.ts
+// src/mcp-server/apps/app-shared.ts
 function extractSchemaDescriptions(schema) {
   const props = schema.properties || {};
   const result = {};
@@ -65256,7 +65885,7 @@ details.detail-section > summary.detail-section-title::-webkit-details-marker {
 .media-modal-audio-wrap audio { width: 100%; max-width: 480px; }
 .thumb-overlay.playable { pointer-events: auto; cursor: pointer; }
 
-/* Upload widget */
+/* Upload app */
 .upload-zone {
   border: 2px dashed var(--cld-border2); border-radius: var(--cld-radius);
   padding: 40px 24px; text-align: center; cursor: pointer;
@@ -66878,7 +67507,7 @@ function setupResize(app, minHeight) {
   report();
 }
 `, SHARED_JS_TOOLTIPS;
-var init_widget_shared = __esm(() => {
+var init_app_shared = __esm(() => {
   init_zod();
   init_info();
   init_uploadresponse();
@@ -66903,11 +67532,11 @@ function tip(key) {
 `;
 });
 
-// src/mcp-server/widgets/asset-gallery-widget.ts
-function getAssetGalleryHtml() {
-  return ASSET_GALLERY_HTML;
+// src/mcp-server/apps/asset-gallery-app.ts
+function getAssetGalleryHtml(toolName) {
+  return injectToolName(ASSET_GALLERY_HTML, toolName);
 }
-var ASSET_GALLERY_RESOURCE_URI = "ui://cloudinary/asset-gallery.html", MCP_APP_MIME_TYPE = "text/html;profile=mcp-app", GALLERY_CSS = `
+var GALLERY_CSS = `
 /* ── Header ── */
 .header {
   display: flex; align-items: center; justify-content: space-between;
@@ -67183,7 +67812,10 @@ var LOG_PREFIX = "[gallery]";
 var MIN_HEIGHT = 120;
 var allResources = [];
 var lastCursor = null;
-var pendingCall = { name: null, args: null };
+var pendingCall = {
+  name: (typeof window.__MCP_TOOL_NAME__ === "string" && window.__MCP_TOOL_NAME__) || null,
+  args: null,
+};
 var selected = new Set();
 var filterQuery = "";
 var aspectFilter = "";
@@ -67795,23 +68427,23 @@ app.ontoolcancelled = function(params) {
   showCancelledPrompt(pendingCall, fetchDirect);
 };
 
-function inferToolName(data) {
-  if (data.total_count !== undefined) return "search-assets";
-  var resources = data.resources;
-  if (!resources || !resources.length) return null;
-  var rt = resources[0].resource_type;
-  if (rt === "video") return "list-videos";
-  if (rt === "raw") return "list-files";
-  return "list-images";
+function resolveToolName(result) {
+  if (typeof window.__MCP_TOOL_NAME__ === "string" && window.__MCP_TOOL_NAME__) {
+    return window.__MCP_TOOL_NAME__;
+  }
+  var fromMeta = result && result._meta && result._meta["cloudinary/toolName"];
+  if (fromMeta) return fromMeta;
+  return pendingCall.name;
 }
 
 app.ontoolresult = function(result) {
   var data = ingestResult(result);
+  var name = resolveToolName(result);
+  if (name) pendingCall.name = name;
   if (data && data.resources) {
     console.log(LOG_PREFIX, "host result:", data.resources.length, "resources");
     allResources = data.resources;
     lastCursor = data.next_cursor || null;
-    pendingCall.name = inferToolName(data) || pendingCall.name;
     render(); attachEvents();
     return;
   }
@@ -67832,7 +68464,11 @@ app.ontoolresult = function(result) {
 };
 
 function showFetchPrompt() {
-  var name = pendingCall.name || "list-images";
+  var name = pendingCall.name;
+  if (!name) {
+    showPersistentError("Unknown Tool", "Could not determine which tool produced this result. Please retry from the host.");
+    return;
+  }
   var root = document.getElementById("app");
   var h = '<div class="prompt">';
   h += '<div class="prompt-icon">\\u{1F4E6}</div>';
@@ -67855,7 +68491,11 @@ function jsonArgs(src) {
 }
 
 async function fetchDirect() {
-  var name = pendingCall.name || "list-images";
+  var name = pendingCall.name;
+  if (!name) {
+    showPersistentError("Unknown Tool", "Could not determine which tool to call. Please retry from the host.");
+    return;
+  }
   var args = jsonArgs(pendingCall.args || {});
   console.log(LOG_PREFIX, "fetchDirect ->", name);
 
@@ -67880,7 +68520,11 @@ async function fetchDirect() {
 
 async function loadMore() {
   if (!lastCursor) return;
-  var name = pendingCall.name || "list-images";
+  var name = pendingCall.name;
+  if (!name) {
+    showError("Unknown Tool", "Could not determine which tool to call for pagination.");
+    return;
+  }
   var args = name === "search-assets"
     ? { request: { next_cursor: lastCursor } }
     : { next_cursor: lastCursor };
@@ -67927,8 +68571,8 @@ app.connect().then(function() {
 });
 
 `, ASSET_GALLERY_HTML;
-var init_asset_gallery_widget = __esm(() => {
-  init_widget_shared();
+var init_asset_gallery_app = __esm(() => {
+  init_app_shared();
   ASSET_GALLERY_HTML = `<!DOCTYPE html>
 <html lang="en">
 <head>
@@ -67958,11 +68602,11 @@ ${GALLERY_JS}
 </html>`;
 });
 
-// src/mcp-server/widgets/asset-details-widget.ts
-function getAssetDetailsHtml() {
-  return ASSET_DETAILS_HTML;
+// src/mcp-server/apps/asset-details-app.ts
+function getAssetDetailsHtml(toolName) {
+  return injectToolName(ASSET_DETAILS_HTML, toolName);
 }
-var ASSET_DETAILS_RESOURCE_URI = "ui://cloudinary/asset-details.html", ASSET_DETAILS_CSS = `
+var ASSET_DETAILS_CSS = `
 .details-header {
   display: flex; align-items: center; gap: 14px;
   padding-bottom: var(--cld-sp-md);
@@ -68221,8 +68865,8 @@ app.connect().then(function() {
   showError("Connection Failed", err && err.message ? err.message : String(err));
 });
 `, ASSET_DETAILS_HTML;
-var init_asset_details_widget = __esm(() => {
-  init_widget_shared();
+var init_asset_details_app = __esm(() => {
+  init_app_shared();
   ASSET_DETAILS_HTML = `<!DOCTYPE html>
 <html lang="en">
 <head>
@@ -68251,46 +68895,58 @@ ${ASSET_DETAILS_JS}
 </html>`;
 });
 
+// src/models/uploaddeliverytype.ts
+var UploadDeliveryType$zodSchema;
+var init_uploaddeliverytype = __esm(() => {
+  init_zod();
+  init_assetdeliverytype();
+  init_manageddeliverytype();
+  UploadDeliveryType$zodSchema = union([
+    ManagedDeliveryType$zodSchema,
+    AssetDeliveryType$zodSchema
+  ]).describe("Delivery types accepted by upload and rename operations.");
+});
+
 // src/models/uploadrequest.ts
-var AutoTranscription$zodSchema, AutoTranscriptionUnion$zodSchema, ResponsiveBreakpoint$zodSchema, UploadRequestType$zodSchema, UploadRequestAccessMode$zodSchema, UploadRequest$zodSchema;
+var UploadRequestAutoTranscription$zodSchema, UploadRequestAutoTranscriptionUnion$zodSchema, UploadRequestAccessMode$zodSchema, UploadRequestRegions$zodSchema, UploadRequestResponsiveBreakpoints$zodSchema, UploadRequest$zodSchema;
 var init_uploadrequest = __esm(() => {
   init_zod();
   init_accesscontrolitem();
-  AutoTranscription$zodSchema = object({
+  init_responsivebreakpoint();
+  init_structuredmetadataparam();
+  init_tagsparam();
+  init_uploaddeliverytype();
+  UploadRequestAutoTranscription$zodSchema = object({
     translate: array(string2()).optional().describe("Array of target language codes for transcription translation.")
   }).describe("Configuration object for automatic video transcription with translation options.");
-  AutoTranscriptionUnion$zodSchema = union([
+  UploadRequestAutoTranscriptionUnion$zodSchema = union([
     boolean2(),
-    lazy(() => AutoTranscription$zodSchema)
+    lazy(() => UploadRequestAutoTranscription$zodSchema)
   ]);
-  ResponsiveBreakpoint$zodSchema = object({
-    bytes_step: int().optional(),
-    create_derived: boolean2().optional(),
-    max_images: int().optional(),
-    max_width: int().optional(),
-    min_width: int().optional(),
-    transformation: string2().optional()
-  });
-  UploadRequestType$zodSchema = _enum2([
-    "upload",
-    "authenticated",
-    "private",
-    "asset"
-  ]).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.");
   UploadRequestAccessMode$zodSchema = _enum2([
     "public",
     "authenticated"
-  ]).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.
+  ]).describe(`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.
+`);
+  UploadRequestRegions$zodSchema = union([
+    string2(),
+    record(string2(), array(array(int())))
+  ]).describe(`Named region coordinate groups for cropping with region gravity.
+Can be a JSON-encoded string or an object. Each region name may contain
+only letters, numbers, or hyphens, and must have at least two coordinate pairs.
 `);
+  UploadRequestResponsiveBreakpoints$zodSchema = union([
+    array(ResponsiveBreakpoint$zodSchema),
+    ResponsiveBreakpoint$zodSchema
+  ]).describe("Settings to automatically generate breakpoints for responsive images.");
   UploadRequest$zodSchema = object({
     access_control: array(AccessControlItem$zodSchema).optional().describe(`Restricts access to the asset by specifying one or more access types.
 The asset is restricted unless at least one listed access type is valid.
 `),
-    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.
+    access_mode: UploadRequestAccessMode$zodSchema.optional().describe(`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.
 `),
-    accessibility_analysis: boolean2().optional().describe("Whether to return return accessibility analysis values for the image."),
-    allowed_formats: string2().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: string2().optional().describe("The API key to use for the request. This is automatically computed by the Cloudinary's SDKs."),
+    accessibility_analysis: boolean2().optional().describe("Whether to return accessibility analysis values for the image."),
+    allowed_formats: string2().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 won't be converted.\n"),
     asset_folder: string2().optional().describe("The asset folder to assign to the asset."),
     async: boolean2().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.
 `),
@@ -68307,7 +68963,7 @@ Use together with the categorization parameter for:
 `),
     auto_transcription: union([
       boolean2(),
-      lazy(() => AutoTranscription$zodSchema)
+      lazy(() => UploadRequestAutoTranscription$zodSchema)
     ]).optional(),
     background_removal: string2().optional().describe(`Automatically remove the background of an image using an add-on.
 - Set to cloudinary_ai to use the deep-learning based Cloudinary AI Background Removal add-on.
@@ -68327,9 +68983,10 @@ to automatically classify the scenes of the uploaded asset.
 Optionally append a language code suffix (e.g., google_tagging:fr).
 `),
     cinemagraph_analysis: boolean2().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."),
+    clear_invalid: boolean2().default(false).describe("Whether to clear metadata field values that have become invalid due to a change in metadata rules. If false, the API returns an error if any existing metadata value is no longer valid. Default: false."),
     colors: boolean2().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: string2().optional().describe("Key-value pairs of general textual context metadata to attach to the asset."),
-    custom_coordinates: string2().optional().describe("An array of coordinates for custom cropping."),
+    context: string2().optional().describe('A pipe-separated list of key-value pairs of general textual context metadata to attach to the asset (e.g., "alt=My image|caption=Nice photo"). The =, ", and | characters can be escaped with a prepending backslash (\\).'),
+    custom_coordinates: string2().optional().describe("Custom coordinates as comma-separated values, with multiple coordinates separated by pipes."),
     detection: string2().optional().describe(`Invokes the relevant add-on to return a list of detected content.
 Set to:
 - <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.
@@ -68345,7 +69002,7 @@ Set to:
     eager_async: boolean2().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: string2().optional().describe("A URL to notify when eager transformations are completed."),
     eval: string2().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: string2().optional().describe("An array of coordinates representing detected faces in the asset, used for custom cropping or overlays."),
+    face_coordinates: string2().optional().describe("Face coordinates as comma-separated values, with multiple faces separated by pipes."),
     faces: boolean2().optional().describe("Whether to detect faces in the asset."),
     file: string2().describe(`One of the following:
 - The remote HTTP or HTTPS URL address of an existing file.
@@ -68366,7 +69023,8 @@ Supported for images, video, and audio.
 - Returned metadata for audio and video includes: audio_codec, audio_bit_rate, audio_frequency, channels, channel_layout.
 - Additional metadata for video includes: pix_format, codec, level, profile, video_bit_rate, dar.
 `),
-    metadata: string2().optional().describe("Structured metadata to attach to the asset based on the metadata fields defined for your account."),
+    metadata: StructuredMetadataParam$zodSchema.optional().describe(`A pipe-separated list or a map of custom metadata fields (by external_id) and the values to assign to each of them. The = " and | characters can be supported as values when escaped with a prepended backslash (\\). For a multi-select field, you can set a maximum of 3000 different metadata values on an asset.
+`),
     moderation: string2().optional().describe(`For all asset types, set to:
 - manual to add the uploaded asset to a list of pending assets that can be moderated using the Admin API or the Cloudinary Console.
 - perception_point to automatically moderate the uploaded asset using the Perception Point Malware Detection add-on.
@@ -68405,15 +69063,21 @@ Optionally append options (e.g., adv_ocr:document).
 - 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)
 - Set to azure_video_indexer to generate AI-powered video insights from Microsoft Azure. (Asynchronous)
 `),
-    regions: string2().optional().describe("Regions to detect in the asset."),
-    responsive_breakpoints: array(lazy(() => ResponsiveBreakpoint$zodSchema)).optional().describe("Settings to automatically generate breakpoints for responsive images."),
-    return_delete_token: boolean2().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: string2().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.
+    regions: union([
+      string2(),
+      record(string2(), array(array(int())))
+    ]).optional().describe(`Named region coordinate groups for cropping with region gravity.
+Can be a JSON-encoded string or an object. Each region name may contain
+only letters, numbers, or hyphens, and must have at least two coordinate pairs.
 `),
-    tags: string2().optional().describe("A comma-separated list of tag names to assign to the asset."),
-    timestamp: int().optional().describe("The timestamp to use for the request in unix time. This is automatically computed by the Cloudinary's SDKs."),
+    responsive_breakpoints: union([
+      array(ResponsiveBreakpoint$zodSchema),
+      ResponsiveBreakpoint$zodSchema
+    ]).optional().describe("Settings to automatically generate breakpoints for responsive images."),
+    return_delete_token: boolean2().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."),
+    tags: TagsParam$zodSchema.optional().describe("A comma-separated list of tag names, or an array of tag names."),
     transformation: string2().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."),
+    type: UploadDeliveryType$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)."),
     unique_display_name: boolean2().optional().describe("Whether the display name should be unique."),
     unique_filename: boolean2().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).
 `),
@@ -68425,7 +69089,7 @@ Name of an upload preset that you defined for your Cloudinary product environmen
 `),
     use_filename_as_display_name: boolean2().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: boolean2().optional().describe("Whether to index the image for use with visual searches. Relevant for images only.")
-  });
+  }).describe("Parameters for configuring asset uploads, including transformation, tagging, metadata, and delivery options.");
 });
 
 // src/models/uploadresourcetype.ts
@@ -68445,11 +69109,11 @@ var init_uploadresourcetype = __esm(() => {
 `);
 });
 
-// src/mcp-server/widgets/asset-upload-widget.ts
-function getAssetUploadHtml() {
-  return ASSET_UPLOAD_HTML;
+// src/mcp-server/apps/asset-upload-app.ts
+function getAssetUploadHtml(toolName) {
+  return injectToolName(ASSET_UPLOAD_HTML, toolName);
 }
-var ASSET_UPLOAD_RESOURCE_URI = "ui://cloudinary/asset-upload.html", uploadJsonSchema, rtJsonSchema, allSchemaProperties, rtCopy, SCHEMA_JSON, UPLOAD_CSS = `
+var uploadJsonSchema, rtJsonSchema, allSchemaProperties, rtCopy, SCHEMA_JSON, UPLOAD_CSS = `
 .upload-header {
   display: flex; align-items: center; gap: 10px;
   margin-bottom: var(--cld-sp-md); padding-bottom: var(--cld-sp-sm);
@@ -68475,9 +69139,9 @@ var ASSET_UPLOAD_RESOURCE_URI = "ui://cloudinary/asset-upload.html", uploadJsonS
   margin-top: 16px; text-align: center;
 }
 `, UPLOAD_JS, ASSET_UPLOAD_HTML;
-var init_asset_upload_widget = __esm(() => {
+var init_asset_upload_app = __esm(() => {
   init_zod();
-  init_widget_shared();
+  init_app_shared();
   init_uploadrequest();
   init_uploadresourcetype();
   uploadJsonSchema = toJSONSchema(UploadRequest$zodSchema);
@@ -69119,7 +69783,7 @@ function renderUploadError(title, msg) {
     var safeMsg = esc(msg).replace(/\\n/g, "<br>");
     var h = '<div class="upload-error-msg">' + safeMsg + "</div>";
     h += '<div class="upload-another" style="margin-top:14px">';
-    h += '<button class="prompt-btn prompt-btn-primary" id="retry-upload-btn">Try from Widget</button>';
+    h += '<button class="prompt-btn prompt-btn-primary" id="retry-upload-btn">Try from App</button>';
     h += "</div>";
     wrap.innerHTML = h;
   } else {
@@ -69131,7 +69795,7 @@ function renderUploadError(title, msg) {
     h += "</div>";
     h += '<div class="upload-error-msg">' + safeMsg + "</div>";
     h += '<div class="upload-another" style="margin-top:14px;text-align:center">';
-    h += '<button class="prompt-btn prompt-btn-primary" id="retry-upload-btn">Try from Widget</button>';
+    h += '<button class="prompt-btn prompt-btn-primary" id="retry-upload-btn">Try from App</button>';
     h += "</div>";
     root.innerHTML = h;
   }
@@ -69269,7 +69933,7 @@ async function doUpload(fileData, displayHint) {
       if (uploadOrigin === "host") {
         try {
           app._rpc("ui/updateModelContext", {
-            content: [{ type: "text", text: "File uploaded successfully via widget. public_id: " + data.public_id + ", secure_url: " + (data.secure_url || data.url || "") }]
+            content: [{ type: "text", text: "File uploaded successfully via app. public_id: " + data.public_id + ", secure_url: " + (data.secure_url || data.url || "") }]
           });
         } catch (e) { console.warn(LOG_PREFIX, "updateModelContext failed:", e); }
       }
@@ -69436,7 +70100,7 @@ app.ontoolcancelled = function(params) {
   h += '<div style="font-size:14px;font-weight:600;color:var(--cld-text);margin-bottom:4px">Upload Cancelled</div>';
   h += renderParamsList(pendingCall.args);
   h += '<div class="prompt-actions" style="margin-top:14px">';
-  h += '<button class="prompt-btn prompt-btn-primary" id="cancelled-retry-btn">Upload from Widget</button>';
+  h += '<button class="prompt-btn prompt-btn-primary" id="cancelled-retry-btn">Upload from App</button>';
   h += '</div>';
   h += '</div>';
   root.innerHTML = h;
@@ -69521,8 +70185,85 @@ ${UPLOAD_JS}
 </html>`;
 });
 
+// src/mcp-server/apps/extensions.ts
+function appResourceContent(uri, html) {
+  return {
+    contents: [{
+      uri: uri.toString(),
+      mimeType: MCP_APP_MIME_TYPE,
+      text: html,
+      _meta: { ui: { csp: { resourceDomains: CSP_RESOURCE_DOMAINS } } }
+    }]
+  };
+}
+function registerAppResources(register, enabledApps) {
+  for (const spec of APP_SPECS) {
+    if (!enabledApps.has(spec.app))
+      continue;
+    register.resourceTemplate({
+      name: spec.name,
+      description: spec.description,
+      metadata: { mimeType: MCP_APP_MIME_TYPE },
+      resource: new ResourceTemplate(appUriTemplate(spec.app), {
+        list: async () => ({
+          resources: spec.tools.map(({ tool, title }) => ({
+            uri: appUri(spec.app, tool),
+            name: title,
+            mimeType: MCP_APP_MIME_TYPE
+          }))
+        })
+      }),
+      scopes: [],
+      read: async (_client, uri, vars, _extra) => {
+        const tool = String(vars["tool"] ?? "");
+        return appResourceContent(uri, spec.render(tool || undefined));
+      }
+    });
+  }
+}
+var CSP_RESOURCE_DOMAINS, APP_SPECS;
+var init_extensions = __esm(() => {
+  init_mcp();
+  init_asset_gallery_app();
+  init_asset_details_app();
+  init_asset_upload_app();
+  CSP_RESOURCE_DOMAINS = [
+    "https://res.cloudinary.com",
+    "https://*.cloudinary.com"
+  ];
+  APP_SPECS = [
+    {
+      app: "asset-gallery",
+      name: "Asset Gallery",
+      description: "Interactive asset gallery for browsing Cloudinary images, videos, files, and search results",
+      tools: [
+        { tool: "list-images", title: "Browse Images" },
+        { tool: "list-videos", title: "Browse Videos" },
+        { tool: "list-files", title: "Browse Files" },
+        { tool: "search-assets", title: "Search Assets" }
+      ],
+      render: getAssetGalleryHtml
+    },
+    {
+      app: "asset-details",
+      name: "Asset Details",
+      description: "Interactive single-asset detail view for Cloudinary assets",
+      tools: [{ tool: "get-asset-details", title: "Asset Details" }],
+      render: getAssetDetailsHtml
+    },
+    {
+      app: "asset-upload",
+      name: "Asset Upload",
+      description: "Interactive upload interface for uploading assets to Cloudinary",
+      tools: [{ tool: "upload-asset", title: "Upload Asset" }],
+      render: getAssetUploadHtml
+    }
+  ];
+});
+
 // src/mcp-server/server.extensions.ts
-function registerMCPExtensions(register) {
+function registerMCPExtensions(register, mcpApps = []) {
+  registerAppResources(register, new Set(mcpApps));
   register.tool({
     name: "get-tx-reference",
     description: `Get Cloudinary transformation rules documentation from official docs
@@ -69582,84 +70323,6 @@ You can view the documentation directly at: ${TX_RULES_URL}`
       }
     }
   });
-  register.resource({
-    name: "Asset Gallery Widget",
-    description: "Interactive asset gallery for browsing Cloudinary images",
-    metadata: {
-      mimeType: MCP_APP_MIME_TYPE
-    },
-    resource: ASSET_GALLERY_RESOURCE_URI,
-    scopes: [],
-    read: async (_client, _uri, _extra) => ({
-      contents: [{
-        uri: ASSET_GALLERY_RESOURCE_URI,
-        mimeType: MCP_APP_MIME_TYPE,
-        text: getAssetGalleryHtml(),
-        _meta: {
-          ui: {
-            csp: {
-              resourceDomains: [
-                "https://res.cloudinary.com",
-                "https://*.cloudinary.com"
-              ]
-            }
-          }
-        }
-      }]
-    })
-  });
-  register.resource({
-    name: "Asset Details Widget",
-    description: "Interactive single-asset detail view for Cloudinary assets",
-    metadata: {
-      mimeType: MCP_APP_MIME_TYPE
-    },
-    resource: ASSET_DETAILS_RESOURCE_URI,
-    scopes: [],
-    read: async (_client, _uri, _extra) => ({
-      contents: [{
-        uri: ASSET_DETAILS_RESOURCE_URI,
-        mimeType: MCP_APP_MIME_TYPE,
-        text: getAssetDetailsHtml(),
-        _meta: {
-          ui: {
-            csp: {
-              resourceDomains: [
-                "https://res.cloudinary.com",
-                "https://*.cloudinary.com"
-              ]
-            }
-          }
-        }
-      }]
-    })
-  });
-  register.resource({
-    name: "Asset Upload Widget",
-    description: "Interactive upload interface for uploading assets to Cloudinary",
-    metadata: {
-      mimeType: MCP_APP_MIME_TYPE
-    },
-    resource: ASSET_UPLOAD_RESOURCE_URI,
-    scopes: [],
-    read: async (_client, _uri, _extra) => ({
-      contents: [{
-        uri: ASSET_UPLOAD_RESOURCE_URI,
-        mimeType: MCP_APP_MIME_TYPE,
-        text: getAssetUploadHtml(),
-        _meta: {
-          ui: {
-            csp: {
-              resourceDomains: [
-                "https://res.cloudinary.com",
-                "https://*.cloudinary.com"
-              ]
-            }
-          }
-        }
-      }]
-    })
-  });
   register.tool({
     name: "transform-asset",
     description: `Generate derived transformations for existing assets using Cloudinary's explicit API with eager transformations
@@ -69727,9 +70390,7 @@ var init_server_extensions = __esm(() => {
   init_tools();
   init_assetsExplicitAsset();
   init_resourcetype();
-  init_asset_gallery_widget();
-  init_asset_details_widget();
-  init_asset_upload_widget();
+  init_extensions();
 });
 
 // src/models/assetrelationinfo.ts
@@ -69765,21 +70426,28 @@ var init_assetrelationsresponse = __esm(() => {
   });
 });
 
+// src/models/relateassetsbyassetidrequest.ts
+var RelateAssetsByAssetIdRequest$zodSchema;
+var init_relateassetsbyassetidrequest = __esm(() => {
+  init_zod();
+  RelateAssetsByAssetIdRequest$zodSchema = object({
+    assets_to_relate: array(string2()).describe("Relates the asset to all the assets specified in this array of up to 10 assets, specified by their asset IDs.")
+  }).describe("The asset relation request.");
+});
+
 // src/models/createassetrelationsbyassetidop.ts
-var CreateAssetRelationsByAssetIdGlobals$zodSchema, CreateAssetRelationsByAssetIdRequestBody$zodSchema, CreateAssetRelationsByAssetIdRequest$zodSchema, CreateAssetRelationsByAssetIdResponse$zodSchema;
+var CreateAssetRelationsByAssetIdGlobals$zodSchema, CreateAssetRelationsByAssetIdRequest$zodSchema, CreateAssetRelationsByAssetIdResponse$zodSchema;
 var init_createassetrelationsbyassetidop = __esm(() => {
   init_zod();
   init_apierror();
   init_assetrelationsresponse();
+  init_relateassetsbyassetidrequest();
   CreateAssetRelationsByAssetIdGlobals$zodSchema = object({
     cloud_name: string2().describe("The cloud name of your product environment.").optional()
   });
-  CreateAssetRelationsByAssetIdRequestBody$zodSchema = object({
-    assets_to_relate: array(string2()).describe("Relates the asset to all the assets specified in this array of up to 10 assets, specified by their asset IDs.")
-  });
   CreateAssetRelationsByAssetIdRequest$zodSchema = object({
-    RequestBody: lazy(() => CreateAssetRelationsByAssetIdRequestBody$zodSchema),
-    asset_id: string2().describe("The asset ID of the resource. Must be a 32-character hexadecimal string.")
+    asset_id: string2().describe("The asset ID of the resource. Must be a 32-character hexadecimal string."),
+    relate_assets_by_asset_id_request: RelateAssetsByAssetIdRequest$zodSchema.describe("The asset IDs to relate.")
   });
   CreateAssetRelationsByAssetIdResponse$zodSchema = union([
     ApiError$zodSchema,
@@ -69788,20 +70456,22 @@ var init_createassetrelationsbyassetidop = __esm(() => {
 });
 
 // src/funcs/assetRelationsCreateAssetRelationsByAssetId.ts
-function assetRelationsCreateAssetRelationsByAssetId(client$, asset_id, RequestBody, options) {
-  return new APIPromise($do2(client$, asset_id, RequestBody, options));
+function assetRelationsCreateAssetRelationsByAssetId(client$, asset_id, relate_assets_by_asset_id_request, options) {
+  return new APIPromise($do2(client$, asset_id, relate_assets_by_asset_id_request, options));
 }
-async function $do2(client$, asset_id, RequestBody, options) {
+async function $do2(client$, asset_id, relate_assets_by_asset_id_request, options) {
   const input$ = {
     asset_id,
-    RequestBody
+    relate_assets_by_asset_id_request
   };
   const parsed$ = safeParse4(input$, (value$) => CreateAssetRelationsByAssetIdRequest$zodSchema.parse(value$), "Input validation failed");
   if (!parsed$.ok) {
     return [parsed$, { status: "invalid" }];
   }
   const payload$ = parsed$.value;
-  const body$ = encodeJSON("body", payload$.RequestBody, { explode: true });
+  const body$ = encodeJSON("body", payload$.relate_assets_by_asset_id_request, {
+    explode: true
+  });
   const pathParams$ = {
     asset_id: encodeSimple("asset_id", payload$.asset_id, {
       explode: false,
@@ -69879,17 +70549,17 @@ var args, tool$assetRelationsCreateAssetRelationsByAssetId;
 var init_assetRelationsCreateAssetRelationsByAssetId2 = __esm(() => {
   init_zod();
   init_assetRelationsCreateAssetRelationsByAssetId();
-  init_createassetrelationsbyassetidop();
+  init_relateassetsbyassetidrequest();
   init_tools();
   args = {
     asset_id: string2().describe("The asset ID of the resource. Must be a 32-character hexadecimal string."),
-    RequestBody: CreateAssetRelationsByAssetIdRequestBody$zodSchema
+    relate_assets_by_asset_id_request: RelateAssetsByAssetIdRequest$zodSchema.describe(`The asset IDs to relate.`)
   };
   tool$assetRelationsCreateAssetRelationsByAssetId = {
     name: "create-asset-relations",
     description: `Add related assets by asset ID
 
-Relates an asset to other assets by their asset IDs, an immutable identifier, regardless of public ID, display name, asset folder, resource type or deliver type. This is a bidirectional process, meaning that the asset will also be added as a related_asset to all the other assets specified. The relation is also a one to many relationship, where the asset is related to all the assets specified, but those assets aren't also related to each other.`,
+Relates an asset to other assets by their asset IDs, an immutable identifier, regardless of public ID, display name, asset folder, resource type or delivery type. This is a bidirectional process, meaning that the asset will also be added as a related_asset to all the other assets specified. The relation is also a one to many relationship, where the asset is related to all the assets specified, but those assets aren't also related to each other.`,
     scopes: ["librarian"],
     annotations: {
       title: "Create Asset Relations",
@@ -69900,7 +70570,7 @@ Relates an asset to other assets by their asset IDs, an immutable identifier, re
     },
     args,
     tool: async (client, args2, ctx) => {
-      const [result] = await assetRelationsCreateAssetRelationsByAssetId(client, args2.asset_id, args2.RequestBody, { fetchOptions: { signal: ctx.signal } }).$inspect();
+      const [result] = await assetRelationsCreateAssetRelationsByAssetId(client, args2.asset_id, args2.relate_assets_by_asset_id_request, { fetchOptions: { signal: ctx.signal } }).$inspect();
       if (!result.ok) {
         return {
           content: [{ type: "text", text: result.error.message }],
@@ -69923,21 +70593,28 @@ var init_assetrelationsdeleteresponse = __esm(() => {
   });
 });
 
+// src/models/unrelateassetsbyassetidrequest.ts
+var UnrelateAssetsByAssetIdRequest$zodSchema;
+var init_unrelateassetsbyassetidrequest = __esm(() => {
+  init_zod();
+  UnrelateAssetsByAssetIdRequest$zodSchema = object({
+    assets_to_unrelate: array(string2()).describe("Unrelates the asset from all the assets specified in this array of assets, specified by their asset IDs.")
+  }).describe("The asset unrelation request.");
+});
+
 // src/models/deleteassetrelationsbyassetidop.ts
-var DeleteAssetRelationsByAssetIdGlobals$zodSchema, DeleteAssetRelationsByAssetIdRequestBody$zodSchema, DeleteAssetRelationsByAssetIdRequest$zodSchema, DeleteAssetRelationsByAssetIdResponse$zodSchema;
+var DeleteAssetRelationsByAssetIdGlobals$zodSchema, DeleteAssetRelationsByAssetIdRequest$zodSchema, DeleteAssetRelationsByAssetIdResponse$zodSchema;
 var init_deleteassetrelationsbyassetidop = __esm(() => {
   init_zod();
   init_apierror();
   init_assetrelationsdeleteresponse();
+  init_unrelateassetsbyassetidrequest();
   DeleteAssetRelationsByAssetIdGlobals$zodSchema = object({
     cloud_name: string2().describe("The cloud name of your product environment.").optional()
   });
-  DeleteAssetRelationsByAssetIdRequestBody$zodSchema = object({
-    assets_to_unrelate: array(string2()).describe("Unrelates the asset from all the assets specified in this array of assets, specified by their asset IDs.")
-  });
   DeleteAssetRelationsByAssetIdRequest$zodSchema = object({
-    RequestBody: lazy(() => DeleteAssetRelationsByAssetIdRequestBody$zodSchema),
-    asset_id: string2().describe("The asset ID of the resource. Must be a 32-character hexadecimal string.")
+    asset_id: string2().describe("The asset ID of the resource. Must be a 32-character hexadecimal string."),
+    unrelate_assets_by_asset_id_request: UnrelateAssetsByAssetIdRequest$zodSchema.describe("The asset IDs to unrelate.")
   });
   DeleteAssetRelationsByAssetIdResponse$zodSchema = union([
     ApiError$zodSchema,
@@ -69946,20 +70623,20 @@ var init_deleteassetrelationsbyassetidop = __esm(() => {
 });
 
 // src/funcs/assetRelationsDeleteAssetRelationsByAssetId.ts
-function assetRelationsDeleteAssetRelationsByAssetId(client$, asset_id, RequestBody, options) {
-  return new APIPromise($do3(client$, asset_id, RequestBody, options));
+function assetRelationsDeleteAssetRelationsByAssetId(client$, asset_id, unrelate_assets_by_asset_id_request, options) {
+  return new APIPromise($do3(client$, asset_id, unrelate_assets_by_asset_id_request, options));
 }
-async function $do3(client$, asset_id, RequestBody, options) {
+async function $do3(client$, asset_id, unrelate_assets_by_asset_id_request, options) {
   const input$ = {
     asset_id,
-    RequestBody
+    unrelate_assets_by_asset_id_request
   };
   const parsed$ = safeParse4(input$, (value$) => DeleteAssetRelationsByAssetIdRequest$zodSchema.parse(value$), "Input validation failed");
   if (!parsed$.ok) {
     return [parsed$, { status: "invalid" }];
   }
   const payload$ = parsed$.value;
-  const body$ = encodeJSON("body", payload$.RequestBody, { explode: true });
+  const body$ = encodeJSON("body", payload$.unrelate_assets_by_asset_id_request, { explode: true });
   const pathParams$ = {
     asset_id: encodeSimple("asset_id", payload$.asset_id, {
       explode: false,
@@ -70037,17 +70714,17 @@ var args2, tool$assetRelationsDeleteAssetRelationsByAssetId;
 var init_assetRelationsDeleteAssetRelationsByAssetId2 = __esm(() => {
   init_zod();
   init_assetRelationsDeleteAssetRelationsByAssetId();
-  init_deleteassetrelationsbyassetidop();
+  init_unrelateassetsbyassetidrequest();
   init_tools();
   args2 = {
     asset_id: string2().describe("The asset ID of the resource. Must be a 32-character hexadecimal string."),
-    RequestBody: DeleteAssetRelationsByAssetIdRequestBody$zodSchema
+    unrelate_assets_by_asset_id_request: UnrelateAssetsByAssetIdRequest$zodSchema.describe(`The asset IDs to unrelate.`)
   };
   tool$assetRelationsDeleteAssetRelationsByAssetId = {
     name: "delete-asset-relations",
     description: `Delete asset relations by asset ID
 
-Unrelates the asset from other assets, specified by their asset IDs, an immutable identifier, regardless of public ID, display name, asset folder, resource type or deliver type. This is a bidirectional process, meaning that the asset will also be removed as a related_asset from all the other assets specified.`,
+Unrelates the asset from other assets, specified by their asset IDs, an immutable identifier, regardless of public ID, display name, asset folder, resource type or delivery type. This is a bidirectional process, meaning that the asset will also be removed as a related_asset from all the other assets specified.`,
     scopes: ["librarian"],
     annotations: {
       title: "Delete Asset Relations",
@@ -70058,7 +70735,7 @@ Unrelates the asset from other assets, specified by their asset IDs, an immutabl
     },
     args: args2,
     tool: async (client, args3, ctx) => {
-      const [result] = await assetRelationsDeleteAssetRelationsByAssetId(client, args3.asset_id, args3.RequestBody, { fetchOptions: { signal: ctx.signal } }).$inspect();
+      const [result] = await assetRelationsDeleteAssetRelationsByAssetId(client, args3.asset_id, args3.unrelate_assets_by_asset_id_request, { fetchOptions: { signal: ctx.signal } }).$inspect();
       if (!result.ok) {
         return {
           content: [{ type: "text", text: result.error.message }],
@@ -70166,7 +70843,7 @@ var init_assetsDerivedDestroy2 = __esm(() => {
   init_deriveddestroyrequest();
   init_tools();
   args3 = {
-    request: DerivedDestroyRequest$zodSchema
+    request: DerivedDestroyRequest$zodSchema.describe(`The derived resource IDs to delete.`)
   };
   tool$assetsDerivedDestroy = {
     name: "delete-derived-assets",
@@ -70195,19 +70872,15 @@ Deletes derived resources by derived resource ID`,
   };
 });
 
-// src/models/destroyrequest.ts
-var DestroyRequest$zodSchema;
-var init_destroyrequest = __esm(() => {
+// src/models/componentsdestroyrequest.ts
+var ComponentsDestroyRequest$zodSchema;
+var init_componentsdestroyrequest = __esm(() => {
   init_zod();
-  DestroyRequest$zodSchema = object({
-    api_key: string2().optional().describe("The API key to use for the request. This is automatically computed by the Cloudinary's SDKs."),
-    asset_id: string2().describe("The ID of the asset to delete."),
+  ComponentsDestroyRequest$zodSchema = object({
+    asset_id: string2().describe("A 32-character hexadecimal asset ID."),
     callback: string2().optional().describe("URL for redirect after operation completion."),
     invalidate: boolean2().optional().describe("Whether to invalidate CDN cache. Default is false."),
-    notification_url: string2().optional().describe("URL to receive completion notification."),
-    signature: string2().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.
-`),
-    timestamp: int().optional().describe("The timestamp to use for the request in unix time. This is automatically computed by the Cloudinary's SDKs.")
+    notification_url: string2().optional().describe("URL to receive completion notification.")
   });
 });
 
@@ -70216,7 +70889,7 @@ function assetsDestroyByAssetId(client$, request, options) {
   return new APIPromise($do5(client$, request, options));
 }
 async function $do5(client$, request, options) {
-  const parsed$ = safeParse4(request, (value$) => DestroyRequest$zodSchema.parse(value$), "Input validation failed");
+  const parsed$ = safeParse4(request, (value$) => ComponentsDestroyRequest$zodSchema.parse(value$), "Input validation failed");
   if (!parsed$.ok) {
     return [parsed$, { status: "invalid" }];
   }
@@ -70286,7 +70959,7 @@ var init_assetsDestroyByAssetId = __esm(() => {
   init_schemas4();
   init_security();
   init_url();
-  init_destroyrequest();
+  init_componentsdestroyrequest();
   init_async();
 });
 
@@ -70294,17 +70967,16 @@ var init_assetsDestroyByAssetId = __esm(() => {
 var args4, tool$assetsDestroyByAssetId;
 var init_assetsDestroyByAssetId2 = __esm(() => {
   init_assetsDestroyByAssetId();
-  init_destroyrequest();
+  init_componentsdestroyrequest();
   init_tools();
   args4 = {
-    request: DestroyRequest$zodSchema
+    request: ComponentsDestroyRequest$zodSchema.describe(`The asset to delete and related options.`)
   };
   tool$assetsDestroyByAssetId = {
     name: "delete-asset",
-    description: `Delete asset by asset-id
+    description: `Delete asset by asset ID
 
-Deletes an asset using its asset ID. This endpoint replaces the legacy /resources/by_asset_id endpoint.
-Returns the deletion status and asset folder information when folder decoupling is enabled.
+Deletes an asset using its immutable asset ID.
 `,
     scopes: ["admin"],
     annotations: {
@@ -70329,63 +71001,35 @@ Returns the deletion status and asset folder information when folder decoupling
 });
 
 // src/models/downloadbackupassetop.ts
-var DownloadBackupAssetGlobals$zodSchema, DownloadBackupAssetRequest$zodSchema, NotFoundError$zodSchema, DownloadBackupAssetNotFoundResponseBody$zodSchema, DownloadBackupAssetUnauthorizedError$zodSchema, DownloadBackupAssetUnauthorizedResponseBody$zodSchema, BadRequestError$zodSchema, DownloadBackupAssetBadRequestResponseBody$zodSchema, DownloadBackupAssetResponse$zodSchema;
+var DownloadBackupAssetGlobals$zodSchema, DownloadBackupAssetRequest$zodSchema, DownloadBackupAssetResponse$zodSchema;
 var init_downloadbackupassetop = __esm(() => {
   init_zod();
   init_base64();
+  init_apierror();
   DownloadBackupAssetGlobals$zodSchema = object({
     cloud_name: string2().describe("The cloud name of your product environment.").optional()
   });
   DownloadBackupAssetRequest$zodSchema = object({
-    api_key: string2().describe("The API key to use for the request. This is automatically computed by the Cloudinary's SDKs.").optional(),
     asset_id: string2().describe("The asset ID of the resource. Must be a 32-character hexadecimal string."),
-    signature: string2().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.
-`).optional(),
-    timestamp: int().describe("The timestamp to use for the request in unix time. This is automatically computed by the Cloudinary's SDKs.").optional(),
     version_id: string2().describe("The version ID of the backup to download. Must be a 32-character hexadecimal string.")
   });
-  NotFoundError$zodSchema = object({
-    message: string2().optional().describe("Specified version does not exist")
-  });
-  DownloadBackupAssetNotFoundResponseBody$zodSchema = object({
-    error: lazy(() => NotFoundError$zodSchema).optional()
-  }).describe("Version not found");
-  DownloadBackupAssetUnauthorizedError$zodSchema = object({
-    http_code: int().optional().describe("The HTTP status code."),
-    message: string2().optional().describe("Invalid Signature or timestamp expired.")
-  });
-  DownloadBackupAssetUnauthorizedResponseBody$zodSchema = object({
-    error: lazy(() => DownloadBackupAssetUnauthorizedError$zodSchema).optional()
-  }).describe("Authentication failed");
-  BadRequestError$zodSchema = object({
-    http_code: int().optional().describe("The HTTP status code."),
-    message: string2().optional().describe("A problem with one of the parameters or timestamp.")
-  });
-  DownloadBackupAssetBadRequestResponseBody$zodSchema = object({
-    error: lazy(() => BadRequestError$zodSchema).optional()
-  }).describe("Bad request");
   DownloadBackupAssetResponse$zodSchema = union([
+    ApiError$zodSchema,
     string2().describe("Base64-encoded binary content").transform(bytesFromBase64),
     string2().describe("Base64-encoded binary content").transform(bytesFromBase64),
     string2().describe("Base64-encoded binary content").transform(bytesFromBase64),
-    string2().describe("Base64-encoded binary content").transform(bytesFromBase64),
-    lazy(() => DownloadBackupAssetBadRequestResponseBody$zodSchema),
-    lazy(() => DownloadBackupAssetUnauthorizedResponseBody$zodSchema),
-    lazy(() => DownloadBackupAssetNotFoundResponseBody$zodSchema)
+    string2().describe("Base64-encoded binary content").transform(bytesFromBase64)
   ]);
 });
 
 // src/funcs/assetsDownloadBackupAsset.ts
-function assetsDownloadBackupAsset(client$, asset_id, version_id, api_key, signature, timestamp, options) {
-  return new APIPromise($do6(client$, asset_id, version_id, api_key, signature, timestamp, options));
+function assetsDownloadBackupAsset(client$, asset_id, version_id, options) {
+  return new APIPromise($do6(client$, asset_id, version_id, options));
 }
-async function $do6(client$, asset_id, version_id, api_key, signature, timestamp, options) {
+async function $do6(client$, asset_id, version_id, options) {
   const input$ = {
     asset_id,
-    version_id,
-    api_key,
-    signature,
-    timestamp
+    version_id
   };
   const parsed$ = safeParse4(input$, (value$) => DownloadBackupAssetRequest$zodSchema.parse(value$), "Input validation failed");
   if (!parsed$.ok) {
@@ -70401,10 +71045,7 @@ async function $do6(client$, asset_id, version_id, api_key, signature, timestamp
   };
   const path$ = pathToFunc("/v1_1/{cloud_name}/download_backup")(pathParams$);
   const query$ = encodeFormQuery({
-    api_key: payload$.api_key,
     asset_id: payload$.asset_id,
-    signature: payload$.signature,
-    timestamp: payload$.timestamp,
     version_id: payload$.version_id
   });
   const headers$ = new Headers(compactMap({
@@ -70476,11 +71117,7 @@ var init_assetsDownloadBackupAsset2 = __esm(() => {
   init_tools();
   args5 = {
     asset_id: string2().describe("The asset ID of the resource. Must be a 32-character hexadecimal string."),
-    version_id: string2().describe("The version ID of the backup to download. Must be a 32-character hexadecimal string."),
-    api_key: string2().describe("The API key to use for the request. This is automatically computed by the Cloudinary's SDKs.").optional(),
-    signature: string2().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.
-`).optional(),
-    timestamp: int().describe("The timestamp to use for the request in unix time. This is automatically computed by the Cloudinary's SDKs.").optional()
+    version_id: string2().describe("The version ID of the backup to download. Must be a 32-character hexadecimal string.")
   };
   tool$assetsDownloadBackupAsset = {
     name: "download-asset-backup",
@@ -70488,13 +71125,13 @@ var init_assetsDownloadBackupAsset2 = __esm(() => {
     annotations: {
       title: "Download Asset Backup",
       destructiveHint: false,
-      idempotentHint: false,
+      idempotentHint: true,
       openWorldHint: false,
       readOnlyHint: true
     },
     args: args5,
     tool: async (client, args6, ctx) => {
-      const [result] = await assetsDownloadBackupAsset(client, args6.asset_id, args6.version_id, args6.api_key, args6.signature, args6.timestamp, { fetchOptions: { signal: ctx.signal } }).$inspect();
+      const [result] = await assetsDownloadBackupAsset(client, args6.asset_id, args6.version_id, { fetchOptions: { signal: ctx.signal } }).$inspect();
       if (!result.ok) {
         return {
           content: [{ type: "text", text: result.error.message }],
@@ -70518,82 +71155,105 @@ var init_archiveresourcetype = __esm(() => {
   ]).describe('The type of resources to include in the archive. "image" for images, "video" for videos, "raw" for non-media files, or "all" for mixed types.');
 });
 
+// src/models/generatearchiveresponse.ts
+var GenerateArchiveResponse$zodSchema;
+var init_generatearchiveresponse = __esm(() => {
+  init_zod();
+  GenerateArchiveResponse$zodSchema = object({
+    asset_folder: string2().optional().describe("The folder in your product environment where the archive is stored."),
+    asset_id: string2().optional().describe("A 32-character hexadecimal asset ID."),
+    bytes: int().optional().describe("The size of the generated archive in bytes."),
+    created_at: exports_iso.datetime({ offset: true }).optional().describe("The timestamp when the archive was generated."),
+    display_name: string2().optional().describe("The display name of the generated archive."),
+    empty_prefixes: array(string2()).optional().describe("The list of prefixes that were requested but returned no results."),
+    empty_tags: array(string2()).optional().describe("The list of tags that were requested but returned no results."),
+    etag: string2().optional().describe("The ETag of the generated archive."),
+    file_count: int().optional().describe("The total number of files in the archive."),
+    folder: string2().optional().describe("The folder where the archive is stored (only for product environments with Dynamic Folders disabled)."),
+    missing_public_ids: array(string2()).optional().describe("The list of public IDs that were requested but not found."),
+    placeholder: boolean2().optional().describe("Whether the generated archive is a placeholder."),
+    public_id: string2().optional().describe("The public ID of the generated archive."),
+    resource_count: int().optional().describe("The number of unique resources included in the archive."),
+    resource_type: string2().optional().describe('The type of resource. Always "raw" for generated archives.'),
+    secure_url: string2().optional().describe("The HTTPS URL for downloading the generated archive."),
+    signature: string2().optional().describe("The API signature for the generated archive."),
+    tags: array(string2()).nullable().optional().describe("Tag names assigned to the asset."),
+    type: string2().optional().describe("The resource type of the generated archive."),
+    url: string2().optional().describe("The HTTP URL for downloading the generated archive."),
+    version: int().optional().describe("The version number of the generated archive."),
+    version_id: string2().optional().describe("Hexadecimal version ID; length is a positive multiple of 32 (typically 32 or 64).")
+  });
+});
+
 // src/models/generatearchiveop.ts
-var GenerateArchiveGlobals$zodSchema, Mode$zodSchema, TargetFormat$zodSchema, GenerateArchiveRequestBody$zodSchema, GenerateArchiveRequest$zodSchema, GenerateArchiveResponseBody$zodSchema, GenerateArchiveResponse$zodSchema;
+var GenerateArchiveGlobals$zodSchema, Mode$zodSchema, TargetFormat$zodSchema, AssetFolders$zodSchema, GenerateArchiveRequestBody$zodSchema, GenerateArchiveRequest$zodSchema, GenerateArchiveResponseResponse$zodSchema;
 var init_generatearchiveop = __esm(() => {
   init_zod();
   init_base64();
   init_apierror();
   init_archiveresourcetype();
-  init_archivestoragetype();
+  init_deliverytypeall();
+  init_generatearchiveresponse();
   GenerateArchiveGlobals$zodSchema = object({
     cloud_name: string2().describe("The cloud name of your product environment.").optional()
   });
   Mode$zodSchema = _enum2([
-    "create"
-  ]).describe(`The method for generating and delivering the archive. Only "create" is supported:
+    "download",
+    "create",
+    "create_and_download"
+  ]).describe(`The method for generating and delivering the archive. Options:
+download - Generates and delivers the archive file without storing it
 create - Creates and stores the archive as a raw asset, returning URLs in the response
+create_and_download - Creates, stores, and delivers the archive file
 `);
   TargetFormat$zodSchema = _enum2([
     "zip",
     "tgz"
   ]).describe("The format of the generated archive.");
+  AssetFolders$zodSchema = union([
+    array(string2()),
+    string2()
+  ]).describe("A list of asset folder paths to include in the archive, or a single folder path string. Only available when asset folders are enabled for your account.");
   GenerateArchiveRequestBody$zodSchema = object({
     allow_missing: boolean2().default(false).describe("Whether to allow missing assets in the archive. If false, the operation will fail if any asset is not found."),
-    api_key: string2().optional().describe("The API key to use for the request. This is automatically computed by the Cloudinary's SDKs."),
+    asset_folders: union([
+      array(string2()),
+      string2()
+    ]).optional().describe("A list of asset folder paths to include in the archive, or a single folder path string. Only available when asset folders are enabled for your account."),
     async: boolean2().default(false).describe('("create" mode only), specifies whether to generate the archive asynchronously.'),
     expires_at: int().optional().describe('("download" mode only) Unix timestamp indicating when the generated archive URL should expire.'),
     flatten_folders: boolean2().default(false).describe("Whether to flatten all files to be in the root of the archive file."),
     flatten_transformations: boolean2().default(false).describe("Whether to flatten the folder structure of the derived assets."),
+    fully_qualified_public_ids: array(string2()).optional().describe("A list of fully qualified public IDs (resource_type/type/public_id) to include in the archive."),
     keep_derived: boolean2().default(false).describe("Whether to keep the derived assets used for generating the archive."),
-    mode: Mode$zodSchema.default("create").describe(`The method for generating and delivering the archive. Only "create" is supported:
+    mode: Mode$zodSchema.default("create").describe(`The method for generating and delivering the archive. Options:
+download - Generates and delivers the archive file without storing it
 create - Creates and stores the archive as a raw asset, returning URLs in the response
+create_and_download - Creates, stores, and delivers the archive file
 `),
     notification_url: string2().optional().describe('("create" mode only), specifies the URL to notify when the archive generation is complete.'),
-    prefixes: array(string2()).optional().describe("Select all assets where the public ID starts with this prefix. Up to 20 prefixes are supported."),
-    public_ids: array(string2()).optional().describe("The list of public IDs to include in the archive. Up to 1000 public IDs are supported."),
-    signature: string2().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.
-`),
+    prefixes: array(string2()).optional().describe("Select all assets where the public ID starts with this prefix."),
+    public_ids: array(string2()).optional().describe("The list of public IDs to include in the archive."),
+    search_expression: string2().optional().describe("A search expression to select assets to include in the archive."),
     skip_transformation_name: boolean2().default(false).describe("Whether to skip adding the transformation details to the file names in the archive."),
-    tags: array(string2()).optional().describe("A tag to use for selecting assets to include in the archive. Up to 20 tags are supported."),
+    tags: array(string2()).optional().describe("Tags to filter which assets to include in the archive. Assets matching any of the specified tags are included."),
     target_asset_folder: string2().optional().describe("The folder in your product environment where the generated archive should be stored."),
+    target_filename: string2().optional().describe("The filename for the downloaded archive file. Extension must match target_format (zip or tgz)."),
     target_format: TargetFormat$zodSchema.default("zip").describe("The format of the generated archive."),
     target_public_id: string2().optional().describe("The public ID to assign to the generated archive, or the filename of the downloaded archive file."),
     target_tags: array(string2()).optional().describe("A list of tag names to assign to the generated archive."),
-    timestamp: int().optional().describe("The timestamp to use for the request in unix time. This is automatically computed by the Cloudinary's SDKs."),
     transformations: string2().optional().describe('The transformations to apply to the assets before including them in the archive (separated by "|").'),
-    type: ArchiveStorageType$zodSchema.optional().describe("The storage type of resources to include in the archive."),
+    type: DeliveryTypeAll$zodSchema.optional().describe("All supported delivery types."),
     use_original_filename: boolean2().default(false).describe("Whether to use the original filenames of the assets in the archive instead of public IDs (when available).")
-  });
+  }).describe("The archive generation parameters.");
   GenerateArchiveRequest$zodSchema = object({
-    RequestBody: lazy(() => GenerateArchiveRequestBody$zodSchema),
-    resource_type: ArchiveResourceType$zodSchema.describe('The type of resources to include in the archive. "image" for images, "video" for videos, "raw" for non-media files, or "all" for mixed types.')
+    RequestBody: lazy(() => GenerateArchiveRequestBody$zodSchema).describe("The archive generation parameters."),
+    resource_type: ArchiveResourceType$zodSchema.describe("The type of resource for archive generation (image, video, or raw).")
   });
-  GenerateArchiveResponseBody$zodSchema = object({
-    asset_folder: string2().optional().describe("The folder in your product environment where the archive is stored."),
-    asset_id: string2().optional().describe("The unique identifier of the generated archive in the Cloudinary system."),
-    bytes: int().optional().describe("The size of the generated archive in bytes."),
-    created_at: exports_iso.datetime({ offset: true }).optional().describe("The timestamp when the archive was generated."),
-    display_name: string2().optional().describe("The display name of the generated archive."),
-    empty_prefixes: array(string2()).optional().describe("The list of prefixes that were requested but returned no results."),
-    empty_tags: array(string2()).optional().describe("The list of tags that were requested but returned no results."),
-    file_count: int().optional().describe("The total number of files in the archive."),
-    folder: string2().optional().describe("The folder where the archive is stored (only for product environments with Dynamic Folders disabled)"),
-    missing_public_ids: array(string2()).optional().describe("The list of public IDs that were requested but not found."),
-    public_id: string2().optional().describe("The public ID of the generated archive."),
-    resource_count: int().optional().describe("The number of unique resources included in the archive."),
-    resource_type: string2().optional().describe('The type of resource. Always "raw" for generated archives.'),
-    secure_url: string2().optional().describe("The HTTPS URL for downloading the generated archive."),
-    tags: array(string2()).optional().describe("The tags assigned to the generated archive."),
-    type: string2().optional().describe("The resource type of the generated archive."),
-    url: string2().optional().describe("The HTTP URL for downloading the generated archive."),
-    version: int().optional().describe("The version number of the generated archive."),
-    version_id: string2().optional().describe("The unique identifier of this version of the generated archive.")
-  }).describe("Archive successfully generated or downloaded");
-  GenerateArchiveResponse$zodSchema = union([
+  GenerateArchiveResponseResponse$zodSchema = union([
     ApiError$zodSchema,
     string2().describe("Base64-encoded binary content").transform(bytesFromBase64),
-    lazy(() => GenerateArchiveResponseBody$zodSchema)
+    GenerateArchiveResponse$zodSchema
   ]);
 });
 
@@ -70692,8 +71352,8 @@ var init_assetsGenerateArchive2 = __esm(() => {
   init_generatearchiveop();
   init_tools();
   args6 = {
-    resource_type: ArchiveResourceType$zodSchema.describe(`The type of resources to include in the archive. "image" for images, "video" for videos, "raw" for non-media files, or "all" for mixed types.`),
-    RequestBody: GenerateArchiveRequestBody$zodSchema
+    resource_type: ArchiveResourceType$zodSchema.describe(`The type of resource for archive generation (image, video, or raw).`),
+    RequestBody: GenerateArchiveRequestBody$zodSchema.describe(`The archive generation parameters.`)
   };
   tool$assetsGenerateArchive = {
     name: "generate-archive",
@@ -70867,7 +71527,6 @@ var init_assetsGetResourceByAssetId2 = __esm(() => {
   init_zod();
   init_assetsGetResourceByAssetId();
   init_tools();
-  init_asset_details_widget();
   args7 = {
     asset_id: string2().describe("The asset ID of the resource. Must be a 32-character hexadecimal string."),
     colors: boolean2().default(false).describe("Whether to include color information (predominant colors and histogram of 32 leading colors). Default: false."),
@@ -70896,7 +71555,7 @@ Returns the details of a single resource specified by its asset ID.`,
       readOnlyHint: true
     },
     _meta: {
-      ui: { resourceUri: ASSET_DETAILS_RESOURCE_URI }
+      ui: { resourceUri: appUri("asset-details", "get-asset-details") }
     },
     args: args7,
     tool: async (client, args8, ctx) => {
@@ -70912,47 +71571,58 @@ Returns the details of a single resource specified by its asset ID.`,
   };
 });
 
-// src/models/direction.ts
-var Direction$zodSchema;
-var init_direction = __esm(() => {
+// src/models/directionenum.ts
+var DirectionEnum$zodSchema;
+var init_directionenum = __esm(() => {
   init_zod();
-  Direction$zodSchema = _enum2([
+  DirectionEnum$zodSchema = _enum2([
     "asc",
     "desc"
-  ]);
+  ]).describe("Sort direction.");
 });
 
-// src/models/fieldsspec.ts
-var FieldsSpec$zodSchema;
-var init_fieldsspec = __esm(() => {
+// src/models/resourcefieldsenum.ts
+var ResourceFieldsEnum$zodSchema;
+var init_resourcefieldsenum = __esm(() => {
   init_zod();
-  FieldsSpec$zodSchema = _enum2([
+  ResourceFieldsEnum$zodSchema = _enum2([
+    "public_id",
+    "asset_id",
     "asset_folder",
     "folder",
-    "filename",
+    "display_name",
     "format",
     "version",
-    "version_id",
-    "signature",
     "resource_type",
+    "type",
     "created_at",
-    "uploaded_at",
     "bytes",
-    "backup_bytes",
     "width",
     "height",
-    "aspect_ratio",
+    "backup",
     "access_control",
-    "metadata",
-    "context",
-    "tags",
-    "pixels",
-    "custom",
-    "moderation",
+    "access_mode",
     "url",
     "secure_url",
-    "status",
-    "etag"
+    "tags",
+    "context",
+    "metadata",
+    "moderation_kind",
+    "moderation_status",
+    "placeholder",
+    "regions",
+    "is_audio"
+  ]).describe("Valid field names for selective resource responses.");
+});
+
+// src/models/fields.ts
+var Fields$zodSchema;
+var init_fields = __esm(() => {
+  init_zod();
+  init_resourcefieldsenum();
+  Fields$zodSchema = union([
+    string2(),
+    array(ResourceFieldsEnum$zodSchema)
   ]);
 });
 
@@ -70968,41 +71638,28 @@ var init_listresponse = __esm(() => {
   });
 });
 
-// src/models/liststoragetype.ts
-var ListStorageType$zodSchema;
-var init_liststoragetype = __esm(() => {
-  init_zod();
-  ListStorageType$zodSchema = _enum2([
-    "upload",
-    "private",
-    "authenticated",
-    "fetch",
-    "list"
-  ]).describe("The delivery type for filtering resources in list operations.");
-});
-
 // src/models/listimagesop.ts
 var ListImagesGlobals$zodSchema, ListImagesRequest$zodSchema, ListImagesResponse$zodSchema;
 var init_listimagesop = __esm(() => {
   init_zod();
   init_apierror();
-  init_direction();
-  init_fieldsspec();
+  init_deliverytypeall();
+  init_directionenum();
+  init_fields();
   init_listresponse();
-  init_liststoragetype();
   ListImagesGlobals$zodSchema = object({
     cloud_name: string2().describe("The cloud name of your product environment.").optional()
   });
   ListImagesRequest$zodSchema = object({
-    direction: Direction$zodSchema.optional().describe("Sort direction."),
-    fields: array(FieldsSpec$zodSchema).optional(),
+    direction: DirectionEnum$zodSchema.optional().describe('The sort direction for the results. Default is "desc".'),
+    fields: Fields$zodSchema.optional().describe("Additional fields to include in the response. The fields public_id and asset_id are always included."),
     max_results: int().describe("Maximum number of results to return (1-500).").optional(),
     next_cursor: string2().describe("Cursor for pagination.").optional(),
-    prefix: string2().describe("Find resources with a public ID prefix. Requires the `type` parameter.").optional(),
+    prefix: string2().describe("A public_id prefix. When specified, all assets with that prefix are returned.").optional(),
     public_ids: array(string2()).describe("An array of public IDs to return.").optional(),
-    start_at: exports_iso.datetime({ offset: true }).describe("Retrieve resources uploaded after this timestamp.").optional(),
-    tags: boolean2().describe("Whether to include the list of tag names assigned to each asset. Default: false").optional(),
-    type: ListStorageType$zodSchema.optional().describe("The storage type of the assets. Necessary for prefix filtering.")
+    start_at: exports_iso.datetime({ offset: true }).describe("An ISO-8601 formatted timestamp. When specified, returns resources created since that timestamp. Supported only if neither `prefix` nor `public_ids` were passed.").optional(),
+    tags: boolean2().default(false).describe("Whether to include the list of tag names assigned to each asset. Default is false."),
+    type: DeliveryTypeAll$zodSchema.optional().describe("The delivery type to filter by. When omitted, returns assets of all delivery types.")
   });
   ListImagesResponse$zodSchema = union([
     ApiError$zodSchema,
@@ -71117,27 +71774,26 @@ var args8, tool$assetsListImages;
 var init_assetsListImages2 = __esm(() => {
   init_zod();
   init_assetsListImages();
-  init_direction();
-  init_fieldsspec();
-  init_liststoragetype();
-  init_asset_gallery_widget();
+  init_deliverytypeall();
+  init_directionenum();
+  init_fields();
   init_tools();
   args8 = {
-    type: ListStorageType$zodSchema.optional().describe(`The storage type of the assets. Necessary for prefix filtering.`),
-    prefix: string2().describe("Find resources with a public ID prefix. Requires the `type` parameter.").optional(),
+    type: DeliveryTypeAll$zodSchema.optional().describe(`The delivery type to filter by. When omitted, returns assets of all delivery types.`),
+    prefix: string2().describe("A public_id prefix. When specified, all assets with that prefix are returned.").optional(),
     public_ids: array(string2()).describe("An array of public IDs to return.").optional(),
-    tags: boolean2().describe("Whether to include the list of tag names assigned to each asset. Default: false").optional(),
+    tags: boolean2().default(false).describe("Whether to include the list of tag names assigned to each asset. Default is false."),
     next_cursor: string2().describe("Cursor for pagination.").optional(),
     max_results: int().describe("Maximum number of results to return (1-500).").optional(),
-    direction: Direction$zodSchema.optional().describe(`Sort direction.`),
-    start_at: exports_iso.datetime({ offset: true }).describe("Retrieve resources uploaded after this timestamp.").optional(),
-    fields: array(FieldsSpec$zodSchema).optional()
+    direction: DirectionEnum$zodSchema.optional().describe(`The sort direction for the results. Default is "desc".`),
+    start_at: exports_iso.datetime({ offset: true }).describe("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: Fields$zodSchema.optional().describe(`Additional fields to include in the response. The fields public_id and asset_id are always included.`)
   };
   tool$assetsListImages = {
     name: "list-images",
     description: `Get image assets
 
-Retrieves a list of image assets. Results can be filtered by various criteria like tags, moderation status, prefix, or specific public IDs.
+Retrieves a list of image assets. Results can be filtered by various criteria like tags, prefix, or specific public IDs.
 `,
     scopes: ["librarian"],
     annotations: {
@@ -71148,7 +71804,7 @@ Retrieves a list of image assets. Results can be filtered by various criteria li
       readOnlyHint: true
     },
     _meta: {
-      ui: { resourceUri: ASSET_GALLERY_RESOURCE_URI }
+      ui: { resourceUri: appUri("asset-gallery", "list-images") }
     },
     args: args8,
     tool: async (client, args9, ctx) => {
@@ -71169,23 +71825,23 @@ var ListRawFilesGlobals$zodSchema, ListRawFilesRequest$zodSchema, ListRawFilesRe
 var init_listrawfilesop = __esm(() => {
   init_zod();
   init_apierror();
-  init_direction();
-  init_fieldsspec();
+  init_deliverytypeall();
+  init_directionenum();
+  init_fields();
   init_listresponse();
-  init_liststoragetype();
   ListRawFilesGlobals$zodSchema = object({
     cloud_name: string2().describe("The cloud name of your product environment.").optional()
   });
   ListRawFilesRequest$zodSchema = object({
-    direction: Direction$zodSchema.optional().describe("Sort direction."),
-    fields: array(FieldsSpec$zodSchema).optional(),
+    direction: DirectionEnum$zodSchema.optional().describe('The sort direction for the results. Default is "desc".'),
+    fields: Fields$zodSchema.optional().describe("Additional fields to include in the response. The fields public_id and asset_id are always included."),
     max_results: int().describe("Maximum number of results to return (1-500).").optional(),
     next_cursor: string2().describe("Cursor for pagination.").optional(),
-    prefix: string2().describe("A public_id prefix. When specified, all assets with that prefix are returned. When using this, the `type` parameter must also be specified.").optional(),
+    prefix: string2().describe("A public_id prefix. When specified, all assets with that prefix are returned.").optional(),
     public_ids: array(string2()).describe("An array of public IDs to return.").optional(),
-    start_at: exports_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.").optional(),
-    tags: boolean2().describe("Whether to include the list of tag names assigned to each asset. Default: false").optional(),
-    type: ListStorageType$zodSchema.optional().describe("The delivery type. Necessary for prefix filtering.")
+    start_at: exports_iso.datetime({ offset: true }).describe("An ISO-8601 formatted timestamp. When specified, returns resources created since that timestamp. Supported only if neither `prefix` nor `public_ids` were passed.").optional(),
+    tags: boolean2().default(false).describe("Whether to include the list of tag names assigned to each asset. Default is false."),
+    type: DeliveryTypeAll$zodSchema.optional().describe("The delivery type to filter by. When omitted, returns assets of all delivery types.")
   });
   ListRawFilesResponse$zodSchema = union([
     ApiError$zodSchema,
@@ -71300,27 +71956,26 @@ var args9, tool$assetsListRawFiles;
 var init_assetsListRawFiles2 = __esm(() => {
   init_zod();
   init_assetsListRawFiles();
-  init_direction();
-  init_fieldsspec();
-  init_liststoragetype();
+  init_deliverytypeall();
+  init_directionenum();
+  init_fields();
   init_tools();
-  init_asset_gallery_widget();
   args9 = {
-    type: ListStorageType$zodSchema.optional().describe(`The delivery type. Necessary for prefix filtering.`),
-    prefix: string2().describe("A public_id prefix. When specified, all assets with that prefix are returned. When using this, the `type` parameter must also be specified.").optional(),
+    type: DeliveryTypeAll$zodSchema.optional().describe(`The delivery type to filter by. When omitted, returns assets of all delivery types.`),
+    prefix: string2().describe("A public_id prefix. When specified, all assets with that prefix are returned.").optional(),
     public_ids: array(string2()).describe("An array of public IDs to return.").optional(),
-    tags: boolean2().describe("Whether to include the list of tag names assigned to each asset. Default: false").optional(),
+    tags: boolean2().default(false).describe("Whether to include the list of tag names assigned to each asset. Default is false."),
     next_cursor: string2().describe("Cursor for pagination.").optional(),
     max_results: int().describe("Maximum number of results to return (1-500).").optional(),
-    direction: Direction$zodSchema.optional().describe(`Sort direction.`),
-    start_at: exports_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.").optional(),
-    fields: array(FieldsSpec$zodSchema).optional()
+    direction: DirectionEnum$zodSchema.optional().describe(`The sort direction for the results. Default is "desc".`),
+    start_at: exports_iso.datetime({ offset: true }).describe("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: Fields$zodSchema.optional().describe(`Additional fields to include in the response. The fields public_id and asset_id are always included.`)
   };
   tool$assetsListRawFiles = {
     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: {
@@ -71331,7 +71986,7 @@ Retrieves a list of raw assets. Results can be filtered by various criteria like
       readOnlyHint: true
     },
     _meta: {
-      ui: { resourceUri: ASSET_GALLERY_RESOURCE_URI }
+      ui: { resourceUri: appUri("asset-gallery", "list-files") }
     },
     args: args9,
     tool: async (client, args10, ctx) => {
@@ -71347,28 +72002,35 @@ Retrieves a list of raw assets. Results can be filtered by various criteria like
   };
 });
 
+// src/models/tagslistresponse.ts
+var TagsListResponse$zodSchema;
+var init_tagslistresponse = __esm(() => {
+  init_zod();
+  TagsListResponse$zodSchema = object({
+    next_cursor: string2().nullable().optional(),
+    tags: array(string2()).optional()
+  });
+});
+
 // src/models/listresourcetagsop.ts
-var ListResourceTagsGlobals$zodSchema, ListResourceTagsRequest$zodSchema, ListResourceTagsResponseBody$zodSchema, ListResourceTagsResponse$zodSchema;
+var ListResourceTagsGlobals$zodSchema, ListResourceTagsRequest$zodSchema, ListResourceTagsResponse$zodSchema;
 var init_listresourcetagsop = __esm(() => {
   init_zod();
   init_apierror();
   init_resourcetype();
+  init_tagslistresponse();
   ListResourceTagsGlobals$zodSchema = object({
     cloud_name: string2().describe("The cloud name of your product environment.").optional()
   });
   ListResourceTagsRequest$zodSchema = object({
     max_results: int().describe("Maximum number of results to return (1-500).").optional(),
     next_cursor: string2().describe("Cursor for pagination.").optional(),
-    prefix: string2().describe("The prefix to use if you want to limit the returned tags to those that start with the specified prefix.").optional(),
-    resource_type: ResourceType$zodSchema.describe("The type of resource.")
+    prefix: string2().describe("Limit the returned tags to those that start with the specified prefix.").optional(),
+    resource_type: ResourceType$zodSchema.describe("The type of resource (image, video, or raw).")
   });
-  ListResourceTagsResponseBody$zodSchema = object({
-    next_cursor: string2().nullable().optional(),
-    tags: array(string2()).optional()
-  }).describe("List of tags retrieved");
   ListResourceTagsResponse$zodSchema = union([
     ApiError$zodSchema,
-    lazy(() => ListResourceTagsResponseBody$zodSchema)
+    TagsListResponse$zodSchema
   ]);
 });
 
@@ -71474,8 +72136,8 @@ var init_assetsListResourceTags2 = __esm(() => {
   init_resourcetype();
   init_tools();
   args10 = {
-    resource_type: ResourceType$zodSchema.describe(`The type of resource.`),
-    prefix: string2().describe("The prefix to use if you want to limit the returned tags to those that start with the specified prefix.").optional(),
+    resource_type: ResourceType$zodSchema.describe(`The type of resource (image, video, or raw).`),
+    prefix: string2().describe("Limit the returned tags to those that start with the specified prefix.").optional(),
     next_cursor: string2().describe("Cursor for pagination.").optional(),
     max_results: int().describe("Maximum number of results to return (1-500).").optional()
   };
@@ -71514,23 +72176,23 @@ var ListVideosGlobals$zodSchema, ListVideosRequest$zodSchema, ListVideosResponse
 var init_listvideosop = __esm(() => {
   init_zod();
   init_apierror();
-  init_direction();
-  init_fieldsspec();
+  init_deliverytypeall();
+  init_directionenum();
+  init_fields();
   init_listresponse();
-  init_liststoragetype();
   ListVideosGlobals$zodSchema = object({
     cloud_name: string2().describe("The cloud name of your product environment.").optional()
   });
   ListVideosRequest$zodSchema = object({
-    direction: Direction$zodSchema.optional().describe("Sort direction."),
-    fields: array(FieldsSpec$zodSchema).optional(),
+    direction: DirectionEnum$zodSchema.optional().describe('The sort direction for the results. Default is "desc".'),
+    fields: Fields$zodSchema.optional().describe("Additional fields to include in the response. The fields public_id and asset_id are always included."),
     max_results: int().describe("Maximum number of results to return (1-500).").optional(),
     next_cursor: string2().describe("Cursor for pagination.").optional(),
-    prefix: string2().describe("A public_id prefix. When specified, all assets with that prefix are returned. When using this, the `type` parameter must also be specified.").optional(),
+    prefix: string2().describe("A public_id prefix. When specified, all assets with that prefix are returned.").optional(),
     public_ids: array(string2()).describe("An array of public IDs to return.").optional(),
-    start_at: exports_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.").optional(),
-    tags: boolean2().describe("Whether to include the list of tag names assigned to each asset. Default: false").optional(),
-    type: ListStorageType$zodSchema.optional().describe("The delivery type. Necessary for prefix filtering.")
+    start_at: exports_iso.datetime({ offset: true }).describe("An ISO-8601 formatted timestamp. When specified, returns resources created since that timestamp. Supported only if neither `prefix` nor `public_ids` were passed.").optional(),
+    tags: boolean2().default(false).describe("Whether to include the list of tag names assigned to each asset. Default is false."),
+    type: DeliveryTypeAll$zodSchema.optional().describe("The delivery type to filter by. When omitted, returns assets of all delivery types.")
   });
   ListVideosResponse$zodSchema = union([
     ApiError$zodSchema,
@@ -71645,27 +72307,26 @@ var args11, tool$assetsListVideos;
 var init_assetsListVideos2 = __esm(() => {
   init_zod();
   init_assetsListVideos();
-  init_direction();
-  init_fieldsspec();
-  init_liststoragetype();
+  init_deliverytypeall();
+  init_directionenum();
+  init_fields();
   init_tools();
-  init_asset_gallery_widget();
   args11 = {
-    type: ListStorageType$zodSchema.optional().describe(`The delivery type. Necessary for prefix filtering.`),
-    prefix: string2().describe("A public_id prefix. When specified, all assets with that prefix are returned. When using this, the `type` parameter must also be specified.").optional(),
+    type: DeliveryTypeAll$zodSchema.optional().describe(`The delivery type to filter by. When omitted, returns assets of all delivery types.`),
+    prefix: string2().describe("A public_id prefix. When specified, all assets with that prefix are returned.").optional(),
     public_ids: array(string2()).describe("An array of public IDs to return.").optional(),
-    tags: boolean2().describe("Whether to include the list of tag names assigned to each asset. Default: false").optional(),
+    tags: boolean2().default(false).describe("Whether to include the list of tag names assigned to each asset. Default is false."),
     next_cursor: string2().describe("Cursor for pagination.").optional(),
     max_results: int().describe("Maximum number of results to return (1-500).").optional(),
-    direction: Direction$zodSchema.optional().describe(`Sort direction.`),
-    start_at: exports_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.").optional(),
-    fields: array(FieldsSpec$zodSchema).optional()
+    direction: DirectionEnum$zodSchema.optional().describe(`The sort direction for the results. Default is "desc".`),
+    start_at: exports_iso.datetime({ offset: true }).describe("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: Fields$zodSchema.optional().describe(`Additional fields to include in the response. The fields public_id and asset_id are always included.`)
   };
   tool$assetsListVideos = {
     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: {
@@ -71676,7 +72337,7 @@ Retrieves a list of video assets. Results can be filtered by various criteria li
       readOnlyHint: true
     },
     _meta: {
-      ui: { resourceUri: ASSET_GALLERY_RESOURCE_URI }
+      ui: { resourceUri: appUri("asset-gallery", "list-videos") }
     },
     args: args11,
     tool: async (client, args12, ctx) => {
@@ -71692,46 +72353,31 @@ Retrieves a list of video assets. Results can be filtered by various criteria li
   };
 });
 
-// src/models/storagetype.ts
-var StorageType$zodSchema;
-var init_storagetype = __esm(() => {
-  init_zod();
-  StorageType$zodSchema = _enum2([
-    "upload",
-    "private",
-    "authenticated"
-  ]).describe("The storage type of the resource.");
-});
-
 // src/models/renameassetop.ts
 var RenameAssetGlobals$zodSchema, RenameAssetRequestBody$zodSchema, RenameAssetRequest$zodSchema, RenameAssetResponse$zodSchema;
 var init_renameassetop = __esm(() => {
   init_zod();
   init_apierror();
   init_resourcetype();
-  init_storagetype();
+  init_uploaddeliverytype();
   init_uploadresponse();
   RenameAssetGlobals$zodSchema = object({
     cloud_name: string2().describe("The cloud name of your product environment.").optional()
   });
   RenameAssetRequestBody$zodSchema = object({
-    api_key: string2().optional().describe("The API key to use for the request. This is automatically computed by the Cloudinary's SDKs."),
-    context: string2().optional().describe("Context metadata to update during rename."),
+    context: boolean2().default(false).describe("Whether to include contextual metadata in the response. Default is false."),
     from_public_id: string2().describe("The public ID of the asset to rename."),
-    invalidate: boolean2().optional().describe("Whether to invalidate the CDN cache for the renamed asset."),
-    metadata: string2().optional().describe("Structured metadata to update during rename."),
+    invalidate: boolean2().default(false).describe("Whether to invalidate CDN cache copies of the renamed asset. Default is false."),
+    metadata: boolean2().default(false).describe("Whether to include structured metadata in the response. Default is false."),
     notification_url: string2().optional().describe("URL to notify when the operation is complete."),
-    overwrite: boolean2().optional().describe("Whether to overwrite the target asset if it already exists."),
-    signature: string2().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.
-`),
-    timestamp: int().optional().describe("The timestamp to use for the request in unix time. This is automatically computed by the Cloudinary's SDKs."),
+    overwrite: boolean2().default(false).describe("Whether to overwrite the target asset if it already exists. Default is false."),
     to_public_id: string2().describe("The new public ID for the asset."),
-    to_type: StorageType$zodSchema.optional().describe("The storage type of the resource."),
-    type: StorageType$zodSchema.optional().describe("The storage type of the resource.")
-  });
+    to_type: UploadDeliveryType$zodSchema.optional().describe("The target delivery type for the renamed asset. If omitted, the delivery type remains unchanged."),
+    type: UploadDeliveryType$zodSchema.optional().describe("The current delivery type of the asset.")
+  }).describe("The rename request parameters.");
   RenameAssetRequest$zodSchema = object({
-    RequestBody: lazy(() => RenameAssetRequestBody$zodSchema),
-    resource_type: ResourceType$zodSchema.describe("The type of resource.")
+    RequestBody: lazy(() => RenameAssetRequestBody$zodSchema).describe("The rename request parameters."),
+    resource_type: ResourceType$zodSchema.describe("The type of resource (image, video, or raw).")
   });
   RenameAssetResponse$zodSchema = union([
     ApiError$zodSchema,
@@ -71834,8 +72480,8 @@ var init_assetsRenameAsset2 = __esm(() => {
   init_resourcetype();
   init_tools();
   args12 = {
-    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.`)
   };
   tool$assetsRenameAsset = {
     name: "asset-rename",
@@ -71863,11 +72509,13 @@ var init_assetsRenameAsset2 = __esm(() => {
 });
 
 // src/models/resourceupdaterequest.ts
-var ModerationStatus$zodSchema, ResourceUpdateRequest$zodSchema;
+var ResourceUpdateRequestModerationStatus$zodSchema, ResourceUpdateRequest$zodSchema;
 var init_resourceupdaterequest = __esm(() => {
   init_zod();
   init_accesscontrolitem();
-  ModerationStatus$zodSchema = _enum2([
+  init_structuredmetadataparam();
+  init_tagsparam();
+  ResourceUpdateRequestModerationStatus$zodSchema = _enum2([
     "approved",
     "rejected"
   ]).describe("The moderation status of the resource.");
@@ -71880,21 +72528,22 @@ The asset is restricted unless at least one listed access type is valid.
     background_removal: string2().optional().describe("The background removal provider to use for the resource. Optionally append a template suffix (e.g., cloudinary_ai:fine_edges)."),
     categorization: string2().optional().describe("The type of categorization to perform on the resource. Optionally append a language code suffix (e.g., google_tagging:fr)."),
     clear_invalid: boolean2().default(false).describe("Whether to clear invalid metadata fields. If false, invalid fields will be preserved. Default: false"),
-    context: string2().optional().describe("A pipe-separated list of key-value pairs of contextual metadata."),
+    context: string2().optional().describe('A pipe-separated list of key-value pairs of general textual context metadata to attach to the asset (e.g., "alt=My image|caption=Nice photo"). The =, ", and | characters can be escaped with a prepending backslash (\\).'),
     custom_coordinates: string2().optional().describe("Custom coordinates as comma-separated values, with multiple coordinates separated by pipes."),
     detection: string2().optional().describe("The type of detection to perform on the resource."),
     display_name: string2().optional().describe("The display name of the resource."),
     face_coordinates: string2().optional().describe("Face coordinates as comma-separated values, with multiple faces separated by pipes."),
-    metadata: string2().optional().describe("A pipe-separated list of custom metadata fields (by external_id) and their values."),
-    moderation_status: ModerationStatus$zodSchema.optional().describe("The moderation status of the resource."),
+    metadata: StructuredMetadataParam$zodSchema.optional().describe(`A pipe-separated list or a map of custom metadata fields (by external_id) and the values to assign to each of them. The = " and | characters can be supported as values when escaped with a prepended backslash (\\). For a multi-select field, you can set a maximum of 3000 different metadata values on an asset.
+`),
+    moderation_status: ResourceUpdateRequestModerationStatus$zodSchema.optional().describe("The moderation status of the resource."),
     ocr: string2().optional().describe("The type of OCR to perform on the resource. Set to adv_ocr, optionally with options (e.g., adv_ocr:document)."),
     quality_override: string2().optional().describe("Quality override value that will override any automatic quality transformations."),
     raw_convert: string2().optional().describe("The conversion to apply for raw files (e.g., aspose, google_speech, extract_text)."),
-    regions: string2().optional().describe("Named groups of coordinate pairs representing regions."),
-    tags: string2().optional().describe("A comma-separated list of tags to assign to the resource."),
+    regions: string2().optional().describe("A JSON-encoded object of named groups of coordinate pairs representing regions. Each region name may contain only letters, numbers, or hyphens, and must have at least two coordinate pairs."),
+    tags: TagsParam$zodSchema.optional().describe("A comma-separated list of tag names, or an array of tag names."),
     unique_display_name: boolean2().default(false).describe("Whether to ensure the display name is unique across all resources. If false, the operation will fail if a resource with the same display name exists. Default: false"),
     visual_search: boolean2().optional().describe("Whether to index the resource with visual search. If true, the resource will be indexed for visual search capabilities. Default: false")
-  });
+  }).describe("The resource properties to update.");
 });
 
 // src/models/updateresourcebyassetidop.ts
@@ -71908,7 +72557,7 @@ var init_updateresourcebyassetidop = __esm(() => {
     cloud_name: string2().describe("The cloud name of your product environment.").optional()
   });
   UpdateResourceByAssetIdRequest$zodSchema = object({
-    ResourceUpdateRequest: ResourceUpdateRequest$zodSchema,
+    ResourceUpdateRequest: ResourceUpdateRequest$zodSchema.describe("The asset attributes to update."),
     asset_id: string2().describe("The asset ID of the resource. Must be a 32-character hexadecimal string.")
   });
   UpdateResourceByAssetIdResponse$zodSchema = union([
@@ -72015,13 +72664,13 @@ var init_assetsUpdateResourceByAssetId2 = __esm(() => {
   init_tools();
   args13 = {
     asset_id: string2().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.`)
   };
   tool$assetsUpdateResourceByAssetId = {
     name: "asset-update",
     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: {
@@ -72045,25 +72694,32 @@ Updates one or more attributes of a specified resource (asset) by its asset ID.
   };
 });
 
+// src/models/createfolderresponse.ts
+var CreateFolderResponse$zodSchema;
+var init_createfolderresponse = __esm(() => {
+  init_zod();
+  CreateFolderResponse$zodSchema = object({
+    name: string2().optional().describe("The name of the created folder."),
+    path: string2().optional().describe("The path of the created folder."),
+    success: boolean2().optional().describe("Whether the operation was successful.")
+  });
+});
+
 // src/models/createfolderop.ts
-var CreateFolderGlobals$zodSchema, CreateFolderRequest$zodSchema, CreateFolderResponseBody$zodSchema, CreateFolderResponse$zodSchema;
+var CreateFolderGlobals$zodSchema, CreateFolderRequest$zodSchema, CreateFolderResponseResponse$zodSchema;
 var init_createfolderop = __esm(() => {
   init_zod();
   init_apierror();
+  init_createfolderresponse();
   CreateFolderGlobals$zodSchema = object({
     cloud_name: string2().describe("The cloud name of your product environment.").optional()
   });
   CreateFolderRequest$zodSchema = object({
-    folder: string2()
-  });
-  CreateFolderResponseBody$zodSchema = object({
-    name: string2().optional().describe("The name of the created folder"),
-    path: string2().optional().describe("The path of the created folder"),
-    success: boolean2().optional().describe("Whether the operation was successful")
-  }).describe("Folder created successfully");
-  CreateFolderResponse$zodSchema = union([
+    folder: string2().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.")
+  });
+  CreateFolderResponseResponse$zodSchema = union([
     ApiError$zodSchema,
-    lazy(() => CreateFolderResponseBody$zodSchema)
+    CreateFolderResponse$zodSchema
   ]);
 });
 
@@ -72159,7 +72815,7 @@ var init_foldersCreateFolder2 = __esm(() => {
   init_foldersCreateFolder();
   init_tools();
   args14 = {
-    folder: string2()
+    folder: string2().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.")
   };
   tool$foldersCreateFolder = {
     name: "create-folder",
@@ -72188,22 +72844,29 @@ Creates a new folder at the specified path`,
   };
 });
 
+// src/models/deletefolderresponse.ts
+var DeleteFolderResponse$zodSchema;
+var init_deletefolderresponse = __esm(() => {
+  init_zod();
+  DeleteFolderResponse$zodSchema = object({
+    deleted: array(string2()).describe("List of deleted folder paths.")
+  });
+});
+
 // src/models/destroyfolderop.ts
-var DestroyFolderGlobals$zodSchema, DestroyFolderRequest$zodSchema, DestroyFolderResponseBody$zodSchema, DestroyFolderResponse$zodSchema;
+var DestroyFolderGlobals$zodSchema, DestroyFolderRequest$zodSchema, DestroyFolderResponse$zodSchema;
 var init_destroyfolderop = __esm(() => {
   init_zod();
   init_apierror();
+  init_deletefolderresponse();
   DestroyFolderGlobals$zodSchema = object({
     cloud_name: string2().describe("The cloud name of your product environment.").optional()
   });
   DestroyFolderRequest$zodSchema = object({
-    folder: string2()
+    folder: string2().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.")
   });
-  DestroyFolderResponseBody$zodSchema = object({
-    deleted: array(string2()).describe("List of deleted folder paths")
-  }).describe("Folder deleted successfully");
   DestroyFolderResponse$zodSchema = union([
-    lazy(() => DestroyFolderResponseBody$zodSchema),
+    DeleteFolderResponse$zodSchema,
     ApiError$zodSchema
   ]);
 });
@@ -72300,7 +72963,7 @@ var init_foldersDestroyFolder2 = __esm(() => {
   init_foldersDestroyFolder();
   init_tools();
   args15 = {
-    folder: string2()
+    folder: string2().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.")
   };
   tool$foldersDestroyFolder = {
     name: "delete-folder",
@@ -72355,27 +73018,20 @@ var init_folderssearchresponse = __esm(() => {
 });
 
 // src/models/searchfoldersop.ts
-var SearchFoldersGlobals$zodSchema, Expression$zodSchema, ExpressionUnion$zodSchema, SearchFoldersRequest$zodSchema, SearchFoldersResponse$zodSchema;
+var SearchFoldersGlobals$zodSchema, SearchFoldersRequest$zodSchema, SearchFoldersResponse$zodSchema;
 var init_searchfoldersop = __esm(() => {
   init_zod();
   init_apierror();
+  init_directionenum();
   init_folderssearchresponse();
   SearchFoldersGlobals$zodSchema = object({
     cloud_name: string2().describe("The cloud name of your product environment.").optional()
   });
-  Expression$zodSchema = object({});
-  ExpressionUnion$zodSchema = union([
-    string2(),
-    lazy(() => Expression$zodSchema)
-  ]).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).");
   SearchFoldersRequest$zodSchema = object({
-    expression: union([
-      string2(),
-      lazy(() => Expression$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)."),
+    expression: string2().describe("The (Lucene-like) string expression specifying the search query. If not passed, returns all folders (up to max_results).").optional(),
     max_results: int().default(50).describe("Maximum number of folders to return (max 500, default 50)."),
     next_cursor: string2().describe("The cursor for pagination. Use the next_cursor value from a previous response to get the next page of results.").optional(),
-    sort_by: array(string2()).describe("An array of key-value pairs for sorting. Each value is a key and direction (asc/desc).").optional()
+    sort_by: array(record(string2(), DirectionEnum$zodSchema)).describe("Sort order for the results. Each item maps a field name to a direction.").optional()
   });
   SearchFoldersResponse$zodSchema = union([
     FoldersSearchResponse$zodSchema,
@@ -72479,11 +73135,11 @@ var args16, tool$foldersSearchFolders;
 var init_foldersSearchFolders2 = __esm(() => {
   init_zod();
   init_foldersSearchFolders();
-  init_searchfoldersop();
+  init_directionenum();
   init_tools();
   args16 = {
-    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: array(string2()).describe("An array of key-value pairs for sorting. Each value is a key and direction (asc/desc).").optional(),
+    expression: string2().describe("The (Lucene-like) string expression specifying the search query. If not passed, returns all folders (up to max_results).").optional(),
+    sort_by: array(record(string2(), DirectionEnum$zodSchema)).describe("Sort order for the results. Each item maps a field name to a direction.").optional(),
     max_results: int().default(50).describe("Maximum number of folders to return (max 500, default 50)."),
     next_cursor: string2().describe("The cursor for pagination. Use the next_cursor value from a previous response to get the next page of results.").optional()
   };
@@ -72515,54 +73171,73 @@ Lists the folders that match the specified search expression. Limited to 2000 re
   };
 });
 
+// src/models/movefolderrequest.ts
+var MoveFolderRequest$zodSchema;
+var init_movefolderrequest = __esm(() => {
+  init_zod();
+  MoveFolderRequest$zodSchema = object({
+    to_folder: string2().describe("The new path for the folder.")
+  }).describe("The folder move/rename request.");
+});
+
+// src/models/foldernamepath.ts
+var FolderNamePath$zodSchema;
+var init_foldernamepath = __esm(() => {
+  init_zod();
+  FolderNamePath$zodSchema = object({
+    name: string2().describe("The name of the folder."),
+    path: string2().describe("The full path of the folder.")
+  });
+});
+
+// src/models/movefolderresponse.ts
+var MoveFolderResponse$zodSchema;
+var init_movefolderresponse = __esm(() => {
+  init_zod();
+  init_foldernamepath();
+  MoveFolderResponse$zodSchema = object({
+    from: FolderNamePath$zodSchema,
+    to: FolderNamePath$zodSchema
+  });
+});
+
 // src/models/updatefolderop.ts
-var UpdateFolderGlobals$zodSchema, UpdateFolderRequestBody$zodSchema, UpdateFolderRequest$zodSchema, From$zodSchema, To$zodSchema, UpdateFolderResponseBody$zodSchema, UpdateFolderResponse$zodSchema;
+var UpdateFolderGlobals$zodSchema, UpdateFolderRequest$zodSchema, UpdateFolderResponse$zodSchema;
 var init_updatefolderop = __esm(() => {
   init_zod();
   init_apierror();
+  init_movefolderrequest();
+  init_movefolderresponse();
   UpdateFolderGlobals$zodSchema = object({
     cloud_name: string2().describe("The cloud name of your product environment.").optional()
   });
-  UpdateFolderRequestBody$zodSchema = object({
-    to_folder: string2().describe("The new path for the folder.")
-  });
   UpdateFolderRequest$zodSchema = object({
-    RequestBody: lazy(() => UpdateFolderRequestBody$zodSchema),
-    folder: string2()
-  });
-  From$zodSchema = object({
-    name: string2().describe("The name of the source folder."),
-    path: string2().describe("The full path of the source folder.")
+    folder: string2().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.")
   });
-  To$zodSchema = object({
-    name: string2().describe("The name of the target folder."),
-    path: string2().describe("The full path of the target folder.")
-  });
-  UpdateFolderResponseBody$zodSchema = object({
-    from: lazy(() => From$zodSchema),
-    to: lazy(() => To$zodSchema)
-  }).describe("Folder renamed successfully");
   UpdateFolderResponse$zodSchema = union([
-    lazy(() => UpdateFolderResponseBody$zodSchema),
+    MoveFolderResponse$zodSchema,
     ApiError$zodSchema
   ]);
 });
 
 // src/funcs/foldersUpdateFolder.ts
-function foldersUpdateFolder(client$, folder, RequestBody, options) {
-  return new APIPromise($do18(client$, folder, RequestBody, options));
+function foldersUpdateFolder(client$, folder, move_folder_request, options) {
+  return new APIPromise($do18(client$, folder, move_folder_request, options));
 }
-async function $do18(client$, folder, RequestBody, options) {
+async function $do18(client$, folder, move_folder_request, options) {
   const input$ = {
     folder,
-    RequestBody
+    move_folder_request
   };
   const parsed$ = safeParse4(input$, (value$) => UpdateFolderRequest$zodSchema.parse(value$), "Input validation failed");
   if (!parsed$.ok) {
     return [parsed$, { status: "invalid" }];
   }
   const payload$ = parsed$.value;
-  const body$ = encodeJSON("body", payload$.RequestBody, { explode: true });
+  const body$ = encodeJSON("body", payload$.move_folder_request, {
+    explode: true
+  });
   const pathParams$ = {
     cloud_name: encodeSimple("cloud_name", client$._options.cloud_name, {
       explode: false,
@@ -72640,11 +73315,11 @@ var args17, tool$foldersUpdateFolder;
 var init_foldersUpdateFolder2 = __esm(() => {
   init_zod();
   init_foldersUpdateFolder();
-  init_updatefolderop();
+  init_movefolderrequest();
   init_tools();
   args17 = {
-    folder: string2(),
-    RequestBody: UpdateFolderRequestBody$zodSchema
+    folder: string2().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.`)
   };
   tool$foldersUpdateFolder = {
     name: "move-folder",
@@ -72661,7 +73336,7 @@ Renames or moves an entire folder (along with all assets it contains) to a new l
     },
     args: args17,
     tool: async (client, args18, ctx) => {
-      const [result] = await foldersUpdateFolder(client, args18.folder, args18.RequestBody, { fetchOptions: { signal: ctx.signal } }).$inspect();
+      const [result] = await foldersUpdateFolder(client, args18.folder, args18.move_folder_request, { fetchOptions: { signal: ctx.signal } }).$inspect();
       if (!result.ok) {
         return {
           content: [{ type: "text", text: result.error.message }],
@@ -72673,34 +73348,25 @@ Renames or moves an entire folder (along with all assets it contains) to a new l
   };
 });
 
-// src/models/searchsortpair.ts
-var SearchSortPair$zodSchema;
-var init_searchsortpair = __esm(() => {
-  init_zod();
-  SearchSortPair$zodSchema = _enum2([
-    "asc",
-    "desc"
-  ]);
-});
-
 // src/models/searchparameters.ts
-var SearchParametersType$zodSchema, SearchParametersRange$zodSchema, Aggregate$zodSchema, AggregateEnum$zodSchema, AggregateUnion$zodSchema, WithField$zodSchema, SearchParameters$zodSchema;
+var Type$zodSchema, SearchParametersRange$zodSchema, Aggregate$zodSchema, AggregateEnum$zodSchema, AggregateUnion$zodSchema, WithField$zodSchema, SearchParameters$zodSchema;
 var init_searchparameters = __esm(() => {
   init_zod();
-  init_searchsortpair();
-  SearchParametersType$zodSchema = _enum2([
+  init_directionenum();
+  Type$zodSchema = _enum2([
     "bytes",
     "image_pixels",
     "video_pixels",
     "duration"
   ]);
   SearchParametersRange$zodSchema = object({
-    from: number2().optional().describe("Start of the range (inclusive)"),
-    to: number2().optional().describe("End of the range (exclusive)")
+    from: number2().optional().describe("Start of the range (inclusive). At least one of `from` / `to` is required."),
+    key: string2().describe("A label for the bucket, returned in the aggregation response. 1–20 chars, alphanumeric plus `-` and `_`."),
+    to: number2().optional().describe("End of the range (exclusive). At least one of `from` / `to` is required.")
   });
   Aggregate$zodSchema = object({
-    ranges: array(lazy(() => SearchParametersRange$zodSchema)),
-    type: SearchParametersType$zodSchema
+    ranges: array(lazy(() => SearchParametersRange$zodSchema)).describe("One or more ranges for the numeric field. Each range must include a `key` label and at least one of `from` / `to`.\n"),
+    type: Type$zodSchema
   });
   AggregateEnum$zodSchema = _enum2([
     "format",
@@ -72710,7 +73376,8 @@ var init_searchparameters = __esm(() => {
   AggregateUnion$zodSchema = union([
     array(AggregateEnum$zodSchema),
     array(lazy(() => Aggregate$zodSchema))
-  ]);
+  ]).describe(`Fields or ranges to aggregate search results by. Requires a Tier 2 search plan; on Tier 1 the field is accepted but aggregations are omitted from the response.
+`);
   WithField$zodSchema = _enum2([
     "context",
     "tags",
@@ -72724,19 +73391,20 @@ var init_searchparameters = __esm(() => {
     aggregate: union([
       array(AggregateEnum$zodSchema),
       array(lazy(() => Aggregate$zodSchema))
-    ]).optional(),
-    expression: string2().optional().describe("The search expression. Supports exact match, wildcard match, presence, greater/less than, and range. For details on building expressions, see the Search API documentation."),
+    ]).optional().describe(`Fields or ranges to aggregate search results by. Requires a Tier 2 search plan; on Tier 1 the field is accepted but aggregations are omitted from the response.
+`),
+    expression: string2().optional().describe('The Lucene-like search expression. Supports token match (`:`), exact match (`=`), trailing `*` for prefix match, ranges (`[a TO b]`, `{a TO b}`), and comparisons (`>`, `<`, `>=`, `<=`). Combine terms with uppercase `AND`, `OR`, `NOT`, or `+`/`-`. `NOT` must appear between clauses — a leading `NOT` is a parse error; use `-field:value` to negate the first clause. Group with parentheses.\n\nWrap values containing spaces, colons, or other reserved characters (`! ( ) { } [ ] ^ ~ ?  \\ = & < > |`) in double quotes, e.g. `tags:"service:mantels"`, `aspect_ratio:"16:9"`. Send raw `<`/`>`, never HTML-escaped.\n\nWildcards are prefix-only (trailing `*`). A bare `*` (e.g. `folder:*`, `context.alt:*`, `metadata.key:*`, `tags:*`, `-tags:*`) is a parse error — there is no "has any value" / presence probe. Either drop the clause, use a concrete prefix, or filter on a known token.\n\nDates: ISO-8601 in quotes, or relative shorthand `1h`, `1d`, `1w`, `1m`, `1y` (`uploaded_at>1d`, `created_at:[4w TO 1w]`).\n\nSupported fields: `public_id`, `asset_id`, `filename`, `display_name`, `folder` / `asset_folder` (singular, not `folders`), `tags`, `context.<key>`, `metadata.<external_id>`, `resource_type`, `type`, `format`, `bytes`, `width`, `height`, `duration`, `pages`, `aspect_ratio`, `transparent`, `grayscale`, `status`, `moderation_status`, `moderation_kind`, `uploaded_at`, `created_at`, `taken_at`, `updated_at`, `last_updated.<kind>`, `face_count`, `illustration_score`, `quality_score`. Fields under `image_metadata.*`, `image_analysis.*`, `quality_analysis.*`, and `accessibility_analysis.*` also require the matching `with_field` to be returned in the response.\n\nSee the [search expressions guide](https://cloudinary.com/documentation/search_expressions.md) for the full reference.\n'),
     fields: string2().optional().describe(`A comma-separated list of fields to include in the response.
 Notes:
 - This parameter takes precedence over the with_field parameter, so if you want any additional asset attributes returned, make sure to also include them in this list (e.g., tags or context).
 - The following fields are always included in the response: public_id, asset_id, asset_folder, created_at, status, type, and resource_type.
 `),
-    max_results: int().optional().describe("The maximum number of results to return. Default - 50. Maximum - 500."),
+    max_results: int().optional().describe("The maximum number of results to return. Default - 50. Maximum - 500.\nSet to `0` to get only `total_count` and `aggregations` without any resources in the response — useful for counting or aggregation-only queries.\n"),
     next_cursor: string2().optional().describe("The cursor value to get the next page of results. Available when a previous search returned more results than max_results."),
-    sort_by: array(record(string2(), SearchSortPair$zodSchema)).optional().describe(`An array of single-key objects mapping a field to a sort direction. Each object must contain exactly one field name mapped to 'asc' or 'desc'.
+    sort_by: array(record(string2(), DirectionEnum$zodSchema)).optional().describe(`An array of single-key objects mapping a field to a sort direction. Each object must contain exactly one field name mapped to 'asc' or 'desc'.
 Default: [{"created_at": "desc"}].
 `),
-    with_field: array(WithField$zodSchema).optional().describe("The additional fields to include in the response. Note that the fields parameter takes precedence over this parameter.")
+    with_field: array(WithField$zodSchema).optional().describe("The additional asset attributes to include in each search result. The `fields` parameter takes precedence over this parameter. `image_metadata`, `image_analysis`, and `metadata` require a Tier 2 search plan.\n")
   }).describe("Common parameters for resource search operations.");
 });
 
@@ -72825,9 +73493,8 @@ var init_searchSearchAssets2 = __esm(() => {
   init_searchSearchAssets();
   init_searchparameters();
   init_tools();
-  init_asset_gallery_widget();
   args18 = {
-    request: SearchParameters$zodSchema
+    request: SearchParameters$zodSchema.describe(`The search query parameters.`)
   };
   tool$searchSearchAssets = {
     name: "search-assets",
@@ -72835,9 +73502,53 @@ var init_searchSearchAssets2 = __esm(() => {
 
 Returns a list of resources matching the specified search criteria.
 
-Uses Lucene-like query language to search by descriptive attributes (public_id, filename, folder, tags, context), file details (resource_type, format, bytes, width, height), embedded data (image_metadata), and analyzed data (face_count, colors, quality_score). Supports aggregate counts and complex Boolean expressions.
-
-Examples: tags:shirt AND uploaded_at>1d, resource_type:image AND bytes>1mb, folder:products OR context.category:electronics
+Uses a Lucene-like query language to filter assets by descriptive attributes (\`public_id\`, \`asset_id\`, \`filename\`, \`display_name\`, \`folder\` / \`asset_folder\`, \`tags\`, \`context.<key>\`), file details (\`resource_type\`, \`type\`, \`format\`, \`bytes\`, \`width\`, \`height\`, \`duration\`, \`pages\`, \`aspect_ratio\`, \`transparent\`, \`grayscale\`), lifecycle dates (\`uploaded_at\`, \`created_at\`, \`taken_at\`, \`updated_at\`, \`last_updated.<kind>\`), moderation and lifecycle state (\`status\`, \`moderation_status\`, \`moderation_kind\`), embedded data (\`image_metadata.*\`), structured metadata (\`metadata.<external_id>\`), and analysis fields (\`face_count\`, \`colors\`, \`quality_score\`, \`illustration_score\`, \`accessibility_analysis.*\`). Supports sorting, aggregate counts, and complex boolean expressions. See the \`expression\` parameter for the full field reference.
+
+## Expression syntax
+
+- **Match**: \`field:value\` (token match) or \`field=value\` (exact match). Examples: \`tags:shirt\`, \`tags=cotton\`.
+- **Comparisons**: \`>\`, \`<\`, \`>=\`, \`<=\` for numbers and dates. Example: \`bytes>10000000\`.
+- **Ranges**: \`field:[from TO to]\` inclusive, \`field:{from TO to}\` exclusive. Example: \`width:{200 TO 1028}\`.
+- **Booleans**: \`AND\`, \`OR\`, \`NOT\` (uppercase), or \`+\` (must), \`-\` (must not). \`NOT\` must appear between clauses — a bare leading \`NOT\` is a parse error; use \`-field:value\` to negate the first clause. Group with parentheses: \`(shirt OR pants) AND clothes\`.
+- **Wildcards**: trailing \`*\` only, for prefix match (\`public_id:shoes_*\`, \`format:jp*\`, \`tags:shirt*\`). Not supported on \`folder\`, \`asset_folder\`, \`resource_type\`, or \`type\`. Leading \`*\`, middle \`*\`, \`?\`, and bare \`*\` (\`folder:*\`, \`context.alt:*\`) are all parse errors — wildcards cannot be used as a "field is present" probe.
+- **Tokenized vs exact fields**: \`tags\`, \`filename\`, \`display_name\`, \`context.<key>\`, and \`metadata.<id>\` match on tokens split by whitespace and punctuation — \`tags:analysis\` matches the tag \`full-analysis\`. \`public_id\`, \`folder\`, \`asset_folder\`, and \`format\` match the whole value — \`public_id:dog\` will not match \`dog_pldcwy\`; use \`public_id="dog_pldcwy"\` (exact) or \`public_id:dog*\` (prefix). These exact-match fields still accept a trailing \`*\` for prefix match (except \`folder\` / \`asset_folder\`, where wildcards are ignored).
+- **Dates**: ISO-8601 in quotes (\`uploaded_at>"2024-01-15"\`) or relative shorthand \`Nh\`, \`Nd\`, \`Nw\`, \`Nm\`, \`Ny\` (\`uploaded_at>1d\`, \`created_at:[4w TO 1w]\`). Send raw \`<\`/\`>\`, never HTML-escaped.
+- **Quoting**: wrap any value containing a space, colon, or other reserved character (\`! ( ) { } [ ] ^ ~ ?  \\ = & < > |\`) in double quotes, or escape each character with \`\\\`. Examples: \`tags:"service:mantels"\`, \`aspect_ratio:"16:9"\`, \`folder:"My Folder"\`.
+
+## Common mistakes
+
+- Use \`folder:\` or \`asset_folder:\` (singular); \`folders:\`, \`asset_folder_id:\`, and other invented variants are not valid fields. Pass the exact folder name — wildcards do not apply here.
+- There is no "has any value" / presence probe. \`folder:*\`, \`metadata.alt:*\`, \`context.key:*\`, \`tags:*\`, and \`-tags:*\` are all parse errors. See *"Which assets have any value for \`metadata.<id>\`?"* under **Common tasks** for workarounds.
+- \`NOT foo AND bar\` is a parse error. Write it as \`bar AND NOT foo\` or \`-foo AND bar\`, and keep every \`NOT\` between two clauses (\`a AND NOT b AND NOT c\` is fine; \`NOT b AND NOT c …\` is not).
+- \`public_id:dog\` will not match \`dog_pldcwy\`. Use \`public_id="dog_pldcwy"\` (exact) or \`public_id:dog*\` (prefix).
+- \`tags=service:mantels\` fails because the unquoted colon is parsed as a field separator. Use \`tags="service:mantels"\` or \`tags=service\\:mantels\`.
+- Do not HTML-escape operators. Send \`uploaded_at<1h\`, not \`uploaded_at&lt;1h\`.
+- Do not leave an operand empty (e.g. \`tags: AND -tags:foo\`). Omit the empty clause entirely.
+
+## Tips
+
+- Set \`max_results: 0\` to return only \`total_count\` and \`aggregations\` without any resource payload — useful for counts and aggregation-only queries.
+- \`total_count\` is always present in the response; prefer it over running an aggregation just to get a count.
+- \`aggregate\` (both simple and range variants) and the \`metadata\`, \`image_metadata\`, \`image_analysis\` values of \`with_field\` require a Tier 2 search plan.
+- Range aggregations require each range to include a \`key\` label (1–20 chars, \`[a-zA-Z0-9_-]+\`) and at least one of \`from\` / \`to\`.
+
+## Common tasks
+
+- **Count matching assets** — put the filter in \`expression\` with \`max_results: 0\` and read \`total_count\` from the response. Works on every tier; no \`aggregate\` needed.
+- **Preview one matching asset** — set \`max_results: 1\`; add \`with_field: ["tags", "context"]\` (or \`metadata\`, Tier 2) to inspect values. Prefer this over fetching and scanning a full page.
+- **Distribution of values for a field** — Tier 2: \`aggregate: [format|resource_type|type]\` for enum counts, or range aggregations on \`bytes\`, \`image_pixels\`, \`video_pixels\`, or \`duration\`. Tier 1 fallback: run N small queries with \`max_results: 0\`, one per candidate value, and read \`total_count\` from each.
+- **"Which assets have any value for \`metadata.<id>\`?"** — not expressible directly (\`metadata.X:*\` is a parse error; there is no presence probe). Workarounds: (a) if the field has a known value set, enumerate — \`metadata.region:(apac OR emea OR amer)\`; (b) query broadly with \`with_field: ["metadata"]\` (Tier 2) and filter client-side for entries where the field is set; (c) at ingest time, attach a sentinel tag whenever the field is set, then search by that tag.
+- **Newest / largest N** — keep the filter in \`expression\` and sort explicitly: \`sort_by: [{uploaded_at: "desc"}]\` with \`max_results: 10\`.
+- **Filter by folder** — both \`asset_folder:"parent/child"\` and \`folder:"parent/child"\` match an exact folder path; there is no wildcard or "contains". To query across multiple folders, enumerate: \`asset_folder:("campaigns/2024" OR "campaigns/2025")\`.
+- **Filter by metadata when you only know the label** — first call \`list-metadata-fields\` to resolve the label to an \`external_id\`, then query \`metadata.<external_id>:value\`.
+- **Multiple independent filters in one turn** — prefer one \`expression\` with \`OR\` / parentheses over firing many parallel calls: \`metadata.region:apac OR metadata.region:emea\` in a single request is faster and more reliable than two parallel requests.
+
+## Examples
+
+- \`tags:shirt AND uploaded_at>1d\`
+- \`resource_type:image AND bytes>1000000 AND (format:png OR format:jpg)\`
+- \`folder:products AND context.category:electronics\`
+- \`tags:"service:mantels" AND -tags:discontinued\`
 `,
     scopes: ["librarian"],
     annotations: {
@@ -72848,7 +73559,7 @@ Examples: tags:shirt AND uploaded_at>1d, resource_type:image AND bytes>1mb, fold
       readOnlyHint: true
     },
     _meta: {
-      ui: { resourceUri: ASSET_GALLERY_RESOURCE_URI }
+      ui: { resourceUri: appUri("asset-gallery", "search-assets") }
     },
     args: args18,
     tool: async (client, args19, ctx) => {
@@ -72973,7 +73684,7 @@ var init_searchVisualSearchAssets2 = __esm(() => {
   init_visualsearchparametersunion();
   init_tools();
   args19 = {
-    request: VisualSearchParametersUnion$zodSchema
+    request: VisualSearchParametersUnion$zodSchema.describe(`The visual search parameters.`)
   };
   tool$searchVisualSearchAssets = {
     name: "visual-search-assets",
@@ -72981,7 +73692,7 @@ var init_searchVisualSearchAssets2 = __esm(() => {
 
 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"],
@@ -73011,7 +73722,7 @@ var AsyncUploadResponseStatus$zodSchema, AsyncUploadResponse$zodSchema;
 var init_asyncuploadresponse = __esm(() => {
   init_zod();
   init_resourcetype();
-  init_storagetype();
+  init_uploaddeliverytype();
   AsyncUploadResponseStatus$zodSchema = _enum2([
     "pending"
   ]).describe("The status of the asynchronous upload. Will be 'pending' for async uploads.");
@@ -73021,7 +73732,7 @@ var init_asyncuploadresponse = __esm(() => {
     requester_ip: string2().optional().describe("The IP address of the requester. This is only included if a product environment has requester_ip tracking enabled."),
     resource_type: ResourceType$zodSchema.optional().describe("The type of resource."),
     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)");
 });
 
@@ -73038,13 +73749,8 @@ var init_uploadop = __esm(() => {
     cloud_name: string2().describe("The cloud name of your product environment.").optional()
   });
   UploadRequestRequest$zodSchema = object({
-    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
-`),
-    upload_request: UploadRequest$zodSchema
+    resource_type: UploadResourceType$zodSchema.default("auto").describe("The type of resource (image, video, raw, or auto)."),
+    upload_request: UploadRequest$zodSchema.describe("The file to upload and associated parameters.")
   });
   UploadResponseBody$zodSchema = union([
     AsyncUploadResponse$zodSchema,
@@ -73153,16 +73859,10 @@ var init_uploadUpload2 = __esm(() => {
   init_uploadUpload();
   init_uploadrequest();
   init_uploadresourcetype();
-  init_asset_upload_widget();
   init_tools();
   args20 = {
-    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
-`),
-    upload_request: UploadRequest$zodSchema
+    resource_type: UploadResourceType$zodSchema.default("auto").describe(`The type of resource (image, video, raw, or auto).`),
+    upload_request: UploadRequest$zodSchema.describe(`The file to upload and associated parameters.`)
   };
   tool$uploadUpload = {
     name: "upload-asset",
@@ -73192,7 +73892,7 @@ Transform media files using transformation syntax in delivery URLs, which create
       readOnlyHint: false
     },
     _meta: {
-      ui: { resourceUri: ASSET_UPLOAD_RESOURCE_URI }
+      ui: { resourceUri: appUri("asset-upload", "upload-asset") }
     },
     args: args20,
     tool: async (client, args21, ctx) => {
@@ -73270,7 +73970,7 @@ var init_getusageop = __esm(() => {
     cloud_name: string2().describe("The cloud name of your product environment.").optional()
   });
   GetUsageRequest$zodSchema = object({
-    date: string2().date().optional()
+    date: string2().date().describe("The date for which to retrieve usage details (YYYY-MM-DD). If not specified, returns the current usage.").optional()
   });
   GetUsageResponse$zodSchema = union([
     ApiError$zodSchema,
@@ -73370,7 +74070,7 @@ var init_usageGetUsage2 = __esm(() => {
   init_usageGetUsage();
   init_tools();
   args21 = {
-    date: string2().date().optional()
+    date: string2().date().describe("The date for which to retrieve usage details (YYYY-MM-DD). If not specified, returns the current usage.").optional()
   };
   tool$usageGetUsage = {
     name: "get-usage-details",
@@ -73403,7 +74103,7 @@ A report on the status of product environment usage, including storage, credits,
 function createMCPServer(deps) {
   const server = new McpServer({
     name: "CloudinaryAssetMgmt",
-    version: "0.9.0-rc.0"
+    version: "0.9.1"
   });
   const getClient = deps.getSDK || (() => new CloudinaryAssetMgmtCore({
     security: deps.security,
@@ -73420,7 +74120,7 @@ function createMCPServer(deps) {
   }));
   const scopes = new Set(deps.scopes);
   const allowedTools = deps.allowedTools && new Set(deps.allowedTools);
-  const [tool, tools, toolMap] = createRegisterTool(deps.logger, server, getClient, scopes, allowedTools, deps.dynamic, deps.annotationFilter);
+  const [tool, tools, toolMap] = createRegisterTool(deps.logger, server, getClient, scopes, allowedTools, deps.dynamic, deps.annotationFilter, deps.mcpApps);
   const resource = createRegisterResource(deps.logger, server, getClient, scopes);
   const resourceTemplate = createRegisterResourceTemplate(deps.logger, server, getClient, scopes);
   const prompt = createRegisterPrompt(deps.logger, server, getClient, scopes);
@@ -73449,7 +74149,7 @@ function createMCPServer(deps) {
   if (deps.dynamic) {
     registerDynamicTools(deps.logger, server, getClient, toolMap, scopes);
   }
-  registerMCPExtensions(register);
+  registerMCPExtensions(register, deps.mcpApps);
   return { server, tools };
 }
 var init_server2 = __esm(() => {
@@ -73521,31 +74221,30 @@ Creates a downloadable ZIP or other archive format containing the specified reso
     },
     {
       name: "delete-asset",
-      description: `Delete asset by asset-id
+      description: `Delete asset by asset ID
 
-Deletes an asset using its asset ID. This endpoint replaces the legacy /resources/by_asset_id endpoint.
-Returns the deletion status and asset folder information when folder decoupling is enabled.
+Deletes an asset using its immutable asset ID.
 `
     },
     {
       name: "list-images",
       description: `Get image assets
 
-Retrieves a list of image assets. Results can be filtered by various criteria like tags, moderation status, prefix, or specific public IDs.
+Retrieves a list of image assets. Results can be filtered by various criteria like tags, prefix, or specific public IDs.
 `
     },
     {
       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.
 `
     },
     {
       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.
 `
     },
     {
@@ -73558,7 +74257,7 @@ Returns the details of a single resource specified by its asset ID.`
       name: "asset-update",
       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.
 `
     },
     {
@@ -73586,13 +74285,13 @@ A report on the status of product environment usage, including storage, credits,
       name: "create-asset-relations",
       description: `Add related assets by asset ID
 
-Relates an asset to other assets by their asset IDs, an immutable identifier, regardless of public ID, display name, asset folder, resource type or deliver type. This is a bidirectional process, meaning that the asset will also be added as a related_asset to all the other assets specified. The relation is also a one to many relationship, where the asset is related to all the assets specified, but those assets aren't also related to each other.`
+Relates an asset to other assets by their asset IDs, an immutable identifier, regardless of public ID, display name, asset folder, resource type or delivery type. This is a bidirectional process, meaning that the asset will also be added as a related_asset to all the other assets specified. The relation is also a one to many relationship, where the asset is related to all the assets specified, but those assets aren't also related to each other.`
     },
     {
       name: "delete-asset-relations",
       description: `Delete asset relations by asset ID
 
-Unrelates the asset from other assets, specified by their asset IDs, an immutable identifier, regardless of public ID, display name, asset folder, resource type or deliver type. This is a bidirectional process, meaning that the asset will also be removed as a related_asset from all the other assets specified.`
+Unrelates the asset from other assets, specified by their asset IDs, an immutable identifier, regardless of public ID, display name, asset folder, resource type or delivery type. This is a bidirectional process, meaning that the asset will also be removed as a related_asset from all the other assets specified.`
     },
     {
       name: "move-folder",
@@ -73621,14 +74320,7 @@ Lists the folders that match the specified search expression. Limited to 2000 re
     },
     {
       name: "search-assets",
-      description: `Provides a powerful query interface to filter and retrieve assets and their details
-
-Returns a list of resources matching the specified search criteria.
-
-Uses Lucene-like query language to search by descriptive attributes (public_id, filename, folder, tags, context), file details (resource_type, format, bytes, width, height), embedded data (image_metadata), and analyzed data (face_count, colors, quality_score). Supports aggregate counts and complex Boolean expressions.
-
-Examples: tags:shirt AND uploaded_at>1d, resource_type:image AND bytes>1mb, folder:products OR context.category:electronics
-`
+      description: "Provides a powerful query interface to filter and retrieve assets and their details\n\nReturns a list of resources matching the specified search criteria.\n\nUses a Lucene-like query language to filter assets by descriptive attributes (`public_id`, `asset_id`, `filename`, `display_name`, `folder` / `asset_folder`, `tags`, `context.<key>`), file details (`resource_type`, `type`, `format`, `bytes`, `width`, `height`, `duration`, `pages`, `aspect_ratio`, `transparent`, `grayscale`), lifecycle dates (`uploaded_at`, `created_at`, `taken_at`, `updated_at`, `last_updated.<kind>`), moderation and lifecycle state (`status`, `moderation_status`, `moderation_kind`), embedded data (`image_metadata.*`), structured metadata (`metadata.<external_id>`), and analysis fields (`face_count`, `colors`, `quality_score`, `illustration_score`, `accessibility_analysis.*`). Supports sorting, aggregate counts, and complex boolean expressions. See the `expression` parameter for the full field reference.\n\n## Expression syntax\n\n- **Match**: `field:value` (token match) or `field=value` (exact match). Examples: `tags:shirt`, `tags=cotton`.\n- **Comparisons**: `>`, `<`, `>=`, `<=` for numbers and dates. Example: `bytes>10000000`.\n- **Ranges**: `field:[from TO to]` inclusive, `field:{from TO to}` exclusive. Example: `width:{200 TO 1028}`.\n- **Booleans**: `AND`, `OR`, `NOT` (uppercase), or `+` (must), `-` (must not). `NOT` must appear between clauses — a bare leading `NOT` is a parse error; use `-field:value` to negate the first clause. Group with parentheses: `(shirt OR pants) AND clothes`.\n- **Wildcards**: trailing `*` only, for prefix match (`public_id:shoes_*`, `format:jp*`, `tags:shirt*`). Not supported on `folder`, `asset_folder`, `resource_type`, or `type`. Leading `*`, middle `*`, `?`, and bare `*` (`folder:*`, `context.alt:*`) are all parse errors — wildcards cannot be used as a \"field is present\" probe.\n- **Tokenized vs exact fields**: `tags`, `filename`, `display_name`, `context.<key>`, and `metadata.<id>` match on tokens split by whitespace and punctuation — `tags:analysis` matches the tag `full-analysis`. `public_id`, `folder`, `asset_folder`, and `format` match the whole value — `public_id:dog` will not match `dog_pldcwy`; use `public_id=\"dog_pldcwy\"` (exact) or `public_id:dog*` (prefix). These exact-match fields still accept a trailing `*` for prefix match (except `folder` / `asset_folder`, where wildcards are ignored).\n- **Dates**: ISO-8601 in quotes (`uploaded_at>\"2024-01-15\"`) or relative shorthand `Nh`, `Nd`, `Nw`, `Nm`, `Ny` (`uploaded_at>1d`, `created_at:[4w TO 1w]`). Send raw `<`/`>`, never HTML-escaped.\n- **Quoting**: wrap any value containing a space, colon, or other reserved character (`! ( ) { } [ ] ^ ~ ?  \\ = & < > |`) in double quotes, or escape each character with `\\`. Examples: `tags:\"service:mantels\"`, `aspect_ratio:\"16:9\"`, `folder:\"My Folder\"`.\n\n## Common mistakes\n\n- Use `folder:` or `asset_folder:` (singular); `folders:`, `asset_folder_id:`, and other invented variants are not valid fields. Pass the exact folder name — wildcards do not apply here.\n- There is no \"has any value\" / presence probe. `folder:*`, `metadata.alt:*`, `context.key:*`, `tags:*`, and `-tags:*` are all parse errors. See *\"Which assets have any value for `metadata.<id>`?\"* under **Common tasks** for workarounds.\n- `NOT foo AND bar` is a parse error. Write it as `bar AND NOT foo` or `-foo AND bar`, and keep every `NOT` between two clauses (`a AND NOT b AND NOT c` is fine; `NOT b AND NOT c …` is not).\n- `public_id:dog` will not match `dog_pldcwy`. Use `public_id=\"dog_pldcwy\"` (exact) or `public_id:dog*` (prefix).\n- `tags=service:mantels` fails because the unquoted colon is parsed as a field separator. Use `tags=\"service:mantels\"` or `tags=service\\:mantels`.\n- Do not HTML-escape operators. Send `uploaded_at<1h`, not `uploaded_at&lt;1h`.\n- Do not leave an operand empty (e.g. `tags: AND -tags:foo`). Omit the empty clause entirely.\n\n## Tips\n\n- Set `max_results: 0` to return only `total_count` and `aggregations` without any resource payload — useful for counts and aggregation-only queries.\n- `total_count` is always present in the response; prefer it over running an aggregation just to get a count.\n- `aggregate` (both simple and range variants) and the `metadata`, `image_metadata`, `image_analysis` values of `with_field` require a Tier 2 search plan.\n- Range aggregations require each range to include a `key` label (1–20 chars, `[a-zA-Z0-9_-]+`) and at least one of `from` / `to`.\n\n## Common tasks\n\n- **Count matching assets** — put the filter in `expression` with `max_results: 0` and read `total_count` from the response. Works on every tier; no `aggregate` needed.\n- **Preview one matching asset** — set `max_results: 1`; add `with_field: [\"tags\", \"context\"]` (or `metadata`, Tier 2) to inspect values. Prefer this over fetching and scanning a full page.\n- **Distribution of values for a field** — Tier 2: `aggregate: [format|resource_type|type]` for enum counts, or range aggregations on `bytes`, `image_pixels`, `video_pixels`, or `duration`. Tier 1 fallback: run N small queries with `max_results: 0`, one per candidate value, and read `total_count` from each.\n- **\"Which assets have any value for `metadata.<id>`?\"** — not expressible directly (`metadata.X:*` is a parse error; there is no presence probe). Workarounds: (a) if the field has a known value set, enumerate — `metadata.region:(apac OR emea OR amer)`; (b) query broadly with `with_field: [\"metadata\"]` (Tier 2) and filter client-side for entries where the field is set; (c) at ingest time, attach a sentinel tag whenever the field is set, then search by that tag.\n- **Newest / largest N** — keep the filter in `expression` and sort explicitly: `sort_by: [{uploaded_at: \"desc\"}]` with `max_results: 10`.\n- **Filter by folder** — both `asset_folder:\"parent/child\"` and `folder:\"parent/child\"` match an exact folder path; there is no wildcard or \"contains\". To query across multiple folders, enumerate: `asset_folder:(\"campaigns/2024\" OR \"campaigns/2025\")`.\n- **Filter by metadata when you only know the label** — first call `list-metadata-fields` to resolve the label to an `external_id`, then query `metadata.<external_id>:value`.\n- **Multiple independent filters in one turn** — prefer one `expression` with `OR` / parentheses over firing many parallel calls: `metadata.region:apac OR metadata.region:emea` in a single request is faster and more reliable than two parallel requests.\n\n## Examples\n\n- `tags:shirt AND uploaded_at>1d`\n- `resource_type:image AND bytes>1000000 AND (format:png OR format:jpg)`\n- `folder:products AND context.category:electronics`\n- `tags:\"service:mantels\" AND -tags:discontinued`\n"
     },
     {
       name: "visual-search-assets",
@@ -73636,7 +74328,7 @@ Examples: tags:shirt AND uploaded_at>1d, resource_type:image AND bytes>1mb, fold
 
 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
 `
     },
@@ -74588,7 +75280,7 @@ http_headers = { "api-key" = "YOUR_API_KEY", "api-secret" = "YOUR_API_SECRET", "
         <h1>Instructions</h1>
         <p>One-click installation for Claude Desktop users</p>
         <div class="instruction-item">
-          <a href="https://github.com/cloudinary/asset-management-mcp/releases/download/v0.9.0-rc.0/mcp-server.mcpb" download="mcp-server.mcpb" class="action-button header-action" style="display: inline-flex; margin-bottom: 16px;">
+          <a href="https://github.com/cloudinary/asset-management-mcp/releases/download/v0.9.1/mcp-server.mcpb" download="mcp-server.mcpb" class="action-button header-action" style="display: inline-flex; margin-bottom: 16px;">
             \uD83D\uDCE5 Download MCP Bundle
           </a>
         </div>
@@ -74780,7 +75472,8 @@ async function startStreamableHTTP(cliFlags) {
       cloud_name: cliFlags["cloud-name"],
       serverIdx: cliFlags["server-index"],
       region: cliFlags.region,
-      host: cliFlags["api-host"]
+      host: cliFlags["api-host"],
+      mcpApps: resolveMcpApps(cliFlags["mcp-apps"])
     });
     mcpServer.server.onerror = (error48) => {
       logger.error("MCP protocol error", {
@@ -74815,6 +75508,7 @@ async function startStreamableHTTP(cliFlags) {
 var import_express;
 var init_impl = __esm(() => {
   init_streamableHttp();
+  init_config2();
   init_console_logger();
   init_server2();
   init_tools();
@@ -75083,7 +75777,8 @@ async function startStdio(flags) {
     serverURL: flags["server-url"],
     serverIdx: flags["server-index"],
     region: flags.region,
-    host: flags["api-host"]
+    host: flags["api-host"],
+    mcpApps: resolveMcpApps(flags["mcp-apps"])
   });
   await server.connect(transport);
   const abort = async () => {
@@ -75134,7 +75829,8 @@ async function startSSE(cliFlags) {
       serverURL: flags["server-url"],
       serverIdx: flags["server-index"],
       region: flags.region,
-      host: flags["api-host"]
+      host: flags["api-host"],
+      mcpApps: resolveMcpApps(flags["mcp-apps"])
     });
     const transport = new SSEServerTransport(`/message/${sessionId}`, res);
     const cleanup = async () => {
@@ -75214,6 +75910,7 @@ var import_express2;
 var init_impl2 = __esm(() => {
   init_sse();
   init_stdio2();
+  init_config2();
   init_console_logger();
   init_server2();
   init_tools();
@@ -76218,6 +76915,18 @@ function buildContext(process2) {
 // src/mcp-server/cli/serve/command.ts
 init_zod();
 init_config();
+
+// src/mcp-server/apps/cli-flag.ts
+init_config2();
+var mcpAppsFlag = {
+  kind: "parsed",
+  brief: "Enable MCP Apps (interactive UI). Bare flag or 'all'/'true' enables all; 'none'/'false' disables; or comma-separated: asset-gallery,asset-details,asset-upload. Env: CLOUDINARY_MCP_APPS.",
+  optional: true,
+  inferEmpty: true,
+  parse: parseMcpAppsList
+};
+
+// src/mcp-server/cli/serve/command.ts
 init_console_logger();
 init_scopes();
 var serveCommand = sn({
@@ -76249,7 +76958,7 @@ var serveCommand = sn({
       },
       mode: {
         kind: "enum",
-        brief: "Server mode (dynamic: expose list_tools, describe_tool, and execute_tool instead of individual tools)",
+        brief: "Server mode (dynamic: expose list_tools, describe_tool_input, and execute_tool instead of individual tools)",
         values: ["dynamic"],
         optional: true
       },
@@ -76322,6 +77031,7 @@ var serveCommand = sn({
         optional: true,
         parse: (value) => value
       },
+      "mcp-apps": mcpAppsFlag,
       "log-level": {
         kind: "enum",
         brief: "The log level to use for the server",
@@ -76392,7 +77102,7 @@ var startCommand = sn({
       },
       mode: {
         kind: "enum",
-        brief: "Server mode (dynamic: expose list_tools, describe_tool, and execute_tool instead of individual tools)",
+        brief: "Server mode (dynamic: expose list_tools, describe_tool_input, and execute_tool instead of individual tools)",
         values: ["dynamic"],
         optional: true
       },
@@ -76465,6 +77175,7 @@ var startCommand = sn({
         optional: true,
         parse: (value) => value
       },
+      "mcp-apps": mcpAppsFlag,
       "log-level": {
         kind: "enum",
         brief: "The log level to use for the server",
@@ -76513,7 +77224,7 @@ var routes = ln({
 var app = _e(routes, {
   name: "mcp",
   versionInfo: {
-    currentVersion: "0.9.0-rc.0"
+    currentVersion: "0.9.1"
   }
 });
 Yt(app, process4.argv.slice(2), buildContext(process4));
@@ -76521,5 +77232,5 @@ export {
   app
 };
 
-//# debugId=2917C5DD083B0D6C64756E2164756E21
+//# debugId=92BB3EDCF4CED14664756E2164756E21
 //# sourceMappingURL=mcp-server.js.map