@cloudinary/environment-config-mcp 0.6.0 → 0.6.1

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 = (
@@ -45,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/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 {
@@ -111,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/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";
@@ -194,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/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";
@@ -383,8 +384,6 @@ async function logResponse(
       break;
     case matchContentType(res, "application/jsonl")
       || jsonlLikeContentTypeRE.test(ct):
-      logger.log(await res.clone().text());
-      break;
     case matchContentType(res, "text/event-stream"):
       logger.log(`<${contentType}>`);
       break;

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";
@@ -13,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";
   }
 
@@ -240,8 +246,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 +267,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";
@@ -41,10 +42,17 @@ export const serveCommand = buildCommand({
       mode: {
         kind: "enum",
         brief:
-          "Server mode (dynamic: expose list_tools, describe_tool, and execute_tool instead of individual tools)",
+          "Server mode (dynamic: expose list_tools, describe_tool_input, and execute_tool instead of individual tools)",
         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";
@@ -39,7 +41,7 @@ async function startStreamableHTTP(cliFlags: ServeCommandFlags) {
   app.use((req, res, next) => {
     res.header("Access-Control-Allow-Origin", "*");
     res.header("Access-Control-Allow-Methods", "GET, POST, OPTIONS");
-    res.header("Access-Control-Allow-Headers", "Content-Type, *");
+    res.header("Access-Control-Allow-Headers", "*");
     if (req.method === "OPTIONS") {
       res.sendStatus(204);
       return;
@@ -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";
@@ -41,10 +42,17 @@ export const startCommand = buildCommand({
       mode: {
         kind: "enum",
         brief:
-          "Server mode (dynamic: expose list_tools, describe_tool, and execute_tool instead of individual tools)",
+          "Server mode (dynamic: expose list_tools, describe_tool_input, and execute_tool instead of individual tools)",
         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.6.0",
+    currentVersion: "0.6.1",
   },
 });
 

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 = [

package/src/mcp-server/server.ts

@@ -1,5 +1,6 @@
 /*
  * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+ * @generated-id: 2784dd48e82a
  */
 
 import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
@@ -12,7 +13,11 @@ import {
   createRegisterResourceTemplate,
 } from "./resources.js";
 import { MCPScope } from "./scopes.js";
-import { createRegisterTool, registerDynamicTools } from "./tools.js";
+import {
+  createRegisterTool,
+  MCPToolAnnotationFilter,
+  registerDynamicTools,
+} from "./tools.js";
 import { tool$streamingProfilesCreateStreamingProfile } from "./tools/streamingProfilesCreateStreamingProfile.js";
 import { tool$streamingProfilesDeleteStreamingProfile } from "./tools/streamingProfilesDeleteStreamingProfile.js";
 import { tool$streamingProfilesGetStreamingProfile } from "./tools/streamingProfilesGetStreamingProfile.js";
@@ -43,6 +48,7 @@ export function createMCPServer(deps: {
   allowedTools?: string[] | undefined;
   dynamic?: boolean | undefined;
   scopes?: MCPScope[] | undefined;
+  annotationFilter?: MCPToolAnnotationFilter | undefined;
   getSDK?: () => CloudinaryEnvConfigCore;
   serverURL?: string | undefined;
   security?: SDKOptions["security"] | undefined;
@@ -53,7 +59,7 @@ export function createMCPServer(deps: {
 }) {
   const server = new McpServer({
     name: "CloudinaryEnvConfig",
-    version: "0.6.0",
+    version: "0.6.1",
   });
 
   const getClient = deps.getSDK || (() =>
@@ -83,6 +89,7 @@ export function createMCPServer(deps: {
     scopes,
     allowedTools,
     deps.dynamic,
+    deps.annotationFilter,
   );
   const resource = createRegisterResource(
     deps.logger,

package/src/mcp-server/shared.ts

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

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

@@ -1,5 +1,6 @@
 /*
  * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+ * @generated-id: bdb92e282dcf
  */
 
 import { streamingProfilesCreateStreamingProfile } from "../../funcs/streamingProfilesCreateStreamingProfile.js";
@@ -7,7 +8,9 @@ import { StreamingProfileCreate$zodSchema } from "../../models/streamingprofilec
 import { formatResult, ToolDefinition } from "../tools.js";
 
 const args = {
-  request: StreamingProfileCreate$zodSchema,
+  request: StreamingProfileCreate$zodSchema.describe(
+    `The streaming profile configuration.`,
+  ),
 };
 
 export const tool$streamingProfilesCreateStreamingProfile: ToolDefinition<

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

@@ -1,5 +1,6 @@
 /*
  * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+ * @generated-id: b4e9f3eb3ca7
  */
 
 import * as z from "zod";
@@ -7,7 +8,7 @@ import { streamingProfilesDeleteStreamingProfile } from "../../funcs/streamingPr
 import { formatResult, ToolDefinition } from "../tools.js";
 
 const args = {
-  name: z.string(),
+  name: z.string().describe("The name of the streaming profile."),
 };
 
 export const tool$streamingProfilesDeleteStreamingProfile: ToolDefinition<

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

@@ -1,5 +1,6 @@
 /*
  * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+ * @generated-id: 418409851acf
  */
 
 import * as z from "zod";
@@ -7,7 +8,7 @@ import { streamingProfilesGetStreamingProfile } from "../../funcs/streamingProfi
 import { formatResult, ToolDefinition } from "../tools.js";
 
 const args = {
-  name: z.string(),
+  name: z.string().describe("The name of the streaming profile."),
 };
 
 export const tool$streamingProfilesGetStreamingProfile: ToolDefinition<

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

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

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

@@ -1,5 +1,6 @@
 /*
  * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+ * @generated-id: 4e34c78fa055
  */
 
 import * as z from "zod";
@@ -8,8 +9,10 @@ import { StreamingProfileUpdate$zodSchema } from "../../models/streamingprofileu
 import { formatResult, ToolDefinition } from "../tools.js";
 
 const args = {
-  name: z.string(),
-  streaming_profile_update: StreamingProfileUpdate$zodSchema,
+  name: z.string().describe("The name of the streaming profile."),
+  streaming_profile_update: StreamingProfileUpdate$zodSchema.describe(
+    `The updated streaming profile configuration.`,
+  ),
 };
 
 export const tool$streamingProfilesUpdateStreamingProfile: ToolDefinition<

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

@@ -1,5 +1,6 @@
 /*
  * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+ * @generated-id: 8325647b37f6
  */
 
 import * as z from "zod";
@@ -9,9 +10,11 @@ import { formatResult, ToolDefinition } from "../tools.js";
 
 const args = {
   transformation: z.string().describe(
-    "The valid transformation name to create.\n",
+    "The valid transformation name to create.",
+  ),
+  create_request: CreateRequest$zodSchema.describe(
+    `The named transformation definition.`,
   ),
-  create_request: CreateRequest$zodSchema,
 };
 
 export const tool$transformationsCreateTransformation: ToolDefinition<
@@ -19,7 +22,7 @@ export const tool$transformationsCreateTransformation: ToolDefinition<
 > = {
   name: "create-transformation",
   description:
-    `Creates a new named transformation (assigning a custom name to a set of transformation
+    `Creates a new named transformation by assigning a custom name to a set of transformation parameters
 
 Creates a new named transformation with the given name and transformation string.
 `,

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

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

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

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

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

@@ -1,5 +1,6 @@
 /*
  * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+ * @generated-id: 86830305f9cf
  */
 
 import * as z from "zod";
@@ -23,7 +24,7 @@ export const tool$transformationsListTransformations: ToolDefinition<
 > = {
   name: "list-transformations",
   description:
-    `Lists all transformation definitions in your account (including named transformations
+    `Lists all transformation definitions in your account, including named transformations
 
 Retrieves a list of all transformations, which can be filtered to show either only named or unnamed transformations.
 `,

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

@@ -1,5 +1,6 @@
 /*
  * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+ * @generated-id: 8051ff62d868
  */
 
 import * as z from "zod";
@@ -11,16 +12,18 @@ const args = {
   transformation: z.string().describe(
     "The transformation identifier. Can be either a named transformation (e.g., 'small_profile_thumbnail') or a transformation string (e.g., 'w_100,h_150,c_fill,g_auto').\n",
   ),
-  update_request: UpdateRequest$zodSchema,
+  update_request: UpdateRequest$zodSchema.describe(
+    `The updated transformation definition.`,
+  ),
 };
 
 export const tool$transformationsUpdateTransformation: ToolDefinition<
   typeof args
 > = {
   name: "update-transformation",
-  description: `Updates the definition of an existing named transformation
+  description: `Updates the definition of an existing transformation
 
-Update an existing named or unnamed transformation.
+Updates a named or unnamed transformation.
 `,
   scopes: ["admin"],
   annotations: {

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

@@ -1,13 +1,16 @@
 /*
  * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+ * @generated-id: 841868a185b7
  */
 
 import { triggersCreateTrigger } from "../../funcs/triggersCreateTrigger.js";
-import { CreateTriggerRequest$zodSchema } from "../../models/createtriggerop.js";
+import { CreateTriggerRequest$zodSchema } from "../../models/createtriggerrequest.js";
 import { formatResult, ToolDefinition } from "../tools.js";
 
 const args = {
-  request: CreateTriggerRequest$zodSchema,
+  request: CreateTriggerRequest$zodSchema.describe(
+    `The webhook notification trigger to create.`,
+  ),
 };
 
 export const tool$triggersCreateTrigger: ToolDefinition<typeof args> = {

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

@@ -1,5 +1,6 @@
 /*
  * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+ * @generated-id: 36d23c68493b
  */
 
 import * as z from "zod";
@@ -7,7 +8,7 @@ import { triggersDeleteTrigger } from "../../funcs/triggersDeleteTrigger.js";
 import { formatResult, ToolDefinition } from "../tools.js";
 
 const args = {
-  id: z.string(),
+  id: z.string().describe("The ID of the trigger."),
 };
 
 export const tool$triggersDeleteTrigger: ToolDefinition<typeof args> = {