@nodaro/shared 2.20.0 → 2.21.1

package/dist/index.cjs

@@ -55,7 +55,7 @@ var MODEL_RECOMMENDATIONS = [
   { intent: "cheapest realistic image", modelIds: ["z-image", "qwen", "imagen4-fast"], note: "Z-Image is the cheapest. Qwen / Imagen4 Fast for slightly higher quality." },
   { intent: "highest fidelity image", modelIds: ["nano-banana-pro", "imagen4-ultra", "flux-flex"], note: "Pick by family preference; all three are premium tiers." },
   { intent: "image edit / restyle", modelIds: ["flux-kontext", "ideogram-remix", "seedream-5-pro-i2i"], note: "Flux Kontext preserves identity; Ideogram Remix is character-aware; Seedream 5 Pro for instruction-based edits (5 Lite is the budget option)." },
-  { intent: "highest-resolution image (4K / 8K)", modelIds: ["topaz-image-upscale", "nano-banana-pro", "gpt-image-2"], note: "Generate at native then Topaz upscale for 8K." },
+  { intent: "highest-resolution image", modelIds: ["topaz-image-upscale", "nano-banana-pro", "gpt-image-2"], note: "Generate at the model's top tier, then Topaz upscale 4x (Topaz's only lever is the 1x/2x/4x factor)." },
   { intent: "background removal / cutout", modelIds: ["recraft-remove-bg"], note: "Cheap, no prompt needed." },
   // video
   { intent: "best cinematic video", modelIds: ["veo3", "kling-3.0", "seedance-2"], note: "VEO 3.1 Quality for premium narrative; Kling 3.0 for music-synced motion; Seedance 2 for reference-driven consistency." },
@@ -398,7 +398,8 @@ var IMAGE_MODELS = {
       { identifier: "gpt-image-2", credits: 15, note: "1K default" },
       { identifier: "gpt-image-2:2K", credits: 30, note: "2K" },
       { identifier: "gpt-image-2:4K", credits: 60, note: "4K" }
-    ]
+    ],
+    safetyFilter: { stochastic: true, fallback: "nano-banana-pro" }
   },
   "gpt-image-2-i2i": {
     id: "gpt-image-2-i2i",
@@ -408,6 +409,7 @@ var IMAGE_MODELS = {
     label: "GPT Image 2 (I2I)",
     series: "GPT Image",
     description: "Image-to-image with GPT Image 2.",
+    safetyFilter: { stochastic: true, fallback: "nano-banana-pro" },
     useCases: ["edit", "high-res"],
     features: ["reference-image"],
     aspectRatios: GPT_IMAGE_2_RATIOS,
@@ -818,14 +820,15 @@ var IMAGE_MODELS = {
     family: "Topaz",
     label: "Topaz Image Upscale",
     series: "Topaz",
-    description: "High-quality image upscale up to 8K. Best for production-ready output.",
+    description: "High-quality image upscale at 1x (enhance only), 2x or 4x. Best for production-ready output.",
     useCases: ["upscale", "high-res", "premium"],
     features: ["reference-image"],
-    resolutions: ["2K", "4K", "8K"],
+    // No `resolutions`: the provider's only quality lever is `upscale_factor`
+    // (1/2/4) — see resolveTopazUpscale. The 2K/4K/8K menu this used to
+    // advertise had no provider parameter behind it.
     pricing: [
-      { identifier: "topaz-image-upscale", credits: 25, note: "2K default" },
-      { identifier: "topaz-image-upscale:4K", credits: 50, note: "4K" },
-      { identifier: "topaz-image-upscale:8K", credits: 100, note: "8K" }
+      { identifier: "topaz-image-upscale", credits: 25, note: "1x / 2x" },
+      { identifier: "topaz-image-upscale:4K", credits: 50, note: "4x (legacy identifier)" }
     ]
   }
 };
@@ -856,6 +859,7 @@ var VIDEO_MODELS = {
   // docs.kie.ai/market/minimax-h3/{text,image,reference}-to-video.
   "minimax-h3": {
     id: "minimax-h3",
+    unlistedResolutionRendersAs: "2K",
     kind: "video",
     modes: ["i2v", "t2v"],
     family: "MiniMax",
@@ -1341,6 +1345,7 @@ var VIDEO_MODELS = {
   // declared explicitly in PRICING_DEFAULT_RESOLUTION, never by array position.
   "wan-3": {
     id: "wan-3",
+    unlistedResolutionRendersAs: "720p",
     kind: "video",
     modes: ["i2v", "t2v"],
     family: "Alibaba",
@@ -1365,6 +1370,7 @@ var VIDEO_MODELS = {
   },
   "wan-3-prime": {
     id: "wan-3-prime",
+    unlistedResolutionRendersAs: "720p",
     kind: "video",
     modes: ["i2v", "t2v"],
     family: "Alibaba",
@@ -1533,6 +1539,76 @@ var VIDEO_MODELS = {
       { identifier: "wan-2.7-t2v", credits: 188, note: "5s 720p default" }
     ]
   },
+  // Lightricks LTX 2.3 (Replicate, not KIE). Both variants run one endpoint per
+  // variant and switch behaviour with a `task` discriminator, so t2v and i2v are
+  // the SAME id — no VIDEO_MODE_ALIASES row. `extend` / `retake` are separate
+  // priced ops on the same model (ids below) but are NOT listed in `modes`:
+  // they are driven by the Extend Video / Video Retake nodes' own pickers, and
+  // adding the mode here would duplicate LTX in those menus.
+  // Bands are lowercase to match LTX_DURATION_TIERS' keys in credit-identifiers.ts
+  // and QUALITY_MAP in node-default-mappings.ts.
+  "ltx-2.3-pro": {
+    id: "ltx-2.3-pro",
+    kind: "video",
+    modes: ["i2v", "t2v"],
+    family: "Lightricks",
+    label: "LTX 2.3 Pro",
+    series: "LTX",
+    description: "Lightricks LTX 2.3 Pro \u2014 text/image/audio\u2192video up to 4K, 6/8/10s, end-frame interpolation.",
+    useCases: ["premium", "high-res", "narrative"],
+    features: ["end-frame"],
+    aspectRatios: ["16:9", "9:16"],
+    resolutions: ["1080p", "2k", "4k"],
+    durations: [6, 8, 10],
+    pricing: [
+      { identifier: "ltx-2.3-pro", credits: 240, note: "default 1080p 6s" },
+      { identifier: "ltx-2.3-pro:1080p:6s", credits: 240 },
+      { identifier: "ltx-2.3-pro:1080p:8s", credits: 320 },
+      { identifier: "ltx-2.3-pro:1080p:10s", credits: 400 },
+      { identifier: "ltx-2.3-pro:2k:6s", credits: 480 },
+      { identifier: "ltx-2.3-pro:2k:8s", credits: 640 },
+      { identifier: "ltx-2.3-pro:2k:10s", credits: 800 },
+      { identifier: "ltx-2.3-pro:4k:6s", credits: 960 },
+      { identifier: "ltx-2.3-pro:4k:8s", credits: 1280 },
+      { identifier: "ltx-2.3-pro:4k:10s", credits: 1600 },
+      { identifier: "ltx-2.3-pro-extend:per-second", credits: 40, note: "extend, per second of new footage" },
+      { identifier: "ltx-2.3-pro-retake:per-second", credits: 40, note: "retake, per second re-rendered" }
+    ]
+  },
+  "ltx-2.3-fast": {
+    id: "ltx-2.3-fast",
+    kind: "video",
+    modes: ["i2v", "t2v"],
+    family: "Lightricks",
+    label: "LTX 2.3 Fast",
+    series: "LTX",
+    description: "Lightricks LTX 2.3 Fast \u2014 text/image\u2192video up to 20s at 1080p (6/8/10s at 2K and 4K). No audio input, no extend.",
+    useCases: ["long-form", "fast", "narrative"],
+    features: ["end-frame"],
+    aspectRatios: ["16:9", "9:16"],
+    resolutions: ["1080p", "2k", "4k"],
+    // Flat union across bands — 12–20s exist only at 1080p (LTX_DURATION_TIERS
+    // in credit-identifiers.ts is the per-band authority and snaps a 2k/4k
+    // request back onto 6/8/10s, so the reservation is always a real tier).
+    durations: [6, 8, 10, 12, 14, 16, 18, 20],
+    pricing: [
+      { identifier: "ltx-2.3-fast", credits: 180, note: "default 1080p 6s" },
+      { identifier: "ltx-2.3-fast:1080p:6s", credits: 180 },
+      { identifier: "ltx-2.3-fast:1080p:8s", credits: 240 },
+      { identifier: "ltx-2.3-fast:1080p:10s", credits: 300 },
+      { identifier: "ltx-2.3-fast:1080p:12s", credits: 360 },
+      { identifier: "ltx-2.3-fast:1080p:14s", credits: 420 },
+      { identifier: "ltx-2.3-fast:1080p:16s", credits: 480 },
+      { identifier: "ltx-2.3-fast:1080p:18s", credits: 540 },
+      { identifier: "ltx-2.3-fast:1080p:20s", credits: 600 },
+      { identifier: "ltx-2.3-fast:2k:6s", credits: 360 },
+      { identifier: "ltx-2.3-fast:2k:8s", credits: 480 },
+      { identifier: "ltx-2.3-fast:2k:10s", credits: 600 },
+      { identifier: "ltx-2.3-fast:4k:6s", credits: 720 },
+      { identifier: "ltx-2.3-fast:4k:8s", credits: 960 },
+      { identifier: "ltx-2.3-fast:4k:10s", credits: 1200 }
+    ]
+  },
   // ── HappyHorse (1.1 — ids kept version-less; repointed in place when KIE
   // delisted 1.0, same param surface, so saved workflows keep working) ──
   "happyhorse": {
@@ -2384,6 +2460,105 @@ function normalizeModelInput(modelId, input) {
   }
   return out;
 }
+var PASSTHROUGH_ASPECT_TOKENS = /* @__PURE__ */ new Set(["auto", "adaptive"]);
+var RESOLUTION_BAND_PIXELS = {
+  "2k": 1440,
+  "4k": 2160,
+  "8k": 4320
+};
+function bandPixels(token) {
+  const t2 = token.trim().toLowerCase();
+  if (RESOLUTION_BAND_PIXELS[t2] !== void 0) return RESOLUTION_BAND_PIXELS[t2];
+  const m = /^(\d+)p$/.exec(t2);
+  return m ? Number(m[1]) : void 0;
+}
+function nearestResolutionBand(token, allowed) {
+  let highest = allowed[allowed.length - 1];
+  let highestPx = -Infinity;
+  for (const a of allowed) {
+    const px = bandPixels(a);
+    if (px !== void 0 && px > highestPx) {
+      highestPx = px;
+      highest = a;
+    }
+  }
+  const want = bandPixels(token);
+  if (want === void 0) return highest;
+  let best = highest;
+  let bestDist = Infinity;
+  for (const a of allowed) {
+    const px = bandPixels(a);
+    if (px === void 0) continue;
+    const d = Math.abs(px - want);
+    if (d < bestDist) {
+      bestDist = d;
+      best = a;
+    }
+  }
+  return best;
+}
+function nearestAspectRatio(token, allowed) {
+  const [w, h] = token.split(":").map(Number);
+  if (!w || !h) return void 0;
+  const target = Math.log(w / h);
+  let best;
+  let bestDist = Infinity;
+  for (const c of allowed) {
+    const [cw, ch] = c.split(":").map(Number);
+    if (!cw || !ch) continue;
+    const d = Math.abs(Math.log(cw / ch) - target);
+    if (d < bestDist) {
+      bestDist = d;
+      best = c;
+    }
+  }
+  return best;
+}
+function readOptionToken(value) {
+  if (value === void 0 || value === null) return void 0;
+  const s = (typeof value === "string" ? value : String(value)).trim();
+  return s === "" ? void 0 : s;
+}
+function normalizeVideoRequestParams(modelId, input) {
+  const m = MODEL_CATALOG[modelId];
+  const aspect = readOptionToken(input.aspectRatio);
+  const res = readOptionToken(input.resolution);
+  const out = { aspectRatio: aspect, resolution: res, adjustments: [] };
+  if (!m) return out;
+  if (m.aspectRatios?.length && aspect && !PASSTHROUGH_ASPECT_TOKENS.has(aspect.toLowerCase())) {
+    const allowed = m.aspectRatios;
+    const exact = allowed.find((a) => a === aspect) ?? allowed.find((a) => a.toLowerCase() === aspect.toLowerCase());
+    if (exact !== void 0) {
+      out.aspectRatio = exact;
+    } else {
+      const next = nearestAspectRatio(aspect, allowed.filter((a) => !PASSTHROUGH_ASPECT_TOKENS.has(a.toLowerCase()))) ?? allowed[0];
+      out.adjustments.push({
+        field: "aspectRatio",
+        from: aspect,
+        to: next,
+        reason: `${m.label} does not support aspect ratio "${aspect}" \u2014 using "${next}" instead. Supported: ${allowed.join(", ")}.`
+      });
+      out.aspectRatio = next;
+    }
+  }
+  if (m.resolutions?.length && res) {
+    const allowed = m.resolutions;
+    const exact = allowed.find((a) => a === res) ?? allowed.find((a) => a.toLowerCase() === res.toLowerCase());
+    if (exact !== void 0) {
+      out.resolution = exact;
+    } else {
+      const next = m.unlistedResolutionRendersAs ?? nearestResolutionBand(res, allowed);
+      out.adjustments.push({
+        field: "resolution",
+        from: res,
+        to: next,
+        reason: `${m.label} does not support resolution "${res}" \u2014 using "${next}" instead. Supported: ${allowed.join(", ")}.`
+      });
+      out.resolution = next;
+    }
+  }
+  return out;
+}
 var MODEL_VALUE_LABELS = {
   // aspect ratios
   "1:1": "1:1 (Square)",
@@ -2398,6 +2573,7 @@ var MODEL_VALUE_LABELS = {
   "2K": "2K (High)",
   "4K": "4K (Ultra)",
   "4k": "4K",
+  "2k": "2K",
   "8K": "8K (Ultra)",
   // qualities
   "medium": "Medium (Balanced)",
@@ -3583,6 +3759,39 @@ var VIDEO_REF_LIMITS_BY_PROVIDER = {
   // the user's references (the grok-imagine-video-1.5 bug). Add only with a
   // verified provider path + the catalog `reference-image` feature.
 };
+var VIDEO_REF_VIDEO_DURATION_LIMITS = {
+  "seedance-2-5": { minSec: 2, maxSec: 30, maxTotalSec: 30 },
+  // MiniMax Hailuo 3 — the provider states the per-clip bound in its own reject
+  // text: "content[1].video_url: invalid param: video duration 52838 ms,
+  // expected [2000, 15000] ms" (app-reports P4, 2 rows, the same clip retried).
+  // The KIE reference-to-video doc adds the COMBINED cap — the same shape the
+  // audio side already declares in SEEDANCE_2_R2V_MAX_AUDIO_SEC_BY_PROVIDER
+  // above, whose h3 row cites the same page.
+  "minimax-h3": { minSec: 2, maxSec: 15, maxTotalSec: 15 }
+};
+function checkRefVideoDurations(provider, durationsSec) {
+  const limit = VIDEO_REF_VIDEO_DURATION_LIMITS[provider];
+  if (!limit) return { ok: true };
+  const usable = durationsSec.filter((d) => Number.isFinite(d) && d > 0);
+  if (usable.length === 0) return { ok: true };
+  const offender = usable.find((d) => d < limit.minSec || d > limit.maxSec);
+  if (offender !== void 0) {
+    return {
+      ok: false,
+      message: `Each reference video must be between ${limit.minSec} and ${limit.maxSec} seconds \u2014 one is ${offender.toFixed(1)}s. Trim it (a Trim Video node upstream works) and run again.`
+    };
+  }
+  if (limit.maxTotalSec !== void 0) {
+    const total = usable.reduce((a, b) => a + b, 0);
+    if (total > limit.maxTotalSec) {
+      return {
+        ok: false,
+        message: `Reference videos must not exceed ${limit.maxTotalSec} seconds in total \u2014 these add up to ${total.toFixed(1)}s. Remove one or trim them and run again.`
+      };
+    }
+  }
+  return { ok: true };
+}
 var RESOLUTION_VIDEO_REF_PRICING = SEEDANCE_2_PROVIDERS;
 var RESOLUTION_DURATION_PRICING = {
   // KIE supports only 480p/720p here; 480p is the default.
@@ -3676,10 +3885,39 @@ var VIDEO_AUDIO_CAPABILITY = {
   // and skip the lip-sync pass. `defaultOn` mirrors the KIE default so an
   // intent-less request is described honestly; audio is priced into the uniform
   // per-second rate, so NOT cost-affecting (no `:audio` composite).
-  // gemini-omni-flash is deliberately ABSENT — gemini-omni-video is absent too
-  // (mode "none"), and the siblings must not disagree.
   "wan-3": { mode: "ambient", field: "audio", defaultOn: true },
-  "wan-3-prime": { mode: "ambient", field: "audio", defaultOn: true }
+  "wan-3-prime": { mode: "ambient", field: "audio", defaultOn: true },
+  // Gemini Omni (both SKUs — the pro `gemini-omni-video` and the faster
+  // `gemini-omni-flash`; one model at two speeds, so their rows are identical
+  // and a test pins that). Settled 2026-09-03 from Google's own documentation
+  // at https://ai.google.dev/gemini-api/docs/omni, having been unlisted — and
+  // therefore reported as SILENT — while the catalog described both as "native
+  // audio".
+  //
+  // "ambient", and alwaysOn with no toggle field, on three sentences from that
+  // page:
+  //   - "By default the model will try to generate an appropriate audio track
+  //     for a video." Audio on every render, and the KIE input schema
+  //     (prompt / image_urls / first+last_frame_url / audio_ids / video_list /
+  //     character_ids / duration / aspect_ratio / seed / resolution — see
+  //     docs.kie.ai/market/gemini-omni-video and
+  //     docs.kie.ai/market/google/gemini-omni-flash-1-1) carries no on/off
+  //     lever, so there is nothing for applyVideoAudioToggle to write.
+  //   - NOT native_speech: "Multi-turn voice extension: Generating spoken
+  //     dialogue or speech is supported when extending previously generated
+  //     videos via multi-turn (`previous_interaction_id`)" — a field KIE's
+  //     createTask schema does not expose, so the dialogue path is unreachable
+  //     on our transport. Held to the Wan 3.0 bar: no documented dialogue
+  //     guarantee on the path we actually drive ⇒ ambient, and upgrade only on
+  //     a live probe (the kling-3.0 standard). Classifying it native_speech
+  //     would reroute the Story→Video dialogue pipeline past the lip-sync pass.
+  //   - NOT audio_driven either: "Uploading audio references is unsupported in
+  //     the current version of the API", and "any audio in a video reference is
+  //     ignored" — there is no reference-audio transport to be driven by, and
+  //     runGeminiOmni never sends `audio_ids`.
+  // Audio is priced into the per-tier rate, so NOT cost-affecting.
+  "gemini-omni-video": { mode: "ambient", alwaysOn: true },
+  "gemini-omni-flash": { mode: "ambient", alwaysOn: true }
 };
 var VIDEO_AUDIO_NONE = { mode: "none" };
 function getVideoAudioCapability(model) {
@@ -4487,6 +4725,16 @@ var LTX_DURATION_TIERS = {
   "ltx-2.3-pro": { "1080p": [6, 8, 10], "2k": [6, 8, 10], "4k": [6, 8, 10] },
   "ltx-2.3-fast": { "1080p": [6, 8, 10, 12, 14, 16, 18, 20], "2k": [6, 8, 10], "4k": [6, 8, 10] }
 };
+function ltxPricedTier(provider, resolution, duration) {
+  const bands = LTX_DURATION_TIERS[provider];
+  if (!bands) return void 0;
+  const band2 = bands[String(resolution)] ? String(resolution) : "1080p";
+  const allowed = bands[band2];
+  const raw = typeof duration === "string" ? parseInt(duration, 10) : duration ?? allowed[0];
+  const want = Number.isNaN(raw) ? allowed[0] : raw;
+  const dur = allowed.reduce((b, a) => Math.abs(a - want) < Math.abs(b - want) ? a : b);
+  return { band: band2, duration: dur };
+}
 function buildVideoCreditModelIdentifier(provider, duration, sound, nodeType, mode, resolution, hasVideoRef) {
   let effectiveProvider = provider;
   if (nodeType === "text-to-video") {
@@ -4512,14 +4760,9 @@ function buildVideoCreditModelIdentifier(provider, duration, sound, nodeType, mo
     const d = Number.isNaN(raw) ? 8 : GEMINI_OMNI_DURATIONS.reduce((b, a) => Math.abs(a - raw) < Math.abs(b - raw) ? a : b);
     return resolution === "4k" ? `${effectiveProvider}:4k:${d}` : `${effectiveProvider}:${d}`;
   }
-  if (effectiveProvider === "ltx-2.3-pro" || effectiveProvider === "ltx-2.3-fast") {
-    const bands = LTX_DURATION_TIERS[effectiveProvider];
-    const band2 = bands[String(resolution)] ? String(resolution) : "1080p";
-    const allowed = bands[band2];
-    const raw = typeof duration === "string" ? parseInt(duration, 10) : duration ?? allowed[0];
-    const want = Number.isNaN(raw) ? allowed[0] : raw;
-    const dur = allowed.reduce((b, a) => Math.abs(a - want) < Math.abs(b - want) ? a : b);
-    return `${effectiveProvider}:${band2}:${dur}s`;
+  const ltxTier = ltxPricedTier(effectiveProvider, resolution, duration);
+  if (ltxTier) {
+    return `${effectiveProvider}:${ltxTier.band}:${ltxTier.duration}s`;
   }
   if (!DURATION_PRICED_PROVIDERS.has(effectiveProvider)) {
     return effectiveProvider;
@@ -4559,6 +4802,22 @@ function buildVideoCreditModelIdentifier(provider, duration, sound, nodeType, mo
   }
   return identifier;
 }
+function pricedVideoSelection(opts) {
+  const adjustments = [];
+  const ltx = ltxPricedTier(opts.provider, opts.resolution, opts.duration);
+  const resolution = opts.resolution ?? (ltx ? ltx.band : PRICING_DEFAULT_RESOLUTION[opts.provider]);
+  if (!ltx) return { resolution, adjustments };
+  const requested = typeof opts.duration === "string" ? parseInt(opts.duration, 10) : opts.duration;
+  if (requested !== void 0 && !Number.isNaN(requested) && requested !== ltx.duration) {
+    adjustments.push({
+      field: "duration",
+      from: requested,
+      to: ltx.duration,
+      reason: `LTX renders ${ltx.band} in ${ltx.duration}s steps \u2014 using ${ltx.duration}s instead of ${requested}s.`
+    });
+  }
+  return { resolution, duration: ltx.duration, adjustments };
+}
 function buildMotionCreditModelIdentifier(provider, resolution, videoDuration) {
   if (provider === "wan-animate-move" || provider === "wan-animate-replace") {
     if (resolution === "580p" || resolution === "720p") {
@@ -4684,6 +4943,71 @@ function extractVideoDurationFromNode(data) {
   return void 0;
 }
 
+// src/topaz-upscale.ts
+var TOPAZ_UPSCALE_FACTORS = ["1", "2", "4"];
+var TOPAZ_DEFAULT_UPSCALE_FACTOR = "2";
+var LEGACY_TIER_TO_FACTOR = {
+  "2K": "2",
+  "4K": "4",
+  "8K": "4"
+};
+function isFactor(v) {
+  return TOPAZ_UPSCALE_FACTORS.includes(v);
+}
+function resolveTopazUpscale(input) {
+  const adjustments = [];
+  const rawFactor = typeof input.upscaleFactor === "string" ? input.upscaleFactor : "";
+  const rawTier = typeof input.targetResolution === "string" ? input.targetResolution : "";
+  const trimmedFactor = rawFactor.trim();
+  const normalizedTier = rawTier.trim().toUpperCase();
+  const factorGiven = trimmedFactor.length > 0;
+  const factorValid = factorGiven && isFactor(trimmedFactor);
+  const tierGiven = normalizedTier.length > 0;
+  const tierMappedFactor = tierGiven ? LEGACY_TIER_TO_FACTOR[normalizedTier] : void 0;
+  const finalFactor = factorValid ? trimmedFactor : tierMappedFactor ?? TOPAZ_DEFAULT_UPSCALE_FACTOR;
+  if (factorGiven && !factorValid) {
+    adjustments.push({
+      field: "upscaleFactor",
+      from: rawFactor,
+      to: finalFactor,
+      reason: `Topaz upscale accepts a factor of 1, 2 or 4 \u2014 "${rawFactor}" was replaced with ${finalFactor}.`
+    });
+  }
+  if (factorValid && tierGiven) {
+    if (tierMappedFactor !== finalFactor) {
+      adjustments.push({
+        field: "targetResolution",
+        from: rawTier,
+        to: void 0,
+        reason: "upscaleFactor takes precedence over the legacy targetResolution."
+      });
+    }
+  } else if (!factorValid && tierGiven) {
+    if (tierMappedFactor) {
+      if (normalizedTier === "8K") {
+        adjustments.push({
+          field: "targetResolution",
+          from: rawTier,
+          to: finalFactor,
+          reason: "Topaz upscale offers factors up to 4x \u2014 an 8K target renders and bills at the 4x tier."
+        });
+      }
+    } else {
+      adjustments.push({
+        field: "targetResolution",
+        from: rawTier,
+        to: finalFactor,
+        reason: `Unknown Topaz target "${rawTier}" \u2014 rendering at ${finalFactor}x.`
+      });
+    }
+  }
+  return {
+    upscaleFactor: finalFactor,
+    creditTier: finalFactor === "4" ? "4K" : void 0,
+    adjustments
+  };
+}
+
 // src/presentation-utils.ts
 var INPUT_NODE_TYPES = /* @__PURE__ */ new Set([
   "text-prompt",
@@ -6456,6 +6780,35 @@ function resolveNodeRefs(text, labelToOutput) {
   }
   return result;
 }
+var REF_TOKEN_NAMESPACE_PREFIXES = [
+  "image:",
+  "video:",
+  "audio:",
+  "slot:",
+  "ref:"
+];
+function classifyRefToken(name, resolvable) {
+  const lower = name.toLowerCase();
+  if (name === "" || REF_TOKEN_NAMESPACE_PREFIXES.some((p) => lower.startsWith(p))) return "skip";
+  if (RESERVED_TEMPLATE_VARS.has(name)) return "reserved";
+  if (resolvable === null) return "unknown";
+  return resolvable.has(canonicalVarName(name)) ? "wired" : "missing";
+}
+function unresolvedRefTokens(text, opts) {
+  if (typeof text !== "string" || text.length === 0) return [];
+  const seen = /* @__PURE__ */ new Set();
+  const out = [];
+  for (const m of text.matchAll(NODE_REF_PATTERN)) {
+    const { name, fallback } = parseNodeRef(m[1] ?? "");
+    if (fallback !== null) continue;
+    if (classifyRefToken(name, opts.resolvable) !== "missing") continue;
+    const canon = canonicalVarName(name);
+    if (opts.known.has(canon) || seen.has(canon)) continue;
+    seen.add(canon);
+    out.push(name);
+  }
+  return out;
+}
 
 // src/filter-condition.ts
 function tryParseJson(item) {
@@ -9642,6 +9995,18 @@ function togglePick(current, id, maxSelected) {
   return [...current.slice(1), id];
 }
 
+// src/safety-retry-policy.ts
+function safetyRetryPolicy(modelId) {
+  const entry = getModel(modelId);
+  const safetyFilter = entry?.safetyFilter;
+  if (!safetyFilter?.stochastic) return { maxAttempts: 1 };
+  const fallback = safetyFilter.fallback;
+  if (fallback && getModel(fallback)) {
+    return { maxAttempts: 2, fallback };
+  }
+  return { maxAttempts: 2 };
+}
+
 // src/caption-styles.ts
 var STATIC_CAPTION_STYLES = ["subtitle"];
 var KINETIC_CAPTION_STYLES = [
@@ -9782,6 +10147,18 @@ var EXECUTION_DATA_KEYS = /* @__PURE__ */ new Set([
   "currentJobId",
   "currentJobProgress",
   "errorMessage",
+  // Structured detail alongside errorMessage for a safety-filter block
+  // (see `JobErrorHint` in the app's frontend/src/types/nodes.ts). Same
+  // lifecycle as errorMessage: a RESULT the user expects to survive reload,
+  // never user-edited config.
+  "errorHint",
+  // A job policy registered by the deployment held this node's result for a
+  // human reviewer (`jobs.status = "pending_review"`). Pure run state, like
+  // executionStatus: the node is still "running" and the flag disappears the
+  // moment the review resolves — so it is ALSO in TRANSIENT_RUNTIME_KEYS
+  // below. Without the transient half, a flip into review marks a passive tab
+  // dirty and a preset captures "awaiting review".
+  "jobAwaitingReview",
   "isStreaming",
   "generatedImageUrl",
   "generatedVideoUrl",
@@ -9829,6 +10206,7 @@ var TRANSIENT_RUNTIME_KEYS = /* @__PURE__ */ new Set([
   "executionStatus",
   "currentJobId",
   "currentJobProgress",
+  "jobAwaitingReview",
   "isStreaming",
   "subWorkflowProgress",
   "__listTotal",
@@ -13519,6 +13897,26 @@ var clipLookSchema = zod.z.object({
    * insert) states the deviation in that scene's `visual`, as with `lighting`.
    */
   style: zod.z.string().optional(),
+  /**
+   * The Style picker CATALOG ID the prose in `style` corresponds to — the
+   * analyzer's PICK ("pixar-3d" beside "3D stylized animation"), not a second
+   * description of it.
+   *
+   * Worth strictly more than the prose it accompanies: an id addresses the
+   * catalog, so a recreation renders the same medium the product's own Style
+   * picker would render, instead of re-interpreting a sentence. Absent when the
+   * analyzer read a medium it could not place in the catalog — `style` then
+   * carries the whole answer, as it always did.
+   *
+   * A free `string` here on purpose. The PRODUCER validates it against the
+   * catalog (the analyzer plugin's wire schema is an enum generated from
+   * `STYLES`, so an invented id never leaves it), while this package must not
+   * carry the catalog itself. A closed enum here would only add a second copy
+   * of the vocabulary to drift out of date — and, worse, would REJECT a
+   * catalog entry newer than the installed `@nodaro/shared`, which is exactly
+   * the analysis a consumer most wants to read.
+   */
+  styleId: zod.z.string().optional(),
   /** Colour grade / palette — "muted teal-and-orange, crushed blacks". */
   grade: zod.z.string().optional(),
   /** Camera or film FORMAT and stock — "anamorphic digital", "16mm film grain". */
@@ -13589,8 +13987,9 @@ var entitySlotSchema = zod.z.object({
   /** NON-default looks only; present only when at least one exists. */
   variations: zod.z.array(slotVariationSchema).max(VIDEO_ANALYSIS_MAX_VARIATIONS).optional()
 });
+var VIDEO_ANALYSIS_AUDIO_MODES = ["speech", "music", "sfx", "ambience"];
 var audioLayerSchema = zod.z.object({
-  mode: zod.z.enum(["speech", "music", "sfx"]),
+  mode: zod.z.enum(VIDEO_ANALYSIS_AUDIO_MODES),
   content: zod.z.string().min(1),
   voice: zod.z.string().optional(),
   /**
@@ -13613,7 +14012,34 @@ var audioLayerSchema = zod.z.object({
    * (doctrine §5), so attribution here would resurrect the phantom-entity
    * defect that `stripOrphanSlots` exists to kill.
    */
-  speakerSlot: zod.z.string().optional()
+  speakerSlot: zod.z.string().optional(),
+  /**
+   * SPEECH ONLY — WHO says these words, by NAME.
+   *
+   * The second of two ways to name a speaker, and the one for documents that
+   * have no slots: `speakerSlot` addresses an `EntitySlot` of THIS analysis by
+   * id, while `speaker` is the plain cast name a production keys its own cast
+   * by ("Jack Mercer"). A layer may legitimately carry both — the id for the
+   * analysis it came from, the name for the document it is going into — and a
+   * consumer that understands only one reads the one it understands.
+   *
+   * Optional, and not refined against `mode`, for the same reason
+   * `speakerSlot` is not: the window schema is the enforced decode grammar and
+   * must not throw away a whole roll over one mis-tagged field.
+   *
+   * NOT swept by `dropUnknownSpeakers`. That function is the SLOT channel's
+   * sanitizer — it judges an id against the surviving slot list, and a name has
+   * no id space to be unknown in. The asymmetry is deliberate and pinned by
+   * test; whoever owns the name's vocabulary sanitizes the name.
+   *
+   * The residual that leaves: a layer can keep a `speaker` naming someone
+   * `stripOrphanSlots` already pruned as a phantom, where the same claim spelled
+   * `speakerSlot` would have been dropped — the invented-narrator defect, in the
+   * one spelling the sweep cannot see. LATENT today, since nothing in this
+   * repo emits `speaker`; the day the analyzer does, that sweep is what has to
+   * grow, not this field.
+   */
+  speaker: zod.z.string().optional()
 });
 var windowSceneBase = zod.z.object({
   startSec: zod.z.number().min(0),
@@ -14453,6 +14879,7 @@ exports.REFERENCE_HANDLE_MAP = REFERENCE_HANDLE_MAP;
 exports.REFERENCE_ROLE_PRESETS = REFERENCE_ROLE_PRESETS;
 exports.REF_HANDLE_CATEGORY = REF_HANDLE_CATEGORY;
 exports.REF_IMAGE_MAX_LIMITS = REF_IMAGE_MAX_LIMITS;
+exports.REF_TOKEN_NAMESPACE_PREFIXES = REF_TOKEN_NAMESPACE_PREFIXES;
 exports.RENDERING_SPEED_SUPPORT = RENDERING_SPEED_SUPPORT;
 exports.REPEATABLE_NODE_TYPES = REPEATABLE_NODE_TYPES;
 exports.REPEAT_PLACEHOLDER = REPEAT_PLACEHOLDER;
@@ -14527,6 +14954,8 @@ exports.TEXT_TO_VIDEO_PROVIDERS = TEXT_TO_VIDEO_PROVIDERS;
 exports.TIER_MAX_PIPELINE_COST_CREDITS = TIER_MAX_PIPELINE_COST_CREDITS;
 exports.TIER_PIPELINE_PARALLELISM = TIER_PIPELINE_PARALLELISM;
 exports.TILT_CARRIED_FRACTION = TILT_CARRIED_FRACTION;
+exports.TOPAZ_DEFAULT_UPSCALE_FACTOR = TOPAZ_DEFAULT_UPSCALE_FACTOR;
+exports.TOPAZ_UPSCALE_FACTORS = TOPAZ_UPSCALE_FACTORS;
 exports.TRANSCRIBE_PROVIDERS = TRANSCRIBE_PROVIDERS;
 exports.TRANSIENT_RUNTIME_KEYS = TRANSIENT_RUNTIME_KEYS;
 exports.TTS_PROVIDERS = TTS_PROVIDERS;
@@ -14542,6 +14971,7 @@ exports.VEHICLES = VEHICLES;
 exports.VEHICLE_SUBCATEGORY_LABELS = VEHICLE_SUBCATEGORY_LABELS;
 exports.VEHICLE_SUBCATEGORY_ORDER = VEHICLE_SUBCATEGORY_ORDER;
 exports.VEO_PROVIDERS = VEO_PROVIDERS;
+exports.VIDEO_ANALYSIS_AUDIO_MODES = VIDEO_ANALYSIS_AUDIO_MODES;
 exports.VIDEO_ANALYSIS_BUCKET_CREDITS = VIDEO_ANALYSIS_BUCKET_CREDITS;
 exports.VIDEO_ANALYSIS_CLIP_TRANSITIONS_IN = VIDEO_ANALYSIS_CLIP_TRANSITIONS_IN;
 exports.VIDEO_ANALYSIS_DEFAULT_VARIATION = VIDEO_ANALYSIS_DEFAULT_VARIATION;
@@ -14586,6 +15016,7 @@ exports.VIDEO_PROMPT_MAX = VIDEO_PROMPT_MAX;
 exports.VIDEO_PROVIDERS_REQUIRING_IMAGE = VIDEO_PROVIDERS_REQUIRING_IMAGE;
 exports.VIDEO_PROVIDERS_WITHOUT_DISPATCH = VIDEO_PROVIDERS_WITHOUT_DISPATCH;
 exports.VIDEO_REF_LIMITS_BY_PROVIDER = VIDEO_REF_LIMITS_BY_PROVIDER;
+exports.VIDEO_REF_VIDEO_DURATION_LIMITS = VIDEO_REF_VIDEO_DURATION_LIMITS;
 exports.VIDEO_TO_VIDEO_PROVIDERS = VIDEO_TO_VIDEO_PROVIDERS;
 exports.VIDEO_UPSCALE_PROVIDERS = VIDEO_UPSCALE_PROVIDERS;
 exports.VIDEO_UTIL_PRICING = VIDEO_UTIL_PRICING;
@@ -14654,9 +15085,11 @@ exports.characterMentionSlug = characterMentionSlug;
 exports.characterMentionableAssetArrays = characterMentionableAssetArrays;
 exports.characterSheetRefItems = characterSheetRefItems;
 exports.characterVariantAssetArrays = characterVariantAssetArrays;
+exports.checkRefVideoDurations = checkRefVideoDurations;
 exports.cinematicCreditId = cinematicCreditId;
 exports.clampCinematicDuration = clampCinematicDuration;
 exports.clampSmartCutWindow = clampSmartCutWindow;
+exports.classifyRefToken = classifyRefToken;
 exports.cleanOrphanedItems = cleanOrphanedItems;
 exports.clearImageCriticMetadata = clearImageCriticMetadata;
 exports.clearVideoCriticMetadata = clearVideoCriticMetadata;
@@ -14831,6 +15264,7 @@ exports.normalizeModelInput = normalizeModelInput;
 exports.normalizeNodeModelParams = normalizeNodeModelParams;
 exports.normalizePinterestUrl = normalizePinterestUrl;
 exports.normalizeRoleSlug = normalizeRoleSlug;
+exports.normalizeVideoRequestParams = normalizeVideoRequestParams;
 exports.normalizeWan3Resolution = normalizeWan3Resolution;
 exports.orderedLlmModels = orderedLlmModels;
 exports.parseAttributedDialogue = parseAttributedDialogue;
@@ -14855,6 +15289,7 @@ exports.presentTypes = presentTypes;
 exports.presetApplyClearKeys = presetApplyClearKeys;
 exports.presetDataMatches = presetDataMatches;
 exports.presetEntries = presetEntries;
+exports.pricedVideoSelection = pricedVideoSelection;
 exports.qualityOptionsByKind = qualityOptionsByKind;
 exports.readPromptAffixes = readPromptAffixes;
 exports.refHandleCategory = refHandleCategory;
@@ -14899,6 +15334,7 @@ exports.resolveSlideshowTransition = resolveSlideshowTransition;
 exports.resolveSourceThroughConnectedList = resolveSourceThroughConnectedList;
 exports.resolveStoredTier = resolveStoredTier;
 exports.resolveSwitchXCreditId = resolveSwitchXCreditId;
+exports.resolveTopazUpscale = resolveTopazUpscale;
 exports.resolveVideoAnalysisModel = resolveVideoAnalysisModel;
 exports.resolveVideoModeForInputs = resolveVideoModeForInputs;
 exports.resolveVideoProviderForMode = resolveVideoProviderForMode;
@@ -14909,6 +15345,7 @@ exports.rewriteSpeakerSlots = rewriteSpeakerSlots;
 exports.rgbaArrayToHex = rgbaArrayToHex;
 exports.roleToPhrase = roleToPhrase;
 exports.runSelector = runSelector;
+exports.safetyRetryPolicy = safetyRetryPolicy;
 exports.sanitizeRole = sanitizeRole;
 exports.searchModelVariants = searchModelVariants;
 exports.seedance2AudioLimitSec = seedance2AudioLimitSec;
@@ -14945,6 +15382,7 @@ exports.tryParseJson = tryParseJson;
 exports.uiAspectRatioFill = uiAspectRatioFill;
 exports.uiDurationFill = uiDurationFill;
 exports.uiResolutionFill = uiResolutionFill;
+exports.unresolvedRefTokens = unresolvedRefTokens;
 exports.unwrapUnresolvedTokens = unwrapUnresolvedTokens;
 exports.usageModeDirective = usageModeDirective;
 exports.usageModeIncludesName = usageModeIncludesName;