@decartai/sdk 0.0.7 → 0.0.12

package/README.md

@@ -82,6 +82,34 @@ const result = await client.process({
 videoElement.src = URL.createObjectURL(result);
 ```
 
+## Development
+
+### Setup
+
+```bash
+pnpm install
+```
+
+### Development Commands
+
+- `pnpm build` - Build the project
+- `pnpm dev:example` - Run Vite dev server for examples
+- `pnpm test` - Run unit tests
+- `pnpm test:e2e` - Run end-to-end tests
+- `pnpm typecheck` - Type check with TypeScript
+- `pnpm format` - Format code with Biome
+- `pnpm lint` - Lint code with Biome
+
+### Publishing
+
+1. **Version bump**: Run `pnpm release` to bump the version (this uses `bumpp` to create a new version tag) and push it to GitHub
+2. **Automated publish**: The GitHub Actions workflow will:
+   - Build the project
+   - Publish to npm
+   - Create a GitHub release with changelog
+
+The package is published to npm as `@decartai/sdk`.
+
 ## License
 
 MIT

package/dist/index.d.ts

@@ -10,12 +10,25 @@ import { z } from "zod";
 declare const decartClientOptionsSchema: z.ZodObject<{
   apiKey: z.ZodString;
   baseUrl: z.ZodOptional<z.ZodURL>;
+  integration: z.ZodOptional<z.ZodString>;
 }, z.core.$strip>;
 type DecartClientOptions = z.infer<typeof decartClientOptionsSchema>;
 declare const createDecartClient: (options: DecartClientOptions) => {
   realtime: {
     connect: (stream: MediaStream, options: RealTimeClientConnectOptions) => Promise<RealTimeClient>;
   };
+  /**
+   * Client for video and image generation.
+   *
+   * @example
+   * ```ts
+   * const client = createDecartClient({ apiKey: "your-api-key" });
+   * const result = await client.process({
+   *   model: models.video("lucy-pro-t2v"),
+   *   prompt: "A beautiful sunset over the ocean"
+   * });
+   * ```
+   */
   process: ProcessClient;
 };
 //#endregion

package/dist/index.js

@@ -7,7 +7,8 @@ import { z } from "zod";
 //#region src/index.ts
 const decartClientOptionsSchema = z.object({
 	apiKey: z.string().min(1),
-	baseUrl: z.url().optional()
+	baseUrl: z.url().optional(),
+	integration: z.string().optional()
 });
 const createDecartClient = (options) => {
 	const parsedOptions = decartClientOptionsSchema.safeParse(options);
@@ -17,14 +18,16 @@ const createDecartClient = (options) => {
 		if (issue.path.includes("baseUrl")) throw createInvalidBaseUrlError(options.baseUrl);
 		throw parsedOptions.error;
 	}
-	const { baseUrl = "https://api.decart.ai", apiKey } = parsedOptions.data;
+	const { baseUrl = "https://api.decart.ai", apiKey, integration } = parsedOptions.data;
 	const realtime = createRealTimeClient({
 		baseUrl: "wss://api3.decart.ai",
-		apiKey
+		apiKey,
+		integration
 	});
 	const process = createProcessClient({
 		baseUrl,
-		apiKey
+		apiKey,
+		integration
 	});
 	return {
 		realtime,

package/dist/process/client.js

@@ -3,7 +3,7 @@ import { fileInputToBlob, sendRequest } from "./request.js";
 
 //#region src/process/client.ts
 const createProcessClient = (opts) => {
-	const { apiKey, baseUrl } = opts;
+	const { apiKey, baseUrl, integration } = opts;
 	const _process = async (options) => {
 		const { model, signal,...inputs } = options;
 		const parsedInputs = model.inputSchema.safeParse(inputs);
@@ -16,7 +16,8 @@ const createProcessClient = (opts) => {
 			apiKey,
 			model,
 			inputs: processedInputs,
-			signal
+			signal,
+			integration
 		});
 	};
 	return _process;

package/dist/process/request.js

@@ -1,4 +1,5 @@
 import { createInvalidInputError, createSDKError } from "../utils/errors.js";
+import { buildUserAgent } from "../utils/user-agent.js";
 
 //#region src/process/request.ts
 async function fileInputToBlob(input) {
@@ -13,14 +14,17 @@ async function fileInputToBlob(input) {
 	}
 	throw createInvalidInputError("Invalid file input type");
 }
-async function sendRequest({ baseUrl, apiKey, model, inputs, signal }) {
+async function sendRequest({ baseUrl, apiKey, model, inputs, signal, integration }) {
 	const formData = new FormData();
 	for (const [key, value] of Object.entries(inputs)) if (value !== void 0 && value !== null) if (value instanceof Blob) formData.append(key, value);
 	else formData.append(key, String(value));
 	const endpoint = `${baseUrl}${model.urlPath}`;
 	const response = await fetch(endpoint, {
 		method: "POST",
-		headers: { "X-API-KEY": apiKey },
+		headers: {
+			"X-API-KEY": apiKey,
+			"User-Agent": buildUserAgent(integration)
+		},
 		body: formData,
 		signal
 	});

package/dist/process/types.d.ts

@@ -1,12 +1,145 @@
-import { ModelDefinition, ModelInputSchemas } from "../shared/model.js";
+import { ImageModels, ModelDefinition, ModelInputSchemas, VideoModels } from "../shared/model.js";
 import { z } from "zod";
 
 //#region src/process/types.d.ts
+type FileInput = File | Blob | ReadableStream | URL | string;
 type InferModelInputs<T extends ModelDefinition> = T["name"] extends keyof ModelInputSchemas ? z.input<ModelInputSchemas[T["name"]]> : Record<string, never>;
+/**
+ * Model-specific input documentation for image generation models.
+ */
+interface ImageGenerationInputs {
+  /**
+   * Text description to use for the generation.
+   *
+   * See our [Prompt Engineering](https://docs.platform.decart.ai/models/image/image-generation#prompt-engineering) guide for how to write prompt for Decart image models effectively.
+   */
+  prompt: string;
+}
+/**
+ * Model-specific input documentation for image editing models.
+ */
+interface ImageEditingInputs {
+  /**
+   * Text description of the changes to apply to the image.
+   *
+   * It's highly recommended to read our [Prompt Engineering for Edits](https://docs.platform.decart.ai/models/image/image-editing#prompt-engineering-for-edits) guide for how to write effective editing prompts.
+   */
+  prompt: string;
+}
+/**
+ * Model-specific input documentation for video models.
+ */
+interface VideoModelInputs {
+  /**
+   * Text description to use for the generation.
+   *
+   * See our [Prompt Engineering](https://docs.platform.decart.ai/models/video/video-generation#prompt-engineering) guide for how to write prompt for Decart video models effectively.
+   */
+  prompt: string;
+}
+/**
+ * Default inputs for models that only require a prompt.
+ */
+interface PromptInput {
+  /**
+   * Text description to use for the generation.
+   */
+  prompt: string;
+}
+/**
+ * Conditional type that selects the appropriate model-specific input documentation based on the model type.
+ * This allows different models to have field-specific documentation while maintaining type safety.
+ * Specific models are checked first, then falls back to category-based selection.
+ */
+type ModelSpecificInputs<T extends ModelDefinition> = T["name"] extends "lucy-pro-i2i" ? ImageEditingInputs : T["name"] extends ImageModels ? ImageGenerationInputs : T["name"] extends VideoModels ? VideoModelInputs : PromptInput;
+interface ProcessInputs {
+  /**
+   * Random seed for reproducible results.
+   *
+   * Using the same seed with the same prompt and settings will produce the same output every time.
+   * This is useful for testing, debugging, or when you want to recreate a specific result.
+   *
+   */
+  seed?: number;
+  /**
+   * The output resolution to use for the generation.
+   *
+   * @default "720p"
+   */
+  resolution?: "480p" | "720p";
+  /**
+   * The output orientation to use for the generation.
+   *
+   * @default "landscape"
+   */
+  orientation?: "landscape" | "portrait";
+  /**
+   * The data to use for generation (for image-to-image and video-to-video).
+   * Can be a File, Blob, ReadableStream, URL, or string URL.
+   */
+  data?: FileInput;
+  /**
+   * The start frame image (for first-last-frame models).
+   * Can be a File, Blob, ReadableStream, URL, or string URL.
+   */
+  start?: FileInput;
+  /**
+   * The end frame image (for first-last-frame models).
+   * Can be a File, Blob, ReadableStream, URL, or string URL.
+   */
+  end?: FileInput;
+  /**
+   * Whether to enhance the prompt.
+   *
+   * @remarks
+   * For best results, keep this `true` (default) to let Decart's AI enhance your prompts.
+   * Only disable it if you need exact prompt control.
+   *
+   * @default true
+   */
+  enhance_prompt?: boolean;
+  /**
+   * The number of inference steps.
+   *
+   * @default 50
+   */
+  num_inference_steps?: number;
+}
+/**
+ * ProcessInputs combined with model-specific inputs.
+ * This ensures fields have the correct descriptions based on the model type.
+ * Add fields to ImageGenerationInputs, ImageEditingInputs, VideoModelInputs, or PromptInput
+ * to provide model-specific documentation for any field.
+ */
+type ModelSpecificProcessInputs<T extends ModelDefinition> = ProcessInputs & ModelSpecificInputs<T>;
+/**
+ * Pick only the fields from ModelSpecificProcessInputs that exist in the inferred model inputs,
+ * so JSDoc comments will be preserved, while type inference will be accurate.
+ */
+type PickDocumentedInputs<T extends ModelDefinition> = Pick<ModelSpecificProcessInputs<T>, keyof ModelSpecificProcessInputs<T> & keyof InferModelInputs<T>>;
+/**
+ * Merge documented inputs with inferred inputs, ensuring zod types take precedence
+ * while preserving JSDoc comments from ModelSpecificProcessInputs.
+ *
+ * By intersecting PickDocumentedInputs with InferModelInputs, we get:
+ * - JSDoc comments from ModelSpecificProcessInputs (from PickDocumentedInputs)
+ * - Accurate types from zod schemas (from InferModelInputs, takes precedence in intersection)
+ */
+type MergeDocumentedInputs<T extends ModelDefinition> = PickDocumentedInputs<T> & InferModelInputs<T>;
+/**
+ * Options for the process client to generate video or image content.
+ *
+ * @template T - The model definition type
+ */
 type ProcessOptions<T extends ModelDefinition = ModelDefinition> = {
+  /**
+   * The model definition to use.
+   */
   model: T;
+  /**
+   * Optional `AbortSignal` for canceling the request.
+   */
   signal?: AbortSignal;
-} & InferModelInputs<T>;
-type FileInput = File | Blob | ReadableStream | URL | string;
+} & MergeDocumentedInputs<T>;
 //#endregion
 export { FileInput, ProcessOptions };

package/dist/realtime/client.js

@@ -17,7 +17,7 @@ const realTimeClientConnectOptionsSchema = z.object({
 	customizeOffer: createAsyncFunctionSchema(z.function()).optional()
 });
 const createRealTimeClient = (opts) => {
-	const { baseUrl, apiKey } = opts;
+	const { baseUrl, apiKey, integration } = opts;
 	const connect = async (stream, options) => {
 		const eventEmitter = mitt();
 		const parsedOptions = realTimeClientConnectOptionsSchema.safeParse(options);
@@ -31,6 +31,7 @@ const createRealTimeClient = (opts) => {
 			sessionId,
 			fps: options.model.fps,
 			initialState,
+			integration,
 			onRemoteStream,
 			onConnectionStateChange: (state) => {
 				eventEmitter.emit("connectionChange", state);

package/dist/realtime/webrtc-connection.js

@@ -1,3 +1,5 @@
+import { buildUserAgent } from "../utils/user-agent.js";
+
 //#region src/realtime/webrtc-connection.ts
 const ICE_SERVERS = [{ urls: "stun:stun.l.google.com:19302" }];
 var WebRTCConnection = class {
@@ -9,13 +11,16 @@ var WebRTCConnection = class {
 	constructor(callbacks = {}) {
 		this.callbacks = callbacks;
 	}
-	async connect(url, localStream, timeout = 25e3) {
+	async connect(url, localStream, timeout = 25e3, integration) {
 		const deadline = Date.now() + timeout;
 		this.localStream = localStream;
+		const userAgent = encodeURIComponent(buildUserAgent(integration));
+		const separator = url.includes("?") ? "&" : "?";
+		const wsUrl = `${url}${separator}user_agent=${userAgent}`;
 		await new Promise((resolve, reject) => {
 			this.connectionReject = reject;
 			const timer = setTimeout(() => reject(/* @__PURE__ */ new Error("WebSocket timeout")), timeout);
-			this.ws = new WebSocket(url);
+			this.ws = new WebSocket(wsUrl);
 			this.ws.onopen = () => {
 				clearTimeout(timer);
 				resolve();

package/dist/realtime/webrtc-manager.js

@@ -24,7 +24,7 @@ var WebRTCManager = class {
 	}
 	async connect(localStream) {
 		return pRetry(async () => {
-			await this.connection.connect(this.config.webrtcUrl, localStream);
+			await this.connection.connect(this.config.webrtcUrl, localStream, 25e3, this.config.integration);
 			return true;
 		}, {
 			retries: 5,

package/dist/shared/model.d.ts

@@ -13,32 +13,44 @@ declare const modelInputSchemas: {
   readonly "lucy-pro-t2v": z.ZodObject<{
     prompt: z.ZodString;
     seed: z.ZodOptional<z.ZodNumber>;
-    resolution: z.ZodOptional<z.ZodString>;
+    resolution: z.ZodDefault<z.ZodOptional<z.ZodEnum<{
+      "720p": "720p";
+      "480p": "480p";
+    }>>>;
     orientation: z.ZodOptional<z.ZodString>;
   }, z.core.$strip>;
   readonly "lucy-pro-t2i": z.ZodObject<{
     prompt: z.ZodString;
     seed: z.ZodOptional<z.ZodNumber>;
-    resolution: z.ZodOptional<z.ZodString>;
+    resolution: z.ZodDefault<z.ZodOptional<z.ZodEnum<{
+      "720p": "720p";
+      "480p": "480p";
+    }>>>;
     orientation: z.ZodOptional<z.ZodString>;
   }, z.core.$strip>;
   readonly "lucy-pro-i2v": 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]>;
     seed: z.ZodOptional<z.ZodNumber>;
-    resolution: z.ZodOptional<z.ZodString>;
+    resolution: z.ZodDefault<z.ZodOptional<z.ZodEnum<{
+      "720p": "720p";
+      "480p": "480p";
+    }>>>;
   }, z.core.$strip>;
   readonly "lucy-dev-i2v": 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]>;
     seed: z.ZodOptional<z.ZodNumber>;
-    resolution: z.ZodOptional<z.ZodString>;
+    resolution: z.ZodOptional<z.ZodDefault<z.ZodLiteral<"720p">>>;
   }, 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]>;
     seed: z.ZodOptional<z.ZodNumber>;
-    resolution: z.ZodOptional<z.ZodString>;
+    resolution: z.ZodDefault<z.ZodOptional<z.ZodEnum<{
+      "720p": "720p";
+      "480p": "480p";
+    }>>>;
     enhance_prompt: z.ZodOptional<z.ZodBoolean>;
     num_inference_steps: z.ZodOptional<z.ZodNumber>;
   }, z.core.$strip>;
@@ -46,7 +58,7 @@ declare const modelInputSchemas: {
     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]>;
     seed: z.ZodOptional<z.ZodNumber>;
-    resolution: z.ZodOptional<z.ZodString>;
+    resolution: z.ZodOptional<z.ZodDefault<z.ZodLiteral<"720p">>>;
     enhance_prompt: z.ZodOptional<z.ZodBoolean>;
   }, z.core.$strip>;
   readonly "lucy-pro-flf2v": z.ZodObject<{
@@ -54,13 +66,19 @@ declare const modelInputSchemas: {
     start: z.ZodUnion<readonly [z.ZodCustom<File, File>, z.ZodCustom<Blob, Blob>, z.ZodCustom<ReadableStream<unknown>, ReadableStream<unknown>>, z.ZodCustom<URL, URL>, z.ZodURL]>;
     end: z.ZodUnion<readonly [z.ZodCustom<File, File>, z.ZodCustom<Blob, Blob>, z.ZodCustom<ReadableStream<unknown>, ReadableStream<unknown>>, z.ZodCustom<URL, URL>, z.ZodURL]>;
     seed: z.ZodOptional<z.ZodNumber>;
-    resolution: z.ZodOptional<z.ZodString>;
+    resolution: z.ZodDefault<z.ZodOptional<z.ZodEnum<{
+      "720p": "720p";
+      "480p": "480p";
+    }>>>;
   }, 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]>;
     seed: z.ZodOptional<z.ZodNumber>;
-    resolution: z.ZodOptional<z.ZodString>;
+    resolution: z.ZodDefault<z.ZodOptional<z.ZodEnum<{
+      "720p": "720p";
+      "480p": "480p";
+    }>>>;
     enhance_prompt: z.ZodOptional<z.ZodBoolean>;
   }, z.core.$strip>;
 };
@@ -71,11 +89,29 @@ type ModelDefinition<T extends Model = Model> = {
   fps: number;
   width: number;
   height: number;
-  inputSchema: T extends keyof ModelInputSchemas ? ModelInputSchemas[T] : z.ZodObject<any>;
+  inputSchema: T extends keyof ModelInputSchemas ? ModelInputSchemas[T] : z.ZodTypeAny;
 };
 declare const models: {
   realtime: <T extends RealTimeModels>(model: T) => ModelDefinition<T>;
+  /**
+   * Get a video model identifier.
+   *
+   * Available options:
+   *   - `"lucy-pro-t2v"` - Text-to-video
+   *   - `"lucy-pro-i2v"` - Image-to-video
+   *   - `"lucy-pro-v2v"` - Video-to-video
+   *   - `"lucy-pro-flf2v"` - First-last-frame-to-video
+   * 	 - `"lucy-dev-i2v"` - Image-to-video (Dev quality)
+   *   - `"lucy-dev-v2v"` - Video-to-video (Dev quality)
+   */
   video: <T extends VideoModels>(model: T) => ModelDefinition<T>;
+  /**
+   * Get an image model identifier.
+   *
+   * Available options:
+   *   - `"lucy-pro-t2i"` - Text-to-image
+   *   - `"lucy-pro-i2i"` - Image-to-image
+   */
   image: <T extends ImageModels>(model: T) => ModelDefinition<T>;
 };
 //#endregion

package/dist/shared/model.js

@@ -28,59 +28,74 @@ const fileInputSchema = z.union([
 	z.instanceof(URL),
 	z.url()
 ]);
+/**
+* Resolution schema for dev models. Supports only 720p.
+*/
+const devResolutionSchema = z.literal("720p").default("720p").optional().describe("The resolution to use for the generation. For dev models, only `720p` is supported.");
+/**
+* Resolution schema for pro models.
+* @param defaultValue - Optional default value (e.g., "720p")
+*/
+const proResolutionSchema = () => {
+	return z.enum(["720p", "480p"]).optional().describe("The resolution to use for the generation").default("720p");
+};
+/**
+* Resolution schema for lucy-pro-v2v (supports 720p and 480p).
+*/
+const proV2vResolutionSchema = z.enum(["720p", "480p"]).optional().describe("The resolution to use for the generation").default("720p");
 const modelInputSchemas = {
 	"lucy-pro-t2v": z.object({
-		prompt: z.string(),
-		seed: z.number().optional(),
-		resolution: z.string().optional(),
-		orientation: z.string().optional()
+		prompt: z.string().describe("The prompt to use for the generation"),
+		seed: z.number().optional().describe("The seed to use for the generation"),
+		resolution: proResolutionSchema(),
+		orientation: z.string().optional().describe("The orientation to use for the generation")
 	}),
 	"lucy-pro-t2i": z.object({
-		prompt: z.string(),
-		seed: z.number().optional(),
-		resolution: z.string().optional(),
-		orientation: z.string().optional()
+		prompt: z.string().describe("The prompt to use for the generation"),
+		seed: z.number().optional().describe("The seed to use for the generation"),
+		resolution: proResolutionSchema(),
+		orientation: z.string().optional().describe("The orientation to use for the generation")
 	}),
 	"lucy-pro-i2v": z.object({
-		prompt: z.string(),
-		data: fileInputSchema,
-		seed: z.number().optional(),
-		resolution: z.string().optional()
+		prompt: z.string().describe("The prompt to use for the generation"),
+		data: fileInputSchema.describe("The image data to use for generation (File, Blob, ReadableStream, URL, or string URL)"),
+		seed: z.number().optional().describe("The seed to use for the generation"),
+		resolution: proResolutionSchema()
 	}),
 	"lucy-dev-i2v": z.object({
-		prompt: z.string(),
-		data: fileInputSchema,
-		seed: z.number().optional(),
-		resolution: z.string().optional()
+		prompt: z.string().describe("The prompt to use for the generation"),
+		data: fileInputSchema.describe("The image data to use for generation (File, Blob, ReadableStream, URL, or string URL)"),
+		seed: z.number().optional().describe("The seed to use for the generation"),
+		resolution: devResolutionSchema
 	}),
 	"lucy-pro-v2v": z.object({
-		prompt: z.string(),
-		data: fileInputSchema,
-		seed: z.number().optional(),
-		resolution: z.string().optional(),
-		enhance_prompt: z.boolean().optional(),
-		num_inference_steps: z.number().optional()
+		prompt: z.string().describe("The prompt to use for the generation"),
+		data: fileInputSchema.describe("The video data to use for generation (File, Blob, ReadableStream, URL, or string URL)"),
+		seed: z.number().optional().describe("The seed to use for the generation"),
+		resolution: proV2vResolutionSchema,
+		enhance_prompt: z.boolean().optional().describe("Whether to enhance the prompt"),
+		num_inference_steps: z.number().optional().describe("The number of inference steps")
 	}),
 	"lucy-dev-v2v": z.object({
-		prompt: z.string(),
-		data: fileInputSchema,
-		seed: z.number().optional(),
-		resolution: z.string().optional(),
-		enhance_prompt: z.boolean().optional()
+		prompt: z.string().describe("The prompt to use for the generation"),
+		data: fileInputSchema.describe("The video data to use for generation (File, Blob, ReadableStream, URL, or string URL)"),
+		seed: z.number().optional().describe("The seed to use for the generation"),
+		resolution: devResolutionSchema,
+		enhance_prompt: z.boolean().optional().describe("Whether to enhance the prompt")
 	}),
 	"lucy-pro-flf2v": z.object({
-		prompt: z.string(),
-		start: fileInputSchema,
-		end: fileInputSchema,
-		seed: z.number().optional(),
-		resolution: z.string().optional()
+		prompt: z.string().describe("The prompt to use for the generation"),
+		start: fileInputSchema.describe("The start frame image (File, Blob, ReadableStream, URL, or string URL)"),
+		end: fileInputSchema.describe("The end frame image (File, Blob, ReadableStream, URL, or string URL)"),
+		seed: z.number().optional().describe("The seed to use for the generation"),
+		resolution: proResolutionSchema()
 	}),
 	"lucy-pro-i2i": z.object({
-		prompt: z.string(),
-		data: fileInputSchema,
-		seed: z.number().optional(),
-		resolution: z.string().optional(),
-		enhance_prompt: z.boolean().optional()
+		prompt: z.string().describe("The prompt to use for the generation"),
+		data: fileInputSchema.describe("The image data to use for generation (File, Blob, ReadableStream, URL, or string URL)"),
+		seed: z.number().optional().describe("The seed to use for the generation"),
+		resolution: proResolutionSchema(),
+		enhance_prompt: z.boolean().optional().describe("Whether to enhance the prompt")
 	})
 };
 const modelDefinitionSchema = z.object({
@@ -104,7 +119,7 @@ const _models = {
 		mirage_v2: {
 			urlPath: "/v1/stream",
 			name: "mirage_v2",
-			fps: 18,
+			fps: 22,
 			width: 1280,
 			height: 704,
 			inputSchema: z.object({})

package/dist/utils/user-agent.js

@@ -0,0 +1,32 @@
+import { VERSION } from "../version.js";
+
+//#region src/utils/user-agent.ts
+function getRuntimeEnvironment(globalThisAny = globalThis) {
+	if (globalThisAny.window) return "runtime/browser";
+	if (globalThisAny.navigator?.userAgent) return `runtime/${globalThisAny.navigator.userAgent.toLowerCase()}`;
+	if (globalThisAny.process?.versions?.node) return `runtime/node.js/${globalThisAny.process.version.substring(0)}`;
+	if (globalThisAny.EdgeRuntime) return "runtime/vercel-edge";
+	return "runtime/unknown";
+}
+/**
+* Builds the User-Agent string for the SDK.
+* Format: decart-js-sdk/{version} lang/js {integration} {runtime}
+*
+* @param integration - Optional integration identifier (e.g., "vercel-ai-sdk/3.0.0")
+* @param globalThisAny - The global object (defaults to globalThis). Can be mocked for testing.
+* @returns Complete User-Agent string
+* @example
+* buildUserAgent() // => "decart-js-sdk/0.0.7 lang/js runtime/node.js/v18.17.0"
+* buildUserAgent("vercel-ai-sdk/3.0.0") // => "decart-js-sdk/0.0.7 lang/js vercel-ai-sdk/3.0.0 runtime/node.js/v18.17.0"
+*/
+function buildUserAgent(integration, globalThisAny = globalThis) {
+	return [
+		`decart-js-sdk/${VERSION}`,
+		"lang/js",
+		...integration ? [integration] : [],
+		getRuntimeEnvironment(globalThisAny)
+	].join(" ");
+}
+
+//#endregion
+export { buildUserAgent };

package/dist/version.js

@@ -0,0 +1,10 @@
+//#region src/version.ts
+/**
+* The current version of the Decart SDK.
+* Injected at build time from package.json.
+* Falls back to '0.0.0-dev' in development.
+*/
+const VERSION = "0.0.12";
+
+//#endregion
+export { VERSION };

package/package.json

@@ -1,61 +1,60 @@
 {
-	"name": "@decartai/sdk",
-	"version": "0.0.7",
-	"description": "Decart's JavaScript SDK",
-	"type": "module",
-	"license": "MIT",
-	"private": false,
-	"homepage": "https://github.com/decartai/sdk#readme",
-	"bugs": {
-		"url": "https://github.com/decartai/sdk/issues"
-	},
-	"repository": {
-		"type": "git",
-		"url": "git+https://github.com/decartai/sdk.git"
-	},
-	"author": "Adir Amsalem <adir@decart.ai>",
-	"sideEffects": false,
-	"files": [
-		"dist"
-	],
-	"main": "./dist/index.js",
-	"module": "./dist/index.js",
-	"types": "./dist/index.d.ts",
-	"exports": {
-		".": "./dist/index.js",
-		"./package.json": "./package.json"
-	},
-	"publishConfig": {
-		"access": "public"
-	},
-	"scripts": {
-		"build": "tsdown",
-		"dev": "tsdown --watch",
-		"dev:example": "vite dev --port 3000",
-		"test": "vitest unit",
-		"test:e2e": "vitest e2e",
-		"typecheck": "tsc --noEmit",
-		"format": "biome format --write",
-		"format:check": "biome check",
-		"lint": "biome lint",
-		"prepublishOnly": "pnpm build",
-		"release": "bumpp && npm publish"
-	},
-	"devDependencies": {
-		"@types/node": "^22.15.17",
-		"biome": "^0.3.3",
-		"bumpp": "^10.1.0",
-		"msw": "^2.11.3",
-		"pkg-pr-new": "^0.0.56",
-		"tsdown": "^0.14.1",
-		"typescript": "^5.8.3",
-		"vite": "^7.1.2",
-		"vitest": "^3.1.3"
-	},
-	"dependencies": {
-		"mitt": "^3.0.1",
-		"p-retry": "^6.2.1",
-		"uuid": "^11.1.0",
-		"zod": "^4.0.17"
-	}
-}
+  "name": "@decartai/sdk",
+  "version": "0.0.12",
+  "description": "Decart's JavaScript SDK",
+  "type": "module",
+  "license": "MIT",
+  "private": false,
+  "homepage": "https://github.com/decartai/sdk#readme",
+  "bugs": {
+    "url": "https://github.com/decartai/sdk/issues"
+  },
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/DecartAI/sdk"
+  },
+  "author": "Adir Amsalem <adir@decart.ai>",
+  "sideEffects": false,
+  "files": [
+    "dist"
+  ],
+  "main": "./dist/index.js",
+  "module": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": "./dist/index.js",
+    "./package.json": "./package.json"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "devDependencies": {
+    "@types/node": "^22.15.17",
+    "biome": "^0.3.3",
+    "bumpp": "^10.1.0",
+    "msw": "^2.11.3",
+    "pkg-pr-new": "^0.0.56",
+    "tsdown": "^0.14.1",
+    "typescript": "^5.8.3",
+    "vite": "^7.1.2",
+    "vitest": "^3.1.3"
+  },
+  "dependencies": {
+    "mitt": "^3.0.1",
+    "p-retry": "^6.2.1",
+    "uuid": "^11.1.0",
+    "zod": "^4.0.17"
+  },
+  "scripts": {
+    "build": "tsdown",
+    "dev": "tsdown --watch",
+    "dev:example": "vite dev --port 3000",
+    "test": "vitest unit",
+    "test:e2e": "vitest e2e",
+    "typecheck": "tsc --noEmit",
+    "format": "biome format --write",
+    "format:check": "biome check",
+    "lint": "biome lint",
+    "release": "bumpp"
+  }
+}