@decartai/sdk 0.1.13 → 0.1.14

package/dist/realtime/preflight-connectivity.js

@@ -0,0 +1,102 @@
+//#region src/realtime/preflight-connectivity.ts
+function candidateType(candidate) {
+	if (candidate.type) return candidate.type;
+	return /\btyp (\w+)/.exec(candidate.candidate)?.[1] ?? "";
+}
+function nowMs() {
+	return globalThis.performance?.now?.() ?? Date.now();
+}
+async function gatherIceCandidates(iceServers, timeoutMs, signal, logger) {
+	if (signal?.aborted) return {
+		transport: "failed",
+		rttMs: null
+	};
+	const PC = globalThis?.RTCPeerConnection;
+	if (typeof PC !== "function") {
+		logger.warn("preflight: RTCPeerConnection unavailable in this environment");
+		return {
+			transport: "failed",
+			rttMs: null
+		};
+	}
+	let pc = null;
+	try {
+		pc = new PC({ iceServers });
+		pc.createDataChannel("decart-preflight");
+		let sawSrflx = false;
+		let sawOtherCandidate = false;
+		let firstSrflxAt = null;
+		const start = nowMs();
+		await new Promise((resolve) => {
+			let settled = false;
+			let timer;
+			const finish = () => {
+				if (settled) return;
+				settled = true;
+				clearTimeout(timer);
+				signal?.removeEventListener("abort", finish);
+				resolve();
+			};
+			timer = setTimeout(finish, timeoutMs);
+			signal?.addEventListener("abort", finish, { once: true });
+			if (signal?.aborted) finish();
+			const peer = pc;
+			peer.onicecandidate = (event) => {
+				if (!event.candidate || event.candidate.candidate === "") return finish();
+				if (candidateType(event.candidate) === "srflx") {
+					sawSrflx = true;
+					if (firstSrflxAt === null) firstSrflxAt = nowMs();
+				} else sawOtherCandidate = true;
+			};
+			peer.onicegatheringstatechange = () => {
+				if (peer.iceGatheringState === "complete") finish();
+			};
+			peer.createOffer().then((offer) => peer.setLocalDescription(offer)).catch((error) => {
+				logger.warn("preflight: failed to create offer", { error: error instanceof Error ? error.message : String(error) });
+				finish();
+			});
+		});
+		const rttMs = firstSrflxAt !== null ? Math.round(firstSrflxAt - start) : null;
+		return {
+			transport: sawSrflx ? "udp" : sawOtherCandidate ? "relay" : "failed",
+			rttMs
+		};
+	} catch (error) {
+		logger.warn("preflight: connectivity probe threw", { error: error instanceof Error ? error.message : String(error) });
+		return {
+			transport: "failed",
+			rttMs: null
+		};
+	} finally {
+		try {
+			pc?.close();
+		} catch {}
+	}
+}
+function classifyConnectivity(metrics, thresholds) {
+	const reasons = [];
+	let quality;
+	if (metrics.transport === "failed") {
+		quality = "critical";
+		reasons.push("Could not establish any WebRTC connectivity (no ICE candidates gathered). Real-time streaming is unlikely to work on this network.");
+	} else if (metrics.transport === "relay") {
+		quality = "poor";
+		reasons.push("Direct UDP connectivity could not be confirmed; the session will need a TURN relay, which adds latency and can't be verified without starting a session.");
+	} else if (metrics.rttMs != null && metrics.rttMs > thresholds.marginalMs) {
+		quality = "poor";
+		reasons.push(`Network round-trip time is high (~${metrics.rttMs}ms > ${thresholds.marginalMs}ms); the real-time experience may feel laggy.`);
+	} else if (metrics.rttMs != null && metrics.rttMs > thresholds.goodMs) {
+		quality = "fair";
+		reasons.push(`Network round-trip time is elevated (~${metrics.rttMs}ms > ${thresholds.goodMs}ms).`);
+	} else quality = "good";
+	return {
+		quality,
+		metrics: {
+			transport: metrics.transport,
+			rttMs: metrics.rttMs
+		},
+		reasons
+	};
+}
+//#endregion
+export { classifyConnectivity, gatherIceCandidates };

package/dist/realtime/preflight-types.d.ts

@@ -0,0 +1,30 @@
+import { CustomModelDefinition, ModelDefinition } from "../shared/model.js";
+import { ConnectionQuality } from "./observability/connection-quality.js";
+
+//#region src/realtime/preflight-types.d.ts
+type ConnectivityTransport = "udp" | "relay" | "failed";
+type ConnectivityMetrics = {
+  transport: ConnectivityTransport;
+  rttMs: number | null;
+  g2gMs?: number | null;
+  ttffMs?: number | null;
+  g2gDropRatio?: number | null;
+  upstreamJitterMs?: number | null;
+  packetLoss?: number | null;
+  sampleCount?: number;
+};
+type ConnectivityReport = {
+  quality: ConnectionQuality;
+  metrics: ConnectivityMetrics;
+  reasons: string[];
+};
+type CheckConnectivityOptions = {
+  iceServers?: RTCIceServer[];
+  iceGatherTimeoutMs?: number;
+  signal?: AbortSignal;
+  deep?: boolean;
+  model?: ModelDefinition | CustomModelDefinition;
+  durationMs?: number;
+};
+//#endregion
+export { CheckConnectivityOptions, ConnectivityMetrics, ConnectivityReport, ConnectivityTransport };

package/dist/realtime/react-native/index.js

@@ -0,0 +1,36 @@
+import { createRealTimeClient } from "../client.js";
+import { createRealTimeSubscribeClient } from "../subscribe-client.js";
+import { createReactNativePreflight } from "./preflight.js";
+import { assertReactNativeReady, prepareReactNativeConnection, unsupportedReactNativeFeature } from "./prepare-connection.js";
+//#region src/realtime/react-native/index.ts
+const createReactNativeRealtime = (options) => {
+	const publish = createRealTimeClient({
+		baseUrl: options.publishBaseUrl,
+		apiKey: options.apiKey,
+		integration: options.integration,
+		logger: options.logger,
+		telemetryEnabled: options.telemetryEnabled,
+		prepareConnection: prepareReactNativeConnection
+	});
+	const subscribe = createRealTimeSubscribeClient({
+		baseUrl: options.subscribeBaseUrl,
+		apiKey: options.apiKey,
+		integration: options.integration,
+		logger: options.logger
+	});
+	const preflight = createReactNativePreflight({ logger: options.logger });
+	return {
+		connect: (stream, connectOptions) => publish.connect(stream, connectOptions),
+		subscribe: (subscribeOptions) => {
+			assertReactNativeReady();
+			return subscribe.subscribe(subscribeOptions);
+		},
+		checkConnectivity: async (checkOptions = {}) => {
+			assertReactNativeReady();
+			if (checkOptions.deep) unsupportedReactNativeFeature("Deep connectivity preflight");
+			return preflight.checkConnectivity(checkOptions);
+		}
+	};
+};
+//#endregion
+export { createReactNativeRealtime };

package/dist/realtime/react-native/preflight.js

@@ -0,0 +1,10 @@
+import { REALTIME_CONFIG } from "../config-realtime.js";
+import { classifyConnectivity, gatherIceCandidates } from "../preflight-connectivity.js";
+//#region src/realtime/react-native/preflight.ts
+function createReactNativePreflight({ logger }) {
+	return { checkConnectivity: async (options = {}) => {
+		return classifyConnectivity(await gatherIceCandidates(options.iceServers ?? REALTIME_CONFIG.preflight.defaultStunUrls.map((urls) => ({ urls })), options.iceGatherTimeoutMs ?? REALTIME_CONFIG.preflight.iceGatherTimeoutMs, options.signal, logger), REALTIME_CONFIG.preflight.rtt);
+	} };
+}
+//#endregion
+export { createReactNativePreflight };

package/dist/realtime/react-native/prepare-connection.js

@@ -0,0 +1,26 @@
+import { createReactNativeSetupRequiredError, createUnsupportedPlatformFeatureError } from "../../utils/errors.js";
+import { RealtimeObservability } from "../observability/realtime-observability.js";
+import { missingReactNativeRealtimeGlobals } from "../../utils/platform.js";
+import { createLiveKitMediaChannel } from "../media-channel.js";
+//#region src/realtime/react-native/prepare-connection.ts
+function assertReactNativeReady() {
+	const missing = missingReactNativeRealtimeGlobals();
+	if (missing.length > 0) throw createReactNativeSetupRequiredError(missing);
+}
+function unsupportedReactNativeFeature(feature) {
+	throw createUnsupportedPlatformFeatureError(feature, "React Native");
+}
+const prepareReactNativeConnection = ({ stream, mirror, debugQuality, preferredVideoCodec, observability: observabilityOptions }) => {
+	assertReactNativeReady();
+	if (mirror !== false) unsupportedReactNativeFeature("Outgoing video mirroring");
+	if (debugQuality) unsupportedReactNativeFeature("debugQuality");
+	return {
+		stream: stream ?? new MediaStream(),
+		observability: new RealtimeObservability(observabilityOptions),
+		videoCodec: preferredVideoCodec,
+		createMediaChannel: createLiveKitMediaChannel,
+		dispose: () => {}
+	};
+};
+//#endregion
+export { assertReactNativeReady, prepareReactNativeConnection, unsupportedReactNativeFeature };

package/dist/realtime/stream-session.js

@@ -1,6 +1,5 @@
 import { createConsoleLogger } from "../utils/logger.js";
 import { REALTIME_CONFIG } from "./config-realtime.js";
-import { MediaChannel } from "./media-channel.js";
 import { SignalingChannel } from "./signaling-channel.js";
 import mitt from "mitt";
 import pRetry, { AbortError } from "p-retry";
@@ -238,7 +237,7 @@ var StreamSession = class {
 			logger: this.logger,
 			observability: this.config.observability
 		});
-		this.media = new MediaChannel({
+		this.media = this.config.createMediaChannel({
 			observability: this.config.observability,
 			localStream: this.config.localStream,
 			logger: this.logger,

package/dist/realtime/subscribe-client.js

@@ -2,8 +2,8 @@ import { classifyWebrtcError } from "../utils/errors.js";
 import { createConsoleLogger } from "../utils/logger.js";
 import { createEventBuffer } from "./event-buffer.js";
 import { REALTIME_CONFIG } from "./config-realtime.js";
+import { loadLiveKitClient } from "./livekit.js";
 import { RealtimeObservability } from "./observability/realtime-observability.js";
-import { ConnectionState, Room, RoomEvent, Track } from "livekit-client";
 //#region src/realtime/subscribe-client.ts
 function decodeSubscribeToken(token) {
 	try {
@@ -16,11 +16,11 @@ function decodeSubscribeToken(token) {
 }
 function mapLiveKitState(state) {
 	switch (state) {
-		case ConnectionState.Connecting: return "connecting";
-		case ConnectionState.Connected: return "connected";
-		case ConnectionState.Reconnecting:
-		case ConnectionState.SignalReconnecting: return "reconnecting";
-		case ConnectionState.Disconnected: return "disconnected";
+		case "connecting": return "connecting";
+		case "connected": return "connected";
+		case "reconnecting":
+		case "signalReconnecting": return "reconnecting";
+		case "disconnected": return "disconnected";
 		default: return "disconnected";
 	}
 }
@@ -63,6 +63,7 @@ const createRealTimeSubscribeClient = (opts) => {
 			emitOrBuffer("connectionChange", state);
 		};
 		try {
+			const { Room: LiveKitRoom, RoomEvent } = await loadLiveKitClient();
 			observability = new RealtimeObservability({
 				telemetryEnabled: false,
 				apiKey,
@@ -76,11 +77,11 @@ const createRealTimeSubscribeClient = (opts) => {
 				apiKey,
 				roomName
 			});
-			room = new Room(REALTIME_CONFIG.livekit.roomOptions);
+			room = new LiveKitRoom(REALTIME_CONFIG.livekit.roomOptions);
 			const activeRoom = room;
 			activeRoom.on(RoomEvent.TrackSubscribed, (track, _pub, participant) => {
 				if (!participant.identity.startsWith(REALTIME_CONFIG.livekit.inferenceServerIdentityPrefix)) return;
-				if (track.kind !== Track.Kind.Video && track.kind !== Track.Kind.Audio) return;
+				if (track.kind !== "video" && track.kind !== "audio") return;
 				const mediaStreamTrack = track.mediaStreamTrack;
 				if (!mediaStreamTrack) return;
 				const tracks = remoteStream?.getTracks() ?? [];
@@ -98,7 +99,7 @@ const createRealTimeSubscribeClient = (opts) => {
 			observability.setLiveKitRoom(activeRoom);
 			setState("connected");
 			const client = {
-				isConnected: () => activeRoom.state === ConnectionState.Connected,
+				isConnected: () => activeRoom.state === "connected",
 				getConnectionState: () => mapLiveKitState(activeRoom.state),
 				disconnect: () => {
 					observability?.stop();

package/dist/shared/model.d.ts

@@ -17,7 +17,6 @@ type CanonicalModel = z.infer<typeof canonicalModelSchema>;
  * Old names still work but will log a deprecation warning.
  */
 declare const modelAliases: {
-  readonly mirage_v2: "lucy-restyle-2";
   readonly "lucy-2.1-vton-2": "lucy-vton-2";
   readonly "lucy-pro-v2v": "lucy-clip";
   readonly "lucy-restyle-v2v": "lucy-restyle-2";
@@ -25,10 +24,10 @@ declare const modelAliases: {
 };
 /** @internal Test-only helper to reset deprecation warning tracking */
 
-declare const realtimeModels: z.ZodUnion<readonly [z.ZodLiteral<"lucy-2.1">, z.ZodLiteral<"lucy-2.5">, z.ZodLiteral<"lucy-vton-2">, z.ZodLiteral<"lucy-vton-3">, z.ZodLiteral<"lucy-restyle-2">, z.ZodLiteral<"lucy-latest">, z.ZodLiteral<"lucy-vton-latest">, z.ZodLiteral<"lucy-restyle-latest">, z.ZodLiteral<"mirage_v2">, z.ZodLiteral<"lucy-2.1-vton-2">]>;
+declare const realtimeModels: z.ZodUnion<readonly [z.ZodLiteral<"lucy-2.1">, z.ZodLiteral<"lucy-2.5">, z.ZodLiteral<"lucy-vton-2">, z.ZodLiteral<"lucy-vton-3">, z.ZodLiteral<"lucy-restyle-2">, z.ZodLiteral<"lucy-latest">, z.ZodLiteral<"lucy-vton-latest">, z.ZodLiteral<"lucy-restyle-latest">, z.ZodLiteral<"lucy-2.1-vton-2">]>;
 declare const videoModels: z.ZodUnion<readonly [z.ZodLiteral<"lucy-clip">, z.ZodLiteral<"lucy-2.1">, z.ZodLiteral<"lucy-2.5">, z.ZodLiteral<"lucy-vton-2">, z.ZodLiteral<"lucy-vton-3">, z.ZodLiteral<"lucy-restyle-2">, z.ZodLiteral<"lucy-latest">, z.ZodLiteral<"lucy-vton-latest">, z.ZodLiteral<"lucy-restyle-latest">, z.ZodLiteral<"lucy-clip-latest">, z.ZodLiteral<"lucy-2.1-vton-2">, z.ZodLiteral<"lucy-pro-v2v">, z.ZodLiteral<"lucy-restyle-v2v">]>;
 declare const imageModels: z.ZodUnion<readonly [z.ZodLiteral<"lucy-image-2">, z.ZodLiteral<"lucy-image-latest">, z.ZodLiteral<"lucy-pro-i2i">]>;
-declare const modelSchema: z.ZodUnion<readonly [z.ZodUnion<readonly [z.ZodLiteral<"lucy-2.1">, z.ZodLiteral<"lucy-2.5">, z.ZodLiteral<"lucy-vton-2">, z.ZodLiteral<"lucy-vton-3">, z.ZodLiteral<"lucy-restyle-2">, z.ZodLiteral<"lucy-latest">, z.ZodLiteral<"lucy-vton-latest">, z.ZodLiteral<"lucy-restyle-latest">, z.ZodLiteral<"mirage_v2">, z.ZodLiteral<"lucy-2.1-vton-2">]>, z.ZodUnion<readonly [z.ZodLiteral<"lucy-clip">, z.ZodLiteral<"lucy-2.1">, z.ZodLiteral<"lucy-2.5">, z.ZodLiteral<"lucy-vton-2">, z.ZodLiteral<"lucy-vton-3">, z.ZodLiteral<"lucy-restyle-2">, z.ZodLiteral<"lucy-latest">, z.ZodLiteral<"lucy-vton-latest">, z.ZodLiteral<"lucy-restyle-latest">, z.ZodLiteral<"lucy-clip-latest">, z.ZodLiteral<"lucy-2.1-vton-2">, z.ZodLiteral<"lucy-pro-v2v">, z.ZodLiteral<"lucy-restyle-v2v">]>, z.ZodUnion<readonly [z.ZodLiteral<"lucy-image-2">, z.ZodLiteral<"lucy-image-latest">, z.ZodLiteral<"lucy-pro-i2i">]>]>;
+declare const modelSchema: z.ZodUnion<readonly [z.ZodUnion<readonly [z.ZodLiteral<"lucy-2.1">, z.ZodLiteral<"lucy-2.5">, z.ZodLiteral<"lucy-vton-2">, z.ZodLiteral<"lucy-vton-3">, z.ZodLiteral<"lucy-restyle-2">, z.ZodLiteral<"lucy-latest">, z.ZodLiteral<"lucy-vton-latest">, z.ZodLiteral<"lucy-restyle-latest">, z.ZodLiteral<"lucy-2.1-vton-2">]>, z.ZodUnion<readonly [z.ZodLiteral<"lucy-clip">, z.ZodLiteral<"lucy-2.1">, z.ZodLiteral<"lucy-2.5">, z.ZodLiteral<"lucy-vton-2">, z.ZodLiteral<"lucy-vton-3">, z.ZodLiteral<"lucy-restyle-2">, z.ZodLiteral<"lucy-latest">, z.ZodLiteral<"lucy-vton-latest">, z.ZodLiteral<"lucy-restyle-latest">, z.ZodLiteral<"lucy-clip-latest">, z.ZodLiteral<"lucy-2.1-vton-2">, z.ZodLiteral<"lucy-pro-v2v">, z.ZodLiteral<"lucy-restyle-v2v">]>, z.ZodUnion<readonly [z.ZodLiteral<"lucy-image-2">, z.ZodLiteral<"lucy-image-latest">, z.ZodLiteral<"lucy-pro-i2i">]>]>;
 type Model = z.infer<typeof modelSchema>;
 type RealTimeModels = z.infer<typeof realtimeModels>;
 type VideoModels = z.infer<typeof videoModels>;
@@ -53,12 +52,12 @@ declare function resolveCanonicalModelAlias(model: string): CanonicalModel | und
 declare const modelInputSchemas: {
   readonly "lucy-clip": z.ZodObject<{
     prompt: z.ZodString;
-    data: z.ZodUnion<readonly [z.ZodCustom<File, File>, z.ZodCustom<Blob, Blob>, z.ZodCustom<ReadableStream<unknown>, ReadableStream<unknown>>, z.ZodCustom<URL, URL>, z.ZodURL, z.ZodObject<{
+    data: z.ZodUnion<readonly [z.ZodType<File, unknown, z.core.$ZodTypeInternals<File, unknown>>, z.ZodType<Blob, unknown, z.core.$ZodTypeInternals<Blob, unknown>>, z.ZodType<ReadableStream<any>, unknown, z.core.$ZodTypeInternals<ReadableStream<any>, unknown>>, z.ZodType<URL, unknown, z.core.$ZodTypeInternals<URL, unknown>>, z.ZodURL, z.ZodObject<{
       uri: z.ZodString;
       type: z.ZodString;
       name: z.ZodString;
     }, z.core.$strip>]>;
-    reference_image: z.ZodOptional<z.ZodUnion<readonly [z.ZodCustom<File, File>, z.ZodCustom<Blob, Blob>, z.ZodCustom<ReadableStream<unknown>, ReadableStream<unknown>>, z.ZodCustom<URL, URL>, z.ZodURL, z.ZodObject<{
+    reference_image: z.ZodOptional<z.ZodUnion<readonly [z.ZodType<File, unknown, z.core.$ZodTypeInternals<File, unknown>>, z.ZodType<Blob, unknown, z.core.$ZodTypeInternals<Blob, unknown>>, z.ZodType<ReadableStream<any>, unknown, z.core.$ZodTypeInternals<ReadableStream<any>, unknown>>, z.ZodType<URL, unknown, z.core.$ZodTypeInternals<URL, unknown>>, z.ZodURL, z.ZodObject<{
       uri: z.ZodString;
       type: z.ZodString;
       name: z.ZodString;
@@ -69,12 +68,12 @@ declare const modelInputSchemas: {
   }, z.core.$strip>;
   readonly "lucy-image-2": z.ZodObject<{
     prompt: z.ZodString;
-    data: z.ZodUnion<readonly [z.ZodCustom<File, File>, z.ZodCustom<Blob, Blob>, z.ZodCustom<ReadableStream<unknown>, ReadableStream<unknown>>, z.ZodCustom<URL, URL>, z.ZodURL, z.ZodObject<{
+    data: z.ZodUnion<readonly [z.ZodType<File, unknown, z.core.$ZodTypeInternals<File, unknown>>, z.ZodType<Blob, unknown, z.core.$ZodTypeInternals<Blob, unknown>>, z.ZodType<ReadableStream<any>, unknown, z.core.$ZodTypeInternals<ReadableStream<any>, unknown>>, z.ZodType<URL, unknown, z.core.$ZodTypeInternals<URL, unknown>>, z.ZodURL, z.ZodObject<{
       uri: z.ZodString;
       type: z.ZodString;
       name: z.ZodString;
     }, z.core.$strip>]>;
-    reference_image: z.ZodOptional<z.ZodUnion<readonly [z.ZodCustom<File, File>, z.ZodCustom<Blob, Blob>, z.ZodCustom<ReadableStream<unknown>, ReadableStream<unknown>>, z.ZodCustom<URL, URL>, z.ZodURL, z.ZodObject<{
+    reference_image: z.ZodOptional<z.ZodUnion<readonly [z.ZodType<File, unknown, z.core.$ZodTypeInternals<File, unknown>>, z.ZodType<Blob, unknown, z.core.$ZodTypeInternals<Blob, unknown>>, z.ZodType<ReadableStream<any>, unknown, z.core.$ZodTypeInternals<ReadableStream<any>, unknown>>, z.ZodType<URL, unknown, z.core.$ZodTypeInternals<URL, unknown>>, z.ZodURL, z.ZodObject<{
       uri: z.ZodString;
       type: z.ZodString;
       name: z.ZodString;
@@ -88,12 +87,12 @@ declare const modelInputSchemas: {
   }, z.core.$strip>;
   readonly "lucy-restyle-2": z.ZodObject<{
     prompt: z.ZodOptional<z.ZodString>;
-    reference_image: z.ZodOptional<z.ZodUnion<readonly [z.ZodCustom<File, File>, z.ZodCustom<Blob, Blob>, z.ZodCustom<ReadableStream<unknown>, ReadableStream<unknown>>, z.ZodCustom<URL, URL>, z.ZodURL, z.ZodObject<{
+    reference_image: z.ZodOptional<z.ZodUnion<readonly [z.ZodType<File, unknown, z.core.$ZodTypeInternals<File, unknown>>, z.ZodType<Blob, unknown, z.core.$ZodTypeInternals<Blob, unknown>>, z.ZodType<ReadableStream<any>, unknown, z.core.$ZodTypeInternals<ReadableStream<any>, unknown>>, z.ZodType<URL, unknown, z.core.$ZodTypeInternals<URL, unknown>>, z.ZodURL, z.ZodObject<{
       uri: z.ZodString;
       type: z.ZodString;
       name: z.ZodString;
     }, z.core.$strip>]>>;
-    data: z.ZodUnion<readonly [z.ZodCustom<File, File>, z.ZodCustom<Blob, Blob>, z.ZodCustom<ReadableStream<unknown>, ReadableStream<unknown>>, z.ZodCustom<URL, URL>, z.ZodURL, z.ZodObject<{
+    data: z.ZodUnion<readonly [z.ZodType<File, unknown, z.core.$ZodTypeInternals<File, unknown>>, z.ZodType<Blob, unknown, z.core.$ZodTypeInternals<Blob, unknown>>, z.ZodType<ReadableStream<any>, unknown, z.core.$ZodTypeInternals<ReadableStream<any>, unknown>>, z.ZodType<URL, unknown, z.core.$ZodTypeInternals<URL, unknown>>, z.ZodURL, z.ZodObject<{
       uri: z.ZodString;
       type: z.ZodString;
       name: z.ZodString;
@@ -104,12 +103,12 @@ declare const modelInputSchemas: {
   }, z.core.$strip>;
   readonly "lucy-2.1": z.ZodObject<{
     prompt: z.ZodString;
-    reference_image: z.ZodOptional<z.ZodUnion<readonly [z.ZodCustom<File, File>, z.ZodCustom<Blob, Blob>, z.ZodCustom<ReadableStream<unknown>, ReadableStream<unknown>>, z.ZodCustom<URL, URL>, z.ZodURL, z.ZodObject<{
+    reference_image: z.ZodOptional<z.ZodUnion<readonly [z.ZodType<File, unknown, z.core.$ZodTypeInternals<File, unknown>>, z.ZodType<Blob, unknown, z.core.$ZodTypeInternals<Blob, unknown>>, z.ZodType<ReadableStream<any>, unknown, z.core.$ZodTypeInternals<ReadableStream<any>, unknown>>, z.ZodType<URL, unknown, z.core.$ZodTypeInternals<URL, unknown>>, z.ZodURL, z.ZodObject<{
       uri: z.ZodString;
       type: z.ZodString;
       name: z.ZodString;
     }, z.core.$strip>]>>;
-    data: z.ZodUnion<readonly [z.ZodCustom<File, File>, z.ZodCustom<Blob, Blob>, z.ZodCustom<ReadableStream<unknown>, ReadableStream<unknown>>, z.ZodCustom<URL, URL>, z.ZodURL, z.ZodObject<{
+    data: z.ZodUnion<readonly [z.ZodType<File, unknown, z.core.$ZodTypeInternals<File, unknown>>, z.ZodType<Blob, unknown, z.core.$ZodTypeInternals<Blob, unknown>>, z.ZodType<ReadableStream<any>, unknown, z.core.$ZodTypeInternals<ReadableStream<any>, unknown>>, z.ZodType<URL, unknown, z.core.$ZodTypeInternals<URL, unknown>>, z.ZodURL, z.ZodObject<{
       uri: z.ZodString;
       type: z.ZodString;
       name: z.ZodString;
@@ -120,12 +119,12 @@ declare const modelInputSchemas: {
   }, z.core.$strip>;
   readonly "lucy-2.5": z.ZodObject<{
     prompt: z.ZodString;
-    reference_image: z.ZodOptional<z.ZodUnion<readonly [z.ZodCustom<File, File>, z.ZodCustom<Blob, Blob>, z.ZodCustom<ReadableStream<unknown>, ReadableStream<unknown>>, z.ZodCustom<URL, URL>, z.ZodURL, z.ZodObject<{
+    reference_image: z.ZodOptional<z.ZodUnion<readonly [z.ZodType<File, unknown, z.core.$ZodTypeInternals<File, unknown>>, z.ZodType<Blob, unknown, z.core.$ZodTypeInternals<Blob, unknown>>, z.ZodType<ReadableStream<any>, unknown, z.core.$ZodTypeInternals<ReadableStream<any>, unknown>>, z.ZodType<URL, unknown, z.core.$ZodTypeInternals<URL, unknown>>, z.ZodURL, z.ZodObject<{
       uri: z.ZodString;
       type: z.ZodString;
       name: z.ZodString;
     }, z.core.$strip>]>>;
-    data: z.ZodUnion<readonly [z.ZodCustom<File, File>, z.ZodCustom<Blob, Blob>, z.ZodCustom<ReadableStream<unknown>, ReadableStream<unknown>>, z.ZodCustom<URL, URL>, z.ZodURL, z.ZodObject<{
+    data: z.ZodUnion<readonly [z.ZodType<File, unknown, z.core.$ZodTypeInternals<File, unknown>>, z.ZodType<Blob, unknown, z.core.$ZodTypeInternals<Blob, unknown>>, z.ZodType<ReadableStream<any>, unknown, z.core.$ZodTypeInternals<ReadableStream<any>, unknown>>, z.ZodType<URL, unknown, z.core.$ZodTypeInternals<URL, unknown>>, z.ZodURL, z.ZodObject<{
       uri: z.ZodString;
       type: z.ZodString;
       name: z.ZodString;
@@ -136,12 +135,12 @@ declare const modelInputSchemas: {
   }, z.core.$strip>;
   readonly "lucy-vton-2": z.ZodObject<{
     prompt: z.ZodString;
-    reference_image: z.ZodOptional<z.ZodUnion<readonly [z.ZodCustom<File, File>, z.ZodCustom<Blob, Blob>, z.ZodCustom<ReadableStream<unknown>, ReadableStream<unknown>>, z.ZodCustom<URL, URL>, z.ZodURL, z.ZodObject<{
+    reference_image: z.ZodOptional<z.ZodUnion<readonly [z.ZodType<File, unknown, z.core.$ZodTypeInternals<File, unknown>>, z.ZodType<Blob, unknown, z.core.$ZodTypeInternals<Blob, unknown>>, z.ZodType<ReadableStream<any>, unknown, z.core.$ZodTypeInternals<ReadableStream<any>, unknown>>, z.ZodType<URL, unknown, z.core.$ZodTypeInternals<URL, unknown>>, z.ZodURL, z.ZodObject<{
       uri: z.ZodString;
       type: z.ZodString;
       name: z.ZodString;
     }, z.core.$strip>]>>;
-    data: z.ZodUnion<readonly [z.ZodCustom<File, File>, z.ZodCustom<Blob, Blob>, z.ZodCustom<ReadableStream<unknown>, ReadableStream<unknown>>, z.ZodCustom<URL, URL>, z.ZodURL, z.ZodObject<{
+    data: z.ZodUnion<readonly [z.ZodType<File, unknown, z.core.$ZodTypeInternals<File, unknown>>, z.ZodType<Blob, unknown, z.core.$ZodTypeInternals<Blob, unknown>>, z.ZodType<ReadableStream<any>, unknown, z.core.$ZodTypeInternals<ReadableStream<any>, unknown>>, z.ZodType<URL, unknown, z.core.$ZodTypeInternals<URL, unknown>>, z.ZodURL, z.ZodObject<{
       uri: z.ZodString;
       type: z.ZodString;
       name: z.ZodString;
@@ -152,12 +151,12 @@ declare const modelInputSchemas: {
   }, z.core.$strip>;
   readonly "lucy-vton-3": z.ZodObject<{
     prompt: z.ZodString;
-    reference_image: z.ZodOptional<z.ZodUnion<readonly [z.ZodCustom<File, File>, z.ZodCustom<Blob, Blob>, z.ZodCustom<ReadableStream<unknown>, ReadableStream<unknown>>, z.ZodCustom<URL, URL>, z.ZodURL, z.ZodObject<{
+    reference_image: z.ZodOptional<z.ZodUnion<readonly [z.ZodType<File, unknown, z.core.$ZodTypeInternals<File, unknown>>, z.ZodType<Blob, unknown, z.core.$ZodTypeInternals<Blob, unknown>>, z.ZodType<ReadableStream<any>, unknown, z.core.$ZodTypeInternals<ReadableStream<any>, unknown>>, z.ZodType<URL, unknown, z.core.$ZodTypeInternals<URL, unknown>>, z.ZodURL, z.ZodObject<{
       uri: z.ZodString;
       type: z.ZodString;
       name: z.ZodString;
     }, z.core.$strip>]>>;
-    data: z.ZodUnion<readonly [z.ZodCustom<File, File>, z.ZodCustom<Blob, Blob>, z.ZodCustom<ReadableStream<unknown>, ReadableStream<unknown>>, z.ZodCustom<URL, URL>, z.ZodURL, z.ZodObject<{
+    data: z.ZodUnion<readonly [z.ZodType<File, unknown, z.core.$ZodTypeInternals<File, unknown>>, z.ZodType<Blob, unknown, z.core.$ZodTypeInternals<Blob, unknown>>, z.ZodType<ReadableStream<any>, unknown, z.core.$ZodTypeInternals<ReadableStream<any>, unknown>>, z.ZodType<URL, unknown, z.core.$ZodTypeInternals<URL, unknown>>, z.ZodURL, z.ZodObject<{
       uri: z.ZodString;
       type: z.ZodString;
       name: z.ZodString;
@@ -168,12 +167,12 @@ declare const modelInputSchemas: {
   }, z.core.$strip>;
   readonly "lucy-latest": z.ZodObject<{
     prompt: z.ZodString;
-    reference_image: z.ZodOptional<z.ZodUnion<readonly [z.ZodCustom<File, File>, z.ZodCustom<Blob, Blob>, z.ZodCustom<ReadableStream<unknown>, ReadableStream<unknown>>, z.ZodCustom<URL, URL>, z.ZodURL, z.ZodObject<{
+    reference_image: z.ZodOptional<z.ZodUnion<readonly [z.ZodType<File, unknown, z.core.$ZodTypeInternals<File, unknown>>, z.ZodType<Blob, unknown, z.core.$ZodTypeInternals<Blob, unknown>>, z.ZodType<ReadableStream<any>, unknown, z.core.$ZodTypeInternals<ReadableStream<any>, unknown>>, z.ZodType<URL, unknown, z.core.$ZodTypeInternals<URL, unknown>>, z.ZodURL, z.ZodObject<{
       uri: z.ZodString;
       type: z.ZodString;
       name: z.ZodString;
     }, z.core.$strip>]>>;
-    data: z.ZodUnion<readonly [z.ZodCustom<File, File>, z.ZodCustom<Blob, Blob>, z.ZodCustom<ReadableStream<unknown>, ReadableStream<unknown>>, z.ZodCustom<URL, URL>, z.ZodURL, z.ZodObject<{
+    data: z.ZodUnion<readonly [z.ZodType<File, unknown, z.core.$ZodTypeInternals<File, unknown>>, z.ZodType<Blob, unknown, z.core.$ZodTypeInternals<Blob, unknown>>, z.ZodType<ReadableStream<any>, unknown, z.core.$ZodTypeInternals<ReadableStream<any>, unknown>>, z.ZodType<URL, unknown, z.core.$ZodTypeInternals<URL, unknown>>, z.ZodURL, z.ZodObject<{
       uri: z.ZodString;
       type: z.ZodString;
       name: z.ZodString;
@@ -184,12 +183,12 @@ declare const modelInputSchemas: {
   }, z.core.$strip>;
   readonly "lucy-vton-latest": z.ZodObject<{
     prompt: z.ZodString;
-    reference_image: z.ZodOptional<z.ZodUnion<readonly [z.ZodCustom<File, File>, z.ZodCustom<Blob, Blob>, z.ZodCustom<ReadableStream<unknown>, ReadableStream<unknown>>, z.ZodCustom<URL, URL>, z.ZodURL, z.ZodObject<{
+    reference_image: z.ZodOptional<z.ZodUnion<readonly [z.ZodType<File, unknown, z.core.$ZodTypeInternals<File, unknown>>, z.ZodType<Blob, unknown, z.core.$ZodTypeInternals<Blob, unknown>>, z.ZodType<ReadableStream<any>, unknown, z.core.$ZodTypeInternals<ReadableStream<any>, unknown>>, z.ZodType<URL, unknown, z.core.$ZodTypeInternals<URL, unknown>>, z.ZodURL, z.ZodObject<{
       uri: z.ZodString;
       type: z.ZodString;
       name: z.ZodString;
     }, z.core.$strip>]>>;
-    data: z.ZodUnion<readonly [z.ZodCustom<File, File>, z.ZodCustom<Blob, Blob>, z.ZodCustom<ReadableStream<unknown>, ReadableStream<unknown>>, z.ZodCustom<URL, URL>, z.ZodURL, z.ZodObject<{
+    data: z.ZodUnion<readonly [z.ZodType<File, unknown, z.core.$ZodTypeInternals<File, unknown>>, z.ZodType<Blob, unknown, z.core.$ZodTypeInternals<Blob, unknown>>, z.ZodType<ReadableStream<any>, unknown, z.core.$ZodTypeInternals<ReadableStream<any>, unknown>>, z.ZodType<URL, unknown, z.core.$ZodTypeInternals<URL, unknown>>, z.ZodURL, z.ZodObject<{
       uri: z.ZodString;
       type: z.ZodString;
       name: z.ZodString;
@@ -200,12 +199,12 @@ declare const modelInputSchemas: {
   }, z.core.$strip>;
   readonly "lucy-restyle-latest": z.ZodObject<{
     prompt: z.ZodOptional<z.ZodString>;
-    reference_image: z.ZodOptional<z.ZodUnion<readonly [z.ZodCustom<File, File>, z.ZodCustom<Blob, Blob>, z.ZodCustom<ReadableStream<unknown>, ReadableStream<unknown>>, z.ZodCustom<URL, URL>, z.ZodURL, z.ZodObject<{
+    reference_image: z.ZodOptional<z.ZodUnion<readonly [z.ZodType<File, unknown, z.core.$ZodTypeInternals<File, unknown>>, z.ZodType<Blob, unknown, z.core.$ZodTypeInternals<Blob, unknown>>, z.ZodType<ReadableStream<any>, unknown, z.core.$ZodTypeInternals<ReadableStream<any>, unknown>>, z.ZodType<URL, unknown, z.core.$ZodTypeInternals<URL, unknown>>, z.ZodURL, z.ZodObject<{
       uri: z.ZodString;
       type: z.ZodString;
       name: z.ZodString;
     }, z.core.$strip>]>>;
-    data: z.ZodUnion<readonly [z.ZodCustom<File, File>, z.ZodCustom<Blob, Blob>, z.ZodCustom<ReadableStream<unknown>, ReadableStream<unknown>>, z.ZodCustom<URL, URL>, z.ZodURL, z.ZodObject<{
+    data: z.ZodUnion<readonly [z.ZodType<File, unknown, z.core.$ZodTypeInternals<File, unknown>>, z.ZodType<Blob, unknown, z.core.$ZodTypeInternals<Blob, unknown>>, z.ZodType<ReadableStream<any>, unknown, z.core.$ZodTypeInternals<ReadableStream<any>, unknown>>, z.ZodType<URL, unknown, z.core.$ZodTypeInternals<URL, unknown>>, z.ZodURL, z.ZodObject<{
       uri: z.ZodString;
       type: z.ZodString;
       name: z.ZodString;
@@ -216,12 +215,12 @@ declare const modelInputSchemas: {
   }, z.core.$strip>;
   readonly "lucy-clip-latest": z.ZodObject<{
     prompt: z.ZodString;
-    data: z.ZodUnion<readonly [z.ZodCustom<File, File>, z.ZodCustom<Blob, Blob>, z.ZodCustom<ReadableStream<unknown>, ReadableStream<unknown>>, z.ZodCustom<URL, URL>, z.ZodURL, z.ZodObject<{
+    data: z.ZodUnion<readonly [z.ZodType<File, unknown, z.core.$ZodTypeInternals<File, unknown>>, z.ZodType<Blob, unknown, z.core.$ZodTypeInternals<Blob, unknown>>, z.ZodType<ReadableStream<any>, unknown, z.core.$ZodTypeInternals<ReadableStream<any>, unknown>>, z.ZodType<URL, unknown, z.core.$ZodTypeInternals<URL, unknown>>, z.ZodURL, z.ZodObject<{
       uri: z.ZodString;
       type: z.ZodString;
       name: z.ZodString;
     }, z.core.$strip>]>;
-    reference_image: z.ZodOptional<z.ZodUnion<readonly [z.ZodCustom<File, File>, z.ZodCustom<Blob, Blob>, z.ZodCustom<ReadableStream<unknown>, ReadableStream<unknown>>, z.ZodCustom<URL, URL>, z.ZodURL, z.ZodObject<{
+    reference_image: z.ZodOptional<z.ZodUnion<readonly [z.ZodType<File, unknown, z.core.$ZodTypeInternals<File, unknown>>, z.ZodType<Blob, unknown, z.core.$ZodTypeInternals<Blob, unknown>>, z.ZodType<ReadableStream<any>, unknown, z.core.$ZodTypeInternals<ReadableStream<any>, unknown>>, z.ZodType<URL, unknown, z.core.$ZodTypeInternals<URL, unknown>>, z.ZodURL, z.ZodObject<{
       uri: z.ZodString;
       type: z.ZodString;
       name: z.ZodString;
@@ -232,12 +231,12 @@ declare const modelInputSchemas: {
   }, z.core.$strip>;
   readonly "lucy-image-latest": z.ZodObject<{
     prompt: z.ZodString;
-    data: z.ZodUnion<readonly [z.ZodCustom<File, File>, z.ZodCustom<Blob, Blob>, z.ZodCustom<ReadableStream<unknown>, ReadableStream<unknown>>, z.ZodCustom<URL, URL>, z.ZodURL, z.ZodObject<{
+    data: z.ZodUnion<readonly [z.ZodType<File, unknown, z.core.$ZodTypeInternals<File, unknown>>, z.ZodType<Blob, unknown, z.core.$ZodTypeInternals<Blob, unknown>>, z.ZodType<ReadableStream<any>, unknown, z.core.$ZodTypeInternals<ReadableStream<any>, unknown>>, z.ZodType<URL, unknown, z.core.$ZodTypeInternals<URL, unknown>>, z.ZodURL, z.ZodObject<{
       uri: z.ZodString;
       type: z.ZodString;
       name: z.ZodString;
     }, z.core.$strip>]>;
-    reference_image: z.ZodOptional<z.ZodUnion<readonly [z.ZodCustom<File, File>, z.ZodCustom<Blob, Blob>, z.ZodCustom<ReadableStream<unknown>, ReadableStream<unknown>>, z.ZodCustom<URL, URL>, z.ZodURL, z.ZodObject<{
+    reference_image: z.ZodOptional<z.ZodUnion<readonly [z.ZodType<File, unknown, z.core.$ZodTypeInternals<File, unknown>>, z.ZodType<Blob, unknown, z.core.$ZodTypeInternals<Blob, unknown>>, z.ZodType<ReadableStream<any>, unknown, z.core.$ZodTypeInternals<ReadableStream<any>, unknown>>, z.ZodType<URL, unknown, z.core.$ZodTypeInternals<URL, unknown>>, z.ZodURL, z.ZodObject<{
       uri: z.ZodString;
       type: z.ZodString;
       name: z.ZodString;
@@ -251,12 +250,12 @@ declare const modelInputSchemas: {
   }, z.core.$strip>;
   readonly "lucy-2.1-vton-2": z.ZodObject<{
     prompt: z.ZodString;
-    reference_image: z.ZodOptional<z.ZodUnion<readonly [z.ZodCustom<File, File>, z.ZodCustom<Blob, Blob>, z.ZodCustom<ReadableStream<unknown>, ReadableStream<unknown>>, z.ZodCustom<URL, URL>, z.ZodURL, z.ZodObject<{
+    reference_image: z.ZodOptional<z.ZodUnion<readonly [z.ZodType<File, unknown, z.core.$ZodTypeInternals<File, unknown>>, z.ZodType<Blob, unknown, z.core.$ZodTypeInternals<Blob, unknown>>, z.ZodType<ReadableStream<any>, unknown, z.core.$ZodTypeInternals<ReadableStream<any>, unknown>>, z.ZodType<URL, unknown, z.core.$ZodTypeInternals<URL, unknown>>, z.ZodURL, z.ZodObject<{
       uri: z.ZodString;
       type: z.ZodString;
       name: z.ZodString;
     }, z.core.$strip>]>>;
-    data: z.ZodUnion<readonly [z.ZodCustom<File, File>, z.ZodCustom<Blob, Blob>, z.ZodCustom<ReadableStream<unknown>, ReadableStream<unknown>>, z.ZodCustom<URL, URL>, z.ZodURL, z.ZodObject<{
+    data: z.ZodUnion<readonly [z.ZodType<File, unknown, z.core.$ZodTypeInternals<File, unknown>>, z.ZodType<Blob, unknown, z.core.$ZodTypeInternals<Blob, unknown>>, z.ZodType<ReadableStream<any>, unknown, z.core.$ZodTypeInternals<ReadableStream<any>, unknown>>, z.ZodType<URL, unknown, z.core.$ZodTypeInternals<URL, unknown>>, z.ZodURL, z.ZodObject<{
       uri: z.ZodString;
       type: z.ZodString;
       name: z.ZodString;
@@ -267,12 +266,12 @@ declare const modelInputSchemas: {
   }, z.core.$strip>;
   readonly "lucy-pro-v2v": z.ZodObject<{
     prompt: z.ZodString;
-    data: z.ZodUnion<readonly [z.ZodCustom<File, File>, z.ZodCustom<Blob, Blob>, z.ZodCustom<ReadableStream<unknown>, ReadableStream<unknown>>, z.ZodCustom<URL, URL>, z.ZodURL, z.ZodObject<{
+    data: z.ZodUnion<readonly [z.ZodType<File, unknown, z.core.$ZodTypeInternals<File, unknown>>, z.ZodType<Blob, unknown, z.core.$ZodTypeInternals<Blob, unknown>>, z.ZodType<ReadableStream<any>, unknown, z.core.$ZodTypeInternals<ReadableStream<any>, unknown>>, z.ZodType<URL, unknown, z.core.$ZodTypeInternals<URL, unknown>>, z.ZodURL, z.ZodObject<{
       uri: z.ZodString;
       type: z.ZodString;
       name: z.ZodString;
     }, z.core.$strip>]>;
-    reference_image: z.ZodOptional<z.ZodUnion<readonly [z.ZodCustom<File, File>, z.ZodCustom<Blob, Blob>, z.ZodCustom<ReadableStream<unknown>, ReadableStream<unknown>>, z.ZodCustom<URL, URL>, z.ZodURL, z.ZodObject<{
+    reference_image: z.ZodOptional<z.ZodUnion<readonly [z.ZodType<File, unknown, z.core.$ZodTypeInternals<File, unknown>>, z.ZodType<Blob, unknown, z.core.$ZodTypeInternals<Blob, unknown>>, z.ZodType<ReadableStream<any>, unknown, z.core.$ZodTypeInternals<ReadableStream<any>, unknown>>, z.ZodType<URL, unknown, z.core.$ZodTypeInternals<URL, unknown>>, z.ZodURL, z.ZodObject<{
       uri: z.ZodString;
       type: z.ZodString;
       name: z.ZodString;
@@ -283,12 +282,12 @@ declare const modelInputSchemas: {
   }, z.core.$strip>;
   readonly "lucy-pro-i2i": z.ZodObject<{
     prompt: z.ZodString;
-    data: z.ZodUnion<readonly [z.ZodCustom<File, File>, z.ZodCustom<Blob, Blob>, z.ZodCustom<ReadableStream<unknown>, ReadableStream<unknown>>, z.ZodCustom<URL, URL>, z.ZodURL, z.ZodObject<{
+    data: z.ZodUnion<readonly [z.ZodType<File, unknown, z.core.$ZodTypeInternals<File, unknown>>, z.ZodType<Blob, unknown, z.core.$ZodTypeInternals<Blob, unknown>>, z.ZodType<ReadableStream<any>, unknown, z.core.$ZodTypeInternals<ReadableStream<any>, unknown>>, z.ZodType<URL, unknown, z.core.$ZodTypeInternals<URL, unknown>>, z.ZodURL, z.ZodObject<{
       uri: z.ZodString;
       type: z.ZodString;
       name: z.ZodString;
     }, z.core.$strip>]>;
-    reference_image: z.ZodOptional<z.ZodUnion<readonly [z.ZodCustom<File, File>, z.ZodCustom<Blob, Blob>, z.ZodCustom<ReadableStream<unknown>, ReadableStream<unknown>>, z.ZodCustom<URL, URL>, z.ZodURL, z.ZodObject<{
+    reference_image: z.ZodOptional<z.ZodUnion<readonly [z.ZodType<File, unknown, z.core.$ZodTypeInternals<File, unknown>>, z.ZodType<Blob, unknown, z.core.$ZodTypeInternals<Blob, unknown>>, z.ZodType<ReadableStream<any>, unknown, z.core.$ZodTypeInternals<ReadableStream<any>, unknown>>, z.ZodType<URL, unknown, z.core.$ZodTypeInternals<URL, unknown>>, z.ZodURL, z.ZodObject<{
       uri: z.ZodString;
       type: z.ZodString;
       name: z.ZodString;
@@ -302,12 +301,12 @@ declare const modelInputSchemas: {
   }, z.core.$strip>;
   readonly "lucy-restyle-v2v": z.ZodObject<{
     prompt: z.ZodOptional<z.ZodString>;
-    reference_image: z.ZodOptional<z.ZodUnion<readonly [z.ZodCustom<File, File>, z.ZodCustom<Blob, Blob>, z.ZodCustom<ReadableStream<unknown>, ReadableStream<unknown>>, z.ZodCustom<URL, URL>, z.ZodURL, z.ZodObject<{
+    reference_image: z.ZodOptional<z.ZodUnion<readonly [z.ZodType<File, unknown, z.core.$ZodTypeInternals<File, unknown>>, z.ZodType<Blob, unknown, z.core.$ZodTypeInternals<Blob, unknown>>, z.ZodType<ReadableStream<any>, unknown, z.core.$ZodTypeInternals<ReadableStream<any>, unknown>>, z.ZodType<URL, unknown, z.core.$ZodTypeInternals<URL, unknown>>, z.ZodURL, z.ZodObject<{
       uri: z.ZodString;
       type: z.ZodString;
       name: z.ZodString;
     }, z.core.$strip>]>>;
-    data: z.ZodUnion<readonly [z.ZodCustom<File, File>, z.ZodCustom<Blob, Blob>, z.ZodCustom<ReadableStream<unknown>, ReadableStream<unknown>>, z.ZodCustom<URL, URL>, z.ZodURL, z.ZodObject<{
+    data: z.ZodUnion<readonly [z.ZodType<File, unknown, z.core.$ZodTypeInternals<File, unknown>>, z.ZodType<Blob, unknown, z.core.$ZodTypeInternals<Blob, unknown>>, z.ZodType<ReadableStream<any>, unknown, z.core.$ZodTypeInternals<ReadableStream<any>, unknown>>, z.ZodType<URL, unknown, z.core.$ZodTypeInternals<URL, unknown>>, z.ZodURL, z.ZodObject<{
       uri: z.ZodString;
       type: z.ZodString;
       name: z.ZodString;
@@ -333,6 +332,7 @@ type ModelDefinition<T extends Model = Model> = {
   height: number;
   inputSchema: T extends keyof ModelInputSchemas ? ModelInputSchemas[T] : z.ZodTypeAny;
 };
+declare function resolveFpsNumber(fps: ModelFps, fallback?: number): number;
 /**
  * A model definition with an arbitrary (non-registry) model name.
  * Use this when providing your own model configuration.
@@ -411,4 +411,4 @@ declare const models: {
   };
 };
 //#endregion
-export { CanonicalModel, CustomModelDefinition, ImageModelDefinition, ImageModels, ListedModelDefinition, Model, ModelDefinition, ModelInputSchemas, ModelKind, RealTimeModels, VideoModelDefinition, VideoModels, isCanonicalModel, isImageModel, isModel, isRealtimeModel, isVideoModel, listModels, modelAliases, models, resolveCanonicalModelAlias, resolveModelAlias };
+export { CanonicalModel, CustomModelDefinition, ImageModelDefinition, ImageModels, ListedModelDefinition, Model, ModelDefinition, ModelFps, ModelInputSchemas, ModelKind, RealTimeModels, VideoModelDefinition, VideoModels, isCanonicalModel, isImageModel, isModel, isRealtimeModel, isVideoModel, listModels, modelAliases, models, resolveCanonicalModelAlias, resolveFpsNumber, resolveModelAlias };