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

package/esm/mcp-server/widgets/widget-shared.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"widget-shared.js","sourceRoot":"","sources":["../../../src/mcp-server/widgets/widget-shared.ts"],"names":[],"mappings":"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"}

package/esm/models/fieldsspec.d.ts

@@ -35,13 +35,13 @@ export declare const FieldsSpec$zodSchema: z.ZodEnum<{
     metadata: "metadata";
     format: "format";
     status: "status";
+    bytes: "bytes";
     context: "context";
     resource_type: "resource_type";
     version_id: "version_id";
     signature: "signature";
     width: "width";
     height: "height";
-    bytes: "bytes";
     secure_url: "secure_url";
     version: "version";
     created_at: "created_at";

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@cloudinary/asset-management-mcp",
-  "version": "0.8.1",
+  "version": "0.9.0-rc.0",
   "mcpName": "io.github.cloudinary/asset-management-mcp",
   "author": "Cloudinary",
   "type": "module",

package/src/landing-page.ts

@@ -933,7 +933,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.8.1/mcp-server.mcpb" download="mcp-server.mcpb" class="action-button header-action" style="display: inline-flex; margin-bottom: 16px;">
+          <a href="https://github.com/cloudinary/asset-management-mcp/releases/download/v0.9.0-rc.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

@@ -113,8 +113,8 @@ export function serverURLFromOptions(options: SDKOptions): URL | null {
 export const SDK_METADATA = {
   language: "typescript",
   openapiDocVersion: "0.4.0",
-  sdkVersion: "0.8.1",
-  genVersion: "2.869.10",
+  sdkVersion: "0.9.0-rc.0",
+  genVersion: "2.879.11",
   userAgent:
-    "speakeasy-sdk/mcp-typescript 0.8.1 2.869.10 0.4.0 @cloudinary/asset-management-mcp",
+    "speakeasy-sdk/mcp-typescript 0.9.0-rc.0 2.879.11 0.4.0 @cloudinary/asset-management-mcp",
 } as const;

package/src/lib/encodings.ts

@@ -475,6 +475,23 @@ export const encodeSpaceDelimitedQuery = queryEncoder(encodeSpaceDelimited);
 export const encodePipeDelimitedQuery = queryEncoder(encodePipeDelimited);
 export const encodeDeepObjectQuery = queryEncoder(encodeDeepObject);
 
+function isBlobLike(val: unknown): val is Blob {
+  if (val instanceof Blob) {
+    return true;
+  }
+
+  if (typeof val !== "object" || val == null || !(Symbol.toStringTag in val)) {
+    return false;
+  }
+
+  const tag = val[Symbol.toStringTag];
+  if (tag !== "Blob" && tag !== "File") {
+    return false;
+  }
+
+  return "stream" in val && typeof val.stream === "function";
+}
+
 export function appendForm(
   fd: FormData,
   key: string,
@@ -483,11 +500,22 @@ export function appendForm(
 ): void {
   if (value == null) {
     return;
-  } else if (value instanceof Blob && fileName) {
-    fd.append(key, value, fileName);
-  } else if (value instanceof Blob) {
-    fd.append(key, value);
+  } else if (isBlobLike(value)) {
+    if (fileName) {
+      fd.append(key, value as Blob, fileName);
+    } else {
+      fd.append(key, value as Blob);
+    }
   } else {
     fd.append(key, String(value));
   }
 }
+
+export async function normalizeBlob(
+  value: Pick<Blob, "arrayBuffer" | "type">,
+): Promise<Blob> {
+  if (value instanceof Blob) {
+    return value;
+  }
+  return new Blob([await value.arrayBuffer()], { type: value.type });
+}

package/src/lib/security.ts

@@ -241,8 +241,9 @@ function applyBearer(
 }
 export function resolveGlobalSecurity(
   security: Partial<Security> | null | undefined,
+  allowedFields?: number[],
 ): SecurityState | null {
-  return resolveSecurity(
+  let inputs: SecurityInput[][] = [
     [
       {
         type: "http:custom",
@@ -261,7 +262,18 @@ export function resolveGlobalSecurity(
         value: security?.oauth2 || env().CLOUDINARY_OAUTH2,
       },
     ],
-  );
+  ];
+
+  if (allowedFields) {
+    inputs = allowedFields.map((i) => {
+      if (i < 0 || i >= inputs.length) {
+        throw new RangeError(`invalid allowedFields index ${i}`);
+      }
+      return inputs[i]!;
+    });
+  }
+
+  return resolveSecurity(...inputs);
 }
 
 export async function extractSecurity<

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

@@ -22,7 +22,7 @@ const routes = buildRouteMap({
 export const app = buildApplication(routes, {
   name: "mcp",
   versionInfo: {
-    currentVersion: "0.8.1",
+    currentVersion: "0.9.0-rc.0",
   },
 });
 

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

@@ -7,6 +7,19 @@ import { Register } from "./extensions.js";
 import { formatResult } from "./tools.js";
 import { assetsExplicitAsset } from "../funcs/assetsExplicitAsset.js";
 import { ResourceType$zodSchema } from "../models/resourcetype.js";
+import {
+  ASSET_GALLERY_RESOURCE_URI,
+  MCP_APP_MIME_TYPE,
+  getAssetGalleryHtml,
+} from "./widgets/asset-gallery-widget.js";
+import {
+  ASSET_DETAILS_RESOURCE_URI,
+  getAssetDetailsHtml,
+} from "./widgets/asset-details-widget.js";
+import {
+  ASSET_UPLOAD_RESOURCE_URI,
+  getAssetUploadHtml,
+} from "./widgets/asset-upload-widget.js";
 
 const TX_RULES_URL = "https://cloudinary.com/documentation/cloudinary_transformation_rules.md";
 
@@ -55,6 +68,90 @@ export function registerMCPExtensions(register: Register): void {
     }
   });
 
+  // Asset gallery MCP App — interactive UI for list-images results
+  register.resource({
+    name: "Asset Gallery Widget",
+    description: "Interactive asset gallery for browsing Cloudinary images",
+    metadata: {
+      mimeType: MCP_APP_MIME_TYPE,
+    },
+    resource: ASSET_GALLERY_RESOURCE_URI,
+    scopes: [],
+    read: async (_client, _uri, _extra) => ({
+      contents: [{
+        uri: ASSET_GALLERY_RESOURCE_URI,
+        mimeType: MCP_APP_MIME_TYPE,
+        text: getAssetGalleryHtml(),
+        _meta: {
+          ui: {
+            csp: {
+              resourceDomains: [
+                "https://res.cloudinary.com",
+                "https://*.cloudinary.com",
+              ],
+            },
+          },
+        },
+      } as any],
+    }),
+  });
+
+  // Asset details MCP App — interactive UI for get-asset-details results
+  register.resource({
+    name: "Asset Details Widget",
+    description: "Interactive single-asset detail view for Cloudinary assets",
+    metadata: {
+      mimeType: MCP_APP_MIME_TYPE,
+    },
+    resource: ASSET_DETAILS_RESOURCE_URI,
+    scopes: [],
+    read: async (_client, _uri, _extra) => ({
+      contents: [{
+        uri: ASSET_DETAILS_RESOURCE_URI,
+        mimeType: MCP_APP_MIME_TYPE,
+        text: getAssetDetailsHtml(),
+        _meta: {
+          ui: {
+            csp: {
+              resourceDomains: [
+                "https://res.cloudinary.com",
+                "https://*.cloudinary.com",
+              ],
+            },
+          },
+        },
+      } as any],
+    }),
+  });
+
+  // Asset upload MCP App — interactive upload UI for upload-asset tool
+  register.resource({
+    name: "Asset Upload Widget",
+    description: "Interactive upload interface for uploading assets to Cloudinary",
+    metadata: {
+      mimeType: MCP_APP_MIME_TYPE,
+    },
+    resource: ASSET_UPLOAD_RESOURCE_URI,
+    scopes: [],
+    read: async (_client, _uri, _extra) => ({
+      contents: [{
+        uri: ASSET_UPLOAD_RESOURCE_URI,
+        mimeType: MCP_APP_MIME_TYPE,
+        text: getAssetUploadHtml(),
+        _meta: {
+          ui: {
+            csp: {
+              resourceDomains: [
+                "https://res.cloudinary.com",
+                "https://*.cloudinary.com",
+              ],
+            },
+          },
+        },
+      } as any],
+    }),
+  });
+
   // Transform asset tool using explicit API with eager transformations
   register.tool({
     name: "transform-asset",

package/src/mcp-server/server.ts

@@ -58,7 +58,7 @@ export function createMCPServer(deps: {
 }) {
   const server = new McpServer({
     name: "CloudinaryAssetMgmt",
-    version: "0.8.1",
+    version: "0.9.0-rc.0",
   });
 
   const getClient = deps.getSDK || (() =>

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

@@ -6,6 +6,7 @@
 import * as z from "zod";
 import { assetsGetResourceByAssetId } from "../../funcs/assetsGetResourceByAssetId.js";
 import { formatResult, ToolDefinition } from "../tools.js";
+import { ASSET_DETAILS_RESOURCE_URI } from "../widgets/asset-details-widget.js";
 
 const args = {
   asset_id: z.string().describe(
@@ -59,6 +60,9 @@ Returns the details of a single resource specified by its asset ID.`,
     "openWorldHint": false,
     "readOnlyHint": true,
   },
+  _meta: {
+    ui: { resourceUri: ASSET_DETAILS_RESOURCE_URI },
+  },
   args,
   tool: async (client, args, ctx) => {
     const [result] = await assetsGetResourceByAssetId(

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

@@ -8,6 +8,7 @@ import { assetsListImages } from "../../funcs/assetsListImages.js";
 import { Direction$zodSchema } from "../../models/direction.js";
 import { FieldsSpec$zodSchema } from "../../models/fieldsspec.js";
 import { ListStorageType$zodSchema } from "../../models/liststoragetype.js";
+import { ASSET_GALLERY_RESOURCE_URI } from "../widgets/asset-gallery-widget.js";
 import { formatResult, ToolDefinition } from "../tools.js";
 
 const args = {
@@ -46,6 +47,9 @@ Retrieves a list of image assets. Results can be filtered by various criteria li
     "openWorldHint": false,
     "readOnlyHint": true,
   },
+  _meta: {
+    ui: { resourceUri: ASSET_GALLERY_RESOURCE_URI },
+  },
   args,
   tool: async (client, args, ctx) => {
     const [result] = await assetsListImages(

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

@@ -9,6 +9,7 @@ import { Direction$zodSchema } from "../../models/direction.js";
 import { FieldsSpec$zodSchema } from "../../models/fieldsspec.js";
 import { ListStorageType$zodSchema } from "../../models/liststoragetype.js";
 import { formatResult, ToolDefinition } from "../tools.js";
+import { ASSET_GALLERY_RESOURCE_URI } from "../widgets/asset-gallery-widget.js";
 
 const args = {
   type: ListStorageType$zodSchema.optional().describe(
@@ -46,6 +47,9 @@ Retrieves a list of raw assets. Results can be filtered by various criteria like
     "openWorldHint": false,
     "readOnlyHint": true,
   },
+  _meta: {
+    ui: { resourceUri: ASSET_GALLERY_RESOURCE_URI },
+  },
   args,
   tool: async (client, args, ctx) => {
     const [result] = await assetsListRawFiles(

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

@@ -9,6 +9,7 @@ import { Direction$zodSchema } from "../../models/direction.js";
 import { FieldsSpec$zodSchema } from "../../models/fieldsspec.js";
 import { ListStorageType$zodSchema } from "../../models/liststoragetype.js";
 import { formatResult, ToolDefinition } from "../tools.js";
+import { ASSET_GALLERY_RESOURCE_URI } from "../widgets/asset-gallery-widget.js";
 
 const args = {
   type: ListStorageType$zodSchema.optional().describe(
@@ -46,6 +47,9 @@ Retrieves a list of video assets. Results can be filtered by various criteria li
     "openWorldHint": false,
     "readOnlyHint": true,
   },
+  _meta: {
+    ui: { resourceUri: ASSET_GALLERY_RESOURCE_URI },
+  },
   args,
   tool: async (client, args, ctx) => {
     const [result] = await assetsListVideos(

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

@@ -6,6 +6,7 @@
 import { searchSearchAssets } from "../../funcs/searchSearchAssets.js";
 import { SearchParameters$zodSchema } from "../../models/searchparameters.js";
 import { formatResult, ToolDefinition } from "../tools.js";
+import { ASSET_GALLERY_RESOURCE_URI } from "../widgets/asset-gallery-widget.js";
 
 const args = {
   request: SearchParameters$zodSchema,
@@ -30,6 +31,9 @@ Examples: tags:shirt AND uploaded_at>1d, resource_type:image AND bytes>1mb, fold
     "openWorldHint": false,
     "readOnlyHint": true,
   },
+  _meta: {
+    ui: { resourceUri: ASSET_GALLERY_RESOURCE_URI },
+  },
   args,
   tool: async (client, args, ctx) => {
     const [result] = await searchSearchAssets(

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

@@ -6,6 +6,7 @@
 import { uploadUpload } from "../../funcs/uploadUpload.js";
 import { UploadRequest$zodSchema } from "../../models/uploadrequest.js";
 import { UploadResourceType$zodSchema } from "../../models/uploadresourcetype.js";
+import { ASSET_UPLOAD_RESOURCE_URI } from "../widgets/asset-upload-widget.js";
 import { formatResult, ToolDefinition } from "../tools.js";
 
 const args = {
@@ -48,6 +49,9 @@ Transform media files using transformation syntax in delivery URLs, which create
     "openWorldHint": false,
     "readOnlyHint": false,
   },
+  _meta: {
+    ui: { resourceUri: ASSET_UPLOAD_RESOURCE_URI },
+  },
   args,
   tool: async (client, args, ctx) => {
     const [result] = await uploadUpload(

package/src/mcp-server/tools.ts

@@ -80,6 +80,7 @@ export type ToolDefinition<
       openWorldHint: boolean;
       readOnlyHint: boolean;
     };
+    _meta?: Record<string, unknown>;
     tool: (
       client: CloudinaryAssetMgmtCore,
       args: ShapeOutput<Args>,
@@ -98,6 +99,7 @@ export type ToolDefinition<
       openWorldHint: boolean;
       readOnlyHint: boolean;
     };
+    _meta?: Record<string, unknown>;
     tool: (
       client: CloudinaryAssetMgmtCore,
       extra: RequestHandlerExtra<ServerRequest, ServerNotification>,
@@ -212,6 +214,7 @@ export function createRegisterTool(
           description: tool.description,
           inputSchema: tool.args,
           annotations: tool.annotations,
+          ...(tool._meta ? { _meta: tool._meta } : {}),
         },
         async (args, ctx) => {
           return tool.tool(getSDK(), args, ctx);
@@ -223,6 +226,7 @@ export function createRegisterTool(
         {
           description: tool.description,
           annotations: tool.annotations,
+          ...(tool._meta ? { _meta: tool._meta } : {}),
         },
         async (ctx) => {
           return tool.tool(getSDK(), ctx);