@cloudinary/asset-management-mcp 0.9.3 → 0.10.0

package/src/models/resourceupdatebybodyrequest.ts

@@ -0,0 +1,168 @@
+/*
+ * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+ * @generated-id: 3c17bbd5de7c
+ */
+
+import * as z from "zod";
+import { collectExtraKeys as collectExtraKeys$ } from "../lib/schemas.js";
+import { ClosedEnum } from "../types/enums.js";
+import {
+  AdminContextOperation,
+  AdminContextOperation$zodSchema,
+} from "./admincontextoperation.js";
+
+/**
+ * The type of the asset (image, video, or raw).
+ */
+export const ResourceUpdateByBodyRequestResourceType = {
+  Image: "image",
+  Video: "video",
+  Raw: "raw",
+} as const;
+/**
+ * The type of the asset (image, video, or raw).
+ */
+export type ResourceUpdateByBodyRequestResourceType = ClosedEnum<
+  typeof ResourceUpdateByBodyRequestResourceType
+>;
+
+export const ResourceUpdateByBodyRequestResourceType$zodSchema = z.enum([
+  "image",
+  "video",
+  "raw",
+]).describe("The type of the asset (image, video, or raw).");
+
+/**
+ * The delivery type of the asset.
+ */
+export const ResourceUpdateByBodyRequestKind = {
+  Upload: "upload",
+  Private: "private",
+  Authenticated: "authenticated",
+} as const;
+/**
+ * The delivery type of the asset.
+ */
+export type ResourceUpdateByBodyRequestKind = ClosedEnum<
+  typeof ResourceUpdateByBodyRequestKind
+>;
+
+export const ResourceUpdateByBodyRequestKind$zodSchema = z.enum([
+  "upload",
+  "private",
+  "authenticated",
+]).describe("The delivery type of the asset.");
+
+/**
+ * The moderation status to set on the asset.
+ */
+export const ResourceUpdateByBodyRequestModerationStatus = {
+  Pending: "pending",
+  Approved: "approved",
+  Rejected: "rejected",
+} as const;
+/**
+ * The moderation status to set on the asset.
+ */
+export type ResourceUpdateByBodyRequestModerationStatus = ClosedEnum<
+  typeof ResourceUpdateByBodyRequestModerationStatus
+>;
+
+export const ResourceUpdateByBodyRequestModerationStatus$zodSchema = z.enum([
+  "pending",
+  "approved",
+  "rejected",
+]).describe("The moderation status to set on the asset.");
+
+/**
+ * The asset identifiers plus the attributes to update. The identifying fields (public_id,
+ *
+ * @remarks
+ * resource_type, kind) are required; the remaining update fields are optional. Additional
+ * fields accepted by the asset update API are permitted.
+ */
+export type ResourceUpdateByBodyRequest = {
+  public_id: string;
+  resource_type: ResourceUpdateByBodyRequestResourceType;
+  kind: ResourceUpdateByBodyRequestKind;
+  tags?: Array<string> | undefined;
+  context?: { [k: string]: any } | undefined;
+  metadata?: { [k: string]: any } | undefined;
+  asset_folder?: string | undefined;
+  display_name?: string | undefined;
+  moderation_status?: ResourceUpdateByBodyRequestModerationStatus | undefined;
+  admin_context?: Array<AdminContextOperation> | undefined;
+  response_type?: string | undefined;
+  skip_permission_check?: boolean | undefined;
+  AdditionalProperties?: { [k: string]: any };
+};
+
+export const ResourceUpdateByBodyRequest$zodSchema: z.ZodType<
+  ResourceUpdateByBodyRequest
+> = collectExtraKeys$(
+  z.object({
+    admin_context: z.array(AdminContextOperation$zodSchema).optional().describe(
+      "Internal-only contextual metadata operations applied with add/remove semantics. Each\nentry names a context key, the value(s) to apply, the value type, and the operation.\n",
+    ),
+    asset_folder: z.string().optional().describe(
+      "The asset folder to move the asset into.",
+    ),
+    context: z.record(z.string(), z.any()).optional().describe(
+      "The key-value pairs of contextual metadata to assign to the asset.",
+    ),
+    display_name: z.string().optional().describe(
+      "The display name to assign to the asset.",
+    ),
+    kind: ResourceUpdateByBodyRequestKind$zodSchema.describe(
+      "The delivery type of the asset.",
+    ),
+    metadata: z.record(z.string(), z.any()).optional().describe(
+      "The structured metadata field values to assign to the asset.",
+    ),
+    moderation_status: ResourceUpdateByBodyRequestModerationStatus$zodSchema
+      .optional().describe("The moderation status to set on the asset."),
+    public_id: z.string().describe("The public ID of the asset to update."),
+    resource_type: ResourceUpdateByBodyRequestResourceType$zodSchema.describe(
+      "The type of the asset (image, video, or raw).",
+    ),
+    response_type: z.string().optional().describe(
+      "The shape of the asset representation to return (for example, \"public\").",
+    ),
+    skip_permission_check: z.boolean().optional().describe(
+      "Whether to skip permission enforcement for the update. Internal use only. Default is false.",
+    ),
+    tags: z.array(z.string()).optional().describe(
+      "The list of tags to assign to the asset, replacing any existing tags.",
+    ),
+  }).describe(
+    "The asset identifiers plus the attributes to update. The identifying fields (public_id,\nresource_type, kind) are required; the remaining update fields are optional. Additional\nfields accepted by the asset update API are permitted.\n",
+  ).catchall(z.any()),
+  "AdditionalProperties",
+  true,
+);
+
+export const ResourceUpdateByBodyRequest$zodSchemaOutbound: z.ZodType<any> = z
+  .object({
+    AdditionalProperties: z.record(z.string(), z.any()).optional(),
+    admin_context: z.array(AdminContextOperation$zodSchema).optional(),
+    asset_folder: z.string().optional(),
+    context: z.record(z.string(), z.any()).optional(),
+    display_name: z.string().optional(),
+    kind: ResourceUpdateByBodyRequestKind$zodSchema,
+    metadata: z.record(z.string(), z.any()).optional(),
+    moderation_status: ResourceUpdateByBodyRequestModerationStatus$zodSchema
+      .optional(),
+    public_id: z.string(),
+    resource_type: ResourceUpdateByBodyRequestResourceType$zodSchema,
+    response_type: z.string().optional(),
+    skip_permission_check: z.boolean().optional(),
+    tags: z.array(z.string()).optional(),
+  }).describe(
+    "The asset identifiers plus the attributes to update. The identifying fields (public_id,\nresource_type, kind) are required; the remaining update fields are optional. Additional\nfields accepted by the asset update API are permitted.\n",
+  ).transform((v) => {
+    const { AdditionalProperties, ...rest } = v;
+    return {
+      ...rest,
+      ...AdditionalProperties,
+    };
+  });

package/src/models/searchparameters.ts

@@ -22,6 +22,40 @@ export const Type$zodSchema = z.enum([
   "duration",
 ]);
 
+export const AggregateEnum = {
+  Format: "format",
+  ResourceType: "resource_type",
+  Type: "type",
+} as const;
+export type AggregateEnum = ClosedEnum<typeof AggregateEnum>;
+
+export const AggregateEnum$zodSchema = z.enum([
+  "format",
+  "resource_type",
+  "type",
+]);
+
+export const WithField = {
+  Context: "context",
+  Tags: "tags",
+  ImageMetadata: "image_metadata",
+  ImageAnalysis: "image_analysis",
+  Metadata: "metadata",
+  QualityAnalysis: "quality_analysis",
+  AccessibilityAnalysis: "accessibility_analysis",
+} as const;
+export type WithField = ClosedEnum<typeof WithField>;
+
+export const WithField$zodSchema = z.enum([
+  "context",
+  "tags",
+  "image_metadata",
+  "image_analysis",
+  "metadata",
+  "quality_analysis",
+  "accessibility_analysis",
+]);
+
 export type SearchParametersRange = {
   key: string;
   from?: number | undefined;
@@ -50,19 +84,6 @@ export const Aggregate$zodSchema: z.ZodType<Aggregate> = z.object({
   type: Type$zodSchema,
 });
 
-export const AggregateEnum = {
-  Format: "format",
-  ResourceType: "resource_type",
-  Type: "type",
-} as const;
-export type AggregateEnum = ClosedEnum<typeof AggregateEnum>;
-
-export const AggregateEnum$zodSchema = z.enum([
-  "format",
-  "resource_type",
-  "type",
-]);
-
 /**
  * Fields or ranges to aggregate search results by. Requires a Tier 2 search plan; on Tier 1 the field is accepted but aggregations are omitted from the response.
  *
@@ -77,27 +98,6 @@ export const AggregateUnion$zodSchema: z.ZodType<AggregateUnion> = z.union([
   "Fields or ranges to aggregate search results by. Requires a Tier 2 search plan; on Tier 1 the field is accepted but aggregations are omitted from the response.\n",
 );
 
-export const WithField = {
-  Context: "context",
-  Tags: "tags",
-  ImageMetadata: "image_metadata",
-  ImageAnalysis: "image_analysis",
-  Metadata: "metadata",
-  QualityAnalysis: "quality_analysis",
-  AccessibilityAnalysis: "accessibility_analysis",
-} as const;
-export type WithField = ClosedEnum<typeof WithField>;
-
-export const WithField$zodSchema = z.enum([
-  "context",
-  "tags",
-  "image_metadata",
-  "image_analysis",
-  "metadata",
-  "quality_analysis",
-  "accessibility_analysis",
-]);
-
 /**
  * Common parameters for resource search operations.
  */
@@ -120,7 +120,7 @@ export const SearchParameters$zodSchema: z.ZodType<SearchParameters> = z.object(
       "Fields or ranges to aggregate search results by. Requires a Tier 2 search plan; on Tier 1 the field is accepted but aggregations are omitted from the response.\n",
     ),
     expression: z.string().optional().describe(
-      "The Lucene-like search expression. Supports token match (`:`), exact match (`=`), trailing `*` for prefix match, ranges (`[a TO b]`, `{a TO b}`), and comparisons (`>`, `<`, `>=`, `<=`). Combine terms with uppercase `AND`, `OR`, `NOT`, or `+`/`-`. `NOT` must appear between clauses — a leading `NOT` is a parse error; use `-field:value` to negate the first clause. Group with parentheses.\n\nWrap values containing spaces, colons, or other reserved characters (`! ( ) { } [ ] ^ ~ ?  \\ = & < > |`) in double quotes, e.g. `tags:\"service:mantels\"`, `aspect_ratio:\"16:9\"`. Send raw `<`/`>`, never HTML-escaped.\n\nWildcards are prefix-only (trailing `*`). A bare `*` (e.g. `folder:*`, `context.alt:*`, `metadata.key:*`, `tags:*`, `-tags:*`) is a parse error — there is no \"has any value\" / presence probe. Either drop the clause, use a concrete prefix, or filter on a known token.\n\nDates: ISO-8601 in quotes, or relative shorthand `1h`, `1d`, `1w`, `1m`, `1y` (`uploaded_at>1d`, `created_at:[4w TO 1w]`).\n\nSupported fields: `public_id`, `asset_id`, `filename`, `display_name`, `folder` / `asset_folder` (singular, not `folders`), `tags`, `context.<key>`, `metadata.<external_id>`, `resource_type`, `type`, `format`, `bytes`, `width`, `height`, `duration`, `pages`, `aspect_ratio`, `transparent`, `grayscale`, `status`, `moderation_status`, `moderation_kind`, `uploaded_at`, `created_at`, `taken_at`, `updated_at`, `last_updated.<kind>`, `face_count`, `illustration_score`, `quality_score`. Fields under `image_metadata.*`, `image_analysis.*`, `quality_analysis.*`, and `accessibility_analysis.*` also require the matching `with_field` to be returned in the response.\n\nSee the [search expressions guide](https://cloudinary.com/documentation/search_expressions.md) for the full reference.\n",
+      "The Lucene-like search expression. Supports token match (`:`), exact match (`=`), trailing `*` for prefix match, ranges (`[a TO b]`, `{a TO b}`), and comparisons (`>`, `<`, `>=`, `<=`). Combine terms with uppercase `AND`, `OR`, `NOT`, or `+`/`-`. `NOT` must appear between clauses — a leading `NOT` is a parse error; use `-field:value` to negate the first clause. Group with parentheses.\n\nWrap values containing spaces, colons, or other reserved characters (`! ( ) { } [ ] ^ ~ ?  \\ = & < > |`) in double quotes, e.g. `tags:\"service:mantels\"`, `tags:\"brand:openhaul\"`, `aspect_ratio:\"16:9\"`. Send raw `<`/`>`, never HTML-escaped.\n\nWildcards are prefix-only (trailing `*`). A bare `*` (e.g. `folder:*`, `context.alt:*`, `metadata.key:*`, `tags:*`, `-tags:*`) is a parse error — there is no \"has any value\" / presence probe. Either drop the clause, use a concrete prefix, or filter on a known token.\n\nDates: ISO-8601 in quotes (`uploaded_at>\"2024-01-15\"`, `created_at>\"2026-01-01T00:00:00Z\"`), or relative shorthand `Nh`, `Nd`, `Nw` (`uploaded_at>1d`, `created_at:[4w TO 1w]`).\n\nSupported fields: `public_id`, `asset_id`, `filename`, `display_name`, `folder` / `asset_folder` (singular, not `folders`), `tags`, `context.<key>`, `metadata.<external_id>`, `resource_type`, `type`, `format`, `bytes`, `width`, `height`, `duration`, `pages`, `aspect_ratio`, `transparent`, `grayscale`, `status`, `moderation_status`, `moderation_kind`, `uploaded_at`, `created_at`, `taken_at`, `updated_at`, `last_updated.<kind>`, `face_count`, `illustration_score`, `quality_score`. Fields under `image_metadata.*`, `image_analysis.*`, `quality_analysis.*`, and `accessibility_analysis.*` also require the matching `with_field` to be returned in the response.\n\nSee the [search expressions guide](https://cloudinary.com/documentation/search_expressions.md) for the full reference.\n",
     ),
     fields: z.string().optional().describe(
       "A comma-separated list of fields to include in the response.\nNotes:\n- This parameter takes precedence over the with_field parameter, so if you want any additional asset attributes returned, make sure to also include them in this list (e.g., tags or context).\n- The following fields are always included in the response: public_id, asset_id, asset_folder, created_at, status, type, and resource_type.\n",

package/src/models/searchresponse.ts

@@ -57,14 +57,14 @@ export const SearchResponseStatus$zodSchema = z.enum([
 ]).describe("The current status of the asset.");
 
 /**
- * The access mode of the asset.
+ * The access mode of the asset. Null when not explicitly set.
  */
 export const SearchResponseAccessMode = {
   Public: "public",
   Authenticated: "authenticated",
 } as const;
 /**
- * The access mode of the asset.
+ * The access mode of the asset. Null when not explicitly set.
  */
 export type SearchResponseAccessMode = ClosedEnum<
   typeof SearchResponseAccessMode
@@ -73,7 +73,7 @@ export type SearchResponseAccessMode = ClosedEnum<
 export const SearchResponseAccessMode$zodSchema = z.enum([
   "public",
   "authenticated",
-]).describe("The access mode of the asset.");
+]).describe("The access mode of the asset. Null when not explicitly set.");
 
 /**
  * Information about who created the asset.
@@ -149,7 +149,7 @@ export type Resource = {
   asset_folder?: string | undefined;
   filename?: string | undefined;
   display_name?: string | undefined;
-  format?: string | undefined;
+  format?: string | null | undefined;
   version?: number | undefined;
   resource_type?: SearchResponseResourceType | undefined;
   type?: DeliveryTypeAll | undefined;
@@ -157,14 +157,14 @@ export type Resource = {
   uploaded_at?: string | undefined;
   bytes?: number | undefined;
   backup_bytes?: number | undefined;
-  width?: number | undefined;
-  height?: number | undefined;
-  aspect_ratio?: number | undefined;
-  pixels?: number | undefined;
+  width?: number | null | undefined;
+  height?: number | null | undefined;
+  aspect_ratio?: number | null | undefined;
+  pixels?: number | null | undefined;
   url?: string | undefined;
   secure_url?: string | undefined;
   status?: SearchResponseStatus | undefined;
-  access_mode?: SearchResponseAccessMode | undefined;
+  access_mode?: SearchResponseAccessMode | null | undefined;
   access_control?: Array<AccessControlItem> | null | undefined;
   etag?: string | undefined;
   created_by?: CreatedBy | null | undefined;
@@ -181,13 +181,12 @@ export type Resource = {
 export const Resource$zodSchema: z.ZodType<Resource> = z.object({
   access_control: z.array(AccessControlItem$zodSchema).nullable().optional()
     .describe("The access control settings for the asset."),
-  access_mode: SearchResponseAccessMode$zodSchema.optional().describe(
-    "The access mode of the asset.",
-  ),
+  access_mode: SearchResponseAccessMode$zodSchema.nullable().optional()
+    .describe("The access mode of the asset. Null when not explicitly set."),
   accessibility_analysis: z.lazy(() => AccessibilityAnalysis$zodSchema)
     .nullable().optional().describe("Results of accessibility analysis."),
-  aspect_ratio: z.number().optional().describe(
-    "The aspect ratio of the asset (width/height).",
+  aspect_ratio: z.number().nullable().optional().describe(
+    "The aspect ratio of the asset (width/height). Null for non-visual assets (e.g. raw, audio).",
   ),
   asset_folder: z.string().optional().describe(
     "The folder where the asset is stored.",
@@ -215,8 +214,12 @@ export const Resource$zodSchema: z.ZodType<Resource> = z.object({
   filename: z.string().optional().describe(
     "The original filename of the asset.",
   ),
-  format: z.string().optional().describe("The format of the asset."),
-  height: z.int().optional().describe("The height of the asset in pixels."),
+  format: z.string().nullable().optional().describe(
+    "The format of the asset. Null for raw assets, which have no format.",
+  ),
+  height: z.int().nullable().optional().describe(
+    "The height of the asset in pixels. Null for non-visual assets (e.g. raw, audio).",
+  ),
   image_analysis: z.lazy(() => ImageAnalysis$zodSchema).nullable().optional()
     .describe("Results of image analysis."),
   image_metadata: z.lazy(() => SearchResponseImageMetadata$zodSchema).nullable()
@@ -224,8 +227,8 @@ export const Resource$zodSchema: z.ZodType<Resource> = z.object({
   metadata: z.lazy(() => Metadata$zodSchema).nullable().optional().describe(
     "Structured metadata associated with the asset.",
   ),
-  pixels: z.int().optional().describe(
-    "The total number of pixels in the asset.",
+  pixels: z.int().nullable().optional().describe(
+    "The total number of pixels in the asset. Null for non-visual assets (e.g. raw, audio).",
   ),
   public_id: z.string().optional().describe(
     "The public identifier that is used to build the URL.",
@@ -254,7 +257,9 @@ export const Resource$zodSchema: z.ZodType<Resource> = z.object({
     .describe("Information about who uploaded the asset."),
   url: z.string().optional().describe("The HTTP URL for accessing the asset."),
   version: z.int().optional().describe("The version number of the asset."),
-  width: z.int().optional().describe("The width of the asset in pixels."),
+  width: z.int().nullable().optional().describe(
+    "The width of the asset in pixels. Null for non-visual assets (e.g. raw, audio).",
+  ),
 }).describe(
   "Resource fields that can be returned. All fields are optional and can be filtered using the fields parameter.",
 );

package/src/models/storage.ts

@@ -0,0 +1,39 @@
+/*
+ * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+ * @generated-id: 8b534f43f59e
+ */
+
+import * as z from "zod";
+import {
+  ManagedAssetStorage,
+  ManagedAssetStorage$zodSchema,
+} from "./managedassetstorage.js";
+import {
+  TemporaryStorage,
+  TemporaryStorage$zodSchema,
+} from "./temporarystorage.js";
+
+/**
+ * Where a generated asset is stored — mirrors the request `target`,
+ *
+ * @remarks
+ * determined by `storage_type`. `secure_url` is always present.
+ */
+export type Storage =
+  | (ManagedAssetStorage & { storage_type: "managed_asset" })
+  | (TemporaryStorage & { storage_type: "temporary" });
+
+export const Storage$zodSchema: z.ZodType<Storage> = z.union([
+  ManagedAssetStorage$zodSchema.and(
+    z.object({
+      storage_type: z.literal("managed_asset"),
+    }).transform((v) => ({ storage_type: v.storage_type })),
+  ),
+  TemporaryStorage$zodSchema.and(
+    z.object({
+      storage_type: z.literal("temporary"),
+    }).transform((v) => ({ storage_type: v.storage_type })),
+  ),
+]).describe(
+  "Where a generated asset is stored — mirrors the request `target`,\ndetermined by `storage_type`. `secure_url` is always present.\n",
+);

package/src/models/target.ts

@@ -0,0 +1,39 @@
+/*
+ * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+ * @generated-id: f37077ef7c9a
+ */
+
+import * as z from "zod";
+import {
+  ManagedAssetTarget,
+  ManagedAssetTarget$zodSchema,
+} from "./managedassettarget.js";
+import {
+  TemporaryTarget,
+  TemporaryTarget$zodSchema,
+} from "./temporarytarget.js";
+
+/**
+ * Where to store the generated output, determined by `target_type`.
+ *
+ * @remarks
+ * Optional; defaults to a `managed_asset` target when omitted.
+ */
+export type Target =
+  | (ManagedAssetTarget & { target_type: "managed_asset" })
+  | (TemporaryTarget & { target_type: "temporary" });
+
+export const Target$zodSchema: z.ZodType<Target> = z.union([
+  ManagedAssetTarget$zodSchema.and(
+    z.object({
+      target_type: z.literal("managed_asset"),
+    }).transform((v) => ({ target_type: v.target_type })),
+  ),
+  TemporaryTarget$zodSchema.and(
+    z.object({
+      target_type: z.literal("temporary"),
+    }).transform((v) => ({ target_type: v.target_type })),
+  ),
+]).describe(
+  "Where to store the generated output, determined by `target_type`.\nOptional; defaults to a `managed_asset` target when omitted.\n",
+);

package/src/models/task.ts

@@ -0,0 +1,53 @@
+/*
+ * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+ * @generated-id: 9609f5f4adcb
+ */
+
+import * as z from "zod";
+import { GeneratedAsset, GeneratedAsset$zodSchema } from "./generatedasset.js";
+import { Limits, Limits$zodSchema } from "./limits.js";
+import { TaskStatus, TaskStatus$zodSchema } from "./taskstatus.js";
+
+/**
+ * The generated assets. Populated once `status` is `completed`.
+ *
+ * @remarks
+ */
+export type TaskResult = { assets: Array<GeneratedAsset> };
+
+export const TaskResult$zodSchema: z.ZodType<TaskResult> = z.object({
+  assets: z.array(GeneratedAsset$zodSchema).describe(
+    "The generated assets. Currently a single asset is returned.",
+  ),
+}).describe("The generated assets. Populated once `status` is `completed`.\n");
+
+/**
+ * An async generation task. Returned when a generation is accepted (202)
+ *
+ * @remarks
+ * and from GET /tasks/{task_id} as it progresses. The `result` is filled
+ * in once `status` is `completed`.
+ */
+export type Task = {
+  task_id: string;
+  status: TaskStatus;
+  result?: TaskResult | null | undefined;
+  limits?: Limits | undefined;
+};
+
+export const Task$zodSchema: z.ZodType<Task> = z.object({
+  limits: Limits$zodSchema.optional().describe(
+    "Rate limit information for the account's add-on quotas.",
+  ),
+  result: z.lazy(() => TaskResult$zodSchema).nullable().optional().describe(
+    "The generated assets. Populated once `status` is `completed`.\n",
+  ),
+  status: TaskStatus$zodSchema.describe(
+    "The status of an async generation task.\n* `pending`: accepted and queued, not yet started.\n* `processing`: generation is in progress.\n* `completed`: generation finished; `result` is populated.\n* `failed`: generation did not complete successfully.\n",
+  ),
+  task_id: z.string().describe(
+    "Identifier for the async generation task. Use it to poll `GET /generate/{cloud_name}/tasks/{task_id}`.",
+  ),
+}).describe(
+  "An async generation task. Returned when a generation is accepted (202)\nand from GET /tasks/{task_id} as it progresses. The `result` is filled\nin once `status` is `completed`.\n",
+);

package/src/models/taskresponse.ts

@@ -0,0 +1,26 @@
+/*
+ * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+ * @generated-id: b5ae8dfddaea
+ */
+
+import * as z from "zod";
+import { Task, Task$zodSchema } from "./task.js";
+
+/**
+ * Envelope for an async generation task — returned by the accepted (202)
+ *
+ * @remarks
+ * response and by GET /tasks/{task_id}.
+ */
+export type TaskResponse = { data?: Task | undefined; request_id: string };
+
+export const TaskResponse$zodSchema: z.ZodType<TaskResponse> = z.object({
+  data: Task$zodSchema.optional().describe(
+    "An async generation task. Returned when a generation is accepted (202)\nand from GET /tasks/{task_id} as it progresses. The `result` is filled\nin once `status` is `completed`.\n",
+  ),
+  request_id: z.string().describe(
+    "Unique identifier for this request, for correlation and support.",
+  ),
+}).describe(
+  "Envelope for an async generation task — returned by the accepted (202)\nresponse and by GET /tasks/{task_id}.\n",
+);

package/src/models/taskstatus.ts

@@ -0,0 +1,42 @@
+/*
+ * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+ * @generated-id: 53ca97329a8b
+ */
+
+import * as z from "zod";
+import { ClosedEnum } from "../types/enums.js";
+
+/**
+ * The status of an async generation task.
+ *
+ * @remarks
+ * * `pending`: accepted and queued, not yet started.
+ * * `processing`: generation is in progress.
+ * * `completed`: generation finished; `result` is populated.
+ * * `failed`: generation did not complete successfully.
+ */
+export const TaskStatus = {
+  Pending: "pending",
+  Processing: "processing",
+  Completed: "completed",
+  Failed: "failed",
+} as const;
+/**
+ * The status of an async generation task.
+ *
+ * @remarks
+ * * `pending`: accepted and queued, not yet started.
+ * * `processing`: generation is in progress.
+ * * `completed`: generation finished; `result` is populated.
+ * * `failed`: generation did not complete successfully.
+ */
+export type TaskStatus = ClosedEnum<typeof TaskStatus>;
+
+export const TaskStatus$zodSchema = z.enum([
+  "pending",
+  "processing",
+  "completed",
+  "failed",
+]).describe(
+  "The status of an async generation task.\n* `pending`: accepted and queued, not yet started.\n* `processing`: generation is in progress.\n* `completed`: generation finished; `result` is populated.\n* `failed`: generation did not complete successfully.\n",
+);

package/src/models/temporarystorage.ts

@@ -0,0 +1,47 @@
+/*
+ * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+ * @generated-id: edef5e745a76
+ */
+
+import * as z from "zod";
+import { ClosedEnum } from "../types/enums.js";
+
+/**
+ * Discriminator identifying this as temporary storage.
+ */
+export const TemporaryStorageStorageType = {
+  Temporary: "temporary",
+} as const;
+/**
+ * Discriminator identifying this as temporary storage.
+ */
+export type TemporaryStorageStorageType = ClosedEnum<
+  typeof TemporaryStorageStorageType
+>;
+
+export const TemporaryStorageStorageType$zodSchema = z.enum([
+  "temporary",
+]).describe("Discriminator identifying this as temporary storage.");
+
+/**
+ * A generated asset stored as a short-lived asset on the upload service.
+ */
+export type TemporaryStorage = {
+  storage_type: TemporaryStorageStorageType;
+  secure_url: string;
+  expires_at: string;
+};
+
+export const TemporaryStorage$zodSchema: z.ZodType<TemporaryStorage> = z.object(
+  {
+    expires_at: z.iso.datetime({ offset: true }).describe(
+      "Time in UTC when secure_url stops being valid.",
+    ),
+    secure_url: z.string().describe("The URL to fetch the generated asset."),
+    storage_type: TemporaryStorageStorageType$zodSchema.describe(
+      "Discriminator identifying this as temporary storage.",
+    ),
+  },
+).describe(
+  "A generated asset stored as a short-lived asset on the upload service.",
+);

package/src/models/temporarytarget.ts

@@ -0,0 +1,35 @@
+/*
+ * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+ * @generated-id: 3585fffc94ea
+ */
+
+import * as z from "zod";
+import { ClosedEnum } from "../types/enums.js";
+
+/**
+ * Discriminator identifying this as a temporary target.
+ */
+export const TemporaryTargetTargetType = {
+  Temporary: "temporary",
+} as const;
+/**
+ * Discriminator identifying this as a temporary target.
+ */
+export type TemporaryTargetTargetType = ClosedEnum<
+  typeof TemporaryTargetTargetType
+>;
+
+export const TemporaryTargetTargetType$zodSchema = z.enum([
+  "temporary",
+]).describe("Discriminator identifying this as a temporary target.");
+
+/**
+ * Store the output as a short-lived asset on the upload service.
+ */
+export type TemporaryTarget = { target_type: TemporaryTargetTargetType };
+
+export const TemporaryTarget$zodSchema: z.ZodType<TemporaryTarget> = z.object({
+  target_type: TemporaryTargetTargetType$zodSchema.describe(
+    "Discriminator identifying this as a temporary target.",
+  ),
+}).describe("Store the output as a short-lived asset on the upload service.");