@cloudinary/asset-management-mcp 0.9.2 → 0.10.0

package/src/models/inspectpeoplepermissionsop.ts

@@ -0,0 +1,31 @@
+/*
+ * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+ * @generated-id: 37203eb65669
+ */
+
+import * as z from "zod";
+import { ApiError, ApiError$zodSchema } from "./apierror.js";
+import {
+  PeopleInspectResponse,
+  PeopleInspectResponse$zodSchema,
+} from "./peopleinspectresponse.js";
+
+export type InspectPeoplePermissionsGlobals = {
+  cloud_name?: string | undefined;
+};
+
+export const InspectPeoplePermissionsGlobals$zodSchema: z.ZodType<
+  InspectPeoplePermissionsGlobals
+> = z.object({
+  cloud_name: z.string().describe("The cloud name of your product environment.")
+    .optional(),
+});
+
+export type InspectPeoplePermissionsResponse = PeopleInspectResponse | ApiError;
+
+export const InspectPeoplePermissionsResponse$zodSchema: z.ZodType<
+  InspectPeoplePermissionsResponse
+> = z.union([
+  PeopleInspectResponse$zodSchema,
+  ApiError$zodSchema,
+]);

package/src/models/invalidatebyurlsrequest.ts

@@ -0,0 +1,27 @@
+/*
+ * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+ * @generated-id: da07f4b04b4b
+ */
+
+import * as z from "zod";
+
+/**
+ * The set of delivery URLs whose derived assets should be invalidated.
+ */
+export type InvalidateByUrlsRequest = {
+  urls: Array<string>;
+  skip_reporting?: boolean | undefined;
+};
+
+export const InvalidateByUrlsRequest$zodSchema: z.ZodType<
+  InvalidateByUrlsRequest
+> = z.object({
+  skip_reporting: z.boolean().optional().describe(
+    "Whether to skip recording this invalidation against the product environment usage. If false, the invalidation is counted towards usage. Default is false.",
+  ),
+  urls: z.array(z.string()).describe(
+    "The delivery URLs whose cached derived assets should be invalidated.",
+  ),
+}).describe(
+  "The set of delivery URLs whose derived assets should be invalidated.",
+);

package/src/models/invalidatebyurlsresponse.ts

@@ -0,0 +1,33 @@
+/*
+ * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+ * @generated-id: 786274723fd0
+ */
+
+import * as z from "zod";
+
+/**
+ * The result of invalidating derived assets by delivery URLs.
+ */
+export type InvalidateByUrlsResponse = {
+  cdn_invalidated?: boolean | undefined;
+  took?: number | undefined;
+  urls?: Array<string> | undefined;
+  unauthorized_urls?: Array<string> | undefined;
+};
+
+export const InvalidateByUrlsResponse$zodSchema: z.ZodType<
+  InvalidateByUrlsResponse
+> = z.object({
+  cdn_invalidated: z.boolean().optional().describe(
+    "Whether the assets were invalidated directly on the CDN.",
+  ),
+  took: z.number().optional().describe(
+    "The time the invalidation took, in seconds.",
+  ),
+  unauthorized_urls: z.array(z.string()).optional().describe(
+    "The delivery URLs that were skipped because the caller lacked update permission.",
+  ),
+  urls: z.array(z.string()).optional().describe(
+    "The delivery URLs that were invalidated.",
+  ),
+}).describe("The result of invalidating derived assets by delivery URLs.");

package/src/models/invalidatederivedbyurlsop.ts

@@ -0,0 +1,33 @@
+/*
+ * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+ * @generated-id: 697be3fe78bc
+ */
+
+import * as z from "zod";
+import { ApiError, ApiError$zodSchema } from "./apierror.js";
+import {
+  InvalidateByUrlsResponse,
+  InvalidateByUrlsResponse$zodSchema,
+} from "./invalidatebyurlsresponse.js";
+
+export type InvalidateDerivedByUrlsGlobals = {
+  cloud_name?: string | undefined;
+};
+
+export const InvalidateDerivedByUrlsGlobals$zodSchema: z.ZodType<
+  InvalidateDerivedByUrlsGlobals
+> = z.object({
+  cloud_name: z.string().describe("The cloud name of your product environment.")
+    .optional(),
+});
+
+export type InvalidateDerivedByUrlsResponse =
+  | ApiError
+  | InvalidateByUrlsResponse;
+
+export const InvalidateDerivedByUrlsResponse$zodSchema: z.ZodType<
+  InvalidateDerivedByUrlsResponse
+> = z.union([
+  ApiError$zodSchema,
+  InvalidateByUrlsResponse$zodSchema,
+]);

package/src/models/limits.ts

@@ -0,0 +1,18 @@
+/*
+ * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+ * @generated-id: eb60dcc8c8ce
+ */
+
+import * as z from "zod";
+import { AddonQuota, AddonQuota$zodSchema } from "./addonquota.js";
+
+/**
+ * Rate limit information for the account's add-on quotas.
+ */
+export type Limits = { addons_quota?: Array<AddonQuota> | undefined };
+
+export const Limits$zodSchema: z.ZodType<Limits> = z.object({
+  addons_quota: z.array(AddonQuota$zodSchema).optional().describe(
+    "Per-add-on quota usage for this account.",
+  ),
+}).describe("Rate limit information for the account's add-on quotas.");

package/src/models/listinitialbackupsop.ts

@@ -0,0 +1,45 @@
+/*
+ * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+ * @generated-id: 7c99a1eff522
+ */
+
+import * as z from "zod";
+import { ApiError, ApiError$zodSchema } from "./apierror.js";
+import {
+  InitialBackupListResponse,
+  InitialBackupListResponse$zodSchema,
+} from "./initialbackuplistresponse.js";
+
+export type ListInitialBackupsGlobals = { cloud_name?: string | undefined };
+
+export const ListInitialBackupsGlobals$zodSchema: z.ZodType<
+  ListInitialBackupsGlobals
+> = z.object({
+  cloud_name: z.string().describe("The cloud name of your product environment.")
+    .optional(),
+});
+
+export type ListInitialBackupsRequest = {
+  max_results?: number | undefined;
+  next_cursor?: string | undefined;
+};
+
+export const ListInitialBackupsRequest$zodSchema: z.ZodType<
+  ListInitialBackupsRequest
+> = z.object({
+  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(),
+});
+
+export type ListInitialBackupsResponse = InitialBackupListResponse | ApiError;
+
+export const ListInitialBackupsResponse$zodSchema: z.ZodType<
+  ListInitialBackupsResponse
+> = z.union([
+  InitialBackupListResponse$zodSchema,
+  ApiError$zodSchema,
+]);

package/src/models/listpeopleop.ts

@@ -13,15 +13,6 @@ import {
 } from "./peoplelistresponse.js";
 import { PersonStatus, PersonStatus$zodSchema } from "./personstatus.js";
 
-export type ListPeopleGlobals = { cloud_name?: string | undefined };
-
-export const ListPeopleGlobals$zodSchema: z.ZodType<ListPeopleGlobals> = z
-  .object({
-    cloud_name: z.string().describe(
-      "The cloud name of your product environment.",
-    ).optional(),
-  });
-
 /**
  * Filter by whether the person has been named. Default: all.
  */
@@ -64,6 +55,15 @@ export const ListPeopleSortBy$zodSchema = z.enum([
   "updated_at",
 ]).describe("The field to sort results by. Default: name (ascending).\n");
 
+export type ListPeopleGlobals = { cloud_name?: string | undefined };
+
+export const ListPeopleGlobals$zodSchema: z.ZodType<ListPeopleGlobals> = z
+  .object({
+    cloud_name: z.string().describe(
+      "The cloud name of your product environment.",
+    ).optional(),
+  });
+
 export type ListPeopleRequest = {
   max_results?: number | undefined;
   next_cursor?: string | undefined;

package/src/models/listresourcesbycontaineridop.ts

@@ -0,0 +1,61 @@
+/*
+ * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+ * @generated-id: 7926a5342ba5
+ */
+
+import * as z from "zod";
+import { ApiError, ApiError$zodSchema } from "./apierror.js";
+import {
+  ResourcesByContainerIdResponse,
+  ResourcesByContainerIdResponse$zodSchema,
+} from "./resourcesbycontaineridresponse.js";
+
+export type ListResourcesByContainerIdGlobals = {
+  cloud_name?: string | undefined;
+};
+
+export const ListResourcesByContainerIdGlobals$zodSchema: z.ZodType<
+  ListResourcesByContainerIdGlobals
+> = z.object({
+  cloud_name: z.string().describe("The cloud name of your product environment.")
+    .optional(),
+});
+
+export type ListResourcesByContainerIdRequest = {
+  container_id: string;
+  max_results?: number | undefined;
+  next_cursor?: string | undefined;
+  sort_by?: string | undefined;
+  fields?: string | undefined;
+};
+
+export const ListResourcesByContainerIdRequest$zodSchema: z.ZodType<
+  ListResourcesByContainerIdRequest
+> = z.object({
+  container_id: z.string().describe(
+    "The immutable identifier of the folder container whose assets are listed.",
+  ),
+  fields: z.string().describe(
+    "A comma-separated list of asset fields to include in each returned asset.",
+  ).optional(),
+  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(),
+  sort_by: z.string().describe(
+    "The field by which the assets are sorted. Default is \"uploaded_at\".",
+  ).optional(),
+});
+
+export type ListResourcesByContainerIdResponse =
+  | ResourcesByContainerIdResponse
+  | ApiError;
+
+export const ListResourcesByContainerIdResponse$zodSchema: z.ZodType<
+  ListResourcesByContainerIdResponse
+> = z.union([
+  ResourcesByContainerIdResponse$zodSchema,
+  ApiError$zodSchema,
+]);

package/src/models/managedassetreference.ts

@@ -0,0 +1,47 @@
+/*
+ * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+ * @generated-id: fc6cfda12670
+ */
+
+import * as z from "zod";
+import { ClosedEnum } from "../types/enums.js";
+
+/**
+ * Discriminator identifying this as a managed-asset reference.
+ */
+export const ManagedAssetReferenceSourceType = {
+  ManagedAsset: "managed_asset",
+} as const;
+/**
+ * Discriminator identifying this as a managed-asset reference.
+ */
+export type ManagedAssetReferenceSourceType = ClosedEnum<
+  typeof ManagedAssetReferenceSourceType
+>;
+
+export const ManagedAssetReferenceSourceType$zodSchema = z.enum([
+  "managed_asset",
+]).describe("Discriminator identifying this as a managed-asset reference.");
+
+/**
+ * A reference to a managed asset in the caller's product environment, by
+ *
+ * @remarks
+ * asset ID.
+ */
+export type ManagedAssetReference = {
+  source_type: ManagedAssetReferenceSourceType;
+  asset_id: string;
+};
+
+export const ManagedAssetReference$zodSchema: z.ZodType<ManagedAssetReference> =
+  z.object({
+    asset_id: z.string().describe(
+      "Cloudinary asset ID of the reference image. READ permission is enforced.",
+    ),
+    source_type: ManagedAssetReferenceSourceType$zodSchema.describe(
+      "Discriminator identifying this as a managed-asset reference.",
+    ),
+  }).describe(
+    "A reference to a managed asset in the caller's product environment, by\nasset ID.\n",
+  );

package/src/models/managedassetstorage.ts

@@ -0,0 +1,83 @@
+/*
+ * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+ * @generated-id: 6fd55dfd5f37
+ */
+
+import * as z from "zod";
+import { ClosedEnum } from "../types/enums.js";
+
+/**
+ * Discriminator identifying this as managed-asset storage.
+ */
+export const ManagedAssetStorageStorageType = {
+  ManagedAsset: "managed_asset",
+} as const;
+/**
+ * Discriminator identifying this as managed-asset storage.
+ */
+export type ManagedAssetStorageStorageType = ClosedEnum<
+  typeof ManagedAssetStorageStorageType
+>;
+
+export const ManagedAssetStorageStorageType$zodSchema = z.enum([
+  "managed_asset",
+]).describe("Discriminator identifying this as managed-asset storage.");
+
+/**
+ * Cloudinary resource type of the stored asset.
+ */
+export const ManagedAssetStorageResourceType = {
+  Image: "image",
+  Video: "video",
+  Raw: "raw",
+} as const;
+/**
+ * Cloudinary resource type of the stored asset.
+ */
+export type ManagedAssetStorageResourceType = ClosedEnum<
+  typeof ManagedAssetStorageResourceType
+>;
+
+export const ManagedAssetStorageResourceType$zodSchema = z.enum([
+  "image",
+  "video",
+  "raw",
+]).describe("Cloudinary resource type of the stored asset.");
+
+/**
+ * A generated asset stored as a permanent managed asset. Reference it in
+ *
+ * @remarks
+ * other Cloudinary APIs by `asset_id`, or by the
+ * `resource_type` / `type` / `public_id` triple.
+ */
+export type ManagedAssetStorage = {
+  storage_type: ManagedAssetStorageStorageType;
+  secure_url: string;
+  asset_id?: string | undefined;
+  public_id: string;
+  resource_type: ManagedAssetStorageResourceType;
+  type: string;
+  version: number;
+};
+
+export const ManagedAssetStorage$zodSchema: z.ZodType<ManagedAssetStorage> = z
+  .object({
+    asset_id: z.string().optional().describe(
+      "Cloudinary asset ID — a stable, globally-unique reference to the asset.",
+    ),
+    public_id: z.string().describe("Public ID of the stored asset."),
+    resource_type: ManagedAssetStorageResourceType$zodSchema.describe(
+      "Cloudinary resource type of the stored asset.",
+    ),
+    secure_url: z.string().describe("The URL to fetch the generated asset."),
+    storage_type: ManagedAssetStorageStorageType$zodSchema.describe(
+      "Discriminator identifying this as managed-asset storage.",
+    ),
+    type: z.string().describe(
+      "Cloudinary delivery type of the stored asset (e.g. `upload`, `private`, `authenticated`).",
+    ),
+    version: z.int().describe("Version of the stored asset."),
+  }).describe(
+    "A generated asset stored as a permanent managed asset. Reference it in\nother Cloudinary APIs by `asset_id`, or by the\n`resource_type` / `type` / `public_id` triple.\n",
+  );

package/src/models/managedassettarget.ts

@@ -0,0 +1,48 @@
+/*
+ * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+ * @generated-id: 7134de2f0583
+ */
+
+import * as z from "zod";
+import { ClosedEnum } from "../types/enums.js";
+
+/**
+ * Discriminator identifying this as a managed-asset target.
+ */
+export const ManagedAssetTargetTargetType = {
+  ManagedAsset: "managed_asset",
+} as const;
+/**
+ * Discriminator identifying this as a managed-asset target.
+ */
+export type ManagedAssetTargetTargetType = ClosedEnum<
+  typeof ManagedAssetTargetTargetType
+>;
+
+export const ManagedAssetTargetTargetType$zodSchema = z.enum([
+  "managed_asset",
+]).describe("Discriminator identifying this as a managed-asset target.");
+
+/**
+ * Store the output as a permanent managed asset in your Cloudinary product environment (the default).
+ */
+export type ManagedAssetTarget = {
+  target_type: ManagedAssetTargetTargetType;
+  public_id?: string | undefined;
+  upload_preset?: string | undefined;
+};
+
+export const ManagedAssetTarget$zodSchema: z.ZodType<ManagedAssetTarget> = z
+  .object({
+    public_id: z.string().optional().describe(
+      "Public ID to store the asset under. Auto-assigned when omitted.",
+    ),
+    target_type: ManagedAssetTargetTargetType$zodSchema.describe(
+      "Discriminator identifying this as a managed-asset target.",
+    ),
+    upload_preset: z.string().optional().describe(
+      "Upload preset to apply. Uses the product environment's default when omitted.",
+    ),
+  }).describe(
+    "Store the output as a permanent managed asset in your Cloudinary product environment (the default).",
+  );

package/src/models/model.ts

@@ -0,0 +1,17 @@
+/*
+ * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+ * @generated-id: b99d4c14e794
+ */
+
+import * as z from "zod";
+
+/**
+ * Identifies the model that produced a generation result.
+ */
+export type Model = { family: string; tier: string; id: string };
+
+export const Model$zodSchema: z.ZodType<Model> = z.object({
+  family: z.string().describe("The model family used."),
+  id: z.string().describe("The exact model identifier used for generation."),
+  tier: z.string().describe("The quality tier used."),
+}).describe("Identifies the model that produced a generation result.");

package/src/models/modelbyfamily.ts

@@ -0,0 +1,84 @@
+/*
+ * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+ * @generated-id: 6af9ea6fe52b
+ */
+
+import * as z from "zod";
+import { ClosedEnum } from "../types/enums.js";
+
+/**
+ * Model family:
+ *
+ * @remarks
+ * * `flux`: Photorealistic images (FLUX.2 Klein 9B / FLUX.2 Pro).
+ * * `recraft`: Vector and illustration (Recraft V3 / Recraft V4).
+ * * `gpt-image`: Campaign and marketing images (GPT Image 1 Mini / GPT Image 2).
+ * * `nano-banana`: General purpose generation (Nano Banana 1 / Nano Banana 2).
+ * * `ideogram`: Realism, text rendering, and artistic generation (Ideogram V4).
+ */
+export const Family = {
+  Flux: "flux",
+  Recraft: "recraft",
+  GptImage: "gpt-image",
+  NanoBanana: "nano-banana",
+  Ideogram: "ideogram",
+} as const;
+/**
+ * Model family:
+ *
+ * @remarks
+ * * `flux`: Photorealistic images (FLUX.2 Klein 9B / FLUX.2 Pro).
+ * * `recraft`: Vector and illustration (Recraft V3 / Recraft V4).
+ * * `gpt-image`: Campaign and marketing images (GPT Image 1 Mini / GPT Image 2).
+ * * `nano-banana`: General purpose generation (Nano Banana 1 / Nano Banana 2).
+ * * `ideogram`: Realism, text rendering, and artistic generation (Ideogram V4).
+ */
+export type Family = ClosedEnum<typeof Family>;
+
+export const Family$zodSchema = z.enum([
+  "flux",
+  "recraft",
+  "gpt-image",
+  "nano-banana",
+  "ideogram",
+]).describe(
+  "Model family:\n* `flux`: Photorealistic images (FLUX.2 Klein 9B / FLUX.2 Pro).\n* `recraft`: Vector and illustration (Recraft V3 / Recraft V4).\n* `gpt-image`: Campaign and marketing images (GPT Image 1 Mini / GPT Image 2).\n* `nano-banana`: General purpose generation (Nano Banana 1 / Nano Banana 2).\n* `ideogram`: Realism, text rendering, and artistic generation (Ideogram V4).\n",
+);
+
+/**
+ * Quality tier within the family. Defaults to `standard` when omitted.
+ */
+export const Tier = {
+  Standard: "standard",
+  Premium: "premium",
+} as const;
+/**
+ * Quality tier within the family. Defaults to `standard` when omitted.
+ */
+export type Tier = ClosedEnum<typeof Tier>;
+
+export const Tier$zodSchema = z.enum([
+  "standard",
+  "premium",
+]).describe(
+  "Quality tier within the family. Defaults to `standard` when omitted.",
+);
+
+/**
+ * Select a model by family and quality tier; a missing `tier` defaults to
+ *
+ * @remarks
+ * `standard`.
+ */
+export type ModelByFamily = { family: Family; tier?: Tier | undefined };
+
+export const ModelByFamily$zodSchema: z.ZodType<ModelByFamily> = z.object({
+  family: Family$zodSchema.describe(
+    "Model family:\n* `flux`: Photorealistic images (FLUX.2 Klein 9B / FLUX.2 Pro).\n* `recraft`: Vector and illustration (Recraft V3 / Recraft V4).\n* `gpt-image`: Campaign and marketing images (GPT Image 1 Mini / GPT Image 2).\n* `nano-banana`: General purpose generation (Nano Banana 1 / Nano Banana 2).\n* `ideogram`: Realism, text rendering, and artistic generation (Ideogram V4).\n",
+  ),
+  tier: Tier$zodSchema.optional().describe(
+    "Quality tier within the family. Defaults to `standard` when omitted.",
+  ),
+}).describe(
+  "Select a model by family and quality tier; a missing `tier` defaults to\n`standard`.\n",
+);

package/src/models/modelbyid.ts

@@ -0,0 +1,75 @@
+/*
+ * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+ * @generated-id: 55f0cd308347
+ */
+
+import * as z from "zod";
+import { ClosedEnum } from "../types/enums.js";
+
+/**
+ * Exact model identifier; overrides family/tier when provided. The
+ *
+ * @remarks
+ * `-edit` models accept reference images and are selectable only on
+ * `image_to_image`; the others only on `text_to_image`.
+ */
+export const Id = {
+  NanoBanana1: "nano-banana-1",
+  NanoBanana2: "nano-banana-2",
+  Flux2Klein9b: "flux-2-klein-9b",
+  Flux2Pro: "flux-2-pro",
+  RecraftV3: "recraft-v3",
+  RecraftV4: "recraft-v4",
+  GptImage1Mini: "gpt-image-1-mini",
+  GptImage2: "gpt-image-2",
+  IdeogramV4Base: "ideogram-v4-base",
+  IdeogramV4Turbo: "ideogram-v4-turbo",
+  NanoBanana1Edit: "nano-banana-1-edit",
+  NanoBanana2Edit: "nano-banana-2-edit",
+  Flux2Klein9bEdit: "flux-2-klein-9b-edit",
+  Flux2ProEdit: "flux-2-pro-edit",
+  RecraftV3Edit: "recraft-v3-edit",
+  GptImage1MiniEdit: "gpt-image-1-mini-edit",
+  GptImage2Edit: "gpt-image-2-edit",
+} as const;
+/**
+ * Exact model identifier; overrides family/tier when provided. The
+ *
+ * @remarks
+ * `-edit` models accept reference images and are selectable only on
+ * `image_to_image`; the others only on `text_to_image`.
+ */
+export type Id = ClosedEnum<typeof Id>;
+
+export const Id$zodSchema = z.enum([
+  "nano-banana-1",
+  "nano-banana-2",
+  "flux-2-klein-9b",
+  "flux-2-pro",
+  "recraft-v3",
+  "recraft-v4",
+  "gpt-image-1-mini",
+  "gpt-image-2",
+  "ideogram-v4-base",
+  "ideogram-v4-turbo",
+  "nano-banana-1-edit",
+  "nano-banana-2-edit",
+  "flux-2-klein-9b-edit",
+  "flux-2-pro-edit",
+  "recraft-v3-edit",
+  "gpt-image-1-mini-edit",
+  "gpt-image-2-edit",
+]).describe(
+  "Exact model identifier; overrides family/tier when provided. The\n`-edit` models accept reference images and are selectable only on\n`image_to_image`; the others only on `text_to_image`.\n",
+);
+
+/**
+ * Pin an exact model by ID, bypassing family/tier.
+ */
+export type ModelById = { id: Id };
+
+export const ModelById$zodSchema: z.ZodType<ModelById> = z.object({
+  id: Id$zodSchema.describe(
+    "Exact model identifier; overrides family/tier when provided. The\n`-edit` models accept reference images and are selectable only on\n`image_to_image`; the others only on `text_to_image`.\n",
+  ),
+}).describe("Pin an exact model by ID, bypassing family/tier.");

package/src/models/modelselection.ts

@@ -0,0 +1,26 @@
+/*
+ * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+ * @generated-id: dc910f56e90b
+ */
+
+import * as z from "zod";
+import { ModelByFamily, ModelByFamily$zodSchema } from "./modelbyfamily.js";
+import { ModelById, ModelById$zodSchema } from "./modelbyid.js";
+
+/**
+ * Selects the model, in one of two mutually exclusive forms (omit to use
+ *
+ * @remarks
+ * the global default):
+ *   * `ModelByFamily`: `family` (+ optional `tier`); the stable-over-time
+ *     selector.
+ *   * `ModelById`: an explicit `id`, pinning one exact model.
+ */
+export type ModelSelection = ModelByFamily | ModelById;
+
+export const ModelSelection$zodSchema: z.ZodType<ModelSelection> = z.union([
+  ModelByFamily$zodSchema,
+  ModelById$zodSchema,
+]).describe(
+  "Selects the model, in one of two mutually exclusive forms (omit to use\nthe global default):\n  * `ModelByFamily`: `family` (+ optional `tier`); the stable-over-time\n    selector.\n  * `ModelById`: an explicit `id`, pinning one exact model.\n",
+);