@nodaro/shared 3.61.0 → 3.62.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (254) hide show
  1. package/dist/{chunk-IVXSNW2B.cjs → chunk-2D5LQFV4.cjs} +18 -332
  2. package/dist/chunk-2D5LQFV4.cjs.map +1 -0
  3. package/dist/{chunk-XUJC6GHE.cjs → chunk-2HZGDZZN.cjs} +6 -6
  4. package/dist/{chunk-XUJC6GHE.cjs.map → chunk-2HZGDZZN.cjs.map} +1 -1
  5. package/dist/{chunk-43TGSZRJ.js → chunk-2QKF7M2Z.js} +3 -3
  6. package/dist/{chunk-43TGSZRJ.js.map → chunk-2QKF7M2Z.js.map} +1 -1
  7. package/dist/{chunk-7ARKVJTN.cjs → chunk-2W745U4A.cjs} +228 -355
  8. package/dist/chunk-2W745U4A.cjs.map +1 -0
  9. package/dist/{chunk-673E4KYC.js → chunk-3OYO3XCC.js} +70 -6
  10. package/dist/chunk-3OYO3XCC.js.map +1 -0
  11. package/dist/{chunk-FMXFHJWX.cjs → chunk-4ZEFP2FQ.cjs} +4 -4
  12. package/dist/{chunk-FMXFHJWX.cjs.map → chunk-4ZEFP2FQ.cjs.map} +1 -1
  13. package/dist/{chunk-A3FHTSLB.js → chunk-5YYN5X57.js} +302 -27
  14. package/dist/chunk-5YYN5X57.js.map +1 -0
  15. package/dist/{chunk-4KYLNTR7.cjs → chunk-6CSXMWL4.cjs} +4 -4
  16. package/dist/{chunk-4KYLNTR7.cjs.map → chunk-6CSXMWL4.cjs.map} +1 -1
  17. package/dist/{chunk-M3SXUUWC.cjs → chunk-6FQBKI2A.cjs} +4 -11
  18. package/dist/chunk-6FQBKI2A.cjs.map +1 -0
  19. package/dist/{chunk-G4XWVWRI.js → chunk-6G7NN4S4.js} +5 -4
  20. package/dist/chunk-6G7NN4S4.js.map +1 -0
  21. package/dist/{chunk-ZFJN23V4.cjs → chunk-A2PX5IRC.cjs} +4 -4
  22. package/dist/{chunk-ZFJN23V4.cjs.map → chunk-A2PX5IRC.cjs.map} +1 -1
  23. package/dist/{chunk-JHTT2V4A.cjs → chunk-AFYTX4AI.cjs} +52 -43
  24. package/dist/chunk-AFYTX4AI.cjs.map +1 -0
  25. package/dist/chunk-ALRXY4QH.cjs +13 -0
  26. package/dist/chunk-ALRXY4QH.cjs.map +1 -0
  27. package/dist/chunk-AOJ6B7K4.cjs +351 -0
  28. package/dist/chunk-AOJ6B7K4.cjs.map +1 -0
  29. package/dist/{chunk-ZDBPQBAA.js → chunk-C7POAYFE.js} +3 -3
  30. package/dist/{chunk-ZDBPQBAA.js.map → chunk-C7POAYFE.js.map} +1 -1
  31. package/dist/{chunk-B6BG3LV2.js → chunk-CC4V2B7S.js} +3 -3
  32. package/dist/{chunk-B6BG3LV2.js.map → chunk-CC4V2B7S.js.map} +1 -1
  33. package/dist/{chunk-XZKFZMRT.cjs → chunk-CIPPPT7E.cjs} +6 -6
  34. package/dist/{chunk-XZKFZMRT.cjs.map → chunk-CIPPPT7E.cjs.map} +1 -1
  35. package/dist/{chunk-6XVHYD5R.js → chunk-CLAKSLXF.js} +4 -9
  36. package/dist/chunk-CLAKSLXF.js.map +1 -0
  37. package/dist/chunk-CTANEPMY.js +61 -0
  38. package/dist/chunk-CTANEPMY.js.map +1 -0
  39. package/dist/{chunk-WGKAOUEQ.cjs → chunk-D34K455O.cjs} +3 -2
  40. package/dist/chunk-D34K455O.cjs.map +1 -0
  41. package/dist/chunk-E2HZTGYX.js +331 -0
  42. package/dist/chunk-E2HZTGYX.js.map +1 -0
  43. package/dist/{chunk-RQ4F3AJH.cjs → chunk-G3KVK7OU.cjs} +21 -21
  44. package/dist/{chunk-RQ4F3AJH.cjs.map → chunk-G3KVK7OU.cjs.map} +1 -1
  45. package/dist/chunk-G4U3HW6W.js +453 -0
  46. package/dist/chunk-G4U3HW6W.js.map +1 -0
  47. package/dist/{chunk-IRQ3SPX7.js → chunk-GSFB537T.js} +3 -3
  48. package/dist/{chunk-IRQ3SPX7.js.map → chunk-GSFB537T.js.map} +1 -1
  49. package/dist/chunk-HRY7KGAE.cjs +506 -0
  50. package/dist/chunk-HRY7KGAE.cjs.map +1 -0
  51. package/dist/{chunk-VOWJCUMR.js → chunk-I2RQB7VG.js} +3 -3
  52. package/dist/{chunk-VOWJCUMR.js.map → chunk-I2RQB7VG.js.map} +1 -1
  53. package/dist/chunk-IDTKF5EX.cjs +48 -0
  54. package/dist/chunk-IDTKF5EX.cjs.map +1 -0
  55. package/dist/{chunk-5XRRENHD.cjs → chunk-IWWVPR3W.cjs} +88 -11
  56. package/dist/chunk-IWWVPR3W.cjs.map +1 -0
  57. package/dist/{chunk-SCMTN57Y.js → chunk-JJNNM23P.js} +3 -3
  58. package/dist/{chunk-SCMTN57Y.js.map → chunk-JJNNM23P.js.map} +1 -1
  59. package/dist/{chunk-ZZGQRRN7.js → chunk-JZGZ26YB.js} +6 -306
  60. package/dist/chunk-JZGZ26YB.js.map +1 -0
  61. package/dist/{chunk-XROE3CAS.cjs → chunk-KHH54GRP.cjs} +120 -79
  62. package/dist/chunk-KHH54GRP.cjs.map +1 -0
  63. package/dist/{chunk-NJVOJXBS.cjs → chunk-KJSRPHJ2.cjs} +48 -47
  64. package/dist/chunk-KJSRPHJ2.cjs.map +1 -0
  65. package/dist/{chunk-FVVD6XY2.js → chunk-KL6GAYTT.js} +13 -4
  66. package/dist/chunk-KL6GAYTT.js.map +1 -0
  67. package/dist/{chunk-AFQFGZN7.cjs → chunk-KYMHFVAZ.cjs} +8 -6
  68. package/dist/chunk-KYMHFVAZ.cjs.map +1 -0
  69. package/dist/{chunk-F5YEMSNK.cjs → chunk-MYJQELFN.cjs} +320 -26
  70. package/dist/chunk-MYJQELFN.cjs.map +1 -0
  71. package/dist/chunk-N5HH46JF.cjs +68 -0
  72. package/dist/chunk-N5HH46JF.cjs.map +1 -0
  73. package/dist/{chunk-MQZRQ5LM.cjs → chunk-N7OUQK7E.cjs} +8 -8
  74. package/dist/{chunk-MQZRQ5LM.cjs.map → chunk-N7OUQK7E.cjs.map} +1 -1
  75. package/dist/{chunk-UARGJ5IZ.js → chunk-NGKKNSK6.js} +30 -7
  76. package/dist/chunk-NGKKNSK6.js.map +1 -0
  77. package/dist/{chunk-SWVGHAYO.js → chunk-O7RZRUMZ.js} +110 -74
  78. package/dist/chunk-O7RZRUMZ.js.map +1 -0
  79. package/dist/{chunk-C77F4ZTL.js → chunk-PTD6EDUU.js} +3 -3
  80. package/dist/{chunk-C77F4ZTL.js.map → chunk-PTD6EDUU.js.map} +1 -1
  81. package/dist/{chunk-ZNM2LW3D.cjs → chunk-QWYFHQYK.cjs} +78 -53
  82. package/dist/chunk-QWYFHQYK.cjs.map +1 -0
  83. package/dist/{chunk-VB2ARGQ6.js → chunk-RGNHHIMN.js} +3 -3
  84. package/dist/chunk-RGNHHIMN.js.map +1 -0
  85. package/dist/{chunk-MOMFX32D.js → chunk-S24ZBUB4.js} +194 -299
  86. package/dist/chunk-S24ZBUB4.js.map +1 -0
  87. package/dist/{chunk-EWS2VFO4.js → chunk-S5TMRJMX.js} +4 -4
  88. package/dist/{chunk-EWS2VFO4.js.map → chunk-S5TMRJMX.js.map} +1 -1
  89. package/dist/chunk-SMOO5FAH.js +10 -0
  90. package/dist/chunk-SMOO5FAH.js.map +1 -0
  91. package/dist/{chunk-RUHKBEFF.js → chunk-SYWR5G3T.js} +16 -7
  92. package/dist/chunk-SYWR5G3T.js.map +1 -0
  93. package/dist/{chunk-FQXRYPCX.cjs → chunk-TRVWMKNE.cjs} +337 -52
  94. package/dist/chunk-TRVWMKNE.cjs.map +1 -0
  95. package/dist/{chunk-LLOIAGFB.js → chunk-UDDVDQMF.js} +292 -35
  96. package/dist/chunk-UDDVDQMF.js.map +1 -0
  97. package/dist/{chunk-PONP5J5E.cjs → chunk-V24EPI5N.cjs} +13 -3
  98. package/dist/chunk-V24EPI5N.cjs.map +1 -0
  99. package/dist/{chunk-5I4T4QR5.cjs → chunk-VACPZPUA.cjs} +5 -5
  100. package/dist/{chunk-5I4T4QR5.cjs.map → chunk-VACPZPUA.cjs.map} +1 -1
  101. package/dist/{chunk-HGI2VKIV.js → chunk-Y6X7UJSD.js} +10 -9
  102. package/dist/chunk-Y6X7UJSD.js.map +1 -0
  103. package/dist/chunk-YCXRSWCQ.js +42 -0
  104. package/dist/chunk-YCXRSWCQ.js.map +1 -0
  105. package/dist/entries/apps.cjs +44 -44
  106. package/dist/entries/apps.js +9 -9
  107. package/dist/entries/credits.cjs +217 -152
  108. package/dist/entries/credits.d.cts +105 -3
  109. package/dist/entries/credits.d.ts +105 -3
  110. package/dist/entries/credits.js +13 -8
  111. package/dist/entries/entities.cjs +188 -143
  112. package/dist/entries/entities.d.cts +122 -1
  113. package/dist/entries/entities.d.ts +122 -1
  114. package/dist/entries/entities.js +2 -1
  115. package/dist/entries/llm-models.d.cts +2 -1
  116. package/dist/entries/llm-models.d.ts +2 -1
  117. package/dist/entries/media.cjs +92 -87
  118. package/dist/entries/media.d.cts +11 -1
  119. package/dist/entries/media.d.ts +11 -1
  120. package/dist/entries/media.js +3 -2
  121. package/dist/entries/model-catalog.cjs +195 -103
  122. package/dist/entries/model-catalog.d.cts +90 -4
  123. package/dist/entries/model-catalog.d.ts +90 -4
  124. package/dist/entries/model-catalog.js +5 -5
  125. package/dist/entries/models.cjs +407 -294
  126. package/dist/entries/models.d.cts +4 -3
  127. package/dist/entries/models.d.ts +4 -3
  128. package/dist/entries/models.js +6 -5
  129. package/dist/entries/nodes.cjs +241 -233
  130. package/dist/entries/nodes.d.cts +15 -2
  131. package/dist/entries/nodes.d.ts +15 -2
  132. package/dist/entries/nodes.js +10 -10
  133. package/dist/entries/pipeline.cjs +152 -152
  134. package/dist/entries/pipeline.d.cts +2 -1
  135. package/dist/entries/pipeline.d.ts +2 -1
  136. package/dist/entries/pipeline.js +3 -3
  137. package/dist/entries/ugc.cjs +71 -71
  138. package/dist/entries/ugc.js +4 -4
  139. package/dist/entries/video.cjs +308 -204
  140. package/dist/entries/video.d.cts +480 -98
  141. package/dist/entries/video.d.ts +480 -98
  142. package/dist/entries/video.js +8 -4
  143. package/dist/entries/workflow.cjs +102 -102
  144. package/dist/entries/workflow.d.cts +5 -4
  145. package/dist/entries/workflow.d.ts +5 -4
  146. package/dist/entries/workflow.js +2 -2
  147. package/dist/{gpt-image-2-6-BeZdT-pW.d.cts → gpt-image-2-6-jIRQBRag.d.cts} +6 -0
  148. package/dist/{gpt-image-2-6-BeZdT-pW.d.ts → gpt-image-2-6-jIRQBRag.d.ts} +6 -0
  149. package/dist/index.cjs +2309 -1886
  150. package/dist/index.d.cts +9 -9
  151. package/dist/index.d.ts +9 -9
  152. package/dist/index.js +26 -23
  153. package/dist/{model-catalog-BgSvskgY.d.cts → model-catalog-CCEcv08q.d.cts} +128 -14
  154. package/dist/{model-catalog-BgSvskgY.d.ts → model-catalog-CCEcv08q.d.ts} +128 -14
  155. package/dist/{model-constants-DHd9jwQ7.d.ts → model-constants-B88p6XR0.d.ts} +299 -19
  156. package/dist/{model-constants-DHd9jwQ7.d.cts → model-constants-Cf3zaITt.d.cts} +299 -19
  157. package/package.json +1 -1
  158. package/src/__tests__/extend-providers.test.ts +114 -0
  159. package/src/__tests__/fixtures/mask-composite-quote-parity.json +118 -0
  160. package/src/__tests__/fixtures/root-exports.baseline.json +68 -0
  161. package/src/__tests__/gpt-image-2-6-formats.test.ts +4 -1
  162. package/src/__tests__/grok-video-15-catalog.test.ts +189 -0
  163. package/src/__tests__/gvp-supported-providers.test.ts +5 -2
  164. package/src/__tests__/minimax-h3-image.test.ts +140 -0
  165. package/src/__tests__/model-makers.test.ts +49 -11
  166. package/src/__tests__/model-tree.test.ts +13 -0
  167. package/src/__tests__/retired-video-provider.test.ts +15 -5
  168. package/src/__tests__/seedance-25-catalog-modes.test.ts +1 -1
  169. package/src/__tests__/seedance-task-type.test.ts +178 -0
  170. package/src/__tests__/seedream-5-5.test.ts +117 -0
  171. package/src/__tests__/unit-contract-compose.test.ts +27 -1
  172. package/src/__tests__/unit-contracts.test.ts +20 -6
  173. package/src/__tests__/upscale-factors.test.ts +107 -0
  174. package/src/__tests__/video-character-refs.test.ts +20 -2
  175. package/src/__tests__/video-collapse-parity.test.ts +19 -0
  176. package/src/__tests__/video-overlay-geometry.test.ts +68 -0
  177. package/src/__tests__/video-overlay-layer-plan.test.ts +3 -4
  178. package/src/__tests__/video-overlay-layouts.test.ts +529 -0
  179. package/src/__tests__/video-overlay-pricing.test.ts +61 -0
  180. package/src/__tests__/video-overlay-validate.test.ts +128 -0
  181. package/src/__tests__/video-overlay-wired-kind.test.ts +207 -0
  182. package/src/__tests__/video-overlay.test.ts +280 -194
  183. package/src/__tests__/video-ref-limits.test.ts +2 -1
  184. package/src/__tests__/video-reference-only.test.ts +6 -2
  185. package/src/__tests__/video-start-frame-only.test.ts +98 -0
  186. package/src/__tests__/wired-character-names.test.ts +220 -0
  187. package/src/credit-estimators/index.ts +8 -0
  188. package/src/credit-estimators/video-overlay.ts +70 -0
  189. package/src/credit-identifiers.ts +94 -1
  190. package/src/entity-image-url.ts +21 -0
  191. package/src/entries/credits.ts +14 -0
  192. package/src/entries/entities.ts +14 -0
  193. package/src/entries/model-catalog.ts +35 -1
  194. package/src/entries/models.ts +34 -0
  195. package/src/entries/nodes.ts +2 -0
  196. package/src/entries/video.ts +6 -0
  197. package/src/generated/unit-contracts.ts +8 -1
  198. package/src/gpt-image-2-6.ts +6 -0
  199. package/src/input-image-pricing.ts +76 -0
  200. package/src/mask-composite.ts +11 -0
  201. package/src/minimax-h3-image.ts +61 -0
  202. package/src/model-catalog.ts +355 -37
  203. package/src/model-constants.ts +590 -32
  204. package/src/node-default-mappings.ts +12 -2
  205. package/src/node-execution-state.ts +4 -3
  206. package/src/producer-types.ts +23 -1
  207. package/src/seedance-task-type.ts +37 -0
  208. package/src/seedream-5-5.ts +45 -0
  209. package/src/unit-contract-compose.ts +4 -1
  210. package/src/upscale-factors.ts +111 -0
  211. package/src/video-character-refs.ts +7 -4
  212. package/src/video-overlay-geometry.ts +99 -0
  213. package/src/video-overlay-input.ts +25 -0
  214. package/src/video-overlay-layout-ids.ts +48 -0
  215. package/src/video-overlay-layouts.ts +315 -0
  216. package/src/video-overlay-validate.ts +223 -0
  217. package/src/video-overlay-video-layers.ts +304 -0
  218. package/src/video-overlay.ts +165 -297
  219. package/src/video-ui-defaults.ts +8 -6
  220. package/src/wired-character-names.ts +202 -0
  221. package/dist/chunk-5XRRENHD.cjs.map +0 -1
  222. package/dist/chunk-673E4KYC.js.map +0 -1
  223. package/dist/chunk-6XVHYD5R.js.map +0 -1
  224. package/dist/chunk-7ARKVJTN.cjs.map +0 -1
  225. package/dist/chunk-7WGKP3EU.js +0 -23
  226. package/dist/chunk-7WGKP3EU.js.map +0 -1
  227. package/dist/chunk-A3FHTSLB.js.map +0 -1
  228. package/dist/chunk-AFQFGZN7.cjs.map +0 -1
  229. package/dist/chunk-F5YEMSNK.cjs.map +0 -1
  230. package/dist/chunk-FQXRYPCX.cjs.map +0 -1
  231. package/dist/chunk-FVVD6XY2.js.map +0 -1
  232. package/dist/chunk-G4XWVWRI.js.map +0 -1
  233. package/dist/chunk-HGI2VKIV.js.map +0 -1
  234. package/dist/chunk-IVXSNW2B.cjs.map +0 -1
  235. package/dist/chunk-JHTT2V4A.cjs.map +0 -1
  236. package/dist/chunk-KHZAQGRP.js +0 -17
  237. package/dist/chunk-KHZAQGRP.js.map +0 -1
  238. package/dist/chunk-LLOIAGFB.js.map +0 -1
  239. package/dist/chunk-M3SXUUWC.cjs.map +0 -1
  240. package/dist/chunk-MOMFX32D.js.map +0 -1
  241. package/dist/chunk-NCOGGRRP.cjs +0 -27
  242. package/dist/chunk-NCOGGRRP.cjs.map +0 -1
  243. package/dist/chunk-NJVOJXBS.cjs.map +0 -1
  244. package/dist/chunk-PONP5J5E.cjs.map +0 -1
  245. package/dist/chunk-RUHKBEFF.js.map +0 -1
  246. package/dist/chunk-SWVGHAYO.js.map +0 -1
  247. package/dist/chunk-UARGJ5IZ.js.map +0 -1
  248. package/dist/chunk-VB2ARGQ6.js.map +0 -1
  249. package/dist/chunk-WGKAOUEQ.cjs.map +0 -1
  250. package/dist/chunk-XROE3CAS.cjs.map +0 -1
  251. package/dist/chunk-ZLDFPVVI.cjs +0 -19
  252. package/dist/chunk-ZLDFPVVI.cjs.map +0 -1
  253. package/dist/chunk-ZNM2LW3D.cjs.map +0 -1
  254. package/dist/chunk-ZZGQRRN7.js.map +0 -1
@@ -1,3 +1,41 @@
1
+ /**
2
+ * Seedance 2.5 reference task type — what a request's reference media is FOR.
3
+ *
4
+ * The provider takes an optional declaration of the job a run's references do:
5
+ * - `reference` — the media guides a new clip (look, subject, motion);
6
+ * - `edit` — the clip is an edit of the reference video, in its own shape
7
+ * and length;
8
+ * - `extend` — the clip continues the reference video.
9
+ * Without one the provider guesses from the prompt. `auto` is the platform's
10
+ * spelling of "declare nothing": the provider keeps guessing.
11
+ *
12
+ * Which models take the declaration is a catalog capability
13
+ * (`MODEL_CATALOG[id].referenceTaskTypes`), read through
14
+ * `supportsReferenceTaskType`; whether a given request declares one, and the
15
+ * aspect ratio and length that forces, is decided in one place by
16
+ * `resolveSeedanceTaskType` (both in `model-constants.ts`). Never hand-list the
17
+ * model.
18
+ *
19
+ * Import-free on purpose: the catalog (`model-catalog.ts`) and the constants
20
+ * module (`model-constants.ts`, which imports the catalog) both read it. The
21
+ * resolver itself lives in `model-constants.ts` because it needs
22
+ * `videoDefaultDurationSec` from there.
23
+ */
24
+ /** Every value a request may carry, `auto` (declare nothing) first. */
25
+ declare const SEEDANCE_REFERENCE_TASK_TYPES: readonly ["auto", "reference", "edit", "extend"];
26
+ type SeedanceReferenceTaskType = typeof SEEDANCE_REFERENCE_TASK_TYPES[number];
27
+ /** A value that is actually sent to the provider. */
28
+ type DeclaredSeedanceTaskType = Exclude<SeedanceReferenceTaskType, "auto">;
29
+ /**
30
+ * The reference-video length (seconds, inclusive) an `edit` declaration
31
+ * accepts. Every reference video must be measured and inside it; otherwise
32
+ * nothing is declared.
33
+ */
34
+ declare const SEEDANCE_EDIT_REF_VIDEO_SEC: {
35
+ readonly min: 4;
36
+ readonly max: 30;
37
+ };
38
+
1
39
  /**
2
40
  * Model catalog — single source of truth for what each Nodaro-exposed model
3
41
  * is, who made it, what it's good for, and which knobs it accepts.
@@ -27,6 +65,7 @@
27
65
  * `npm run gen:skills` (from `backend/`) to refresh the public
28
66
  * `docs/choosing-models.md` guide. CI (`gen:skills:check`) fails on drift.
29
67
  */
68
+
30
69
  type ModelKind = "image" | "video" | "audio";
31
70
  type ModelMode = "t2i" | "i2i" | "edit" | "upscale" | "remove-bg" | "i2v" | "t2v" | "v2v" | "extend" | "motion-transfer" | "lip-sync" | "video-upscale" | "video-depth" | "tts" | "music" | "sfx" | "stt" | "voice-design" | "voice-changer" | "isolation" | "dubbing" | "forced-alignment" | "dialogue" | "video-analysis" | "video-audit";
32
71
  interface PriceVariant {
@@ -188,12 +227,16 @@ interface ModelMaker {
188
227
  /** True for an id of {@link MODEL_MAKERS} (and nothing it inherits). */
189
228
  declare function isModelMakerId(value: unknown): value is ModelMakerId;
190
229
  /**
191
- * The maker of a catalog entry, in its wire shape — undefined when its `maker`
192
- * is not a registry id (an entry built at run time without one). Never throws,
193
- * so one bad entry cannot fail a whole model listing.
230
+ * The maker of a catalog entry, in its wire shape — undefined for a model
231
+ * offered under the deployment's own label (`ownLabel`, which names none —
232
+ * even an entry built at run time, or by a JavaScript caller, that also names a
233
+ * maker) and when its `maker` is not a registry id (an entry built at run time
234
+ * without one). Never throws, so one bad entry cannot fail a whole model
235
+ * listing.
194
236
  */
195
- declare function modelMakerOf(entry: Pick<ModelCatalogEntry, "maker">): ModelMaker | undefined;
196
- interface ModelCatalogEntry {
237
+ declare function modelMakerOf(entry: Pick<ModelCatalogEntry, "maker" | "ownLabel">): ModelMaker | undefined;
238
+ /** Every field of a catalog entry but who it is offered under (`maker` / `ownLabel`, {@link ModelCatalogEntry}). */
239
+ interface ModelCatalogEntryFields {
197
240
  id: string;
198
241
  kind: ModelKind;
199
242
  /**
@@ -206,12 +249,6 @@ interface ModelCatalogEntry {
206
249
  modes: readonly ModelMode[];
207
250
  /** Vendor / lab that produced the model. Used for UI grouping. */
208
251
  family: string;
209
- /**
210
- * The company that made the model (see {@link MODEL_MAKERS}). REQUIRED, so a
211
- * new model cannot ship without one; every model of a `family` names the same
212
- * maker.
213
- */
214
- maker: ModelMakerId;
215
252
  /** Display name (NOT the id — the id is the API enum value). */
216
253
  label: string;
217
254
  /**
@@ -274,8 +311,10 @@ interface ModelCatalogEntry {
274
311
  * `"voice-references"` (video models only) means the model takes each
275
312
  * reference AUDIO clip as a VOICE sample — who speaks and how they sound —
276
313
  * and makes its own soundtrack, rather than conditioning on the audio itself
277
- * (Kling 4.0: KIE `voices`, `@VoiceN` in the prompt). The editor names that
278
- * input "Voice Refs" for such a model.
314
+ * (Kling 4.0: KIE `voices`, `@VoiceN` in the prompt; Kling 4.0 Flash: each
315
+ * clip is a wired character's voice, KIE `elements[].voice_url` — see
316
+ * `audioBindsToCharacters`). The editor names that input "Voice Refs" for
317
+ * such a model.
279
318
  *
280
319
  * `"audio-soundtrack"` (video models only) means the platform can play the
281
320
  * model's FIRST reference audio clip as the result's soundtrack: it sends
@@ -310,6 +349,24 @@ interface ModelCatalogEntry {
310
349
  * as before. "auto" stays in `aspectRatios`, so every menu still offers it.
311
350
  */
312
351
  autoAspectFromSourceImage?: true;
352
+ /**
353
+ * The provider's endpoint refuses an aspect ratio this model does not list.
354
+ * Set only when that was read from the provider's own schema: a ratio field
355
+ * marked required, with a closed list (Seedream 5.5: text to image requires
356
+ * one of its eight ratios and has no "auto"; its edit takes "auto" and the
357
+ * same eight; docs.kie.ai/market/seedream/5-5-text-to-image.md and
358
+ * 5-5-image-to-image.md). The lanes that pass a stored ratio straight on (a
359
+ * Scene, a surround continuation) move a ratio such a model does not list to
360
+ * the nearest one it does, checked against the model the request reaches
361
+ * (`aspectRatioForStrictModel` in the backend), and send every other model's
362
+ * ratio exactly as stored.
363
+ *
364
+ * A ratio missing from `aspectRatios` is NOT evidence the provider refuses
365
+ * it. Measured 2026-11-11: the provider rendered 21:9 (1916×821) and 4:5
366
+ * (1122×1402) for GPT Image 2, whose list names neither. Do not set this flag
367
+ * from a catalog list alone, and do not snap those lanes for every model.
368
+ */
369
+ strictAspectRatios?: true;
313
370
  /**
314
371
  * The pixel size (width, height) this model renders at each aspect ratio and
315
372
  * size, from the provider's own table, for a PNG, JPEG or WebP. Read where a
@@ -356,6 +413,16 @@ interface ModelCatalogEntry {
356
413
  * the two cannot drift.
357
414
  */
358
415
  unlistedResolutionRendersAs?: string;
416
+ /**
417
+ * The resolutions (catalog spelling) at which this video model takes a start
418
+ * frame ONLY: no end frame, no loop and no in-between frames beside it. A run
419
+ * that would send any of them at such a resolution is refused before any
420
+ * credits are held, with one sentence (`videoStartFrameOnlyProblem`), on the
421
+ * API routes, the workflow run and the editor's Run; the editor offers the
422
+ * resolution only while nothing but a start frame is wired. Declared from the
423
+ * provider's own refusal, never guessed.
424
+ */
425
+ startFrameOnlyResolutions?: readonly string[];
359
426
  qualities?: readonly string[];
360
427
  /**
361
428
  * The quality a run renders at when none is named, where that is not the
@@ -423,6 +490,16 @@ interface ModelCatalogEntry {
423
490
  * the longest clip and settled on the delivered one.
424
491
  */
425
492
  autoDuration?: boolean;
493
+ /**
494
+ * The reference task types this model accepts as a declaration (see
495
+ * `SEEDANCE_REFERENCE_TASK_TYPES`): what the request's reference media is for
496
+ * — a `reference`, an `edit` of the reference video, or an `extend` of it.
497
+ * The list is what is honoured: `resolveSeedanceTaskType` declares only a
498
+ * value listed here, and anything else runs as Auto. Absent or empty: the
499
+ * model takes no such declaration and the provider guesses from the prompt.
500
+ * `supportsReferenceTaskType` says whether the list is non-empty.
501
+ */
502
+ referenceTaskTypes?: readonly DeclaredSeedanceTaskType[];
426
503
  /**
427
504
  * The model takes NO seed: its provider schema has none, so a seed the
428
505
  * request carries is dropped before the provider call and repeat runs vary.
@@ -474,6 +551,25 @@ interface ModelCatalogEntry {
474
551
  */
475
552
  tts?: TtsCapabilities;
476
553
  }
554
+ /**
555
+ * Who a model is offered under — exactly one of:
556
+ *
557
+ * - `maker`: the company that made it (see {@link MODEL_MAKERS}). Every model
558
+ * names one unless it is marked `ownLabel`, so a new model cannot ship
559
+ * without saying whose it is; every model of a `family` names the same maker.
560
+ * - `ownLabel: true`: the model is offered under the deployment's own label and
561
+ * names no maker (decided 2026-11-11). `GET /v1/models` leaves `maker` out
562
+ * for it and returns `logoUrl: null`; MCP `list_models` leaves `maker` out (it
563
+ * never carries `logoUrl`); a client shows no maker. Such a model may not
564
+ * carry a `maker` (`model-makers.test.ts`).
565
+ */
566
+ type ModelCatalogEntry = ModelCatalogEntryFields & ({
567
+ maker: ModelMakerId;
568
+ ownLabel?: never;
569
+ } | {
570
+ ownLabel: true;
571
+ maker?: never;
572
+ });
477
573
  /**
478
574
  * Editorial recommendations — short "best for X" picks Claude can echo back
479
575
  * to the user when they don't know which model to use. Surfaces as a "Quick
@@ -647,6 +743,24 @@ declare function maskedEditResolution(modelId: string, levers: {
647
743
  declare function resolutionNearestSource(modelId: string, aspectRatio: unknown, source: SourceImageSize | undefined): string | undefined;
648
744
  /** True for the "auto" aspect token in any case or padding. */
649
745
  declare function isAutoAspectToken(value: unknown): boolean;
746
+ /**
747
+ * True for the video request's "Auto" ratio — the unified node's
748
+ * provider-agnostic token — in exactly the spellings a video provider adapter
749
+ * receives it as (`"Auto"`, `"auto"`). Narrower than {@link isAutoAspectToken}
750
+ * on purpose: it is the wire rule's own match, so a reader of it agrees with
751
+ * what is sent.
752
+ */
753
+ declare function isVideoAutoAspectToken(value: string | undefined): boolean;
754
+ /**
755
+ * The ratio a video model runs the "Auto" token ({@link isVideoAutoAspectToken})
756
+ * at: `"adaptive"` (match the input) when the request has a visual input to
757
+ * match — a frame, a reference image or a reference video — and the model's
758
+ * catalog lists `"adaptive"`; otherwise `undefined`, and the provider adapter
759
+ * sends its own fixed default. The ONE mapping: the KIE adapter sends what it
760
+ * says, and the Seedance reference task type resolver reads it to tell a ratio
761
+ * it would replace from one that already runs at the ratio it forces.
762
+ */
763
+ declare function videoAutoAspectRunsAt(modelId: string | undefined, hasVisualInput: boolean): "adaptive" | undefined;
650
764
  /**
651
765
  * The ratio in `ratios` nearest a `sourceWidth` x `sourceHeight` image:
652
766
  * minimises |ln(w/h) - ln(rw/rh)|, so a portrait and its landscape mirror are
@@ -884,4 +998,4 @@ declare function modelIdsByKindMode(kind: ModelKind | null, modes: readonly Mode
884
998
  includeHidden?: boolean;
885
999
  }): [string, ...string[]];
886
1000
 
887
- export { modelMakerOf as $, creditRangesAll as A, defaultResolutionFor as B, durationsByMode as C, fitAspectRatioToModel as D, getAspectRatioOptions as E, getCreditRange as F, getDurationsForModel as G, getModel as H, IMAGE_GIF_FRAME_SIZE as I, getQualityOptions as J, getResolutionOptions as K, type LabeledOption as L, MASKLESS_OUTPUT_FORMATS as M, type NormalizedModelInput as N, groupByFamily as O, type PriceVariant as P, groupByKindAndFamily as Q, hasFeature as R, SPEECH_UNIT_PRICE_NOTE as S, TRANSPARENT_OUTPUT_FORMATS as T, isAutoAspectToken as U, type ValidationField as V, isModelMakerId as W, listModels as X, maskEditMatchesSource as Y, maskedEditResolution as Z, modelIdsByKindMode as _, IMAGE_OUTPUT_FORMAT_LABELS as a, modelTakesSeed as a0, modelsWithFeature as a1, nearestCatalogAspectRatio as a2, normalizeModelInput as a3, normalizeVideoRequestParams as a4, outputFormatOptionsByKind as a5, qualityOptionsByKind as a6, resolutionAtAspectRatio as a7, resolutionNearestSource as a8, resolutionOptionsByKind as a9, resolutionsAtAspectRatio as aa, sourceImageSizeNeeded as ab, svgLevelOptionsByKind as ac, validateModelInput as ad, IMAGE_SVG_LEVEL_LABELS as b, MODEL_CATALOG as c, MODEL_INPUT_ADJUSTMENT_FIELDS as d, MODEL_KINDS as e, MODEL_MAKERS as f, MODEL_RECOMMENDATIONS as g, type ModelCatalogEntry as h, type ModelInputAdjustment as i, type ModelInputAdjustmentField as j, type ModelInputContext as k, type ModelKind as l, type ModelMaker as m, type ModelMakerId as n, type ModelMenuOption as o, type ModelMode as p, type ModelRecommendation as q, type ModelValidationIssue as r, type NormalizedVideoRequest as s, type SourceImageSize as t, type TtsCapabilities as u, type TtsSettingLever as v, aspectRatioOptionsByKind as w, autoAspectNeedsSourceImage as x, backgroundOptionsByKind as y, buildModelMenu as z };
1001
+ export { isModelMakerId as $, aspectRatioOptionsByKind as A, autoAspectNeedsSourceImage as B, backgroundOptionsByKind as C, type DeclaredSeedanceTaskType as D, buildModelMenu as E, creditRangesAll as F, defaultResolutionFor as G, durationsByMode as H, IMAGE_GIF_FRAME_SIZE as I, fitAspectRatioToModel as J, getAspectRatioOptions as K, type LabeledOption as L, MASKLESS_OUTPUT_FORMATS as M, type NormalizedModelInput as N, getCreditRange as O, type PriceVariant as P, getDurationsForModel as Q, getModel as R, SEEDANCE_EDIT_REF_VIDEO_SEC as S, TRANSPARENT_OUTPUT_FORMATS as T, getQualityOptions as U, type ValidationField as V, getResolutionOptions as W, groupByFamily as X, groupByKindAndFamily as Y, hasFeature as Z, isAutoAspectToken as _, IMAGE_OUTPUT_FORMAT_LABELS as a, isVideoAutoAspectToken as a0, listModels as a1, maskEditMatchesSource as a2, maskedEditResolution as a3, modelIdsByKindMode as a4, modelMakerOf as a5, modelTakesSeed as a6, modelsWithFeature as a7, nearestCatalogAspectRatio as a8, normalizeModelInput as a9, normalizeVideoRequestParams as aa, outputFormatOptionsByKind as ab, qualityOptionsByKind as ac, resolutionAtAspectRatio as ad, resolutionNearestSource as ae, resolutionOptionsByKind as af, resolutionsAtAspectRatio as ag, sourceImageSizeNeeded as ah, svgLevelOptionsByKind as ai, validateModelInput as aj, videoAutoAspectRunsAt as ak, IMAGE_SVG_LEVEL_LABELS as b, MODEL_CATALOG as c, MODEL_INPUT_ADJUSTMENT_FIELDS as d, MODEL_KINDS as e, MODEL_MAKERS as f, MODEL_RECOMMENDATIONS as g, type ModelCatalogEntry as h, type ModelCatalogEntryFields as i, type ModelInputAdjustment as j, type ModelInputAdjustmentField as k, type ModelInputContext as l, type ModelKind as m, type ModelMaker as n, type ModelMakerId as o, type ModelMenuOption as p, type ModelMode as q, type ModelRecommendation as r, type ModelValidationIssue as s, type NormalizedVideoRequest as t, SEEDANCE_REFERENCE_TASK_TYPES as u, SPEECH_UNIT_PRICE_NOTE as v, type SeedanceReferenceTaskType as w, type SourceImageSize as x, type TtsCapabilities as y, type TtsSettingLever as z };