@nodaro/shared 3.31.0 → 3.33.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 (378) hide show
  1. package/README.md +17 -0
  2. package/dist/chunk-23FJQTEA.js +1604 -0
  3. package/dist/chunk-23FJQTEA.js.map +1 -0
  4. package/dist/chunk-2NIQO2J3.cjs +54 -0
  5. package/dist/chunk-2NIQO2J3.cjs.map +1 -0
  6. package/dist/chunk-2NQLSLSN.cjs +19 -0
  7. package/dist/chunk-2NQLSLSN.cjs.map +1 -0
  8. package/dist/chunk-2OJIVO7R.cjs +32 -0
  9. package/dist/chunk-2OJIVO7R.cjs.map +1 -0
  10. package/dist/chunk-2RF4Z7KG.cjs +803 -0
  11. package/dist/chunk-2RF4Z7KG.cjs.map +1 -0
  12. package/dist/chunk-3RYKIUAE.js +86 -0
  13. package/dist/chunk-3RYKIUAE.js.map +1 -0
  14. package/dist/chunk-44I73CQS.cjs +194 -0
  15. package/dist/chunk-44I73CQS.cjs.map +1 -0
  16. package/dist/chunk-5PC6JBGJ.cjs +1419 -0
  17. package/dist/chunk-5PC6JBGJ.cjs.map +1 -0
  18. package/dist/chunk-5RU2HCW2.js +30 -0
  19. package/dist/chunk-5RU2HCW2.js.map +1 -0
  20. package/dist/chunk-5RYLK3MQ.js +267 -0
  21. package/dist/chunk-5RYLK3MQ.js.map +1 -0
  22. package/dist/chunk-5THUHJ3E.js +46 -0
  23. package/dist/chunk-5THUHJ3E.js.map +1 -0
  24. package/dist/chunk-6DAWSVX2.cjs +103 -0
  25. package/dist/chunk-6DAWSVX2.cjs.map +1 -0
  26. package/dist/chunk-6WZ2VN7V.js +920 -0
  27. package/dist/chunk-6WZ2VN7V.js.map +1 -0
  28. package/dist/chunk-7G7G42KS.js +86 -0
  29. package/dist/chunk-7G7G42KS.js.map +1 -0
  30. package/dist/chunk-7Z5LUTGU.js +1567 -0
  31. package/dist/chunk-7Z5LUTGU.js.map +1 -0
  32. package/dist/chunk-AINCI23X.js +2171 -0
  33. package/dist/chunk-AINCI23X.js.map +1 -0
  34. package/dist/chunk-BG5D5CZ6.js +1922 -0
  35. package/dist/chunk-BG5D5CZ6.js.map +1 -0
  36. package/dist/chunk-CK3GK34R.js +1381 -0
  37. package/dist/chunk-CK3GK34R.js.map +1 -0
  38. package/dist/chunk-CUH22J4D.js +17 -0
  39. package/dist/chunk-CUH22J4D.js.map +1 -0
  40. package/dist/chunk-D26ENTN2.cjs +1770 -0
  41. package/dist/chunk-D26ENTN2.cjs.map +1 -0
  42. package/dist/chunk-D6GNRSCV.cjs +2017 -0
  43. package/dist/chunk-D6GNRSCV.cjs.map +1 -0
  44. package/dist/chunk-FBV5DF6D.js +95 -0
  45. package/dist/chunk-FBV5DF6D.js.map +1 -0
  46. package/dist/chunk-FG4E7MTG.cjs +4 -0
  47. package/dist/chunk-FG4E7MTG.cjs.map +1 -0
  48. package/dist/chunk-FT5CF6IA.js +42 -0
  49. package/dist/chunk-FT5CF6IA.js.map +1 -0
  50. package/dist/chunk-G6IIVKMO.js +26 -0
  51. package/dist/chunk-G6IIVKMO.js.map +1 -0
  52. package/dist/chunk-HC7VKIV5.cjs +430 -0
  53. package/dist/chunk-HC7VKIV5.cjs.map +1 -0
  54. package/dist/chunk-HGC5JNVA.cjs +1503 -0
  55. package/dist/chunk-HGC5JNVA.cjs.map +1 -0
  56. package/dist/chunk-HKFMXNVQ.cjs +1273 -0
  57. package/dist/chunk-HKFMXNVQ.cjs.map +1 -0
  58. package/dist/chunk-HRXEZ3SX.cjs +526 -0
  59. package/dist/chunk-HRXEZ3SX.cjs.map +1 -0
  60. package/dist/chunk-HSHCCBIV.js +255 -0
  61. package/dist/chunk-HSHCCBIV.js.map +1 -0
  62. package/dist/chunk-HUR6ZJ7S.cjs +159 -0
  63. package/dist/chunk-HUR6ZJ7S.cjs.map +1 -0
  64. package/dist/chunk-J7BMO73N.cjs +114 -0
  65. package/dist/chunk-J7BMO73N.cjs.map +1 -0
  66. package/dist/chunk-JFS3NWZ5.cjs +1714 -0
  67. package/dist/chunk-JFS3NWZ5.cjs.map +1 -0
  68. package/dist/chunk-JL4C5VJ7.cjs +488 -0
  69. package/dist/chunk-JL4C5VJ7.cjs.map +1 -0
  70. package/dist/chunk-JSGIEF6Z.cjs +1087 -0
  71. package/dist/chunk-JSGIEF6Z.cjs.map +1 -0
  72. package/dist/chunk-JWA5SGCS.js +203 -0
  73. package/dist/chunk-JWA5SGCS.js.map +1 -0
  74. package/dist/chunk-K3LLGRK7.cjs +3545 -0
  75. package/dist/chunk-K3LLGRK7.cjs.map +1 -0
  76. package/dist/chunk-KU6S7IYV.cjs +210 -0
  77. package/dist/chunk-KU6S7IYV.cjs.map +1 -0
  78. package/dist/chunk-M36G6SRP.js +447 -0
  79. package/dist/chunk-M36G6SRP.js.map +1 -0
  80. package/dist/chunk-M7GQBRZU.cjs +1963 -0
  81. package/dist/chunk-M7GQBRZU.cjs.map +1 -0
  82. package/dist/chunk-MRXGWL42.cjs +4 -0
  83. package/dist/chunk-MRXGWL42.cjs.map +1 -0
  84. package/dist/chunk-NEJ2PV4C.cjs +211 -0
  85. package/dist/chunk-NEJ2PV4C.cjs.map +1 -0
  86. package/dist/chunk-OTATNBMD.js +141 -0
  87. package/dist/chunk-OTATNBMD.js.map +1 -0
  88. package/dist/chunk-OZSACQ2V.js +471 -0
  89. package/dist/chunk-OZSACQ2V.js.map +1 -0
  90. package/dist/chunk-PHZ23DP3.js +1782 -0
  91. package/dist/chunk-PHZ23DP3.js.map +1 -0
  92. package/dist/chunk-PQHS255G.js +1369 -0
  93. package/dist/chunk-PQHS255G.js.map +1 -0
  94. package/dist/chunk-PRYE7AZQ.cjs +1227 -0
  95. package/dist/chunk-PRYE7AZQ.cjs.map +1 -0
  96. package/dist/chunk-PVJBAPYJ.js +404 -0
  97. package/dist/chunk-PVJBAPYJ.js.map +1 -0
  98. package/dist/chunk-PXFQVLBX.js +776 -0
  99. package/dist/chunk-PXFQVLBX.js.map +1 -0
  100. package/dist/chunk-QA3MVQ32.js +21 -0
  101. package/dist/chunk-QA3MVQ32.js.map +1 -0
  102. package/dist/chunk-QJRP44ZO.js +769 -0
  103. package/dist/chunk-QJRP44ZO.js.map +1 -0
  104. package/dist/chunk-SAW5OK36.cjs +54 -0
  105. package/dist/chunk-SAW5OK36.cjs.map +1 -0
  106. package/dist/chunk-SES6GDBQ.cjs +624 -0
  107. package/dist/chunk-SES6GDBQ.cjs.map +1 -0
  108. package/dist/chunk-SFW3UB2P.js +31 -0
  109. package/dist/chunk-SFW3UB2P.js.map +1 -0
  110. package/dist/chunk-TNPDV7I4.cjs +2346 -0
  111. package/dist/chunk-TNPDV7I4.cjs.map +1 -0
  112. package/dist/chunk-TU33KYKW.cjs +25 -0
  113. package/dist/chunk-TU33KYKW.cjs.map +1 -0
  114. package/dist/chunk-TZBIY5C3.js +187 -0
  115. package/dist/chunk-TZBIY5C3.js.map +1 -0
  116. package/dist/chunk-TZE673G6.js +3 -0
  117. package/dist/chunk-TZE673G6.js.map +1 -0
  118. package/dist/chunk-UCFWI6D4.js +29 -0
  119. package/dist/chunk-UCFWI6D4.js.map +1 -0
  120. package/dist/chunk-UTQSSKSG.js +1164 -0
  121. package/dist/chunk-UTQSSKSG.js.map +1 -0
  122. package/dist/chunk-VA42637J.cjs +287 -0
  123. package/dist/chunk-VA42637J.cjs.map +1 -0
  124. package/dist/chunk-VNQRI2RO.cjs +1047 -0
  125. package/dist/chunk-VNQRI2RO.cjs.map +1 -0
  126. package/dist/chunk-VXPLKQWY.cjs +821 -0
  127. package/dist/chunk-VXPLKQWY.cjs.map +1 -0
  128. package/dist/chunk-WD6HJRBG.cjs +197 -0
  129. package/dist/chunk-WD6HJRBG.cjs.map +1 -0
  130. package/dist/chunk-WDIBOWAA.js +1054 -0
  131. package/dist/chunk-WDIBOWAA.js.map +1 -0
  132. package/dist/chunk-WKOIGLQX.cjs +38 -0
  133. package/dist/chunk-WKOIGLQX.cjs.map +1 -0
  134. package/dist/chunk-WNVQ3SMB.cjs +96 -0
  135. package/dist/chunk-WNVQ3SMB.cjs.map +1 -0
  136. package/dist/chunk-WRSWH7US.cjs +285 -0
  137. package/dist/chunk-WRSWH7US.cjs.map +1 -0
  138. package/dist/chunk-XGFTL5XY.js +181 -0
  139. package/dist/chunk-XGFTL5XY.js.map +1 -0
  140. package/dist/chunk-XNISPHTZ.js +1039 -0
  141. package/dist/chunk-XNISPHTZ.js.map +1 -0
  142. package/dist/chunk-Y2PM3FFL.js +3 -0
  143. package/dist/chunk-Y2PM3FFL.js.map +1 -0
  144. package/dist/chunk-YBPBK5KI.js +1030 -0
  145. package/dist/chunk-YBPBK5KI.js.map +1 -0
  146. package/dist/chunk-YWNYGYI7.cjs +31 -0
  147. package/dist/chunk-YWNYGYI7.cjs.map +1 -0
  148. package/dist/chunk-YYV35XOS.js +122 -0
  149. package/dist/chunk-YYV35XOS.js.map +1 -0
  150. package/dist/chunk-Z2OL5AJD.cjs +133 -0
  151. package/dist/chunk-Z2OL5AJD.cjs.map +1 -0
  152. package/dist/chunk-ZDFHA2EC.js +572 -0
  153. package/dist/chunk-ZDFHA2EC.js.map +1 -0
  154. package/dist/chunk-ZL7UM6PU.cjs +34 -0
  155. package/dist/chunk-ZL7UM6PU.cjs.map +1 -0
  156. package/dist/chunk-ZNZDQAXN.js +175 -0
  157. package/dist/chunk-ZNZDQAXN.js.map +1 -0
  158. package/dist/chunk-ZO5PBBFX.js +3497 -0
  159. package/dist/chunk-ZO5PBBFX.js.map +1 -0
  160. package/dist/chunk-ZRL2UFTH.cjs +1073 -0
  161. package/dist/chunk-ZRL2UFTH.cjs.map +1 -0
  162. package/dist/entries/apps.cjs +155 -0
  163. package/dist/entries/apps.cjs.map +1 -0
  164. package/dist/entries/apps.d.cts +292 -0
  165. package/dist/entries/apps.d.ts +292 -0
  166. package/dist/entries/apps.js +10 -0
  167. package/dist/entries/apps.js.map +1 -0
  168. package/dist/entries/captions.cjs +124 -0
  169. package/dist/entries/captions.cjs.map +1 -0
  170. package/dist/entries/captions.d.cts +354 -0
  171. package/dist/entries/captions.d.ts +354 -0
  172. package/dist/entries/captions.js +3 -0
  173. package/dist/entries/captions.js.map +1 -0
  174. package/dist/entries/catalogs.cjs +165 -0
  175. package/dist/entries/catalogs.cjs.map +1 -0
  176. package/dist/entries/catalogs.d.cts +385 -0
  177. package/dist/entries/catalogs.d.ts +385 -0
  178. package/dist/entries/catalogs.js +4 -0
  179. package/dist/entries/catalogs.js.map +1 -0
  180. package/dist/entries/credits.cjs +596 -0
  181. package/dist/entries/credits.cjs.map +1 -0
  182. package/dist/entries/credits.d.cts +1460 -0
  183. package/dist/entries/credits.d.ts +1460 -0
  184. package/dist/entries/credits.js +11 -0
  185. package/dist/entries/credits.js.map +1 -0
  186. package/dist/entries/edl.cjs +409 -0
  187. package/dist/entries/edl.cjs.map +1 -0
  188. package/dist/entries/edl.d.cts +1199 -0
  189. package/dist/entries/edl.d.ts +1199 -0
  190. package/dist/entries/edl.js +4 -0
  191. package/dist/entries/edl.js.map +1 -0
  192. package/dist/entries/entities.cjs +530 -0
  193. package/dist/entries/entities.cjs.map +1 -0
  194. package/dist/entries/entities.d.cts +1371 -0
  195. package/dist/entries/entities.d.ts +1371 -0
  196. package/dist/entries/entities.js +5 -0
  197. package/dist/entries/entities.js.map +1 -0
  198. package/dist/entries/i18n.cjs +48 -0
  199. package/dist/entries/i18n.cjs.map +1 -0
  200. package/dist/entries/i18n.d.cts +69 -0
  201. package/dist/entries/i18n.d.ts +69 -0
  202. package/dist/entries/i18n.js +3 -0
  203. package/dist/entries/i18n.js.map +1 -0
  204. package/dist/entries/llm-models.cjs +177 -0
  205. package/dist/entries/llm-models.cjs.map +1 -0
  206. package/dist/entries/llm-models.d.cts +435 -0
  207. package/dist/entries/llm-models.d.ts +435 -0
  208. package/dist/entries/llm-models.js +4 -0
  209. package/dist/entries/llm-models.js.map +1 -0
  210. package/dist/entries/media.cjs +335 -0
  211. package/dist/entries/media.cjs.map +1 -0
  212. package/dist/entries/media.d.cts +518 -0
  213. package/dist/entries/media.d.ts +518 -0
  214. package/dist/entries/media.js +6 -0
  215. package/dist/entries/media.js.map +1 -0
  216. package/dist/entries/model-catalog.cjs +259 -0
  217. package/dist/entries/model-catalog.cjs.map +1 -0
  218. package/dist/entries/model-catalog.d.cts +202 -0
  219. package/dist/entries/model-catalog.d.ts +202 -0
  220. package/dist/entries/model-catalog.js +6 -0
  221. package/dist/entries/model-catalog.js.map +1 -0
  222. package/dist/entries/models.cjs +833 -0
  223. package/dist/entries/models.cjs.map +1 -0
  224. package/dist/entries/models.d.cts +287 -0
  225. package/dist/entries/models.d.ts +287 -0
  226. package/dist/entries/models.js +8 -0
  227. package/dist/entries/models.js.map +1 -0
  228. package/dist/entries/nodes.cjs +789 -0
  229. package/dist/entries/nodes.cjs.map +1 -0
  230. package/dist/entries/nodes.d.cts +1600 -0
  231. package/dist/entries/nodes.d.ts +1600 -0
  232. package/dist/entries/nodes.js +16 -0
  233. package/dist/entries/nodes.js.map +1 -0
  234. package/dist/entries/organizations.cjs +80 -0
  235. package/dist/entries/organizations.cjs.map +1 -0
  236. package/dist/entries/organizations.d.cts +466 -0
  237. package/dist/entries/organizations.d.ts +466 -0
  238. package/dist/entries/organizations.js +3 -0
  239. package/dist/entries/organizations.js.map +1 -0
  240. package/dist/entries/pipeline.cjs +594 -0
  241. package/dist/entries/pipeline.cjs.map +1 -0
  242. package/dist/entries/pipeline.d.cts +2617 -0
  243. package/dist/entries/pipeline.d.ts +2617 -0
  244. package/dist/entries/pipeline.js +5 -0
  245. package/dist/entries/pipeline.js.map +1 -0
  246. package/dist/entries/scene3d.cjs +704 -0
  247. package/dist/entries/scene3d.cjs.map +1 -0
  248. package/dist/entries/scene3d.d.cts +4284 -0
  249. package/dist/entries/scene3d.d.ts +4284 -0
  250. package/dist/entries/scene3d.js +3 -0
  251. package/dist/entries/scene3d.js.map +1 -0
  252. package/dist/entries/social.cjs +714 -0
  253. package/dist/entries/social.cjs.map +1 -0
  254. package/dist/entries/social.d.cts +1366 -0
  255. package/dist/entries/social.d.ts +1366 -0
  256. package/dist/entries/social.js +5 -0
  257. package/dist/entries/social.js.map +1 -0
  258. package/dist/entries/types.cjs +13 -0
  259. package/dist/entries/types.cjs.map +1 -0
  260. package/dist/entries/types.d.cts +162 -0
  261. package/dist/entries/types.d.ts +162 -0
  262. package/dist/entries/types.js +4 -0
  263. package/dist/entries/types.js.map +1 -0
  264. package/dist/entries/ugc.cjs +279 -0
  265. package/dist/entries/ugc.cjs.map +1 -0
  266. package/dist/entries/ugc.d.cts +575 -0
  267. package/dist/entries/ugc.d.ts +575 -0
  268. package/dist/entries/ugc.js +6 -0
  269. package/dist/entries/ugc.js.map +1 -0
  270. package/dist/entries/video.cjs +549 -0
  271. package/dist/entries/video.cjs.map +1 -0
  272. package/dist/entries/video.d.cts +1791 -0
  273. package/dist/entries/video.d.ts +1791 -0
  274. package/dist/entries/video.js +8 -0
  275. package/dist/entries/video.js.map +1 -0
  276. package/dist/entries/workflow.cjs +574 -0
  277. package/dist/entries/workflow.cjs.map +1 -0
  278. package/dist/entries/workflow.d.cts +1743 -0
  279. package/dist/entries/workflow.d.ts +1743 -0
  280. package/dist/entries/workflow.js +5 -0
  281. package/dist/entries/workflow.js.map +1 -0
  282. package/dist/fan-out-meta-Bu6VyXcZ.d.cts +19 -0
  283. package/dist/fan-out-meta-Bu6VyXcZ.d.ts +19 -0
  284. package/dist/gemini-omni-voices-zeRXxSbZ.d.cts +174 -0
  285. package/dist/gemini-omni-voices-zeRXxSbZ.d.ts +174 -0
  286. package/dist/image-overlay-layers-CyBfRhxJ.d.cts +208 -0
  287. package/dist/image-overlay-layers-CyBfRhxJ.d.ts +208 -0
  288. package/dist/index.cjs +7747 -27084
  289. package/dist/index.cjs.map +1 -1
  290. package/dist/index.d.cts +32 -24198
  291. package/dist/index.d.ts +32 -24198
  292. package/dist/index.js +40 -25220
  293. package/dist/index.js.map +1 -1
  294. package/dist/model-catalog-V-ZNzRSd.d.cts +651 -0
  295. package/dist/model-catalog-V-ZNzRSd.d.ts +651 -0
  296. package/dist/presentation-types-0ENOCjoj.d.cts +61 -0
  297. package/dist/presentation-types-0ENOCjoj.d.ts +61 -0
  298. package/dist/presentation-utils-D0kxsWf9.d.cts +92 -0
  299. package/dist/presentation-utils-pZwlEAzo.d.ts +92 -0
  300. package/dist/scene-node-types-C3kl_zyK.d.cts +1949 -0
  301. package/dist/scene-node-types-C3kl_zyK.d.ts +1949 -0
  302. package/dist/supported-fonts-CRoF1gOy.d.cts +16 -0
  303. package/dist/supported-fonts-CRoF1gOy.d.ts +16 -0
  304. package/dist/types-BRlFPEru.d.cts +511 -0
  305. package/dist/types-BRlFPEru.d.ts +511 -0
  306. package/dist/types-DffyGSy5.d.cts +67 -0
  307. package/dist/types-DffyGSy5.d.ts +67 -0
  308. package/package.json +102 -1
  309. package/src/__tests__/add-captions-plan.test.ts +6 -2
  310. package/src/__tests__/caption-edge-dash.test.ts +23 -0
  311. package/src/__tests__/fixtures/root-exports.baseline.json +4625 -0
  312. package/src/__tests__/input-field-extra-keys.test.ts +1 -0
  313. package/src/__tests__/model-makers.test.ts +76 -0
  314. package/src/__tests__/no-internal-imports.test.ts +1 -1
  315. package/src/__tests__/node-aspect-ratio.test.ts +25 -0
  316. package/src/__tests__/node-runtime-keys.test.ts +9 -0
  317. package/src/__tests__/package-entries.test.ts +50 -0
  318. package/src/__tests__/pitch-tempo-pricing.test.ts +21 -0
  319. package/src/__tests__/presentation-utils.test.ts +15 -0
  320. package/src/__tests__/preview-gate-use-case.test.ts +151 -0
  321. package/src/__tests__/private-host.test.ts +53 -0
  322. package/src/__tests__/run-continuation.test.ts +7 -1
  323. package/src/__tests__/site-capture-node.test.ts +58 -0
  324. package/src/__tests__/ugc-lane-wires.test.ts +228 -0
  325. package/src/__tests__/ugc-node-wires.test.ts +9 -3
  326. package/src/__tests__/ugc-run-state.test.ts +5 -4
  327. package/src/__tests__/video-analysis-catalog-sync.test.ts +1 -1
  328. package/src/__tests__/video-analysis-pricing.test.ts +6 -6
  329. package/src/__tests__/voice-changer-pro-quote.test.ts +79 -0
  330. package/src/add-captions-plan.ts +9 -3
  331. package/src/caption-edge-dash.ts +33 -0
  332. package/src/component-types.ts +9 -0
  333. package/src/credit-estimators/index.ts +22 -1
  334. package/src/credit-estimators/pitch-tempo.ts +15 -1
  335. package/src/credit-estimators/speech.ts +72 -4
  336. package/src/credit-estimators/unit-quote.ts +52 -0
  337. package/src/credit-estimators/video-sfx.ts +15 -0
  338. package/src/credit-estimators/voice-changer-pro-quote.ts +138 -0
  339. package/src/credit-identifiers.ts +62 -17
  340. package/src/entity-image-handle.ts +2 -0
  341. package/src/entries/apps.ts +63 -0
  342. package/src/entries/captions.ts +34 -0
  343. package/src/entries/catalogs.ts +65 -0
  344. package/src/entries/credits.ts +105 -0
  345. package/src/entries/edl.ts +42 -0
  346. package/src/entries/entities.ts +144 -0
  347. package/src/entries/i18n.ts +31 -0
  348. package/src/entries/llm-models.ts +63 -0
  349. package/src/entries/media.ts +36 -0
  350. package/src/entries/model-catalog.ts +95 -0
  351. package/src/entries/models.ts +266 -0
  352. package/src/entries/nodes.ts +245 -0
  353. package/src/entries/organizations.ts +9 -0
  354. package/src/entries/pipeline.ts +43 -0
  355. package/src/entries/scene3d.ts +27 -0
  356. package/src/entries/social.ts +297 -0
  357. package/src/entries/types.ts +26 -0
  358. package/src/entries/ugc.ts +14 -0
  359. package/src/entries/video.ts +59 -0
  360. package/src/entries/workflow.ts +172 -0
  361. package/src/fan-out-rows.ts +2 -0
  362. package/src/index.ts +25 -1845
  363. package/src/json-kinds.ts +4 -0
  364. package/src/model-catalog.ts +243 -34
  365. package/src/node-mappable-fields.ts +1 -0
  366. package/src/node-run-routes.ts +2 -0
  367. package/src/node-runtime-keys.ts +8 -0
  368. package/src/normalize-node-params.ts +30 -0
  369. package/src/presentation-utils.ts +12 -0
  370. package/src/preview-gate.ts +92 -14
  371. package/src/private-host.ts +89 -59
  372. package/src/producer-types.ts +16 -2
  373. package/src/run-continuation.ts +21 -0
  374. package/src/site-capture-node.ts +82 -0
  375. package/src/ugc-lane-wires.ts +246 -0
  376. package/src/ugc-node-wires.ts +37 -7
  377. package/src/ugc-run-state.ts +5 -3
  378. package/src/video-analysis-pricing.ts +31 -29
@@ -0,0 +1,1600 @@
1
+ export { C as ClipNote, F as FanOutItemMeta, c as clipNotesFrom, f as fanOutItemMeta } from '../fan-out-meta-Bu6VyXcZ.js';
2
+ import { e as ModelInputAdjustment } from '../model-catalog-V-ZNzRSd.js';
3
+
4
+ /** Node types whose run route is NOT `POST /v1/<type>`. */
5
+ declare const NODE_RUN_ROUTES: Readonly<Record<string, string>>;
6
+ /**
7
+ * Node types with no route that runs them on their own, each with what to run
8
+ * instead. They run inside the editor or a workflow, or through a sibling
9
+ * route that takes a differently shaped body.
10
+ */
11
+ declare const NODE_TYPES_WITHOUT_RUN_ROUTE: Readonly<Record<string, string>>;
12
+ /**
13
+ * The route that runs `type` on its own, or null when it has none (see
14
+ * {@link NODE_TYPES_WITHOUT_RUN_ROUTE} for what to run instead).
15
+ */
16
+ declare function nodeRunRoute(type: string): string | null;
17
+
18
+ /**
19
+ * Per-node-type list of field names eligible for fieldMappings resolution.
20
+ * Text fields also participate in {} injection when the resolver sees a
21
+ * string value containing {} markers; non-text fields just receive the
22
+ * mapped source's value verbatim.
23
+ */
24
+ declare const NODE_MAPPABLE_FIELDS: Readonly<Record<string, readonly string[]>>;
25
+ /** suno-generate secondary text fields exposed as `field-<key>` canvas handles. */
26
+ declare const SUNO_FIELD_HANDLE_FIELDS: readonly ["style", "lyrics", "title", "negativeStyle"];
27
+ /** Map a `field-<key>` handle id to its data key, or null if not a field handle. */
28
+ declare function fieldKeyFromHandle(handleId: string): string | null;
29
+
30
+ /** The handle id of the Settings input. */
31
+ declare const SETTINGS_INPUT_HANDLE = "settings";
32
+ /** A Generation Settings node type → the consumer data field it sets. */
33
+ declare const SETTINGS_SOURCE_FIELDS: {
34
+ readonly "aspect-ratio": "aspectRatio";
35
+ readonly duration: "duration";
36
+ readonly provider: "provider";
37
+ };
38
+ /**
39
+ * Generation Settings nodes a Settings input takes as a prompt CLAUSE rather
40
+ * than a field: Motion (how much the shot moves). Each engine's hint collector
41
+ * adds its clause beside the Look family's, under the same Inject Look switch
42
+ * (`isSettingsHintEdge`).
43
+ */
44
+ declare const SETTINGS_HINT_SOURCES: readonly ["motion"];
45
+ type SettingsFieldSourceType = keyof typeof SETTINGS_SOURCE_FIELDS;
46
+ type SettingsHintSourceType = (typeof SETTINGS_HINT_SOURCES)[number];
47
+ type SettingsSourceType = SettingsFieldSourceType | SettingsHintSourceType;
48
+ type SettingsField = (typeof SETTINGS_SOURCE_FIELDS)[SettingsFieldSourceType];
49
+ /** Every Generation Settings node type a Settings input can take. */
50
+ declare const SETTINGS_SOURCE_TYPES: readonly SettingsSourceType[];
51
+ /** The consumers that have a Settings input, and the settings each accepts. */
52
+ declare const SETTINGS_INPUT_CONSUMERS: Readonly<Record<string, readonly SettingsSourceType[]>>;
53
+ declare function isSettingsSourceType(type: string | undefined | null): type is SettingsSourceType;
54
+ /** Whether a Generation Settings node adds a prompt clause rather than setting a field. */
55
+ declare function isSettingsHintSource(type: string | undefined | null): type is SettingsHintSourceType;
56
+ /** Whether `consumerType`'s Settings input takes a `sourceType` node. */
57
+ declare function settingsInputAccepts(consumerType: string, sourceType: string): boolean;
58
+ /** The consumer fields a Settings input can set, for `NODE_MAPPABLE_FIELDS`. */
59
+ declare function settingsInputFields(consumerType: string): SettingsField[];
60
+ /** The models a wired Provider may name on `consumerType` (empty for a non-consumer). */
61
+ declare function settingsProviderModels(consumerType: string): readonly string[];
62
+ interface SettingsEdge {
63
+ readonly source: string;
64
+ readonly target: string;
65
+ readonly targetHandle?: string | null;
66
+ }
67
+ /**
68
+ * The `sourceType` node wired into `consumerId`'s Settings input, or
69
+ * undefined. When two nodes of one kind are wired, the LAST edge wins — the
70
+ * same rule as every other single-value input.
71
+ */
72
+ declare function settingsSourceForType(consumerId: string, consumerType: string, sourceType: SettingsSourceType, edges: ReadonlyArray<SettingsEdge>, typeOf: (nodeId: string) => string | undefined | null): string | undefined;
73
+ /** The node wired into `consumerId`'s Settings input that sets `field`, or undefined (last edge wins). */
74
+ declare function settingsSourceForField(consumerId: string, consumerType: string, field: string, edges: ReadonlyArray<SettingsEdge>, typeOf: (nodeId: string) => string | undefined | null): string | undefined;
75
+ /**
76
+ * Whether `edge` brings a prompt-clause setting (Motion) into its target's
77
+ * Settings input and is the one of its kind that applies (the last edge). The
78
+ * hint collectors of both engines ask this, so the clause a run gets is the
79
+ * one the node's chips show.
80
+ */
81
+ declare function isSettingsHintEdge(edge: SettingsEdge, consumerType: string, edges: ReadonlyArray<SettingsEdge>, typeOf: (nodeId: string) => string | undefined | null): boolean;
82
+ /**
83
+ * Every setting wired into `consumerId`'s Settings input, one per kind (the
84
+ * last edge of a kind wins), in the order of `SETTINGS_INPUT_CONSUMERS`.
85
+ */
86
+ declare function connectedSettingsSources(consumerId: string, consumerType: string, edges: ReadonlyArray<SettingsEdge>, typeOf: (nodeId: string) => string | undefined | null): Array<{
87
+ sourceType: SettingsSourceType;
88
+ field?: SettingsField;
89
+ sourceId: string;
90
+ }>;
91
+ /**
92
+ * `seconds` as `model` renders it: the nearest duration the catalog lists for
93
+ * the model, a tie going to the shorter one — the rule the provider layer
94
+ * applies when it renders (`snapToAllowedDuration`, KIE), so the length the
95
+ * run is priced at is the length it renders. Not `normalizeModelInput`'s
96
+ * duration snap, which replaces an invalid value with the model's FIRST
97
+ * length: right for a typo, wrong for a wired length (a 60 s Duration would
98
+ * become the model's shortest clip instead of its longest). A model without a
99
+ * duration list, and the "auto" duration, keep the value.
100
+ */
101
+ declare function snapToModelDuration(model: string, seconds: number): number;
102
+ type SettingsInputProblem = {
103
+ readonly kind: "provider-not-accepted";
104
+ readonly sourceId: string;
105
+ readonly value: string;
106
+ };
107
+ /**
108
+ * The consumer's data once its Settings input has been read (after the field
109
+ * mapping resolver wrote each wired value into its field):
110
+ * - a wired Provider must name a model this consumer runs: a Provider node set
111
+ * to an image model cannot drive Generate Video, and the run refuses with
112
+ * `problem` rather than sending an image model to the video provider;
113
+ * - a wired Provider on a node that runs several models per run replaces the
114
+ * list with its one model (see `SettingsConsumer.modelList`);
115
+ * - a wired Duration is fitted to the model (see `SettingsConsumer.duration`);
116
+ * - a wired Aspect Ratio is fitted to the model (`fitAspectRatioToModel`).
117
+ */
118
+ declare function applySettingsInput(consumerType: string, consumerId: string, data: Readonly<Record<string, unknown>>, edges: ReadonlyArray<SettingsEdge>, typeOf: (nodeId: string) => string | undefined | null): {
119
+ data: Record<string, unknown>;
120
+ problem?: SettingsInputProblem;
121
+ };
122
+ interface SettingsGraphNode {
123
+ readonly id: string;
124
+ readonly type?: string | null;
125
+ readonly data?: unknown;
126
+ }
127
+ /** One setting wired into a node's Settings input. */
128
+ interface WiredSetting {
129
+ readonly sourceType: SettingsSourceType;
130
+ /** The field it sets; none for a prompt-clause setting (Motion). */
131
+ readonly field?: SettingsField;
132
+ readonly sourceId: string;
133
+ /** The value the wired node holds, read the way the run engines read it. */
134
+ readonly value: string | undefined;
135
+ }
136
+ /**
137
+ * What `consumerId` runs with once its Settings input is read: its data with
138
+ * each wired setting written into its field and fitted to the model — the
139
+ * steps the run engines take (field-mapping resolver, then
140
+ * `applySettingsInput`), for the readers that run before any resolver: the
141
+ * workflow estimate, the node's chips and its settings panel.
142
+ */
143
+ declare function resolveWiredSettings(consumerId: string, consumerType: string, data: Readonly<Record<string, unknown>>, nodes: ReadonlyArray<SettingsGraphNode>, edges: ReadonlyArray<SettingsEdge>): {
144
+ data: Record<string, unknown>;
145
+ wired: WiredSetting[];
146
+ problem?: SettingsInputProblem;
147
+ };
148
+ interface SettingsNodeLike {
149
+ readonly id?: string;
150
+ readonly type?: string | null;
151
+ readonly data?: unknown;
152
+ }
153
+ interface SettingsEdgeLike {
154
+ readonly source?: string;
155
+ readonly target: string;
156
+ readonly targetHandle?: string | null;
157
+ }
158
+ /**
159
+ * `node` as it runs, for the readers that plan or price a run before any
160
+ * resolver: the workflow estimates, the Run price, and the fan-out plan (a
161
+ * wired Provider turns a several-model image run into one). A node with no
162
+ * Settings input — or a caller without the graph — gets `node` back as is.
163
+ */
164
+ declare function withWiredSettings<T extends SettingsNodeLike>(node: T, nodes?: ReadonlyArray<SettingsNodeLike>, edges?: ReadonlyArray<SettingsEdgeLike>): T;
165
+
166
+ declare const SCRIPT_SCENE_COUNT_RANGE: {
167
+ readonly min: 1;
168
+ readonly max: 20;
169
+ };
170
+ declare const SCRIPT_TARGET_DURATION_RANGE: {
171
+ readonly min: 5;
172
+ readonly max: 600;
173
+ };
174
+ /** What the script generator uses when a request leaves the field out. */
175
+ declare const SCRIPT_SCENE_COUNT_DEFAULT = 5;
176
+ /** Seconds; what the script generator uses when a request leaves it out. */
177
+ declare const SCRIPT_TARGET_DURATION_DEFAULT = 60;
178
+ declare const SCRIPT_TONE_MAX_LENGTH = 200;
179
+ declare const SCRIPT_STYLE_GUIDE_MAX_LENGTH = 100000;
180
+ interface ScriptSettings {
181
+ sceneCount?: number;
182
+ tone?: string;
183
+ /** Seconds. */
184
+ targetDuration?: number;
185
+ styleGuide?: string;
186
+ }
187
+ /**
188
+ * The settings a Generate Script node sends. `refMap` resolves `{Node Label}`
189
+ * references in the style guide, the one field here with a reference-aware
190
+ * editor; references with no matching node stay as typed.
191
+ */
192
+ declare function readScriptSettings(data: Record<string, unknown>, refMap?: ReadonlyMap<string, string>): ScriptSettings;
193
+
194
+ /** The quality an Apply EDL render was made at. "proxy" is a Preview. */
195
+ type RenderQuality = "proxy" | "final";
196
+ /** The medium a render hands on. */
197
+ type RenderMedium = "video" | "audio";
198
+ /** What a finished render says about itself beside its URL. */
199
+ interface RenderResultStamp {
200
+ readonly quality?: RenderQuality;
201
+ /** The plan clip the render was cut from (`edlSpanKey` of that clip). */
202
+ readonly clipKey?: string;
203
+ /** The plan value the render was cut from (`renderReadBasis`): stamped only
204
+ * when that value is the plan's own (`renderPlanBasis`). Absent = unknown. */
205
+ readonly planBasis?: string;
206
+ /** The render's own settings (`renderSettingsBasis`): its output, its
207
+ * crossfade and the media it read. */
208
+ readonly renderBasis?: string;
209
+ }
210
+ /** One row of a run's per-item results, row-aligned with them. A row that
211
+ * produced nothing (a hole) carries no take's fields; a render's hole still
212
+ * says what it was sent for (`renderSentRowStamps`): the quality its run
213
+ * renders at and, when the run can name it, its clip (`clipKey`,
214
+ * `renderPlanRowClipKeys`), so a failed row is matched to its clip by key.
215
+ * `{}` is a hole that names none (a run made before every row was stamped, or
216
+ * a node that is not a render). */
217
+ interface RunResultRowStamp extends RenderResultStamp {
218
+ readonly jobId?: string;
219
+ readonly thumbnailUrl?: string;
220
+ /** The row never ran: a Stop, or the fail-fast after another row failed,
221
+ * skipped it. It is a hole, never a failure. */
222
+ readonly cancelled?: true;
223
+ }
224
+ /** One saved render result. */
225
+ interface SavedRenderItem extends RenderResultStamp {
226
+ readonly url: string;
227
+ readonly medium: RenderMedium;
228
+ readonly jobId?: string;
229
+ readonly thumbnailUrl?: string;
230
+ }
231
+ type Data = Readonly<Record<string, unknown>>;
232
+ /** The stamp a finished render's output carries: a known quality, a non-empty
233
+ * clip key and the two bases as 16 hex digits, nothing else (an unknown value
234
+ * is dropped, not trusted). */
235
+ declare function renderResultStamp(output: unknown): RenderResultStamp;
236
+ /** The one result a saved render hands a scalar edge: the selected result (as
237
+ * the node's medium), else the saved field of its medium, else the other
238
+ * medium's field (as that medium). */
239
+ declare function savedRenderOutput(data: Data): SavedRenderItem | undefined;
240
+ /** The rows of a saved render's LATEST batch, row-aligned (`null` = a row that
241
+ * produced nothing), each with what its render stamped. `undefined` when the
242
+ * render has no batch (it ran once, or never). */
243
+ declare function savedRenderBatch(data: Data): ReadonlyArray<SavedRenderItem | null> | undefined;
244
+ /** The latest batch as the list an each edge iterates (`""` = a hole). */
245
+ declare function savedRenderBatchUrls(data: Data): string[] | undefined;
246
+ /**
247
+ * A plan clip's identity: the outer span of its kept segments on the master
248
+ * clock, `${min inMs}-${max outMs}` (integer ms, as `normalizeEdl` rounds them).
249
+ * Taken from the PLAN's clip, never from a rendered EDL — Camera Switch can
250
+ * move a clip's outer edges inward. `undefined` when the value is not an EDL
251
+ * with segments.
252
+ */
253
+ declare function edlSpanKey(edl: unknown): string | undefined;
254
+ /** The clip key of row `row` of a clips plan (a list of EDLs, objects or JSON
255
+ * strings). `undefined` for a plan that is one EDL (Tighten), a missing row,
256
+ * or a row that is not an EDL. */
257
+ declare function planClipKeyAt(plan: unknown, row: number): string | undefined;
258
+ /** A node or an edge as the plan walk needs it (either engine's graph). */
259
+ interface RenderGraphNode {
260
+ readonly id: string;
261
+ readonly type?: string | null;
262
+ }
263
+ interface RenderGraphEdge {
264
+ readonly source: string;
265
+ readonly target: string;
266
+ readonly sourceHandle?: string | null;
267
+ readonly targetHandle?: string | null;
268
+ /** The wire's settings: its `outputMode` and its range / list selector. */
269
+ readonly data?: unknown;
270
+ }
271
+ /** One wire on the way from the plan to the render that picks clips: the render's
272
+ * `edl` wire, or a Camera Switch's. */
273
+ interface RenderPlanHop {
274
+ /** The consumer's wire — the one whose selector the input resolvers apply. */
275
+ readonly edge: RenderGraphEdge;
276
+ /** Whether the wire hands on one clip per row ("each"), as both resolvers
277
+ * decide it: its `outputMode`, else the default of the node behind any
278
+ * teleports, on the handle that node is wired from. */
279
+ readonly each: boolean;
280
+ /** The type of the node the wire hands the clips on from, behind any
281
+ * teleports: what a "Selected" (`last`) wire reads is that node's own output. */
282
+ readonly source?: string;
283
+ }
284
+ /** The Edit Plan behind a render and the wires between them, plan side first. */
285
+ interface RenderPlanPath {
286
+ readonly planId: string;
287
+ readonly hops: readonly RenderPlanHop[];
288
+ }
289
+ /**
290
+ * The Edit Plan whose clips a render's `edl` input comes from, and the wires
291
+ * that pick them: up the LAST wire on its `edl` handle (both engines keep the
292
+ * last value), through teleports and Camera Switch. `undefined` when the EDL
293
+ * comes from anything else.
294
+ */
295
+ declare function renderPlanPath(renderId: string, nodes: readonly RenderGraphNode[], edges: readonly RenderGraphEdge[]): RenderPlanPath | undefined;
296
+ /** The Edit Plan whose clips a render's `edl` input comes from (`renderPlanPath`). */
297
+ declare function renderPlanNodeId(renderId: string, nodes: readonly RenderGraphNode[], edges: readonly RenderGraphEdge[]): string | undefined;
298
+ /**
299
+ * The plan value a render iteration reads. `plan` is the plan's output as the
300
+ * engine holds it: a clip set's clips (a list of EDLs, objects or JSON strings,
301
+ * `""` at a dropped clip), or a Tighten plan's one EDL — which every wire hands
302
+ * on as it is. `hops` are the wires from the plan down (`renderPlanPath`). Each
303
+ * "each" wire hands on the clips its selector picks — Camera Switch's row k is
304
+ * row k of ITS selection, the render's row k row k of its own — exactly as both
305
+ * input resolvers select before they index. A wire that hands on one value
306
+ * hands on the clip it picks (`singlePick`), and names one only when exactly
307
+ * one is picked.
308
+ *
309
+ * Holes (a dropped clip, TA16) follow the row space each wire really hands on.
310
+ * A pass-through node (Camera Switch: every hop but the last) runs once per
311
+ * KEPT clip of its selection and both engines store its batch by iteration, so
312
+ * the next wire reads a list without the holes. The last wire, into the
313
+ * render, is not compacted: a render wired straight to the plan is rowed in
314
+ * the plan's own rows, holes included.
315
+ *
316
+ * With a row on an "each" wire, the row's clip; a row past the clips starts
317
+ * over from the first, as the resolvers read it. With no row (a render run
318
+ * once, or Repeat xN with nothing list-driven), the clip only when exactly one
319
+ * KEPT clip is left — the scalar both engines read — and any other plan names
320
+ * no single clip. An empty row names nothing.
321
+ */
322
+ declare function renderPlanValue(plan: unknown, row: number | undefined, hops?: readonly RenderPlanHop[]): unknown;
323
+ /** The clip a render iteration reads, as a key (`edlSpanKey` of the clip
324
+ * `renderPlanValue` picks). A Tighten plan names no clip. */
325
+ declare function renderClipKey(plan: unknown, row: number | undefined, hops?: readonly RenderPlanHop[]): string | undefined;
326
+ /**
327
+ * The clip key a render iteration stamps — the ONE rule both engines call: the
328
+ * Edit Plan behind its `edl` wire (`renderPlanPath`), its clips as the engine
329
+ * holds them (`planClips`), picked by every wire on the way and indexed by the
330
+ * iteration's list row (`renderClipKey`). Pass the row only when a list drives
331
+ * it, never an iteration number.
332
+ */
333
+ declare function renderPlanClipKey(renderId: string, nodes: readonly RenderGraphNode[], edges: readonly RenderGraphEdge[], planClips: (planNode: RenderGraphNode) => unknown, row: number | undefined): string | undefined;
334
+ /**
335
+ * The clip key of EVERY iteration of a render's fan-out, row-aligned with its
336
+ * batch: `rows[k]` is iteration k's list row (`FanOutPlan.rows`), as both
337
+ * engines hand it to `renderPlanClipKey` (never the iteration number). Both
338
+ * engines stamp it on each batch row up front, so a row that FAILED still
339
+ * names its clip (decided 2026-10-06): the batch has one row per run, not one
340
+ * per plan clip, and a reader matches rows to clips by this key, never by
341
+ * position. The plan is read once, as the run held it when the fan-out began.
342
+ */
343
+ declare function renderPlanRowClipKeys(renderId: string, nodes: readonly RenderGraphNode[], edges: readonly RenderGraphEdge[], planClips: (planNode: RenderGraphNode) => unknown, rows: ReadonlyArray<number | undefined>, ranIds: ReadonlySet<string>): Array<string | undefined>;
344
+ /** The quality a render runs at: its `quality` setting as the run holds it
345
+ * ("proxy" is a Preview; anything else renders a final). */
346
+ declare function renderRunQuality(data: Readonly<Record<string, unknown>> | undefined): RenderQuality;
347
+ /**
348
+ * What every row of a render's fan-out batch is stamped with before it runs
349
+ * (decided 2026-10-06): the quality the run renders at and the clip the row is
350
+ * sent for (`renderPlanRowClipKeys`, absent when the run cannot name it). Both
351
+ * engines write it on every row; a landed take's own stamp wins over it, so a
352
+ * row that FAILED still says which clip, and at which quality, it was sent for.
353
+ */
354
+ declare function renderSentRowStamps(quality: RenderQuality, clipKeys: ReadonlyArray<string | undefined>): RunResultRowStamp[];
355
+ /**
356
+ * The fingerprint of the plan value a render read (R2 a, decided 2026-10-06):
357
+ * `editPlanBasis` of the value with its top-level `meta` removed. No renderer
358
+ * reads `meta`, so an edited hook (a clip's `meta.hook`, text only) leaves it
359
+ * unchanged. A clip given as JSON text reads as its object. `undefined` for
360
+ * anything that is not one plan object (a list, a scalar, unparsable text).
361
+ */
362
+ declare function renderReadBasis(value: unknown): string | undefined;
363
+ /** A render's own settings, as it reads them. */
364
+ interface RenderSettingsInput {
365
+ /** Any value other than "audio" is a video render. */
366
+ readonly output?: unknown;
367
+ /** The default crossfade in ms; missing, negative or non-finite is a hard cut. */
368
+ readonly crossfadeMs?: unknown;
369
+ }
370
+ /**
371
+ * The fingerprint of a render's own settings (R19 a, decided 2026-10-06):
372
+ * `editPlanBasis({crossfadeMs, output, sources})`. `sources` is the EFFECTIVE
373
+ * source list — the URL of each source of the effective EDL the render cuts,
374
+ * in order, with the `sources` wires' overrides applied (`""` for a source with
375
+ * no URL). A change to any of the three changes the cut while the plan value
376
+ * stays equal. The settings are read as the render reads them: whole ms, a
377
+ * hard cut when the crossfade is missing.
378
+ */
379
+ declare function renderSettingsBasis(settings: RenderSettingsInput, sources?: ReadonlyArray<string | undefined>): string;
380
+ /**
381
+ * The plan basis a render iteration stamps — the ONE rule both engines call
382
+ * (R1 a, decided 2026-10-06). The plan value the iteration read
383
+ * (`renderPlanValue` of `planOutput` — the plan's output as the run holds it —
384
+ * along `renderPlanPath`), as `renderReadBasis`.
385
+ *
386
+ * THE SAME-RUN RULE. Behind a pass-through node (Camera Switch) the render reads
387
+ * that node's output, which is the plan's current value only when the node ran
388
+ * in the same run as the render; a SAVED output can come from an older plan.
389
+ * So the basis is stamped only when every pass-through node on the path is in
390
+ * `ranIds`, the nodes executed in the render's run, and is `undefined`
391
+ * otherwise — the take then reads as unknown (stale), never as current. A
392
+ * render wired straight to the plan (through teleports at most) reads the
393
+ * plan's output itself and is always stamped.
394
+ */
395
+ declare function renderPlanBasis(renderId: string, nodes: readonly RenderGraphNode[], edges: readonly RenderGraphEdge[], planOutput: (planNode: RenderGraphNode) => unknown, row: number | undefined, ranIds: ReadonlySet<string>): string | undefined;
396
+
397
+ /** Where a render's player maps the output clock back to the master clock
398
+ * from: the EDL it was given (`input_data.edl`), or the EDL it emitted on its
399
+ * `json` output (a render that rewrites its EDL, e.g. by splitting turns). */
400
+ type RenderClockSource = "input" | "output-json";
401
+ /** What a render's `json` output handle carries. Only a `transcript` is handed
402
+ * on as one (Add Captions, the word-timing preflight). */
403
+ type RenderJsonKind = "transcript" | "edl";
404
+ /** Where a render's wired transcript, remapped through its cut, comes out
405
+ * (Apply EDL's on its `json`; Speaker View's on its own `transcript` pip,
406
+ * decided 2026-10-08). */
407
+ interface RenderTranscriptOutput {
408
+ /** The output pip — also the key it rides on the job's `output_data` and on
409
+ * a run's node output. */
410
+ readonly handle: string;
411
+ /** The saved node-data field that holds it (the landed take's). */
412
+ readonly dataField: string;
413
+ }
414
+ /** The pip a render's `json` output (its `jsonKind`) comes out on, and its key
415
+ * on the job's `output_data`. */
416
+ declare const RENDER_JSON_HANDLE = "json";
417
+ interface RenderNodeDescriptor {
418
+ /** The medium the render's order asks for (its node data, or its job's
419
+ * `input_data`) — before any output exists to say. */
420
+ readonly mediumOf: (data: Readonly<Record<string, unknown>>) => RenderMedium;
421
+ /** The credit id a render reserves on — a per-OUTPUT-MINUTE row: every
422
+ * render is charged its row × the minutes it renders. Chosen from the
423
+ * render's `quality` and `output` (as its node data or its job's request
424
+ * carries them) and, for a render priced in tiers, the `priceTier` the
425
+ * render rule judged it to be in (Speaker View's, decided 2026-10-10). A
426
+ * tiered render given no tier names its dearer row. */
427
+ readonly creditId: (quality: unknown, output?: unknown, priceTier?: unknown) => string;
428
+ /** Every id `creditId` can name (each must have a price row). */
429
+ readonly creditIds: readonly string[];
430
+ readonly clockMapFrom: RenderClockSource;
431
+ /** Listed in its owner's own views only, never in a public one (decided
432
+ * 2026-10-06): a Preview is private, and a public final would be exposure
433
+ * nobody decided. */
434
+ readonly ownerOnlyListing: boolean;
435
+ /** An `each` wire reads its LATEST batch only, never its accumulated history
436
+ * (TA6, decided 2026-10-04). */
437
+ readonly latestBatch: boolean;
438
+ readonly jsonKind: RenderJsonKind;
439
+ /** Where its remapped transcript comes out. On the `json` pip exactly when
440
+ * `jsonKind` is `transcript` (a guard test holds the two together). */
441
+ readonly transcriptOutput: RenderTranscriptOutput;
442
+ }
443
+ declare const RENDER_NODE_TYPES: Readonly<Record<string, RenderNodeDescriptor>>;
444
+ /** Every render node type, in registry order. */
445
+ declare const RENDER_NODE_TYPE_IDS: readonly string[];
446
+ /** The descriptor of a render node type (or job name); `undefined` for any
447
+ * other value. Own keys only, so `"constructor"` is not a render. */
448
+ declare function renderNodeOf(type: unknown): RenderNodeDescriptor | undefined;
449
+ /** Is this node type (or job name) a render? */
450
+ declare function isRenderNodeType(type: unknown): type is string;
451
+ /** Does an `each` wire from this node read its latest batch only? */
452
+ declare function rendersLatestBatch(type: unknown): boolean;
453
+ /** Is this node a render whose `json` output is a Transcript? */
454
+ declare function rendersTranscriptJson(type: unknown): boolean;
455
+ /** Where a render's remapped transcript comes out; `undefined` for any other
456
+ * node type. */
457
+ declare function renderTranscriptOutputOf(type: unknown): RenderTranscriptOutput | undefined;
458
+ /** Is `handle` one of a render's data pips — its `json` or its transcript —
459
+ * rather than its media? Every other pip of a render (the default included)
460
+ * is the rendered media. `false` for any other node type. */
461
+ declare function isRenderDataHandle(type: unknown, handle: unknown): boolean;
462
+ /** One json output a render lands on its node: its key on the job's
463
+ * `output_data` (and on a run's node output) and its saved node-data field. */
464
+ interface RenderSavedJsonOutput {
465
+ readonly outputKey: string;
466
+ readonly dataField: string;
467
+ }
468
+ /** The json outputs a render lands on its node, `json` first, each once — what
469
+ * every lane that lands a take (or picks one) writes or restores. Empty for
470
+ * any other node type. */
471
+ declare function renderSavedJsonOutputs(type: unknown): readonly RenderSavedJsonOutput[];
472
+ /** The render job types that list in their owner's own views only. */
473
+ declare const OWNER_ONLY_LISTING_RENDER_TYPES: readonly string[];
474
+
475
+ /**
476
+ * What a JSON pip CARRIES — the handle typing behind "an EDL is not a
477
+ * transcript" (decided 2026-10-07) and its reverse, "a transcript is not an
478
+ * EDL" (decided 2026-10-08).
479
+ *
480
+ * Every JSON output colours the same "look" data pip, so a validator that sees
481
+ * only the source NODE type cannot tell Edit Plan's edit list from a
482
+ * Transcribe's transcript. Wired into Add Captions' Transcript input, the edit
483
+ * list is accepted at connect time and only fails (or captions nothing) at run
484
+ * time. This module is the one place that knows the difference, read by the
485
+ * canvas validators and the server's edge normalization alike (MCP workflow
486
+ * writes, the REST delta lane, the Copilot).
487
+ *
488
+ * Output kinds are DATA, never a list of node names:
489
+ * - a render node's `json` pip answers its registry `jsonKind`
490
+ * (`RENDER_NODE_TYPES`), so a render registered later — Speaker View, whose
491
+ * json is an EDL — is covered by its own registry entry; its transcript pip
492
+ * (`transcriptOutput`, Speaker View's `transcript`) is a Transcript;
493
+ * - the other JSON producers declare a kind per output pip in
494
+ * `JSON_OUTPUT_KINDS` below. EVERY node with a JSON output declares one
495
+ * (decided 2026-10-08): `transcript`, `edl`, or `other` for JSON that is
496
+ * neither (a scrape, an analysis, a collection). `other` is a positive
497
+ * statement, not a gap — it connects exactly as an undeclared pip always
498
+ * has. A guard test enumerates the node definitions' JSON pips and fails
499
+ * on one with no declaration, so a new JSON node cannot ship unclassified
500
+ * and a Transcript producer cannot slip past the EDL/Transcript block.
501
+ * Input kinds follow the platform's handle vocabulary: a `transcript` pip
502
+ * expects a Transcript, an `edl` pip an EDL.
503
+ */
504
+
505
+ /** The two JSON shapes the platform's handle vocabulary tells apart. */
506
+ type JsonKind = "transcript" | "edl";
507
+ /**
508
+ * What a JSON output pip DECLARES: one of the two kinds, or `other` — JSON that
509
+ * is neither a Transcript nor an EDL. Only `JsonKind` ever takes part in a
510
+ * connection check; `other` records that the pip was classified.
511
+ */
512
+ type JsonOutputDeclaration = JsonKind | "other";
513
+ /**
514
+ * What the JSON output `sourceHandle` of a node of `nodeType` DECLARES —
515
+ * `transcript`, `edl`, `other` — or `undefined` when the pip is not declared at
516
+ * all (a non-JSON pip, an unknown handle, an unregistered node). `renders` is
517
+ * the render-node registry (injectable for tests). The guard test reads this to
518
+ * prove every JSON pip is classified.
519
+ */
520
+ declare function declaredJsonOutput(nodeType: string | null | undefined, sourceHandle: string | null | undefined, renders?: Readonly<Record<string, RenderNodeDescriptor>>): JsonOutputDeclaration | undefined;
521
+ /** The declared JSON output pips of the non-render nodes, as `[nodeType, pipId, declaration]` rows. */
522
+ declare function declaredJsonOutputRows(): ReadonlyArray<readonly [string, string, JsonOutputDeclaration]>;
523
+ /**
524
+ * What the JSON output `sourceHandle` of a node of `nodeType` carries, or
525
+ * `undefined` when it is not known to carry one of the two kinds (anything
526
+ * declared `other`, a non-JSON pip, anything unregistered).
527
+ */
528
+ declare function jsonOutputKind(nodeType: string | null | undefined, sourceHandle: string | null | undefined, renders?: Readonly<Record<string, RenderNodeDescriptor>>): JsonKind | undefined;
529
+ /** What the JSON input `targetHandle` of a node expects, or `undefined`. */
530
+ declare function jsonInputKind(_nodeType: string | null | undefined, targetHandle: string | null | undefined): JsonKind | undefined;
531
+ interface JsonKindMismatch {
532
+ readonly output: JsonKind;
533
+ readonly input: JsonKind;
534
+ }
535
+ /**
536
+ * The connections this blocks: a JSON output of one kind wired into an input of
537
+ * the other (decided 2026-10-07 / 2026-10-08) — an EDL into a Transcript input
538
+ * and a Transcript into an EDL input. Both directions read the same two
539
+ * tables. `null` for every other pair — including pairs it cannot classify,
540
+ * which keep today's behaviour.
541
+ */
542
+ declare function jsonKindMismatch(sourceType: string | null | undefined, sourceHandle: string | null | undefined, targetType: string | null | undefined, targetHandle: string | null | undefined, renders?: Readonly<Record<string, RenderNodeDescriptor>>): JsonKindMismatch | null;
543
+ /** The sentence a rejected connection is explained with. */
544
+ declare function jsonKindMismatchMessage(mismatch: JsonKindMismatch, labels?: {
545
+ readonly sourceLabel?: string;
546
+ readonly targetLabel?: string;
547
+ }): string;
548
+
549
+ /** Render nodes a run can stop at: every render in the registry (SV18). */
550
+ declare const PREVIEW_RENDER_NODE_TYPES: ReadonlySet<string>;
551
+ /**
552
+ * Use-case nodes whose review-on run ends at a Preview of their own: what
553
+ * follows them waits for their Render final, exactly as after a render at
554
+ * Preview. They are not render nodes (`PREVIEW_RENDER_NODE_TYPES` stays the
555
+ * renders), so they join the hold here.
556
+ */
557
+ declare const REVIEW_HOLDING_USE_CASE_TYPES: ReadonlySet<string>;
558
+ /** A node whose take can be a Preview that holds what follows it. */
559
+ declare function isPreviewHoldingType(type: string | null | undefined): boolean;
560
+ /**
561
+ * Stable refusal code: a run with nobody to review it (a trigger, an API or
562
+ * MCP call, a present link, an app run) holds a Preview render. Set the
563
+ * render to Final, or run with a Final override on it.
564
+ */
565
+ declare const PREVIEW_REVIEW_REQUIRED = "preview_review_required";
566
+ /**
567
+ * Stable refusal code: a sub-workflow or a component holds a Preview render.
568
+ * A nested graph has no Render final path, so this refusal is permanent.
569
+ */
570
+ declare const PREVIEW_RENDER_NESTED = "preview_render_nested";
571
+ /**
572
+ * The same two refusals when what holds the run is not (only) a render: a
573
+ * use-case node with "Review before render" on. `…_REVIEW_ON`: only such
574
+ * nodes hold it (turn their review off); `…_MIXED`: renders at Preview and
575
+ * such nodes both do. The two codes above stay what a render-held refusal
576
+ * (and every older one) carries. Branch on {@link isPreviewRefusalCode}, never
577
+ * on one code: all six mean "this run stops for a review nobody can give".
578
+ */
579
+ declare const PREVIEW_REVIEW_REQUIRED_REVIEW_ON = "preview_review_required_review_on";
580
+ declare const PREVIEW_REVIEW_REQUIRED_MIXED = "preview_review_required_mixed";
581
+ declare const PREVIEW_RENDER_NESTED_REVIEW_ON = "preview_render_nested_review_on";
582
+ declare const PREVIEW_RENDER_NESTED_MIXED = "preview_render_nested_mixed";
583
+ /** Is `code` a preview refusal — a run that stops for a review nobody can give (any of the six codes)? */
584
+ declare function isPreviewRefusalCode(code: unknown): boolean;
585
+ /** A node as the stop rule reads it (either engine's graph, or a saved one). */
586
+ interface PreviewGateNode {
587
+ readonly id: string;
588
+ readonly type?: string | null;
589
+ readonly data?: unknown;
590
+ readonly parentId?: string | null;
591
+ }
592
+ /** A wire as the stop rule reads it. `data.outputMode` is the wire's mode. */
593
+ interface PreviewGateEdge {
594
+ readonly source: string;
595
+ readonly target: string;
596
+ readonly sourceHandle?: string | null;
597
+ readonly targetHandle?: string | null;
598
+ readonly data?: unknown;
599
+ }
600
+ /** What a saved render result says about itself: `"proxy"` is a Preview. */
601
+ interface SavedRenderQualityStamp {
602
+ readonly quality?: string;
603
+ }
604
+ /**
605
+ * How the rule reads a saved render: the result a scalar wire receives
606
+ * (`output`) and the rows an `each` wire iterates (`batch`, the LATEST batch
607
+ * only — `undefined` when the render has none, and the wire then reads the one
608
+ * result). The saved-output reader both engines use plugs in here.
609
+ */
610
+ interface SavedRenderStampReader {
611
+ output(data: Readonly<Record<string, unknown>>): SavedRenderQualityStamp | undefined;
612
+ batch(data: Readonly<Record<string, unknown>>): ReadonlyArray<SavedRenderQualityStamp | null> | undefined;
613
+ }
614
+ /** A reader that sees no stamps: every saved render reads as unstamped. */
615
+ declare const NO_SAVED_RENDER_STAMPS: SavedRenderStampReader;
616
+ /**
617
+ * The production reader. No render result carries a `quality` stamp until the
618
+ * results themselves are stamped, so today it reads none and the saved-preview
619
+ * half of the rule is inert; the stamped-result reader replaces it here, the
620
+ * one place every caller takes it from.
621
+ */
622
+ declare const SAVED_RENDER_STAMPS: SavedRenderStampReader;
623
+ /** One run's view: which nodes execute, and how saved renders are read. */
624
+ interface PreviewGateRun {
625
+ /** Does this node execute in this run? Default: every node that is not frozen (`data.skipped`). */
626
+ readonly executes?: (nodeId: string) => boolean;
627
+ /** Default: `SAVED_RENDER_STAMPS`. */
628
+ readonly savedRenders?: SavedRenderStampReader;
629
+ }
630
+ interface PreviewStops {
631
+ /** Render nodes that execute in this run at Preview quality (and review-on use-case nodes). */
632
+ readonly previewRenderIds: readonly string[];
633
+ /** Render nodes outside the run whose saved output hands a Preview on (and
634
+ * review-on use-case nodes whose saved take is a Preview, stamped `proxy`). */
635
+ readonly savedPreviewRenderIds: readonly string[];
636
+ /** Every node that would consume a preview: never executed in this run. */
637
+ readonly gatedNodeIds: ReadonlySet<string>;
638
+ }
639
+ /**
640
+ * A node that renders a Preview in this run: a render node whose quality
641
+ * (after any run overrides) is `proxy`, or a use-case node with review on
642
+ * that does not run as its own Render final — the continuation a Render final
643
+ * sets on it for that run only (`useCaseContinue`, render-final, naming the
644
+ * run it finishes), which renders the final and releases what follows.
645
+ */
646
+ declare function rendersAsPreview(node: PreviewGateNode): boolean;
647
+ /** The stop rule: where this run stops, and everything it does not run. */
648
+ declare function previewStops(nodes: readonly PreviewGateNode[], edges: readonly PreviewGateEdge[], run?: PreviewGateRun): PreviewStops;
649
+ /** The nodes this run does not execute because they would consume a preview. */
650
+ declare function previewGatedNodeIds(nodes: readonly PreviewGateNode[], edges: readonly PreviewGateEdge[], run?: PreviewGateRun): Set<string>;
651
+ /** Does this run hold anything a reviewer would have to review: a Preview
652
+ * render it executes, or a saved Preview it hands on? */
653
+ declare function holdsPreviewRender(nodes: readonly PreviewGateNode[], edges: readonly PreviewGateEdge[], run?: PreviewGateRun): boolean;
654
+ /**
655
+ * The fields a run's input override clears from the node it overrides, so a
656
+ * fresh input wins over a cached result. The server's merge and
657
+ * `withRunOverrides` both clear exactly these.
658
+ */
659
+ declare const RUN_OVERRIDE_CLEARED_FIELDS: readonly ["generatedResults", "activeResultIndex", "generatedImageUrl", "generatedVideoUrl", "generatedAudioUrl", "generatedText"];
660
+ /**
661
+ * Node fields set for ONE run only, by that run's input override: a use-case
662
+ * node's continuation of an earlier run (`useCaseContinue` — a Render final, a
663
+ * Continue). Never saved (`TRANSIENT_RUNTIME_KEYS`); one found on a saved graph
664
+ * is stale, and every reader ignores it — the server's engine drops it before
665
+ * its override merge, and `withRunOverrides` before its own.
666
+ */
667
+ declare const RUN_ONLY_NODE_FIELDS: readonly ["useCaseContinue"];
668
+ /**
669
+ * The graph a run executes once its input overrides (`{ [nodeId]: fields }`)
670
+ * are merged: the same merge as the server's — a node's saved run-only fields
671
+ * (`RUN_ONLY_NODE_FIELDS`) dropped first, so only THIS run's override can set
672
+ * one; then the shallow merge, clearing the overridden node's saved results.
673
+ * Never mutates; a node with no override and no saved run-only field is
674
+ * returned as is. Render final is a run with `{ [renderId]: { quality: "final" } }`.
675
+ *
676
+ * Apply it ONCE, to the saved graph: on a graph it already produced it would
677
+ * drop the continuation that run's override set. With no overrides it is the
678
+ * saved graph as a plain run reads it.
679
+ */
680
+ declare function withRunOverrides<N extends PreviewGateNode>(nodes: readonly N[], overrides: Readonly<Record<string, Readonly<Record<string, unknown>>>> | undefined): N[];
681
+
682
+ /**
683
+ * A run CONTINUED from an earlier execution (`continueFromExecutionId` on
684
+ * `POST /v1/workflows/:id/run`): the nodes it does not run hand on what that
685
+ * execution produced, never the workflow's saved results. Render final after a
686
+ * run that stopped at a preview is one, and an app's Render final runs as one,
687
+ * outside the app run.
688
+ *
689
+ * The stable codes a continuation is refused with. A client branches on the
690
+ * code, never on the text.
691
+ */
692
+ /** The execution does not exist, or the caller did not start it. */
693
+ declare const CONTINUATION_NOT_FOUND = "continuation_not_found";
694
+ /** The execution ran another workflow. */
695
+ declare const CONTINUATION_WORKFLOW_MISMATCH = "continuation_workflow_mismatch";
696
+ /** The execution ran another version of the graph: a published app version
697
+ * where this run uses the live workflow, or the reverse, or another version. */
698
+ declare const CONTINUATION_VERSION_MISMATCH = "continuation_version_mismatch";
699
+ /** The execution has not ended `completed` (it is still running, or it
700
+ * failed or was cancelled). */
701
+ declare const CONTINUATION_NOT_COMPLETED = "continuation_not_completed";
702
+ /** A continuation names the nodes it runs (`nodeIds`); every other node hands
703
+ * on the execution's output. */
704
+ declare const CONTINUATION_SUBSET_REQUIRED = "continuation_subset_required";
705
+ /** A continue-from-failed run (use-case nodes) needs an execution that ended
706
+ * `failed`: a completed run has nothing to resume, a running one is not over. */
707
+ declare const CONTINUATION_NOT_FAILED = "continuation_not_failed";
708
+ /** A continue-from-failed (use-case nodes) of a run a later continuation of
709
+ * it has superseded — that later one failed too: continue it instead. */
710
+ declare const CONTINUATION_SUPERSEDED = "continuation_superseded";
711
+ /** A continue-from-failed (use-case nodes) of a failed run whose wrapper is not
712
+ * settled yet (its fee not yet refunded): ask again in a moment. A retry
713
+ * answer, not a refusal — outside `RUN_CONTINUATION_CODES`. */
714
+ declare const CONTINUATION_SETTLING = "continuation_settling";
715
+ /** A Render final (use-case nodes) of a preview with the very edit a COMPLETED
716
+ * final of it already rendered (decided 2026-10-13): nothing would change, so
717
+ * nothing runs — the answer names that final. A changed edit renders again. */
718
+ declare const RENDER_FINAL_ALREADY_RENDERED = "render_final_already_rendered";
719
+ declare const RENDER_FINAL_ALREADY_RENDERED_MESSAGE = "Already rendered with this edit.";
720
+ /** Every continuation refusal code. */
721
+ declare const RUN_CONTINUATION_CODES: readonly ["continuation_not_found", "continuation_workflow_mismatch", "continuation_version_mismatch", "continuation_not_completed", "continuation_subset_required", "continuation_not_failed", "continuation_superseded"];
722
+ type RunContinuationCode = (typeof RUN_CONTINUATION_CODES)[number];
723
+
724
+ /**
725
+ * Render final for agents (`renderFinal: { renderNodeId }` on
726
+ * `POST /v1/workflows/:id/run`, the SDK's `workflows.renderFinal`, MCP
727
+ * `render_final`; decided 2026-10-06). The server derives the nodes the run
728
+ * executes and the render's one-shot Final override from the saved graph.
729
+ *
730
+ * The stable codes a Render final request is refused with when the node it
731
+ * names cannot be rendered. A client branches on the code, never on the text.
732
+ */
733
+ /** The workflow has no node with that id. */
734
+ declare const RENDER_FINAL_NODE_NOT_FOUND = "render_final_node_not_found";
735
+ /** The node is not a render a Render final can run (an Apply EDL render). */
736
+ declare const RENDER_FINAL_NOT_A_RENDER = "render_final_not_a_render";
737
+ /** Every Render final refusal code. */
738
+ declare const RENDER_FINAL_CODES: readonly ["render_final_node_not_found", "render_final_not_a_render"];
739
+ type RenderFinalCode = (typeof RENDER_FINAL_CODES)[number];
740
+
741
+ /**
742
+ * Collections — where a workflow's records live (decided 2026-10-05).
743
+ *
744
+ * A collection belongs to one person and holds records: a title, a text, a
745
+ * link, the links of its pictures / videos / sounds, a small bag of extra
746
+ * fields and where the record came from. Text and links only — never files;
747
+ * a media link from a platform expires on its own schedule, so a consumer
748
+ * that needs the picture later copies it (an upload node), the collection
749
+ * keeps the link as given.
750
+ *
751
+ * Why public: `Collection` / `CollectionRecord` are what `/v1/collections`
752
+ * returns and the SDK's `collections` resource types; the caps are what the
753
+ * page and the API quote; the digest and the ingest map are the ONE rule the
754
+ * read node, MCP and the CLI render records with.
755
+ */
756
+ declare const COLLECTION_NAME_MAX = 80;
757
+ declare const COLLECTION_DESCRIPTION_MAX = 500;
758
+ declare const COLLECTION_RECORD_TITLE_MAX = 500;
759
+ declare const COLLECTION_RECORD_TEXT_MAX = 20000;
760
+ declare const COLLECTION_RECORD_URL_MAX = 2000;
761
+ declare const COLLECTION_RECORD_MEDIA_MAX = 20;
762
+ declare const COLLECTION_RECORD_FIELDS_MAX = 50;
763
+ declare const COLLECTION_RECORD_FIELDS_BYTES_MAX: number;
764
+ declare const COLLECTION_DEDUPE_KEY_MAX = 300;
765
+ declare const COLLECTION_IDEMPOTENCY_KEY_MAX = 200;
766
+ /** Records per page of `GET /v1/collections/:id/records`. */
767
+ declare const COLLECTIONS_PAGE_MAX = 100;
768
+ declare const COLLECTIONS_PAGE_DEFAULT = 50;
769
+ /** The longest a headline (a record's one-line name) gets. */
770
+ declare const COLLECTION_HEADLINE_MAX = 120;
771
+ declare const COLLECTION_MEDIA_TYPES: readonly ["image", "video", "audio", "link"];
772
+ type CollectionMediaType = (typeof COLLECTION_MEDIA_TYPES)[number];
773
+ interface CollectionMedia {
774
+ readonly type: CollectionMediaType;
775
+ /** The file's link, as given (never fetched, never copied). */
776
+ readonly url: string;
777
+ /** A video's poster frame, when known. */
778
+ readonly posterUrl?: string;
779
+ }
780
+ /** How many collections a person may have, and how many records each may hold. */
781
+ interface CollectionCaps {
782
+ readonly collections: number;
783
+ readonly records: number;
784
+ }
785
+ /**
786
+ * Caps by effective tier (decided 2026-10-05: open to free accounts; past the
787
+ * records cap the OLDEST records are evicted, never the write refused — a
788
+ * scheduled pipeline must not stall silently). `payg` is a derived tier whose
789
+ * entitlements are basic's; `enterprise` reads as business.
790
+ *
791
+ * A tier this table does not know has NO caps here (`collectionCapsForTier`
792
+ * answers undefined): the API then holds the account to no cap rather than to
793
+ * free's, because the cap is enforced by DELETING records — a new tier or a
794
+ * misspelt one must never cost a paying account its records. Add the tier.
795
+ */
796
+ declare const COLLECTION_TIER_CAPS: Readonly<Record<string, CollectionCaps>>;
797
+ declare function collectionCapsForTier(tier: string | null | undefined): CollectionCaps | undefined;
798
+ interface Collection {
799
+ readonly id: string;
800
+ readonly name: string;
801
+ readonly description: string;
802
+ readonly recordCount: number;
803
+ /** How many of its records have been used (`usedAt` set) and are not in the Trash. On the one-collection read; a server before the usage migration leaves it out. */
804
+ readonly usedCount?: number;
805
+ /** How many of its records are in the Trash. On the one-collection read; a server before the usage migration leaves it out. `recordCount` counts them too (they still count toward the cap). */
806
+ readonly trashCount?: number;
807
+ readonly createdAt: string;
808
+ readonly updatedAt: string;
809
+ }
810
+ /** Where a record came from — a node in a run, or a direct write. The same shape says who USED it. */
811
+ interface CollectionRecordSource {
812
+ readonly via?: "api" | "mcp" | "node" | "ui";
813
+ readonly nodeType?: string;
814
+ readonly workflowId?: string;
815
+ readonly executionId?: string;
816
+ readonly nodeId?: string;
817
+ /** Read-side enrichment: the workflow's name and project, looked up when the records are listed. Ignored on a write. */
818
+ readonly workflowName?: string;
819
+ readonly projectId?: string;
820
+ }
821
+ type CollectionFieldValue = string | number | boolean;
822
+ /** Which records a list or a read returns: every record, the ones not used yet, or the ones used. */
823
+ declare const COLLECTION_USAGES: readonly ["all", "unused", "used"];
824
+ type CollectionUsage = (typeof COLLECTION_USAGES)[number];
825
+ interface CollectionRecord {
826
+ readonly id: string;
827
+ readonly collectionId: string;
828
+ readonly title: string;
829
+ readonly text: string;
830
+ readonly url: string | null;
831
+ readonly media: readonly CollectionMedia[];
832
+ readonly fields: Readonly<Record<string, CollectionFieldValue>>;
833
+ /** The normalized key the collection deduplicates on (defaults to the link); null when the record has none. */
834
+ readonly dedupeKey: string | null;
835
+ readonly source: CollectionRecordSource;
836
+ readonly createdAt: string;
837
+ /** When the record was used (a Save to Collection node with "mark the item as used", the API, the page) — null until then. A server before the usage migration leaves it out. */
838
+ readonly usedAt?: string | null;
839
+ /** Who used it, in the shape of `source`; empty until then. */
840
+ readonly usedBy?: CollectionRecordSource;
841
+ /** When the record was moved to the Trash (a delete on the page, the API or the CLI); null while it is live. A server before the usage migration leaves it out. */
842
+ readonly deletedAt?: string | null;
843
+ }
844
+ /** Which records a list returns: the live ones (`active`, the default) or the ones in the Trash. Nodes, exports and MCP read the live ones only. */
845
+ declare const COLLECTION_RECORD_STATUSES: readonly ["active", "trash"];
846
+ type CollectionRecordStatus = (typeof COLLECTION_RECORD_STATUSES)[number];
847
+ /** The most records one bulk call (`POST /v1/collections/:id/records/bulk`) touches. */
848
+ declare const COLLECTION_BULK_MAX = 100;
849
+ /** The actions of a bulk call: move the records to the Trash, bring them back, or delete records already in the Trash for good. */
850
+ declare const COLLECTION_BULK_ACTIONS: readonly ["trash", "restore", "delete"];
851
+ type CollectionBulkAction = (typeof COLLECTION_BULK_ACTIONS)[number];
852
+ /** The most records a numbered page may skip (`offset`) — past any page a person turns to, within the largest cap. */
853
+ declare const COLLECTION_RECORDS_OFFSET_MAX = 1000000;
854
+ /** The body of `POST /v1/collections/:id/records/bulk`. */
855
+ type BulkCollectionRecordsInput = {
856
+ readonly ids: readonly string[];
857
+ readonly action: CollectionBulkAction;
858
+ };
859
+ interface BulkCollectionRecordsResult {
860
+ /** How many of the ids were the caller's records in that collection and changed (a record already in the asked state is not counted). */
861
+ readonly updated: number;
862
+ }
863
+ /** The caller's limits as the API quotes them: `null` is "no limit" (a
864
+ * self-hosted server with no ceiling configured, or a tier the caps table
865
+ * does not know). */
866
+ interface CollectionLimits {
867
+ readonly collections: number | null;
868
+ readonly records: number | null;
869
+ }
870
+ /** The answer of `GET /v1/collections`. `available` is false on a server whose
871
+ * database does not have collections yet (the data is then empty). */
872
+ interface ListCollectionsResult {
873
+ readonly data: readonly Collection[];
874
+ readonly available: boolean;
875
+ /** The caller's limits, so a client never carries its own copy of the tier table. */
876
+ readonly caps: CollectionLimits;
877
+ }
878
+ type CreateCollectionInput = {
879
+ readonly name: string;
880
+ readonly description?: string;
881
+ };
882
+ type UpdateCollectionInput = {
883
+ readonly name?: string;
884
+ readonly description?: string;
885
+ };
886
+ /** Query of `GET /v1/collections/:id/records`. */
887
+ type ListCollectionRecordsParams = {
888
+ /** Words to find in the title, the text or the link. */
889
+ readonly q?: string;
890
+ /** Only records saved at or after this ISO timestamp (date and time). */
891
+ readonly since?: string;
892
+ /** Only records saved before this ISO timestamp (date and time). */
893
+ readonly until?: string;
894
+ /** `all` (default), `unused` (not used yet) or `used`. */
895
+ readonly usage?: CollectionUsage;
896
+ /** `newest` (default) or `oldest` first. */
897
+ readonly order?: "newest" | "oldest";
898
+ /** `active` (default: the live records) or `trash`. */
899
+ readonly status?: CollectionRecordStatus;
900
+ /** The `nextCursor` of the previous page. Not together with `offset`. */
901
+ readonly cursor?: string;
902
+ /** Skip this many records first (0–`COLLECTION_RECORDS_OFFSET_MAX`; a numbered page is `offset = (page - 1) × limit`). Not together with `cursor`; the result then carries `total`. */
903
+ readonly offset?: number;
904
+ /** 1–100, default 50. */
905
+ readonly limit?: number;
906
+ };
907
+ /** The body of `PATCH /v1/collections/:id/records/:recordId`: mark a record used (or not used again). */
908
+ type SetCollectionRecordUsedInput = {
909
+ readonly used: boolean;
910
+ /** Who is marking it; the API fills `via` when absent. */
911
+ readonly source?: CollectionRecordSource;
912
+ };
913
+ interface ListCollectionRecordsResult {
914
+ readonly data: readonly CollectionRecord[];
915
+ readonly nextCursor: string | null;
916
+ /** How many records match the filters in all (a numbered page is `ceil(total / limit)` pages). Only on a page asked for by `offset`, and left out when the server could not count. */
917
+ readonly total?: number;
918
+ }
919
+ /** The body of `POST /v1/collections/:id/records`. An explicit field wins over
920
+ * what `item` (any JSON — a feed post, a search result, an LLM's object) maps to. */
921
+ type AddCollectionRecordInput = {
922
+ readonly title?: string;
923
+ readonly text?: string;
924
+ readonly url?: string;
925
+ readonly media?: readonly CollectionMedia[];
926
+ readonly fields?: Readonly<Record<string, CollectionFieldValue>>;
927
+ readonly dedupeKey?: string;
928
+ readonly source?: CollectionRecordSource;
929
+ readonly item?: unknown;
930
+ };
931
+ type CollectionWriteOutcome = "inserted" | "duplicate" | "replayed";
932
+ interface AddCollectionRecordResult {
933
+ readonly record: CollectionRecord;
934
+ readonly outcome: CollectionWriteOutcome;
935
+ /** Records evicted past the collection's cap by this write. */
936
+ readonly evicted: number;
937
+ }
938
+ type CollectionExportFormat = "csv" | "json";
939
+ type CollectionDigestFormat = "headlines" | "full";
940
+ declare const COLLECTION_DIGEST_SEPARATOR = "\n\n---\n\n";
941
+ /** The Read Collection node: how far back it may look (720 hours = 30 days; `days` × 24 is held to the same ceiling) and how many records one run emits. */
942
+ declare const COLLECTION_READ_WINDOW_HOURS_MAX = 720;
943
+ declare const COLLECTION_READ_LIMIT_MAX = 200;
944
+ type CollectionReadWindowUnit = "hours" | "days";
945
+ type CollectionReadOrder = "newest" | "oldest";
946
+ /** The start of a Read Collection window, as an ISO timestamp — `amount` × `unit` back from `now`, held to the ceiling. */
947
+ declare function collectionReadSince(amount: number, unit: CollectionReadWindowUnit, now?: number): string;
948
+ /** A link a record may hold: `http(s)`, no whitespace, at most 2,000 characters. */
949
+ declare function isCollectionUrl(v: unknown): v is string;
950
+ /**
951
+ * The first `max` characters of a text, counted as Postgres counts them
952
+ * (`char_length`: code points), so a cut never splits a surrogate pair into a
953
+ * lone half the database refuses.
954
+ */
955
+ declare function clampChars(text: string, max: number): string;
956
+ /**
957
+ * A Save to Collection field held to the record route's limit — the ONE rule
958
+ * both engines apply to a field whose `{Node}` references resolved to more
959
+ * than was typed: a title, text or duplicate key is cut to whole characters
960
+ * (as the store cuts an item's), and a link over the limit is not sent at all
961
+ * (a cut link is a wrong link; the item's own link then wins).
962
+ */
963
+ declare function fitCollectionField(key: "title" | "text" | "link" | "dedupeKey", value: string): string | undefined;
964
+ /**
965
+ * The key a collection deduplicates on: trimmed, inner whitespace collapsed,
966
+ * lower-cased, at most 300 characters; null when there is nothing to key on.
967
+ */
968
+ declare function normalizeDedupeKey(raw: unknown): string | null;
969
+ /**
970
+ * How many records one write may evict past the cap. A cap that drops at once
971
+ * (a lapsed subscription, billing briefly reading "free") then trims a big
972
+ * collection a little per write instead of deleting most of it in one go.
973
+ */
974
+ declare const COLLECTION_EVICT_MAX_PER_WRITE = 100;
975
+ declare function isCollectionMedia(v: unknown): v is CollectionMedia;
976
+ /** The media list as stored: known kinds with http(s) links, no repeats, at most 20. */
977
+ declare function normalizeCollectionMedia(value: unknown): CollectionMedia[];
978
+ /** The extra fields as stored: scalar values only, at most 50 keys and 16 KB. */
979
+ declare function normalizeCollectionFields(value: unknown): Record<string, CollectionFieldValue>;
980
+ /**
981
+ * A record's one-line name: its title, else the first line of its text, else
982
+ * its link. Tolerates a partial record (a hand-written node result in workflow
983
+ * JSON): a missing field reads as empty rather than throwing on the canvas.
984
+ */
985
+ declare function collectionRecordHeadline(record: Partial<Pick<CollectionRecord, "title" | "text" | "url">>): string;
986
+ /**
987
+ * ONE digest for a collection's records — what the Read Collection node's
988
+ * `text` handle, MCP `read_collection` and the CLI print. `headlines`: one line
989
+ * per record (headline · date · link); `full`: the whole text of each record
990
+ * under its headline, separated by a rule.
991
+ */
992
+ declare function collectionRecordsDigest(records: ReadonlyArray<Partial<Pick<CollectionRecord, "title" | "text" | "url" | "createdAt">> | null | undefined>, format?: CollectionDigestFormat): string;
993
+ /** What `ingestRecordFromJson` reads out of an item: the record's fields, before explicit overrides. */
994
+ interface IngestedRecord {
995
+ readonly title: string;
996
+ readonly text: string;
997
+ readonly url: string | null;
998
+ readonly media: CollectionMedia[];
999
+ readonly fields: Record<string, CollectionFieldValue>;
1000
+ readonly dedupeKey: string | null;
1001
+ }
1002
+ /**
1003
+ * A record read out of any JSON item — a Telegram post, a Social Search
1004
+ * result, an LLM's object, a plain string. Title ← title / headline / name;
1005
+ * text ← text / body / caption / description; link ← the first of url /
1006
+ * postUrl / link that IS an http(s) link; media ← `media[]` and the image /
1007
+ * video / audio link keys; the dedupe key ← the link, else slug / id / postId;
1008
+ * every other scalar lands in `fields` (a nested object's `name`, such as a
1009
+ * forwarded-from, lands as that name). One pass over the item: its size is
1010
+ * the caller's body limit, never a loop of its own.
1011
+ */
1012
+ declare function ingestRecordFromJson(item: unknown): IngestedRecord;
1013
+
1014
+ /**
1015
+ * When a public video node outputs its input unchanged — no job, no charge —
1016
+ * because there is nothing for it to do (spec R14). One rule for both engines:
1017
+ * the orchestrator asks before any reservation, the canvas block before its API
1018
+ * call. The API routes keep their limits (Combine Videos still needs two URLs;
1019
+ * an empty overlay request is still `no_layers`).
1020
+ */
1021
+ type PassThroughWarning = "no_layers" | "no_captions" | "single_input";
1022
+ interface PassThrough {
1023
+ readonly videoUrl: string;
1024
+ readonly warning: PassThroughWarning;
1025
+ }
1026
+ /** Exactly one resolved video → that video, unchanged. */
1027
+ declare function combineVideosPassThrough(videoUrls: ReadonlyArray<string | null | undefined>): PassThrough | null;
1028
+ /** A wired layer plan that resolved to nothing, with no handle layer either → the base video. */
1029
+ declare function videoOverlayPassThrough(input: {
1030
+ readonly videoUrl: string | null | undefined;
1031
+ readonly planWired: boolean;
1032
+ readonly layerCount: number;
1033
+ }): PassThrough | null;
1034
+ /** A wired caption plan whose styling produced no segment → the input video. */
1035
+ declare function captionPlanPassThrough(input: {
1036
+ readonly videoUrl: string | null | undefined;
1037
+ readonly planWired: boolean;
1038
+ readonly segmentCount: number;
1039
+ }): PassThrough | null;
1040
+
1041
+ /**
1042
+ * Pre-run checks for the transcribe → captions chain.
1043
+ *
1044
+ * A transcription lane that cannot return per-word timings (`whisper`) still
1045
+ * RUNS and BILLS — it just hands back phrase segments with `words: []`. Anything
1046
+ * downstream that needs words then fails AFTER the transcription was paid for.
1047
+ * These helpers let every run surface (the editor's DAG, the backend
1048
+ * orchestrator, single-node Run) refuse BEFORE any spend, with one message.
1049
+ * Pure: no I/O, no framework types — callers pass plain nodes/edges.
1050
+ */
1051
+ /** The refusal for a lane that can't return word timings; `null` when it can.
1052
+ * An absent provider resolves to the transcribe NODE default. */
1053
+ declare function transcribeWordTimestampsRefusal(provider: string | null | undefined): string | null;
1054
+ interface PreflightGraphNode {
1055
+ readonly id: string;
1056
+ readonly type?: string | null;
1057
+ readonly data?: Record<string, unknown> | null;
1058
+ }
1059
+ interface PreflightGraphEdge {
1060
+ readonly source: string;
1061
+ readonly target: string;
1062
+ readonly sourceHandle?: string | null;
1063
+ readonly targetHandle?: string | null;
1064
+ }
1065
+ interface WordlessTranscriptFeed {
1066
+ readonly transcribeNodeId: string;
1067
+ /** The add-captions node that would receive a transcript with no words. */
1068
+ readonly consumerNodeId: string;
1069
+ readonly provider: string;
1070
+ readonly message: string;
1071
+ }
1072
+ /**
1073
+ * Every transcribe node on a word-INCAPABLE lane whose `json` output reaches an
1074
+ * add-captions `transcript` input — directly, or through apply-edl, which remaps
1075
+ * the transcript and re-emits it on its own `json` handle (or any render, by
1076
+ * its registry `transcriptOutput`: Speaker View's `transcript`). add-captions rejects a
1077
+ * transcript with no words, so such a run can only fail, after paying for the
1078
+ * transcription. Skipped nodes are ignored on both ends.
1079
+ *
1080
+ * The engine is read from node data and nothing else can change it: `provider`
1081
+ * is not a mappable field on transcribe, so what this check sees IS what runs.
1082
+ * add-captions' own "transcript has no words" guard stays as defence in depth
1083
+ * for a transcript that arrives from anywhere other than a transcribe node.
1084
+ */
1085
+ declare function findWordlessTranscriptFeeds(nodes: readonly PreflightGraphNode[], edges: readonly PreflightGraphEdge[]): WordlessTranscriptFeed[];
1086
+
1087
+ /**
1088
+ * Source node types whose primary output is a video URL.
1089
+ * Mirrors the backend execution-graph VIDEO_SOURCE_TYPES verbatim.
1090
+ */
1091
+ declare const VIDEO_PRODUCER_TYPES: ReadonlySet<string>;
1092
+ /**
1093
+ * Source node types whose output media-type cannot be classified
1094
+ * statically — iterators, dynamic dispatchers, sub-workflow wrappers.
1095
+ * The orchestrator decides their actual output type at execution time
1096
+ * based on what's wired upstream (loop iterates upstream column type;
1097
+ * sub-workflow emits its leaf node's type; adjust-volume passes through
1098
+ * video or audio based on its `lastInputType` runtime field;
1099
+ * voice-changer emits audio in audio mode, video+audio in video mode).
1100
+ *
1101
+ * Typed-handle validators (frontend/src/lib/{generate-image,generate-
1102
+ * video,ffmpeg}-handles.ts) must include these as acceptors on EVERY
1103
+ * media-typed input handle — otherwise the canvas validator hard-
1104
+ * rejects edges that the orchestrator would happily route at runtime.
1105
+ *
1106
+ * Lifted here from `frontend/src/lib/ffmpeg-handles.ts` (where the
1107
+ * escape hatch was first added) so the same set drives ALL handle
1108
+ * validators uniformly. Adding a new dynamic-output node type means
1109
+ * one edit here instead of N across sibling validator files.
1110
+ *
1111
+ * Intentionally OMITTED:
1112
+ * - `webhook-trigger` / `schedule-trigger` — their outputs are
1113
+ * user-defined JSON shapes, not media URLs. Accepting them as
1114
+ * media producers creates false-positive drops at the canvas
1115
+ * that fail at execution. Users wanting trigger → media flows
1116
+ * should wire through an upload node.
1117
+ */
1118
+ declare const DYNAMIC_PRODUCER_TYPES: ReadonlySet<string>;
1119
+ /**
1120
+ * Source node types whose primary output is an audio URL.
1121
+ * Mirrors the backend execution-graph AUDIO_SOURCE_TYPES verbatim.
1122
+ */
1123
+ declare const AUDIO_PRODUCER_TYPES: ReadonlySet<string>;
1124
+ /**
1125
+ * Source node types whose output is an IMAGE URL — what feeds a References
1126
+ * input. ONE set for the canvas validators (`frontend/src/lib/
1127
+ * generate-image-handles.ts` re-exports it), the backend's Generate Image
1128
+ * handle migration and the MCP edge normalizer (`llm-chat`'s legacy `in`):
1129
+ * they used to keep separate copies, and the backend's lagged by eight types.
1130
+ */
1131
+ declare const IMAGE_PRODUCER_TYPES: ReadonlySet<string>;
1132
+ /**
1133
+ * Source node types whose primary output is a LIST that, by default, fans out
1134
+ * one downstream execution per element when an edge leaves them WITHOUT an
1135
+ * explicit `outputMode` (all other edges default to "last"). `selector` is
1136
+ * included because its picked/rest channels are lists too.
1137
+ *
1138
+ * Single source of truth for the fan-out "each" default, consumed by:
1139
+ * - backend/src/services/workflow-engine/input-resolver.ts (DEFAULT_EACH_TYPES)
1140
+ * - frontend/src/components/editor/workflow-editor/types.ts (FAN_OUT_EACH_TYPES)
1141
+ * - frontend/src/components/editor/workflow-editor/node-input-resolver.ts
1142
+ *
1143
+ * These three previously kept independent copies; the backend copy drifted
1144
+ * (missing the four list-transform types), so server-side workflow runs
1145
+ * silently dropped all-but-the-first item for filter-list / deduplicate /
1146
+ * merge-lists / sort-list sources while the canvas fanned out N ways. Lifting
1147
+ * the set here makes that drift impossible.
1148
+ */
1149
+ declare const FAN_OUT_EACH_TYPES: ReadonlySet<string>;
1150
+ /**
1151
+ * Per-HANDLE "each" defaults, for a node whose outputs differ in kind: on the
1152
+ * `each` handles an edge without an explicit `outputMode` defaults to "each",
1153
+ * on its other handles to "last". `primary` is the handle an edge with no
1154
+ * `sourceHandle` reads (agent-written workflow JSON often omits it).
1155
+ *
1156
+ * The list an "each" edge reads is the node's per-iteration results
1157
+ * (`listResults`) — it exists only when the node itself ran once per item, so
1158
+ * after a single run the edge degrades to the single value, exactly like a
1159
+ * `FAN_OUT_EACH_TYPES` member with one item.
1160
+ */
1161
+ declare const FAN_OUT_EACH_HANDLES: Readonly<Record<string, {
1162
+ readonly each: readonly string[];
1163
+ readonly primary: string;
1164
+ }>>;
1165
+ /**
1166
+ * Fan-out nodes whose iterations must ALL succeed: one failed item fails the
1167
+ * node (today's rule tolerates a partial list). UGC Clip — a missing clip
1168
+ * silently drops a beat from the script (spec R17). Already-started items
1169
+ * finish and settle; their jobs are reused on the next run.
1170
+ */
1171
+ declare const FAN_OUT_ALL_OR_NOTHING_TYPES: ReadonlySet<string>;
1172
+ /**
1173
+ * Nodes whose saved list is the list their last run PRODUCED — `__listResults`
1174
+ * (Extract Field's JSON value on `generatedJson`) — and never a history in
1175
+ * `generatedResults`: Extract Field, JSON Process and Site Capture. No run of the first two writes
1176
+ * one; earlier builds' server runs did (the run's text, the links of a list of
1177
+ * links), and both engines' list readers leave it out for these two (decided
1178
+ * 2026-10-05). Single source of truth for the backend engine and the editor.
1179
+ */
1180
+ declare const OWN_LIST_NODE_TYPES: ReadonlySet<string>;
1181
+ /** Whether a node's saved list is its own `__listResults`, never a history. */
1182
+ declare function ownsItsList(nodeType: string | null | undefined): boolean;
1183
+ /** The `outputMode` an edge has when none is set on it — the ONE rule both
1184
+ * engines, the credit estimate and the editor read. */
1185
+ declare function defaultEdgeOutputMode(sourceType: string | null | undefined, sourceHandle: string | null | undefined): "each" | "last";
1186
+ /** Whether an edge from `sourceHandle` reads the node's per-iteration results
1187
+ * (`listResults` — each iteration's PRIMARY output). False on the other
1188
+ * handles of a `FAN_OUT_EACH_HANDLES` node: Camera Switch's transcript is one
1189
+ * value, never the list of switched EDLs, whatever mode its edge is set to. */
1190
+ declare function listResultsServeHandle(sourceType: string | null | undefined, sourceHandle: string | null | undefined): boolean;
1191
+ /**
1192
+ * FAN-IN targets: nodes that FOLD everything wired into them into ONE run,
1193
+ * instead of running once per upstream item. Keyed by node type; the value
1194
+ * names the target handles that fold (`"*"` = every handle). An edge into any
1195
+ * other handle of such a node is routed normally — Content Ideas folds its
1196
+ * recipes but reads its brand from a `field-brand` wire like any field.
1197
+ *
1198
+ * Single source of truth for both engines' input resolvers (the backend and
1199
+ * the editor each used to keep a private `new Set(["reduce"])`). A fan-in
1200
+ * node is never itself fanned out by an upstream list.
1201
+ */
1202
+ declare const FAN_IN_TARGETS: Readonly<Record<string, "*" | readonly string[]>>;
1203
+ declare function isFanInNodeType(nodeType: string | undefined | null): boolean;
1204
+ /** True when an edge into `targetHandle` of a `targetType` node is folded.
1205
+ * An edge with NO target handle (workflow JSON written by an agent often
1206
+ * omits it) lands on the node's primary input, which is the folding one. */
1207
+ declare function isFanInEdge(targetType: string | undefined | null, targetHandle: string | null | undefined): boolean;
1208
+
1209
+ type LoneMediaUrlKind = "image" | "video";
1210
+ /** Which medium a text value is when its WHOLE value is one media link; `null`
1211
+ * for anything else (empty, several words, a comma-joined pair of links, a
1212
+ * page link, a file ending in the host or the query, an unsupported format). */
1213
+ declare function loneMediaUrlKind(value: string): LoneMediaUrlKind | null;
1214
+ /** A source whose wire a social post reads as TEXT: not a declared image, video
1215
+ * or audio producer, not a dynamic (multi-typed) one such as List — whose typed
1216
+ * columns route by column type — not a message trigger, and not an entity
1217
+ * whose picture is a reference. Derived from the producer sets, so a new text
1218
+ * node is covered and a new media node (which must join its producer set to
1219
+ * connect at all) is excluded, with nothing to remember. */
1220
+ declare function isLoneMediaLinkSource(nodeType: string | null | undefined): boolean;
1221
+
1222
+ /**
1223
+ * Workflow-node parameter normalization.
1224
+ *
1225
+ * The config panels already prevent an impossible provider/parameter pair from
1226
+ * being *selected*: their dropdowns are provider-aware and a fail-safe effect
1227
+ * snaps stale values when the provider changes. But both of those are React
1228
+ * effects — they only run when that specific node's panel or hover strip is
1229
+ * mounted. A node written straight into workflow JSON by a non-UI author (an
1230
+ * agent, an import, a template) is never seen by either, so its invalid pair
1231
+ * survives all the way to the provider call.
1232
+ *
1233
+ * That is the 2026-08-09 incident: one `generate-image` node carrying
1234
+ * `gpt-image` + `16:9` (GPT Image 1.5 renders 1:1 / 3:2 / 2:3 only) reached KIE,
1235
+ * got rejected, and aborted a run whose five sibling nodes had already produced
1236
+ * — and billed for — their images.
1237
+ *
1238
+ * This module is the write-boundary guard: it heals the node instead of
1239
+ * rejecting it, so the user sees a valid value on the canvas rather than a
1240
+ * failed run. It reads exclusively from `MODEL_CATALOG`, so a model added later
1241
+ * is covered without touching this file.
1242
+ */
1243
+
1244
+ /**
1245
+ * Node types whose `data` carries catalog-governed model parameters under the
1246
+ * shape this module understands (`provider` + aspectRatio/resolution/quality).
1247
+ *
1248
+ * IMAGE ONLY, deliberately. The video nodes route several of these fields
1249
+ * through mode-dependent defaults (`"adaptive"` for Seedance/Hailuo, duration
1250
+ * composites tied to pricing) that this flat normalizer would flatten wrongly;
1251
+ * they get their own pass once those defaults are catalog-derived too.
1252
+ *
1253
+ * `modify-image` carries the same provider/aspectRatio/resolution/quality trio
1254
+ * as `image-to-image` (it routes through the same worker), and `edit-image`
1255
+ * carries provider + aspectRatio. `edit-image`'s `targetResolution` is an
1256
+ * UPSCALE target, a different field this module never reads — so listing the
1257
+ * type here heals its ratio without touching what it is priced on.
1258
+ */
1259
+ declare const MODEL_PARAM_NODE_TYPES: ReadonlySet<string>;
1260
+ /**
1261
+ * The image node types that transform a SOURCE image (their required `image`
1262
+ * input). On these "auto" means "keep the source photo's shape", and the run
1263
+ * resolves it against that image — natively on a model that lists "auto", else
1264
+ * to the model's nearest listed ratio (`normalizeModelInput`'s `sourceImage`).
1265
+ *
1266
+ * `generate-image` is absent: its photo is optional, and it is the first image
1267
+ * its references ASSEMBLE to, not a node input — see
1268
+ * `AUTO_ASPECT_AT_RUN_NODE_TYPES`.
1269
+ */
1270
+ declare const SOURCE_IMAGE_NODE_TYPES: ReadonlySet<string>;
1271
+ /**
1272
+ * The node types whose "auto" aspect ratio the RUN resolves against a photo,
1273
+ * so a write boundary (which has no photo) keeps it: the source-image types,
1274
+ * plus `generate-image`, whose photo is the first reference the run assembles
1275
+ * (or its inpaint / refine base). A Generate Image run with no photo snaps
1276
+ * "auto" exactly as this boundary used to — the value that reaches a provider
1277
+ * never changes there.
1278
+ */
1279
+ declare const AUTO_ASPECT_AT_RUN_NODE_TYPES: ReadonlySet<string>;
1280
+ /**
1281
+ * The image nodes whose aspect-ratio dropdown leads with the photo "Auto" tile
1282
+ * (Generate Image and Modify Image: `withPhotoAuto` in the editor). On these an
1283
+ * UNSET ratio IS Auto — the dropdown shows Auto for it, and both engines send
1284
+ * "auto" for it — so what the editor shows is what the run asks for.
1285
+ *
1286
+ * It used to send nothing, which handed the ratio to the provider's own
1287
+ * default (16:9 on nearly every model) while the panel displayed "Auto" or the
1288
+ * model's first listed ratio: a 3:4 photo through Modify Image came back 16:9
1289
+ * (#2009). "auto" then resolves exactly as a chosen Auto does — natively on a
1290
+ * model that lists it, else to the model's ratio nearest the photo, else (no
1291
+ * photo) the model's first listed ratio.
1292
+ */
1293
+ declare const PHOTO_AUTO_ASPECT_NODE_TYPES: ReadonlySet<string>;
1294
+ /**
1295
+ * The aspect ratio a node asks for: its stored value, or "auto" when it is
1296
+ * unset on a photo-Auto node (`PHOTO_AUTO_ASPECT_NODE_TYPES`). Every other node
1297
+ * type gets its value back unchanged (undefined stays undefined).
1298
+ */
1299
+ declare function nodeAspectRatio(nodeType: "generate-image" | "modify-image", aspectRatio: unknown): string;
1300
+ declare function nodeAspectRatio(nodeType: string | undefined, aspectRatio: unknown): string | undefined;
1301
+ interface NodeParamAdjustment extends ModelInputAdjustment {
1302
+ nodeId: string;
1303
+ provider: string;
1304
+ }
1305
+ interface NormalizedNodes<T> {
1306
+ nodes: T[];
1307
+ /** Empty when nothing needed correcting. */
1308
+ adjustments: NodeParamAdjustment[];
1309
+ }
1310
+ interface NodeLike {
1311
+ id?: unknown;
1312
+ type?: unknown;
1313
+ data?: unknown;
1314
+ }
1315
+ /**
1316
+ * Return `nodes` with every catalog-governed image parameter coerced into a
1317
+ * combination its provider actually accepts, plus the list of what changed.
1318
+ *
1319
+ * Immutable: nodes that need no correction are returned by reference, and a
1320
+ * corrected node is a fresh object (never a mutation of the caller's input).
1321
+ *
1322
+ * Multi-provider nodes (`data.providers` holding 2+ entries) are SKIPPED: the
1323
+ * valid set there is the intersection across every selected provider, and when
1324
+ * a stored value falls outside it there is no single defensible replacement —
1325
+ * picking one provider's default would silently misconfigure the others. Those
1326
+ * nodes are still guarded interactively by the panel's intersection dropdown.
1327
+ */
1328
+ declare function normalizeNodeModelParams<T extends NodeLike>(nodes: readonly T[]): NormalizedNodes<T>;
1329
+ /** One-line-per-change summary, for surfacing back to an agent or a log. */
1330
+ declare function describeNodeAdjustments(adjustments: readonly NodeParamAdjustment[]): string[];
1331
+
1332
+ /**
1333
+ * Generated-plan state on composer nodes that a preset must NEITHER capture NOR
1334
+ * carry, and that the dropdown must CLEAR when applying a preset:
1335
+ *
1336
+ * - every composer node's plan field (`COMPOSER_PLAN_MAP[*].planField` —
1337
+ * sceneGraph / effectPlan / overlayPlan / titlePlan / motionPlan /
1338
+ * compositePlan): a large LLM-authored plan blob, regenerated per run.
1339
+ * - `lottieUrl`: the R2 url of the authored Lottie JSON (motion-graphics'
1340
+ * `lottie` handle output) — a reapable generated artifact, not config.
1341
+ *
1342
+ * Derived from the single source of truth (COMPOSER_PLAN_MAP) so a new composer
1343
+ * node type is covered by construction — no per-type list to keep in sync.
1344
+ *
1345
+ * Two distinct hazards this closes (see motion-graphics-presets design §2a/§2b):
1346
+ * 1. Apply-time staleness: applying a preset over a node that already generated
1347
+ * a plan would leave the OLD animation showing under the NEW prompt (the
1348
+ * plan field is named by no patch, so it persists in the preview and on the
1349
+ * output handle). The dropdown spreads `{ ...clearPatch, ...preset.data }`
1350
+ * where clearPatch maps each key here to `undefined`.
1351
+ * 2. Capture pollution: a user-saved preset would otherwise capture the plan
1352
+ * blob (~tens of KB) + a stale url, re-injecting them on every apply and
1353
+ * bloating the preset row. These keys are in the capture-exclusion set below.
1354
+ */
1355
+ declare const PRESET_APPLY_CLEAR_KEYS: readonly string[];
1356
+ /**
1357
+ * The keys applying THIS preset must clear on the node: always `PRESET_APPLY_CLEAR_KEYS`, plus
1358
+ * `promptPrefix` / `promptSuffix` when the preset owns prompt content. The dropdown spreads
1359
+ * `{ ...clearPatch, ...preset.data }`, so the preset's own affixes (if any) land back on top of
1360
+ * the clear — the clear only decides what happens to the keys the preset does NOT set.
1361
+ *
1362
+ * The hazard this closes: with a STATIC clear set the affixes are named by no patch, so applying
1363
+ * preset B (which ships only `prompt`) over a node carrying preset A's `promptPrefix` leaves A's
1364
+ * prefix in place, silently wrapping B's prompt. The node then runs text no preset ever authored,
1365
+ * and nothing in the UI attributes it — the prefix lives in a collapsed settings section.
1366
+ *
1367
+ * The rule is ASYMMETRIC on purpose, because the two directions have opposite promises:
1368
+ * - A preset that owns prompt content is authoring the whole prompt, affixes included, so any
1369
+ * leftover affix from a previous preset is stale — clear both.
1370
+ * - A settings-only preset (provider / aspect ratio / seed …) promises to touch nothing about the
1371
+ * prompt, so it leaves prompt AND affixes exactly as the user has them.
1372
+ * - `prompt` is NEVER cleared, only overwritten when the preset ships it. That is the feature's
1373
+ * core promise: apply a preset that ships only affixes and your typed prompt is kept, wrapped.
1374
+ *
1375
+ * Pure; `PRESET_APPLY_CLEAR_KEYS` itself stays a fixed set (it is also spread into
1376
+ * `PRESET_EXCLUDED_KEYS`, and affixes must remain capture-INCLUDED for presets to ship them).
1377
+ */
1378
+ declare function presetApplyClearKeys(presetData: Readonly<Record<string, unknown>>, nodeType?: string): readonly string[];
1379
+ /**
1380
+ * Per node type, the look levers a preset may leave unset. Applying any preset
1381
+ * with data to a node of a listed type clears every member that preset does not
1382
+ * set, so one preset's plate colour, weight or position never carries over into
1383
+ * the next. Data-driven, so a new preset of a listed type is covered by
1384
+ * construction. The members stay capture-included: a saved preset carries the
1385
+ * levers its node had, so it clears only the ones that were unset when it was saved.
1386
+ */
1387
+ declare const PRESET_LEVER_GROUPS: Readonly<Record<string, readonly string[]>>;
1388
+ /**
1389
+ * The lever-group keys applying THIS preset clears on a node of `nodeType`: every
1390
+ * member of the node type's group that the preset does not set. Nothing for a node
1391
+ * type with no group, and nothing for empty preset data. Pure.
1392
+ */
1393
+ declare function presetLeverClearKeys(presetData: Readonly<Record<string, unknown>>, nodeType?: string): readonly string[];
1394
+ /**
1395
+ * Config fields that are intentionally NOT part of a preset, because they are not portable
1396
+ * configuration — they identify the node on the canvas, wire it into one specific graph, or point
1397
+ * at specific DB entities. Capturing them would make a preset silently wrong when applied to a
1398
+ * different node or workflow. This is the single place that defines that contract, so the system
1399
+ * stays correct-by-construction as new node types are added.
1400
+ *
1401
+ * Identity:
1402
+ * - `label`: the node's canvas identity. Presets carry their own name and must not rename the node.
1403
+ *
1404
+ * Graph wiring (reference specific upstream node / handle / tile ids — meaningless elsewhere):
1405
+ * - `fieldMappings`: field -> upstream node id.
1406
+ * - `referenceImageOrder` / `referenceOrder` / `connectedMediaOrder` / `connectedRefImageOrder`:
1407
+ * orderings keyed by the ids of wired upstream references.
1408
+ *
1409
+ * Structural identifiers (handle / port / route / channel ids that must stay unique per node and
1410
+ * that downstream edges target — copying them across nodes orphans edges or duplicates a channel):
1411
+ * - `routes` / `routeId` / `routeIds`: router routes + sub-workflow/condition route pairing ids.
1412
+ * - `ports` / `inputPorts` / `outputPorts`: sub-workflow port arrays (each port has a handle id).
1413
+ * - `channel` / `channelColor`: teleport send/receive pairing channel (auto-assigned per node).
1414
+ *
1415
+ * DB entity references / per-wiring identity state (tied to specific characters/locations):
1416
+ * - `characterDefinitionIds`, `suppressedCanonicalCharacterIds`, `suppressedCanonicalLocationIds`.
1417
+ * - `identityMeta`: per-identity overrides keyed by the wired identity's index/label.
1418
+ * - `extraRefs`: extra references carrying `characterSlug` + workflow-specific asset urls.
1419
+ *
1420
+ * Preset meta:
1421
+ * - `__activePresetId`: which preset is currently loaded onto the node (for the dropdown's
1422
+ * active-name + dirty `*`). Node-local UI state, never part of a preset's own config.
1423
+ * - `__promptFinalView`: field keys currently showing the final-prompt view (Edit ⇄ Final
1424
+ * per-field toggle). Node-local UI state, never part of a preset's own config.
1425
+ *
1426
+ * NOTE: manual reference image urls (`referenceImageUrl` / `referenceImageUrls`) are deliberately
1427
+ * KEPT — they are self-contained R2 urls a user set as input, and portable across nodes.
1428
+ *
1429
+ * Generated composer-plan state (`PRESET_APPLY_CLEAR_KEYS` — every COMPOSER_PLAN_MAP plan field +
1430
+ * `lottieUrl`): NOT portable config — a per-run LLM-authored plan blob / reapable artifact url.
1431
+ * Excluded here (preset-scoped, zero blast radius) rather than via EXECUTION_DATA_KEYS, whose
1432
+ * non-preset consumers (undo-skip in use-workflow-store, auto-execute IGNORE_KEYS) would then
1433
+ * treat a legitimately-persisted plan as transient runtime state.
1434
+ */
1435
+ declare const PRESET_EXCLUDED_KEYS: ReadonlySet<string>;
1436
+ /**
1437
+ * Capture a node's reusable configuration from its `data`: a shallow copy minus runtime/result
1438
+ * state (`isExecutionDataKey`: the global keys, plus the node type's own when `nodeType` is given)
1439
+ * and graph/identity fields (PRESET_EXCLUDED_KEYS). Pure; never mutates the input. The node type is
1440
+ * stored alongside the result by the caller.
1441
+ */
1442
+ declare function extractPresetData(data: Readonly<Record<string, unknown>>, nodeType?: string): Record<string, unknown>;
1443
+ /**
1444
+ * True iff the node's `data` still matches the preset — i.e. every key the preset defines
1445
+ * deep-equals the node's current value. Compares only preset-defined keys (the node may carry
1446
+ * extra keys the preset doesn't set, e.g. seed, which must NOT count as a mismatch). Used to drive
1447
+ * the dropdown's dirty `*` indicator.
1448
+ */
1449
+ declare function presetDataMatches(nodeData: Readonly<Record<string, unknown>>, presetData: Readonly<Record<string, unknown>>): boolean;
1450
+
1451
+ /**
1452
+ * Prompt pre/post text ("affixes") — the PUBLIC node-data contract.
1453
+ *
1454
+ * Every AI prompt node may carry two optional strings that are wrapped around
1455
+ * its run-time prompt: `promptPrefix` goes before, `promptSuffix` after. Both
1456
+ * support `{Node Label}` references and plain-text snippets exactly like the
1457
+ * main prompt. They are settings (edited in the node's config panel, captured
1458
+ * by presets, settable through workflow JSON / `inputOverrides`), never shown
1459
+ * on the node face or to published-app end users.
1460
+ *
1461
+ * Only the KEYS + TYPE live here (what the SDK/API contract needs). The wrap
1462
+ * behaviour (`applyPromptAffixes`) lives in `@nodaro/prompts` next to
1463
+ * `resolvePrompt` — see the spec's IP-placement note.
1464
+ */
1465
+ declare const PROMPT_PREFIX_KEY: "promptPrefix";
1466
+ declare const PROMPT_SUFFIX_KEY: "promptSuffix";
1467
+ interface PromptAffixFields {
1468
+ /** Text placed BEFORE the node's prompt at run time. Supports {Node Label} refs. */
1469
+ readonly promptPrefix?: string;
1470
+ /** Text placed AFTER the node's prompt at run time. Supports {Node Label} refs. */
1471
+ readonly promptSuffix?: string;
1472
+ }
1473
+ /** The affix pair read off node data (blank / non-string values are omitted). */
1474
+ interface PromptAffixes {
1475
+ readonly prefix?: string;
1476
+ readonly suffix?: string;
1477
+ }
1478
+ /** Read `{ prefix, suffix }` off a node's `data`. Never throws; unknown shapes → `{}`. */
1479
+ declare function readPromptAffixes(data: Record<string, unknown>): PromptAffixes;
1480
+
1481
+ declare const NODE_PRESET_EXPORT_KIND: "nodaro.node-presets";
1482
+ interface ExportedPreset {
1483
+ nodeType: string;
1484
+ name: string;
1485
+ description?: string;
1486
+ data: Record<string, unknown>;
1487
+ }
1488
+ interface NodePresetExport {
1489
+ kind: typeof NODE_PRESET_EXPORT_KIND;
1490
+ version: 1;
1491
+ exportedAt: string;
1492
+ presets: ExportedPreset[];
1493
+ }
1494
+ declare function buildNodePresetExport(presets: ExportedPreset[], exportedAtIso: string): NodePresetExport;
1495
+ /**
1496
+ * Validate an unknown parsed-JSON value as a preset export; throws on invalid. Defensively
1497
+ * re-strips runtime keys from each preset's data.
1498
+ */
1499
+ declare function parseNodePresetExport(input: unknown): NodePresetExport;
1500
+
1501
+ /** Legacy SOURCE handle id → canonical id, per node type. */
1502
+ declare const LEGACY_SOURCE_HANDLE_ALIASES: Readonly<Record<string, Readonly<Record<string, string>>>>;
1503
+ /** Legacy TARGET handle id → canonical id, per node type. */
1504
+ declare const LEGACY_TARGET_HANDLE_ALIASES: Readonly<Record<string, Readonly<Record<string, string>>>>;
1505
+ /**
1506
+ * Node types whose handles are created at run time — a column per list field,
1507
+ * a lane per Router route, a slot per overlay layer, a sub-workflow's ports —
1508
+ * so an edge into them cannot be checked against the declared handle list.
1509
+ */
1510
+ declare const DYNAMIC_HANDLE_NODE_TYPES: ReadonlySet<string>;
1511
+ /** The canonical source handle id for a legacy spelling on this node type, or the spelling itself. */
1512
+ declare function canonicalSourceHandle(nodeType: string | undefined, handle: string): string;
1513
+ /** The canonical target handle id for a legacy spelling on this node type, or the spelling itself. */
1514
+ declare function canonicalTargetHandle(nodeType: string | undefined, handle: string): string;
1515
+ /**
1516
+ * The target handle an edge lands on AFTER the alias table, decided by the
1517
+ * source node's type. `handle` is the id after the table; `sentHandle` the id
1518
+ * as written, for the rule that only reinterprets a legacy `in`. Returns the
1519
+ * handle unchanged when no rule applies — a no-op for every typed wire.
1520
+ */
1521
+ declare function classifyLegacyTargetHandle(targetType: string | undefined, handle: string | null | undefined, sourceType: string | undefined, sentHandle?: string | null | undefined): string | null | undefined;
1522
+ /**
1523
+ * Source pips a component renders that its NODE_DEFINITIONS entry does not
1524
+ * declare, or declares under another name — the burn-down list of issue
1525
+ * #1877, pinned to the rendered JSX by the frontend guard
1526
+ * (node-output-handles-completeness.test.ts). The server treats these as the
1527
+ * node's real outputs: an edge on one draws; an edge on the declared-only id
1528
+ * does not, so the write-time pass moves it onto the one pip that draws. An
1529
+ * entry leaves this table the day its definition is fixed.
1530
+ *
1531
+ * EMPTY since #1877 was burned down: every definition declares the pips its
1532
+ * component renders, and the ids they used to declare are source aliases
1533
+ * above. The table and `renderedSourceHandle` stay so a drift that is found
1534
+ * later can be recorded here instead of shipping an invisible edge; the guard
1535
+ * test fails until it is.
1536
+ */
1537
+ declare const RENDERED_OUTPUT_HANDLES: Readonly<Record<string, readonly string[]>>;
1538
+ /**
1539
+ * The pip that draws for a source handle a node DECLARES but does not render
1540
+ * (a `RENDERED_OUTPUT_HANDLES` node): `<handle>-out` when that is a rendered
1541
+ * pip (the ffmpeg family), else the node's single rendered pip; null when the
1542
+ * handle is not such a case, or several pips could be meant (never guessed).
1543
+ * `declaredOutputs` is the node's definition list — `NODE_HANDLES[type].outputs`
1544
+ * on the server, `NODE_DEF_MAP.get(type).outputs` in the editor. The editor
1545
+ * applies it when it LOADS a graph, the server when it WRITES one: the same
1546
+ * move, from one place.
1547
+ */
1548
+ declare function renderedSourceHandle(nodeType: string | undefined, handle: string | null | undefined, declaredOutputs: ReadonlyArray<string> | undefined): string | null;
1549
+
1550
+ /**
1551
+ * Site Capture node — the wire contract both engines read.
1552
+ *
1553
+ * The node runs `POST /v1/site-capture` (a web page captured the way a phone
1554
+ * shows it: a full-page image, up to 8 section stills in page order, a section
1555
+ * map and the page's exact figures) and polls its job. What it hands on is read
1556
+ * from that job's output here, once, so the editor and a server run cannot
1557
+ * disagree:
1558
+ * - `image`: the stills, in page order. The first still is the pip's single
1559
+ * value; every still is its list (an "each" wire runs once per still, a
1560
+ * Bundle wire takes them all). The full-page image is never one of them.
1561
+ * - `json`: the capture's output as the route returns it.
1562
+ */
1563
+ declare const SITE_CAPTURE_NODE_TYPE: "site-capture";
1564
+ /** The stills a capture may return — the route's `maxStills` bounds. */
1565
+ declare const SITE_CAPTURE_STILLS: {
1566
+ readonly min: 3;
1567
+ readonly max: 8;
1568
+ readonly default: 8;
1569
+ };
1570
+ /** A node's `maxStills`, clamped to the route's bounds; anything else is the default. */
1571
+ declare function siteCaptureMaxStills(value: unknown): number;
1572
+ /**
1573
+ * The page a run captures: the address typed on the node, else the first web
1574
+ * address in the text wired into it (a Text node, a list item), else that
1575
+ * text's first word, which the route normalises ("example.com") or refuses.
1576
+ */
1577
+ declare function siteCapturePageUrl(typed: unknown, upstream?: string | null): string;
1578
+ /** One still of a capture, as its output lists it. */
1579
+ interface SiteCaptureStill {
1580
+ readonly url: string;
1581
+ readonly index: number;
1582
+ readonly label: string;
1583
+ readonly category: string;
1584
+ }
1585
+ /** The stills of a capture's output, in page order; none when it holds none. */
1586
+ declare function siteCaptureStills(output: unknown): SiteCaptureStill[];
1587
+ /** The still URLs of a capture's output, in page order. */
1588
+ declare function siteCaptureStillUrls(output: unknown): string[];
1589
+ /**
1590
+ * What a capture hands on: `json` (the output itself), `imageUrl` (the first
1591
+ * still) and `listResults` (every still, in page order). Nothing for an output
1592
+ * that is not an object.
1593
+ */
1594
+ declare function siteCaptureNodeOutputs(output: unknown): {
1595
+ json?: Record<string, unknown>;
1596
+ imageUrl?: string;
1597
+ listResults?: string[];
1598
+ };
1599
+
1600
+ export { AUDIO_PRODUCER_TYPES, AUTO_ASPECT_AT_RUN_NODE_TYPES, type AddCollectionRecordInput, type AddCollectionRecordResult, type BulkCollectionRecordsInput, type BulkCollectionRecordsResult, COLLECTIONS_PAGE_DEFAULT, COLLECTIONS_PAGE_MAX, COLLECTION_BULK_ACTIONS, COLLECTION_BULK_MAX, COLLECTION_DEDUPE_KEY_MAX, COLLECTION_DESCRIPTION_MAX, COLLECTION_DIGEST_SEPARATOR, COLLECTION_EVICT_MAX_PER_WRITE, COLLECTION_HEADLINE_MAX, COLLECTION_IDEMPOTENCY_KEY_MAX, COLLECTION_MEDIA_TYPES, COLLECTION_NAME_MAX, COLLECTION_READ_LIMIT_MAX, COLLECTION_READ_WINDOW_HOURS_MAX, COLLECTION_RECORDS_OFFSET_MAX, COLLECTION_RECORD_FIELDS_BYTES_MAX, COLLECTION_RECORD_FIELDS_MAX, COLLECTION_RECORD_MEDIA_MAX, COLLECTION_RECORD_STATUSES, COLLECTION_RECORD_TEXT_MAX, COLLECTION_RECORD_TITLE_MAX, COLLECTION_RECORD_URL_MAX, COLLECTION_TIER_CAPS, COLLECTION_USAGES, CONTINUATION_NOT_COMPLETED, CONTINUATION_NOT_FAILED, CONTINUATION_NOT_FOUND, CONTINUATION_SETTLING, CONTINUATION_SUBSET_REQUIRED, CONTINUATION_SUPERSEDED, CONTINUATION_VERSION_MISMATCH, CONTINUATION_WORKFLOW_MISMATCH, type Collection, type CollectionBulkAction, type CollectionCaps, type CollectionDigestFormat, type CollectionExportFormat, type CollectionFieldValue, type CollectionLimits, type CollectionMedia, type CollectionMediaType, type CollectionReadOrder, type CollectionReadWindowUnit, type CollectionRecord, type CollectionRecordSource, type CollectionRecordStatus, type CollectionUsage, type CollectionWriteOutcome, type CreateCollectionInput, DYNAMIC_HANDLE_NODE_TYPES, DYNAMIC_PRODUCER_TYPES, type ExportedPreset, FAN_IN_TARGETS, FAN_OUT_ALL_OR_NOTHING_TYPES, FAN_OUT_EACH_HANDLES, FAN_OUT_EACH_TYPES, IMAGE_PRODUCER_TYPES, type IngestedRecord, type JsonKind, type JsonKindMismatch, type JsonOutputDeclaration, LEGACY_SOURCE_HANDLE_ALIASES, LEGACY_TARGET_HANDLE_ALIASES, type ListCollectionRecordsParams, type ListCollectionRecordsResult, type ListCollectionsResult, type LoneMediaUrlKind, MODEL_PARAM_NODE_TYPES, NODE_MAPPABLE_FIELDS, NODE_PRESET_EXPORT_KIND, NODE_RUN_ROUTES, NODE_TYPES_WITHOUT_RUN_ROUTE, NO_SAVED_RENDER_STAMPS, type NodeParamAdjustment, type NodePresetExport, type NormalizedNodes, OWNER_ONLY_LISTING_RENDER_TYPES, OWN_LIST_NODE_TYPES, PHOTO_AUTO_ASPECT_NODE_TYPES, PRESET_APPLY_CLEAR_KEYS, PRESET_EXCLUDED_KEYS, PRESET_LEVER_GROUPS, PREVIEW_RENDER_NESTED, PREVIEW_RENDER_NESTED_MIXED, PREVIEW_RENDER_NESTED_REVIEW_ON, PREVIEW_RENDER_NODE_TYPES, PREVIEW_REVIEW_REQUIRED, PREVIEW_REVIEW_REQUIRED_MIXED, PREVIEW_REVIEW_REQUIRED_REVIEW_ON, PROMPT_PREFIX_KEY, PROMPT_SUFFIX_KEY, type PassThrough, type PassThroughWarning, type PreflightGraphEdge, type PreflightGraphNode, type PreviewGateEdge, type PreviewGateNode, type PreviewGateRun, type PreviewStops, type PromptAffixFields, type PromptAffixes, RENDERED_OUTPUT_HANDLES, RENDER_FINAL_ALREADY_RENDERED, RENDER_FINAL_ALREADY_RENDERED_MESSAGE, RENDER_FINAL_CODES, RENDER_FINAL_NODE_NOT_FOUND, RENDER_FINAL_NOT_A_RENDER, RENDER_JSON_HANDLE, RENDER_NODE_TYPES, RENDER_NODE_TYPE_IDS, REVIEW_HOLDING_USE_CASE_TYPES, RUN_CONTINUATION_CODES, RUN_ONLY_NODE_FIELDS, RUN_OVERRIDE_CLEARED_FIELDS, type RenderClockSource, type RenderFinalCode, type RenderGraphEdge, type RenderGraphNode, type RenderJsonKind, type RenderMedium, type RenderNodeDescriptor, type RenderPlanHop, type RenderPlanPath, type RenderQuality, type RenderResultStamp, type RenderSavedJsonOutput, type RenderSettingsInput, type RenderTranscriptOutput, type RunContinuationCode, type RunResultRowStamp, SAVED_RENDER_STAMPS, SCRIPT_SCENE_COUNT_DEFAULT, SCRIPT_SCENE_COUNT_RANGE, SCRIPT_STYLE_GUIDE_MAX_LENGTH, SCRIPT_TARGET_DURATION_DEFAULT, SCRIPT_TARGET_DURATION_RANGE, SCRIPT_TONE_MAX_LENGTH, SETTINGS_HINT_SOURCES, SETTINGS_INPUT_CONSUMERS, SETTINGS_INPUT_HANDLE, SETTINGS_SOURCE_FIELDS, SETTINGS_SOURCE_TYPES, SITE_CAPTURE_NODE_TYPE, SITE_CAPTURE_STILLS, SOURCE_IMAGE_NODE_TYPES, SUNO_FIELD_HANDLE_FIELDS, type SavedRenderItem, type SavedRenderQualityStamp, type SavedRenderStampReader, type ScriptSettings, type SetCollectionRecordUsedInput, type SettingsField, type SettingsFieldSourceType, type SettingsHintSourceType, type SettingsInputProblem, type SettingsSourceType, type SiteCaptureStill, type UpdateCollectionInput, VIDEO_PRODUCER_TYPES, type WiredSetting, type WordlessTranscriptFeed, applySettingsInput, buildNodePresetExport, canonicalSourceHandle, canonicalTargetHandle, captionPlanPassThrough, clampChars, classifyLegacyTargetHandle, collectionCapsForTier, collectionReadSince, collectionRecordHeadline, collectionRecordsDigest, combineVideosPassThrough, connectedSettingsSources, declaredJsonOutput, declaredJsonOutputRows, defaultEdgeOutputMode, describeNodeAdjustments, edlSpanKey, extractPresetData, fieldKeyFromHandle, findWordlessTranscriptFeeds, fitCollectionField, holdsPreviewRender, ingestRecordFromJson, isCollectionMedia, isCollectionUrl, isFanInEdge, isFanInNodeType, isLoneMediaLinkSource, isPreviewHoldingType, isPreviewRefusalCode, isRenderDataHandle, isRenderNodeType, isSettingsHintEdge, isSettingsHintSource, isSettingsSourceType, jsonInputKind, jsonKindMismatch, jsonKindMismatchMessage, jsonOutputKind, listResultsServeHandle, loneMediaUrlKind, nodeAspectRatio, nodeRunRoute, normalizeCollectionFields, normalizeCollectionMedia, normalizeDedupeKey, normalizeNodeModelParams, ownsItsList, parseNodePresetExport, planClipKeyAt, presetApplyClearKeys, presetDataMatches, presetLeverClearKeys, previewGatedNodeIds, previewStops, readPromptAffixes, readScriptSettings, renderClipKey, renderNodeOf, renderPlanBasis, renderPlanClipKey, renderPlanNodeId, renderPlanPath, renderPlanRowClipKeys, renderPlanValue, renderReadBasis, renderResultStamp, renderRunQuality, renderSavedJsonOutputs, renderSentRowStamps, renderSettingsBasis, renderTranscriptOutputOf, renderedSourceHandle, rendersAsPreview, rendersLatestBatch, rendersTranscriptJson, resolveWiredSettings, savedRenderBatch, savedRenderBatchUrls, savedRenderOutput, settingsInputAccepts, settingsInputFields, settingsProviderModels, settingsSourceForField, settingsSourceForType, siteCaptureMaxStills, siteCaptureNodeOutputs, siteCapturePageUrl, siteCaptureStillUrls, siteCaptureStills, snapToModelDuration, transcribeWordTimestampsRefusal, videoOverlayPassThrough, withRunOverrides, withWiredSettings };