@byte_fluffy/nexra-sdk 0.1.0-alpha.22 → 0.1.0-alpha.24

package/dist/chunk-TA3YGQQY.js

@@ -0,0 +1,386 @@
+// ../contracts/src/assets.ts
+var MEDIA_KINDS = [
+  "image",
+  "video",
+  "audio",
+  "document",
+  "archive",
+  "other"
+];
+
+// ../contracts/src/media-api.ts
+var NEXRA_MEDIA_API_VERSION = 1;
+var NEXRA_GENERATION_OPERATIONS = [
+  "text.generate",
+  "image.generate",
+  "video.generate",
+  "audio.generate",
+  "image.upscale",
+  "video.upscale"
+];
+var NEXRA_MEDIA_OPERATIONS = [
+  "image.generate",
+  "video.generate",
+  "audio.generate",
+  "image.upscale",
+  "video.upscale"
+];
+var NEXRA_PUBLISHED_MEDIA_OPERATIONS = [
+  "image.generate",
+  "video.generate",
+  "audio.generate",
+  "image.upscale"
+];
+var NEXRA_MEDIA_FEATURES = [
+  "text-to-image",
+  "image-to-image",
+  "image-reference",
+  "image-edit",
+  "image-inpaint",
+  "image-control",
+  "text-to-video",
+  "first-frame",
+  "first-last-frame",
+  "image-to-video",
+  "video-to-video",
+  "audio-to-video",
+  "avatar-video",
+  "reference-image",
+  "reference-video",
+  "reference-audio",
+  "omni-reference",
+  "tts",
+  "music",
+  "sfx",
+  "voice-reference",
+  "scale-factor",
+  "target-resolution"
+];
+var NEXRA_MEDIA_OPERATION_DEFINITIONS = Object.freeze([
+  {
+    operation: "image.generate",
+    status: "active",
+    outputKind: "image",
+    features: ["text-to-image", "image-to-image", "image-reference", "image-edit", "image-inpaint", "image-control"],
+    parameterKeys: ["aspect_ratio", "resolution", "quality", "count", "output_format", "seed"]
+  },
+  {
+    operation: "video.generate",
+    status: "active",
+    outputKind: "video",
+    features: ["text-to-video", "first-frame", "first-last-frame", "image-to-video", "video-to-video", "audio-to-video", "avatar-video", "reference-image", "reference-video", "reference-audio", "omni-reference"],
+    parameterKeys: ["voice", "aspect_ratio", "resolution", "quality", "duration", "generate_audio", "output_format", "seed"]
+  },
+  {
+    operation: "audio.generate",
+    status: "active",
+    outputKind: "audio",
+    features: ["tts", "music", "sfx", "voice-reference"],
+    parameterKeys: ["voice", "language", "duration", "output_format", "sample_rate", "speed", "volume", "pitch", "emotion", "instrumental", "loop", "prompt_influence", "seed"]
+  },
+  {
+    operation: "image.upscale",
+    status: "active",
+    outputKind: "image",
+    features: ["scale-factor", "target-resolution"],
+    parameterKeys: ["scale", "resolution", "output_format", "preserve_details"]
+  },
+  {
+    operation: "video.upscale",
+    status: "hold",
+    outputKind: "video",
+    features: ["scale-factor", "target-resolution"],
+    parameterKeys: ["scale", "resolution", "output_format", "preserve_details"]
+  }
+]);
+var mediaSourceSchema = {
+  oneOf: [
+    { type: "string", minLength: 1 },
+    {
+      type: "object",
+      properties: { assetId: { type: "string", minLength: 1 } },
+      required: ["assetId"],
+      additionalProperties: false
+    }
+  ]
+};
+function textPartSchema(roles) {
+  return {
+    type: "object",
+    properties: {
+      type: { const: "text" },
+      text: { type: "string", minLength: 1 },
+      role: { type: "string", enum: [...roles] }
+    },
+    required: ["type", "text"],
+    additionalProperties: false
+  };
+}
+function mediaPartSchema(type, roles) {
+  return {
+    type: "object",
+    properties: {
+      type: { const: type },
+      source: structuredClone(mediaSourceSchema),
+      role: { type: "string", enum: [...roles] },
+      ...type === "image" ? { name: { type: "string", minLength: 1, maxLength: 64, pattern: "^[^\\s@]+$" } } : {}
+    },
+    required: ["type", "source"],
+    additionalProperties: false
+  };
+}
+function inputSchema(contentItems, properties, contentBounds = {}) {
+  return {
+    $schema: "https://json-schema.org/draft/2020-12/schema",
+    type: "object",
+    properties: {
+      content: {
+        type: "array",
+        minItems: contentBounds.minItems ?? 1,
+        ...contentBounds.maxItems === void 0 ? {} : { maxItems: contentBounds.maxItems },
+        items: { oneOf: contentItems.map((item) => structuredClone(item)) },
+        "x-ui": { control: "content-parts", order: 0 }
+      },
+      ...properties
+    },
+    required: ["content"],
+    additionalProperties: false
+  };
+}
+var imagePart = mediaPartSchema("image", ["source", "reference", "first_frame", "last_frame", "mask", "control", "subject", "background"]);
+var videoPart = mediaPartSchema("video", ["source", "reference", "edit", "extend"]);
+var audioPart = mediaPartSchema("audio", ["source", "reference", "voice_reference"]);
+var draftPart = {
+  type: "object",
+  properties: {
+    type: { const: "draft_task" },
+    draft_task: { type: "object", properties: { id: { type: "string", minLength: 1 } }, required: ["id"], additionalProperties: false }
+  },
+  required: ["type", "draft_task"],
+  additionalProperties: false
+};
+var NEXRA_MEDIA_INPUT_SCHEMAS = Object.freeze({
+  "image.generate": inputSchema(
+    [textPartSchema(["prompt", "negative_prompt"]), imagePart],
+    {
+      aspect_ratio: { type: "string", minLength: 1, "x-ui": { order: 10 } },
+      resolution: { type: "string", minLength: 1, "x-ui": { order: 11 } },
+      quality: { type: "string", minLength: 1, "x-ui": { order: 12 } },
+      count: { type: "integer", minimum: 1, "x-ui": { order: 13, control: "number" } },
+      output_format: { type: "string", minLength: 1, "x-ui": { order: 14 } },
+      seed: { type: "integer", minimum: 0, "x-ui": { order: 15, control: "number" } }
+    }
+  ),
+  "video.generate": inputSchema(
+    [textPartSchema(["prompt", "negative_prompt", "script"]), imagePart, videoPart, audioPart, draftPart],
+    {
+      voice: { type: "string", minLength: 1, "x-ui": { order: 9, control: "resource", resource: "voice" } },
+      draft: { type: "boolean", "x-ui": { control: "switch" } },
+      aspect_ratio: { type: "string", minLength: 1, "x-ui": { order: 10 } },
+      resolution: { type: "string", minLength: 1, "x-ui": { order: 11 } },
+      quality: { type: "string", minLength: 1, "x-ui": { order: 12 } },
+      duration: { type: "number", exclusiveMinimum: 0, "x-ui": { order: 13, control: "number" } },
+      generate_audio: { type: "boolean", "x-ui": { order: 14, control: "switch" } },
+      output_format: { type: "string", minLength: 1, "x-ui": { order: 15 } },
+      seed: { type: "integer", minimum: 0, "x-ui": { order: 16, control: "number" } }
+    }
+  ),
+  "audio.generate": inputSchema(
+    [textPartSchema(["prompt", "script", "lyrics"]), audioPart],
+    {
+      voice: { type: "string", minLength: 1, "x-ui": { order: 10, control: "resource", resource: "voice" } },
+      language: { type: "string", minLength: 1, "x-ui": { order: 11 } },
+      duration: { type: "number", exclusiveMinimum: 0, "x-ui": { order: 12, control: "number" } },
+      output_format: { type: "string", minLength: 1, "x-ui": { order: 13 } },
+      sample_rate: { type: "integer", minimum: 1, "x-ui": { order: 14, control: "number" } },
+      speed: { type: "number", exclusiveMinimum: 0, "x-ui": { order: 15, control: "number" } },
+      volume: { type: "number", "x-ui": { order: 16, control: "number" } },
+      pitch: { type: "number", "x-ui": { order: 17, control: "number" } },
+      emotion: { type: "string", minLength: 1, "x-ui": { order: 18 } },
+      instrumental: { type: "boolean", "x-ui": { order: 19, control: "switch" } },
+      loop: { type: "boolean", "x-ui": { order: 20, control: "switch" } },
+      prompt_influence: { type: "number", minimum: 0, maximum: 1, "x-ui": { order: 21, control: "number" } },
+      seed: { type: "integer", minimum: 0, "x-ui": { order: 22, control: "number" } }
+    }
+  ),
+  "image.upscale": inputSchema(
+    [mediaPartSchema("image", ["source"])],
+    {
+      scale: { type: "number", exclusiveMinimum: 1, "x-ui": { order: 10, control: "number" } },
+      resolution: { type: "string", minLength: 1, "x-ui": { order: 11 } },
+      output_format: { type: "string", minLength: 1, "x-ui": { order: 12 } },
+      preserve_details: { type: "boolean", "x-ui": { order: 13, control: "switch" } }
+    },
+    { minItems: 1, maxItems: 1 }
+  )
+});
+function nexraMediaInputSchema(operation) {
+  if (!(operation in NEXRA_MEDIA_INPUT_SCHEMAS)) return void 0;
+  return structuredClone(NEXRA_MEDIA_INPUT_SCHEMAS[operation]);
+}
+function isNexraMediaInput(value) {
+  if (!value || typeof value !== "object" || Array.isArray(value)) return false;
+  const input = value;
+  if ("model" in input) return false;
+  const content = input.content;
+  return Array.isArray(content) && content.length > 0 && content.every((part) => {
+    if (!part || typeof part !== "object" || Array.isArray(part)) return false;
+    if (part.type === "text") return typeof part.text === "string" && part.text.length > 0;
+    if (!["image", "video", "audio"].includes(String(part.type))) return false;
+    if (typeof part.source === "string") return part.source.length > 0;
+    return Boolean(part.source && typeof part.source === "object" && !Array.isArray(part.source) && typeof part.source.assetId === "string" && part.source.assetId.length > 0);
+  });
+}
+function nexraMediaOperationForMode(mode) {
+  if (["text-to-image", "image-to-image"].includes(mode)) return "image.generate";
+  if (["text-to-video", "image-to-video", "multimodal-to-video", "avatar-video"].includes(mode)) return "video.generate";
+  if (["text-to-speech", "text-to-music", "text-to-sfx"].includes(mode)) return "audio.generate";
+  if (mode === "image-upscale") return "image.upscale";
+  return void 0;
+}
+function nexraMediaInputSchemaForMode(mode) {
+  const operation = nexraMediaOperationForMode(mode);
+  const schema = operation ? nexraMediaInputSchema(operation) : void 0;
+  if (!schema) return void 0;
+  const properties = schema.properties;
+  const content = properties.content;
+  const items = content.items;
+  const variants = Array.isArray(items.oneOf) ? items.oneOf : [];
+  if (mode === "avatar-video") {
+    for (const variant of variants) {
+      const variantProperties = variant.properties;
+      if (variantProperties.type.const === "text") {
+        variantProperties.role = { type: "string", enum: ["script"] };
+      }
+    }
+  }
+  const allowed = mode === "text-to-image" || mode === "text-to-video" || mode === "text-to-music" || mode === "text-to-sfx" ? /* @__PURE__ */ new Set(["text"]) : mode === "image-to-image" ? /* @__PURE__ */ new Set(["text", "image"]) : mode === "image-to-video" ? /* @__PURE__ */ new Set(["text", "image", "audio"]) : mode === "text-to-speech" ? /* @__PURE__ */ new Set(["text", "audio"]) : /* @__PURE__ */ new Set(["text", "image", "video", "audio"]);
+  items.oneOf = variants.filter((variant) => allowed.has(String(variant.properties.type.const)));
+  if (mode === "image-to-video") {
+    for (const variant of items.oneOf) {
+      const variantProperties = variant.properties;
+      if (variantProperties.type.const !== "image") continue;
+      variantProperties.role = { type: "string", enum: ["first_frame", "last_frame"] };
+      const required = new Set(Array.isArray(variant.required) ? variant.required.filter((key) => typeof key === "string") : []);
+      required.add("role");
+      variant.required = [...required];
+    }
+  }
+  if (mode === "multimodal-to-video") {
+    for (const variant of items.oneOf) {
+      const variantProperties = variant.properties;
+      const type = String(variantProperties.type.const);
+      if (!["image", "video", "audio"].includes(type)) continue;
+      variantProperties.role = type === "image" ? { type: "string", enum: ["reference", "subject", "background"] } : type === "video" ? { type: "string", enum: ["reference", "edit", "extend"] } : { type: "string", const: "reference" };
+      const required = new Set(Array.isArray(variant.required) ? variant.required.filter((key) => typeof key === "string") : []);
+      required.add("role");
+      variant.required = [...required];
+    }
+  }
+  const requiredMedia = mode === "image-to-image" || mode === "image-to-video" || mode === "avatar-video" ? "image" : void 0;
+  const requiresReferenceMedia = mode === "multimodal-to-video";
+  content.allOf = [
+    ...mode === "avatar-video" ? [] : [{
+      contains: { type: "object", properties: { type: { const: "text" } }, required: ["type"] },
+      minContains: 1
+    }],
+    ...requiredMedia ? [{
+      contains: { type: "object", properties: { type: { const: requiredMedia } }, required: ["type"] },
+      minContains: 1
+    }] : [],
+    ...requiresReferenceMedia ? [{
+      contains: { type: "object", properties: { type: { enum: ["image", "video", "audio"] } }, required: ["type"] },
+      minContains: 1
+    }] : []
+  ];
+  if (mode === "text-to-speech") {
+    properties.voice = { ...properties.voice, "x-ui": { order: 10, control: "resource", resource: "voice" } };
+  }
+  const allowedParameters = mode === "avatar-video" ? /* @__PURE__ */ new Set(["content", "voice", "aspect_ratio", "resolution"]) : mode === "text-to-speech" ? /* @__PURE__ */ new Set(["content", "voice", "language", "output_format", "sample_rate", "speed", "volume", "pitch", "emotion"]) : mode === "text-to-music" ? /* @__PURE__ */ new Set(["content", "duration", "output_format", "instrumental", "prompt_influence", "seed"]) : mode === "text-to-sfx" ? /* @__PURE__ */ new Set(["content", "duration", "output_format", "loop", "prompt_influence", "seed"]) : void 0;
+  if (allowedParameters) {
+    schema.properties = Object.fromEntries(Object.entries(properties).filter(([key]) => allowedParameters.has(key)));
+  }
+  return schema;
+}
+
+// ../contracts/src/tasks.ts
+var TASK_STATUSES = [
+  "queued",
+  "running",
+  "succeeded",
+  "failed",
+  "cancelling",
+  "cancelled"
+];
+var CREATE_TASK_CONTROL_FIELDS = [
+  "model",
+  "callback_url",
+  "metadata",
+  "quoteToken",
+  "submittedAt",
+  "schemaVersion",
+  "webhook"
+];
+function createTaskRequest(model, input, controls = {}) {
+  for (const field of [...CREATE_TASK_CONTROL_FIELDS, "input"]) {
+    if (Object.hasOwn(input, field)) {
+      throw new Error(`Nexra model parameters cannot use reserved Task field: ${field}`);
+    }
+  }
+  return { model, ...input, ...controls };
+}
+function isTerminalTaskStatus(status) {
+  return status === "succeeded" || status === "failed" || status === "cancelled";
+}
+
+// ../contracts/src/ratio-display-order.ts
+function parseRatioParts(value) {
+  const matched = /^\s*(\d+(?:\.\d+)?)\s*:\s*(\d+(?:\.\d+)?)\s*$/.exec(value);
+  if (!matched) return void 0;
+  const w = Number(matched[1]);
+  const h = Number(matched[2]);
+  return w > 0 && h > 0 ? { w, h } : void 0;
+}
+function ratioDisplayOrderKey(value) {
+  const normalized = value.trim();
+  const parts = parseRatioParts(normalized);
+  if (!parts) {
+    const auto = normalized.toLowerCase() === "auto" ? 0 : 1;
+    return [0, auto, 0, 0, value];
+  }
+  if (parts.w === parts.h) return [1, 0, 0, 0, value];
+  const long = Math.max(parts.w, parts.h);
+  const short = Math.min(parts.w, parts.h);
+  const landscape = parts.w > parts.h ? 1 : 0;
+  return short === 1 ? [3, long, landscape, -short, value] : [2, long, landscape, -short, value];
+}
+function compareRatioDisplayOrder(a, b) {
+  const ka = ratioDisplayOrderKey(a);
+  const kb = ratioDisplayOrderKey(b);
+  for (let index = 0; index < ka.length; index += 1) {
+    if (ka[index] !== kb[index]) return ka[index] < kb[index] ? -1 : 1;
+  }
+  return 0;
+}
+function sortRatioDisplayOrder(values) {
+  return [...values].sort(compareRatioDisplayOrder);
+}
+
+export {
+  MEDIA_KINDS,
+  NEXRA_MEDIA_API_VERSION,
+  NEXRA_GENERATION_OPERATIONS,
+  NEXRA_MEDIA_OPERATIONS,
+  NEXRA_PUBLISHED_MEDIA_OPERATIONS,
+  NEXRA_MEDIA_FEATURES,
+  NEXRA_MEDIA_OPERATION_DEFINITIONS,
+  NEXRA_MEDIA_INPUT_SCHEMAS,
+  nexraMediaInputSchema,
+  isNexraMediaInput,
+  nexraMediaOperationForMode,
+  nexraMediaInputSchemaForMode,
+  TASK_STATUSES,
+  createTaskRequest,
+  isTerminalTaskStatus,
+  sortRatioDisplayOrder
+};

package/dist/index.d.ts

@@ -1,7 +1,10 @@
-import { A as AssetsClient, T as TasksClient, R as RunTaskOptions, a as RunResult, b as ApiErrorPayload, c as TaskResult } from './types-CcYROaH1.js';
-export { d as AssetImportRequest, e as AssetInput, f as AssetReference, g as AssetUploadOptions, C as CreateTaskOptions, h as CreateTaskRequest, M as MEDIA_KINDS, i as MediaAsset, j as MediaAssetStatus, k as MediaKind, l as RequestDetails, m as TASK_STATUSES, n as Task, o as TaskCost, p as TaskError, q as TaskEvent, r as TaskEventType, s as TaskListParams, t as TaskPage, u as TaskProgress, v as TaskReceipt, w as TaskStatus, x as TaskTiming, y as TaskUsage, z as TaskWebhookConfig, B as TerminalTaskStatus, V as VerifyWebhookOptions, W as WaitTaskOptions, D as WatchTaskOptions, E as isTerminalTaskStatus, F as verifyWebhook } from './types-CcYROaH1.js';
-import { H as HttpTransport, q as ModelSearchParams, r as CursorPage, T as TaskModelSummary, s as TaskModel, t as ModelSchema, u as NexraClientOptions, J as JsonValue } from './media-geometry-Ckr1-Mh3.js';
-export { b as CreateNexraDisplayQuoteBatchRequest, C as CreateNexraQuoteRequest, F as FetchLike, v as JsonObject, w as JsonPrimitive, M as MediaGeometryField, g as MediaGeometryProjection, x as ModelCapabilitySummary, y as ModelDateVersion, z as ModelEndpointSummary, A as ModelModality, B as ModelResourceList, D as ModelResourceOption, h as NexraBillingCurrency, d as NexraCatalogRevision, c as NexraDisplayQuoteBatch, E as NexraDisplayQuoteBatchEntry, j as NexraModelOperation, e as NexraModelSpec, f as NexraModelSpecFilter, a as NexraQuote, k as NexraSalePrice, N as NexraSalePriceList, l as NexraSettlement, U as UnifiedMediaGeometry, m as applyMediaGeometry, n as decodeMediaGeometry, o as encodeMediaGeometry, p as projectMediaGeometry } from './media-geometry-Ckr1-Mh3.js';
+export { a as AssetImportRequest, b as AssetInput, A as AssetReference, c as AssetUploadOptions, M as MEDIA_KINDS, d as MediaAsset, e as MediaAssetStatus, f as MediaKind } from './assets-dUJMQNJD.js';
+import { H as HttpTransport, q as ModelSearchParams, T as TaskModelSummary, r as TaskModel, s as ModelSchema, t as NexraClientOptions } from './media-geometry-Bo6ukeIQ.js';
+export { b as CreateNexraDisplayQuoteBatchRequest, C as CreateNexraQuoteRequest, F as FetchLike, M as MediaGeometryField, g as MediaGeometryProjection, u as ModelCapabilitySummary, v as ModelDateVersion, w as ModelEndpointSummary, x as ModelModality, y as ModelResourceList, z as ModelResourceOption, h as NexraBillingCurrency, d as NexraCatalogRevision, c as NexraDisplayQuoteBatch, A as NexraDisplayQuoteBatchEntry, j as NexraModelOperation, e as NexraModelSpec, f as NexraModelSpecFilter, a as NexraQuote, k as NexraSalePrice, N as NexraSalePriceList, l as NexraSettlement, U as UnifiedMediaGeometry, m as applyMediaGeometry, n as decodeMediaGeometry, o as encodeMediaGeometry, p as projectMediaGeometry } from './media-geometry-Bo6ukeIQ.js';
+import { C as CursorPage, a as JsonValue } from './json-Drjj1OKl.js';
+export { J as JsonObject, b as JsonPrimitive } from './json-Drjj1OKl.js';
+import { A as AssetsClient, T as TasksClient, R as RunTaskOptions, a as RunResult, b as ApiErrorPayload, c as TaskResult } from './types-DPLgTh8D.js';
+export { C as CreateTaskOptions, d as CreateTaskRequest, e as RequestDetails, f as TASK_STATUSES, g as Task, h as TaskCost, i as TaskError, j as TaskEvent, k as TaskEventType, l as TaskListParams, m as TaskPage, n as TaskProgress, o as TaskReceipt, p as TaskStatus, q as TaskTiming, r as TaskUsage, s as TaskWebhookConfig, t as TerminalTaskStatus, V as VerifyWebhookOptions, W as WaitTaskOptions, u as WatchTaskOptions, v as isTerminalTaskStatus, w as verifyWebhook } from './types-DPLgTh8D.js';
 import { CatalogClient } from './catalog.js';
 export { getModelSpec, listModelSpecs } from './catalog.js';
 export { ceilDecimal, multiplyDecimal } from './decimal.js';
@@ -20,7 +23,7 @@ declare class NexraClient {
     readonly models: ModelsClient;
     readonly tasks: TasksClient;
     constructor(options?: NexraClientOptions);
-    run<TOutput = JsonValue, TInput = Record<string, unknown>>(model: string, options: RunTaskOptions<TInput>): Promise<RunResult<TOutput>>;
+    run<TOutput = JsonValue, TInput = Record<string, unknown>>(model: string, input: TInput, options?: RunTaskOptions): Promise<RunResult<TOutput>>;
 }
 declare function createNexra(options?: NexraClientOptions): NexraClient;
 

package/dist/index.js

@@ -1,27 +1,30 @@
 import {
   CatalogClient,
   HttpTransport,
-  MEDIA_KINDS,
   NexraApiError,
   NexraTaskError,
   NexraWaitTimeoutError,
-  TASK_STATUSES,
   applyMediaGeometry,
   applyNoWatermark,
   decodeMediaGeometry,
   encodeMediaGeometry,
   getModelSpec,
-  isTerminalTaskStatus,
   jsonBody,
   listModelSpecs,
   projectMediaGeometry,
   queryString,
   sleep
-} from "./chunk-2DKVYO26.js";
+} from "./chunk-7V2P2UQD.js";
 import {
   ceilDecimal,
   multiplyDecimal
 } from "./chunk-FCH5IQP5.js";
+import {
+  MEDIA_KINDS,
+  TASK_STATUSES,
+  createTaskRequest,
+  isTerminalTaskStatus
+} from "./chunk-TA3YGQQY.js";
 
 // src/assets.ts
 var AssetsClient = class {
@@ -279,28 +282,18 @@ var TasksClient = class {
   }
   transport;
   assets;
-  async create(model, options) {
+  async create(model, input, options = {}) {
     const schema = getModelSpec(model)?.operations[0]?.inputSchema;
-    const mapped = schema && options.input && typeof options.input === "object" && !Array.isArray(options.input) ? applyNoWatermark(schema, applyMediaGeometry(schema, options.input)) : options.input;
-    const input = await normalizeTaskInput(mapped, this.assets, options.signal);
-    if (input.model !== void 0 && input.model !== model) {
-      throw new TypeError(`Task input model ${String(input.model)} does not match ${model}`);
-    }
-    const parameters = { ...input };
-    delete parameters.model;
-    for (const field of ["quoteToken", "submittedAt", "metadata", "callback_url", "webhook", "schemaVersion"]) {
-      if (Object.hasOwn(parameters, field)) throw new TypeError(`Task input cannot use reserved field: ${field}`);
-    }
-    const body = {
-      ...parameters,
-      model,
+    const mapped = schema && input && typeof input === "object" && !Array.isArray(input) ? applyNoWatermark(schema, applyMediaGeometry(schema, input)) : input;
+    const normalizedInput = await normalizeTaskInput(mapped, this.assets, options.signal);
+    const body = createTaskRequest(model, normalizedInput, {
       quoteToken: options.quoteToken,
       submittedAt: options.submittedAt,
       metadata: options.metadata,
       callback_url: options.callback_url,
       webhook: options.webhook,
       schemaVersion: options.schemaVersion
-    };
+    });
     const idempotencyKey = options.idempotencyKey ?? crypto.randomUUID();
     return this.transport.json(
       "/tasks",
@@ -406,8 +399,8 @@ var TasksClient = class {
       if (timeout) clearTimeout(timeout);
     }
   }
-  async run(model, options) {
-    const task = await this.create(model, options);
+  async run(model, input, options = {}) {
+    const task = await this.create(model, input, options);
     let completed;
     try {
       completed = await this.wait(task.id, options);
@@ -448,8 +441,8 @@ var NexraClient = class {
     this.models = new ModelsClient(transport);
     this.tasks = new TasksClient(transport, this.assets);
   }
-  run(model, options) {
-    return this.tasks.run(model, options);
+  run(model, input, options = {}) {
+    return this.tasks.run(model, input, options);
   }
 };
 function createNexra(options = {}) {

package/dist/json-Drjj1OKl.d.ts

@@ -0,0 +1,11 @@
+type JsonPrimitive = boolean | number | string | null;
+type JsonValue = JsonPrimitive | JsonObject | JsonValue[];
+interface JsonObject {
+    [key: string]: JsonValue;
+}
+interface CursorPage<T> {
+    data: T[];
+    nextCursor?: string;
+}
+
+export type { CursorPage as C, JsonObject as J, JsonValue as a, JsonPrimitive as b };

package/dist/{media-geometry-Ckr1-Mh3.d.ts → media-geometry-Bo6ukeIQ.d.ts}

@@ -1,12 +1,4 @@
-type JsonPrimitive = boolean | number | string | null;
-type JsonValue = JsonPrimitive | JsonObject | JsonValue[];
-interface JsonObject {
-    [key: string]: JsonValue;
-}
-interface CursorPage<T> {
-    data: T[];
-    nextCursor?: string;
-}
+import { b as JsonPrimitive, J as JsonObject, a as JsonValue } from './json-Drjj1OKl.js';
 
 declare const BILLING_METRICS: readonly ["requests", "input_tokens", "cached_input_tokens", "cache_write_tokens", "cache_creation_5m_input_tokens", "cache_creation_1h_input_tokens", "cache_read_input_tokens", "output_tokens", "input_characters", "input_utf8_bytes", "input_images", "output_images", "input_audio_seconds", "output_audio_seconds", "input_video_seconds", "output_video_seconds", "provider_credits", "web_search_requests"];
 type BillingMetric = (typeof BILLING_METRICS)[number];
@@ -37,6 +29,27 @@ interface MeteringContract {
 }
 
 type ModelModality = "language" | "embedding" | "reranker" | "image" | "video" | "audio" | "world" | "multimodal" | "other";
+/** A concrete operation of a code-owned endpoint contract, shared by API and UI. */
+type ModelHttpOperation = Readonly<{
+    key: string;
+    kind: "request" | "create" | "query" | "cancel" | "delete" | "stream" | "generate" | "edit";
+    httpMethod: "GET" | "POST" | "PUT" | "PATCH" | "DELETE";
+    pathTemplate: string;
+    schemaProjection: "request" | "bearer-request" | "managed-task-create" | "managed-task-query" | "managed-task-cancel" | "native-task-create" | "native-task-query" | "native-task-delete";
+    responseStatus?: number;
+    idempotencyKey?: boolean;
+    queryParameters?: Readonly<JsonObject>;
+    headerParameters?: Readonly<JsonObject>;
+    pathParameters?: Readonly<JsonObject>;
+    /** Operation-specific body; binary fields describe multipart file parts. */
+    bodyParameters?: Readonly<JsonObject>;
+    responseBody?: Readonly<JsonObject>;
+    requestBody?: Readonly<{
+        properties: readonly string[];
+        required: readonly string[];
+        oneOfRequired?: readonly (readonly string[])[];
+    }>;
+}>;
 interface ModelEndpointSummary {
     key: string;
     label: string;
@@ -47,6 +60,8 @@ interface ModelEndpointSummary {
     capabilities: string[];
     /** Task execution of this native endpoint, not a second model parameter definition. */
     sourceEndpointKey?: string | null;
+    documentationUrl?: string;
+    httpOperations?: readonly ModelHttpOperation[];
 }
 interface ModelCapabilitySummary {
     inputModalities: string[];
@@ -118,6 +133,8 @@ interface TaskModel extends TaskModelSummary {
 interface ModelSchema {
     model: string;
     version: number;
+    /** Contract owner for the returned schema. Defaults to nexra for older servers. */
+    contract?: "nexra" | "native";
     dialect: "https://json-schema.org/draft/2020-12/schema" | string;
     inputSchema: JsonObject;
     outputSchema: JsonObject;
@@ -284,7 +301,7 @@ declare class HttpTransport {
     response(path: string, init?: RequestInit, options?: RequestOptions): Promise<Response>;
 }
 
-/** Unified canvas vocabulary: resolution 1K/2K/4K, ratio X:X. */
+/** UI-friendly view of Nexra's canonical geometry fields. */
 type UnifiedMediaGeometry = {
     resolution?: string;
     ratio?: string;
@@ -292,27 +309,23 @@ type UnifiedMediaGeometry = {
 };
 type MediaGeometryField = {
     field: string;
-    nest?: string;
     options: readonly string[];
     default?: string;
     optionLabels: Readonly<Record<string, string>>;
 };
 type MediaGeometryProjection = {
-    kind: "pixel-size" | "tier-size" | "resolution-ratio" | "ratio-only" | "none";
+    kind: "resolution-ratio" | "ratio-only" | "none";
     resolution?: MediaGeometryField;
     ratio?: MediaGeometryField;
     quality?: MediaGeometryField;
 };
-/** Schema → unified resolution/ratio/quality controls for app UIs. */
+/** Read controls from the Nexra contract. It never exposes provider-native size fields. */
 declare function projectMediaGeometry(inputSchema: JsonObject): MediaGeometryProjection;
-/** Unified geometry → the model's native catalog fields (channel original params). */
+/** UI geometry aliases → canonical Nexra request fields. */
 declare function encodeMediaGeometry(inputSchema: JsonObject, geometry: UnifiedMediaGeometry): JsonObject;
-/** Native catalog fields → unified resolution/ratio/quality. */
-declare function decodeMediaGeometry(inputSchema: JsonObject, nativeInput: JsonObject): UnifiedMediaGeometry;
-/**
- * Rewrite a Task/quote body: unified keys become native catalog fields.
- * Native size/ratio already present is left alone (existing callers keep working).
- */
+/** Canonical Nexra request fields → UI geometry aliases. */
+declare function decodeMediaGeometry(_inputSchema: JsonObject, input: JsonObject): UnifiedMediaGeometry;
+/** Normalize the SDK convenience alias `ratio` without producing Native fields. */
 declare function applyMediaGeometry(inputSchema: JsonObject, input: JsonObject): JsonObject;
 
-export { type ModelModality as A, type ModelResourceList as B, type CreateNexraQuoteRequest as C, type ModelResourceOption as D, type NexraDisplayQuoteBatchEntry as E, type FetchLike as F, HttpTransport as H, type JsonValue as J, type MediaGeometryField as M, type NexraSalePriceList as N, type TaskModelSummary as T, type UnifiedMediaGeometry as U, type NexraQuote as a, type CreateNexraDisplayQuoteBatchRequest as b, type NexraDisplayQuoteBatch as c, type NexraCatalogRevision as d, type NexraModelSpec as e, type NexraModelSpecFilter as f, type MediaGeometryProjection as g, type NexraBillingCurrency as h, type NexraModelEndpointSpec as i, type NexraModelOperation as j, type NexraSalePrice as k, type NexraSettlement as l, applyMediaGeometry as m, decodeMediaGeometry as n, encodeMediaGeometry as o, projectMediaGeometry as p, type ModelSearchParams as q, type CursorPage as r, type TaskModel as s, type ModelSchema as t, type NexraClientOptions as u, type JsonObject as v, type JsonPrimitive as w, type ModelCapabilitySummary as x, type ModelDateVersion as y, type ModelEndpointSummary as z };
+export { type NexraDisplayQuoteBatchEntry as A, type CreateNexraQuoteRequest as C, type FetchLike as F, HttpTransport as H, type MediaGeometryField as M, type NexraSalePriceList as N, type TaskModelSummary as T, type UnifiedMediaGeometry as U, type NexraQuote as a, type CreateNexraDisplayQuoteBatchRequest as b, type NexraDisplayQuoteBatch as c, type NexraCatalogRevision as d, type NexraModelSpec as e, type NexraModelSpecFilter as f, type MediaGeometryProjection as g, type NexraBillingCurrency as h, type NexraModelEndpointSpec as i, type NexraModelOperation as j, type NexraSalePrice as k, type NexraSettlement as l, applyMediaGeometry as m, decodeMediaGeometry as n, encodeMediaGeometry as o, projectMediaGeometry as p, type ModelSearchParams as q, type TaskModel as r, type ModelSchema as s, type NexraClientOptions as t, type ModelCapabilitySummary as u, type ModelDateVersion as v, type ModelEndpointSummary as w, type ModelModality as x, type ModelResourceList as y, type ModelResourceOption as z };