@cloudinary/asset-management-mcp 0.8.1 → 0.9.0

package/src/models/listresourcesbyassetidsop.ts

@@ -5,7 +5,7 @@
 
 import * as z from "zod";
 import { ApiError, ApiError$zodSchema } from "./apierror.js";
-import { FieldsSpec, FieldsSpec$zodSchema } from "./fieldsspec.js";
+import { Fields, Fields$zodSchema } from "./fields.js";
 import { ListResponse, ListResponse$zodSchema } from "./listresponse.js";
 import { ResourceType, ResourceType$zodSchema } from "./resourcetype.js";
 
@@ -23,7 +23,7 @@ export const ListResourcesByAssetIDsGlobals$zodSchema: z.ZodType<
 export type ListResourcesByAssetIDsRequest = {
   asset_ids: Array<string>;
   resource_type?: ResourceType | undefined;
-  fields?: Array<FieldsSpec> | undefined;
+  fields?: Fields | undefined;
 };
 
 export const ListResourcesByAssetIDsRequest$zodSchema: z.ZodType<
@@ -32,9 +32,11 @@ export const ListResourcesByAssetIDsRequest$zodSchema: z.ZodType<
   asset_ids: z.array(z.string()).describe(
     "List of asset IDs to retrieve (max 100).",
   ),
-  fields: z.array(FieldsSpec$zodSchema).optional(),
+  fields: Fields$zodSchema.optional().describe(
+    "Additional fields to include in the response. The fields public_id and asset_id are always included.",
+  ),
   resource_type: ResourceType$zodSchema.optional().describe(
-    "Resource type (optional, can sometimes disambiguate).",
+    "Resource type filter.",
   ),
 });
 

package/src/models/listresourcesbycontextop.ts

@@ -5,8 +5,8 @@
 
 import * as z from "zod";
 import { ApiError, ApiError$zodSchema } from "./apierror.js";
-import { Direction, Direction$zodSchema } from "./direction.js";
-import { FieldsSpec, FieldsSpec$zodSchema } from "./fieldsspec.js";
+import { DirectionEnum, DirectionEnum$zodSchema } from "./directionenum.js";
+import { Fields, Fields$zodSchema } from "./fields.js";
 import { ListResponse, ListResponse$zodSchema } from "./listresponse.js";
 import { ResourceType, ResourceType$zodSchema } from "./resourcetype.js";
 
@@ -25,20 +25,26 @@ export type ListResourcesByContextRequest = {
   value?: string | undefined;
   next_cursor?: string | undefined;
   max_results?: number | undefined;
-  direction?: Direction | undefined;
-  fields?: Array<FieldsSpec> | undefined;
+  direction?: DirectionEnum | undefined;
+  fields?: Fields | undefined;
 };
 
 export const ListResourcesByContextRequest$zodSchema: z.ZodType<
   ListResourcesByContextRequest
 > = z.object({
-  direction: Direction$zodSchema.optional().describe("Sort direction."),
-  fields: z.array(FieldsSpec$zodSchema).optional(),
+  direction: DirectionEnum$zodSchema.optional().describe(
+    "The sort direction for the results. Default is \"desc\".",
+  ),
+  fields: Fields$zodSchema.optional().describe(
+    "Additional fields to include in the response. The fields public_id and asset_id are always included.",
+  ),
   key: z.string().describe("Context key to filter by."),
   max_results: z.int().describe("Maximum number of results to return (1-500).")
     .optional(),
   next_cursor: z.string().describe("Cursor for pagination.").optional(),
-  resource_type: ResourceType$zodSchema.describe("The type of resource."),
+  resource_type: ResourceType$zodSchema.describe(
+    "The type of resource (image, video, or raw).",
+  ),
   value: z.string().describe("Context value to filter by.").optional(),
 });
 

package/src/models/listresourcesbymoderationkindandstatusop.ts

@@ -4,11 +4,15 @@
  */
 
 import * as z from "zod";
-import { ClosedEnum } from "../types/enums.js";
 import { ApiError, ApiError$zodSchema } from "./apierror.js";
-import { Direction, Direction$zodSchema } from "./direction.js";
-import { FieldsSpec, FieldsSpec$zodSchema } from "./fieldsspec.js";
+import { DirectionEnum, DirectionEnum$zodSchema } from "./directionenum.js";
+import { Fields, Fields$zodSchema } from "./fields.js";
 import { ListResponse, ListResponse$zodSchema } from "./listresponse.js";
+import { ModerationKind, ModerationKind$zodSchema } from "./moderationkind.js";
+import {
+  ModerationStatusParameter,
+  ModerationStatusParameter$zodSchema,
+} from "./moderationstatusparameter.js";
 import { ResourceType, ResourceType$zodSchema } from "./resourcetype.js";
 
 export type ListResourcesByModerationKindAndStatusGlobals = {
@@ -22,69 +26,37 @@ export const ListResourcesByModerationKindAndStatusGlobals$zodSchema: z.ZodType<
     .optional(),
 });
 
-export const ModerationKind = {
-  Manual: "manual",
-  Webpurify: "webpurify",
-  AwsRek: "aws_rek",
-  AwsRekVideo: "aws_rek_video",
-  PerceptionPoint: "perception_point",
-  GoogleVideoModeration: "google_video_moderation",
-  Duplicate: "duplicate",
-} as const;
-export type ModerationKind = ClosedEnum<typeof ModerationKind>;
-
-export const ModerationKind$zodSchema = z.enum([
-  "manual",
-  "webpurify",
-  "aws_rek",
-  "aws_rek_video",
-  "perception_point",
-  "google_video_moderation",
-  "duplicate",
-]);
-
-export const ListResourcesByModerationKindAndStatusModerationStatus = {
-  Approved: "approved",
-  Rejected: "rejected",
-  Pending: "pending",
-  Queued: "queued",
-  Aborted: "aborted",
-} as const;
-export type ListResourcesByModerationKindAndStatusModerationStatus = ClosedEnum<
-  typeof ListResourcesByModerationKindAndStatusModerationStatus
->;
-
-export const ListResourcesByModerationKindAndStatusModerationStatus$zodSchema =
-  z.enum([
-    "approved",
-    "rejected",
-    "pending",
-    "queued",
-    "aborted",
-  ]);
-
 export type ListResourcesByModerationKindAndStatusRequest = {
   resource_type: ResourceType;
   moderation_kind: ModerationKind;
-  moderation_status: ListResourcesByModerationKindAndStatusModerationStatus;
-  fields?: Array<FieldsSpec> | undefined;
+  moderation_status: ModerationStatusParameter;
+  fields?: Fields | undefined;
   next_cursor?: string | undefined;
   max_results?: number | undefined;
-  direction?: Direction | undefined;
+  direction?: DirectionEnum | undefined;
 };
 
 export const ListResourcesByModerationKindAndStatusRequest$zodSchema: z.ZodType<
   ListResourcesByModerationKindAndStatusRequest
 > = z.object({
-  direction: Direction$zodSchema.optional().describe("Sort direction."),
-  fields: z.array(FieldsSpec$zodSchema).optional(),
+  direction: DirectionEnum$zodSchema.optional().describe(
+    "The sort direction for the results. Default is \"desc\".",
+  ),
+  fields: Fields$zodSchema.optional().describe(
+    "Additional fields to include in the response. The fields public_id and asset_id are always included.",
+  ),
   max_results: z.int().describe("Maximum number of results to return (1-500).")
     .optional(),
-  moderation_kind: ModerationKind$zodSchema,
-  moderation_status:
-    ListResourcesByModerationKindAndStatusModerationStatus$zodSchema,
+  moderation_kind: ModerationKind$zodSchema.describe(
+    "The type of moderation to filter by.",
+  ),
+  moderation_status: ModerationStatusParameter$zodSchema.describe(
+    "The moderation status to filter by.",
+  ),
   next_cursor: z.string().describe("Cursor for pagination.").optional(),
-  resource_type: ResourceType$zodSchema.describe("The type of resource."),
+  resource_type: ResourceType$zodSchema.describe(
+    "The type of resource (image, video, or raw).",
+  ),
 });
 
 export type ListResourcesByModerationKindAndStatusResponse =

package/src/models/listresourcetagsop.ts

@@ -6,6 +6,10 @@
 import * as z from "zod";
 import { ApiError, ApiError$zodSchema } from "./apierror.js";
 import { ResourceType, ResourceType$zodSchema } from "./resourcetype.js";
+import {
+  TagsListResponse,
+  TagsListResponse$zodSchema,
+} from "./tagslistresponse.js";
 
 export type ListResourceTagsGlobals = { cloud_name?: string | undefined };
 
@@ -30,31 +34,18 @@ export const ListResourceTagsRequest$zodSchema: z.ZodType<
     .optional(),
   next_cursor: z.string().describe("Cursor for pagination.").optional(),
   prefix: z.string().describe(
-    "The prefix to use if you want to limit the returned tags to those that start with the specified prefix.",
+    "Limit the returned tags to those that start with the specified prefix.",
   ).optional(),
-  resource_type: ResourceType$zodSchema.describe("The type of resource."),
+  resource_type: ResourceType$zodSchema.describe(
+    "The type of resource (image, video, or raw).",
+  ),
 });
 
-/**
- * List of tags retrieved
- */
-export type ListResourceTagsResponseBody = {
-  tags?: Array<string> | undefined;
-  next_cursor?: string | null | undefined;
-};
-
-export const ListResourceTagsResponseBody$zodSchema: z.ZodType<
-  ListResourceTagsResponseBody
-> = z.object({
-  next_cursor: z.string().nullable().optional(),
-  tags: z.array(z.string()).optional(),
-}).describe("List of tags retrieved");
-
-export type ListResourceTagsResponse = ApiError | ListResourceTagsResponseBody;
+export type ListResourceTagsResponse = ApiError | TagsListResponse;
 
 export const ListResourceTagsResponse$zodSchema: z.ZodType<
   ListResourceTagsResponse
 > = z.union([
   ApiError$zodSchema,
-  z.lazy(() => ListResourceTagsResponseBody$zodSchema),
+  TagsListResponse$zodSchema,
 ]);

package/src/models/listresourcetypesop.ts

@@ -4,7 +4,10 @@
  */
 
 import * as z from "zod";
-import { ClosedEnum } from "../types/enums.js";
+import {
+  ResourceTypesResponse,
+  ResourceTypesResponse$zodSchema,
+} from "./resourcetypesresponse.js";
 
 export type ListResourceTypesGlobals = { cloud_name?: string | undefined };
 
@@ -32,52 +35,21 @@ export const ListResourceTypesError$zodSchema: z.ZodType<
 /**
  * Authentication failed.
  */
-export type ListResourceTypesUnauthorizedResponseBody = {
-  error: ListResourceTypesError;
-};
-
-export const ListResourceTypesUnauthorizedResponseBody$zodSchema: z.ZodType<
-  ListResourceTypesUnauthorizedResponseBody
-> = z.object({
-  error: z.lazy(() => ListResourceTypesError$zodSchema),
-}).describe("Authentication failed.");
-
-export const ListResourceTypesResourceType = {
-  Image: "image",
-  Raw: "raw",
-  Video: "video",
-} as const;
-export type ListResourceTypesResourceType = ClosedEnum<
-  typeof ListResourceTypesResourceType
->;
-
-export const ListResourceTypesResourceType$zodSchema = z.enum([
-  "image",
-  "raw",
-  "video",
-]);
-
-/**
- * The list of resource types.
- */
-export type ListResourceTypesResponseBody = {
-  resource_types?: Array<ListResourceTypesResourceType> | undefined;
-};
+export type ListResourceTypesResponseBody = { error: ListResourceTypesError };
 
 export const ListResourceTypesResponseBody$zodSchema: z.ZodType<
   ListResourceTypesResponseBody
 > = z.object({
-  resource_types: z.array(ListResourceTypesResourceType$zodSchema).optional()
-    .describe("The list of available resource types."),
-}).describe("The list of resource types.");
+  error: z.lazy(() => ListResourceTypesError$zodSchema),
+}).describe("Authentication failed.");
 
 export type ListResourceTypesResponse =
-  | ListResourceTypesUnauthorizedResponseBody
-  | ListResourceTypesResponseBody;
+  | ListResourceTypesResponseBody
+  | ResourceTypesResponse;
 
 export const ListResourceTypesResponse$zodSchema: z.ZodType<
   ListResourceTypesResponse
 > = z.union([
-  z.lazy(() => ListResourceTypesUnauthorizedResponseBody$zodSchema),
   z.lazy(() => ListResourceTypesResponseBody$zodSchema),
+  ResourceTypesResponse$zodSchema,
 ]);

package/src/models/listvideosop.ts

@@ -5,13 +5,13 @@
 
 import * as z from "zod";
 import { ApiError, ApiError$zodSchema } from "./apierror.js";
-import { Direction, Direction$zodSchema } from "./direction.js";
-import { FieldsSpec, FieldsSpec$zodSchema } from "./fieldsspec.js";
-import { ListResponse, ListResponse$zodSchema } from "./listresponse.js";
 import {
-  ListStorageType,
-  ListStorageType$zodSchema,
-} from "./liststoragetype.js";
+  DeliveryTypeAll,
+  DeliveryTypeAll$zodSchema,
+} from "./deliverytypeall.js";
+import { DirectionEnum, DirectionEnum$zodSchema } from "./directionenum.js";
+import { Fields, Fields$zodSchema } from "./fields.js";
+import { ListResponse, ListResponse$zodSchema } from "./listresponse.js";
 
 export type ListVideosGlobals = { cloud_name?: string | undefined };
 
@@ -23,39 +23,43 @@ export const ListVideosGlobals$zodSchema: z.ZodType<ListVideosGlobals> = z
   });
 
 export type ListVideosRequest = {
-  type?: ListStorageType | undefined;
+  type?: DeliveryTypeAll | undefined;
   prefix?: string | undefined;
   public_ids?: Array<string> | undefined;
   tags?: boolean | undefined;
   next_cursor?: string | undefined;
   max_results?: number | undefined;
-  direction?: Direction | undefined;
+  direction?: DirectionEnum | undefined;
   start_at?: string | undefined;
-  fields?: Array<FieldsSpec> | undefined;
+  fields?: Fields | undefined;
 };
 
 export const ListVideosRequest$zodSchema: z.ZodType<ListVideosRequest> = z
   .object({
-    direction: Direction$zodSchema.optional().describe("Sort direction."),
-    fields: z.array(FieldsSpec$zodSchema).optional(),
+    direction: DirectionEnum$zodSchema.optional().describe(
+      "The sort direction for the results. Default is \"desc\".",
+    ),
+    fields: Fields$zodSchema.optional().describe(
+      "Additional fields to include in the response. The fields public_id and asset_id are always included.",
+    ),
     max_results: z.int().describe(
       "Maximum number of results to return (1-500).",
     ).optional(),
     next_cursor: z.string().describe("Cursor for pagination.").optional(),
     prefix: z.string().describe(
-      "A public_id prefix. When specified, all assets with that prefix are returned. When using this, the `type` parameter must also be specified.",
+      "A public_id prefix. When specified, all assets with that prefix are returned.",
     ).optional(),
     public_ids: z.array(z.string()).describe(
       "An array of public IDs to return.",
     ).optional(),
     start_at: z.iso.datetime({ offset: true }).describe(
-      "An ISO-8601 formatted timestamp. When specified, assets created since that timestamp are returned.  Supported only if neither `prefix` nor `public_ids` were passed.",
-    ).optional(),
-    tags: z.boolean().describe(
-      "Whether to include the list of tag names assigned to each asset. Default: false",
+      "An ISO-8601 formatted timestamp. When specified, returns resources created since that timestamp. Supported only if neither `prefix` nor `public_ids` were passed.",
     ).optional(),
-    type: ListStorageType$zodSchema.optional().describe(
-      "The delivery type. Necessary for prefix filtering.",
+    tags: z.boolean().default(false).describe(
+      "Whether to include the list of tag names assigned to each asset. Default is false.",
+    ),
+    type: DeliveryTypeAll$zodSchema.optional().describe(
+      "The delivery type to filter by. When omitted, returns assets of all delivery types.",
     ),
   });
 

package/src/models/manageddeliverytype.ts

@@ -0,0 +1,28 @@
+/*
+ * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+ * @generated-id: a3bf36714875
+ */
+
+import * as z from "zod";
+import { ClosedEnum } from "../types/enums.js";
+
+/**
+ * Managed delivery types for assets uploaded and stored by Cloudinary.
+ */
+export const ManagedDeliveryType = {
+  Upload: "upload",
+  Private: "private",
+  Authenticated: "authenticated",
+} as const;
+/**
+ * Managed delivery types for assets uploaded and stored by Cloudinary.
+ */
+export type ManagedDeliveryType = ClosedEnum<typeof ManagedDeliveryType>;
+
+export const ManagedDeliveryType$zodSchema = z.enum([
+  "upload",
+  "private",
+  "authenticated",
+]).describe(
+  "Managed delivery types for assets uploaded and stored by Cloudinary.",
+);

package/src/models/moderationkind.ts

@@ -0,0 +1,28 @@
+/*
+ * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+ * @generated-id: dd69aeb34a50
+ */
+
+import * as z from "zod";
+import { ClosedEnum } from "../types/enums.js";
+
+export const ModerationKind = {
+  Manual: "manual",
+  Webpurify: "webpurify",
+  AwsRek: "aws_rek",
+  AwsRekVideo: "aws_rek_video",
+  PerceptionPoint: "perception_point",
+  GoogleVideoModeration: "google_video_moderation",
+  Duplicate: "duplicate",
+} as const;
+export type ModerationKind = ClosedEnum<typeof ModerationKind>;
+
+export const ModerationKind$zodSchema = z.enum([
+  "manual",
+  "webpurify",
+  "aws_rek",
+  "aws_rek_video",
+  "perception_point",
+  "google_video_moderation",
+  "duplicate",
+]);

package/src/models/moderationstatusparameter.ts

@@ -0,0 +1,26 @@
+/*
+ * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+ * @generated-id: d184e28eafb2
+ */
+
+import * as z from "zod";
+import { ClosedEnum } from "../types/enums.js";
+
+export const ModerationStatusParameter = {
+  Approved: "approved",
+  Rejected: "rejected",
+  Pending: "pending",
+  Queued: "queued",
+  Aborted: "aborted",
+} as const;
+export type ModerationStatusParameter = ClosedEnum<
+  typeof ModerationStatusParameter
+>;
+
+export const ModerationStatusParameter$zodSchema = z.enum([
+  "approved",
+  "rejected",
+  "pending",
+  "queued",
+  "aborted",
+]);

package/src/models/movefolderrequest.ts

@@ -0,0 +1,16 @@
+/*
+ * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+ * @generated-id: acbca1ab341e
+ */
+
+import * as z from "zod";
+
+/**
+ * The folder move/rename request.
+ */
+export type MoveFolderRequest = { to_folder: string };
+
+export const MoveFolderRequest$zodSchema: z.ZodType<MoveFolderRequest> = z
+  .object({
+    to_folder: z.string().describe("The new path for the folder."),
+  }).describe("The folder move/rename request.");

package/src/models/movefolderresponse.ts

@@ -0,0 +1,15 @@
+/*
+ * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+ * @generated-id: b33bb4d6c655
+ */
+
+import * as z from "zod";
+import { FolderNamePath, FolderNamePath$zodSchema } from "./foldernamepath.js";
+
+export type MoveFolderResponse = { from: FolderNamePath; to: FolderNamePath };
+
+export const MoveFolderResponse$zodSchema: z.ZodType<MoveFolderResponse> = z
+  .object({
+    from: FolderNamePath$zodSchema,
+    to: FolderNamePath$zodSchema,
+  });

package/src/models/nonfinalchunkuploadresponse.ts

@@ -4,7 +4,10 @@
  */
 
 import * as z from "zod";
-import { StorageType, StorageType$zodSchema } from "./storagetype.js";
+import {
+  UploadDeliveryType,
+  UploadDeliveryType$zodSchema,
+} from "./uploaddeliverytype.js";
 
 /**
  * Status information returned for in-progress chunked uploads.
@@ -15,7 +18,7 @@ import { StorageType, StorageType$zodSchema } from "./storagetype.js";
 export type NonFinalChunkUploadResponse = {
   done: boolean;
   bytes: number;
-  kind?: StorageType | undefined;
+  kind?: UploadDeliveryType | undefined;
   resource_type?: string | undefined;
   public_id?: string | undefined;
 };
@@ -27,8 +30,8 @@ export const NonFinalChunkUploadResponse$zodSchema: z.ZodType<
   done: z.boolean().describe(
     "Whether the upload is complete. Will be false for all but the last chunk.",
   ),
-  kind: StorageType$zodSchema.optional().describe(
-    "The storage type of the resource.",
+  kind: UploadDeliveryType$zodSchema.optional().describe(
+    "Delivery types accepted by upload and rename operations.",
   ),
   public_id: z.string().optional().describe(
     "The public ID assigned to the upload. May be omitted in early chunks if it will be auto-generated upon completion.",

package/src/models/peoplelistresponse.ts

@@ -0,0 +1,22 @@
+/*
+ * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+ * @generated-id: 193a600926d9
+ */
+
+import * as z from "zod";
+import { PersonDetails, PersonDetails$zodSchema } from "./persondetails.js";
+
+export type PeopleListResponse = {
+  people?: Array<PersonDetails> | undefined;
+  next_cursor?: string | undefined;
+};
+
+export const PeopleListResponse$zodSchema: z.ZodType<PeopleListResponse> = z
+  .object({
+    next_cursor: z.string().optional().describe(
+      "The cursor to use for the next page of results.",
+    ),
+    people: z.array(PersonDetails$zodSchema).optional().describe(
+      "A list of recognized person objects.",
+    ),
+  });

package/src/models/personresponse.ts

@@ -0,0 +1,15 @@
+/*
+ * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+ * @generated-id: 1fe679d28276
+ */
+
+import * as z from "zod";
+import { PersonDetails, PersonDetails$zodSchema } from "./persondetails.js";
+
+export type PersonResponse = { person?: PersonDetails | undefined };
+
+export const PersonResponse$zodSchema: z.ZodType<PersonResponse> = z.object({
+  person: PersonDetails$zodSchema.optional().describe(
+    "Detailed information about a recognized person.",
+  ),
+});

package/src/models/relateassetsbyassetidrequest.ts

@@ -0,0 +1,19 @@
+/*
+ * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+ * @generated-id: 9b885131a012
+ */
+
+import * as z from "zod";
+
+/**
+ * The asset relation request.
+ */
+export type RelateAssetsByAssetIdRequest = { assets_to_relate: Array<string> };
+
+export const RelateAssetsByAssetIdRequest$zodSchema: z.ZodType<
+  RelateAssetsByAssetIdRequest
+> = z.object({
+  assets_to_relate: z.array(z.string()).describe(
+    "Relates the asset to all the assets specified in this array of up to 10 assets, specified by their asset IDs.",
+  ),
+}).describe("The asset relation request.");

package/src/models/relateassetsbypublicidrequest.ts

@@ -0,0 +1,19 @@
+/*
+ * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+ * @generated-id: 7ecf5c8c27c9
+ */
+
+import * as z from "zod";
+
+/**
+ * The asset relation request.
+ */
+export type RelateAssetsByPublicIdRequest = { assets_to_relate: Array<string> };
+
+export const RelateAssetsByPublicIdRequest$zodSchema: z.ZodType<
+  RelateAssetsByPublicIdRequest
+> = z.object({
+  assets_to_relate: z.array(z.string()).describe(
+    "Relates the asset to all the other assets specified in this array of up to 10 assets, specified as resource_type/type/public_id.",
+  ),
+}).describe("The asset relation request.");