@cloudinary/asset-management-mcp 0.9.2 → 0.10.0

package/src/funcs/uploadEvalUploadParams.ts

@@ -0,0 +1,154 @@
+/*
+ * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+ * @generated-id: ec50bea37a36
+ */
+
+import { CloudinaryAssetMgmtCore } from "../core.js";
+import { encodeJSON, encodeSimple } from "../lib/encodings.js";
+import { compactMap } from "../lib/primitives.js";
+import { safeParse } from "../lib/schemas.js";
+import { RequestOptions } from "../lib/sdks.js";
+import { extractSecurity, resolveGlobalSecurity } from "../lib/security.js";
+import { pathToFunc } from "../lib/url.js";
+import { APIError } from "../models/errors/apierror.js";
+import {
+  ConnectionError,
+  InvalidRequestError,
+  RequestAbortedError,
+  RequestTimeoutError,
+  UnexpectedClientError,
+} from "../models/errors/httpclienterrors.js";
+import { SDKValidationError } from "../models/errors/sdkvalidationerror.js";
+import {
+  EvalRequest,
+  EvalRequest$zodSchemaOutbound,
+} from "../models/evalrequest.js";
+import { APICall, APIPromise } from "../types/async.js";
+import { Result } from "../types/fp.js";
+
+/**
+ * Evaluate a dynamic upload-parameter expression
+ *
+ * @remarks
+ * Evaluates a dynamic eval expression against the supplied upload parameters and returns the resulting upload parameters.
+ */
+export function uploadEvalUploadParams(
+  client$: CloudinaryAssetMgmtCore,
+  request: EvalRequest,
+  options?: RequestOptions,
+): APIPromise<
+  Result<
+    Response,
+    | APIError
+    | SDKValidationError
+    | UnexpectedClientError
+    | InvalidRequestError
+    | RequestAbortedError
+    | RequestTimeoutError
+    | ConnectionError
+  >
+> {
+  return new APIPromise($do(
+    client$,
+    request,
+    options,
+  ));
+}
+
+async function $do(
+  client$: CloudinaryAssetMgmtCore,
+  request: EvalRequest,
+  options?: RequestOptions,
+): Promise<
+  [
+    Result<
+      Response,
+      | APIError
+      | SDKValidationError
+      | UnexpectedClientError
+      | InvalidRequestError
+      | RequestAbortedError
+      | RequestTimeoutError
+      | ConnectionError
+    >,
+    APICall,
+  ]
+> {
+  const parsed$ = safeParse(
+    request,
+    (value$) => EvalRequest$zodSchemaOutbound.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("/v1_1/{cloud_name}/eval")(
+    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: "evalUploadParams",
+    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,
+  }];
+}

package/src/funcs/uploadUploadChunk.ts

@@ -41,13 +41,26 @@ export enum UploadChunkAcceptEnum {
  * large files with the ability to resume interrupted uploads. Each request uploads one chunk of the file.
  * It is required for any files that are larger than 100 MB. This is often relevant for video files, as they
  * tend to have larger file sizes. Minimum chunk size is 5 MB.
+ *
+ * The `file` field accepts either the chunk bytes (multipart) or an HTTP/HTTPS URL. When a URL is supplied,
+ * Cloudinary downloads it and validates the response `Content-Length` against the chunk-size contract
+ * (exact match in the uniform-size flow; within 5 MB floor and 5 GiB cap in explicit-order mode) before
+ * storing any bytes. A mismatch aborts with 400 and persists no state. The remote server must return a
+ * `Content-Length` header; chunked transfer-encoded responses are rejected.
+ *
+ * **Explicit-order totals** (`X-Upload-Part-Number`): `X-Upload-Total-Parts` may be omitted on non-terminal
+ * chunks until the session total *N* is established by any earlier chunk that sent the header. After *N* is
+ * known, the chunk for part index *N* must include `X-Upload-Total-Parts: N`. Whenever the header appears,
+ * its value must be the same integer *N* for that `X-Unique-Upload-Id` (no conflicting totals).
  */
 export function uploadUploadChunk(
   client$: CloudinaryAssetMgmtCore,
   resource_type: UploadResourceType | undefined,
-  contentRange: string,
   xUniqueUploadId: string,
   upload_request: UploadRequest,
+  contentRange?: string | undefined,
+  xUploadPartNumber?: number | undefined,
+  xUploadTotalParts?: number | undefined,
   options?: RequestOptions,
 ): APIPromise<
   Result<
@@ -64,9 +77,11 @@ export function uploadUploadChunk(
   return new APIPromise($do(
     client$,
     resource_type,
-    contentRange,
     xUniqueUploadId,
     upload_request,
+    contentRange,
+    xUploadPartNumber,
+    xUploadTotalParts,
     options,
   ));
 }
@@ -74,9 +89,11 @@ export function uploadUploadChunk(
 async function $do(
   client$: CloudinaryAssetMgmtCore,
   resource_type: UploadResourceType | undefined,
-  contentRange: string,
   xUniqueUploadId: string,
   upload_request: UploadRequest,
+  contentRange?: string | undefined,
+  xUploadPartNumber?: number | undefined,
+  xUploadTotalParts?: number | undefined,
   options?: RequestOptions & { acceptHeaderOverride?: UploadChunkAcceptEnum },
 ): Promise<
   [
@@ -95,9 +112,11 @@ async function $do(
 > {
   const input$: UploadChunkRequest = {
     resource_type: resource_type,
-    contentRange: contentRange,
     xUniqueUploadId: xUniqueUploadId,
     upload_request: upload_request,
+    contentRange: contentRange,
+    xUploadPartNumber: xUploadPartNumber,
+    xUploadTotalParts: xUploadTotalParts,
   };
 
   const parsed$ = safeParse(
@@ -138,6 +157,16 @@ async function $do(
       payload$.xUniqueUploadId,
       { explode: false, charEncoding: "none" },
     ),
+    "X-Upload-Part-Number": encodeSimple(
+      "X-Upload-Part-Number",
+      payload$.xUploadPartNumber,
+      { explode: false, charEncoding: "none" },
+    ),
+    "X-Upload-Total-Parts": encodeSimple(
+      "X-Upload-Total-Parts",
+      payload$.xUploadTotalParts,
+      { explode: false, charEncoding: "none" },
+    ),
   }));
   const securityInput = await extractSecurity(client$._options.security);
   const requestSecurity = resolveGlobalSecurity(securityInput);

package/src/hooks/oauth2scopes.ts

@@ -17,4 +17,8 @@ export type OAuth2Scope =
   /**
    * Allows uploading new assets.
    */
-  | "upload";
+  | "upload"
+  /**
+   * Generate media
+   */
+  | "media_generation";

package/src/landing-page.ts

@@ -939,7 +939,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.2/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;">
             📥 Download MCP Bundle
           </a>
         </div>

package/src/lib/config.ts

@@ -112,9 +112,9 @@ export function serverURLFromOptions(options: SDKOptions): URL | null {
 
 export const SDK_METADATA = {
   language: "typescript",
-  openapiDocVersion: "0.5.1",
-  sdkVersion: "0.9.2",
-  genVersion: "2.885.1",
+  openapiDocVersion: "0.7.4",
+  sdkVersion: "0.10.0",
+  genVersion: "2.918.4",
   userAgent:
-    "speakeasy-sdk/mcp-typescript 0.9.2 2.885.1 0.5.1 @cloudinary/asset-management-mcp",
+    "speakeasy-sdk/mcp-typescript 0.10.0 2.918.4 0.7.4 @cloudinary/asset-management-mcp",
 } as const;

package/src/lib/encodings.ts

@@ -4,7 +4,7 @@
  */
 
 import { bytesToBase64 } from "./base64.js";
-import { isPlainObject } from "./is-plain-object.js";
+import { isPlainObject } from "./primitives.js";
 
 export class EncodingError extends Error {
   constructor(message: string) {

package/src/lib/env.ts

@@ -3,8 +3,6 @@
  * @generated-id: c52972a3b198
  */
 
-import { dlv } from "./dlv.js";
-
 import * as z from "zod";
 import { SDKOptions } from "./config.js";
 
@@ -40,8 +38,13 @@ export function env(): Env {
     return envMemo;
   }
 
+  const globals = globalThis as {
+    process?: { env?: Record<string, string | undefined> };
+    Deno?: { env?: { toObject?: () => Record<string, string | undefined> } };
+  };
+
   envMemo = envSchema.parse(
-    dlv(globalThis, "process.env") ?? dlv(globalThis, "Deno.env") ?? {},
+    globals.process?.env ?? globals.Deno?.env?.toObject?.() ?? {},
   );
   return envMemo;
 }

package/src/lib/http.ts

@@ -46,8 +46,10 @@ export class HTTPClient {
   private requestHooks: BeforeRequestHook[] = [];
   private requestErrorHooks: RequestErrorHook[] = [];
   private responseHooks: ResponseHook[] = [];
+  private options: HTTPClientOptions;
 
-  constructor(private options: HTTPClientOptions = {}) {
+  constructor(options: HTTPClientOptions = {}) {
+    this.options = options;
     this.fetcher = options.fetcher || DEFAULT_FETCHER;
   }
 

package/src/lib/primitives.ts

@@ -112,3 +112,19 @@ export function invariant(
     throw new InvariantError(message);
   }
 }
+
+export function isPlainObject(
+  value: unknown,
+): value is Record<string, unknown> {
+  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;
+  // cross-realm plain objects (vm contexts, iframes) inherit from a
+  // different realm's Object.prototype, which itself has a null prototype
+  try {
+    return Object.getPrototypeOf(proto) === null;
+  } catch {
+    return false;
+  }
+}

package/src/lib/retries.ts

@@ -195,6 +195,14 @@ async function retryBackoff(
 }
 
 function retryIntervalFromResponse(res: Response): number {
+  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;

package/src/lib/security.ts

@@ -14,17 +14,22 @@ type OAuth2PasswordFlow = {
   tokenURL: string;
 };
 
-export enum SecurityErrorCode {
-  Incomplete = "incomplete",
-  UnrecognisedSecurityType = "unrecognized_security_type",
-}
+export const SecurityErrorCode = {
+  Incomplete: "incomplete",
+  UnrecognisedSecurityType: "unrecognized_security_type",
+} as const;
+export type SecurityErrorCode =
+  (typeof SecurityErrorCode)[keyof typeof SecurityErrorCode];
 
 export class SecurityError extends Error {
+  public code: SecurityErrorCode;
+
   constructor(
-    public code: SecurityErrorCode,
+    code: SecurityErrorCode,
     message: string,
   ) {
     super(message);
+    this.code = code;
     this.name = "SecurityError";
   }
 

package/src/mcp-server/apps/app-shared.ts

@@ -116,7 +116,7 @@ export const SHARED_CSS_TOKENS = /* css */ `
 [data-theme="dark"] .status-warn, .dark .status-warn { background: #854d0e; color: #fef08a; }
 [data-theme="dark"] .status-err,  .dark .status-err  { background: #991b1b; color: #fecaca; }
 
-html { overflow: hidden; }
+html { scrollbar-gutter: auto; }
 body {
   font-family: var(--cld-font);
   background: var(--cld-bg);
@@ -125,6 +125,7 @@ body {
   line-height: 1.5;
   font-size: var(--cld-font-xs);
   position: relative;
+  overflow-x: hidden;
 }
 .theme-btn {
   width: 22px; height: 22px; border-radius: 50%;
@@ -163,9 +164,11 @@ export const SHARED_CSS_COMPONENTS = /* css */ `
 .link { cursor: pointer; }
 .link:hover { color: var(--cld-accent); text-decoration: underline; }
 
-/* Modal */
+/* Modal — positioned absolutely so it can be placed in the part of the
+ * iframe that is currently visible in the host's viewport (since position:fixed
+ * inside a tall iframe anchors to iframe-center, not the user's visible area). */
 .modal-overlay {
-  position: fixed; inset: 0;
+  position: absolute; left: 0; right: 0;
   background: rgba(0,0,0,0.45);
   display: flex; align-items: center; justify-content: center;
   z-index: 1000; backdrop-filter: blur(3px); padding: 24px;
@@ -1013,6 +1016,55 @@ function closeModal() {
   if (ov) ov.remove();
 }
 
+/* Position the modal overlay so it's centered on the part of the iframe
+ * the user is currently looking at. Inside an iframe that the host has
+ * sized to scrollHeight, position: fixed anchors to iframe-center, not
+ * the user's visible band — so we compute the visible band ourselves
+ * via IntersectionObserver and place the overlay absolutely there. */
+function positionModalInVisibleArea(overlay) {
+  if (!overlay) return;
+  var docH = Math.max(document.documentElement.scrollHeight, window.innerHeight);
+
+  // Try IntersectionObserver first (works cross-origin too)
+  if (typeof IntersectionObserver !== "undefined") {
+    var probe = document.createElement("div");
+    probe.style.cssText = "position:absolute;left:0;top:0;width:1px;height:" + docH + "px;pointer-events:none;visibility:hidden;";
+    document.body.appendChild(probe);
+    var io = new IntersectionObserver(function(entries) {
+      try {
+        var entry = entries[0];
+        var rect = entry.intersectionRect;
+        var rootRect = entry.rootBounds || entry.boundingClientRect;
+        // intersectionRect.top is in viewport coords; visible band of the
+        // document is from (probe.top + rect.top) to (probe.top + rect.bottom).
+        var probeTop = entry.boundingClientRect.top; // viewport-relative
+        var visibleTop = rect.top - probeTop;        // document-relative
+        var visibleHeight = rect.height;
+        if (visibleHeight > 0) {
+          overlay.style.top = visibleTop + "px";
+          overlay.style.height = visibleHeight + "px";
+        } else {
+          // Fallback: probe not intersecting (shouldn't happen with full-height probe)
+          overlay.style.top = (window.scrollY || 0) + "px";
+          overlay.style.height = window.innerHeight + "px";
+        }
+      } finally {
+        io.disconnect();
+        if (probe.parentNode) probe.parentNode.removeChild(probe);
+      }
+    });
+    io.observe(probe);
+    return;
+  }
+
+  // Fallback: same-origin only — read iframe's bounding rect
+  var rect = document.documentElement.getBoundingClientRect();
+  var visibleTop = rect.top < 0 ? -rect.top : 0;
+  var visibleHeight = Math.min(window.innerHeight, rect.bottom) - Math.max(0, rect.top);
+  overlay.style.top = visibleTop + "px";
+  overlay.style.height = Math.max(visibleHeight, 200) + "px";
+}
+
 function openModal(headerHtml, bodyHtml) {
   closeModal();
   var h = '<div class="modal-overlay"><div class="modal">';
@@ -1022,6 +1074,7 @@ function openModal(headerHtml, bodyHtml) {
   document.body.insertAdjacentHTML("beforeend", h);
 
   var overlay = document.querySelector(".modal-overlay");
+  positionModalInVisibleArea(overlay);
   overlay.addEventListener("click", function(e) {
     if (e.target === overlay || e.target.classList.contains("modal-close")) {
       closeModal();

package/src/mcp-server/apps/asset-gallery-app.ts

@@ -168,17 +168,27 @@ const GALLERY_CSS = /* css */ `
 }
 
 /* ── Multi-select bar ── */
+/* Wrapper takes layout space ONLY when a selection is active. When idle
+ * it's display:none so it contributes 0 to scrollHeight (no phantom
+ * scrollbar gutter / no extra iframe height). */
+.select-bar-wrap {
+  display: none;
+  position: sticky; bottom: 0; left: 0; right: 0;
+  justify-content: center; pointer-events: none;
+  z-index: 100; height: 64px;
+}
+.select-bar-wrap.visible { display: flex; }
 .select-bar {
-  position: fixed; bottom: 16px; left: 50%;
-  transform: translateX(-50%) translateY(80px);
+  position: absolute; bottom: 8px;
+  transform: translateY(80px);
   background: #1a1d24; color: white; border-radius: 40px;
   padding: 0 6px 0 16px; height: 48px;
   display: flex; align-items: center; gap: 4px;
   box-shadow: 0 8px 32px rgba(0,0,0,0.4);
   transition: transform 0.25s cubic-bezier(0.34, 1.56, 0.64, 1), opacity 0.2s;
-  opacity: 0; pointer-events: none; z-index: 100; white-space: nowrap;
+  opacity: 0; pointer-events: none; white-space: nowrap;
 }
-.select-bar.visible { transform: translateX(-50%) translateY(0); opacity: 1; pointer-events: all; }
+.select-bar-wrap.visible .select-bar { transform: translateY(0); opacity: 1; pointer-events: all; }
 .select-count { font-size: 13px; font-weight: 600; margin-right: 8px; }
 .bar-btn {
   height: 36px; padding: 0 14px; border: none; border-radius: 30px;
@@ -243,12 +253,12 @@ function showToast(msg) {
 }
 
 function updateSelectBar() {
-  var bar = document.getElementById("select-bar");
+  var wrap = document.getElementById("select-bar-wrap");
   var countEl = document.getElementById("select-count");
-  if (!bar || !countEl) return;
+  if (!wrap || !countEl) return;
   var n = selected.size;
   countEl.textContent = n + " selected";
-  bar.classList.toggle("visible", n > 0);
+  wrap.classList.toggle("visible", n > 0);
   var btn = document.getElementById("select-all-btn");
   if (btn) {
     var visible = getVisibleIndices();
@@ -528,7 +538,8 @@ function render() {
     h += "</div>";
   }
 
-  // Multi-select bar
+  // Multi-select bar (sticky, in-flow wrapper so iframe sizing stays truthful)
+  h += '<div class="select-bar-wrap" id="select-bar-wrap">';
   h += '<div class="select-bar" id="select-bar">';
   h += '<span class="select-count" id="select-count">0 selected</span>';
   h += '<div class="bar-divider"></div>';
@@ -538,6 +549,7 @@ function render() {
   h += '<div class="bar-divider"></div>';
   h += '<button class="bar-btn bar-ghost" id="bar-clear">' + IC.x + '</button>';
   h += '</div>';
+  h += '</div>';
 
   // Toast
   h += '<div class="gallery-toast" id="gallery-toast"></div>';
@@ -767,6 +779,9 @@ async function fetchDirect() {
   console.log(LOG_PREFIX, "fetchDirect ->", name);
 
   document.getElementById("app").innerHTML = '<div class="status">Fetching assets\\u2026</div>';
+  requestAnimationFrame(function() {
+    app.reportSize(Math.max(document.documentElement.scrollHeight, MIN_HEIGHT));
+  });
   try {
     var res = await app.callServerTool({ name: name, arguments: args });
     var data = ingestResult(res);
@@ -818,6 +833,7 @@ async function loadMore() {
 function refreshGallery() {
   allResources = [];
   lastCursor = null;
+  selected.clear();
   fetchDirect();
 }
 

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

@@ -22,7 +22,7 @@ const routes = buildRouteMap({
 export const app = buildApplication(routes, {
   name: "mcp",
   versionInfo: {
-    currentVersion: "0.9.2",
+    currentVersion: "0.10.0",
   },
 });
 

package/src/mcp-server/server.ts

@@ -38,8 +38,11 @@ import { tool$foldersCreateFolder } from "./tools/foldersCreateFolder.js";
 import { tool$foldersDestroyFolder } from "./tools/foldersDestroyFolder.js";
 import { tool$foldersSearchFolders } from "./tools/foldersSearchFolders.js";
 import { tool$foldersUpdateFolder } from "./tools/foldersUpdateFolder.js";
+import { tool$generationGenerateImage } from "./tools/generationGenerateImage.js";
+import { tool$generationGenerateImageFromImages } from "./tools/generationGenerateImageFromImages.js";
 import { tool$searchSearchAssets } from "./tools/searchSearchAssets.js";
 import { tool$searchVisualSearchAssets } from "./tools/searchVisualSearchAssets.js";
+import { tool$tasksGetGenerationTaskStatus } from "./tools/tasksGetGenerationTaskStatus.js";
 import { tool$uploadUpload } from "./tools/uploadUpload.js";
 import { tool$usageGetUsage } from "./tools/usageGetUsage.js";
 
@@ -60,7 +63,7 @@ export function createMCPServer(deps: {
 }) {
   const server = new McpServer({
     name: "CloudinaryAssetMgmt",
-    version: "0.9.2",
+    version: "0.10.0",
   });
 
   const getClient = deps.getSDK || (() =>
@@ -130,6 +133,9 @@ export 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);

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

@@ -4,11 +4,11 @@
  */
 
 import { assetsDestroyByAssetId } from "../../funcs/assetsDestroyByAssetId.js";
-import { ComponentsDestroyRequest$zodSchema } from "../../models/componentsdestroyrequest.js";
+import { DestroyByAssetIdRequest$zodSchema } from "../../models/destroybyassetidrequest.js";
 import { formatResult, ToolDefinition } from "../tools.js";
 
 const args = {
-  request: ComponentsDestroyRequest$zodSchema.describe(
+  request: DestroyByAssetIdRequest$zodSchema.describe(
     `The asset to delete and related options.`,
   ),
 };

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

@@ -0,0 +1,52 @@
+/*
+ * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+ * @generated-id: 358095938b5f
+ */
+
+import { generationGenerateImage } from "../../funcs/generationGenerateImage.js";
+import { GenerateImageRequest$zodSchema } from "../../models/generateimagerequest.js";
+import { formatResult, ToolDefinition } from "../tools.js";
+
+const args = {
+  request: GenerateImageRequest$zodSchema.describe(
+    `A JSON object containing the generation request parameters.`,
+  ),
+};
+
+export const tool$generationGenerateImage: ToolDefinition<typeof args> = {
+  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,
+  tool: async (client, args, ctx) => {
+    const [result] = await generationGenerateImage(
+      client,
+      args.request,
+      { fetchOptions: { signal: ctx.signal } },
+    ).$inspect();
+
+    if (!result.ok) {
+      return {
+        content: [{ type: "text", text: result.error.message }],
+        isError: true,
+      };
+    }
+
+    return formatResult(result.value);
+  },
+};