@shop-os/modelkit 0.8.0 → 0.9.0

package/dist/catalog.d.cts

@@ -69,6 +69,10 @@ type ModelType = "text" | "image" | "video" | "audio"
  | "lipsync"
 /** Speech to text (`transcribe`). */
  | "transcription"
+/** A reusable voice cloned from recordings (`createVoice`); its id feeds `SpeechRequest.customVoice`. */
+ | "voice-clone"
+/** Candidate voices from a description (`designVoice`); keep one with `createVoice`. */
+ | "voice-design"
 /** A prompt and/or photos of an object in, a GLB 3D model out. */
  | "model3d";
 /**
@@ -133,7 +137,7 @@ type Lifecycle = "active" | "deprecated" | "retired";
 type Surface = "cowork" | "space_builder";
 /** @deprecated use Surface[] */
 type Exposure = Surface[];
-type AdapterId = "ai-sdk-text" | "google-image" | "openai-image" | "google-genai" | "ark" | "fal" | "replicate" | "prodia" | "higgsfield" | "xai-video" | "luma";
+type AdapterId = "ai-sdk-text" | "google-image" | "openai-image" | "google-genai" | "ark" | "fal" | "replicate" | "prodia" | "higgsfield" | "xai-video" | "luma" | "fish";
 /** Gemini image safety threshold, per category, sent only when the caller opts in. */
 type ImageSafetySetting = {
     category: string;
@@ -427,6 +431,12 @@ interface SpeechRequest {
     text: string;
     /** One of `constraints.voices[].id`; the row default when unset. */
     voice?: string;
+    /**
+     * Rows with `capabilities.customVoices`: a voice id `createVoice` returned, used instead of
+     * `voice`. It belongs to the provider account of the key set that created it, so call with
+     * the same `tier`.
+     */
+    customVoice?: string;
     /** One of `constraints.languages[].code`; the provider detects it when unset. */
     language?: string;
     /** Rows with `supports: style`: how to speak it ("warm and slow"), kept out of the script. */
@@ -435,6 +445,65 @@ interface SpeechRequest {
     outputFormat?: string;
     abortSignal?: AbortSignal;
 }
+/** One recording a voice is cloned from. */
+interface VoiceSample {
+    /** Clean, single-speaker speech. Set `durationSeconds` so `constraints.references.audioSeconds` can be checked. */
+    audio: MediaRef;
+    /** The words spoken in `audio`; the provider transcribes the clip when unset. */
+    transcript?: string;
+    /** `VoiceCandidate.signature` when `audio` is a `designVoice` candidate. */
+    designSignature?: string;
+}
+/** `createVoice` on a `voice-clone` row: a private, reusable voice. */
+interface VoiceCloneRequest {
+    model: string;
+    /** The voice's name in the provider console. */
+    title: string;
+    samples: VoiceSample[];
+    description?: string;
+    /** Provider noise removal and level normalisation before cloning; the provider default (on) when unset. */
+    enhance?: boolean;
+    abortSignal?: AbortSignal;
+}
+type VoiceCloneState = "created" | "training" | "trained" | "failed";
+interface VoiceCloneResult {
+    /** Pass as `SpeechRequest.customVoice` on a row with `capabilities.customVoices`. */
+    voiceId: string;
+    /** `trained` means usable now; unset when the provider reports a state the kit does not know. */
+    state?: VoiceCloneState;
+    usage: UsageEvent;
+    raw?: JsonValue;
+}
+/** `designVoice` on a `voice-design` row: short candidate voices from a description. */
+interface VoiceDesignRequest {
+    model: string;
+    /** The voice: age, tone, accent, pacing, context. */
+    prompt: string;
+    /** A short line every candidate reads, so they can be compared. */
+    previewText?: string;
+    /** A language hint such as `en`. */
+    language?: string;
+    /** Candidates to return, within `constraints.voiceDesign.maxCandidates`; the row default when unset. */
+    count?: number;
+    seed?: number;
+    abortSignal?: AbortSignal;
+}
+interface VoiceCandidate {
+    audio: MediaOutput;
+    durationSeconds: number;
+    /** Send with this audio in `VoiceSample.designSignature` to keep the voice. */
+    signature: string;
+}
+interface VoiceDesignResult {
+    candidates: VoiceCandidate[];
+    usage: UsageEvent;
+}
+/** `deleteVoice` on the `voice-clone` row that created the voice, with the same `tier`. */
+interface VoiceDeleteRequest {
+    model: string;
+    voiceId: string;
+    abortSignal?: AbortSignal;
+}
 /** `changeVoice` on a `voice-change` row: the recording re-spoken in another voice. */
 interface VoiceChangeRequest {
     model: string;
@@ -670,6 +739,11 @@ interface ModelConstraints {
     ratioIgnoredWith?: ("firstFrame" | "sourceVideo")[];
     /** Speech and voice-change rows: the voices offered; `defaults.voice` is one of their ids. */
     voices?: VoiceOption[];
+    /** `voice-design` rows: how many candidates one call returns at most, and the preview line's length cap. */
+    voiceDesign?: {
+        maxCandidates: number;
+        previewMaxChars: number;
+    };
     /** Speech, transcription and dubbing (target) rows: the languages taken. */
     languages?: LanguageOption[];
     /** Audio-output rows whose provider lets the caller pick a file format; `defaults.outputFormat` is one. */
@@ -753,6 +827,8 @@ interface CatalogDisplay {
 interface CatalogCapabilities {
     /** Video rows: takes an existing video as the thing to edit or extend. */
     acceptsSourceVideo?: boolean;
+    /** Speech rows: take `SpeechRequest.customVoice`, a voice the same provider cloned. */
+    customVoices?: boolean;
     /**
      * Video rows: offered for prompt-driven edits of a source clip (`taskType: "edit"`). Absent
      * means the caller falls back to `acceptsSourceVideo`; `false` opts a row out.
@@ -901,7 +977,7 @@ interface UsageEvent {
     latencyMs?: number;
     raw?: unknown;
 }
-type ProviderKeyName = "openai" | "anthropic" | "google" | "xai" | "perplexity" | "deepseek" | "moonshot" | "minimax" | "ark" | "fal" | "replicate" | "prodia" | "higgsfield" | "luma" | "cloudflare";
+type ProviderKeyName = "openai" | "anthropic" | "google" | "xai" | "perplexity" | "deepseek" | "moonshot" | "minimax" | "ark" | "fal" | "replicate" | "prodia" | "higgsfield" | "luma" | "fish" | "cloudflare";
 type ProviderKeys = Partial<Record<ProviderKeyName, string>> & {
     /** Higgsfield needs the pair; both switch together. */
     higgsfieldSecret?: string;
@@ -952,6 +1028,8 @@ interface AdapterEndpoints {
     ark?: string;
     /** Luma Agents API. Defaults to https://agents.lumalabs.ai. */
     luma?: string;
+    /** Fish Audio API. Defaults to https://api.fish.audio. */
+    fish?: string;
 }
 interface ModelKitConfig {
     keys: {
@@ -1026,7 +1104,7 @@ declare function isListed(row: CatalogModel): boolean;
  */
 declare const MODELS: CatalogModel[];
 
-declare const ADAPTER_IDS: readonly ["ai-sdk-text", "google-image", "openai-image", "google-genai", "ark", "fal", "replicate", "prodia", "higgsfield", "xai-video", "luma"];
+declare const ADAPTER_IDS: readonly ["ai-sdk-text", "google-image", "openai-image", "google-genai", "ark", "fal", "replicate", "prodia", "higgsfield", "xai-video", "luma", "fish"];
 declare const SurfaceSchema: z.ZodEnum<{
     cowork: "cowork";
     space_builder: "space_builder";
@@ -1061,6 +1139,8 @@ declare const CatalogModelSchemaBase: z.ZodObject<{
         dubbing: "dubbing";
         lipsync: "lipsync";
         transcription: "transcription";
+        "voice-clone": "voice-clone";
+        "voice-design": "voice-design";
         model3d: "model3d";
     }>;
     adapter: z.ZodEnum<{
@@ -1075,6 +1155,7 @@ declare const CatalogModelSchemaBase: z.ZodObject<{
         higgsfield: "higgsfield";
         "xai-video": "xai-video";
         luma: "luma";
+        fish: "fish";
     }>;
     providerModelId: z.ZodString;
     lifecycle: z.ZodEnum<{
@@ -1208,6 +1289,10 @@ declare const CatalogModelSchemaBase: z.ZodObject<{
             description: z.ZodOptional<z.ZodString>;
             previewUrl: z.ZodOptional<z.ZodURL>;
         }, z.core.$loose>>>;
+        voiceDesign: z.ZodOptional<z.ZodObject<{
+            maxCandidates: z.ZodNumber;
+            previewMaxChars: z.ZodNumber;
+        }, z.core.$strip>>;
         languages: z.ZodOptional<z.ZodArray<z.ZodObject<{
             code: z.ZodString;
             name: z.ZodString;
@@ -1512,6 +1597,7 @@ declare const CatalogModelSchemaBase: z.ZodObject<{
     }, z.core.$loose>>;
     capabilities: z.ZodOptional<z.ZodObject<{
         acceptsSourceVideo: z.ZodOptional<z.ZodBoolean>;
+        customVoices: z.ZodOptional<z.ZodBoolean>;
         videoEdit: z.ZodOptional<z.ZodBoolean>;
         framesExcludeReferences: z.ZodOptional<z.ZodBoolean>;
         sourceVideoExcludesFrames: z.ZodOptional<z.ZodBoolean>;
@@ -1733,8 +1819,13 @@ declare function resolveDubbingOptions(model: CatalogModel, request: DubbingRequ
 /** `transcribe` on a `transcription` row. */
 declare function resolveTranscriptionOptions(model: CatalogModel, request: TranscriptionRequest, onUnsupported?: OnUnsupported): ResolveResult<TranscriptionRequest>;
 
+/** `createVoice` on a `voice-clone` row. */
+declare function resolveVoiceCloneOptions(model: CatalogModel, request: VoiceCloneRequest): ResolveResult<VoiceCloneRequest>;
+/** `designVoice` on a `voice-design` row; a count over the row cap is clamped when coercing. */
+declare function resolveVoiceDesignOptions(model: CatalogModel, request: VoiceDesignRequest, onUnsupported?: OnUnsupported): ResolveResult<VoiceDesignRequest>;
+
 /** The client methods that execute a catalog row (text rows run through the text helpers). */
-type MediaMethod = "generateImage" | "generateVideo" | "generateAudio" | "generateSpeech" | "changeVoice" | "lipsync" | "dub" | "transcribe" | "submitVideoTool";
+type MediaMethod = "generateImage" | "generateVideo" | "generateAudio" | "generateSpeech" | "changeVoice" | "lipsync" | "dub" | "transcribe" | "createVoice" | "designVoice" | "submitVideoTool";
 /** Typed as a full `Record` so a new `ModelType` does not compile until it is routed here. */
 declare const MEDIA_METHODS: Record<ModelType, readonly MediaMethod[]>;
 /** A request tagged with the client method it is meant for. */
@@ -1762,6 +1853,12 @@ type ResolveCall = {
 } | {
     method: "transcribe";
     request: TranscriptionRequest;
+} | {
+    method: "createVoice";
+    request: VoiceCloneRequest;
+} | {
+    method: "designVoice";
+    request: VoiceDesignRequest;
 } | {
     method: "submitVideoTool";
     request: VideoToolRequest;
@@ -1798,6 +1895,14 @@ type ResolvedCall = {
     method: "transcribe";
     request: TranscriptionRequest;
     warnings: Warning[];
+} | {
+    method: "createVoice";
+    request: VoiceCloneRequest;
+    warnings: Warning[];
+} | {
+    method: "designVoice";
+    request: VoiceDesignRequest;
+    warnings: Warning[];
 } | {
     method: "submitVideoTool";
     request: VideoToolRequest;
@@ -1829,4 +1934,4 @@ declare function promptConventions(row: {
     constraints: unknown;
 }): PromptConventions;
 
-export { ADAPTER_IDS, AUDIO_OUTPUTS, type AdapterEndpoints, type AdapterId, type AspectRatio, type AudioOutput, type AudioRequest, type AudioResult, type CallContext, Catalog, type CatalogAuth, type CatalogCache, type CatalogCapabilities, type CatalogDisplay, type CatalogEnvelope, type CatalogModel, CatalogModelSchema, CatalogModelSchemaBase, type CatalogOrigin, CatalogSchema, type CatalogSource, type DubbingRequest, type DubbingResult, type Exposure, ExposureSchema, type GeneratedImage, IMAGE_MODELS, type ImageBytes, type ImageCallOptions, type ImageCallResult, type ImageQuality, type ImageRequest, type ImageResult, type ImageSafetySetting, type ImageSize, type JsonObject, type JsonPrimitive, type JsonValue, type KeyTier, type LanguageOption, type Lifecycle, type LipsyncRequest, type LipsyncResult, type LiveCatalogState, MEDIA_METHODS, MEDIA_NODE_MODELS, MODEL3D_IMAGE_SLOTS, MODEL3D_MODELS, MODELS, type MaskBox, type MaskPoint, type MediaMethod, type MediaNodeDefaults, type MediaOutput, type MediaPart, type MediaRef, type Model3dConstraints, type Model3dEndpoints, type Model3dFamily, type Model3dInputRefusal, type Model3dPricedInputs, type Model3dPricedOptions, type Model3dRequest, type Model3dResult, type Model3dStatus, type Model3dSubmission, type Model3dTexture, type Model3dViews, type Model3dWired, type ModelConstraints, type ModelKitConfig, ModelKitError, type ModelKitErrorCode, type ModelKitErrorInit, type ModelType, OTHER_MODELS, type OnUnsupported, type OutputFormat, type PricingKind, type PrimeCatalogResult, type PromptConventions, type ProviderErrorBody, type ProviderKeyName, type ProviderKeys, type ProviderOptionValue, type ProviderOptions, type QuarantineResult, REFERENCE_SYNTAXES, type ReferenceLimits, type ReferenceSyntax, type RequiredInput, type RequiredKeyName, type ResolveCall, type ResolveResult, type ResolvedCall, type Routing, SURFACES, type SpeechRequest, type SubtitleOptions, type SubtitleTextStyle, type SupportedOption, type Surface, SurfaceSchema, TEXT_MODELS, type TranscriptWord, type TranscriptionRequest, type TranscriptionResult, type UpscaleOptions, type UsageEvent, type UsageModality, type UsageUnit, VIDEO_MODELS, VIDEO_TOOL_MODELS, type VideoCallJob, type VideoCallOptions, type VideoJob, type VideoModel, type VideoRequest, type VideoResolution, VideoResolutionSchema, type VideoResult, type VideoSecondsLimits, type VideoToolCallContext, type VideoToolConstraints, type VideoToolKind, type VideoToolOutputFormat, type VideoToolOutputSpec, type VideoToolPlan, type VideoToolRequest, type VideoToolResult, type VideoToolSource, type VideoToolStatus, type VideoToolSubmission, type VoiceChangeRequest, type VoiceGender, type VoiceOption, type Warning, billedAudio, compareCatalogOrder, hasAwsCredentials, isListed, isListedOn, isModelKitError, liveCatalog, liveState, lumaReframeTooTall, model3dConstraints, model3dInputRefusal, model3dPricingSku, model3dResolution, model3dSeedFits, model3dSkus, model3dTexture, nearestAspectRatio, normalizeExposure, outputAudio, planVideoTool, primeCatalog, promptConventions, resetLiveCatalog, resolutionTier, resolveAudioOptions, resolveDubbingOptions, resolveImageOptions, resolveLipsyncOptions, resolveOptions, resolveSpeechOptions, resolveTranscriptionOptions, resolveVideoOptions, resolveVoiceChangeOptions, sortCatalogRows, takesTargetAspectRatio, videoLengthViolation, videoToolConstraints };
+export { ADAPTER_IDS, AUDIO_OUTPUTS, type AdapterEndpoints, type AdapterId, type AspectRatio, type AudioOutput, type AudioRequest, type AudioResult, type CallContext, Catalog, type CatalogAuth, type CatalogCache, type CatalogCapabilities, type CatalogDisplay, type CatalogEnvelope, type CatalogModel, CatalogModelSchema, CatalogModelSchemaBase, type CatalogOrigin, CatalogSchema, type CatalogSource, type DubbingRequest, type DubbingResult, type Exposure, ExposureSchema, type GeneratedImage, IMAGE_MODELS, type ImageBytes, type ImageCallOptions, type ImageCallResult, type ImageQuality, type ImageRequest, type ImageResult, type ImageSafetySetting, type ImageSize, type JsonObject, type JsonPrimitive, type JsonValue, type KeyTier, type LanguageOption, type Lifecycle, type LipsyncRequest, type LipsyncResult, type LiveCatalogState, MEDIA_METHODS, MEDIA_NODE_MODELS, MODEL3D_IMAGE_SLOTS, MODEL3D_MODELS, MODELS, type MaskBox, type MaskPoint, type MediaMethod, type MediaNodeDefaults, type MediaOutput, type MediaPart, type MediaRef, type Model3dConstraints, type Model3dEndpoints, type Model3dFamily, type Model3dInputRefusal, type Model3dPricedInputs, type Model3dPricedOptions, type Model3dRequest, type Model3dResult, type Model3dStatus, type Model3dSubmission, type Model3dTexture, type Model3dViews, type Model3dWired, type ModelConstraints, type ModelKitConfig, ModelKitError, type ModelKitErrorCode, type ModelKitErrorInit, type ModelType, OTHER_MODELS, type OnUnsupported, type OutputFormat, type PricingKind, type PrimeCatalogResult, type PromptConventions, type ProviderErrorBody, type ProviderKeyName, type ProviderKeys, type ProviderOptionValue, type ProviderOptions, type QuarantineResult, REFERENCE_SYNTAXES, type ReferenceLimits, type ReferenceSyntax, type RequiredInput, type RequiredKeyName, type ResolveCall, type ResolveResult, type ResolvedCall, type Routing, SURFACES, type SpeechRequest, type SubtitleOptions, type SubtitleTextStyle, type SupportedOption, type Surface, SurfaceSchema, TEXT_MODELS, type TranscriptWord, type TranscriptionRequest, type TranscriptionResult, type UpscaleOptions, type UsageEvent, type UsageModality, type UsageUnit, VIDEO_MODELS, VIDEO_TOOL_MODELS, type VideoCallJob, type VideoCallOptions, type VideoJob, type VideoModel, type VideoRequest, type VideoResolution, VideoResolutionSchema, type VideoResult, type VideoSecondsLimits, type VideoToolCallContext, type VideoToolConstraints, type VideoToolKind, type VideoToolOutputFormat, type VideoToolOutputSpec, type VideoToolPlan, type VideoToolRequest, type VideoToolResult, type VideoToolSource, type VideoToolStatus, type VideoToolSubmission, type VoiceCandidate, type VoiceChangeRequest, type VoiceCloneRequest, type VoiceCloneResult, type VoiceCloneState, type VoiceDeleteRequest, type VoiceDesignRequest, type VoiceDesignResult, type VoiceGender, type VoiceOption, type VoiceSample, type Warning, billedAudio, compareCatalogOrder, hasAwsCredentials, isListed, isListedOn, isModelKitError, liveCatalog, liveState, lumaReframeTooTall, model3dConstraints, model3dInputRefusal, model3dPricingSku, model3dResolution, model3dSeedFits, model3dSkus, model3dTexture, nearestAspectRatio, normalizeExposure, outputAudio, planVideoTool, primeCatalog, promptConventions, resetLiveCatalog, resolutionTier, resolveAudioOptions, resolveDubbingOptions, resolveImageOptions, resolveLipsyncOptions, resolveOptions, resolveSpeechOptions, resolveTranscriptionOptions, resolveVideoOptions, resolveVoiceChangeOptions, resolveVoiceCloneOptions, resolveVoiceDesignOptions, sortCatalogRows, takesTargetAspectRatio, videoLengthViolation, videoToolConstraints };

package/dist/catalog.d.ts

@@ -69,6 +69,10 @@ type ModelType = "text" | "image" | "video" | "audio"
  | "lipsync"
 /** Speech to text (`transcribe`). */
  | "transcription"
+/** A reusable voice cloned from recordings (`createVoice`); its id feeds `SpeechRequest.customVoice`. */
+ | "voice-clone"
+/** Candidate voices from a description (`designVoice`); keep one with `createVoice`. */
+ | "voice-design"
 /** A prompt and/or photos of an object in, a GLB 3D model out. */
  | "model3d";
 /**
@@ -133,7 +137,7 @@ type Lifecycle = "active" | "deprecated" | "retired";
 type Surface = "cowork" | "space_builder";
 /** @deprecated use Surface[] */
 type Exposure = Surface[];
-type AdapterId = "ai-sdk-text" | "google-image" | "openai-image" | "google-genai" | "ark" | "fal" | "replicate" | "prodia" | "higgsfield" | "xai-video" | "luma";
+type AdapterId = "ai-sdk-text" | "google-image" | "openai-image" | "google-genai" | "ark" | "fal" | "replicate" | "prodia" | "higgsfield" | "xai-video" | "luma" | "fish";
 /** Gemini image safety threshold, per category, sent only when the caller opts in. */
 type ImageSafetySetting = {
     category: string;
@@ -427,6 +431,12 @@ interface SpeechRequest {
     text: string;
     /** One of `constraints.voices[].id`; the row default when unset. */
     voice?: string;
+    /**
+     * Rows with `capabilities.customVoices`: a voice id `createVoice` returned, used instead of
+     * `voice`. It belongs to the provider account of the key set that created it, so call with
+     * the same `tier`.
+     */
+    customVoice?: string;
     /** One of `constraints.languages[].code`; the provider detects it when unset. */
     language?: string;
     /** Rows with `supports: style`: how to speak it ("warm and slow"), kept out of the script. */
@@ -435,6 +445,65 @@ interface SpeechRequest {
     outputFormat?: string;
     abortSignal?: AbortSignal;
 }
+/** One recording a voice is cloned from. */
+interface VoiceSample {
+    /** Clean, single-speaker speech. Set `durationSeconds` so `constraints.references.audioSeconds` can be checked. */
+    audio: MediaRef;
+    /** The words spoken in `audio`; the provider transcribes the clip when unset. */
+    transcript?: string;
+    /** `VoiceCandidate.signature` when `audio` is a `designVoice` candidate. */
+    designSignature?: string;
+}
+/** `createVoice` on a `voice-clone` row: a private, reusable voice. */
+interface VoiceCloneRequest {
+    model: string;
+    /** The voice's name in the provider console. */
+    title: string;
+    samples: VoiceSample[];
+    description?: string;
+    /** Provider noise removal and level normalisation before cloning; the provider default (on) when unset. */
+    enhance?: boolean;
+    abortSignal?: AbortSignal;
+}
+type VoiceCloneState = "created" | "training" | "trained" | "failed";
+interface VoiceCloneResult {
+    /** Pass as `SpeechRequest.customVoice` on a row with `capabilities.customVoices`. */
+    voiceId: string;
+    /** `trained` means usable now; unset when the provider reports a state the kit does not know. */
+    state?: VoiceCloneState;
+    usage: UsageEvent;
+    raw?: JsonValue;
+}
+/** `designVoice` on a `voice-design` row: short candidate voices from a description. */
+interface VoiceDesignRequest {
+    model: string;
+    /** The voice: age, tone, accent, pacing, context. */
+    prompt: string;
+    /** A short line every candidate reads, so they can be compared. */
+    previewText?: string;
+    /** A language hint such as `en`. */
+    language?: string;
+    /** Candidates to return, within `constraints.voiceDesign.maxCandidates`; the row default when unset. */
+    count?: number;
+    seed?: number;
+    abortSignal?: AbortSignal;
+}
+interface VoiceCandidate {
+    audio: MediaOutput;
+    durationSeconds: number;
+    /** Send with this audio in `VoiceSample.designSignature` to keep the voice. */
+    signature: string;
+}
+interface VoiceDesignResult {
+    candidates: VoiceCandidate[];
+    usage: UsageEvent;
+}
+/** `deleteVoice` on the `voice-clone` row that created the voice, with the same `tier`. */
+interface VoiceDeleteRequest {
+    model: string;
+    voiceId: string;
+    abortSignal?: AbortSignal;
+}
 /** `changeVoice` on a `voice-change` row: the recording re-spoken in another voice. */
 interface VoiceChangeRequest {
     model: string;
@@ -670,6 +739,11 @@ interface ModelConstraints {
     ratioIgnoredWith?: ("firstFrame" | "sourceVideo")[];
     /** Speech and voice-change rows: the voices offered; `defaults.voice` is one of their ids. */
     voices?: VoiceOption[];
+    /** `voice-design` rows: how many candidates one call returns at most, and the preview line's length cap. */
+    voiceDesign?: {
+        maxCandidates: number;
+        previewMaxChars: number;
+    };
     /** Speech, transcription and dubbing (target) rows: the languages taken. */
     languages?: LanguageOption[];
     /** Audio-output rows whose provider lets the caller pick a file format; `defaults.outputFormat` is one. */
@@ -753,6 +827,8 @@ interface CatalogDisplay {
 interface CatalogCapabilities {
     /** Video rows: takes an existing video as the thing to edit or extend. */
     acceptsSourceVideo?: boolean;
+    /** Speech rows: take `SpeechRequest.customVoice`, a voice the same provider cloned. */
+    customVoices?: boolean;
     /**
      * Video rows: offered for prompt-driven edits of a source clip (`taskType: "edit"`). Absent
      * means the caller falls back to `acceptsSourceVideo`; `false` opts a row out.
@@ -901,7 +977,7 @@ interface UsageEvent {
     latencyMs?: number;
     raw?: unknown;
 }
-type ProviderKeyName = "openai" | "anthropic" | "google" | "xai" | "perplexity" | "deepseek" | "moonshot" | "minimax" | "ark" | "fal" | "replicate" | "prodia" | "higgsfield" | "luma" | "cloudflare";
+type ProviderKeyName = "openai" | "anthropic" | "google" | "xai" | "perplexity" | "deepseek" | "moonshot" | "minimax" | "ark" | "fal" | "replicate" | "prodia" | "higgsfield" | "luma" | "fish" | "cloudflare";
 type ProviderKeys = Partial<Record<ProviderKeyName, string>> & {
     /** Higgsfield needs the pair; both switch together. */
     higgsfieldSecret?: string;
@@ -952,6 +1028,8 @@ interface AdapterEndpoints {
     ark?: string;
     /** Luma Agents API. Defaults to https://agents.lumalabs.ai. */
     luma?: string;
+    /** Fish Audio API. Defaults to https://api.fish.audio. */
+    fish?: string;
 }
 interface ModelKitConfig {
     keys: {
@@ -1026,7 +1104,7 @@ declare function isListed(row: CatalogModel): boolean;
  */
 declare const MODELS: CatalogModel[];
 
-declare const ADAPTER_IDS: readonly ["ai-sdk-text", "google-image", "openai-image", "google-genai", "ark", "fal", "replicate", "prodia", "higgsfield", "xai-video", "luma"];
+declare const ADAPTER_IDS: readonly ["ai-sdk-text", "google-image", "openai-image", "google-genai", "ark", "fal", "replicate", "prodia", "higgsfield", "xai-video", "luma", "fish"];
 declare const SurfaceSchema: z.ZodEnum<{
     cowork: "cowork";
     space_builder: "space_builder";
@@ -1061,6 +1139,8 @@ declare const CatalogModelSchemaBase: z.ZodObject<{
         dubbing: "dubbing";
         lipsync: "lipsync";
         transcription: "transcription";
+        "voice-clone": "voice-clone";
+        "voice-design": "voice-design";
         model3d: "model3d";
     }>;
     adapter: z.ZodEnum<{
@@ -1075,6 +1155,7 @@ declare const CatalogModelSchemaBase: z.ZodObject<{
         higgsfield: "higgsfield";
         "xai-video": "xai-video";
         luma: "luma";
+        fish: "fish";
     }>;
     providerModelId: z.ZodString;
     lifecycle: z.ZodEnum<{
@@ -1208,6 +1289,10 @@ declare const CatalogModelSchemaBase: z.ZodObject<{
             description: z.ZodOptional<z.ZodString>;
             previewUrl: z.ZodOptional<z.ZodURL>;
         }, z.core.$loose>>>;
+        voiceDesign: z.ZodOptional<z.ZodObject<{
+            maxCandidates: z.ZodNumber;
+            previewMaxChars: z.ZodNumber;
+        }, z.core.$strip>>;
         languages: z.ZodOptional<z.ZodArray<z.ZodObject<{
             code: z.ZodString;
             name: z.ZodString;
@@ -1512,6 +1597,7 @@ declare const CatalogModelSchemaBase: z.ZodObject<{
     }, z.core.$loose>>;
     capabilities: z.ZodOptional<z.ZodObject<{
         acceptsSourceVideo: z.ZodOptional<z.ZodBoolean>;
+        customVoices: z.ZodOptional<z.ZodBoolean>;
         videoEdit: z.ZodOptional<z.ZodBoolean>;
         framesExcludeReferences: z.ZodOptional<z.ZodBoolean>;
         sourceVideoExcludesFrames: z.ZodOptional<z.ZodBoolean>;
@@ -1733,8 +1819,13 @@ declare function resolveDubbingOptions(model: CatalogModel, request: DubbingRequ
 /** `transcribe` on a `transcription` row. */
 declare function resolveTranscriptionOptions(model: CatalogModel, request: TranscriptionRequest, onUnsupported?: OnUnsupported): ResolveResult<TranscriptionRequest>;
 
+/** `createVoice` on a `voice-clone` row. */
+declare function resolveVoiceCloneOptions(model: CatalogModel, request: VoiceCloneRequest): ResolveResult<VoiceCloneRequest>;
+/** `designVoice` on a `voice-design` row; a count over the row cap is clamped when coercing. */
+declare function resolveVoiceDesignOptions(model: CatalogModel, request: VoiceDesignRequest, onUnsupported?: OnUnsupported): ResolveResult<VoiceDesignRequest>;
+
 /** The client methods that execute a catalog row (text rows run through the text helpers). */
-type MediaMethod = "generateImage" | "generateVideo" | "generateAudio" | "generateSpeech" | "changeVoice" | "lipsync" | "dub" | "transcribe" | "submitVideoTool";
+type MediaMethod = "generateImage" | "generateVideo" | "generateAudio" | "generateSpeech" | "changeVoice" | "lipsync" | "dub" | "transcribe" | "createVoice" | "designVoice" | "submitVideoTool";
 /** Typed as a full `Record` so a new `ModelType` does not compile until it is routed here. */
 declare const MEDIA_METHODS: Record<ModelType, readonly MediaMethod[]>;
 /** A request tagged with the client method it is meant for. */
@@ -1762,6 +1853,12 @@ type ResolveCall = {
 } | {
     method: "transcribe";
     request: TranscriptionRequest;
+} | {
+    method: "createVoice";
+    request: VoiceCloneRequest;
+} | {
+    method: "designVoice";
+    request: VoiceDesignRequest;
 } | {
     method: "submitVideoTool";
     request: VideoToolRequest;
@@ -1798,6 +1895,14 @@ type ResolvedCall = {
     method: "transcribe";
     request: TranscriptionRequest;
     warnings: Warning[];
+} | {
+    method: "createVoice";
+    request: VoiceCloneRequest;
+    warnings: Warning[];
+} | {
+    method: "designVoice";
+    request: VoiceDesignRequest;
+    warnings: Warning[];
 } | {
     method: "submitVideoTool";
     request: VideoToolRequest;
@@ -1829,4 +1934,4 @@ declare function promptConventions(row: {
     constraints: unknown;
 }): PromptConventions;
 
-export { ADAPTER_IDS, AUDIO_OUTPUTS, type AdapterEndpoints, type AdapterId, type AspectRatio, type AudioOutput, type AudioRequest, type AudioResult, type CallContext, Catalog, type CatalogAuth, type CatalogCache, type CatalogCapabilities, type CatalogDisplay, type CatalogEnvelope, type CatalogModel, CatalogModelSchema, CatalogModelSchemaBase, type CatalogOrigin, CatalogSchema, type CatalogSource, type DubbingRequest, type DubbingResult, type Exposure, ExposureSchema, type GeneratedImage, IMAGE_MODELS, type ImageBytes, type ImageCallOptions, type ImageCallResult, type ImageQuality, type ImageRequest, type ImageResult, type ImageSafetySetting, type ImageSize, type JsonObject, type JsonPrimitive, type JsonValue, type KeyTier, type LanguageOption, type Lifecycle, type LipsyncRequest, type LipsyncResult, type LiveCatalogState, MEDIA_METHODS, MEDIA_NODE_MODELS, MODEL3D_IMAGE_SLOTS, MODEL3D_MODELS, MODELS, type MaskBox, type MaskPoint, type MediaMethod, type MediaNodeDefaults, type MediaOutput, type MediaPart, type MediaRef, type Model3dConstraints, type Model3dEndpoints, type Model3dFamily, type Model3dInputRefusal, type Model3dPricedInputs, type Model3dPricedOptions, type Model3dRequest, type Model3dResult, type Model3dStatus, type Model3dSubmission, type Model3dTexture, type Model3dViews, type Model3dWired, type ModelConstraints, type ModelKitConfig, ModelKitError, type ModelKitErrorCode, type ModelKitErrorInit, type ModelType, OTHER_MODELS, type OnUnsupported, type OutputFormat, type PricingKind, type PrimeCatalogResult, type PromptConventions, type ProviderErrorBody, type ProviderKeyName, type ProviderKeys, type ProviderOptionValue, type ProviderOptions, type QuarantineResult, REFERENCE_SYNTAXES, type ReferenceLimits, type ReferenceSyntax, type RequiredInput, type RequiredKeyName, type ResolveCall, type ResolveResult, type ResolvedCall, type Routing, SURFACES, type SpeechRequest, type SubtitleOptions, type SubtitleTextStyle, type SupportedOption, type Surface, SurfaceSchema, TEXT_MODELS, type TranscriptWord, type TranscriptionRequest, type TranscriptionResult, type UpscaleOptions, type UsageEvent, type UsageModality, type UsageUnit, VIDEO_MODELS, VIDEO_TOOL_MODELS, type VideoCallJob, type VideoCallOptions, type VideoJob, type VideoModel, type VideoRequest, type VideoResolution, VideoResolutionSchema, type VideoResult, type VideoSecondsLimits, type VideoToolCallContext, type VideoToolConstraints, type VideoToolKind, type VideoToolOutputFormat, type VideoToolOutputSpec, type VideoToolPlan, type VideoToolRequest, type VideoToolResult, type VideoToolSource, type VideoToolStatus, type VideoToolSubmission, type VoiceChangeRequest, type VoiceGender, type VoiceOption, type Warning, billedAudio, compareCatalogOrder, hasAwsCredentials, isListed, isListedOn, isModelKitError, liveCatalog, liveState, lumaReframeTooTall, model3dConstraints, model3dInputRefusal, model3dPricingSku, model3dResolution, model3dSeedFits, model3dSkus, model3dTexture, nearestAspectRatio, normalizeExposure, outputAudio, planVideoTool, primeCatalog, promptConventions, resetLiveCatalog, resolutionTier, resolveAudioOptions, resolveDubbingOptions, resolveImageOptions, resolveLipsyncOptions, resolveOptions, resolveSpeechOptions, resolveTranscriptionOptions, resolveVideoOptions, resolveVoiceChangeOptions, sortCatalogRows, takesTargetAspectRatio, videoLengthViolation, videoToolConstraints };
+export { ADAPTER_IDS, AUDIO_OUTPUTS, type AdapterEndpoints, type AdapterId, type AspectRatio, type AudioOutput, type AudioRequest, type AudioResult, type CallContext, Catalog, type CatalogAuth, type CatalogCache, type CatalogCapabilities, type CatalogDisplay, type CatalogEnvelope, type CatalogModel, CatalogModelSchema, CatalogModelSchemaBase, type CatalogOrigin, CatalogSchema, type CatalogSource, type DubbingRequest, type DubbingResult, type Exposure, ExposureSchema, type GeneratedImage, IMAGE_MODELS, type ImageBytes, type ImageCallOptions, type ImageCallResult, type ImageQuality, type ImageRequest, type ImageResult, type ImageSafetySetting, type ImageSize, type JsonObject, type JsonPrimitive, type JsonValue, type KeyTier, type LanguageOption, type Lifecycle, type LipsyncRequest, type LipsyncResult, type LiveCatalogState, MEDIA_METHODS, MEDIA_NODE_MODELS, MODEL3D_IMAGE_SLOTS, MODEL3D_MODELS, MODELS, type MaskBox, type MaskPoint, type MediaMethod, type MediaNodeDefaults, type MediaOutput, type MediaPart, type MediaRef, type Model3dConstraints, type Model3dEndpoints, type Model3dFamily, type Model3dInputRefusal, type Model3dPricedInputs, type Model3dPricedOptions, type Model3dRequest, type Model3dResult, type Model3dStatus, type Model3dSubmission, type Model3dTexture, type Model3dViews, type Model3dWired, type ModelConstraints, type ModelKitConfig, ModelKitError, type ModelKitErrorCode, type ModelKitErrorInit, type ModelType, OTHER_MODELS, type OnUnsupported, type OutputFormat, type PricingKind, type PrimeCatalogResult, type PromptConventions, type ProviderErrorBody, type ProviderKeyName, type ProviderKeys, type ProviderOptionValue, type ProviderOptions, type QuarantineResult, REFERENCE_SYNTAXES, type ReferenceLimits, type ReferenceSyntax, type RequiredInput, type RequiredKeyName, type ResolveCall, type ResolveResult, type ResolvedCall, type Routing, SURFACES, type SpeechRequest, type SubtitleOptions, type SubtitleTextStyle, type SupportedOption, type Surface, SurfaceSchema, TEXT_MODELS, type TranscriptWord, type TranscriptionRequest, type TranscriptionResult, type UpscaleOptions, type UsageEvent, type UsageModality, type UsageUnit, VIDEO_MODELS, VIDEO_TOOL_MODELS, type VideoCallJob, type VideoCallOptions, type VideoJob, type VideoModel, type VideoRequest, type VideoResolution, VideoResolutionSchema, type VideoResult, type VideoSecondsLimits, type VideoToolCallContext, type VideoToolConstraints, type VideoToolKind, type VideoToolOutputFormat, type VideoToolOutputSpec, type VideoToolPlan, type VideoToolRequest, type VideoToolResult, type VideoToolSource, type VideoToolStatus, type VideoToolSubmission, type VoiceCandidate, type VoiceChangeRequest, type VoiceCloneRequest, type VoiceCloneResult, type VoiceCloneState, type VoiceDeleteRequest, type VoiceDesignRequest, type VoiceDesignResult, type VoiceGender, type VoiceOption, type VoiceSample, type Warning, billedAudio, compareCatalogOrder, hasAwsCredentials, isListed, isListedOn, isModelKitError, liveCatalog, liveState, lumaReframeTooTall, model3dConstraints, model3dInputRefusal, model3dPricingSku, model3dResolution, model3dSeedFits, model3dSkus, model3dTexture, nearestAspectRatio, normalizeExposure, outputAudio, planVideoTool, primeCatalog, promptConventions, resetLiveCatalog, resolutionTier, resolveAudioOptions, resolveDubbingOptions, resolveImageOptions, resolveLipsyncOptions, resolveOptions, resolveSpeechOptions, resolveTranscriptionOptions, resolveVideoOptions, resolveVoiceChangeOptions, resolveVoiceCloneOptions, resolveVoiceDesignOptions, sortCatalogRows, takesTargetAspectRatio, videoLengthViolation, videoToolConstraints };