@nodaro/shared 1.5.0 → 1.7.0

package/dist/index.cjs

@@ -4,8 +4,11 @@ var zod = require('zod');
 
 // src/types.ts
 var DEFAULT_LABEL_BY_SOURCE = {
-  "manual": "object",
-  "wired-image": "object",
+  // Media references default to "ref-only" — the empty label, i.e. a bare
+  // {image:N} token that injects only "reference image A" (image) / "@image_N"
+  // (video) with no descriptive role phrase. Pick a role on the pill to change.
+  "manual": "",
+  "wired-image": "",
   "wired-character": "person",
   "wired-face": "face",
   "wired-object": "object",
@@ -60,6 +63,7 @@ var VIDEO_RATIOS_HVS = ["16:9", "9:16", "1:1"];
 var WAN_27_IMAGE_RATIOS = ["1:1", "16:9", "9:16", "4:3", "3:4", "21:9", "8:1", "1:8"];
 var VIDEO_RATIOS_HVS345 = ["16:9", "9:16", "1:1", "4:3", "3:4"];
 var VIDEO_RATIOS_SEEDANCE_2 = ["16:9", "9:16", "1:1", "4:3", "3:4", "21:9", "adaptive"];
+var VIDEO_RATIOS_HAPPYHORSE_11 = ["16:9", "9:16", "1:1", "4:3", "3:4", "4:5", "5:4", "21:9", "9:21"];
 var IMAGE_MODELS = {
   // ── Google Nano Banana ──
   "nano-banana": {
@@ -1238,21 +1242,22 @@ var VIDEO_MODELS = {
       { identifier: "wan-2.7-t2v", credits: 19, note: "5s 720p default" }
     ]
   },
-  // ── HappyHorse ──
+  // ── HappyHorse (1.1 — ids kept version-less; repointed in place when KIE
+  // delisted 1.0, same param surface, so saved workflows keep working) ──
   "happyhorse": {
     id: "happyhorse",
     kind: "video",
     modes: ["t2v"],
     family: "HappyHorse",
-    label: "HappyHorse",
+    label: "HappyHorse 1.1",
     series: "HappyHorse",
-    description: "HappyHorse text-to-video \u2014 3\u201315s at 720p/1080p.",
+    description: "HappyHorse 1.1 text-to-video \u2014 3\u201315s at 720p/1080p, 9 aspect ratios incl. 21:9/9:21, per-second pricing.",
     useCases: ["motion", "creative"],
-    aspectRatios: VIDEO_RATIOS_HVS345,
+    aspectRatios: VIDEO_RATIOS_HAPPYHORSE_11,
     durations: [3, 4, 5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15],
     resolutions: ["720p", "1080p"],
     pricing: [
-      { identifier: "happyhorse", credits: 13, note: "5s 720p default" }
+      { identifier: "happyhorse", credits: 29, note: "5s 720p default \u2014 per-second: ~5.7 cr/s @720p, ~7.3 cr/s @1080p" }
     ]
   },
   "happyhorse-i2v": {
@@ -1260,14 +1265,14 @@ var VIDEO_MODELS = {
     kind: "video",
     modes: ["i2v"],
     family: "HappyHorse",
-    label: "HappyHorse I2V",
+    label: "HappyHorse 1.1 I2V",
     series: "HappyHorse",
-    description: "HappyHorse image-to-video \u2014 3\u201315s at 720p/1080p, aspect ratio inferred from input image.",
+    description: "HappyHorse 1.1 image-to-video \u2014 3\u201315s at 720p/1080p, aspect ratio inferred from input image, per-second pricing.",
     useCases: ["motion", "creative"],
     durations: [3, 4, 5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15],
     resolutions: ["720p", "1080p"],
     pricing: [
-      { identifier: "happyhorse-i2v", credits: 13, note: "5s 720p default" }
+      { identifier: "happyhorse-i2v", credits: 29, note: "5s 720p default \u2014 per-second: ~5.7 cr/s @720p, ~7.3 cr/s @1080p" }
     ]
   },
   "happyhorse-ref2v": {
@@ -1275,16 +1280,16 @@ var VIDEO_MODELS = {
     kind: "video",
     modes: ["i2v"],
     family: "HappyHorse",
-    label: "HappyHorse Ref2V",
+    label: "HappyHorse 1.1 Ref2V",
     series: "HappyHorse",
-    description: "HappyHorse reference-to-video \u2014 1\u20139 reference images, 3\u201315s at 720p/1080p.",
+    description: "HappyHorse 1.1 reference-to-video \u2014 1\u20139 reference images, 3\u201315s at 720p/1080p, per-second pricing.",
     useCases: ["motion", "reference"],
-    aspectRatios: VIDEO_RATIOS_HVS345,
+    aspectRatios: VIDEO_RATIOS_HAPPYHORSE_11,
     durations: [3, 4, 5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15],
     resolutions: ["720p", "1080p"],
     features: ["reference-image"],
     pricing: [
-      { identifier: "happyhorse-ref2v", credits: 15, note: "5s 720p default" }
+      { identifier: "happyhorse-ref2v", credits: 29, note: "5s 720p default \u2014 per-second: ~5.7 cr/s @720p, ~7.3 cr/s @1080p" }
     ]
   },
   "happyhorse-edit": {
@@ -1298,7 +1303,7 @@ var VIDEO_MODELS = {
     useCases: ["v2v", "restyle"],
     resolutions: ["720p", "1080p"],
     pricing: [
-      { identifier: "happyhorse-edit", credits: 20, note: "720p default" }
+      { identifier: "happyhorse-edit", credits: 35, note: "720p default (5s-equivalent flat rate)" }
     ]
   },
   // ── Bytedance video lite/pro ──
@@ -2750,7 +2755,10 @@ var DURATION_PRICED_PROVIDERS = /* @__PURE__ */ new Set([
   "seedance-2",
   "seedance-2-fast",
   "seedance-2-mini",
-  "grok-imagine-video-1.5"
+  "grok-imagine-video-1.5",
+  "happyhorse",
+  "happyhorse-i2v",
+  "happyhorse-ref2v"
 ]);
 var SEEDANCE_2_PROVIDERS = /* @__PURE__ */ new Set([
   "seedance-2",
@@ -2829,7 +2837,14 @@ var RESOLUTION_DURATION_PRICING = {
   "grok-imagine-video-1.5": ["480p", "720p"],
   // seedance-2-extend always uses a video ref, so pricing has no -ref
   // dimension — duration tier + ":res" only (rates = seedance-2 -ref + stitch).
-  "seedance-2-extend": ["480p", "720p", "1080p"]
+  "seedance-2-extend": ["480p", "720p", "1080p"],
+  // HappyHorse 1.1 — per-second billing at two published resolution rates
+  // (kie.ai/happyhorse-1-1: 22.5 cr/s @720p, 29 cr/s @1080p, uniform across
+  // t2v/i2v/ref2v). 720p first = billing default; the KIE-side default is
+  // pinned to 720p via extraParams in backend kie/models.ts so render matches.
+  "happyhorse": ["720p", "1080p"],
+  "happyhorse-i2v": ["720p", "1080p"],
+  "happyhorse-ref2v": ["720p", "1080p"]
 };
 var NATIVE_ADAPTIVE_ASPECT = {
   "seedance-2": "adaptive",
@@ -2905,6 +2920,10 @@ var VIDEO_VARIABLE_PRICING = {
   // Grok Imagine Video 1.5 — per-second billing split 480p/720p (no video-ref dimension).
   "grok-imagine-video-1.5": "duration+resolution"
 };
+var HAPPYHORSE_DURATION_TIERS = Array.from(
+  { length: 13 },
+  (_, i) => ({ maxSeconds: i + 3, suffix: `${i + 3}s` })
+);
 var VIDEO_DURATION_TIERS = {
   "kling-3.0": [
     { maxSeconds: 5, suffix: "5s" },
@@ -2998,7 +3017,15 @@ var VIDEO_DURATION_TIERS = {
     { maxSeconds: 13, suffix: "13s" },
     { maxSeconds: 14, suffix: "14s" },
     { maxSeconds: 15, suffix: "15s" }
-  ]
+  ],
+  // HappyHorse 1.1 (t2v / i2v / ref2v) — true per-second billing (KIE 22.5 cr/s
+  // @720p, 29 cr/s @1080p, published on kie.ai/happyhorse-1-1). One tier per
+  // allowed second (3–15s) so the composite identifier maps 1:1 to the seeded
+  // price, combined with RESOLUTION_DURATION_PRICING for the ":720p"/":1080p"
+  // suffix (e.g. "happyhorse-i2v:5s:720p").
+  "happyhorse": HAPPYHORSE_DURATION_TIERS,
+  "happyhorse-i2v": HAPPYHORSE_DURATION_TIERS,
+  "happyhorse-ref2v": HAPPYHORSE_DURATION_TIERS
 };
 var COMPOSER_PLAN_MAP = {
   "video-composer": { planType: "scene-graph", planField: "sceneGraph" },
@@ -8565,8 +8592,11 @@ function parseCharacterMentionToken(text, _knownCharacterSlugs) {
   }
   if (parts.length === 4) {
     if (!/^[a-z][a-z0-9-]*$/.test(third)) return null;
-    if (!isUsageMode(fourth)) return null;
-    return { characterSlug, imageIndex, variantSlug: third, usageMode: fourth, ...lockField };
+    if (!/^[a-z][a-z0-9-]*$/.test(fourth)) return null;
+    if (isUsageMode(fourth)) {
+      return { characterSlug, imageIndex, variantSlug: third, usageMode: fourth, ...lockField };
+    }
+    return { characterSlug, imageIndex, variantSlug: third, usageMode: null, role: fourth, ...lockField };
   }
   return null;
 }
@@ -8641,6 +8671,35 @@ function characterMentionableAssetArrays(data) {
     boards: characterBoardItems(data)
   };
 }
+var CHARACTER_PICKER_DISPLAY_ORDER = [
+  "boards",
+  "sheets",
+  ...CHARACTER_VARIANT_ASSET_BUCKETS
+];
+function characterBucketDisplayRank(bucket) {
+  if (bucket === void 0) return -1;
+  const i = CHARACTER_PICKER_DISPLAY_ORDER.indexOf(bucket);
+  return i === -1 ? CHARACTER_PICKER_DISPLAY_ORDER.length : i;
+}
+function sortCharacterEntriesForDisplay(items) {
+  const out = [];
+  let i = 0;
+  while (i < items.length) {
+    const slug = items[i].characterSlug;
+    if (!slug) {
+      out.push(items[i]);
+      i++;
+      continue;
+    }
+    let j = i;
+    while (j < items.length && items[j].characterSlug === slug) j++;
+    const run = items.slice(i, j);
+    const ranked = run.map((it, k) => ({ it, k, r: characterBucketDisplayRank(it.bucket) })).sort((a, b) => a.r - b.r || a.k - b.k).map((x) => x.it);
+    out.push(...ranked);
+    i = j;
+  }
+  return out;
+}
 
 // src/location-mention-slug.ts
 var LOCATION_USAGE_MODES = [
@@ -8734,8 +8793,11 @@ function parseLocationMentionToken(text) {
     const variant = third.slice(slashAt + 1);
     if (!/^[a-z][a-z0-9-]*$/.test(bucket)) return null;
     if (!/^[a-z][a-z0-9-]*$/.test(variant)) return null;
-    if (!isLocationUsageMode(fourth)) return null;
-    return { locationSlug, imageIndex, bucket, variant, usageMode: fourth, ...lockField };
+    if (!/^[a-z][a-z0-9-]*$/.test(fourth)) return null;
+    if (isLocationUsageMode(fourth)) {
+      return { locationSlug, imageIndex, bucket, variant, usageMode: fourth, ...lockField };
+    }
+    return { locationSlug, imageIndex, bucket, variant, usageMode: null, role: fourth, ...lockField };
   }
   return null;
 }
@@ -9059,7 +9121,7 @@ var ShotSpecSchema = zod.z.object({
   // v4.1 Method 10 — parametric 3D camera path
   camera_path_directive: zod.z.object({
     path_kind: zod.z.enum(["orbit", "dolly", "crane", "arc", "reveal"]),
-    parameters: zod.z.record(zod.z.unknown()).optional()
+    parameters: zod.z.record(zod.z.string(), zod.z.unknown()).optional()
   }).optional(),
   // ─── Execution state (engine writes; null on planning) ─────────────────────
   // Phase 1C.1: per-shot execution state lands directly on the shot record so
@@ -9804,7 +9866,7 @@ var StageAwaitingSubGateEventSchema = zod.z.object({
   pipelineId: zod.z.string().uuid(),
   stageName: zod.z.enum(["animate_audio_edit", "scene_images"]),
   subGate: SubGateNameSchema,
-  payload: zod.z.record(zod.z.unknown()).optional()
+  payload: zod.z.record(zod.z.string(), zod.z.unknown()).optional()
 });
 var PipelineMusicReadyEventSchema = zod.z.object({
   type: zod.z.literal("pipeline:music_ready"),
@@ -11060,7 +11122,10 @@ var CHARACTER_ATTACH_COLUMNS = [
   // locations don't have an outfit dimension).
   "sheets",
   "detail_closeups",
-  "outfit_variations"
+  "outfit_variations",
+  // Named composite reference boards (migration 250) — identity-collage
+  // sheets auto-attached by the ffmpeg image-collage worker.
+  "boards"
 ];
 var CHARACTER_ASSET_VARIANTS = {
   expressions: [
@@ -11658,12 +11723,15 @@ function resolveEffectiveSourceType(rawSourceType, sourceHandleId) {
   }
   return rawSourceType ?? "";
 }
+function sourceRefKey(nodeId, sourceHandleId, rawSourceType) {
+  return sourceHandleId === "image" && ENTITY_IMAGE_HANDLE_TYPES.has(rawSourceType ?? "") ? `${nodeId}::image` : nodeId;
+}
 
 // src/reference-roles.ts
 var REFERENCE_ROLE_PRESETS = {
-  "wired-character": ["person", "face", "clothes", "hair", "pose", "expression", "style"],
+  "wired-character": ["ref-only", "person", "face", "clothes", "hair", "pose", "expression", "style"],
   "wired-face": ["face", "person", "expression", "style"],
-  "wired-location": ["background", "atmosphere", "as-is", "empty background", "layout", "lighting", "style"],
+  "wired-location": ["ref-only", "background", "atmosphere", "as-is", "empty background", "layout", "lighting", "style"],
   "wired-object": ["object", "shape", "material", "color", "texture", "style"],
   "wired-creature": ["creature", "anatomy", "markings", "pose", "color", "style"],
   "wired-image": ["object", "person", "face", "clothes", "background", "style", "pose", "texture"],
@@ -11676,6 +11744,8 @@ function roleToPhrase(role, binding) {
   const r = role.trim();
   if (!r) return binding;
   switch (r) {
+    case "ref-only":
+      return binding;
     case "as-is":
       return `${binding}, used as-is`;
     case "empty background":
@@ -11872,6 +11942,7 @@ exports.CHARACTER_FACETS = CHARACTER_FACETS;
 exports.CHARACTER_FACET_IDS = CHARACTER_FACET_IDS;
 exports.CHARACTER_LORA_TRAINING_JOB_TYPE = CHARACTER_LORA_TRAINING_JOB_TYPE;
 exports.CHARACTER_MOTION_PROVIDERS = CHARACTER_MOTION_PROVIDERS;
+exports.CHARACTER_PICKER_DISPLAY_ORDER = CHARACTER_PICKER_DISPLAY_ORDER;
 exports.CHARACTER_REFERENCE_PHOTO_KINDS = CHARACTER_REFERENCE_PHOTO_KINDS;
 exports.CHARACTER_STYLES = CHARACTER_STYLES;
 exports.CHARACTER_VARIANT_ASSET_BUCKETS = CHARACTER_VARIANT_ASSET_BUCKETS;
@@ -12255,6 +12326,7 @@ exports.calculateMonetizedCost = calculateMonetizedCost;
 exports.calculateProgress = calculateProgress;
 exports.canonicalVarName = canonicalVarName;
 exports.characterBoardItems = characterBoardItems;
+exports.characterBucketDisplayRank = characterBucketDisplayRank;
 exports.characterMentionSlug = characterMentionSlug;
 exports.characterMentionableAssetArrays = characterMentionableAssetArrays;
 exports.characterSheetRefItems = characterSheetRefItems;
@@ -12468,7 +12540,9 @@ exports.selectListItems = selectListItems;
 exports.selectLoraRoutingForMentions = selectLoraRoutingForMentions;
 exports.selectRandom = selectRandom;
 exports.settledWithLimit = settledWithLimit;
+exports.sortCharacterEntriesForDisplay = sortCharacterEntriesForDisplay;
 exports.sortListItems = sortListItems;
+exports.sourceRefKey = sourceRefKey;
 exports.spliceDelimitedRows = spliceDelimitedRows;
 exports.splitByLoopDelimiter = splitByLoopDelimiter;
 exports.splitGeneratedItems = splitGeneratedItems;