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

package/src/funcs/foldersUpdateFolder.ts

@@ -1,5 +1,6 @@
 /*
  * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+ * @generated-id: 5ed2a131d9e7
  */
 
 import { CloudinaryAssetMgmtCore } from "../core.js";

package/src/funcs/moderationsListResourcesByModerationKindAndStatus.ts

@@ -1,5 +1,6 @@
 /*
  * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+ * @generated-id: fc11d4aeec08
  */
 
 import { CloudinaryAssetMgmtCore } from "../core.js";

package/src/funcs/peopleGetPerson.ts

@@ -1,5 +1,6 @@
 /*
  * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+ * @generated-id: 777bbc414998
  */
 
 import { CloudinaryAssetMgmtCore } from "../core.js";

package/src/funcs/peopleListPeople.ts

@@ -1,5 +1,6 @@
 /*
  * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+ * @generated-id: fee825c99595
  */
 
 import { CloudinaryAssetMgmtCore } from "../core.js";

package/src/funcs/peopleUpdatePerson.ts

@@ -1,5 +1,6 @@
 /*
  * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+ * @generated-id: 89ec35a63e7d
  */
 
 import { CloudinaryAssetMgmtCore } from "../core.js";

package/src/funcs/searchSearchAssets.ts

@@ -1,5 +1,6 @@
 /*
  * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+ * @generated-id: 7e457683073d
  */
 
 import { CloudinaryAssetMgmtCore } from "../core.js";

package/src/funcs/searchVisualSearchAssets.ts

@@ -1,5 +1,6 @@
 /*
  * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+ * @generated-id: a8db6463f05c
  */
 
 import { CloudinaryAssetMgmtCore } from "../core.js";

package/src/funcs/tagsListResourceTags.ts

@@ -1,5 +1,6 @@
 /*
  * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+ * @generated-id: ca80b95607e2
  */
 
 import { CloudinaryAssetMgmtCore } from "../core.js";

package/src/funcs/uploadDestroyAsset.ts

@@ -1,5 +1,6 @@
 /*
  * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+ * @generated-id: 84ce6bcc285b
  */
 
 import { CloudinaryAssetMgmtCore } from "../core.js";

package/src/funcs/uploadText.ts

@@ -1,5 +1,6 @@
 /*
  * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+ * @generated-id: d712aff8698e
  */
 
 import { CloudinaryAssetMgmtCore } from "../core.js";

package/src/funcs/uploadUpload.ts

@@ -1,5 +1,6 @@
 /*
  * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+ * @generated-id: 4ff8dcd540f6
  */
 
 import { CloudinaryAssetMgmtCore } from "../core.js";

package/src/funcs/uploadUploadChunk.ts

@@ -1,5 +1,6 @@
 /*
  * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+ * @generated-id: 20463a25bf82
  */
 
 import { CloudinaryAssetMgmtCore } from "../core.js";

package/src/funcs/uploadUploadNoResourceType.ts

@@ -1,5 +1,6 @@
 /*
  * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+ * @generated-id: b68b4dbee6f8
  */
 
 import { CloudinaryAssetMgmtCore } from "../core.js";

package/src/funcs/usageGetUsage.ts

@@ -1,5 +1,6 @@
 /*
  * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+ * @generated-id: 1d18d38782a2
  */
 
 import { CloudinaryAssetMgmtCore } from "../core.js";

package/src/funcs/videoAnalyticsGetVideoViews.ts

@@ -1,5 +1,6 @@
 /*
  * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+ * @generated-id: 646049fa8bae
  */
 
 import { CloudinaryAssetMgmtCore } from "../core.js";

package/src/hooks/hooks.ts

@@ -1,5 +1,6 @@
 /*
  * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+ * @generated-id: a2463fc6f69b
  */
 
 import { initHooks } from "./registration.js";

package/src/hooks/oauth2scopes.ts

@@ -1,5 +1,6 @@
 /*
  * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+ * @generated-id: a709b8ce2ddb
  */
 
 /**

package/src/hooks/types.ts

@@ -1,5 +1,6 @@
 /*
  * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+ * @generated-id: 2a02d86ec24f
  */
 
 import { SDKOptions } from "../lib/config.js";

package/src/landing-page.ts

@@ -1,5 +1,6 @@
 /*
  * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+ * @generated-id: ef64a6ee46d7
  */
 
 import {
@@ -932,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.0/mcp-server.mcpb" download="mcp-server.mcpb" class="action-button header-action" style="display: inline-flex; margin-bottom: 16px;">
+          <a href="https://github.com/cloudinary/asset-management-mcp/releases/download/v0.9.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/base64.ts

@@ -1,5 +1,6 @@
 /*
  * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+ * @generated-id: 598522066688
  */
 
 import * as z from "zod";

package/src/lib/config.ts

@@ -1,5 +1,6 @@
 /*
  * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+ * @generated-id: 320761608fb3
  */
 
 import * as z from "zod";
@@ -112,8 +113,8 @@ export function serverURLFromOptions(options: SDKOptions): URL | null {
 export const SDK_METADATA = {
   language: "typescript",
   openapiDocVersion: "0.4.0",
-  sdkVersion: "0.8.0",
-  genVersion: "2.865.2",
+  sdkVersion: "0.9.0-rc.0",
+  genVersion: "2.879.11",
   userAgent:
-    "speakeasy-sdk/mcp-typescript 0.8.0 2.865.2 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/dlv.ts

@@ -1,5 +1,6 @@
 /*
  * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+ * @generated-id: b1988214835a
  */
 
 /*

package/src/lib/encodings.ts

@@ -1,5 +1,6 @@
 /*
  * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+ * @generated-id: 3bd8ead98afd
  */
 
 import { bytesToBase64 } from "./base64.js";
@@ -474,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,
@@ -482,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/env.ts

@@ -1,5 +1,6 @@
 /*
  * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+ * @generated-id: c52972a3b198
  */
 
 import { dlv } from "./dlv.js";

package/src/lib/files.ts

@@ -1,5 +1,6 @@
 /*
  * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+ * @generated-id: e5efa54fcb95
  */
 
 /**
@@ -80,3 +81,25 @@ export function getContentTypeFromFileName(fileName: string): string | null {
 
   return mimeTypes[ext] || null;
 }
+
+/**
+ * Creates a Blob from file content with the given MIME type.
+ *
+ * Node.js Buffers are Uint8Array subclasses that may share a pooled
+ * ArrayBuffer (byteOffset > 0, byteLength < buffer.byteLength). Passing
+ * such a Buffer directly to `new Blob([buf])` can include the entire
+ * underlying pool on some runtimes, producing a Blob with extra bytes
+ * that corrupts multipart uploads.
+ *
+ * Copying into a standalone Uint8Array ensures the Blob receives only the
+ * intended bytes regardless of runtime behaviour.
+ */
+export function bytesToBlob(
+  content: Uint8Array<ArrayBufferLike> | ArrayBuffer | Blob | string,
+  contentType: string,
+): Blob {
+  if (content instanceof Uint8Array) {
+    return new Blob([new Uint8Array(content)], { type: contentType });
+  }
+  return new Blob([content as BlobPart], { type: contentType });
+}

package/src/lib/http.ts

@@ -1,5 +1,6 @@
 /*
  * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+ * @generated-id: 63a80782d37e
  */
 
 export type Fetcher = (

package/src/lib/is-plain-object.ts

@@ -1,5 +1,6 @@
 /*
  * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+ * @generated-id: b9862591096a
  */
 
 /*

package/src/lib/logger.ts

@@ -1,5 +1,6 @@
 /*
  * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+ * @generated-id: 7ee7741a02bf
  */
 
 export interface Logger {

package/src/lib/primitives.ts

@@ -1,5 +1,6 @@
 /*
  * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+ * @generated-id: 74859f750b28
  */
 
 class InvariantError extends Error {

package/src/lib/result.ts

@@ -1,5 +1,6 @@
 /*
  * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+ * @generated-id: ab7a4c1c4c71
  */
 
 /**

package/src/lib/retries.ts

@@ -1,5 +1,6 @@
 /*
  * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+ * @generated-id: b24a69d15639
  */
 
 import { isConnectionError, isTimeoutError } from "./http.js";

package/src/lib/schemas.ts

@@ -1,5 +1,6 @@
 /*
  * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+ * @generated-id: deb4b531fae1
  */
 
 import * as z from "zod";

package/src/lib/sdks.ts

@@ -1,5 +1,6 @@
 /*
  * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+ * @generated-id: 8a6d91f1218d
  */
 
 import { SDKHooks } from "../hooks/hooks.js";

package/src/lib/security.ts

@@ -1,5 +1,6 @@
 /*
  * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+ * @generated-id: 0502afa7922e
  */
 
 import { Security } from "../models/security.js";
@@ -240,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",
@@ -260,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/lib/url.ts

@@ -1,5 +1,6 @@
 /*
  * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+ * @generated-id: b0057e24ed76
  */
 
 const hasOwn = Object.prototype.hasOwnProperty;

package/src/mcp-server/cli/serve/command.ts

@@ -1,5 +1,6 @@
 /*
  * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+ * @generated-id: 7cd4394c80e8
  */
 
 import { buildCommand } from "@stricli/core";
@@ -45,6 +46,13 @@ export const serveCommand = buildCommand({
         values: ["dynamic"],
         optional: true,
       },
+      "tool-annotations": {
+        kind: "parsed",
+        brief:
+          "Filter tools by annotations (comma-separated: readOnly, destructive, idempotent, openWorld). Listed = required true, unlisted = required false.",
+        optional: true,
+        parse: (value) => value.split(",").map(s => s.trim()),
+      },
       scope: {
         kind: "enum",
         brief: "Mount tools/resources that match given scope (repeatable flag)",

package/src/mcp-server/cli/serve/impl.ts

@@ -1,5 +1,6 @@
 /*
  * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+ * @generated-id: 03e83f226068
  */
 
 import { StreamableHTTPServerTransport } from "@modelcontextprotocol/sdk/server/streamableHttp.js";
@@ -12,6 +13,7 @@ import {
 } from "../../console-logger.js";
 import { MCPServerFlags } from "../../flags.js";
 import { createMCPServer } from "../../server.js";
+import { buildAnnotationFilter } from "../../tools.js";
 import { buildSDK } from "../../tools.js";
 
 import { landingPageExpress } from "../../../landing-page.js";
@@ -65,6 +67,7 @@ async function startStreamableHTTP(cliFlags: ServeCommandFlags) {
       logger,
       allowedTools: cliFlags.tool,
       dynamic: cliFlags.mode === "dynamic",
+      annotationFilter: buildAnnotationFilter(cliFlags["tool-annotations"]),
       scopes: cliFlags.scope,
       serverURL: cliFlags["server-url"],
       getSDK: () =>

package/src/mcp-server/cli/start/command.ts

@@ -1,5 +1,6 @@
 /*
  * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+ * @generated-id: b3e53408ccb4
  */
 
 import { buildCommand } from "@stricli/core";
@@ -45,6 +46,13 @@ export const startCommand = buildCommand({
         values: ["dynamic"],
         optional: true,
       },
+      "tool-annotations": {
+        kind: "parsed",
+        brief:
+          "Filter tools by annotations (comma-separated: readOnly, destructive, idempotent, openWorld). Listed = required true, unlisted = required false.",
+        optional: true,
+        parse: (value) => value.split(",").map(s => s.trim()),
+      },
       scope: {
         kind: "enum",
         brief: "Mount tools/resources that match given scope (repeatable flag)",

package/src/mcp-server/cli/start/impl.ts

@@ -1,5 +1,6 @@
 /*
  * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+ * @generated-id: 37494f674015
  */
 
 import { SSEServerTransport } from "@modelcontextprotocol/sdk/server/sse.js";
@@ -12,6 +13,7 @@ import {
 } from "../../console-logger.js";
 import { MCPServerFlags } from "../../flags.js";
 import { createMCPServer } from "../../server.js";
+import { buildAnnotationFilter } from "../../tools.js";
 
 import { landingPageExpress } from "../../../landing-page.js";
 
@@ -52,6 +54,7 @@ async function startStdio(flags: StartCommandFlags) {
     logger,
     allowedTools: flags.tool,
     dynamic: flags.mode === "dynamic",
+    annotationFilter: buildAnnotationFilter(flags["tool-annotations"]),
     scopes: flags.scope,
     security: {
       cloudinaryAuth: flags["api-key"] != null && flags["api-secret"] != null
@@ -116,6 +119,7 @@ async function startSSE(cliFlags: StartCommandFlags) {
       logger,
       allowedTools: flags.tool,
       dynamic: flags.mode === "dynamic",
+      annotationFilter: buildAnnotationFilter(flags["tool-annotations"]),
       scopes: flags.scope,
       security: {
         cloudinaryAuth: flags["api-key"] != null && flags["api-secret"] != null

package/src/mcp-server/cli.ts

@@ -1,5 +1,6 @@
 /*
  * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+ * @generated-id: 4ade0ef98b00
  */
 
 import { CommandContext, StricliProcess } from "@stricli/core";

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

@@ -1,5 +1,6 @@
 /*
  * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+ * @generated-id: 57aff4ff2e15
  */
 
 export const consoleLoggerLevels = [

package/src/mcp-server/extensions.ts

@@ -1,5 +1,6 @@
 /*
  * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+ * @generated-id: 3d9d20ff158f
  */
 
 import { ZodRawShapeCompat } from "@modelcontextprotocol/sdk/server/zod-compat.js";

package/src/mcp-server/flags.ts

@@ -1,5 +1,6 @@
 /*
  * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+ * @generated-id: 0167e624a516
  */
 
 import { SDKOptions } from "../lib/config.js";
@@ -12,6 +13,7 @@ import { MCPScope } from "./scopes.js";
 export interface MCPServerFlags {
   readonly tool?: string[];
   readonly mode?: "dynamic" | undefined;
+  readonly "tool-annotations"?: string[] | undefined;
   readonly scope?: MCPScope[];
   readonly "api-key"?: string | undefined;
   readonly "api-secret"?: string | undefined;

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

@@ -1,5 +1,6 @@
 /*
  * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+ * @generated-id: aabbc4ab07c1
  */
 
 import { buildApplication, buildRouteMap, run } from "@stricli/core";
@@ -21,7 +22,7 @@ const routes = buildRouteMap({
 export const app = buildApplication(routes, {
   name: "mcp",
   versionInfo: {
-    currentVersion: "0.8.0",
+    currentVersion: "0.9.0-rc.0",
   },
 });
 

package/src/mcp-server/prompts.ts

@@ -1,5 +1,6 @@
 /*
  * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+ * @generated-id: 26f3d73cbf31
  */
 
 import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";

package/src/mcp-server/resources.ts

@@ -1,5 +1,6 @@
 /*
  * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+ * @generated-id: cb0c57ebeaea
  */
 
 import {

package/src/mcp-server/scopes.ts

@@ -1,5 +1,6 @@
 /*
  * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+ * @generated-id: 8966d24256b2
  */
 
 export const mcpScopes = [