@cloudinary/asset-management-mcp 0.9.3 → 0.10.0

package/bin/mcp-server.js

@@ -13959,10 +13959,10 @@ var init_config = __esm(() => {
   ]).describe("Regional endpoint selection");
   SDK_METADATA = {
     language: "typescript",
-    openapiDocVersion: "0.5.1",
-    sdkVersion: "0.9.3",
-    genVersion: "2.885.1",
-    userAgent: "speakeasy-sdk/mcp-typescript 0.9.3 2.885.1 0.5.1 @cloudinary/asset-management-mcp"
+    openapiDocVersion: "0.7.4",
+    sdkVersion: "0.10.0",
+    genVersion: "2.918.4",
+    userAgent: "speakeasy-sdk/mcp-typescript 0.10.0 2.918.4 0.7.4 @cloudinary/asset-management-mcp"
   };
 });
 
@@ -52531,6 +52531,10 @@ var require_data = __commonJS((exports, module) => {
 var require_utils4 = __commonJS((exports, module) => {
   var isUUID = RegExp.prototype.test.bind(/^[\da-f]{8}-[\da-f]{4}-[\da-f]{4}-[\da-f]{4}-[\da-f]{12}$/iu);
   var isIPv4 = RegExp.prototype.test.bind(/^(?:(?:25[0-5]|2[0-4]\d|1\d{2}|[1-9]\d|\d)\.){3}(?:25[0-5]|2[0-4]\d|1\d{2}|[1-9]\d|\d)$/u);
+  var isHexPair = RegExp.prototype.test.bind(/^[\da-f]{2}$/iu);
+  var isUnreserved = RegExp.prototype.test.bind(/^[\da-z\-._~]$/iu);
+  var isPathCharacter = RegExp.prototype.test.bind(/^[\da-z\-._~!$&'()*+,;=:@/]$/iu);
+  var isQueryFragmentCharacter = RegExp.prototype.test.bind(/^[\da-z\-._~!$&'()*+,;=:@/?]$/iu);
   function stringArrayToHexStripped(input) {
     let acc = "";
     let code = 0;
@@ -52674,7 +52678,7 @@ var require_utils4 = __commonJS((exports, module) => {
             continue;
           }
         } else if (input[0] === "/") {
-          if (input[1] === "." || input[1] === "/") {
+          if (input[1] === ".") {
             output.push("/");
             break;
           }
@@ -52724,27 +52728,169 @@ var require_utils4 = __commonJS((exports, module) => {
     }
     return output.join("");
   }
-  function normalizeComponentEncoding(component, esc2) {
-    const func = esc2 !== true ? escape : unescape;
-    if (component.scheme !== undefined) {
-      component.scheme = func(component.scheme);
+  var HOST_DELIMS = { "@": "%40", "/": "%2F", "?": "%3F", "#": "%23", ":": "%3A" };
+  var HOST_DELIM_RE = /[@/?#:]/g;
+  var HOST_DELIM_NO_COLON_RE = /[@/?#]/g;
+  function reescapeHostDelimiters(host, isIP) {
+    const re2 = isIP ? HOST_DELIM_NO_COLON_RE : HOST_DELIM_RE;
+    re2.lastIndex = 0;
+    return host.replace(re2, (ch) => HOST_DELIMS[ch]);
+  }
+  function normalizePercentEncoding(input, decodeUnreserved = false) {
+    if (input.indexOf("%") === -1) {
+      return input;
     }
-    if (component.userinfo !== undefined) {
-      component.userinfo = func(component.userinfo);
+    let output = "";
+    for (let i = 0;i < input.length; i++) {
+      if (input[i] === "%" && i + 2 < input.length) {
+        const hex3 = input.slice(i + 1, i + 3);
+        if (isHexPair(hex3)) {
+          const normalizedHex = hex3.toUpperCase();
+          const decoded = String.fromCharCode(parseInt(normalizedHex, 16));
+          if (decodeUnreserved && isUnreserved(decoded)) {
+            output += decoded;
+          } else {
+            output += "%" + normalizedHex;
+          }
+          i += 2;
+          continue;
+        }
+      }
+      output += input[i];
     }
-    if (component.host !== undefined) {
-      component.host = func(component.host);
+    return output;
+  }
+  var BYTE_HEX = new Array(256);
+  {
+    const HEX_DIGITS = "0123456789ABCDEF";
+    for (let i = 0;i < 256; i++) {
+      BYTE_HEX[i] = "%" + HEX_DIGITS[i >> 4] + HEX_DIGITS[i & 15];
     }
-    if (component.path !== undefined) {
-      component.path = func(component.path);
+  }
+  function isEscapeSafe(cp) {
+    return cp >= 48 && cp <= 57 || cp >= 65 && cp <= 90 || cp >= 97 && cp <= 122 || cp === 42 || cp === 43 || cp === 45 || cp === 46 || cp === 47 || cp === 64 || cp === 95;
+  }
+  function percentEncodeNonAscii(cp) {
+    if (cp < 2048) {
+      return BYTE_HEX[192 | cp >> 6] + BYTE_HEX[128 | cp & 63];
     }
-    if (component.query !== undefined) {
-      component.query = func(component.query);
+    if (cp < 65536) {
+      return BYTE_HEX[224 | cp >> 12] + BYTE_HEX[128 | cp >> 6 & 63] + BYTE_HEX[128 | cp & 63];
     }
-    if (component.fragment !== undefined) {
-      component.fragment = func(component.fragment);
+    return BYTE_HEX[240 | cp >> 18] + BYTE_HEX[128 | cp >> 12 & 63] + BYTE_HEX[128 | cp >> 6 & 63] + BYTE_HEX[128 | cp & 63];
+  }
+  function normalizePathEncoding(input) {
+    let output = "";
+    for (let i = 0;i < input.length; i++) {
+      const ch = input[i];
+      if (ch === "%" && i + 2 < input.length) {
+        const hex3 = input.slice(i + 1, i + 3);
+        if (isHexPair(hex3)) {
+          const normalizedHex = hex3.toUpperCase();
+          const decoded = String.fromCharCode(parseInt(normalizedHex, 16));
+          if (decoded !== "." && isUnreserved(decoded)) {
+            output += decoded;
+          } else {
+            output += "%" + normalizedHex;
+          }
+          i += 2;
+          continue;
+        }
+      }
+      if (isPathCharacter(ch)) {
+        output += ch;
+      } else {
+        const code = input.charCodeAt(i);
+        if (code < 128) {
+          output += isEscapeSafe(code) ? ch : BYTE_HEX[code];
+        } else if (code < 55296 || code > 57343) {
+          output += percentEncodeNonAscii(code);
+        } else if (code <= 56319 && i + 1 < input.length) {
+          const low = input.charCodeAt(i + 1);
+          if (low >= 56320 && low <= 57343) {
+            output += percentEncodeNonAscii(65536 + (code - 55296 << 10) + (low - 56320));
+            i++;
+          } else {
+            output += percentEncodeNonAscii(65533);
+          }
+        } else {
+          output += percentEncodeNonAscii(65533);
+        }
+      }
     }
-    return component;
+    return output;
+  }
+  function normalizeQueryFragmentEncoding(input) {
+    let output = "";
+    for (let i = 0;i < input.length; i++) {
+      const ch = input[i];
+      if (ch === "%" && i + 2 < input.length) {
+        const hex3 = input.slice(i + 1, i + 3);
+        if (isHexPair(hex3)) {
+          const normalizedHex = hex3.toUpperCase();
+          const decoded = String.fromCharCode(parseInt(normalizedHex, 16));
+          if (isUnreserved(decoded)) {
+            output += decoded;
+          } else {
+            output += "%" + normalizedHex;
+          }
+          i += 2;
+          continue;
+        }
+      }
+      if (isQueryFragmentCharacter(ch)) {
+        output += ch;
+      } else {
+        const code = input.charCodeAt(i);
+        if (code < 128) {
+          output += isEscapeSafe(code) ? ch : BYTE_HEX[code];
+        } else if (code < 55296 || code > 57343) {
+          output += percentEncodeNonAscii(code);
+        } else if (code <= 56319 && i + 1 < input.length) {
+          const low = input.charCodeAt(i + 1);
+          if (low >= 56320 && low <= 57343) {
+            output += percentEncodeNonAscii(65536 + (code - 55296 << 10) + (low - 56320));
+            i++;
+          } else {
+            output += percentEncodeNonAscii(65533);
+          }
+        } else {
+          output += percentEncodeNonAscii(65533);
+        }
+      }
+    }
+    return output;
+  }
+  function escapePreservingEscapes(input) {
+    let output = "";
+    for (let i = 0;i < input.length; i++) {
+      const ch = input[i];
+      if (ch === "%" && i + 2 < input.length) {
+        const hex3 = input.slice(i + 1, i + 3);
+        if (isHexPair(hex3)) {
+          output += "%" + hex3.toUpperCase();
+          i += 2;
+          continue;
+        }
+      }
+      const code = input.charCodeAt(i);
+      if (code < 128) {
+        output += isEscapeSafe(code) ? ch : BYTE_HEX[code];
+      } else if (code < 55296 || code > 57343) {
+        output += percentEncodeNonAscii(code);
+      } else if (code <= 56319 && i + 1 < input.length) {
+        const low = input.charCodeAt(i + 1);
+        if (low >= 56320 && low <= 57343) {
+          output += percentEncodeNonAscii(65536 + (code - 55296 << 10) + (low - 56320));
+          i++;
+        } else {
+          output += percentEncodeNonAscii(65533);
+        }
+      } else {
+        output += percentEncodeNonAscii(65533);
+      }
+    }
+    return output;
   }
   function recomposeAuthority(component) {
     const uriTokens = [];
@@ -52759,7 +52905,7 @@ var require_utils4 = __commonJS((exports, module) => {
         if (ipV6res.isIPV6 === true) {
           host = `[${ipV6res.escapedHost}]`;
         } else {
-          host = component.host;
+          host = reescapeHostDelimiters(host, false);
         }
       }
       uriTokens.push(host);
@@ -52773,7 +52919,11 @@ var require_utils4 = __commonJS((exports, module) => {
   module.exports = {
     nonSimpleDomain,
     recomposeAuthority,
-    normalizeComponentEncoding,
+    reescapeHostDelimiters,
+    normalizePercentEncoding,
+    normalizePathEncoding,
+    normalizeQueryFragmentEncoding,
+    escapePreservingEscapes,
     removeDotSegments,
     isIPv4,
     isUUID,
@@ -52958,11 +53108,11 @@ var require_schemes = __commonJS((exports, module) => {
 
 // node_modules/fast-uri/index.js
 var require_fast_uri = __commonJS((exports, module) => {
-  var { normalizeIPv6, removeDotSegments, recomposeAuthority, normalizeComponentEncoding, isIPv4, nonSimpleDomain } = require_utils4();
+  var { normalizeIPv6, removeDotSegments, recomposeAuthority, normalizePercentEncoding, normalizePathEncoding, normalizeQueryFragmentEncoding, escapePreservingEscapes, reescapeHostDelimiters, isIPv4, nonSimpleDomain } = require_utils4();
   var { SCHEMES, getSchemeHandler } = require_schemes();
   function normalize(uri, options) {
     if (typeof uri === "string") {
-      uri = serialize(parse6(uri, options), options);
+      uri = normalizeString(uri, options);
     } else if (typeof uri === "object") {
       uri = parse6(serialize(uri, options), options);
     }
@@ -53028,19 +53178,9 @@ var require_fast_uri = __commonJS((exports, module) => {
     return target;
   }
   function equal(uriA, uriB, options) {
-    if (typeof uriA === "string") {
-      uriA = unescape(uriA);
-      uriA = serialize(normalizeComponentEncoding(parse6(uriA, options), true), { ...options, skipEscape: true });
-    } else if (typeof uriA === "object") {
-      uriA = serialize(normalizeComponentEncoding(uriA, true), { ...options, skipEscape: true });
-    }
-    if (typeof uriB === "string") {
-      uriB = unescape(uriB);
-      uriB = serialize(normalizeComponentEncoding(parse6(uriB, options), true), { ...options, skipEscape: true });
-    } else if (typeof uriB === "object") {
-      uriB = serialize(normalizeComponentEncoding(uriB, true), { ...options, skipEscape: true });
-    }
-    return uriA.toLowerCase() === uriB.toLowerCase();
+    const normalizedA = normalizeComparableURI(uriA, options);
+    const normalizedB = normalizeComparableURI(uriB, options);
+    return normalizedA !== undefined && normalizedB !== undefined && normalizedA.toLowerCase() === normalizedB.toLowerCase();
   }
   function serialize(cmpts, opts) {
     const component = {
@@ -53066,12 +53206,12 @@ var require_fast_uri = __commonJS((exports, module) => {
       schemeHandler.serialize(component, options);
     if (component.path !== undefined) {
       if (!options.skipEscape) {
-        component.path = escape(component.path);
+        component.path = escapePreservingEscapes(component.path);
         if (component.scheme !== undefined) {
           component.path = component.path.split("%3A").join(":");
         }
       } else {
-        component.path = unescape(component.path);
+        component.path = normalizePercentEncoding(component.path);
       }
     }
     if (options.reference !== "suffix" && component.scheme) {
@@ -53106,7 +53246,17 @@ var require_fast_uri = __commonJS((exports, module) => {
     return uriTokens.join("");
   }
   var URI_PARSE = /^(?:([^#/:?]+):)?(?:\/\/((?:([^#/?@]*)@)?(\[[^#/?\]]+\]|[^#/:?]*)(?::(\d*))?))?([^#?]*)(?:\?([^#]*))?(?:#((?:.|[\n\r])*))?/u;
-  function parse6(uri, opts) {
+  var AUTHORITY_PREFIX = /^(?:[^#/:?]+:)?\/\/([^/?#]*)/;
+  function getParseError(parsed, matches) {
+    if (matches[2] !== undefined && parsed.path && parsed.path[0] !== "/") {
+      return 'URI path must start with "/" when authority is present.';
+    }
+    if (typeof parsed.port === "number" && (parsed.port < 0 || parsed.port > 65535)) {
+      return "URI port is malformed.";
+    }
+    return;
+  }
+  function parseWithStatus(uri, opts) {
     const options = Object.assign({}, opts);
     const parsed = {
       scheme: undefined,
@@ -53117,6 +53267,7 @@ var require_fast_uri = __commonJS((exports, module) => {
       query: undefined,
       fragment: undefined
     };
+    let malformedAuthorityOrPort = false;
     let isIP = false;
     if (options.reference === "suffix") {
       if (options.scheme) {
@@ -53125,9 +53276,14 @@ var require_fast_uri = __commonJS((exports, module) => {
         uri = "//" + uri;
       }
     }
+    const authorityMatch = uri.match(AUTHORITY_PREFIX);
+    if (authorityMatch !== null && authorityMatch[1].indexOf("\\") !== -1) {
+      parsed.error = "URI authority must not contain a literal backslash.";
+      malformedAuthorityOrPort = true;
+    }
     const matches = uri.match(URI_PARSE);
     if (matches) {
-      parsed.scheme = matches[1];
+      parsed.scheme = matches[1] === undefined ? undefined : matches[1].toLowerCase();
       parsed.userinfo = matches[3];
       parsed.host = matches[4];
       parsed.port = parseInt(matches[5], 10);
@@ -53137,6 +53293,11 @@ var require_fast_uri = __commonJS((exports, module) => {
       if (isNaN(parsed.port)) {
         parsed.port = matches[5];
       }
+      const parseError = getParseError(parsed, matches);
+      if (parseError !== undefined) {
+        parsed.error = parsed.error || parseError;
+        malformedAuthorityOrPort = true;
+      }
       if (parsed.host) {
         const ipv4result = isIPv4(parsed.host);
         if (ipv4result === false) {
@@ -53163,7 +53324,7 @@ var require_fast_uri = __commonJS((exports, module) => {
       if (!options.unicodeSupport && (!schemeHandler || !schemeHandler.unicodeSupport)) {
         if (parsed.host && (options.domainHost || schemeHandler && schemeHandler.domainHost) && isIP === false && nonSimpleDomain(parsed.host)) {
           try {
-            parsed.host = URL.domainToASCII(parsed.host.toLowerCase());
+            parsed.host = new URL("http://" + parsed.host).hostname;
           } catch (e) {
             parsed.error = parsed.error || "Host's domain name can not be converted to ASCII: " + e;
           }
@@ -53175,14 +53336,17 @@ var require_fast_uri = __commonJS((exports, module) => {
             parsed.scheme = unescape(parsed.scheme);
           }
           if (parsed.host !== undefined) {
-            parsed.host = unescape(parsed.host);
+            parsed.host = reescapeHostDelimiters(unescape(parsed.host), isIP);
           }
         }
         if (parsed.path) {
-          parsed.path = escape(unescape(parsed.path));
+          parsed.path = normalizePathEncoding(parsed.path);
+        }
+        if (parsed.query) {
+          parsed.query = normalizeQueryFragmentEncoding(parsed.query);
         }
         if (parsed.fragment) {
-          parsed.fragment = encodeURI(decodeURIComponent(parsed.fragment));
+          parsed.fragment = normalizeQueryFragmentEncoding(parsed.fragment);
         }
       }
       if (schemeHandler && schemeHandler.parse) {
@@ -53191,7 +53355,29 @@ var require_fast_uri = __commonJS((exports, module) => {
     } else {
       parsed.error = parsed.error || "URI can not be parsed.";
     }
-    return parsed;
+    return { parsed, malformedAuthorityOrPort };
+  }
+  function parse6(uri, opts) {
+    return parseWithStatus(uri, opts).parsed;
+  }
+  function normalizeString(uri, opts) {
+    return normalizeStringWithStatus(uri, opts).normalized;
+  }
+  function normalizeStringWithStatus(uri, opts) {
+    const { parsed, malformedAuthorityOrPort } = parseWithStatus(uri, opts);
+    return {
+      normalized: malformedAuthorityOrPort ? uri : serialize(parsed, opts),
+      malformedAuthorityOrPort
+    };
+  }
+  function normalizeComparableURI(uri, opts) {
+    if (typeof uri === "string") {
+      const { normalized, malformedAuthorityOrPort } = normalizeStringWithStatus(uri, opts);
+      return malformedAuthorityOrPort ? undefined : normalized;
+    }
+    if (typeof uri === "object") {
+      return serialize(uri, opts);
+    }
   }
   var fastUri = {
     SCHEMES,
@@ -63347,14 +63533,31 @@ var init_base64 = __esm(() => {
   zodInbound = custom((x) => x instanceof Uint8Array).or(string2().transform(bytesFromBase64));
 });
 
-// src/lib/is-plain-object.ts
+// src/lib/primitives.ts
+function compactMap(values) {
+  const out = {};
+  for (const [k2, v2] of Object.entries(values)) {
+    if (typeof v2 !== "undefined") {
+      out[k2] = v2;
+    }
+  }
+  return out;
+}
 function isPlainObject3(value) {
-  if (typeof value !== "object" || value === null) {
+  if (value === null || typeof value !== "object")
+    return false;
+  if (Object.prototype.toString.call(value) !== "[object Object]")
+    return false;
+  const proto = Object.getPrototypeOf(value);
+  if (proto === null || proto === Object.prototype)
+    return true;
+  try {
+    return Object.getPrototypeOf(proto) === null;
+  } catch {
     return false;
   }
-  const prototype = Object.getPrototypeOf(value);
-  return (prototype === null || prototype === Object.prototype || Object.getPrototypeOf(prototype) === null) && !(Symbol.toStringTag in value) && !(Symbol.iterator in value);
 }
+var init_primitives = () => {};
 
 // src/lib/encodings.ts
 function formEncoder(sep) {
@@ -63553,6 +63756,7 @@ var EncodingError, encodeForm, encodeSpaceDelimited, encodePipeDelimited, encode
 }, encodeJSONQuery, encodeFormQuery, encodeSpaceDelimitedQuery, encodePipeDelimitedQuery, encodeDeepObjectQuery;
 var init_encodings = __esm(() => {
   init_base64();
+  init_primitives();
   EncodingError = class EncodingError extends Error {
     constructor(message) {
       super(message);
@@ -63569,22 +63773,13 @@ var init_encodings = __esm(() => {
   encodeDeepObjectQuery = queryEncoder(encodeDeepObject);
 });
 
-// src/lib/dlv.ts
-function dlv(obj, key, def, p, undef) {
-  key = Array.isArray(key) ? key : key.split(".");
-  for (p = 0;p < key.length; p++) {
-    const k2 = key[p];
-    obj = k2 != null && obj ? obj[k2] : undef;
-  }
-  return obj === undef ? def : obj;
-}
-
 // src/lib/env.ts
 function env() {
   if (envMemo) {
     return envMemo;
   }
-  envMemo = envSchema.parse(dlv(globalThis, "process.env") ?? dlv(globalThis, "Deno.env") ?? {});
+  const globals = globalThis;
+  envMemo = envSchema.parse(globals.process?.env ?? globals.Deno?.env?.toObject?.() ?? {});
   return envMemo;
 }
 function fillGlobals(options) {
@@ -63609,11 +63804,11 @@ var init_env = __esm(() => {
 
 // src/lib/http.ts
 class HTTPClient {
-  options;
   fetcher;
   requestHooks = [];
   requestErrorHooks = [];
   responseHooks = [];
+  options;
   constructor(options = {}) {
     this.options = options;
     this.fetcher = options.fetcher || DEFAULT_FETCHER;
@@ -63861,6 +64056,13 @@ async function retryBackoff(fn, strategy) {
   }
 }
 function retryIntervalFromResponse(res) {
+  const retryAfterMsVal = res.headers.get("retry-after-ms");
+  if (retryAfterMsVal) {
+    const parsedMs = Number(retryAfterMsVal);
+    if (Number.isFinite(parsedMs) && parsedMs >= 0) {
+      return parsedMs;
+    }
+  }
   const retryVal = res.headers.get("retry-after") || "";
   if (!retryVal) {
     return 0;
@@ -64447,7 +64649,9 @@ function registerDynamicTools(logger, server, getSDK, toolMap, allowedScopes) {
 `;
       if (def.args) {
         const jsonSchema = toJSONSchema(object(def.args), {
-          target: "draft-2020-12"
+          target: "draft-2020-12",
+          io: "input",
+          unrepresentable: "any"
         });
         schemaText += JSON.stringify(jsonSchema, null, 2);
       } else {
@@ -64604,18 +64808,6 @@ var init_tools = __esm(() => {
   };
 });
 
-// src/lib/primitives.ts
-function compactMap(values) {
-  const out = {};
-  for (const [k2, v2] of Object.entries(values)) {
-    if (typeof v2 !== "undefined") {
-      out[k2] = v2;
-    }
-  }
-  return out;
-}
-var init_primitives = () => {};
-
 // src/models/errors/sdkvalidationerror.ts
 function formatZodError(err) {
   return prettifyError(err);
@@ -64812,9 +65004,13 @@ async function extractSecurity(sec) {
   }
   return typeof sec === "function" ? sec() : sec;
 }
-var SecurityError;
+var SecurityErrorCode, SecurityError;
 var init_security = __esm(() => {
   init_env();
+  SecurityErrorCode = {
+    Incomplete: "incomplete",
+    UnrecognisedSecurityType: "unrecognized_security_type"
+  };
   SecurityError = class SecurityError extends Error {
     code;
     constructor(code, message) {
@@ -64823,10 +65019,10 @@ var init_security = __esm(() => {
       this.name = "SecurityError";
     }
     static incomplete() {
-      return new SecurityError("incomplete" /* Incomplete */, "Security requirements not met in order to perform the operation");
+      return new SecurityError(SecurityErrorCode.Incomplete, "Security requirements not met in order to perform the operation");
     }
     static unrecognizedType(type) {
-      return new SecurityError("unrecognized_security_type" /* UnrecognisedSecurityType */, `Unrecognised security type: ${type}`);
+      return new SecurityError(SecurityErrorCode.UnrecognisedSecurityType, `Unrecognised security type: ${type}`);
     }
   };
 });
@@ -64987,7 +65183,7 @@ var init_tagsparam = __esm(() => {
 });
 
 // src/models/explicitrequest.ts
-var ExplicitRequestAutoTranscription$zodSchema, ExplicitRequestAutoTranscriptionUnion$zodSchema, ExplicitRequestAccessMode$zodSchema, ExplicitRequestRegions$zodSchema, ExplicitRequestResponsiveBreakpoints$zodSchema, QualityOverride$zodSchema, ExplicitRequest$zodSchema;
+var ExplicitRequestAccessMode$zodSchema, ExplicitRequestAutoTranscription$zodSchema, ExplicitRequestAutoTranscriptionUnion$zodSchema, ExplicitRequestRegions$zodSchema, ExplicitRequestResponsiveBreakpoints$zodSchema, QualityOverride$zodSchema, ExplicitRequest$zodSchema;
 var init_explicitrequest = __esm(() => {
   init_zod();
   init_accesscontrolitem();
@@ -64995,6 +65191,11 @@ var init_explicitrequest = __esm(() => {
   init_responsivebreakpoint();
   init_structuredmetadataparam();
   init_tagsparam();
+  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.
+`);
   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.");
@@ -65002,11 +65203,6 @@ var init_explicitrequest = __esm(() => {
     boolean2(),
     lazy(() => ExplicitRequestAutoTranscription$zodSchema)
   ]);
-  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())))
@@ -65294,16 +65490,19 @@ var init_async = __esm(() => {
     [Symbol.toStringTag] = "APIPromise";
     constructor(p) {
       this.#promise = p instanceof Promise ? p : Promise.resolve(p);
-      this.#unwrapped = p instanceof Promise ? this.#promise.then(([value]) => value) : Promise.resolve(p[0]);
+      this.#unwrapped = p instanceof Promise ? null : Promise.resolve(p[0]);
+    }
+    #getUnwrapped() {
+      return this.#unwrapped ??= this.#promise.then(([value]) => value);
     }
     then(onfulfilled, onrejected) {
       return this.#promise.then(onfulfilled ? ([value]) => onfulfilled(value) : undefined, onrejected);
     }
     catch(onrejected) {
-      return this.#unwrapped.catch(onrejected);
+      return this.#getUnwrapped().catch(onrejected);
     }
     finally(onfinally) {
-      return this.#unwrapped.finally(onfinally);
+      return this.#getUnwrapped().finally(onfinally);
     }
     $inspect() {
       return this.#promise;
@@ -65435,7 +65634,7 @@ var init_deliverytypeall = __esm(() => {
 });
 
 // src/models/info.ts
-var InfoModeration$zodSchema, RelatedAsset$zodSchema, LastUpdated$zodSchema, Derived$zodSchema, Version$zodSchema, InfoInfo$zodSchema, Derivative$zodSchema, Info$zodSchema;
+var InfoModeration$zodSchema, InfoRelatedAsset$zodSchema, InfoLastUpdated$zodSchema, InfoDerived$zodSchema, InfoVersion$zodSchema, InfoInfo$zodSchema, InfoDerivative$zodSchema, Info$zodSchema;
 var init_info = __esm(() => {
   init_zod();
   init_accesscontrolitem();
@@ -65447,8 +65646,8 @@ var init_info = __esm(() => {
     status: string2().optional(),
     updated_at: exports_iso.datetime({ offset: true }).optional()
   });
-  RelatedAsset$zodSchema = object({});
-  LastUpdated$zodSchema = object({
+  InfoRelatedAsset$zodSchema = object({});
+  InfoLastUpdated$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(),
@@ -65456,7 +65655,7 @@ var init_info = __esm(() => {
     tags_updated_at: exports_iso.datetime({ offset: true }).optional(),
     updated_at: exports_iso.datetime({ offset: true }).optional()
   });
-  Derived$zodSchema = object({
+  InfoDerived$zodSchema = object({
     bytes: int().optional(),
     format: string2().optional(),
     id: string2().optional(),
@@ -65464,7 +65663,7 @@ var init_info = __esm(() => {
     transformation: string2().optional(),
     url: string2().optional()
   });
-  Version$zodSchema = object({
+  InfoVersion$zodSchema = object({
     format: string2().nullable().optional(),
     restorable: boolean2().optional(),
     size: int().optional(),
@@ -65473,7 +65672,7 @@ var init_info = __esm(() => {
     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({
+  InfoDerivative$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."),
@@ -65492,8 +65691,8 @@ var init_info = __esm(() => {
     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(),
+    derivatives: array(lazy(() => InfoDerivative$zodSchema)).nullable().optional().describe("Included if 'derived=true' parameter is used. Null when no derivatives exist."),
+    derived: array(lazy(() => InfoDerived$zodSchema)).optional(),
     display_name: string2().optional(),
     duration: number2().nullable().optional().describe("Duration in seconds for video/audio assets. Null for images."),
     etag: string2().optional(),
@@ -65505,7 +65704,7 @@ var init_info = __esm(() => {
     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(),
+    last_updated: lazy(() => InfoLastUpdated$zodSchema).nullable().optional(),
     metadata: record(string2(), any()).optional(),
     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."),
@@ -65514,7 +65713,7 @@ var init_info = __esm(() => {
     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."),
+    related_assets: array(lazy(() => InfoRelatedAsset$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(),
@@ -65526,7 +65725,7 @@ var init_info = __esm(() => {
     uploaded_at: exports_iso.datetime({ offset: true }).optional(),
     url: string2().optional(),
     version: int().optional(),
-    versions: array(lazy(() => Version$zodSchema)).optional(),
+    versions: array(lazy(() => InfoVersion$zodSchema)).optional(),
     width: int().nullable().optional()
   });
 });
@@ -68812,7 +69011,7 @@ var init_uploaddeliverytype = __esm(() => {
 });
 
 // src/models/uploadrequest.ts
-var UploadRequestAutoTranscription$zodSchema, UploadRequestAutoTranscriptionUnion$zodSchema, UploadRequestAccessMode$zodSchema, UploadRequestRegions$zodSchema, UploadRequestResponsiveBreakpoints$zodSchema, UploadRequest$zodSchema;
+var UploadRequestAccessMode$zodSchema, UploadRequestAutoTranscription$zodSchema, UploadRequestAutoTranscriptionUnion$zodSchema, UploadRequestRegions$zodSchema, UploadRequestResponsiveBreakpoints$zodSchema, UploadRequest$zodSchema;
 var init_uploadrequest = __esm(() => {
   init_zod();
   init_accesscontrolitem();
@@ -68820,6 +69019,11 @@ var init_uploadrequest = __esm(() => {
   init_structuredmetadataparam();
   init_tagsparam();
   init_uploaddeliverytype();
+  UploadRequestAccessMode$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.
+`);
   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.");
@@ -68827,11 +69031,6 @@ var init_uploadrequest = __esm(() => {
     boolean2(),
     lazy(() => UploadRequestAutoTranscription$zodSchema)
   ]);
-  UploadRequestAccessMode$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.
-`);
   UploadRequestRegions$zodSchema = union([
     string2(),
     record(string2(), array(array(int())))
@@ -70786,11 +70985,11 @@ Deletes derived resources by derived resource ID`,
   };
 });
 
-// src/models/componentsdestroyrequest.ts
-var ComponentsDestroyRequest$zodSchema;
-var init_componentsdestroyrequest = __esm(() => {
+// src/models/destroybyassetidrequest.ts
+var DestroyByAssetIdRequest$zodSchema;
+var init_destroybyassetidrequest = __esm(() => {
   init_zod();
-  ComponentsDestroyRequest$zodSchema = object({
+  DestroyByAssetIdRequest$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."),
@@ -70803,7 +71002,7 @@ function assetsDestroyByAssetId(client$, request, options) {
   return new APIPromise($do5(client$, request, options));
 }
 async function $do5(client$, request, options) {
-  const parsed$ = safeParse4(request, (value$) => ComponentsDestroyRequest$zodSchema.parse(value$), "Input validation failed");
+  const parsed$ = safeParse4(request, (value$) => DestroyByAssetIdRequest$zodSchema.parse(value$), "Input validation failed");
   if (!parsed$.ok) {
     return [parsed$, { status: "invalid" }];
   }
@@ -70873,7 +71072,7 @@ var init_assetsDestroyByAssetId = __esm(() => {
   init_schemas4();
   init_security();
   init_url();
-  init_componentsdestroyrequest();
+  init_destroybyassetidrequest();
   init_async();
 });
 
@@ -70881,10 +71080,10 @@ var init_assetsDestroyByAssetId = __esm(() => {
 var args4, tool$assetsDestroyByAssetId;
 var init_assetsDestroyByAssetId2 = __esm(() => {
   init_assetsDestroyByAssetId();
-  init_componentsdestroyrequest();
+  init_destroybyassetidrequest();
   init_tools();
   args4 = {
-    request: ComponentsDestroyRequest$zodSchema.describe(`The asset to delete and related options.`)
+    request: DestroyByAssetIdRequest$zodSchema.describe(`The asset to delete and related options.`)
   };
   tool$assetsDestroyByAssetId = {
     name: "delete-asset",
@@ -71100,7 +71299,7 @@ var init_generatearchiveresponse = __esm(() => {
 });
 
 // src/models/generatearchiveop.ts
-var GenerateArchiveGlobals$zodSchema, Mode$zodSchema, TargetFormat$zodSchema, AssetFolders$zodSchema, GenerateArchiveRequestBody$zodSchema, GenerateArchiveRequest$zodSchema, GenerateArchiveResponseResponse$zodSchema;
+var Mode$zodSchema, TargetFormat$zodSchema, GenerateArchiveGlobals$zodSchema, AssetFolders$zodSchema, GenerateArchiveRequestBody$zodSchema, GenerateArchiveRequest$zodSchema, GenerateArchiveResponseResponse$zodSchema;
 var init_generatearchiveop = __esm(() => {
   init_zod();
   init_base64();
@@ -71108,9 +71307,6 @@ var init_generatearchiveop = __esm(() => {
   init_archiveresourcetype();
   init_deliverytypeall();
   init_generatearchiveresponse();
-  GenerateArchiveGlobals$zodSchema = object({
-    cloud_name: string2().describe("The cloud name of your product environment.").optional()
-  });
   Mode$zodSchema = _enum2([
     "download",
     "create",
@@ -71124,6 +71320,9 @@ create_and_download - Creates, stores, and delivers the archive file
     "zip",
     "tgz"
   ]).describe("The format of the generated archive.");
+  GenerateArchiveGlobals$zodSchema = object({
+    cloud_name: string2().describe("The cloud name of your product environment.").optional()
+  });
   AssetFolders$zodSchema = union([
     array(string2()),
     string2()
@@ -72613,8 +72812,10 @@ 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."),
+    created_at: exports_iso.datetime({ offset: true }).optional().describe("The timestamp when the folder was created."),
+    external_id: string2().describe("The unique identifier for the folder."),
+    name: string2().describe("The name of the folder."),
+    path: string2().describe("The full path of the folder."),
     success: boolean2().optional().describe("Whether the operation was successful.")
   });
 });
@@ -72632,8 +72833,8 @@ var init_createfolderop = __esm(() => {
     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,
-    CreateFolderResponse$zodSchema
+    CreateFolderResponse$zodSchema,
+    ApiError$zodSchema
   ]);
 });
 
@@ -73262,8 +73463,530 @@ Renames or moves an entire folder (along with all assets it contains) to a new l
   };
 });
 
+// src/models/imageformat.ts
+var ImageFormat$zodSchema;
+var init_imageformat = __esm(() => {
+  init_zod();
+  ImageFormat$zodSchema = _enum2([
+    "jpeg",
+    "png",
+    "webp"
+  ]).describe("Desired output image format. Optional; defaults to `png` when omitted.\nMapped to the closest format the chosen model supports — `webp` falls\nback to `png` on models that don't support it (e.g. FLUX.2 Pro), and the\nrequest is ignored entirely by models that don't expose a format option\n(e.g. Recraft).\n");
+});
+
+// src/models/declarativeimagesize.ts
+var AspectRatio$zodSchema, Resolution$zodSchema, DeclarativeImageSize$zodSchema;
+var init_declarativeimagesize = __esm(() => {
+  init_zod();
+  AspectRatio$zodSchema = _enum2([
+    "1:1",
+    "16:9",
+    "9:16",
+    "4:3",
+    "3:4"
+  ]).describe(`Output aspect ratio, width-to-height. Limited to the core ratios
+every model supports natively.
+`);
+  Resolution$zodSchema = _enum2([
+    "0.5K",
+    "1K",
+    "2K",
+    "4K"
+  ]).describe("Output resolution tier, measured on the longest edge. Defaults to\n`1K` when omitted.\n* `0.5K`: ~512 px\n* `1K`: ~1024 px\n* `2K`: ~2048 px\n* `4K`: ~4096 px\n");
+  DeclarativeImageSize$zodSchema = object({
+    aspect_ratio: AspectRatio$zodSchema.describe(`Output aspect ratio, width-to-height. Limited to the core ratios
+every model supports natively.
+`),
+    resolution: Resolution$zodSchema.optional().describe("Output resolution tier, measured on the longest edge. Defaults to\n`1K` when omitted.\n* `0.5K`: ~512 px\n* `1K`: ~1024 px\n* `2K`: ~2048 px\n* `4K`: ~4096 px\n")
+  }).describe(`Declarative output size — an aspect ratio plus an optional resolution
+tier, resolved server-side to the nearest size the model supports.
+`);
+});
+
+// src/models/dimensionsimagesize.ts
+var DimensionsImageSize$zodSchema;
+var init_dimensionsimagesize = __esm(() => {
+  init_zod();
+  DimensionsImageSize$zodSchema = object({
+    height: int().describe("Output height in pixels."),
+    width: int().describe("Output width in pixels.")
+  }).describe("Exact output dimensions in pixels. Both `width` and `height` are required together.");
+});
+
+// src/models/imagesize.ts
+var ImageSize$zodSchema;
+var init_imagesize = __esm(() => {
+  init_zod();
+  init_declarativeimagesize();
+  init_dimensionsimagesize();
+  ImageSize$zodSchema = union([
+    DimensionsImageSize$zodSchema,
+    DeclarativeImageSize$zodSchema
+  ]).describe("Desired output size, given in **one** of two mutually exclusive forms:\n\n  * `DimensionsImageSize`: `width` and `height` in pixels, for precise\n    control.\n  * `DeclarativeImageSize`: `aspect_ratio` (and an optional `resolution`\n    tier), resolved server-side to the closest size the chosen model\n    supports. This is the portable form: most providers natively accept\n    an aspect ratio plus a resolution tier rather than raw pixels.\n\nOmit `image_size` entirely to use the model's default size.\n");
+});
+
+// src/models/modelbyfamily.ts
+var Family$zodSchema, Tier$zodSchema, ModelByFamily$zodSchema;
+var init_modelbyfamily = __esm(() => {
+  init_zod();
+  Family$zodSchema = _enum2([
+    "flux",
+    "recraft",
+    "gpt-image",
+    "nano-banana",
+    "ideogram"
+  ]).describe("Model family:\n* `flux`: Photorealistic images (FLUX.2 Klein 9B / FLUX.2 Pro).\n* `recraft`: Vector and illustration (Recraft V3 / Recraft V4).\n* `gpt-image`: Campaign and marketing images (GPT Image 1 Mini / GPT Image 2).\n* `nano-banana`: General purpose generation (Nano Banana 1 / Nano Banana 2).\n* `ideogram`: Realism, text rendering, and artistic generation (Ideogram V4).\n");
+  Tier$zodSchema = _enum2([
+    "standard",
+    "premium"
+  ]).describe("Quality tier within the family. Defaults to `standard` when omitted.");
+  ModelByFamily$zodSchema = object({
+    family: Family$zodSchema.describe("Model family:\n* `flux`: Photorealistic images (FLUX.2 Klein 9B / FLUX.2 Pro).\n* `recraft`: Vector and illustration (Recraft V3 / Recraft V4).\n* `gpt-image`: Campaign and marketing images (GPT Image 1 Mini / GPT Image 2).\n* `nano-banana`: General purpose generation (Nano Banana 1 / Nano Banana 2).\n* `ideogram`: Realism, text rendering, and artistic generation (Ideogram V4).\n"),
+    tier: Tier$zodSchema.optional().describe("Quality tier within the family. Defaults to `standard` when omitted.")
+  }).describe("Select a model by family and quality tier; a missing `tier` defaults to\n`standard`.\n");
+});
+
+// src/models/modelbyid.ts
+var Id$zodSchema, ModelById$zodSchema;
+var init_modelbyid = __esm(() => {
+  init_zod();
+  Id$zodSchema = _enum2([
+    "nano-banana-1",
+    "nano-banana-2",
+    "flux-2-klein-9b",
+    "flux-2-pro",
+    "recraft-v3",
+    "recraft-v4",
+    "gpt-image-1-mini",
+    "gpt-image-2",
+    "ideogram-v4-base",
+    "ideogram-v4-turbo",
+    "nano-banana-1-edit",
+    "nano-banana-2-edit",
+    "flux-2-klein-9b-edit",
+    "flux-2-pro-edit",
+    "recraft-v3-edit",
+    "gpt-image-1-mini-edit",
+    "gpt-image-2-edit"
+  ]).describe("Exact model identifier; overrides family/tier when provided. The\n`-edit` models accept reference images and are selectable only on\n`image_to_image`; the others only on `text_to_image`.\n");
+  ModelById$zodSchema = object({
+    id: Id$zodSchema.describe("Exact model identifier; overrides family/tier when provided. The\n`-edit` models accept reference images and are selectable only on\n`image_to_image`; the others only on `text_to_image`.\n")
+  }).describe("Pin an exact model by ID, bypassing family/tier.");
+});
+
+// src/models/modelselection.ts
+var ModelSelection$zodSchema;
+var init_modelselection = __esm(() => {
+  init_zod();
+  init_modelbyfamily();
+  init_modelbyid();
+  ModelSelection$zodSchema = union([
+    ModelByFamily$zodSchema,
+    ModelById$zodSchema
+  ]).describe("Selects the model, in one of two mutually exclusive forms (omit to use\nthe global default):\n  * `ModelByFamily`: `family` (+ optional `tier`); the stable-over-time\n    selector.\n  * `ModelById`: an explicit `id`, pinning one exact model.\n");
+});
+
+// src/models/managedassettarget.ts
+var ManagedAssetTargetTargetType$zodSchema, ManagedAssetTarget$zodSchema;
+var init_managedassettarget = __esm(() => {
+  init_zod();
+  ManagedAssetTargetTargetType$zodSchema = _enum2([
+    "managed_asset"
+  ]).describe("Discriminator identifying this as a managed-asset target.");
+  ManagedAssetTarget$zodSchema = object({
+    public_id: string2().optional().describe("Public ID to store the asset under. Auto-assigned when omitted."),
+    target_type: ManagedAssetTargetTargetType$zodSchema.describe("Discriminator identifying this as a managed-asset target."),
+    upload_preset: string2().optional().describe("Upload preset to apply. Uses the product environment's default when omitted.")
+  }).describe("Store the output as a permanent managed asset in your Cloudinary product environment (the default).");
+});
+
+// src/models/temporarytarget.ts
+var TemporaryTargetTargetType$zodSchema, TemporaryTarget$zodSchema;
+var init_temporarytarget = __esm(() => {
+  init_zod();
+  TemporaryTargetTargetType$zodSchema = _enum2([
+    "temporary"
+  ]).describe("Discriminator identifying this as a temporary target.");
+  TemporaryTarget$zodSchema = object({
+    target_type: TemporaryTargetTargetType$zodSchema.describe("Discriminator identifying this as a temporary target.")
+  }).describe("Store the output as a short-lived asset on the upload service.");
+});
+
+// src/models/target.ts
+var Target$zodSchema;
+var init_target = __esm(() => {
+  init_zod();
+  init_managedassettarget();
+  init_temporarytarget();
+  Target$zodSchema = union([
+    ManagedAssetTarget$zodSchema.and(object({
+      target_type: literal("managed_asset")
+    }).transform((v2) => ({ target_type: v2.target_type }))),
+    TemporaryTarget$zodSchema.and(object({
+      target_type: literal("temporary")
+    }).transform((v2) => ({ target_type: v2.target_type })))
+  ]).describe("Where to store the generated output, determined by `target_type`.\nOptional; defaults to a `managed_asset` target when omitted.\n");
+});
+
+// src/models/generateimagerequest.ts
+var GenerateImageRequest$zodSchema;
+var init_generateimagerequest = __esm(() => {
+  init_zod();
+  init_imageformat();
+  init_imagesize();
+  init_modelselection();
+  init_target();
+  GenerateImageRequest$zodSchema = object({
+    async: boolean2().default(false).describe(`Whether to perform the generation asynchronously. When true, the API
+returns immediately with a 202 and completes in the background. Once
+complete, a webhook notification is sent to the specified URL and/or to
+the URLs defined in the product environment's settings.
+`),
+    format: ImageFormat$zodSchema.optional().describe("Desired output image format. Optional; defaults to `png` when omitted.\nMapped to the closest format the chosen model supports — `webp` falls\nback to `png` on models that don't support it (e.g. FLUX.2 Pro), and the\nrequest is ignored entirely by models that don't expose a format option\n(e.g. Recraft).\n"),
+    image_size: ImageSize$zodSchema.optional().describe("Desired output size, given in **one** of two mutually exclusive forms:\n\n  * `DimensionsImageSize`: `width` and `height` in pixels, for precise\n    control.\n  * `DeclarativeImageSize`: `aspect_ratio` (and an optional `resolution`\n    tier), resolved server-side to the closest size the chosen model\n    supports. This is the portable form: most providers natively accept\n    an aspect ratio plus a resolution tier rather than raw pixels.\n\nOmit `image_size` entirely to use the model's default size.\n"),
+    model: ModelSelection$zodSchema.optional().describe("Selects the model, in one of two mutually exclusive forms (omit to use\nthe global default):\n  * `ModelByFamily`: `family` (+ optional `tier`); the stable-over-time\n    selector.\n  * `ModelById`: an explicit `id`, pinning one exact model.\n"),
+    notification_url: string2().optional().describe("The webhook URL to notify when the generation is complete. Only relevant when `async` is set to true."),
+    prompt: string2().describe("The text description of the image to generate."),
+    seed: int().nullable().optional().describe(`Seed for reproducible generation. Supported by most models. Silently
+ignored by models that don't support it.
+`),
+    target: Target$zodSchema.optional().describe("Where to store the generated output, determined by `target_type`.\nOptional; defaults to a `managed_asset` target when omitted.\n")
+  }).describe("Parameters for an image-generation request. Only `prompt` is required;\nall other fields fall back to documented defaults.\n");
+});
+
+// src/funcs/generationGenerateImage.ts
+function generationGenerateImage(client$, request, options) {
+  return new APIPromise($do19(client$, request, options));
+}
+async function $do19(client$, request, options) {
+  const parsed$ = safeParse4(request, (value$) => GenerateImageRequest$zodSchema.parse(value$), "Input validation failed");
+  if (!parsed$.ok) {
+    return [parsed$, { status: "invalid" }];
+  }
+  const payload$ = parsed$.value;
+  const body$ = encodeJSON("body", payload$, { explode: true });
+  const pathParams$ = {
+    cloud_name: encodeSimple("cloud_name", client$._options.cloud_name, {
+      explode: false,
+      charEncoding: "percent"
+    })
+  };
+  const path$ = pathToFunc("/v2/generate/{cloud_name}/text_to_image")(pathParams$);
+  const headers$ = new Headers(compactMap({
+    "Content-Type": "application/json",
+    Accept: "application/json"
+  }));
+  const securityInput = await extractSecurity(client$._options.security);
+  const requestSecurity = resolveGlobalSecurity(securityInput);
+  const context = {
+    options: client$._options,
+    baseURL: options?.serverURL ?? client$._baseURL ?? "",
+    operationID: "generate_image",
+    oAuth2Scopes: null,
+    resolvedSecurity: requestSecurity,
+    securitySource: client$._options.security,
+    retryConfig: options?.retries || client$._options.retryConfig || { strategy: "none" },
+    retryCodes: options?.retryCodes || [
+      "429",
+      "500",
+      "502",
+      "503",
+      "504"
+    ]
+  };
+  const requestRes = client$._createRequest(context, {
+    security: requestSecurity,
+    method: "POST",
+    baseURL: options?.serverURL,
+    path: path$,
+    headers: headers$,
+    body: body$,
+    userAgent: client$._options.userAgent,
+    timeoutMs: options?.timeoutMs || client$._options.timeoutMs || -1
+  }, options);
+  if (!requestRes.ok) {
+    return [requestRes, { status: "invalid" }];
+  }
+  const req$ = requestRes.value;
+  const doResult = await client$._do(req$, {
+    context,
+    errorCodes: [],
+    retryConfig: context.retryConfig,
+    retryCodes: context.retryCodes
+  });
+  if (!doResult.ok) {
+    return [doResult, { status: "request-error", request: req$ }];
+  }
+  return [doResult, {
+    status: "complete",
+    request: req$,
+    response: doResult.value
+  }];
+}
+var init_generationGenerateImage = __esm(() => {
+  init_encodings();
+  init_primitives();
+  init_schemas4();
+  init_security();
+  init_url();
+  init_generateimagerequest();
+  init_async();
+});
+
+// src/mcp-server/tools/generationGenerateImage.ts
+var args18, tool$generationGenerateImage;
+var init_generationGenerateImage2 = __esm(() => {
+  init_generationGenerateImage();
+  init_generateimagerequest();
+  init_tools();
+  args18 = {
+    request: GenerateImageRequest$zodSchema.describe(`A JSON object containing the generation request parameters.`)
+  };
+  tool$generationGenerateImage = {
+    name: "generate-image",
+    description: `Generate an image
+
+Generate an image from a text prompt using AI models.
+
+The model is selected via the optional \`model\` object:
+1. If \`model.id\` is provided, use that exact model.
+2. Else if \`model.family\` (+ optional \`model.tier\`) is provided, resolve via the model registry; a missing tier defaults to \`standard\`.
+3. If \`model\` is omitted, use the global default (nano-banana / premium, i.e. \`nano-banana-2\`).
+`,
+    scopes: ["builder"],
+    annotations: {
+      title: "Generate an Image",
+      destructiveHint: false,
+      idempotentHint: false,
+      openWorldHint: false,
+      readOnlyHint: false
+    },
+    args: args18,
+    tool: async (client, args19, ctx) => {
+      const [result] = await generationGenerateImage(client, args19.request, { fetchOptions: { signal: ctx.signal } }).$inspect();
+      if (!result.ok) {
+        return {
+          content: [{ type: "text", text: result.error.message }],
+          isError: true
+        };
+      }
+      return formatResult(result.value);
+    }
+  };
+});
+
+// src/models/managedassetreference.ts
+var ManagedAssetReferenceSourceType$zodSchema, ManagedAssetReference$zodSchema;
+var init_managedassetreference = __esm(() => {
+  init_zod();
+  ManagedAssetReferenceSourceType$zodSchema = _enum2([
+    "managed_asset"
+  ]).describe("Discriminator identifying this as a managed-asset reference.");
+  ManagedAssetReference$zodSchema = object({
+    asset_id: string2().describe("Cloudinary asset ID of the reference image. READ permission is enforced."),
+    source_type: ManagedAssetReferenceSourceType$zodSchema.describe("Discriminator identifying this as a managed-asset reference.")
+  }).describe(`A reference to a managed asset in the caller's product environment, by
+asset ID.
+`);
+});
+
+// src/models/urlreference.ts
+var UrlReferenceSourceType$zodSchema, UrlReference$zodSchema;
+var init_urlreference = __esm(() => {
+  init_zod();
+  UrlReferenceSourceType$zodSchema = _enum2([
+    "url"
+  ]).describe("Discriminator identifying this as an external-URL reference.");
+  UrlReference$zodSchema = object({
+    source_type: UrlReferenceSourceType$zodSchema.describe("Discriminator identifying this as an external-URL reference."),
+    url: string2().describe("HTTPS URL of the reference image.")
+  }).describe("A reference to an external image by HTTPS URL.");
+});
+
+// src/models/referenceimage.ts
+var ReferenceImage$zodSchema;
+var init_referenceimage = __esm(() => {
+  init_zod();
+  init_managedassetreference();
+  init_urlreference();
+  ReferenceImage$zodSchema = union([
+    ManagedAssetReference$zodSchema.and(object({
+      source_type: literal("managed_asset")
+    }).transform((v2) => ({ source_type: v2.source_type }))),
+    UrlReference$zodSchema.and(object({
+      source_type: literal("url")
+    }).transform((v2) => ({ source_type: v2.source_type })))
+  ]).describe("A single reference image, in **one** of two mutually exclusive forms\ndetermined by `source_type`:\n  * `ManagedAssetReference`: a managed asset in the caller's product\n    environment, by `asset_id` (read permission is checked).\n  * `UrlReference`: an external image by HTTPS `url`.\n");
+});
+
+// src/models/imagetoimagerequest.ts
+var ImageToImageRequest$zodSchema;
+var init_imagetoimagerequest = __esm(() => {
+  init_zod();
+  init_imageformat();
+  init_imagesize();
+  init_modelselection();
+  init_referenceimage();
+  init_target();
+  ImageToImageRequest$zodSchema = object({
+    async: boolean2().default(false).describe(`Whether to perform the generation asynchronously. When true, the API
+returns immediately with a 202 and completes in the background. Once
+complete, a webhook notification is sent to the specified URL and/or to
+the URLs defined in the product environment's settings.
+`),
+    format: ImageFormat$zodSchema.optional().describe("Desired output image format. Optional; defaults to `png` when omitted.\nMapped to the closest format the chosen model supports — `webp` falls\nback to `png` on models that don't support it (e.g. FLUX.2 Pro), and the\nrequest is ignored entirely by models that don't expose a format option\n(e.g. Recraft).\n"),
+    image_size: ImageSize$zodSchema.optional().describe("Desired output size, given in **one** of two mutually exclusive forms:\n\n  * `DimensionsImageSize`: `width` and `height` in pixels, for precise\n    control.\n  * `DeclarativeImageSize`: `aspect_ratio` (and an optional `resolution`\n    tier), resolved server-side to the closest size the chosen model\n    supports. This is the portable form: most providers natively accept\n    an aspect ratio plus a resolution tier rather than raw pixels.\n\nOmit `image_size` entirely to use the model's default size.\n"),
+    model: ModelSelection$zodSchema.optional().describe("Selects the model, in one of two mutually exclusive forms (omit to use\nthe global default):\n  * `ModelByFamily`: `family` (+ optional `tier`); the stable-over-time\n    selector.\n  * `ModelById`: an explicit `id`, pinning one exact model.\n"),
+    notification_url: string2().optional().describe("The webhook URL to notify when the generation is complete. Only relevant when `async` is set to true."),
+    prompt: string2().describe("The text instruction describing the desired edit / output."),
+    reference_images: array(ReferenceImage$zodSchema).describe("Reference images that steer the generation, in order (1-indexed; the\nprompt may address them positionally as `[1]`, `[2]`, …). Each entry\nis either a managed asset (by `asset_id`) or an external `url`. The\nplatform accepts up to 4; a specific model may accept fewer (e.g.\nRecraft accepts 1) — exceeding the selected model's capacity returns\n400.\n"),
+    seed: int().nullable().optional().describe(`Seed for reproducible generation. Supported by most models. Silently
+ignored by models that don't support it.
+`),
+    target: Target$zodSchema.optional().describe("Where to store the generated output, determined by `target_type`.\nOptional; defaults to a `managed_asset` target when omitted.\n")
+  }).describe("Parameters for an image-to-image (reference-guided) request. Both\n`prompt` (the edit instruction) and `reference_images` are required; all\nother fields fall back to the same defaults as `text_to_image`.\n");
+});
+
+// src/funcs/generationGenerateImageFromImages.ts
+function generationGenerateImageFromImages(client$, request, options) {
+  return new APIPromise($do20(client$, request, options));
+}
+async function $do20(client$, request, options) {
+  const parsed$ = safeParse4(request, (value$) => ImageToImageRequest$zodSchema.parse(value$), "Input validation failed");
+  if (!parsed$.ok) {
+    return [parsed$, { status: "invalid" }];
+  }
+  const payload$ = parsed$.value;
+  const body$ = encodeJSON("body", payload$, { explode: true });
+  const pathParams$ = {
+    cloud_name: encodeSimple("cloud_name", client$._options.cloud_name, {
+      explode: false,
+      charEncoding: "percent"
+    })
+  };
+  const path$ = pathToFunc("/v2/generate/{cloud_name}/image_to_image")(pathParams$);
+  const headers$ = new Headers(compactMap({
+    "Content-Type": "application/json",
+    Accept: "application/json"
+  }));
+  const securityInput = await extractSecurity(client$._options.security);
+  const requestSecurity = resolveGlobalSecurity(securityInput);
+  const context = {
+    options: client$._options,
+    baseURL: options?.serverURL ?? client$._baseURL ?? "",
+    operationID: "generate_image_from_images",
+    oAuth2Scopes: null,
+    resolvedSecurity: requestSecurity,
+    securitySource: client$._options.security,
+    retryConfig: options?.retries || client$._options.retryConfig || { strategy: "none" },
+    retryCodes: options?.retryCodes || [
+      "429",
+      "500",
+      "502",
+      "503",
+      "504"
+    ]
+  };
+  const requestRes = client$._createRequest(context, {
+    security: requestSecurity,
+    method: "POST",
+    baseURL: options?.serverURL,
+    path: path$,
+    headers: headers$,
+    body: body$,
+    userAgent: client$._options.userAgent,
+    timeoutMs: options?.timeoutMs || client$._options.timeoutMs || -1
+  }, options);
+  if (!requestRes.ok) {
+    return [requestRes, { status: "invalid" }];
+  }
+  const req$ = requestRes.value;
+  const doResult = await client$._do(req$, {
+    context,
+    errorCodes: [],
+    retryConfig: context.retryConfig,
+    retryCodes: context.retryCodes
+  });
+  if (!doResult.ok) {
+    return [doResult, { status: "request-error", request: req$ }];
+  }
+  return [doResult, {
+    status: "complete",
+    request: req$,
+    response: doResult.value
+  }];
+}
+var init_generationGenerateImageFromImages = __esm(() => {
+  init_encodings();
+  init_primitives();
+  init_schemas4();
+  init_security();
+  init_url();
+  init_imagetoimagerequest();
+  init_async();
+});
+
+// src/mcp-server/tools/generationGenerateImageFromImages.ts
+var args19, tool$generationGenerateImageFromImages;
+var init_generationGenerateImageFromImages2 = __esm(() => {
+  init_generationGenerateImageFromImages();
+  init_imagetoimagerequest();
+  init_tools();
+  args19 = {
+    request: ImageToImageRequest$zodSchema.describe(`A JSON object containing the image-to-image generation request parameters.`)
+  };
+  tool$generationGenerateImageFromImages = {
+    name: "generate-image-from-images",
+    description: `Generate an image from reference images
+
+Generate an image guided by one or more **reference images** — restyle,
+on-brand variants, character consistency, virtual try-on, edit/extend —
+steered by \`prompt\`.
+
+Only edit-capable models are selectable here. The model is selected via
+the optional \`model\` object, exactly like \`text_to_image\`, but IDs are
+restricted to edit models:
+1. If \`model.id\` is provided, use that exact edit model.
+2. Else if \`model.family\` (+ optional \`model.tier\`) is provided, resolve
+
+
+
+
+
+
+
+
+   to that family's edit model (e.g. \`nano-banana\` / \`premium\` →
+   \`nano-banana-2-edit\`).
+3. If \`model\` is omitted, use the default edit model (\`nano-banana-2-edit\`).
+
+Each reference image is either a stored managed asset (by \`asset_id\`,
+read-permission checked) or an external HTTPS \`url\`.
+`,
+    scopes: ["builder"],
+    annotations: {
+      title: "Generate an Image from Reference Images",
+      destructiveHint: false,
+      idempotentHint: false,
+      openWorldHint: false,
+      readOnlyHint: false
+    },
+    args: args19,
+    tool: async (client, args20, ctx) => {
+      const [result] = await generationGenerateImageFromImages(client, args20.request, { fetchOptions: { signal: ctx.signal } }).$inspect();
+      if (!result.ok) {
+        return {
+          content: [{ type: "text", text: result.error.message }],
+          isError: true
+        };
+      }
+      return formatResult(result.value);
+    }
+  };
+});
+
 // src/models/searchparameters.ts
-var Type$zodSchema, SearchParametersRange$zodSchema, Aggregate$zodSchema, AggregateEnum$zodSchema, AggregateUnion$zodSchema, WithField$zodSchema, SearchParameters$zodSchema;
+var Type$zodSchema, AggregateEnum$zodSchema, WithField$zodSchema, SearchParametersRange$zodSchema, Aggregate$zodSchema, AggregateUnion$zodSchema, SearchParameters$zodSchema;
 var init_searchparameters = __esm(() => {
   init_zod();
   init_directionenum();
@@ -73273,25 +73996,11 @@ var init_searchparameters = __esm(() => {
     "video_pixels",
     "duration"
   ]);
-  SearchParametersRange$zodSchema = object({
-    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)).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",
     "resource_type",
     "type"
   ]);
-  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",
@@ -73301,13 +74010,27 @@ var init_searchparameters = __esm(() => {
     "quality_analysis",
     "accessibility_analysis"
   ]);
+  SearchParametersRange$zodSchema = object({
+    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)).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
+  });
+  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.
+`);
   SearchParameters$zodSchema = object({
     aggregate: union([
       array(AggregateEnum$zodSchema),
       array(lazy(() => Aggregate$zodSchema))
     ]).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'),
+    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"`, `tags:"brand:openhaul"`, `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 (`uploaded_at>"2024-01-15"`, `created_at>"2026-01-01T00:00:00Z"`), or relative shorthand `Nh`, `Nd`, `Nw` (`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).
@@ -73324,9 +74047,9 @@ Default: [{"created_at": "desc"}].
 
 // src/funcs/searchSearchAssets.ts
 function searchSearchAssets(client$, request, options) {
-  return new APIPromise($do19(client$, request, options));
+  return new APIPromise($do21(client$, request, options));
 }
-async function $do19(client$, request, options) {
+async function $do21(client$, request, options) {
   const parsed$ = safeParse4(request, (value$) => SearchParameters$zodSchema.parse(value$), "Input validation failed");
   if (!parsed$.ok) {
     return [parsed$, { status: "invalid" }];
@@ -73402,12 +74125,12 @@ var init_searchSearchAssets = __esm(() => {
 });
 
 // src/mcp-server/tools/searchSearchAssets.ts
-var args18, tool$searchSearchAssets;
+var args20, tool$searchSearchAssets;
 var init_searchSearchAssets2 = __esm(() => {
   init_searchSearchAssets();
   init_searchparameters();
   init_tools();
-  args18 = {
+  args20 = {
     request: SearchParameters$zodSchema.describe(`The search query parameters.`)
   };
   tool$searchSearchAssets = {
@@ -73426,11 +74149,12 @@ Uses a Lucene-like query language to filter assets by descriptive attributes (\`
 - **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"\`.
+- **Dates**: ISO-8601 in quotes (\`uploaded_at>"2024-01-15"\`, \`created_at>"2026-01-01T00:00:00Z"\`) or relative shorthand \`Nh\`, \`Nd\`, \`Nw\` (\`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"\`, \`tags:"brand:openhaul"\`, \`aspect_ratio:"16:9"\`, \`folder:"My Folder"\`.
 
 ## Common mistakes
 
+- No months or years shorthand. \`1m\` and \`1y\` are not supported; use ISO dates: \`created_at>"2024-01-01"\` or \`created_at:["2024-01-01" TO "2024-04-01"]\`.
 - 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).
@@ -73475,9 +74199,9 @@ Uses a Lucene-like query language to filter assets by descriptive attributes (\`
     _meta: {
       ui: { resourceUri: appUri("asset-gallery", "search-assets") }
     },
-    args: args18,
-    tool: async (client, args19, ctx) => {
-      const [result] = await searchSearchAssets(client, args19.request, { fetchOptions: { signal: ctx.signal } }).$inspect();
+    args: args20,
+    tool: async (client, args21, ctx) => {
+      const [result] = await searchSearchAssets(client, args21.request, { fetchOptions: { signal: ctx.signal } }).$inspect();
       if (!result.ok) {
         return {
           content: [{ type: "text", text: result.error.message }],
@@ -73514,9 +74238,9 @@ var init_visualsearchparametersunion = __esm(() => {
 
 // src/funcs/searchVisualSearchAssets.ts
 function searchVisualSearchAssets(client$, request, options) {
-  return new APIPromise($do20(client$, request, options));
+  return new APIPromise($do22(client$, request, options));
 }
-async function $do20(client$, request, options) {
+async function $do22(client$, request, options) {
   const parsed$ = safeParse4(request, (value$) => VisualSearchParametersUnion$zodSchema.parse(value$), "Input validation failed");
   if (!parsed$.ok) {
     return [parsed$, { status: "invalid" }];
@@ -73592,12 +74316,12 @@ var init_searchVisualSearchAssets = __esm(() => {
 });
 
 // src/mcp-server/tools/searchVisualSearchAssets.ts
-var args19, tool$searchVisualSearchAssets;
+var args21, tool$searchVisualSearchAssets;
 var init_searchVisualSearchAssets2 = __esm(() => {
   init_searchVisualSearchAssets();
   init_visualsearchparametersunion();
   init_tools();
-  args19 = {
+  args21 = {
     request: VisualSearchParametersUnion$zodSchema.describe(`The visual search parameters.`)
   };
   tool$searchVisualSearchAssets = {
@@ -73617,9 +74341,364 @@ Returns a list of resources that are visually similar to a specified image. You
       openWorldHint: false,
       readOnlyHint: true
     },
-    args: args19,
-    tool: async (client, args20, ctx) => {
-      const [result] = await searchVisualSearchAssets(client, args20.request, { fetchOptions: { signal: ctx.signal } }).$inspect();
+    args: args21,
+    tool: async (client, args22, ctx) => {
+      const [result] = await searchVisualSearchAssets(client, args22.request, { fetchOptions: { signal: ctx.signal } }).$inspect();
+      if (!result.ok) {
+        return {
+          content: [{ type: "text", text: result.error.message }],
+          isError: true
+        };
+      }
+      return formatResult(result.value);
+    }
+  };
+});
+
+// src/models/errorcategory.ts
+var ErrorCategory$zodSchema;
+var init_errorcategory = __esm(() => {
+  init_zod();
+  ErrorCategory$zodSchema = _enum2([
+    "user_error",
+    "auth_error",
+    "server_error",
+    "rate_limit_error"
+  ]).describe("Coarse classification of an error, primarily used by clients to decide whether to retry.\n* `user_error`: the request was invalid; do not retry without changes.\n* `auth_error`: authentication or authorization failed.\n* `server_error`: an unexpected server-side error; retrying may succeed.\n* `rate_limit_error`: quota or rate limit exceeded; retry later.\n");
+});
+
+// src/models/error.ts
+var Details$zodSchema, ErrorT$zodSchema;
+var init_error = __esm(() => {
+  init_zod();
+  init_errorcategory();
+  Details$zodSchema = object({}).describe("Additional structured context about the error, when available.");
+  ErrorT$zodSchema = object({
+    category: ErrorCategory$zodSchema.optional().describe("Coarse classification of an error, primarily used by clients to decide whether to retry.\n* `user_error`: the request was invalid; do not retry without changes.\n* `auth_error`: authentication or authorization failed.\n* `server_error`: an unexpected server-side error; retrying may succeed.\n* `rate_limit_error`: quota or rate limit exceeded; retry later.\n"),
+    code: string2().optional().describe("Stable, machine-readable error code for programmatic handling."),
+    details: lazy(() => Details$zodSchema).optional().describe("Additional structured context about the error, when available."),
+    message: string2().optional().describe("Human-readable description of what went wrong.")
+  }).describe("Details of an error, including a coarse category for retry logic, a stable error code, and a human-readable message.");
+});
+
+// src/models/errorresponse.ts
+var ErrorResponse$zodSchema;
+var init_errorresponse = __esm(() => {
+  init_zod();
+  init_error();
+  ErrorResponse$zodSchema = object({
+    error: ErrorT$zodSchema.describe("Details of an error, including a coarse category for retry logic, a stable error code, and a human-readable message."),
+    request_id: string2().describe("Unique identifier for this request, for correlation and support.")
+  }).describe("Wrapper for error responses; includes the error object and a request_id for correlation.");
+});
+
+// src/models/feature.ts
+var Feature$zodSchema;
+var init_feature = __esm(() => {
+  init_zod();
+  Feature$zodSchema = _enum2([
+    "image_generation"
+  ]).describe("The add-on a quota applies to.");
+});
+
+// src/models/addonquota.ts
+var AddonQuota$zodSchema;
+var init_addonquota = __esm(() => {
+  init_zod();
+  init_feature();
+  AddonQuota$zodSchema = object({
+    limit: int().nullable().describe("Maximum generations allowed per period."),
+    remaining: int().nullable().describe("Generations remaining in the current period."),
+    type: Feature$zodSchema.describe("The add-on a quota applies to."),
+    used_by_request: int().nullable().describe("Number of generations consumed by this request.")
+  }).describe("Quota usage for a single add-on.");
+});
+
+// src/models/limits.ts
+var Limits$zodSchema;
+var init_limits = __esm(() => {
+  init_zod();
+  init_addonquota();
+  Limits$zodSchema = object({
+    addons_quota: array(AddonQuota$zodSchema).optional().describe("Per-add-on quota usage for this account.")
+  }).describe("Rate limit information for the account's add-on quotas.");
+});
+
+// src/models/ratelimitedresponse.ts
+var RateLimitedResponse$zodSchema;
+var init_ratelimitedresponse = __esm(() => {
+  init_zod();
+  init_error();
+  init_limits();
+  RateLimitedResponse$zodSchema = object({
+    error: ErrorT$zodSchema.describe("Details of an error, including a coarse category for retry logic, a stable error code, and a human-readable message."),
+    limits: Limits$zodSchema.optional().describe("Rate limit information for the account's add-on quotas."),
+    request_id: string2().describe("Unique identifier for this request, for correlation and support.")
+  }).describe("Rate limited.");
+});
+
+// src/models/model.ts
+var Model$zodSchema;
+var init_model = __esm(() => {
+  init_zod();
+  Model$zodSchema = object({
+    family: string2().describe("The model family used."),
+    id: string2().describe("The exact model identifier used for generation."),
+    tier: string2().describe("The quality tier used.")
+  }).describe("Identifies the model that produced a generation result.");
+});
+
+// src/models/managedassetstorage.ts
+var ManagedAssetStorageStorageType$zodSchema, ManagedAssetStorageResourceType$zodSchema, ManagedAssetStorage$zodSchema;
+var init_managedassetstorage = __esm(() => {
+  init_zod();
+  ManagedAssetStorageStorageType$zodSchema = _enum2([
+    "managed_asset"
+  ]).describe("Discriminator identifying this as managed-asset storage.");
+  ManagedAssetStorageResourceType$zodSchema = _enum2([
+    "image",
+    "video",
+    "raw"
+  ]).describe("Cloudinary resource type of the stored asset.");
+  ManagedAssetStorage$zodSchema = object({
+    asset_id: string2().optional().describe("Cloudinary asset ID — a stable, globally-unique reference to the asset."),
+    public_id: string2().describe("Public ID of the stored asset."),
+    resource_type: ManagedAssetStorageResourceType$zodSchema.describe("Cloudinary resource type of the stored asset."),
+    secure_url: string2().describe("The URL to fetch the generated asset."),
+    storage_type: ManagedAssetStorageStorageType$zodSchema.describe("Discriminator identifying this as managed-asset storage."),
+    type: string2().describe("Cloudinary delivery type of the stored asset (e.g. `upload`, `private`, `authenticated`)."),
+    version: int().describe("Version of the stored asset.")
+  }).describe("A generated asset stored as a permanent managed asset. Reference it in\nother Cloudinary APIs by `asset_id`, or by the\n`resource_type` / `type` / `public_id` triple.\n");
+});
+
+// src/models/temporarystorage.ts
+var TemporaryStorageStorageType$zodSchema, TemporaryStorage$zodSchema;
+var init_temporarystorage = __esm(() => {
+  init_zod();
+  TemporaryStorageStorageType$zodSchema = _enum2([
+    "temporary"
+  ]).describe("Discriminator identifying this as temporary storage.");
+  TemporaryStorage$zodSchema = object({
+    expires_at: exports_iso.datetime({ offset: true }).describe("Time in UTC when secure_url stops being valid."),
+    secure_url: string2().describe("The URL to fetch the generated asset."),
+    storage_type: TemporaryStorageStorageType$zodSchema.describe("Discriminator identifying this as temporary storage.")
+  }).describe("A generated asset stored as a short-lived asset on the upload service.");
+});
+
+// src/models/storage.ts
+var Storage$zodSchema;
+var init_storage = __esm(() => {
+  init_zod();
+  init_managedassetstorage();
+  init_temporarystorage();
+  Storage$zodSchema = union([
+    ManagedAssetStorage$zodSchema.and(object({
+      storage_type: literal("managed_asset")
+    }).transform((v2) => ({ storage_type: v2.storage_type }))),
+    TemporaryStorage$zodSchema.and(object({
+      storage_type: literal("temporary")
+    }).transform((v2) => ({ storage_type: v2.storage_type })))
+  ]).describe("Where a generated asset is stored — mirrors the request `target`,\ndetermined by `storage_type`. `secure_url` is always present.\n");
+});
+
+// src/models/generatedasset.ts
+var Format$zodSchema, GeneratedAsset$zodSchema;
+var init_generatedasset = __esm(() => {
+  init_zod();
+  init_model();
+  init_storage();
+  Format$zodSchema = _enum2([
+    "png",
+    "jpeg",
+    "webp"
+  ]).describe("The image format of the stored asset.");
+  GeneratedAsset$zodSchema = object({
+    bytes: int().optional().describe("The size of the generated image in bytes."),
+    created_at: exports_iso.datetime({ offset: true }).optional().describe("The timestamp when the image was generated."),
+    format: Format$zodSchema.optional().describe("The image format of the stored asset."),
+    height: int().optional().describe("The height of the generated image in pixels; zero if the model doesn't provide dimensions."),
+    model: Model$zodSchema.optional().describe("Identifies the model that produced a generation result."),
+    seed: int().nullable().optional().describe(`The seed used for generation. Echoes input or returns the model-generated seed.
+Null when the model doesn't support seeds.
+`),
+    storage: Storage$zodSchema.describe("Where a generated asset is stored — mirrors the request `target`,\ndetermined by `storage_type`. `secure_url` is always present.\n"),
+    width: int().optional().describe("The width of the generated image in pixels; zero if the model doesn't provide dimensions.")
+  }).describe("A generated asset: where it is stored (`storage`) plus its media\nmetadata. The media fields are populated once the task completes; an\nin-progress asset carries only `storage`.\n");
+});
+
+// src/models/taskstatus.ts
+var TaskStatus$zodSchema;
+var init_taskstatus = __esm(() => {
+  init_zod();
+  TaskStatus$zodSchema = _enum2([
+    "pending",
+    "processing",
+    "completed",
+    "failed"
+  ]).describe("The status of an async generation task.\n* `pending`: accepted and queued, not yet started.\n* `processing`: generation is in progress.\n* `completed`: generation finished; `result` is populated.\n* `failed`: generation did not complete successfully.\n");
+});
+
+// src/models/task.ts
+var TaskResult$zodSchema, Task$zodSchema;
+var init_task = __esm(() => {
+  init_zod();
+  init_generatedasset();
+  init_limits();
+  init_taskstatus();
+  TaskResult$zodSchema = object({
+    assets: array(GeneratedAsset$zodSchema).describe("The generated assets. Currently a single asset is returned.")
+  }).describe("The generated assets. Populated once `status` is `completed`.\n");
+  Task$zodSchema = object({
+    limits: Limits$zodSchema.optional().describe("Rate limit information for the account's add-on quotas."),
+    result: lazy(() => TaskResult$zodSchema).nullable().optional().describe("The generated assets. Populated once `status` is `completed`.\n"),
+    status: TaskStatus$zodSchema.describe("The status of an async generation task.\n* `pending`: accepted and queued, not yet started.\n* `processing`: generation is in progress.\n* `completed`: generation finished; `result` is populated.\n* `failed`: generation did not complete successfully.\n"),
+    task_id: string2().describe("Identifier for the async generation task. Use it to poll `GET /generate/{cloud_name}/tasks/{task_id}`.")
+  }).describe("An async generation task. Returned when a generation is accepted (202)\nand from GET /tasks/{task_id} as it progresses. The `result` is filled\nin once `status` is `completed`.\n");
+});
+
+// src/models/taskresponse.ts
+var TaskResponse$zodSchema;
+var init_taskresponse = __esm(() => {
+  init_zod();
+  init_task();
+  TaskResponse$zodSchema = object({
+    data: Task$zodSchema.optional().describe("An async generation task. Returned when a generation is accepted (202)\nand from GET /tasks/{task_id} as it progresses. The `result` is filled\nin once `status` is `completed`.\n"),
+    request_id: string2().describe("Unique identifier for this request, for correlation and support.")
+  }).describe(`Envelope for an async generation task — returned by the accepted (202)
+response and by GET /tasks/{task_id}.
+`);
+});
+
+// src/models/getgenerationtaskstatusop.ts
+var GetGenerationTaskStatusGlobals$zodSchema, GetGenerationTaskStatusRequest$zodSchema, GetGenerationTaskStatusResponse$zodSchema;
+var init_getgenerationtaskstatusop = __esm(() => {
+  init_zod();
+  init_errorresponse();
+  init_ratelimitedresponse();
+  init_taskresponse();
+  GetGenerationTaskStatusGlobals$zodSchema = object({
+    cloud_name: string2().describe("The cloud name of your product environment.").optional()
+  });
+  GetGenerationTaskStatusRequest$zodSchema = object({
+    task_id: string2().describe("The ID of the generation task.")
+  });
+  GetGenerationTaskStatusResponse$zodSchema = union([
+    ErrorResponse$zodSchema,
+    RateLimitedResponse$zodSchema,
+    TaskResponse$zodSchema
+  ]);
+});
+
+// src/funcs/tasksGetGenerationTaskStatus.ts
+function tasksGetGenerationTaskStatus(client$, task_id, options) {
+  return new APIPromise($do23(client$, task_id, options));
+}
+async function $do23(client$, task_id, options) {
+  const input$ = {
+    task_id
+  };
+  const parsed$ = safeParse4(input$, (value$) => GetGenerationTaskStatusRequest$zodSchema.parse(value$), "Input validation failed");
+  if (!parsed$.ok) {
+    return [parsed$, { status: "invalid" }];
+  }
+  const payload$ = parsed$.value;
+  const body$ = null;
+  const pathParams$ = {
+    cloud_name: encodeSimple("cloud_name", client$._options.cloud_name, {
+      explode: false,
+      charEncoding: "percent"
+    }),
+    task_id: encodeSimple("task_id", payload$.task_id, {
+      explode: false,
+      charEncoding: "percent"
+    })
+  };
+  const path$ = pathToFunc("/v2/generate/{cloud_name}/tasks/{task_id}")(pathParams$);
+  const headers$ = new Headers(compactMap({
+    Accept: "application/json"
+  }));
+  const securityInput = await extractSecurity(client$._options.security);
+  const requestSecurity = resolveGlobalSecurity(securityInput);
+  const context = {
+    options: client$._options,
+    baseURL: options?.serverURL ?? client$._baseURL ?? "",
+    operationID: "get_generation_task_status",
+    oAuth2Scopes: null,
+    resolvedSecurity: requestSecurity,
+    securitySource: client$._options.security,
+    retryConfig: options?.retries || client$._options.retryConfig || { strategy: "none" },
+    retryCodes: options?.retryCodes || [
+      "429",
+      "500",
+      "502",
+      "503",
+      "504"
+    ]
+  };
+  const requestRes = client$._createRequest(context, {
+    security: requestSecurity,
+    method: "GET",
+    baseURL: options?.serverURL,
+    path: path$,
+    headers: headers$,
+    body: body$,
+    userAgent: client$._options.userAgent,
+    timeoutMs: options?.timeoutMs || client$._options.timeoutMs || -1
+  }, options);
+  if (!requestRes.ok) {
+    return [requestRes, { status: "invalid" }];
+  }
+  const req$ = requestRes.value;
+  const doResult = await client$._do(req$, {
+    context,
+    errorCodes: [],
+    retryConfig: context.retryConfig,
+    retryCodes: context.retryCodes
+  });
+  if (!doResult.ok) {
+    return [doResult, { status: "request-error", request: req$ }];
+  }
+  return [doResult, {
+    status: "complete",
+    request: req$,
+    response: doResult.value
+  }];
+}
+var init_tasksGetGenerationTaskStatus = __esm(() => {
+  init_encodings();
+  init_primitives();
+  init_schemas4();
+  init_security();
+  init_url();
+  init_getgenerationtaskstatusop();
+  init_async();
+});
+
+// src/mcp-server/tools/tasksGetGenerationTaskStatus.ts
+var args22, tool$tasksGetGenerationTaskStatus;
+var init_tasksGetGenerationTaskStatus2 = __esm(() => {
+  init_zod();
+  init_tasksGetGenerationTaskStatus();
+  init_tools();
+  args22 = {
+    task_id: string2().describe("The ID of the generation task.")
+  };
+  tool$tasksGetGenerationTaskStatus = {
+    name: "get-generation-task",
+    description: `Get a generation task
+
+Get the status of a generation task.`,
+    scopes: ["builder"],
+    annotations: {
+      title: "Get a Generation Task",
+      destructiveHint: false,
+      idempotentHint: true,
+      openWorldHint: false,
+      readOnlyHint: true
+    },
+    args: args22,
+    tool: async (client, args23, ctx) => {
+      const [result] = await tasksGetGenerationTaskStatus(client, args23.task_id, { fetchOptions: { signal: ctx.signal } }).$inspect();
       if (!result.ok) {
         return {
           content: [{ type: "text", text: result.error.message }],
@@ -73682,9 +74761,9 @@ var init_uploadop = __esm(() => {
 
 // src/funcs/uploadUpload.ts
 function uploadUpload(client$, resource_type, upload_request, options) {
-  return new APIPromise($do21(client$, resource_type, upload_request, options));
+  return new APIPromise($do24(client$, resource_type, upload_request, options));
 }
-async function $do21(client$, resource_type, upload_request, options) {
+async function $do24(client$, resource_type, upload_request, options) {
   const input$ = {
     resource_type,
     upload_request
@@ -73768,13 +74847,13 @@ var init_uploadUpload = __esm(() => {
 });
 
 // src/mcp-server/tools/uploadUpload.ts
-var args20, tool$uploadUpload;
+var args23, tool$uploadUpload;
 var init_uploadUpload2 = __esm(() => {
   init_uploadUpload();
   init_uploadrequest();
   init_uploadresourcetype();
   init_tools();
-  args20 = {
+  args23 = {
     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.`)
   };
@@ -73808,9 +74887,9 @@ Transform media files using transformation syntax in delivery URLs, which create
     _meta: {
       ui: { resourceUri: appUri("asset-upload", "upload-asset") }
     },
-    args: args20,
-    tool: async (client, args21, ctx) => {
-      const [result] = await uploadUpload(client, args21.resource_type, args21.upload_request, { fetchOptions: { signal: ctx.signal } }).$inspect();
+    args: args23,
+    tool: async (client, args24, ctx) => {
+      const [result] = await uploadUpload(client, args24.resource_type, args24.upload_request, { fetchOptions: { signal: ctx.signal } }).$inspect();
       if (!result.ok) {
         return {
           content: [{ type: "text", text: result.error.message }],
@@ -73823,7 +74902,7 @@ Transform media files using transformation syntax in delivery URLs, which create
 });
 
 // src/models/usageresponse.ts
-var Transformations$zodSchema, Objects$zodSchema, Bandwidth$zodSchema, Storage$zodSchema, Impressions$zodSchema, SecondsDelivered$zodSchema, MediaLimits$zodSchema, UsageResponse$zodSchema;
+var Transformations$zodSchema, Objects$zodSchema, Bandwidth$zodSchema, UsageResponseStorage$zodSchema, Impressions$zodSchema, SecondsDelivered$zodSchema, MediaLimits$zodSchema, UsageResponse$zodSchema;
 var init_usageresponse = __esm(() => {
   init_zod();
   Transformations$zodSchema = object({
@@ -73839,7 +74918,7 @@ var init_usageresponse = __esm(() => {
     usage: int().optional().describe("Bandwidth used in bytes"),
     used_percent: number2().optional().describe("Percentage of bandwidth limit used")
   });
-  Storage$zodSchema = object({
+  UsageResponseStorage$zodSchema = object({
     limit: int().optional().describe("Storage limit for the plan"),
     usage: int().optional().describe("Storage used in bytes"),
     used_percent: number2().optional().describe("Percentage of storage limit used")
@@ -73869,7 +74948,7 @@ var init_usageresponse = __esm(() => {
     requests: int().optional().describe("Number of requests made"),
     resources: int().optional().describe("Number of resources stored"),
     seconds_delivered: lazy(() => SecondsDelivered$zodSchema).optional(),
-    storage: lazy(() => Storage$zodSchema).optional(),
+    storage: lazy(() => UsageResponseStorage$zodSchema).optional(),
     transformations: lazy(() => Transformations$zodSchema).optional()
   });
 });
@@ -73894,9 +74973,9 @@ var init_getusageop = __esm(() => {
 
 // src/funcs/usageGetUsage.ts
 function usageGetUsage(client$, date6, options) {
-  return new APIPromise($do22(client$, date6, options));
+  return new APIPromise($do25(client$, date6, options));
 }
-async function $do22(client$, date6, options) {
+async function $do25(client$, date6, options) {
   const input$ = {
     date: date6
   };
@@ -73978,12 +75057,12 @@ var init_usageGetUsage = __esm(() => {
 });
 
 // src/mcp-server/tools/usageGetUsage.ts
-var args21, tool$usageGetUsage;
+var args24, tool$usageGetUsage;
 var init_usageGetUsage2 = __esm(() => {
   init_zod();
   init_usageGetUsage();
   init_tools();
-  args21 = {
+  args24 = {
     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 = {
@@ -73999,9 +75078,9 @@ A report on the status of product environment usage, including storage, credits,
       openWorldHint: false,
       readOnlyHint: true
     },
-    args: args21,
-    tool: async (client, args22, ctx) => {
-      const [result] = await usageGetUsage(client, args22.date, { fetchOptions: { signal: ctx.signal } }).$inspect();
+    args: args24,
+    tool: async (client, args25, ctx) => {
+      const [result] = await usageGetUsage(client, args25.date, { fetchOptions: { signal: ctx.signal } }).$inspect();
       if (!result.ok) {
         return {
           content: [{ type: "text", text: result.error.message }],
@@ -74017,7 +75096,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.3"
+    version: "0.10.0"
   });
   const getClient = deps.getSDK || (() => new CloudinaryAssetMgmtCore({
     security: deps.security,
@@ -74027,9 +75106,9 @@ function createMCPServer(deps) {
     region: deps.region,
     host: deps.host,
     debugLogger: deps.logger.level === "debug" ? {
-      log: (...args22) => console.log(...args22),
-      group: (...args22) => console.group(...args22),
-      groupEnd: (...args22) => console.groupEnd(...args22)
+      log: (...args25) => console.log(...args25),
+      group: (...args25) => console.group(...args25),
+      groupEnd: (...args25) => console.groupEnd(...args25)
     } : undefined
   }));
   const scopes = new Set(deps.scopes);
@@ -74060,6 +75139,9 @@ function createMCPServer(deps) {
   tool(tool$foldersSearchFolders);
   tool(tool$searchSearchAssets);
   tool(tool$searchVisualSearchAssets);
+  tool(tool$generationGenerateImage);
+  tool(tool$generationGenerateImageFromImages);
+  tool(tool$tasksGetGenerationTaskStatus);
   if (deps.dynamic) {
     registerDynamicTools(deps.logger, server, getClient, toolMap, scopes);
   }
@@ -74089,8 +75171,11 @@ var init_server2 = __esm(() => {
   init_foldersDestroyFolder2();
   init_foldersSearchFolders2();
   init_foldersUpdateFolder2();
+  init_generationGenerateImage2();
+  init_generationGenerateImageFromImages2();
   init_searchSearchAssets2();
   init_searchVisualSearchAssets2();
+  init_tasksGetGenerationTaskStatus2();
   init_uploadUpload2();
   init_usageGetUsage2();
 });
@@ -74234,7 +75319,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\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"
+      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\"`, `created_at>\"2026-01-01T00:00:00Z\"`) or relative shorthand `Nh`, `Nd`, `Nw` (`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\"`, `tags:\"brand:openhaul\"`, `aspect_ratio:\"16:9\"`, `folder:\"My Folder\"`.\n\n## Common mistakes\n\n- No months or years shorthand. `1m` and `1y` are not supported; use ISO dates: `created_at>\"2024-01-01\"` or `created_at:[\"2024-01-01\" TO \"2024-04-01\"]`.\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",
@@ -74245,6 +75330,20 @@ Returns a list of resources that are visually similar to a specified image. You
 - Specify the asset ID of an existing image
 - Provide a textual description
 `
+    },
+    {
+      name: "generate-image",
+      description: "Generate an image\n\nGenerate an image from a text prompt using AI models.\n\nThe model is selected via the optional `model` object:\n1. If `model.id` is provided, use that exact model.\n2. Else if `model.family` (+ optional `model.tier`) is provided, resolve via the model registry; a missing tier defaults to `standard`.\n3. If `model` is omitted, use the global default (nano-banana / premium, i.e. `nano-banana-2`).\n"
+    },
+    {
+      name: "generate-image-from-images",
+      description: "Generate an image from reference images\n\nGenerate an image guided by one or more **reference images** — restyle,\non-brand variants, character consistency, virtual try-on, edit/extend —\nsteered by `prompt`.\n\nOnly edit-capable models are selectable here. The model is selected via\nthe optional `model` object, exactly like `text_to_image`, but IDs are\nrestricted to edit models:\n1. If `model.id` is provided, use that exact edit model.\n2. Else if `model.family` (+ optional `model.tier`) is provided, resolve\n\n\n\n\n\n\n\n\n   to that family's edit model (e.g. `nano-banana` / `premium` →\n   `nano-banana-2-edit`).\n3. If `model` is omitted, use the default edit model (`nano-banana-2-edit`).\n\nEach reference image is either a stored managed asset (by `asset_id`,\nread-permission checked) or an external HTTPS `url`.\n"
+    },
+    {
+      name: "get-generation-task",
+      description: `Get a generation task
+
+Get the status of a generation task.`
     },
     {
       name: "get-tx-reference",
@@ -75199,7 +76298,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.3/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.10.0/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>
@@ -77143,7 +78242,7 @@ var routes = ln({
 var app = _e(routes, {
   name: "mcp",
   versionInfo: {
-    currentVersion: "0.9.3"
+    currentVersion: "0.10.0"
   }
 });
 Yt(app, process4.argv.slice(2), buildContext(process4));
@@ -77151,5 +78250,5 @@ export {
   app
 };
 
-//# debugId=6C5BCA15F724A25664756E2164756E21
+//# debugId=F2E22CE70DACAAF964756E2164756E21
 //# sourceMappingURL=mcp-server.js.map