@cloudinary/environment-config-mcp 0.6.0 → 0.6.1

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

@@ -1,21 +1,22 @@
 /*
  * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+ * @generated-id: 5b10585d5fca
  */
 
-import * as z from "zod";
 import { triggersListTrigger } from "../../funcs/triggersListTrigger.js";
+import { EventType$zodSchema } from "../../models/eventtype.js";
 import { formatResult, ToolDefinition } from "../tools.js";
 
 const args = {
-  event_type: z.string().describe(
-    "The type of event that will trigger the notification response.",
-  ).optional(),
+  event_type: EventType$zodSchema.optional().describe(
+    `The type of event that will trigger the notification response.`,
+  ),
 };
 
 export const tool$triggersListTrigger: ToolDefinition<typeof args> = {
   name: "list-triggers",
   description:
-    `Lists all webhook notification triggers configured for your product environmentcloudinary
+    `Lists all webhook notification triggers configured for your product environment
 
 Retrieves a list of all event triggers and notifications within your product environment.
 `,

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

@@ -1,15 +1,18 @@
 /*
  * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+ * @generated-id: b6710d7af609
  */
 
 import * as z from "zod";
 import { triggersTestTrigger } from "../../funcs/triggersTestTrigger.js";
-import { TestTriggerRequestBody$zodSchema } from "../../models/testtriggerop.js";
+import { TestTriggerRequest$zodSchema } from "../../models/testtriggerrequest.js";
 import { formatResult, ToolDefinition } from "../tools.js";
 
 const args = {
-  id: z.string(),
-  RequestBody: TestTriggerRequestBody$zodSchema.optional(),
+  id: z.string().describe("The ID of the trigger to test."),
+  test_trigger_request: TestTriggerRequest$zodSchema.optional().describe(
+    `The test data for the trigger.`,
+  ),
 };
 
 export const tool$triggersTestTrigger: ToolDefinition<typeof args> = {
@@ -23,7 +26,7 @@ Use this endpoint to verify that a trigger's filter will match expected events.
   annotations: {
     "title": "Test Trigger Filter",
     "destructiveHint": false,
-    "idempotentHint": false,
+    "idempotentHint": true,
     "openWorldHint": false,
     "readOnlyHint": true,
   },
@@ -32,7 +35,7 @@ Use this endpoint to verify that a trigger's filter will match expected events.
     const [result] = await triggersTestTrigger(
       client,
       args.id,
-      args.RequestBody,
+      args.test_trigger_request,
       { fetchOptions: { signal: ctx.signal } },
     ).$inspect();
 

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

@@ -1,15 +1,18 @@
 /*
  * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+ * @generated-id: 0bedcb0b91e0
  */
 
 import * as z from "zod";
 import { triggersUpdateTrigger } from "../../funcs/triggersUpdateTrigger.js";
-import { UpdateTriggerRequestBody$zodSchema } from "../../models/updatetriggerop.js";
+import { UpdateTriggerRequest$zodSchema } from "../../models/updatetriggerrequest.js";
 import { formatResult, ToolDefinition } from "../tools.js";
 
 const args = {
-  id: z.string(),
-  RequestBody: UpdateTriggerRequestBody$zodSchema,
+  id: z.string().describe("The ID of the trigger."),
+  update_trigger_request: UpdateTriggerRequest$zodSchema.describe(
+    `The updated trigger configuration.`,
+  ),
 };
 
 export const tool$triggersUpdateTrigger: ToolDefinition<typeof args> = {
@@ -31,7 +34,7 @@ Updates a notification URL for a trigger.`,
     const [result] = await triggersUpdateTrigger(
       client,
       args.id,
-      args.RequestBody,
+      args.update_trigger_request,
       { fetchOptions: { signal: ctx.signal } },
     ).$inspect();
 

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

@@ -1,13 +1,16 @@
 /*
  * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+ * @generated-id: 91d3a6b88c2e
  */
 
 import { uploadMappingsCreateUploadMapping } from "../../funcs/uploadMappingsCreateUploadMapping.js";
-import { CreateUploadMappingRequest$zodSchema } from "../../models/createuploadmappingop.js";
+import { UploadMappingInput$zodSchema } from "../../models/uploadmappinginput.js";
 import { formatResult, ToolDefinition } from "../tools.js";
 
 const args = {
-  request: CreateUploadMappingRequest$zodSchema,
+  request: UploadMappingInput$zodSchema.describe(
+    `The upload mapping folder and URL template.`,
+  ),
 };
 
 export const tool$uploadMappingsCreateUploadMapping: ToolDefinition<

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

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

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

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

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

@@ -1,13 +1,16 @@
 /*
  * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+ * @generated-id: 93f301e2ef80
  */
 
 import { uploadMappingsUpdateUploadMapping } from "../../funcs/uploadMappingsUpdateUploadMapping.js";
-import { UpdateUploadMappingRequest$zodSchema } from "../../models/updateuploadmappingop.js";
+import { UploadMappingInput$zodSchema } from "../../models/uploadmappinginput.js";
 import { formatResult, ToolDefinition } from "../tools.js";
 
 const args = {
-  request: UpdateUploadMappingRequest$zodSchema,
+  request: UploadMappingInput$zodSchema.describe(
+    `The updated upload mapping folder and URL template.`,
+  ),
 };
 
 export const tool$uploadMappingsUpdateUploadMapping: ToolDefinition<
@@ -15,7 +18,7 @@ export const tool$uploadMappingsUpdateUploadMapping: ToolDefinition<
 > = {
   name: "update-upload-mapping",
   description:
-    `Updates an existing upload mapping by changing its remote URL template for a given
+    `Updates an existing upload mapping by changing its remote URL template for a given folder
 
 Updates the URL template for an existing folder mapping`,
   scopes: ["builder"],

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

@@ -1,13 +1,16 @@
 /*
  * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+ * @generated-id: cbfced083eca
  */
 
 import { uploadPresetsCreateUploadPreset } from "../../funcs/uploadPresetsCreateUploadPreset.js";
-import { UploadPreset$zodSchema } from "../../models/uploadpreset.js";
+import { UploadPresetInput$zodSchema } from "../../models/uploadpresetinput.js";
 import { formatResult, ToolDefinition } from "../tools.js";
 
 const args = {
-  request: UploadPreset$zodSchema,
+  request: UploadPresetInput$zodSchema.describe(
+    `The upload preset configuration.`,
+  ),
 };
 
 export const tool$uploadPresetsCreateUploadPreset: ToolDefinition<typeof args> =

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

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

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

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

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

@@ -1,18 +1,24 @@
 /*
  * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+ * @generated-id: 798d000ef5fd
  */
 
 import * as z from "zod";
 import { uploadPresetsListUploadPresets } from "../../funcs/uploadPresetsListUploadPresets.js";
-import {
-  Direction$zodSchema,
-  OrderBy$zodSchema,
-} from "../../models/listuploadpresetsop.js";
+import { DirectionEnum$zodSchema } from "../../models/directionenum.js";
+import { OrderBy$zodSchema } from "../../models/listuploadpresetsop.js";
 import { formatResult, ToolDefinition } from "../tools.js";
 
 const args = {
-  order_by: OrderBy$zodSchema.optional(),
-  direction: Direction$zodSchema.optional(),
+  order_by: OrderBy$zodSchema.optional().describe(
+    `The field to sort presets by.`,
+  ),
+  direction: DirectionEnum$zodSchema.optional().describe(
+    `The sort direction for the results. Default is "desc".`,
+  ),
+  max_results: z.int().default(10).describe(
+    "The maximum number of results to return. Default is 10.",
+  ),
   next_cursor: z.string().describe(
     "The cursor for pagination. Use the next_cursor value from a previous response to get the next page of results.",
   ).optional(),
@@ -36,6 +42,7 @@ export const tool$uploadPresetsListUploadPresets: ToolDefinition<typeof args> =
         client,
         args.order_by,
         args.direction,
+        args.max_results,
         args.next_cursor,
         { fetchOptions: { signal: ctx.signal } },
       ).$inspect();

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

@@ -1,15 +1,18 @@
 /*
  * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+ * @generated-id: 400f04c7187f
  */
 
 import * as z from "zod";
 import { uploadPresetsUpdateUploadPreset } from "../../funcs/uploadPresetsUpdateUploadPreset.js";
-import { UploadPreset$zodSchema } from "../../models/uploadpreset.js";
+import { UploadPresetInput$zodSchema } from "../../models/uploadpresetinput.js";
 import { formatResult, ToolDefinition } from "../tools.js";
 
 const args = {
-  name: z.string(),
-  upload_preset: UploadPreset$zodSchema,
+  name: z.string().describe("The name of the upload preset."),
+  upload_preset_input: UploadPresetInput$zodSchema.describe(
+    `The updated upload preset configuration.`,
+  ),
 };
 
 export const tool$uploadPresetsUpdateUploadPreset: ToolDefinition<typeof args> =
@@ -29,7 +32,7 @@ export const tool$uploadPresetsUpdateUploadPreset: ToolDefinition<typeof args> =
       const [result] = await uploadPresetsUpdateUploadPreset(
         client,
         args.name,
-        args.upload_preset,
+        args.upload_preset_input,
         { fetchOptions: { signal: ctx.signal } },
       ).$inspect();
 

package/src/mcp-server/tools.ts

@@ -1,5 +1,6 @@
 /*
  * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+ * @generated-id: 654d5d1f2062
  */
 
 import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
@@ -21,6 +22,50 @@ import { MCPServerFlags } from "./flags.js";
 import { MCPScope, mcpScopes } from "./scopes.js";
 import { valueToBase64 } from "./shared.js";
 
+export type MCPToolAnnotationFilter = {
+  readOnlyHint?: boolean;
+  destructiveHint?: boolean;
+  idempotentHint?: boolean;
+  openWorldHint?: boolean;
+};
+
+const VALID_ANNOTATIONS = [
+  "readOnly",
+  "destructive",
+  "idempotent",
+  "openWorld",
+] as const;
+type AnnotationName = typeof VALID_ANNOTATIONS[number];
+
+const annotationToKey: Record<AnnotationName, keyof MCPToolAnnotationFilter> = {
+  readOnly: "readOnlyHint",
+  destructive: "destructiveHint",
+  idempotent: "idempotentHint",
+  openWorld: "openWorldHint",
+};
+
+export function buildAnnotationFilter(
+  annotations: string[] | undefined,
+): MCPToolAnnotationFilter {
+  const filter: MCPToolAnnotationFilter = {};
+  if (!annotations || annotations.length === 0) {
+    return filter;
+  }
+  for (const a of annotations) {
+    if (!VALID_ANNOTATIONS.includes(a as AnnotationName)) {
+      throw new Error(
+        `Invalid annotation filter: "${a}". Valid values are: ${
+          VALID_ANNOTATIONS.join(", ")
+        }`,
+      );
+    }
+  }
+  for (const name of VALID_ANNOTATIONS) {
+    filter[annotationToKey[name]] = annotations.includes(name);
+  }
+  return filter;
+}
+
 export type ToolDefinition<
   Args extends undefined | ZodRawShapeCompat = undefined,
 > = Args extends ZodRawShapeCompat ? {
@@ -91,6 +136,7 @@ export function createRegisterTool(
   allowedScopes: Set<MCPScope>,
   allowedTools?: Set<string>,
   dynamic?: boolean,
+  annotationFilter?: MCPToolAnnotationFilter,
 ): [
   <A extends ZodRawShapeCompat | undefined>(tool: ToolDefinition<A>) => void,
   Array<{ name: string; description: string }>,
@@ -120,6 +166,34 @@ export function createRegisterTool(
       return;
     }
 
+    if (annotationFilter) {
+      const a = tool.annotations;
+      if (
+        annotationFilter.readOnlyHint !== undefined
+        && a.readOnlyHint !== annotationFilter.readOnlyHint
+      ) {
+        return;
+      }
+      if (
+        annotationFilter.destructiveHint !== undefined
+        && a.destructiveHint !== annotationFilter.destructiveHint
+      ) {
+        return;
+      }
+      if (
+        annotationFilter.idempotentHint !== undefined
+        && a.idempotentHint !== annotationFilter.idempotentHint
+      ) {
+        return;
+      }
+      if (
+        annotationFilter.openWorldHint !== undefined
+        && a.openWorldHint !== annotationFilter.openWorldHint
+      ) {
+        return;
+      }
+    }
+
     toolMap.set(
       tool.name,
       tool as ToolDefinition<ZodRawShapeCompat | undefined>,
@@ -271,6 +345,8 @@ export function registerDynamicTools(
       if (def.args) {
         const jsonSchema = z.toJSONSchema(z.object(def.args), {
           target: "draft-2020-12",
+          io: "input",
+          unrepresentable: "any",
         });
         schemaText += JSON.stringify(jsonSchema, null, 2);
       } else {
@@ -286,16 +362,16 @@ export function registerDynamicTools(
 
     return { content: [{ type: "text", text: parts.join("\n\n") }] };
   });
-  logger.debug("Registered dynamic meta-tool", { name: "describe_tool" });
+  logger.debug("Registered dynamic meta-tool", { name: "describe_tool_input" });
 
   // 3. execute_tool
   server.registerTool("execute_tool", {
     description:
-      "Execute a tool by name with the provided input parameters. If executing a given tool for the first time, it is recommended to call describe_tool_input first to understand the expected input schema.",
+      "Execute a tool by name with its arguments. If executing a given tool for the first time, it is recommended to call describe_tool_input first to understand the expected `arguments` shape.",
     inputSchema: {
-      tool_name: z.string().describe("The name of the tool to execute"),
-      input: z.record(z.string(), z.unknown()).optional().describe(
-        "Input parameters for the tool as a JSON object",
+      name: z.string().describe("The name of the tool to execute"),
+      arguments: z.looseObject({}).optional().describe(
+        "Arguments for the target tool as a JSON object, matching the schema returned by describe_tool_input.",
       ),
     },
     annotations: {
@@ -306,17 +382,17 @@ export function registerDynamicTools(
       openWorldHint: true,
     },
   }, async (args, ctx) => {
-    const def = toolMap.get(args.tool_name);
+    const def = toolMap.get(args.name);
     if (!def) {
       return {
-        content: [{ type: "text", text: `Unknown tool: ${args.tool_name}` }],
+        content: [{ type: "text", text: `Unknown tool: ${args.name}` }],
         isError: true,
       };
     }
 
     let validatedInput: Record<string, unknown> = {};
     if (def.args) {
-      const vres = z.object(def.args).safeParse(args.input ?? {});
+      const vres = z.object(def.args).safeParse(args.arguments ?? {});
       if (vres.success) {
         validatedInput = vres.data;
       } else {
@@ -326,7 +402,7 @@ export function registerDynamicTools(
           content: [{
             type: "text",
             text:
-              `Invalid input for tool ${args.tool_name}:\n<issues>\n${issues}\n</issues>`,
+              `Invalid input for tool ${args.name}:\n<issues>\n${issues}\n</issues>`,
           }],
           isError: true,
         };
@@ -344,7 +420,7 @@ export function registerDynamicTools(
       return {
         content: [{
           type: "text",
-          text: `Error executing tool ${args.tool_name}: ${message}`,
+          text: `Error executing tool ${args.name}: ${message}`,
         }],
         isError: true,
       };

package/src/models/accesscontrolitem.ts

@@ -1,5 +1,6 @@
 /*
  * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+ * @generated-id: b3d5a7a42328
  */
 
 import * as z from "zod";
@@ -22,22 +23,60 @@ export const AccessType$zodSchema = z.enum([
   "anonymous",
 ]).describe("The type of access control to apply to the asset.");
 
+/**
+ * The start date and time when anonymous access becomes available. Accepts ISO 8601 string or Unix timestamp.
+ */
+export type Start = string | number;
+
+export const Start$zodSchema: z.ZodType<Start> = z.union([
+  z.string(),
+  z.int(),
+]).describe(
+  "The start date and time when anonymous access becomes available. Accepts ISO 8601 string or Unix timestamp.",
+);
+
+/**
+ * The end date and time when anonymous access expires. Accepts ISO 8601 string or Unix timestamp.
+ */
+export type End = string | number;
+
+export const End$zodSchema: z.ZodType<End> = z.union([
+  z.string(),
+  z.int(),
+]).describe(
+  "The end date and time when anonymous access expires. Accepts ISO 8601 string or Unix timestamp.",
+);
+
 /**
  * Access control rule that defines when and how the asset can be accessed.
  */
 export type AccessControlItem = {
   access_type: AccessType;
   key?: string | undefined;
-  start?: string | undefined;
-  end?: string | undefined;
+  start?: string | number | undefined;
+  end?: string | number | undefined;
 };
 
 export const AccessControlItem$zodSchema: z.ZodType<AccessControlItem> = z
   .object({
-    access_type: AccessType$zodSchema,
-    end: z.string().optional(),
-    key: z.string().optional(),
-    start: z.string().optional(),
+    access_type: AccessType$zodSchema.describe(
+      "The type of access control to apply to the asset.",
+    ),
+    end: z.union([
+      z.string(),
+      z.int(),
+    ]).optional().describe(
+      "The end date and time when anonymous access expires. Accepts ISO 8601 string or Unix timestamp.",
+    ),
+    key: z.string().optional().describe(
+      "The authentication key identifier for token-based access. Default key is used if not specified or if set to 'default'.",
+    ),
+    start: z.union([
+      z.string(),
+      z.int(),
+    ]).optional().describe(
+      "The start date and time when anonymous access becomes available. Accepts ISO 8601 string or Unix timestamp.",
+    ),
   }).describe(
     "Access control rule that defines when and how the asset can be accessed.",
   );

package/src/models/apierror.ts

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

package/src/models/assetdeliverytype.ts

@@ -0,0 +1,22 @@
+/*
+ * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+ * @generated-id: bf0f7e855303
+ */
+
+import * as z from "zod";
+import { ClosedEnum } from "../types/enums.js";
+
+/**
+ * Static asset delivery type.
+ */
+export const AssetDeliveryType = {
+  Asset: "asset",
+} as const;
+/**
+ * Static asset delivery type.
+ */
+export type AssetDeliveryType = ClosedEnum<typeof AssetDeliveryType>;
+
+export const AssetDeliveryType$zodSchema = z.enum([
+  "asset",
+]).describe("Static asset delivery type.");

package/src/models/createrequest.ts

@@ -1,5 +1,6 @@
 /*
  * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+ * @generated-id: 2a84f278b6b5
  */
 
 import * as z from "zod";
@@ -10,6 +11,8 @@ export type CreateRequest = {
 };
 
 export const CreateRequest$zodSchema: z.ZodType<CreateRequest> = z.object({
-  allowed_for_strict: z.boolean().optional(),
-  transformation: z.string(),
+  allowed_for_strict: z.boolean().optional().describe(
+    "Whether to allow this named transformation when strict transformations are enabled. Strict transformations prevent transformations from being dynamically applied to media assets.\n",
+  ),
+  transformation: z.string().describe("A valid transformation string."),
 });

package/src/models/createstreamingprofileop.ts

@@ -1,13 +1,14 @@
 /*
  * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+ * @generated-id: f7e150ddbf2a
  */
 
 import * as z from "zod";
 import { ApiError, ApiError$zodSchema } from "./apierror.js";
 import {
-  StreamingProfile,
-  StreamingProfile$zodSchema,
-} from "./streamingprofile.js";
+  StreamingProfileDataResponse,
+  StreamingProfileDataResponse$zodSchema,
+} from "./streamingprofiledataresponse.js";
 
 export type CreateStreamingProfileGlobals = { cloud_name?: string | undefined };
 
@@ -18,24 +19,13 @@ export const CreateStreamingProfileGlobals$zodSchema: z.ZodType<
     .optional(),
 });
 
-/**
- * Streaming profile created
- */
-export type CreateStreamingProfileResponseBody = { data: StreamingProfile };
-
-export const CreateStreamingProfileResponseBody$zodSchema: z.ZodType<
-  CreateStreamingProfileResponseBody
-> = z.object({
-  data: StreamingProfile$zodSchema,
-}).describe("Streaming profile created");
-
 export type CreateStreamingProfileResponse =
-  | CreateStreamingProfileResponseBody
+  | StreamingProfileDataResponse
   | ApiError;
 
 export const CreateStreamingProfileResponse$zodSchema: z.ZodType<
   CreateStreamingProfileResponse
 > = z.union([
-  z.lazy(() => CreateStreamingProfileResponseBody$zodSchema),
+  StreamingProfileDataResponse$zodSchema,
   ApiError$zodSchema,
 ]);