@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,2617 @@
1
+ import { z } from 'zod';
2
+ import { Operation } from 'fast-json-patch';
3
+ import { bq as TtsProvider } from '../scene-node-types-C3kl_zyK.js';
4
+ export { d as AssetRef, e as AssetRefSchema, al as MatchCutVerdict, am as MatchCutVerdictSchema, b0 as SceneMetadata, b1 as SceneMetadataSchema, b2 as SceneNodeData, b3 as SceneNodeDataSchema, b6 as ShotSpec, b7 as ShotSpecSchema, bo as TransitionType, bp as TransitionTypeSchema, cv as sceneRenderStateRegistry } from '../scene-node-types-C3kl_zyK.js';
5
+
6
+ /**
7
+ * Body for POST /v1/pipelines/:id/entities/:entity_id/reject.
8
+ * Approve takes no body (optional `edits` future-deferred).
9
+ */
10
+ declare const EntityRejectInputSchema: z.ZodObject<{
11
+ feedback: z.ZodString;
12
+ }, z.core.$strip>;
13
+ type EntityRejectInput = z.infer<typeof EntityRejectInputSchema>;
14
+ declare const ENTITY_STATUSES: readonly ["pending", "generating", "awaiting_approval", "approved", "rejected", "failed", "pending_description", "skipped"];
15
+ type EntityStatus = (typeof ENTITY_STATUSES)[number];
16
+ declare const ENTITY_TYPES: readonly ["character", "object", "location", "scene"];
17
+ type EntityType = (typeof ENTITY_TYPES)[number];
18
+
19
+ /**
20
+ * Phase 1B.4 — pipeline_state lifecycle + drift event types.
21
+ *
22
+ * `pipeline_state` lives on `pipeline_entity_nodes.pipeline_state` (migration
23
+ * 131). Mirrors the four-value CHECK constraint there.
24
+ *
25
+ * `pipeline_owned_running` — node belongs to the pipeline, work in flight
26
+ * `pipeline_owned_awaiting_approval` — node belongs to the pipeline, user is the gate
27
+ * `pipeline_owned_approved` — node belongs to the pipeline, work locked in
28
+ * `pipeline_orphaned` — pipeline released ownership (cancel / fork / fail);
29
+ * node survives so the user keeps the work
30
+ */
31
+ declare const PipelineStateSchema: z.ZodEnum<{
32
+ pipeline_owned_running: "pipeline_owned_running";
33
+ pipeline_owned_awaiting_approval: "pipeline_owned_awaiting_approval";
34
+ pipeline_owned_approved: "pipeline_owned_approved";
35
+ pipeline_orphaned: "pipeline_orphaned";
36
+ }>;
37
+ type PipelineState = z.infer<typeof PipelineStateSchema>;
38
+ /**
39
+ * Emitted when a pipeline_entity_nodes row transitions to a new
40
+ * `pipeline_state`. Fires on:
41
+ * - stage transitioning to 'awaiting_approval' (per-entity batch)
42
+ * - approveEntity success
43
+ * - rejectEntity regenerate path
44
+ * - force-stop / fork orphaning (every entity at once)
45
+ *
46
+ * Frontend swaps node visuals (running glow → awaiting frame → approved chip)
47
+ * based on the new state.
48
+ */
49
+ declare const EntityStateChangeEventSchema: z.ZodObject<{
50
+ type: z.ZodLiteral<"entity:state_change">;
51
+ pipelineId: z.ZodString;
52
+ pipelineEntityId: z.ZodString;
53
+ newState: z.ZodEnum<{
54
+ pipeline_owned_running: "pipeline_owned_running";
55
+ pipeline_owned_awaiting_approval: "pipeline_owned_awaiting_approval";
56
+ pipeline_owned_approved: "pipeline_owned_approved";
57
+ pipeline_orphaned: "pipeline_orphaned";
58
+ }>;
59
+ }, z.core.$strip>;
60
+ type EntityStateChangeEvent = z.infer<typeof EntityStateChangeEventSchema>;
61
+ /**
62
+ * Emitted when a `pipeline_entities.is_stale` flag flips to true via the
63
+ * cascade staleness trigger (migration 131). Triggered after a `main_asset_id`
64
+ * update on an upstream entity; the trigger marks every transitive dependent
65
+ * stale, and the engine emits one event per dependent.
66
+ *
67
+ * Frontend overlays a "Stale — needs regenerate" warning on the affected
68
+ * canvas nodes.
69
+ */
70
+ declare const EntityStaleEventSchema: z.ZodObject<{
71
+ type: z.ZodLiteral<"entity:stale">;
72
+ pipelineId: z.ZodString;
73
+ pipelineEntityId: z.ZodString;
74
+ reason: z.ZodOptional<z.ZodEnum<{
75
+ manual: "manual";
76
+ upstream_changed: "upstream_changed";
77
+ user_edit: "user_edit";
78
+ }>>;
79
+ }, z.core.$strip>;
80
+ type EntityStaleEvent = z.infer<typeof EntityStaleEventSchema>;
81
+ /**
82
+ * Emitted when a pipeline is force-stopped / forked. Carries the prior status
83
+ * (`forked_status`) so the UI can render "Forked from approval" vs "Forked
84
+ * mid-Stage-5" copy. The companion `entity:state_change` flurry that orphans
85
+ * every node lands in the same SSE batch.
86
+ */
87
+ declare const PipelineForkedEventSchema: z.ZodObject<{
88
+ type: z.ZodLiteral<"pipeline:forked">;
89
+ pipelineId: z.ZodString;
90
+ forkedAt: z.ZodString;
91
+ forkedStatus: z.ZodString;
92
+ forkReason: z.ZodOptional<z.ZodString>;
93
+ }, z.core.$strip>;
94
+ type PipelineForkedEvent = z.infer<typeof PipelineForkedEventSchema>;
95
+ /**
96
+ * Section H drift summary — when the engine pauses a stage at
97
+ * 'awaiting_approval' because user edits on the canvas diverged from the
98
+ * pipeline's recorded state, this payload is attached to the
99
+ * `pipeline_stages.awaiting_reason='canvas_drift'` row so the UI can render
100
+ * the DriftBanner with actionable diffs.
101
+ *
102
+ * Carried inside a `stage:status` event (or a future dedicated event); kept
103
+ * as a standalone schema so callers can validate the drift payload
104
+ * independently.
105
+ */
106
+ declare const PipelineDriftSummarySchema: z.ZodObject<{
107
+ type: z.ZodLiteral<"pipeline:drift">;
108
+ pipelineId: z.ZodString;
109
+ stageName: z.ZodString;
110
+ driftedEntityIds: z.ZodArray<z.ZodString>;
111
+ summary: z.ZodOptional<z.ZodString>;
112
+ }, z.core.$strip>;
113
+ type PipelineDriftSummary = z.infer<typeof PipelineDriftSummarySchema>;
114
+ /**
115
+ * Phase 1C.1 — emitted by Stage 8 (post_merge) when the pipeline reaches the
116
+ * `completed` terminal state. Carries the final merged-MP4 asset id + URL so
117
+ * the SSE consumer can render the player without an extra round-trip.
118
+ *
119
+ * Distinct from the legacy `pipeline:done` lifecycle event (which carries no
120
+ * payload). SSE forwarders close on either type.
121
+ */
122
+ declare const PipelineCompletedEventSchema: z.ZodObject<{
123
+ type: z.ZodLiteral<"pipeline:completed">;
124
+ pipelineId: z.ZodString;
125
+ finalOutputAssetId: z.ZodNullable<z.ZodString>;
126
+ finalOutputUrl: z.ZodString;
127
+ }, z.core.$strip>;
128
+ type PipelineCompletedEvent = z.infer<typeof PipelineCompletedEventSchema>;
129
+ /**
130
+ * Phase 1C.2 — Sub-gate names. Stage 7 (animate_audio_edit) and Stage 6
131
+ * (scene_images) can pause at one of these mid-stage gates before resuming
132
+ * the rest of the stage; the gate name is persisted on
133
+ * `pipeline_stages.output.current_sub_gate` (JSONB) so a resumed orchestrator
134
+ * picks up at the right step.
135
+ *
136
+ * `silent_cut_preview` — Stage 7: Editor LLM has emitted cut_decisions;
137
+ * user reviews the preview reel before the
138
+ * per-shot trims commit.
139
+ * `dialogue_recheck` — Stage 7: A re-recorded dialogue line shifted
140
+ * the dialogue_no_cut_zone; user confirms the
141
+ * new cuts still respect the zone.
142
+ * `match_cut_break_pending` — Stage 6: MatchCutCritic found one or more
143
+ * match-cut shot pairs with `match_strength =
144
+ * "break"`. User must accept each break (sets
145
+ * `accepted_match_cut_break=true` on the shot)
146
+ * before Stage 7 can animate those pairs.
147
+ */
148
+ declare const SubGateNameSchema: z.ZodEnum<{
149
+ silent_cut_preview: "silent_cut_preview";
150
+ dialogue_recheck: "dialogue_recheck";
151
+ match_cut_break_pending: "match_cut_break_pending";
152
+ }>;
153
+ type SubGateName = z.infer<typeof SubGateNameSchema>;
154
+ /**
155
+ * The sub-gates `POST /v1/pipelines/:id/sub-gates/:gate/{approve,reject}`
156
+ * resolves: Stage 7's (`animate_audio_edit`). `match_cut_break_pending` is not
157
+ * one of them — it clears per shot, one break at a time, through
158
+ * `POST /v1/pipelines/:id/entities/:sceneId/helpers/accept_match_cut_break`
159
+ * (`MATCH_CUT_BREAK_GATE`).
160
+ */
161
+ declare const ANIMATE_SUB_GATES: readonly ["silent_cut_preview", "dialogue_recheck"];
162
+ declare const AnimateSubGateSchema: z.ZodEnum<{
163
+ silent_cut_preview: "silent_cut_preview";
164
+ dialogue_recheck: "dialogue_recheck";
165
+ }>;
166
+ type AnimateSubGate = (typeof ANIMATE_SUB_GATES)[number];
167
+ /** Stage 6's sub-gate, cleared by accepting each flagged break (see {@link ANIMATE_SUB_GATES}). */
168
+ declare const MATCH_CUT_BREAK_GATE = "match_cut_break_pending";
169
+ /**
170
+ * Phase 1C.2 — emitted when Stage 6 (scene_images) or Stage 7
171
+ * (animate_audio_edit) pauses at a sub-gate. Carries an optional `payload`
172
+ * (JSONB-shaped) for whatever the gate needs to render — e.g. the preview
173
+ * reel URL, the affected shot ids, or the pending-break list.
174
+ *
175
+ * Distinct from `stage:status awaiting_approval` (which is the top-level
176
+ * stage gate). Sub-gates stash `current_sub_gate` on the stage output AND
177
+ * flip `status = "awaiting_approval"` so the pipeline engine waits.
178
+ */
179
+ declare const StageAwaitingSubGateEventSchema: z.ZodObject<{
180
+ type: z.ZodLiteral<"stage:awaiting_sub_gate">;
181
+ pipelineId: z.ZodString;
182
+ stageName: z.ZodEnum<{
183
+ animate_audio_edit: "animate_audio_edit";
184
+ scene_images: "scene_images";
185
+ }>;
186
+ subGate: z.ZodEnum<{
187
+ silent_cut_preview: "silent_cut_preview";
188
+ dialogue_recheck: "dialogue_recheck";
189
+ match_cut_break_pending: "match_cut_break_pending";
190
+ }>;
191
+ payload: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
192
+ }, z.core.$strip>;
193
+ type StageAwaitingSubGateEvent = z.infer<typeof StageAwaitingSubGateEventSchema>;
194
+ /**
195
+ * Phase 1C.2 — emitted when the music_timeline build step (Stage 7 sibling)
196
+ * has produced the merged music track + beat grid. The SSE consumer can
197
+ * render the music waveform + beat markers without an extra round-trip.
198
+ */
199
+ declare const PipelineMusicReadyEventSchema: z.ZodObject<{
200
+ type: z.ZodLiteral<"pipeline:music_ready">;
201
+ pipelineId: z.ZodString;
202
+ musicAssetUrl: z.ZodString;
203
+ beatGridLength: z.ZodNumber;
204
+ }, z.core.$strip>;
205
+ type PipelineMusicReadyEvent = z.infer<typeof PipelineMusicReadyEventSchema>;
206
+ /**
207
+ * Phase 1C.2 — emitted when the Editor LLM has produced cut_decisions for
208
+ * every shot in the pipeline. Frontend can render the silent-cut-preview UI
209
+ * (timeline + accept/reject) once this fires. Payload is intentionally
210
+ * minimal — the decisions are persisted on the shots' `cut_decision` field
211
+ * and the `editor_decisions` audit table.
212
+ */
213
+ declare const PipelineEditorDecisionsReadyEventSchema: z.ZodObject<{
214
+ type: z.ZodLiteral<"pipeline:editor_decisions_ready">;
215
+ pipelineId: z.ZodString;
216
+ }, z.core.$strip>;
217
+ type PipelineEditorDecisionsReadyEvent = z.infer<typeof PipelineEditorDecisionsReadyEventSchema>;
218
+ /**
219
+ * Union of the Phase 1B.4 + 1C.1 + 1C.2 lifecycle event payloads. The broader
220
+ * `PipelineEvent` union in `pipeline-events.ts` extends this so SSE
221
+ * forwarders accept all of them transparently.
222
+ */
223
+ type PipelineLifecycleEvent = EntityStateChangeEvent | EntityStaleEvent | PipelineForkedEvent | PipelineDriftSummary | PipelineCompletedEvent | StageAwaitingSubGateEvent | PipelineMusicReadyEvent | PipelineEditorDecisionsReadyEvent;
224
+
225
+ /**
226
+ * Canonical pipeline stage order — Phase 1A→1C topology. The engine's
227
+ * `runPipeline` walks this list in sequence; tests, the SSE event router,
228
+ * and the admin-side stage timeline all consume this same tuple as the
229
+ * source of truth for "which stages exist + in what order".
230
+ */
231
+ declare const PIPELINE_STAGE_NAMES: readonly ["script", "characters", "objects", "locations", "shot_list", "scene_images", "animate_audio_edit", "post_merge"];
232
+ declare const PipelineStageNameSchema: z.ZodEnum<{
233
+ characters: "characters";
234
+ script: "script";
235
+ objects: "objects";
236
+ locations: "locations";
237
+ animate_audio_edit: "animate_audio_edit";
238
+ scene_images: "scene_images";
239
+ shot_list: "shot_list";
240
+ post_merge: "post_merge";
241
+ }>;
242
+ type PipelineStageName = (typeof PIPELINE_STAGE_NAMES)[number];
243
+ declare const PipelineStatusSchema: z.ZodEnum<{
244
+ running: "running";
245
+ failed: "failed";
246
+ cancelled: "cancelled";
247
+ awaiting_approval: "awaiting_approval";
248
+ queued: "queued";
249
+ completed: "completed";
250
+ forked: "forked";
251
+ }>;
252
+ type PipelineStatus = z.infer<typeof PipelineStatusSchema>;
253
+ declare const PipelineStageStatusSchema: z.ZodEnum<{
254
+ running: "running";
255
+ failed: "failed";
256
+ cancelled: "cancelled";
257
+ pending: "pending";
258
+ approved: "approved";
259
+ awaiting_approval: "awaiting_approval";
260
+ rejected: "rejected";
261
+ }>;
262
+ type PipelineStageStatus = z.infer<typeof PipelineStageStatusSchema>;
263
+ type PipelineEvent = {
264
+ type: "pipeline:status";
265
+ pipelineId: string;
266
+ status: PipelineStatus;
267
+ } | {
268
+ type: "stage:status";
269
+ pipelineId: string;
270
+ stageName: PipelineStageName;
271
+ status: PipelineStageStatus;
272
+ output?: unknown;
273
+ criticFeedback?: unknown;
274
+ } | {
275
+ type: "pipeline:warning";
276
+ pipelineId: string;
277
+ code: string;
278
+ message: string;
279
+ } | {
280
+ type: "pipeline:done";
281
+ pipelineId: string;
282
+ } | {
283
+ type: "entity:status";
284
+ pipelineId: string;
285
+ entityId: string;
286
+ entityType: EntityType;
287
+ entityKey: string;
288
+ status: EntityStatus;
289
+ mainAssetUrl?: string;
290
+ } | {
291
+ type: "entity:variant:added";
292
+ pipelineId: string;
293
+ entityId: string;
294
+ variantKey: string;
295
+ assetUrl: string;
296
+ } | {
297
+ type: "scene:status";
298
+ pipelineId: string;
299
+ sceneEntityId: string;
300
+ sceneIndex: number;
301
+ status: EntityStatus;
302
+ shotCount?: number;
303
+ } | EntityStateChangeEvent | EntityStaleEvent | PipelineForkedEvent | PipelineDriftSummary | PipelineCompletedEvent | StageAwaitingSubGateEvent | PipelineMusicReadyEvent | PipelineEditorDecisionsReadyEvent | {
304
+ type: "chat:turn";
305
+ pipelineId: string;
306
+ stageName: PipelineStageName;
307
+ turn: {
308
+ id: string;
309
+ turn_n: number;
310
+ role: "user" | "assistant";
311
+ content: string;
312
+ proposed_change: ProposedChange | null;
313
+ };
314
+ } | {
315
+ type: "chat:proposal_applied";
316
+ pipelineId: string;
317
+ stageName: PipelineStageName;
318
+ turnId: string;
319
+ attemptId: string;
320
+ } | {
321
+ type: "shot:status";
322
+ pipelineId: string;
323
+ sceneId: string;
324
+ shotId: string;
325
+ status: "approved" | "failed";
326
+ } | {
327
+ type: "stage:progress";
328
+ pipelineId: string;
329
+ stageName: PipelineStageName;
330
+ message: string;
331
+ bytesSoFar?: number;
332
+ };
333
+
334
+ /** RFC 6902 JSON Patch operations. */
335
+ type JsonPatch = Operation[];
336
+ /**
337
+ * Response from the chat-refine-showrunner LLM specialist. Either includes a
338
+ * concrete proposed change the user can apply, or none (chat-only reply).
339
+ *
340
+ * Two variants:
341
+ * - 'edit_artifact': JSON Patch operations to apply to the current stage
342
+ * artifact (Script stage = ShowrunnerPlan).
343
+ * - 'suggest_branch': the LLM thinks a deeper change is needed — recommend
344
+ * the user use the Branch flow (1D.3) from this stage instead of trying
345
+ * to patch inline.
346
+ */
347
+ declare const ChatTurnResponseSchema: z.ZodObject<{
348
+ reply: z.ZodString;
349
+ proposed_change: z.ZodNullable<z.ZodDiscriminatedUnion<[z.ZodObject<{
350
+ change_type: z.ZodLiteral<"edit_artifact">;
351
+ json_patch: z.ZodArray<z.ZodObject<{
352
+ op: z.ZodEnum<{
353
+ replace: "replace";
354
+ add: "add";
355
+ remove: "remove";
356
+ }>;
357
+ path: z.ZodString;
358
+ value: z.ZodOptional<z.ZodUnknown>;
359
+ }, z.core.$strip>>;
360
+ summary: z.ZodString;
361
+ }, z.core.$strip>, z.ZodObject<{
362
+ change_type: z.ZodLiteral<"suggest_branch">;
363
+ from_stage: z.ZodEnum<{
364
+ characters: "characters";
365
+ script: "script";
366
+ objects: "objects";
367
+ locations: "locations";
368
+ animate_audio_edit: "animate_audio_edit";
369
+ scene_images: "scene_images";
370
+ shot_list: "shot_list";
371
+ }>;
372
+ reason: z.ZodString;
373
+ }, z.core.$strip>], "change_type">>;
374
+ }, z.core.$strip>;
375
+ type ChatTurnResponse = z.infer<typeof ChatTurnResponseSchema>;
376
+ type ProposedChange = NonNullable<ChatTurnResponse["proposed_change"]>;
377
+ /**
378
+ * Per-stage patch validation schema for `applyStageEdit`. Stages other than
379
+ * `script` don't have chat enabled in 1D.2b (per LLM spec v4.0 narrowing) —
380
+ * their entries are explicitly `null` to keep the type-check exhaustive when
381
+ * future stages are added.
382
+ */
383
+ declare const STAGE_PATCH_SCHEMA: Record<PipelineStageName, z.ZodTypeAny | null>;
384
+
385
+ declare const PIPELINE_TYPES: readonly ["story_to_video", "song_to_music_video"];
386
+ type PipelineType = (typeof PIPELINE_TYPES)[number];
387
+ declare const PIPELINE_FORMATS: readonly ["trailer", "short_film", "music_video", "reel", "commercial"];
388
+ type PipelineFormat = (typeof PIPELINE_FORMATS)[number];
389
+ declare const PIPELINE_MODES: readonly ["manual", "auto", "guided"];
390
+ type PipelineMode = (typeof PIPELINE_MODES)[number];
391
+ declare const PIPELINE_ACTIVATION_MODES: readonly ["interactive", "programmatic"];
392
+ type PipelineActivationMode = (typeof PIPELINE_ACTIVATION_MODES)[number];
393
+ declare const PIPELINE_OUTPUT_RESOLUTIONS: readonly ["480p", "720p", "1080p", "4K"];
394
+ type PipelineOutputResolution = (typeof PIPELINE_OUTPUT_RESOLUTIONS)[number];
395
+ declare const PER_FORMAT_DURATION_BOUNDS: Record<PipelineFormat, {
396
+ min: number;
397
+ max: number;
398
+ }>;
399
+ declare const GLOBAL_MAX_DURATION_SECONDS = 600;
400
+ declare function validateDurationForFormat(format: PipelineFormat, seconds: number): {
401
+ ok: true;
402
+ } | {
403
+ ok: false;
404
+ reason: string;
405
+ };
406
+ declare function validateModeActivation(mode: PipelineMode, activation: PipelineActivationMode): {
407
+ ok: true;
408
+ } | {
409
+ ok: false;
410
+ reason: string;
411
+ };
412
+ declare const TIER_PIPELINE_PARALLELISM: Record<string, number>;
413
+ declare const TIER_MAX_PIPELINE_COST_CREDITS: Record<string, number>;
414
+ declare const PIPELINE_STAGE_TIMEOUT_MS: number;
415
+ declare const PIPELINE_HARD_TIMEOUT_MS: number;
416
+ /**
417
+ * Per-stage hard retry caps applied to image-gen for that stage.
418
+ * Pipeline-level credit cap (max_cost_credits) is the ultimate guard, but
419
+ * these prevent a single stage from sucking all the budget.
420
+ */
421
+ declare const ENTITY_TOOL_RETRY_CAP = 3;
422
+ /**
423
+ * Default variant counts when ShowrunnerPlan doesn't suggest specifics.
424
+ */
425
+ declare const DEFAULT_CHARACTER_ANGLE_COUNT = 3;
426
+ declare const DEFAULT_CHARACTER_EXPRESSION_COUNT = 2;
427
+ /**
428
+ * Short-film lean reference set. A few-shot film can't meaningfully consume
429
+ * 5-8 reference variants per character: each shot is animated from exactly ONE
430
+ * reference image (the video providers accept a single reference and drop the
431
+ * rest — see `allocateReferenceSlots`), so the extra angle/expression variants
432
+ * are pure wall-clock + KIE load with ~no quality return. For films at or under
433
+ * the threshold we generate only main + 1 angle + 1 expression; longer films
434
+ * keep the full plan-driven variant set unchanged.
435
+ *
436
+ * Measured impact: the characters stage was the joint-largest time sink (≈27
437
+ * min for a 40 s film — 23 character images at ~58 s each on KIE). Capping a
438
+ * ≤2 min film to 2 variants/character cuts that to ~12 images.
439
+ */
440
+ declare const SHORT_FILM_VARIANT_THRESHOLD_SEC = 120;
441
+ declare const SHORT_FILM_ANGLE_COUNT = 2;
442
+ declare const SHORT_FILM_EXPRESSION_COUNT = 1;
443
+ /**
444
+ * Max location variants generated even if Showrunner suggests more — cost guard.
445
+ */
446
+ declare const MAX_LOCATION_VARIANTS = 4;
447
+ /**
448
+ * Maximum user-turn count per stage for the chat refine flow. Enforced by
449
+ * the chat POST route (counts existing `role='user'` rows and rejects when
450
+ * the cap is reached). 1D.2b ships **Script chat only** per the LLM Spec
451
+ * v4.0 narrowing — `shot_list` + `post_merge` caps are pre-declared so
452
+ * adding their chat surfaces in 1D.2d only needs route+UI wiring, not a
453
+ * type/constant change.
454
+ */
455
+ declare const CHAT_TURN_CAPS: {
456
+ readonly script: 20;
457
+ readonly shot_list: 15;
458
+ readonly post_merge: 8;
459
+ };
460
+ /**
461
+ * Pipeline entity error code emitted by Phase 1D.2c-a image critics
462
+ * (Stage 2 Characters + Stage 4 Locations) and any future image-level
463
+ * validators. Constant lets the frontend compare equality (not substring)
464
+ * and the backend writes a single canonical value.
465
+ *
466
+ * Written to `pipeline_entities.metadata.last_error` after the critic retry
467
+ * cap exhausts. Auto-mode's failure-aggregator (`detectImageCriticFailures`
468
+ * + `failPipelineForImageCriticUnresolvable`) reads this exact value.
469
+ */
470
+ declare const IMAGE_CRITIC_UNRESOLVABLE = "image_critic_unresolvable";
471
+ /**
472
+ * Maximum critic-feedback retry budget per entity in Phase 1D.2c-a image
473
+ * critics. Each fail triggers a regeneration with critic suggestions injected
474
+ * into the prompt; after this many retries the entity is marked failed and
475
+ * surfaces in EntityCard with recovery buttons.
476
+ */
477
+ declare const IMAGE_CRITIC_MAX_RETRIES = 2;
478
+ /**
479
+ * Score threshold below which the critic's verdict is overridden to "fail"
480
+ * regardless of the verdict field. Defends against an overly lenient critic
481
+ * that says verdict='pass' on a borderline image. The numeric score (0-10)
482
+ * is enforced by the schema and the system prompt anchors the meaning.
483
+ */
484
+ declare const IMAGE_CRITIC_MIN_ADHERENCE_SCORE = 5;
485
+ /**
486
+ * Metadata keys written by the image-critic retry loop (Phase 1D.2c-a)
487
+ * onto `pipeline_entities.metadata` when an entity's critic budget is
488
+ * exhausted. The retry-image-generation route clears these to reset the
489
+ * entity to a fresh attempt; EntityCard reads them to render findings +
490
+ * the failed image.
491
+ *
492
+ * Single source of truth so the writer (`_image-critic-loop.ts`) and the
493
+ * clearer (`routes/pipelines.ts:retry-image-generation`) can't drift.
494
+ */
495
+ declare const IMAGE_CRITIC_METADATA_KEYS: readonly ["last_error", "last_error_at", "critic_findings", "last_attempted_image_url", "last_attempted_asset_id", "image_critic_retry_count"];
496
+ type ImageCriticMetadataKey = (typeof IMAGE_CRITIC_METADATA_KEYS)[number];
497
+ /**
498
+ * Removes every {@link IMAGE_CRITIC_METADATA_KEYS} entry from a metadata
499
+ * blob, returning a shallow copy. Used by the retry-image-generation route
500
+ * to wipe critic-only state while preserving everything else (`name`,
501
+ * `voice_match`, `reject_count`, etc.).
502
+ */
503
+ declare function clearImageCriticMetadata(meta: Record<string, unknown> | null | undefined): Record<string, unknown>;
504
+ /**
505
+ * Phase 1D.2c-b-ii — Video Critic frame extraction modes.
506
+ * Each pipeline picks one via PipelineInput.video_critic_frame_count.
507
+ * Default 'first_last' uses the input keyframe + extractLastFrame output
508
+ * (both already produced by Stage 6 + extractLastFrame call), so no new
509
+ * frame extractions are needed in the default case.
510
+ */
511
+ declare const VIDEO_CRITIC_FRAME_MODES: readonly ["first_last", "first_middle_last", "five_evenly"];
512
+ type VideoCriticFrameMode = (typeof VIDEO_CRITIC_FRAME_MODES)[number];
513
+ /**
514
+ * Credits the pipeline's upfront estimate reserves per shot for the Video
515
+ * Critic, by frame mode — a worst case; what goes unused is refunded when the
516
+ * pipeline completes. The config panel quotes these as "up to N credits per
517
+ * shot". The server derives its reservation separately, and a test there
518
+ * fails when the two disagree (they drifted ten-fold across a credit
519
+ * re-denomination while the panel still read ~2 / ~3 / ~4).
520
+ */
521
+ declare const VIDEO_CRITIC_RESERVED_CREDITS_PER_SHOT: Readonly<Record<VideoCriticFrameMode, number>>;
522
+ /** Cap=1 retry per shot — cost-aware (every retry is a full paid video
523
+ * generation, the priciest step in the loop). */
524
+ declare const VIDEO_CRITIC_MAX_RETRIES = 1;
525
+ /** Auto-fail threshold for both prompt_adherence_score and continuity_score. */
526
+ declare const VIDEO_CRITIC_MIN_ADHERENCE_SCORE = 5;
527
+ /**
528
+ * Phase 1D.2c-b-ii — Video Critic ShotSpec sibling field names that get
529
+ * persisted by the per-shot retry loop (`runVideoCriticLoopForShot` in
530
+ * `scene-internal-pipeline.ts`) and stripped by the retry-video-generation
531
+ * recovery route + the frontend Regenerate button.
532
+ *
533
+ * Single source of truth so the writer + clearer can't drift. Mirror of
534
+ * {@link IMAGE_CRITIC_METADATA_KEYS} for the entity-level image critic.
535
+ */
536
+ declare const VIDEO_CRITIC_METADATA_KEYS: readonly ["video_critic_findings", "video_critic_score", "video_critic_continuity_score", "video_critic_identified_action", "video_critic_retry_count", "video_critic_last_attempted_url", "video_critic_failed", "video_critic_verdict"];
537
+ type VideoCriticMetadataKey = (typeof VIDEO_CRITIC_METADATA_KEYS)[number];
538
+ /**
539
+ * Returns a shallow copy of `shot` with all `video_critic_*` keys stripped.
540
+ * Used by the retry-video-generation route + frontend Regenerate handler to
541
+ * reset a shot to a fresh critic attempt while preserving everything else
542
+ * (camera, action, motion_prompt, …).
543
+ */
544
+ declare function clearVideoCriticMetadata<T extends Record<string, unknown>>(shot: T): Omit<T, VideoCriticMetadataKey>;
545
+ /**
546
+ * Phase 1D.2 — single source of truth for chat-stage configuration.
547
+ *
548
+ * `wired: true` = the route has a specialist implemented + the LLM emits
549
+ * valid `ChatTurnResponse` for this stage's artifact.
550
+ * `wired: false` = stage is in the v0.5 spec but not yet implemented
551
+ * (the chat POST returns HTTP 501 `chat_not_wired_for_stage`).
552
+ *
553
+ * Per spec §5.12 v0.5: `script` + `shot_list` + `post_merge`.
554
+ *
555
+ * - `script`: wired in 1D.2b (chat-refine-showrunner)
556
+ * - `post_merge`: wired in 1D.2c (chat-refine-postmerge; suggest_branch only)
557
+ * - `shot_list`: pre-declared, ships in 1D.2d (blocked by v4.0 per-scene
558
+ * architecture)
559
+ *
560
+ * Prefer reading `CHAT_STAGES[stage].wired` directly in new code; the
561
+ * sibling `CHAT_ENABLED_STAGES` / `CHAT_WIRED_STAGES` exports below are
562
+ * derived and remain for backward compatibility with existing call sites.
563
+ */
564
+ declare const CHAT_STAGES: {
565
+ readonly script: {
566
+ readonly wired: true;
567
+ };
568
+ readonly shot_list: {
569
+ readonly wired: false;
570
+ };
571
+ readonly post_merge: {
572
+ readonly wired: true;
573
+ };
574
+ };
575
+ type ChatEnabledStage = keyof typeof CHAT_STAGES;
576
+ /**
577
+ * Ordered list of stages with chat enabled. Derived from {@link CHAT_STAGES}.
578
+ * **In 1D.2c, `script` AND `post_merge` have chat code paths wired** —
579
+ * post-merge ships with a dedicated `chat-refine-postmerge` specialist
580
+ * (suggest_branch only — see {@link STAGE_PATCH_SCHEMA}, `post_merge` stays
581
+ * `null` since the merged video isn't user-editable in place). `shot_list`
582
+ * is pre-declared for 1D.2d. The route's chat dispatch checks
583
+ * {@link CHAT_WIRED_STAGES} to decide which specialist to invoke (or 501
584
+ * for unwired stages).
585
+ */
586
+ declare const CHAT_ENABLED_STAGES: readonly ChatEnabledStage[];
587
+ /**
588
+ * Per-stage boolean map of whether chat code paths are actually wired
589
+ * end-to-end. Derived from {@link CHAT_STAGES}. The chat POST route reads
590
+ * this to decide whether to invoke a specialist (true) or return 501
591
+ * `chat_not_wired_for_stage` (false).
592
+ */
593
+ declare const CHAT_WIRED_STAGES: Record<ChatEnabledStage, boolean>;
594
+
595
+ declare const StyleDirectivesSchema: z.ZodObject<{
596
+ visualStyle: z.ZodOptional<z.ZodString>;
597
+ colorPalette: z.ZodOptional<z.ZodString>;
598
+ lighting: z.ZodOptional<z.ZodString>;
599
+ cameraLanguage: z.ZodOptional<z.ZodString>;
600
+ avoid: z.ZodOptional<z.ZodString>;
601
+ }, z.core.$strip>;
602
+ type StyleDirectives = z.infer<typeof StyleDirectivesSchema>;
603
+ declare const PIPELINE_MODEL_STAGES: readonly ["characters_image", "locations_image", "objects_image", "scene_keyframes_image", "shots_video", "script_llm"];
604
+ type PipelineModelStage = (typeof PIPELINE_MODEL_STAGES)[number];
605
+ declare const PIPELINE_PINNABLE_IMAGE_MODELS: readonly ["nano-banana", "nano-banana-pro", "nano-banana-2-1", "flux", "gpt-image", "gpt-image-2", "gpt-image-2-5-flare", "gpt-image-2-5-sunburst"];
606
+ type PipelinePinnableImageModel = (typeof PIPELINE_PINNABLE_IMAGE_MODELS)[number];
607
+ declare const PIPELINE_LEGACY_PINNED_IMAGE_MODELS: readonly ["nano-banana-2"];
608
+ /** Every image model a pipeline's config may name: the offered pins plus the legacy ones. */
609
+ declare const PIPELINE_ACCEPTED_IMAGE_MODELS: readonly ["nano-banana", "nano-banana-pro", "nano-banana-2-1", "flux", "gpt-image", "gpt-image-2", "gpt-image-2-5-flare", "gpt-image-2-5-sunburst", "nano-banana-2"];
610
+ declare const PIPELINE_PINNABLE_VIDEO_MODELS: readonly ["kling-turbo", "kling", "kling-3.0", "seedance", "seedance-2", "seedance-2-fast", "seedance-2-mini", "seedance-2-5", "veo3", "veo3.1", "veo3_lite", "minimax", "hailuo-standard", "wan-turbo", "bytedance-lite", "bytedance-pro"];
611
+ type PipelinePinnableVideoModel = (typeof PIPELINE_PINNABLE_VIDEO_MODELS)[number];
612
+ declare const PIPELINE_PINNABLE_SCRIPT_LLMS: readonly ["claude-haiku-5-5", "claude-sonnet-4-6", "claude-opus-4-7", "claude-opus-5"];
613
+ declare const PIPELINE_LEGACY_PINNED_SCRIPT_LLMS: readonly ["claude-haiku-4-5"];
614
+ /** Every script LLM a pipeline's config may name: the offered pins plus the legacy ones. */
615
+ declare const PIPELINE_ACCEPTED_SCRIPT_LLMS: readonly ["claude-haiku-5-5", "claude-sonnet-4-6", "claude-opus-4-7", "claude-opus-5", "claude-haiku-4-5"];
616
+ /** A script LLM a pipeline config may carry — an offered pin or a legacy one a saved pipeline still names. */
617
+ type PipelinePinnableScriptLlm = (typeof PIPELINE_ACCEPTED_SCRIPT_LLMS)[number];
618
+ declare const PipelineConfigSchema: z.ZodObject<{
619
+ music_enabled: z.ZodDefault<z.ZodBoolean>;
620
+ narration_enabled: z.ZodDefault<z.ZodBoolean>;
621
+ lipsync_enabled: z.ZodDefault<z.ZodBoolean>;
622
+ freecut_export_enabled: z.ZodDefault<z.ZodBoolean>;
623
+ freecut_export_format: z.ZodDefault<z.ZodEnum<{
624
+ json: "json";
625
+ fcpxml: "fcpxml";
626
+ }>>;
627
+ shot_generation_mode: z.ZodDefault<z.ZodEnum<{
628
+ parallel: "parallel";
629
+ sequential: "sequential";
630
+ }>>;
631
+ silent_cut_review: z.ZodDefault<z.ZodBoolean>;
632
+ skip_script_critic: z.ZodDefault<z.ZodBoolean>;
633
+ auto_advance_production: z.ZodDefault<z.ZodBoolean>;
634
+ force_parallel_animate: z.ZodDefault<z.ZodBoolean>;
635
+ image_model: z.ZodOptional<z.ZodEnum<{
636
+ "gpt-image-2": "gpt-image-2";
637
+ "gpt-image-2-5-flare": "gpt-image-2-5-flare";
638
+ "gpt-image-2-5-sunburst": "gpt-image-2-5-sunburst";
639
+ "nano-banana": "nano-banana";
640
+ "nano-banana-2": "nano-banana-2";
641
+ "nano-banana-2-1": "nano-banana-2-1";
642
+ "nano-banana-pro": "nano-banana-pro";
643
+ flux: "flux";
644
+ "gpt-image": "gpt-image";
645
+ }>>;
646
+ video_model: z.ZodOptional<z.ZodEnum<{
647
+ "seedance-2-5": "seedance-2-5";
648
+ minimax: "minimax";
649
+ veo3: "veo3";
650
+ "kling-3.0": "kling-3.0";
651
+ "seedance-2": "seedance-2";
652
+ "veo3.1": "veo3.1";
653
+ "wan-turbo": "wan-turbo";
654
+ "bytedance-lite": "bytedance-lite";
655
+ "kling-turbo": "kling-turbo";
656
+ "hailuo-standard": "hailuo-standard";
657
+ veo3_lite: "veo3_lite";
658
+ kling: "kling";
659
+ seedance: "seedance";
660
+ "seedance-2-fast": "seedance-2-fast";
661
+ "seedance-2-mini": "seedance-2-mini";
662
+ "bytedance-pro": "bytedance-pro";
663
+ }>>;
664
+ music_model: z.ZodOptional<z.ZodString>;
665
+ script_llm: z.ZodOptional<z.ZodEnum<{
666
+ "claude-haiku-4-5": "claude-haiku-4-5";
667
+ "claude-haiku-5-5": "claude-haiku-5-5";
668
+ "claude-sonnet-4-6": "claude-sonnet-4-6";
669
+ "claude-opus-4-7": "claude-opus-4-7";
670
+ "claude-opus-5": "claude-opus-5";
671
+ }>>;
672
+ stage_models: z.ZodOptional<z.ZodObject<{
673
+ characters_image: z.ZodOptional<z.ZodEnum<{
674
+ "gpt-image-2": "gpt-image-2";
675
+ "gpt-image-2-5-flare": "gpt-image-2-5-flare";
676
+ "gpt-image-2-5-sunburst": "gpt-image-2-5-sunburst";
677
+ "nano-banana": "nano-banana";
678
+ "nano-banana-2": "nano-banana-2";
679
+ "nano-banana-2-1": "nano-banana-2-1";
680
+ "nano-banana-pro": "nano-banana-pro";
681
+ flux: "flux";
682
+ "gpt-image": "gpt-image";
683
+ }>>;
684
+ locations_image: z.ZodOptional<z.ZodEnum<{
685
+ "gpt-image-2": "gpt-image-2";
686
+ "gpt-image-2-5-flare": "gpt-image-2-5-flare";
687
+ "gpt-image-2-5-sunburst": "gpt-image-2-5-sunburst";
688
+ "nano-banana": "nano-banana";
689
+ "nano-banana-2": "nano-banana-2";
690
+ "nano-banana-2-1": "nano-banana-2-1";
691
+ "nano-banana-pro": "nano-banana-pro";
692
+ flux: "flux";
693
+ "gpt-image": "gpt-image";
694
+ }>>;
695
+ objects_image: z.ZodOptional<z.ZodEnum<{
696
+ "gpt-image-2": "gpt-image-2";
697
+ "gpt-image-2-5-flare": "gpt-image-2-5-flare";
698
+ "gpt-image-2-5-sunburst": "gpt-image-2-5-sunburst";
699
+ "nano-banana": "nano-banana";
700
+ "nano-banana-2": "nano-banana-2";
701
+ "nano-banana-2-1": "nano-banana-2-1";
702
+ "nano-banana-pro": "nano-banana-pro";
703
+ flux: "flux";
704
+ "gpt-image": "gpt-image";
705
+ }>>;
706
+ scene_keyframes_image: z.ZodOptional<z.ZodEnum<{
707
+ "gpt-image-2": "gpt-image-2";
708
+ "gpt-image-2-5-flare": "gpt-image-2-5-flare";
709
+ "gpt-image-2-5-sunburst": "gpt-image-2-5-sunburst";
710
+ "nano-banana": "nano-banana";
711
+ "nano-banana-2": "nano-banana-2";
712
+ "nano-banana-2-1": "nano-banana-2-1";
713
+ "nano-banana-pro": "nano-banana-pro";
714
+ flux: "flux";
715
+ "gpt-image": "gpt-image";
716
+ }>>;
717
+ shots_video: z.ZodOptional<z.ZodEnum<{
718
+ "seedance-2-5": "seedance-2-5";
719
+ minimax: "minimax";
720
+ veo3: "veo3";
721
+ "kling-3.0": "kling-3.0";
722
+ "seedance-2": "seedance-2";
723
+ "veo3.1": "veo3.1";
724
+ "wan-turbo": "wan-turbo";
725
+ "bytedance-lite": "bytedance-lite";
726
+ "kling-turbo": "kling-turbo";
727
+ "hailuo-standard": "hailuo-standard";
728
+ veo3_lite: "veo3_lite";
729
+ kling: "kling";
730
+ seedance: "seedance";
731
+ "seedance-2-fast": "seedance-2-fast";
732
+ "seedance-2-mini": "seedance-2-mini";
733
+ "bytedance-pro": "bytedance-pro";
734
+ }>>;
735
+ script_llm: z.ZodOptional<z.ZodEnum<{
736
+ "claude-haiku-4-5": "claude-haiku-4-5";
737
+ "claude-haiku-5-5": "claude-haiku-5-5";
738
+ "claude-sonnet-4-6": "claude-sonnet-4-6";
739
+ "claude-opus-4-7": "claude-opus-4-7";
740
+ "claude-opus-5": "claude-opus-5";
741
+ }>>;
742
+ }, z.core.$strip>>;
743
+ }, z.core.$strip>;
744
+ type PipelineConfig = z.infer<typeof PipelineConfigSchema>;
745
+ /**
746
+ * Resolve which model a given stage should use, following the precedence:
747
+ * 1. `config.stage_models[stage]` — user's per-stage override
748
+ * 2. `config.<kind>_model` (or `config.script_llm`) — user's global pick
749
+ * 3. `undefined` — caller falls back to its own default (LLM picks, or hardcode)
750
+ *
751
+ * Returns `undefined` (not `null`) so callers can use `??` chains cleanly.
752
+ */
753
+ declare function resolvePipelineModel(config: PipelineConfig | Partial<PipelineConfig> | null | undefined, stage: PipelineModelStage): string | undefined;
754
+ declare const PipelineInputSchema: z.ZodObject<{
755
+ pipeline_type: z.ZodDefault<z.ZodEnum<{
756
+ story_to_video: "story_to_video";
757
+ song_to_music_video: "song_to_music_video";
758
+ }>>;
759
+ workflow_id: z.ZodOptional<z.ZodString>;
760
+ root_node_id: z.ZodString;
761
+ story_prompt: z.ZodString;
762
+ target_duration_seconds: z.ZodNumber;
763
+ format: z.ZodEnum<{
764
+ trailer: "trailer";
765
+ short_film: "short_film";
766
+ music_video: "music_video";
767
+ reel: "reel";
768
+ commercial: "commercial";
769
+ }>;
770
+ output_resolution: z.ZodDefault<z.ZodEnum<{
771
+ "480p": "480p";
772
+ "1080p": "1080p";
773
+ "4K": "4K";
774
+ "720p": "720p";
775
+ }>>;
776
+ language: z.ZodDefault<z.ZodString>;
777
+ mode: z.ZodDefault<z.ZodEnum<{
778
+ manual: "manual";
779
+ auto: "auto";
780
+ guided: "guided";
781
+ }>>;
782
+ auto_mode: z.ZodOptional<z.ZodBoolean>;
783
+ style_directives: z.ZodOptional<z.ZodObject<{
784
+ visualStyle: z.ZodOptional<z.ZodString>;
785
+ colorPalette: z.ZodOptional<z.ZodString>;
786
+ lighting: z.ZodOptional<z.ZodString>;
787
+ cameraLanguage: z.ZodOptional<z.ZodString>;
788
+ avoid: z.ZodOptional<z.ZodString>;
789
+ }, z.core.$strip>>;
790
+ config: z.ZodOptional<z.ZodObject<{
791
+ music_enabled: z.ZodOptional<z.ZodDefault<z.ZodBoolean>>;
792
+ narration_enabled: z.ZodOptional<z.ZodDefault<z.ZodBoolean>>;
793
+ lipsync_enabled: z.ZodOptional<z.ZodDefault<z.ZodBoolean>>;
794
+ freecut_export_enabled: z.ZodOptional<z.ZodDefault<z.ZodBoolean>>;
795
+ freecut_export_format: z.ZodOptional<z.ZodDefault<z.ZodEnum<{
796
+ json: "json";
797
+ fcpxml: "fcpxml";
798
+ }>>>;
799
+ shot_generation_mode: z.ZodOptional<z.ZodDefault<z.ZodEnum<{
800
+ parallel: "parallel";
801
+ sequential: "sequential";
802
+ }>>>;
803
+ silent_cut_review: z.ZodOptional<z.ZodDefault<z.ZodBoolean>>;
804
+ skip_script_critic: z.ZodOptional<z.ZodDefault<z.ZodBoolean>>;
805
+ auto_advance_production: z.ZodOptional<z.ZodDefault<z.ZodBoolean>>;
806
+ force_parallel_animate: z.ZodOptional<z.ZodDefault<z.ZodBoolean>>;
807
+ image_model: z.ZodOptional<z.ZodOptional<z.ZodEnum<{
808
+ "gpt-image-2": "gpt-image-2";
809
+ "gpt-image-2-5-flare": "gpt-image-2-5-flare";
810
+ "gpt-image-2-5-sunburst": "gpt-image-2-5-sunburst";
811
+ "nano-banana": "nano-banana";
812
+ "nano-banana-2": "nano-banana-2";
813
+ "nano-banana-2-1": "nano-banana-2-1";
814
+ "nano-banana-pro": "nano-banana-pro";
815
+ flux: "flux";
816
+ "gpt-image": "gpt-image";
817
+ }>>>;
818
+ video_model: z.ZodOptional<z.ZodOptional<z.ZodEnum<{
819
+ "seedance-2-5": "seedance-2-5";
820
+ minimax: "minimax";
821
+ veo3: "veo3";
822
+ "kling-3.0": "kling-3.0";
823
+ "seedance-2": "seedance-2";
824
+ "veo3.1": "veo3.1";
825
+ "wan-turbo": "wan-turbo";
826
+ "bytedance-lite": "bytedance-lite";
827
+ "kling-turbo": "kling-turbo";
828
+ "hailuo-standard": "hailuo-standard";
829
+ veo3_lite: "veo3_lite";
830
+ kling: "kling";
831
+ seedance: "seedance";
832
+ "seedance-2-fast": "seedance-2-fast";
833
+ "seedance-2-mini": "seedance-2-mini";
834
+ "bytedance-pro": "bytedance-pro";
835
+ }>>>;
836
+ music_model: z.ZodOptional<z.ZodOptional<z.ZodString>>;
837
+ script_llm: z.ZodOptional<z.ZodOptional<z.ZodEnum<{
838
+ "claude-haiku-4-5": "claude-haiku-4-5";
839
+ "claude-haiku-5-5": "claude-haiku-5-5";
840
+ "claude-sonnet-4-6": "claude-sonnet-4-6";
841
+ "claude-opus-4-7": "claude-opus-4-7";
842
+ "claude-opus-5": "claude-opus-5";
843
+ }>>>;
844
+ stage_models: z.ZodOptional<z.ZodOptional<z.ZodObject<{
845
+ characters_image: z.ZodOptional<z.ZodEnum<{
846
+ "gpt-image-2": "gpt-image-2";
847
+ "gpt-image-2-5-flare": "gpt-image-2-5-flare";
848
+ "gpt-image-2-5-sunburst": "gpt-image-2-5-sunburst";
849
+ "nano-banana": "nano-banana";
850
+ "nano-banana-2": "nano-banana-2";
851
+ "nano-banana-2-1": "nano-banana-2-1";
852
+ "nano-banana-pro": "nano-banana-pro";
853
+ flux: "flux";
854
+ "gpt-image": "gpt-image";
855
+ }>>;
856
+ locations_image: z.ZodOptional<z.ZodEnum<{
857
+ "gpt-image-2": "gpt-image-2";
858
+ "gpt-image-2-5-flare": "gpt-image-2-5-flare";
859
+ "gpt-image-2-5-sunburst": "gpt-image-2-5-sunburst";
860
+ "nano-banana": "nano-banana";
861
+ "nano-banana-2": "nano-banana-2";
862
+ "nano-banana-2-1": "nano-banana-2-1";
863
+ "nano-banana-pro": "nano-banana-pro";
864
+ flux: "flux";
865
+ "gpt-image": "gpt-image";
866
+ }>>;
867
+ objects_image: z.ZodOptional<z.ZodEnum<{
868
+ "gpt-image-2": "gpt-image-2";
869
+ "gpt-image-2-5-flare": "gpt-image-2-5-flare";
870
+ "gpt-image-2-5-sunburst": "gpt-image-2-5-sunburst";
871
+ "nano-banana": "nano-banana";
872
+ "nano-banana-2": "nano-banana-2";
873
+ "nano-banana-2-1": "nano-banana-2-1";
874
+ "nano-banana-pro": "nano-banana-pro";
875
+ flux: "flux";
876
+ "gpt-image": "gpt-image";
877
+ }>>;
878
+ scene_keyframes_image: z.ZodOptional<z.ZodEnum<{
879
+ "gpt-image-2": "gpt-image-2";
880
+ "gpt-image-2-5-flare": "gpt-image-2-5-flare";
881
+ "gpt-image-2-5-sunburst": "gpt-image-2-5-sunburst";
882
+ "nano-banana": "nano-banana";
883
+ "nano-banana-2": "nano-banana-2";
884
+ "nano-banana-2-1": "nano-banana-2-1";
885
+ "nano-banana-pro": "nano-banana-pro";
886
+ flux: "flux";
887
+ "gpt-image": "gpt-image";
888
+ }>>;
889
+ shots_video: z.ZodOptional<z.ZodEnum<{
890
+ "seedance-2-5": "seedance-2-5";
891
+ minimax: "minimax";
892
+ veo3: "veo3";
893
+ "kling-3.0": "kling-3.0";
894
+ "seedance-2": "seedance-2";
895
+ "veo3.1": "veo3.1";
896
+ "wan-turbo": "wan-turbo";
897
+ "bytedance-lite": "bytedance-lite";
898
+ "kling-turbo": "kling-turbo";
899
+ "hailuo-standard": "hailuo-standard";
900
+ veo3_lite: "veo3_lite";
901
+ kling: "kling";
902
+ seedance: "seedance";
903
+ "seedance-2-fast": "seedance-2-fast";
904
+ "seedance-2-mini": "seedance-2-mini";
905
+ "bytedance-pro": "bytedance-pro";
906
+ }>>;
907
+ script_llm: z.ZodOptional<z.ZodEnum<{
908
+ "claude-haiku-4-5": "claude-haiku-4-5";
909
+ "claude-haiku-5-5": "claude-haiku-5-5";
910
+ "claude-sonnet-4-6": "claude-sonnet-4-6";
911
+ "claude-opus-4-7": "claude-opus-4-7";
912
+ "claude-opus-5": "claude-opus-5";
913
+ }>>;
914
+ }, z.core.$strip>>>;
915
+ }, z.core.$strip>>;
916
+ max_cost_credits: z.ZodOptional<z.ZodNumber>;
917
+ video_critic_frame_count: z.ZodDefault<z.ZodEnum<{
918
+ first_last: "first_last";
919
+ first_middle_last: "first_middle_last";
920
+ five_evenly: "five_evenly";
921
+ }>>;
922
+ }, z.core.$strip>;
923
+ type PipelineInput = z.infer<typeof PipelineInputSchema>;
924
+ declare const DetectionResultSchema: z.ZodObject<{
925
+ characters: z.ZodArray<z.ZodObject<{
926
+ key: z.ZodString;
927
+ name: z.ZodString;
928
+ visual_description: z.ZodString;
929
+ role_hint: z.ZodEnum<{
930
+ protagonist: "protagonist";
931
+ antagonist: "antagonist";
932
+ supporting: "supporting";
933
+ cameo: "cameo";
934
+ }>;
935
+ has_dialogue_hint: z.ZodBoolean;
936
+ }, z.core.$strip>>;
937
+ objects: z.ZodArray<z.ZodObject<{
938
+ key: z.ZodString;
939
+ name: z.ZodString;
940
+ visual_description: z.ZodString;
941
+ narrative_significance: z.ZodString;
942
+ }, z.core.$strip>>;
943
+ locations: z.ZodArray<z.ZodObject<{
944
+ key: z.ZodString;
945
+ name: z.ZodString;
946
+ visual_description: z.ZodString;
947
+ parent_location_key: z.ZodNullable<z.ZodString>;
948
+ variant_kind: z.ZodNullable<z.ZodEnum<{
949
+ weather: "weather";
950
+ time_of_day: "time_of_day";
951
+ main: "main";
952
+ aftermath: "aftermath";
953
+ }>>;
954
+ }, z.core.$strip>>;
955
+ audio_intent: z.ZodObject<{
956
+ has_narrator: z.ZodBoolean;
957
+ narrator_profile_hint: z.ZodNullable<z.ZodString>;
958
+ dialogue_speaker_keys: z.ZodArray<z.ZodString>;
959
+ music: z.ZodObject<{
960
+ mood_hint: z.ZodString;
961
+ bpm_hint: z.ZodNumber;
962
+ genre_hints: z.ZodArray<z.ZodString>;
963
+ }, z.core.$strip>;
964
+ sfx_hints: z.ZodArray<z.ZodString>;
965
+ }, z.core.$strip>;
966
+ }, z.core.$strip>;
967
+ type DetectionResult = z.infer<typeof DetectionResultSchema>;
968
+ declare const EMOTIONAL_BEAT: z.ZodEnum<{
969
+ reveal: "reveal";
970
+ setup: "setup";
971
+ inciting: "inciting";
972
+ rising: "rising";
973
+ tension: "tension";
974
+ climax: "climax";
975
+ release: "release";
976
+ denouement: "denouement";
977
+ shock: "shock";
978
+ release_humor: "release_humor";
979
+ reflection: "reflection";
980
+ }>;
981
+ declare const SceneSpecSchema: z.ZodObject<{
982
+ scene_index: z.ZodNumber;
983
+ description: z.ZodString;
984
+ emotional_beat: z.ZodEnum<{
985
+ reveal: "reveal";
986
+ setup: "setup";
987
+ inciting: "inciting";
988
+ rising: "rising";
989
+ tension: "tension";
990
+ climax: "climax";
991
+ release: "release";
992
+ denouement: "denouement";
993
+ shock: "shock";
994
+ release_humor: "release_humor";
995
+ reflection: "reflection";
996
+ }>;
997
+ duration_seconds: z.ZodNumber;
998
+ cast_keys: z.ZodArray<z.ZodString>;
999
+ location_key: z.ZodString;
1000
+ object_keys: z.ZodArray<z.ZodString>;
1001
+ dialogue: z.ZodDefault<z.ZodArray<z.ZodObject<{
1002
+ cast_key: z.ZodString;
1003
+ line: z.ZodString;
1004
+ }, z.core.$strip>>>;
1005
+ narration: z.ZodNullable<z.ZodString>;
1006
+ continuity_from_prev: z.ZodEnum<{
1007
+ dissolve: "dissolve";
1008
+ hard_cut: "hard_cut";
1009
+ match_last_frame: "match_last_frame";
1010
+ }>;
1011
+ shot_count_hint: z.ZodNumber;
1012
+ }, z.core.$strip>;
1013
+ declare const ShowrunnerPlanSchema: z.ZodObject<{
1014
+ title: z.ZodString;
1015
+ logline: z.ZodString;
1016
+ target_duration_seconds: z.ZodNumber;
1017
+ format: z.ZodEnum<{
1018
+ trailer: "trailer";
1019
+ short_film: "short_film";
1020
+ music_video: "music_video";
1021
+ reel: "reel";
1022
+ commercial: "commercial";
1023
+ }>;
1024
+ output_resolution: z.ZodEnum<{
1025
+ "480p": "480p";
1026
+ "1080p": "1080p";
1027
+ "4K": "4K";
1028
+ "720p": "720p";
1029
+ }>;
1030
+ language: z.ZodString;
1031
+ genre: z.ZodEnum<{
1032
+ "sci-fi": "sci-fi";
1033
+ action: "action";
1034
+ drama: "drama";
1035
+ thriller: "thriller";
1036
+ comedy: "comedy";
1037
+ horror: "horror";
1038
+ documentary: "documentary";
1039
+ }>;
1040
+ tone: z.ZodArray<z.ZodEnum<{
1041
+ warm: "warm";
1042
+ gritty: "gritty";
1043
+ hopeful: "hopeful";
1044
+ tense: "tense";
1045
+ melancholic: "melancholic";
1046
+ playful: "playful";
1047
+ epic: "epic";
1048
+ intimate: "intimate";
1049
+ surreal: "surreal";
1050
+ nostalgic: "nostalgic";
1051
+ urgent: "urgent";
1052
+ dreamy: "dreamy";
1053
+ cold: "cold";
1054
+ menacing: "menacing";
1055
+ whimsical: "whimsical";
1056
+ somber: "somber";
1057
+ triumphant: "triumphant";
1058
+ eerie: "eerie";
1059
+ }>>;
1060
+ cast: z.ZodArray<z.ZodObject<{
1061
+ key: z.ZodString;
1062
+ name: z.ZodString;
1063
+ role: z.ZodEnum<{
1064
+ protagonist: "protagonist";
1065
+ antagonist: "antagonist";
1066
+ supporting: "supporting";
1067
+ cameo: "cameo";
1068
+ }>;
1069
+ visual_description: z.ZodString;
1070
+ voice_profile: z.ZodString;
1071
+ has_dialogue: z.ZodBoolean;
1072
+ angle_count_hint: z.ZodNumber;
1073
+ expression_set_hint: z.ZodDefault<z.ZodArray<z.ZodEnum<{
1074
+ neutral: "neutral";
1075
+ angry: "angry";
1076
+ surprised: "surprised";
1077
+ sad: "sad";
1078
+ laughing: "laughing";
1079
+ crying: "crying";
1080
+ smiling: "smiling";
1081
+ scared: "scared";
1082
+ determined: "determined";
1083
+ thoughtful: "thoughtful";
1084
+ }>>>;
1085
+ }, z.core.$strip>>;
1086
+ locations: z.ZodArray<z.ZodObject<{
1087
+ key: z.ZodString;
1088
+ name: z.ZodString;
1089
+ visual_description: z.ZodString;
1090
+ variants_needed: z.ZodDefault<z.ZodArray<z.ZodString>>;
1091
+ }, z.core.$strip>>;
1092
+ objects: z.ZodArray<z.ZodObject<{
1093
+ key: z.ZodString;
1094
+ name: z.ZodString;
1095
+ visual_description: z.ZodString;
1096
+ narrative_significance: z.ZodString;
1097
+ }, z.core.$strip>>;
1098
+ scenes: z.ZodArray<z.ZodObject<{
1099
+ scene_index: z.ZodNumber;
1100
+ description: z.ZodString;
1101
+ emotional_beat: z.ZodEnum<{
1102
+ reveal: "reveal";
1103
+ setup: "setup";
1104
+ inciting: "inciting";
1105
+ rising: "rising";
1106
+ tension: "tension";
1107
+ climax: "climax";
1108
+ release: "release";
1109
+ denouement: "denouement";
1110
+ shock: "shock";
1111
+ release_humor: "release_humor";
1112
+ reflection: "reflection";
1113
+ }>;
1114
+ duration_seconds: z.ZodNumber;
1115
+ cast_keys: z.ZodArray<z.ZodString>;
1116
+ location_key: z.ZodString;
1117
+ object_keys: z.ZodArray<z.ZodString>;
1118
+ dialogue: z.ZodDefault<z.ZodArray<z.ZodObject<{
1119
+ cast_key: z.ZodString;
1120
+ line: z.ZodString;
1121
+ }, z.core.$strip>>>;
1122
+ narration: z.ZodNullable<z.ZodString>;
1123
+ continuity_from_prev: z.ZodEnum<{
1124
+ dissolve: "dissolve";
1125
+ hard_cut: "hard_cut";
1126
+ match_last_frame: "match_last_frame";
1127
+ }>;
1128
+ shot_count_hint: z.ZodNumber;
1129
+ }, z.core.$strip>>;
1130
+ beats: z.ZodArray<z.ZodObject<{
1131
+ type: z.ZodEnum<{
1132
+ resolution: "resolution";
1133
+ hook: "hook";
1134
+ rising: "rising";
1135
+ climax: "climax";
1136
+ }>;
1137
+ scene_indices: z.ZodArray<z.ZodNumber>;
1138
+ }, z.core.$strip>>;
1139
+ has_narrator: z.ZodBoolean;
1140
+ narrator_profile: z.ZodNullable<z.ZodString>;
1141
+ narration_script: z.ZodOptional<z.ZodObject<{
1142
+ text: z.ZodString;
1143
+ voice_id: z.ZodOptional<z.ZodString>;
1144
+ }, z.core.$strip>>;
1145
+ music_plan: z.ZodObject<{
1146
+ mood: z.ZodString;
1147
+ bpm_target: z.ZodNumber;
1148
+ genre_hints: z.ZodArray<z.ZodString>;
1149
+ }, z.core.$strip>;
1150
+ global_style: z.ZodObject<{
1151
+ visual_style: z.ZodString;
1152
+ color_palette: z.ZodString;
1153
+ lighting: z.ZodString;
1154
+ camera_language: z.ZodString;
1155
+ }, z.core.$strip>;
1156
+ total_duration_seconds: z.ZodNumber;
1157
+ estimated_scene_count: z.ZodNumber;
1158
+ warnings: z.ZodArray<z.ZodString>;
1159
+ }, z.core.$strip>;
1160
+ type ShowrunnerPlan = z.infer<typeof ShowrunnerPlanSchema>;
1161
+ declare const CriticIssueSchema: z.ZodObject<{
1162
+ severity: z.ZodEnum<{
1163
+ warning: "warning";
1164
+ blocking: "blocking";
1165
+ }>;
1166
+ scene_index: z.ZodNullable<z.ZodNumber>;
1167
+ issue_type: z.ZodString;
1168
+ description: z.ZodString;
1169
+ suggested_fix: z.ZodString;
1170
+ }, z.core.$strip>;
1171
+ declare const ScriptCriticVerdictSchema: z.ZodObject<{
1172
+ verdict: z.ZodEnum<{
1173
+ pass: "pass";
1174
+ fail: "fail";
1175
+ }>;
1176
+ issues: z.ZodArray<z.ZodObject<{
1177
+ severity: z.ZodEnum<{
1178
+ warning: "warning";
1179
+ blocking: "blocking";
1180
+ }>;
1181
+ scene_index: z.ZodNullable<z.ZodNumber>;
1182
+ description: z.ZodString;
1183
+ suggested_fix: z.ZodString;
1184
+ issue_type: z.ZodEnum<{
1185
+ dialogue: "dialogue";
1186
+ duration: "duration";
1187
+ arc: "arc";
1188
+ shot_count_hint: "shot_count_hint";
1189
+ consistency: "consistency";
1190
+ generatability: "generatability";
1191
+ continuity: "continuity";
1192
+ }>;
1193
+ }, z.core.$strip>>;
1194
+ duration_analysis: z.ZodObject<{
1195
+ target_seconds: z.ZodNumber;
1196
+ actual_sum_seconds: z.ZodNumber;
1197
+ deviation_percent: z.ZodNumber;
1198
+ within_tolerance: z.ZodBoolean;
1199
+ }, z.core.$strip>;
1200
+ improvement_suggestions: z.ZodOptional<z.ZodArray<z.ZodString>>;
1201
+ }, z.core.$strip>;
1202
+ type ScriptCriticVerdict = z.infer<typeof ScriptCriticVerdictSchema>;
1203
+ declare const CastCoverageCriticVerdictSchema: z.ZodObject<{
1204
+ verdict: z.ZodEnum<{
1205
+ pass: "pass";
1206
+ fail: "fail";
1207
+ }>;
1208
+ issues: z.ZodArray<z.ZodObject<{
1209
+ severity: z.ZodEnum<{
1210
+ warning: "warning";
1211
+ blocking: "blocking";
1212
+ }>;
1213
+ scene_index: z.ZodNullable<z.ZodNumber>;
1214
+ description: z.ZodString;
1215
+ suggested_fix: z.ZodString;
1216
+ issue_type: z.ZodEnum<{
1217
+ orphan_cast: "orphan_cast";
1218
+ unresolved_ref: "unresolved_ref";
1219
+ dialogue_load_skew: "dialogue_load_skew";
1220
+ role_completeness: "role_completeness";
1221
+ key_uniqueness: "key_uniqueness";
1222
+ }>;
1223
+ }, z.core.$strip>>;
1224
+ dialogue_distribution: z.ZodArray<z.ZodObject<{
1225
+ cast_key: z.ZodString;
1226
+ line_count: z.ZodNumber;
1227
+ share_pct: z.ZodNumber;
1228
+ }, z.core.$strip>>;
1229
+ }, z.core.$strip>;
1230
+ type CastCoverageCriticVerdict = z.infer<typeof CastCoverageCriticVerdictSchema>;
1231
+ declare const LocationsCoverageCriticIssueSchema: z.ZodObject<{
1232
+ severity: z.ZodEnum<{
1233
+ warning: "warning";
1234
+ blocking: "blocking";
1235
+ }>;
1236
+ description: z.ZodString;
1237
+ suggested_fix: z.ZodString;
1238
+ issue_type: z.ZodEnum<{
1239
+ orphan_location: "orphan_location";
1240
+ unresolved_scene_location_ref: "unresolved_scene_location_ref";
1241
+ duplicate_key: "duplicate_key";
1242
+ name_too_similar: "name_too_similar";
1243
+ description_too_short: "description_too_short";
1244
+ redundant_location: "redundant_location";
1245
+ }>;
1246
+ location_key: z.ZodOptional<z.ZodNullable<z.ZodString>>;
1247
+ scene_index: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
1248
+ }, z.core.$strip>;
1249
+ declare const LocationsCoverageCriticVerdictSchema: z.ZodObject<{
1250
+ verdict: z.ZodEnum<{
1251
+ pass: "pass";
1252
+ fail: "fail";
1253
+ }>;
1254
+ issues: z.ZodArray<z.ZodObject<{
1255
+ severity: z.ZodEnum<{
1256
+ warning: "warning";
1257
+ blocking: "blocking";
1258
+ }>;
1259
+ description: z.ZodString;
1260
+ suggested_fix: z.ZodString;
1261
+ issue_type: z.ZodEnum<{
1262
+ orphan_location: "orphan_location";
1263
+ unresolved_scene_location_ref: "unresolved_scene_location_ref";
1264
+ duplicate_key: "duplicate_key";
1265
+ name_too_similar: "name_too_similar";
1266
+ description_too_short: "description_too_short";
1267
+ redundant_location: "redundant_location";
1268
+ }>;
1269
+ location_key: z.ZodOptional<z.ZodNullable<z.ZodString>>;
1270
+ scene_index: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
1271
+ }, z.core.$strip>>;
1272
+ }, z.core.$strip>;
1273
+ type LocationsCoverageCriticVerdict = z.infer<typeof LocationsCoverageCriticVerdictSchema>;
1274
+ declare const CharacterImageCriticVerdictSchema: z.ZodObject<{
1275
+ verdict: z.ZodEnum<{
1276
+ pass: "pass";
1277
+ fail: "fail";
1278
+ }>;
1279
+ prompt_adherence_score: z.ZodNumber;
1280
+ identified_subject: z.ZodString;
1281
+ issues: z.ZodArray<z.ZodObject<{
1282
+ severity: z.ZodEnum<{
1283
+ warning: "warning";
1284
+ blocking: "blocking";
1285
+ }>;
1286
+ category: z.ZodEnum<{
1287
+ other: "other";
1288
+ wrong_subject: "wrong_subject";
1289
+ wrong_attributes: "wrong_attributes";
1290
+ visual_artifacts: "visual_artifacts";
1291
+ style_mismatch: "style_mismatch";
1292
+ }>;
1293
+ description: z.ZodString;
1294
+ suggested_fix: z.ZodString;
1295
+ }, z.core.$strip>>;
1296
+ approved_summary: z.ZodOptional<z.ZodString>;
1297
+ }, z.core.$strip>;
1298
+ type CharacterImageCriticVerdict = z.infer<typeof CharacterImageCriticVerdictSchema>;
1299
+ declare const LocationImageCriticVerdictSchema: z.ZodObject<{
1300
+ verdict: z.ZodEnum<{
1301
+ pass: "pass";
1302
+ fail: "fail";
1303
+ }>;
1304
+ prompt_adherence_score: z.ZodNumber;
1305
+ identified_subject: z.ZodString;
1306
+ issues: z.ZodArray<z.ZodObject<{
1307
+ severity: z.ZodEnum<{
1308
+ warning: "warning";
1309
+ blocking: "blocking";
1310
+ }>;
1311
+ category: z.ZodEnum<{
1312
+ other: "other";
1313
+ wrong_attributes: "wrong_attributes";
1314
+ visual_artifacts: "visual_artifacts";
1315
+ style_mismatch: "style_mismatch";
1316
+ wrong_location_type: "wrong_location_type";
1317
+ wrong_time_of_day: "wrong_time_of_day";
1318
+ }>;
1319
+ description: z.ZodString;
1320
+ suggested_fix: z.ZodString;
1321
+ }, z.core.$strip>>;
1322
+ approved_summary: z.ZodOptional<z.ZodString>;
1323
+ }, z.core.$strip>;
1324
+ type LocationImageCriticVerdict = z.infer<typeof LocationImageCriticVerdictSchema>;
1325
+ declare const StoryboardCohesionCriticVerdictSchema: z.ZodObject<{
1326
+ overall_assessment: z.ZodEnum<{
1327
+ coherent: "coherent";
1328
+ minor_issues: "minor_issues";
1329
+ incoherent: "incoherent";
1330
+ }>;
1331
+ coherence_score: z.ZodNumber;
1332
+ summary: z.ZodString;
1333
+ findings: z.ZodArray<z.ZodObject<{
1334
+ severity: z.ZodEnum<{
1335
+ warning: "warning";
1336
+ blocking: "blocking";
1337
+ info: "info";
1338
+ }>;
1339
+ category: z.ZodEnum<{
1340
+ other: "other";
1341
+ character_inconsistency: "character_inconsistency";
1342
+ location_inconsistency: "location_inconsistency";
1343
+ lighting_mismatch: "lighting_mismatch";
1344
+ style_drift: "style_drift";
1345
+ missing_establishing_shot: "missing_establishing_shot";
1346
+ plot_jump: "plot_jump";
1347
+ }>;
1348
+ affected_scenes: z.ZodArray<z.ZodNumber>;
1349
+ description: z.ZodString;
1350
+ suggested_action: z.ZodString;
1351
+ }, z.core.$strip>>;
1352
+ }, z.core.$strip>;
1353
+ type StoryboardCohesionCriticVerdict = z.infer<typeof StoryboardCohesionCriticVerdictSchema>;
1354
+ declare const VideoCriticVerdictSchema: z.ZodObject<{
1355
+ verdict: z.ZodEnum<{
1356
+ pass: "pass";
1357
+ fail: "fail";
1358
+ }>;
1359
+ prompt_adherence_score: z.ZodNumber;
1360
+ continuity_score: z.ZodNullable<z.ZodNumber>;
1361
+ identified_action: z.ZodString;
1362
+ issues: z.ZodArray<z.ZodObject<{
1363
+ severity: z.ZodEnum<{
1364
+ warning: "warning";
1365
+ blocking: "blocking";
1366
+ }>;
1367
+ category: z.ZodEnum<{
1368
+ other: "other";
1369
+ visual_artifacts: "visual_artifacts";
1370
+ style_mismatch: "style_mismatch";
1371
+ wrong_action: "wrong_action";
1372
+ prompt_mismatch: "prompt_mismatch";
1373
+ continuity_break: "continuity_break";
1374
+ motion_glitch: "motion_glitch";
1375
+ }>;
1376
+ description: z.ZodString;
1377
+ suggested_fix: z.ZodString;
1378
+ }, z.core.$strip>>;
1379
+ approved_summary: z.ZodOptional<z.ZodString>;
1380
+ }, z.core.$strip>;
1381
+ type VideoCriticVerdict = z.infer<typeof VideoCriticVerdictSchema>;
1382
+ /**
1383
+ * Phase 1D.2c-b-ii — Video Critic ShotSpec sibling fields persisted by
1384
+ * Stage 7 (scene-internal-pipeline) directly on each ShotSpec record (NOT
1385
+ * under a nested `metadata` key). Persisting them as siblings lets the shot
1386
+ * recovery routes update them via a JSON-Patch-style path; the shared Zod
1387
+ * `ShotSpec` schema doesn't enumerate these because ShotSpec is an open
1388
+ * object on the persistence path, so this interface is the single source of
1389
+ * truth for backend + frontend consumers that need to read/write them.
1390
+ *
1391
+ * Persisted location:
1392
+ * `pipeline_entities.metadata.scene_node_data.shots[N].video_critic_*`
1393
+ *
1394
+ * Cleared by `clearVideoCriticMetadata` (see pipeline-defaults.ts) in the
1395
+ * retry-video-generation recovery route + the frontend Regenerate handler.
1396
+ */
1397
+ interface VideoCriticShotFields {
1398
+ video_critic_findings?: VideoCriticVerdict["issues"];
1399
+ video_critic_score?: number;
1400
+ video_critic_continuity_score?: number | null;
1401
+ video_critic_identified_action?: string;
1402
+ video_critic_retry_count?: number;
1403
+ video_critic_last_attempted_url?: string;
1404
+ video_critic_failed?: boolean;
1405
+ video_critic_verdict?: "pass" | "fail";
1406
+ }
1407
+ declare const CharacterMetadataSchema: z.ZodObject<{
1408
+ entity_type: z.ZodLiteral<"character">;
1409
+ name: z.ZodString;
1410
+ visual_description: z.ZodString;
1411
+ role: z.ZodEnum<{
1412
+ protagonist: "protagonist";
1413
+ antagonist: "antagonist";
1414
+ supporting: "supporting";
1415
+ cameo: "cameo";
1416
+ }>;
1417
+ estimated_screen_time_shots: z.ZodNumber;
1418
+ has_dialogue: z.ZodBoolean;
1419
+ voice_profile: z.ZodOptional<z.ZodString>;
1420
+ angle_count: z.ZodNumber;
1421
+ }, z.core.$strip>;
1422
+ declare const ObjectMetadataSchema: z.ZodObject<{
1423
+ entity_type: z.ZodLiteral<"object">;
1424
+ name: z.ZodString;
1425
+ visual_description: z.ZodString;
1426
+ narrative_significance: z.ZodString;
1427
+ scenes_present: z.ZodArray<z.ZodString>;
1428
+ }, z.core.$strip>;
1429
+ declare const LocationMetadataSchema: z.ZodObject<{
1430
+ entity_type: z.ZodLiteral<"location">;
1431
+ name: z.ZodString;
1432
+ visual_description: z.ZodString;
1433
+ variants_needed: z.ZodArray<z.ZodString>;
1434
+ }, z.core.$strip>;
1435
+ declare const EntityMetadataSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
1436
+ entity_type: z.ZodLiteral<"character">;
1437
+ name: z.ZodString;
1438
+ visual_description: z.ZodString;
1439
+ role: z.ZodEnum<{
1440
+ protagonist: "protagonist";
1441
+ antagonist: "antagonist";
1442
+ supporting: "supporting";
1443
+ cameo: "cameo";
1444
+ }>;
1445
+ estimated_screen_time_shots: z.ZodNumber;
1446
+ has_dialogue: z.ZodBoolean;
1447
+ voice_profile: z.ZodOptional<z.ZodString>;
1448
+ angle_count: z.ZodNumber;
1449
+ }, z.core.$strip>, z.ZodObject<{
1450
+ entity_type: z.ZodLiteral<"object">;
1451
+ name: z.ZodString;
1452
+ visual_description: z.ZodString;
1453
+ narrative_significance: z.ZodString;
1454
+ scenes_present: z.ZodArray<z.ZodString>;
1455
+ }, z.core.$strip>, z.ZodObject<{
1456
+ entity_type: z.ZodLiteral<"location">;
1457
+ name: z.ZodString;
1458
+ visual_description: z.ZodString;
1459
+ variants_needed: z.ZodArray<z.ZodString>;
1460
+ }, z.core.$strip>, z.ZodObject<{
1461
+ entity_type: z.ZodLiteral<"scene">;
1462
+ scene_id: z.ZodString;
1463
+ shot_ids: z.ZodArray<z.ZodString>;
1464
+ emotional_beat: z.ZodString;
1465
+ scene_node_id: z.ZodString;
1466
+ exploded_to_workflow_id: z.ZodDefault<z.ZodNullable<z.ZodString>>;
1467
+ scene_node_data: z.ZodOptional<z.ZodObject<{
1468
+ scene_index: z.ZodNumber;
1469
+ description: z.ZodString;
1470
+ emotional_beat: z.ZodString;
1471
+ duration_seconds: z.ZodNumber;
1472
+ shot_input_mode: z.ZodEnum<{
1473
+ text: "text";
1474
+ first_frame: "first_frame";
1475
+ first_last_frame: "first_last_frame";
1476
+ ref_images: "ref_images";
1477
+ multi_shot: "multi_shot";
1478
+ video_continuation: "video_continuation";
1479
+ frame_interpolation: "frame_interpolation";
1480
+ camera_path: "camera_path";
1481
+ }>;
1482
+ cast_keys: z.ZodArray<z.ZodString>;
1483
+ location_key: z.ZodString;
1484
+ object_keys: z.ZodArray<z.ZodString>;
1485
+ continuity_from_prev: z.ZodEnum<{
1486
+ dissolve: "dissolve";
1487
+ hard_cut: "hard_cut";
1488
+ match_last_frame: "match_last_frame";
1489
+ }>;
1490
+ image_model: z.ZodString;
1491
+ video_model: z.ZodString;
1492
+ shots: z.ZodArray<z.ZodObject<{
1493
+ shot_id: z.ZodString;
1494
+ camera: z.ZodObject<{
1495
+ shot_type: z.ZodEnum<{
1496
+ wide: "wide";
1497
+ medium: "medium";
1498
+ close_up: "close_up";
1499
+ extreme_close_up: "extreme_close_up";
1500
+ pov: "pov";
1501
+ over_shoulder: "over_shoulder";
1502
+ }>;
1503
+ angle: z.ZodEnum<{
1504
+ high: "high";
1505
+ low: "low";
1506
+ eye_level: "eye_level";
1507
+ dutch: "dutch";
1508
+ birds_eye: "birds_eye";
1509
+ }>;
1510
+ motion: z.ZodEnum<{
1511
+ pan: "pan";
1512
+ static: "static";
1513
+ tilt: "tilt";
1514
+ dolly: "dolly";
1515
+ tracking: "tracking";
1516
+ handheld: "handheld";
1517
+ }>;
1518
+ }, z.core.$strip>;
1519
+ shot_intensity_kind: z.ZodEnum<{
1520
+ establishing_shot: "establishing_shot";
1521
+ action_shot: "action_shot";
1522
+ dialogue_shot: "dialogue_shot";
1523
+ reaction_shot: "reaction_shot";
1524
+ climactic_shot: "climactic_shot";
1525
+ transition_shot: "transition_shot";
1526
+ }>;
1527
+ action: z.ZodString;
1528
+ dialogue_line: z.ZodNullable<z.ZodString>;
1529
+ duration_seconds: z.ZodNumber;
1530
+ motion_prompt: z.ZodString;
1531
+ start_state: z.ZodString;
1532
+ end_state: z.ZodString;
1533
+ continuity_with_previous: z.ZodNullable<z.ZodString>;
1534
+ shot_intent: z.ZodObject<{
1535
+ needs_multishot_reference: z.ZodDefault<z.ZodBoolean>;
1536
+ is_loopable: z.ZodDefault<z.ZodBoolean>;
1537
+ needs_music_suppression: z.ZodDefault<z.ZodBoolean>;
1538
+ is_match_cut: z.ZodDefault<z.ZodBoolean>;
1539
+ }, z.core.$strip>;
1540
+ visual_keyframe_prompt: z.ZodString;
1541
+ end_keyframe_prompt: z.ZodOptional<z.ZodString>;
1542
+ extends_shot_id: z.ZodOptional<z.ZodString>;
1543
+ bridge_image_prompt: z.ZodOptional<z.ZodString>;
1544
+ interpolation_keyframes: z.ZodOptional<z.ZodArray<z.ZodObject<{
1545
+ timestamp_sec: z.ZodNumber;
1546
+ prompt: z.ZodString;
1547
+ }, z.core.$strip>>>;
1548
+ interpolation_keyframe_urls: z.ZodOptional<z.ZodArray<z.ZodString>>;
1549
+ camera_path_directive: z.ZodOptional<z.ZodObject<{
1550
+ path_kind: z.ZodEnum<{
1551
+ dolly: "dolly";
1552
+ orbit: "orbit";
1553
+ crane: "crane";
1554
+ arc: "arc";
1555
+ reveal: "reveal";
1556
+ }>;
1557
+ parameters: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
1558
+ }, z.core.$strip>>;
1559
+ keyframe_asset_id: z.ZodOptional<z.ZodString>;
1560
+ keyframe_url: z.ZodOptional<z.ZodString>;
1561
+ video_asset_id: z.ZodOptional<z.ZodString>;
1562
+ video_url: z.ZodOptional<z.ZodString>;
1563
+ last_frame_asset_id: z.ZodOptional<z.ZodString>;
1564
+ last_frame_url: z.ZodOptional<z.ZodString>;
1565
+ audio_asset_id: z.ZodOptional<z.ZodString>;
1566
+ audio_url: z.ZodOptional<z.ZodString>;
1567
+ lipsynced_asset_id: z.ZodOptional<z.ZodString>;
1568
+ lipsynced_url: z.ZodOptional<z.ZodString>;
1569
+ bridged_frame_url: z.ZodOptional<z.ZodString>;
1570
+ accepted_match_cut_break: z.ZodOptional<z.ZodBoolean>;
1571
+ has_dialogue: z.ZodDefault<z.ZodBoolean>;
1572
+ actual_audio_duration_sec: z.ZodOptional<z.ZodNumber>;
1573
+ dialogue_no_cut_zone: z.ZodOptional<z.ZodNullable<z.ZodObject<{
1574
+ start: z.ZodNumber;
1575
+ end: z.ZodNumber;
1576
+ }, z.core.$strip>>>;
1577
+ cut_decision: z.ZodOptional<z.ZodObject<{
1578
+ in_offset_sec: z.ZodDefault<z.ZodNumber>;
1579
+ out_offset_sec: z.ZodDefault<z.ZodNumber>;
1580
+ transition_to_next: z.ZodEnum<{
1581
+ dissolve: "dissolve";
1582
+ hard_cut: "hard_cut";
1583
+ match_cut: "match_cut";
1584
+ overlap: "overlap";
1585
+ }>;
1586
+ transition_duration_sec: z.ZodOptional<z.ZodNumber>;
1587
+ beat_snap_seconds: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
1588
+ }, z.core.$strip>>;
1589
+ }, z.core.$strip>>;
1590
+ scene_anchor_keyframe: z.ZodDefault<z.ZodNullable<z.ZodObject<{
1591
+ asset_id: z.ZodString;
1592
+ url: z.ZodString;
1593
+ }, z.core.$strip>>>;
1594
+ style_directives: z.ZodOptional<z.ZodObject<{
1595
+ visualStyle: z.ZodOptional<z.ZodOptional<z.ZodString>>;
1596
+ colorPalette: z.ZodOptional<z.ZodOptional<z.ZodString>>;
1597
+ lighting: z.ZodOptional<z.ZodOptional<z.ZodString>>;
1598
+ cameraLanguage: z.ZodOptional<z.ZodOptional<z.ZodString>>;
1599
+ avoid: z.ZodOptional<z.ZodOptional<z.ZodString>>;
1600
+ }, z.core.$strip>>;
1601
+ generated_keyframes: z.ZodDefault<z.ZodArray<z.ZodObject<{
1602
+ asset_id: z.ZodString;
1603
+ url: z.ZodString;
1604
+ }, z.core.$strip>>>;
1605
+ generated_clips: z.ZodDefault<z.ZodArray<z.ZodObject<{
1606
+ asset_id: z.ZodString;
1607
+ url: z.ZodString;
1608
+ }, z.core.$strip>>>;
1609
+ composite_video: z.ZodDefault<z.ZodNullable<z.ZodObject<{
1610
+ asset_id: z.ZodString;
1611
+ url: z.ZodString;
1612
+ }, z.core.$strip>>>;
1613
+ last_frame: z.ZodDefault<z.ZodNullable<z.ZodObject<{
1614
+ asset_id: z.ZodString;
1615
+ url: z.ZodString;
1616
+ }, z.core.$strip>>>;
1617
+ scene_audio_track: z.ZodDefault<z.ZodNullable<z.ZodObject<{
1618
+ asset_id: z.ZodString;
1619
+ url: z.ZodString;
1620
+ }, z.core.$strip>>>;
1621
+ composite_video_asset_id: z.ZodOptional<z.ZodString>;
1622
+ composite_video_url: z.ZodOptional<z.ZodString>;
1623
+ }, z.core.$strip>>;
1624
+ }, z.core.$strip>], "entity_type">;
1625
+ type EntityMetadata = z.infer<typeof EntityMetadataSchema>;
1626
+
1627
+ interface ObjectsValidationIssue {
1628
+ severity: "blocking" | "warning";
1629
+ type: "duplicate_key" | "empty_significance" | "orphan_object" | "unresolved_scene_object_ref";
1630
+ object_key?: string;
1631
+ scene_index?: number;
1632
+ message: string;
1633
+ }
1634
+ interface ObjectsValidationResult {
1635
+ ok: boolean;
1636
+ verdict: "pass" | "fail";
1637
+ issues: ObjectsValidationIssue[];
1638
+ }
1639
+ declare function validateObjects(objects: ShowrunnerPlan["objects"], plan: ShowrunnerPlan): ObjectsValidationResult;
1640
+
1641
+ /**
1642
+ * Voice Matcher (LLM spec §7.1) picks an ElevenLabs voice per dialogue-bearing
1643
+ * cast member. Two variants discriminated by `voice_source`:
1644
+ * - 'premade' → uses a catalog voice_id
1645
+ * - 'custom' → emits a prompt for ElevenLabs voice_design (used when no
1646
+ * premade fits)
1647
+ *
1648
+ * **Schema shape note:** this was originally `z.discriminatedUnion(...)` but
1649
+ * Anthropic's tool input_schema validator rejects union-at-root JSON Schemas —
1650
+ * it requires `"type": "object"` at the top level (`tools.0.custom.input_schema.type:
1651
+ * Field required`). Flattening to a single object with both optional fields +
1652
+ * a `.refine()` produces a valid schema (root is an object) while still
1653
+ * enforcing the per-variant required-field rule at parse time. `callLLM`'s
1654
+ * schema.safeParse triggers a retry-with-feedback if the LLM emits an invalid
1655
+ * combination (e.g., 'premade' without voice_id), so the LLM converges on
1656
+ * correct output.
1657
+ */
1658
+ declare const VoiceMatchSchema: z.ZodObject<{
1659
+ voice_source: z.ZodEnum<{
1660
+ custom: "custom";
1661
+ premade: "premade";
1662
+ }>;
1663
+ voice_id: z.ZodOptional<z.ZodString>;
1664
+ voice_design_prompt: z.ZodOptional<z.ZodString>;
1665
+ reasoning: z.ZodString;
1666
+ }, z.core.$strip>;
1667
+ type VoiceMatch = z.infer<typeof VoiceMatchSchema>;
1668
+
1669
+ /**
1670
+ * A premade ElevenLabs voice as returned by `GET /v1/voices`.
1671
+ * Field names + types mirror the route verbatim: the route normalizes every
1672
+ * optional field to `""` (never null), so these are all non-null strings.
1673
+ */
1674
+ interface Voice {
1675
+ voice_id: string;
1676
+ name: string;
1677
+ preview_url: string;
1678
+ gender: string;
1679
+ accent: string;
1680
+ age: string;
1681
+ description: string;
1682
+ use_case: string;
1683
+ category: string;
1684
+ }
1685
+ /**
1686
+ * A shared/community Voice Library entry (`GET /v1/voices/library`).
1687
+ * Same shape as {@link Voice} plus the TTS provider the voice is verified on.
1688
+ */
1689
+ interface SharedVoice extends Voice {
1690
+ /**
1691
+ * The best of our TTS providers whose underlying ElevenLabs model the
1692
+ * voice lists in `verified_languages`, in the order `elevenlabs-v4` (when
1693
+ * verified for the base model `eleven_v4`), then `elevenlabs-v3`, which
1694
+ * renders any voice unmodified, then `elevenlabs-v4-turbo` (verified for the
1695
+ * exact id `eleven_v4_turbo`), then the cheapest v2 model: `elevenlabs-turbo`
1696
+ * preferred, else `elevenlabs-multilingual`. Only those two exact ids count
1697
+ * in the v4 family; the other `eleven_v4_…` variants (`_hq`, `_exp`, …) are
1698
+ * not models of ours and count toward nothing. Models the deployment does
1699
+ * not offer are never recommended.
1700
+ * Clients without a provider picker should send it as the `provider` on
1701
+ * text-to-speech so generation uses a model the voice is actually verified
1702
+ * for — rendering a voice on an unverified model is what makes output drift
1703
+ * audibly from its preview. Absent when the entry has no model metadata, or
1704
+ * when none of the models it is verified for is offered by the deployment.
1705
+ */
1706
+ recommendedProvider?: TtsProvider;
1707
+ /**
1708
+ * Every TTS provider the voice is verified on and the deployment offers
1709
+ * (a subset of {@link TtsProvider}, in the order `elevenlabs-v4`,
1710
+ * `elevenlabs-v3`, `elevenlabs-v4-turbo`, `elevenlabs-turbo`,
1711
+ * `elevenlabs-multilingual` — the same order `recommendedProvider` is picked
1712
+ * from, so it is always the first entry); absent whenever
1713
+ * `recommendedProvider` is. Clients WITH a provider picker should only snap
1714
+ * the provider when the current choice is NOT in this set — most voices
1715
+ * verify more than one, and an explicit user choice within the set must win.
1716
+ * Do not switch over a closed list of members: a speech model added later
1717
+ * joins this set the release it ships.
1718
+ */
1719
+ verifiedProviders?: TtsProvider[];
1720
+ }
1721
+ /** Query params for `GET /v1/voices/library`. All optional; sent as a querystring. */
1722
+ interface VoiceLibraryParams {
1723
+ search?: string;
1724
+ gender?: string;
1725
+ age?: string;
1726
+ accent?: string;
1727
+ language?: string;
1728
+ category?: string;
1729
+ use_cases?: string;
1730
+ descriptives?: string;
1731
+ featured?: boolean;
1732
+ /** e.g. "trending" — passed through to the route. */
1733
+ sort?: string;
1734
+ /** 0-based page; route default 0. */
1735
+ page?: number;
1736
+ /** Route default 30, clamped to 1..100. */
1737
+ page_size?: number;
1738
+ }
1739
+ /** `GET /v1/voices/library` response. */
1740
+ interface VoiceLibraryResponse {
1741
+ voices: SharedVoice[];
1742
+ hasMore: boolean;
1743
+ }
1744
+ /**
1745
+ * A user voice clone. `GET /v1/voice-clones` returns the full shape; the create
1746
+ * response (`POST /v1/voice-clones/from-url`) returns only `id, name,
1747
+ * elevenlabsVoiceId, sampleAudioUrl, createdAt` (+ a credit-tracking `jobId`),
1748
+ * so the list-only fields are optional here. `elevenlabsVoiceId` is the id that
1749
+ * resolves the clone at text-to-speech time (use it as the selected voiceId).
1750
+ */
1751
+ interface VoiceClone {
1752
+ id: string;
1753
+ name: string;
1754
+ elevenlabsVoiceId: string;
1755
+ sampleAudioUrl: string;
1756
+ createdAt: string;
1757
+ /** Present on the list response; absent on the create response. */
1758
+ description?: string | null;
1759
+ previewUrl?: string | null;
1760
+ gender?: string | null;
1761
+ accent?: string | null;
1762
+ updatedAt?: string;
1763
+ /** Only on the create response (credit-tracking); never on the list. */
1764
+ jobId?: string;
1765
+ }
1766
+
1767
+ /**
1768
+ * How the TTS layer resolves a voice id. Mirrors `CharacterVoice.voiceType` on
1769
+ * the frontend character node: `premade` voices resolve by NAME, `library` /
1770
+ * `custom` voices resolve by ID. Carry it alongside the id or premade-vs-library
1771
+ * resolution misroutes (see backend `direct-tts.ts`).
1772
+ */
1773
+ type VoiceType = "premade" | "library" | "custom";
1774
+ /**
1775
+ * A character's saved voice as supplied to the voiced-video orchestration on
1776
+ * `POST /v1/generate-video`. A deliberate subset of the frontend `CharacterVoice`:
1777
+ * only the fields the server needs to synthesise speech (no `voiceName` /
1778
+ * `traits` / `previewUrl`, which are display-only and never read server-side).
1779
+ *
1780
+ * `speaker` is the join key: it matches a {@link DialogueLine}.speaker so a
1781
+ * multi-speaker prompt routes each line to its own voice. Omit it for a
1782
+ * single-voice clip (one spec, no dialogue attribution needed).
1783
+ */
1784
+ interface CharacterVoiceSpec {
1785
+ /** ElevenLabs voice id, or the premade voice NAME when `voiceType === "premade"`. */
1786
+ readonly voiceId: string;
1787
+ /** How the TTS layer resolves {@link voiceId}. Defaults to `"premade"` downstream. */
1788
+ readonly voiceType?: VoiceType;
1789
+ /** Recommended TTS provider for this voice; forwarded as `provider` to TTS. */
1790
+ readonly ttsProvider?: TtsProvider;
1791
+ /**
1792
+ * Speaker label this voice belongs to (e.g. "Anna"). Joined to
1793
+ * {@link DialogueLine}.speaker case-insensitively (trimmed). Omit for a
1794
+ * single-voice clip.
1795
+ */
1796
+ readonly speaker?: string;
1797
+ }
1798
+ /** One attributed line of dialogue: who speaks (`speaker`) and what they say (`line`). */
1799
+ interface DialogueLine {
1800
+ readonly speaker: string;
1801
+ readonly line: string;
1802
+ }
1803
+ /**
1804
+ * A dialogue line resolved to a concrete voice: `{ text, voice }` per line, in
1805
+ * order. `voice` is OUR identifier (premade name or library/custom UUID) — the
1806
+ * direct ElevenLabs Dialogue call resolves it per line to the `voice_id` the
1807
+ * wire shape (`inputs[]`) wants. `voiceType` rides along so the TTS layer
1808
+ * resolves premade-by-name vs library/custom-by-id correctly.
1809
+ */
1810
+ interface ResolvedDialogueVoiceLine {
1811
+ readonly text: string;
1812
+ readonly voice: string;
1813
+ readonly voiceType?: VoiceType;
1814
+ }
1815
+ /**
1816
+ * Extract attributed dialogue (`Speaker: "line"`) from a free-text prompt.
1817
+ *
1818
+ * Deterministic and intentionally conservative (see {@link ATTRIBUTED_DIALOGUE_RE}):
1819
+ * only QUOTED lines attributed to a short speaker label are matched. Callers that
1820
+ * already have structured dialogue (studio prompt chips) should pass it directly
1821
+ * and skip this parser. Order is preserved (it drives the stitched dialogue
1822
+ * track). Returns `[]` when no attributed quoted dialogue is found.
1823
+ */
1824
+ declare function parseAttributedDialogue(prompt: string): DialogueLine[];
1825
+ /**
1826
+ * Resolve each dialogue line to a concrete voice by joining `line.speaker` to
1827
+ * `voices[].speaker` (case-insensitive, trimmed) - the "Speaker mapping" model.
1828
+ *
1829
+ * Fallback order for an unmatched / unattributed line: the matched speaker's
1830
+ * voice -> `defaultVoiceId` -> the sole voice (when exactly one spec is given) ->
1831
+ * the first voice. A line resolves to nothing only when there are no voices and
1832
+ * no default, in which case it is dropped (the caller decides whether an empty
1833
+ * result means "no dialogue to synthesise"). This mirrors the pipeline's
1834
+ * non-fatal missing-voice behaviour (`allowDefaultVoiceFallback`).
1835
+ */
1836
+ declare function resolveDialogueVoices(dialogue: readonly DialogueLine[], voices: readonly CharacterVoiceSpec[], defaultVoiceId?: string): ResolvedDialogueVoiceLine[];
1837
+
1838
+ /**
1839
+ * Image Critic types — shared between backend (Sonnet vision call) and
1840
+ * frontend (helper result modal renderers). The schema lives in
1841
+ * `@nodaro/shared` so the helper-result schemas in `scene-helper-types.ts`
1842
+ * can compose it, and the frontend modal can render a typed
1843
+ * {@link ImageCriticVerdict} without a backend round-trip-only type.
1844
+ *
1845
+ * The runtime + persistence implementation lives in
1846
+ * `backend/src/ee/pipelines/llms/image-critic.ts` which re-exports these
1847
+ * schemas for callers that import from one place.
1848
+ */
1849
+ /**
1850
+ * Issue types the Image Critic can flag. `continuity_break` is the
1851
+ * Phase 1C.1 newcomer — fires when a prior-shot last_frame is supplied
1852
+ * and the new keyframe doesn't plausibly continue from it.
1853
+ */
1854
+ declare const ImageCriticIssueSchema: z.ZodObject<{
1855
+ type: z.ZodEnum<{
1856
+ style_drift: "style_drift";
1857
+ prompt_mismatch: "prompt_mismatch";
1858
+ continuity_break: "continuity_break";
1859
+ identity_mismatch: "identity_mismatch";
1860
+ composition_break: "composition_break";
1861
+ wardrobe_inconsistency: "wardrobe_inconsistency";
1862
+ }>;
1863
+ severity: z.ZodEnum<{
1864
+ warning: "warning";
1865
+ blocking: "blocking";
1866
+ info: "info";
1867
+ }>;
1868
+ message: z.ZodString;
1869
+ suggested_fix: z.ZodOptional<z.ZodString>;
1870
+ }, z.core.$strip>;
1871
+ type ImageCriticIssue = z.infer<typeof ImageCriticIssueSchema>;
1872
+ declare const ImageCriticVerdictSchema: z.ZodObject<{
1873
+ ok: z.ZodBoolean;
1874
+ issues: z.ZodArray<z.ZodObject<{
1875
+ type: z.ZodEnum<{
1876
+ style_drift: "style_drift";
1877
+ prompt_mismatch: "prompt_mismatch";
1878
+ continuity_break: "continuity_break";
1879
+ identity_mismatch: "identity_mismatch";
1880
+ composition_break: "composition_break";
1881
+ wardrobe_inconsistency: "wardrobe_inconsistency";
1882
+ }>;
1883
+ severity: z.ZodEnum<{
1884
+ warning: "warning";
1885
+ blocking: "blocking";
1886
+ info: "info";
1887
+ }>;
1888
+ message: z.ZodString;
1889
+ suggested_fix: z.ZodOptional<z.ZodString>;
1890
+ }, z.core.$strip>>;
1891
+ notes: z.ZodString;
1892
+ }, z.core.$strip>;
1893
+ type ImageCriticVerdict = z.infer<typeof ImageCriticVerdictSchema>;
1894
+
1895
+ declare const IMAGE_CRITIC_LEAF_MODES: readonly ["character-consistency", "realism", "prompt-adherence", "anatomy", "aesthetic", "style-match"];
1896
+ declare const IMAGE_CRITIC_MODES: readonly ["character-consistency", "realism", "prompt-adherence", "anatomy", "aesthetic", "style-match", "all"];
1897
+ type ImageCriticLeafMode = (typeof IMAGE_CRITIC_LEAF_MODES)[number];
1898
+ type ImageCriticMode = (typeof IMAGE_CRITIC_MODES)[number];
1899
+ declare const issue: z.ZodObject<{
1900
+ category: z.ZodString;
1901
+ severity: z.ZodEnum<{
1902
+ warning: "warning";
1903
+ blocking: "blocking";
1904
+ info: "info";
1905
+ }>;
1906
+ description: z.ZodString;
1907
+ }, z.core.$strip>;
1908
+ declare const ImageCriticResultSchema: z.ZodObject<{
1909
+ score: z.ZodNumber;
1910
+ feedback: z.ZodString;
1911
+ issues: z.ZodOptional<z.ZodArray<z.ZodPreprocess<z.ZodObject<{
1912
+ category: z.ZodString;
1913
+ severity: z.ZodEnum<{
1914
+ warning: "warning";
1915
+ blocking: "blocking";
1916
+ info: "info";
1917
+ }>;
1918
+ description: z.ZodString;
1919
+ }, z.core.$strip>>>>;
1920
+ perMode: z.ZodOptional<z.ZodObject<{
1921
+ "character-consistency": z.ZodOptional<z.ZodObject<{
1922
+ score: z.ZodNumber;
1923
+ feedback: z.ZodString;
1924
+ }, z.core.$strip>>;
1925
+ realism: z.ZodOptional<z.ZodObject<{
1926
+ score: z.ZodNumber;
1927
+ feedback: z.ZodString;
1928
+ }, z.core.$strip>>;
1929
+ "prompt-adherence": z.ZodOptional<z.ZodObject<{
1930
+ score: z.ZodNumber;
1931
+ feedback: z.ZodString;
1932
+ }, z.core.$strip>>;
1933
+ anatomy: z.ZodOptional<z.ZodObject<{
1934
+ score: z.ZodNumber;
1935
+ feedback: z.ZodString;
1936
+ }, z.core.$strip>>;
1937
+ aesthetic: z.ZodOptional<z.ZodObject<{
1938
+ score: z.ZodNumber;
1939
+ feedback: z.ZodString;
1940
+ }, z.core.$strip>>;
1941
+ "style-match": z.ZodOptional<z.ZodObject<{
1942
+ score: z.ZodNumber;
1943
+ feedback: z.ZodString;
1944
+ }, z.core.$strip>>;
1945
+ }, z.core.$strict>>;
1946
+ }, z.core.$strip>;
1947
+ type ImageCriticResult = z.infer<typeof ImageCriticResultSchema>;
1948
+ type ImageCriticNodeIssue = z.infer<typeof issue>;
1949
+
1950
+ /**
1951
+ * All 10 helpers — 7 text/planning helpers shipped in Phase 1B.3 +
1952
+ * 3 vision-keyframe helpers activated in Phase 1C.1.
1953
+ * Names match the §6.11 spec sub-section labels (URL-safe form).
1954
+ */
1955
+ declare const SCENE_HELPER_NAMES: readonly ["audit_prompt", "improve_prompt", "generate_motion", "optimize_for_model", "add_broll", "bridge_to_next_scene", "anchor_scene_style", "audit_images", "fix_continuity", "validate_match_cut"];
1956
+ declare const SceneHelperNameSchema: z.ZodEnum<{
1957
+ audit_prompt: "audit_prompt";
1958
+ improve_prompt: "improve_prompt";
1959
+ generate_motion: "generate_motion";
1960
+ optimize_for_model: "optimize_for_model";
1961
+ add_broll: "add_broll";
1962
+ bridge_to_next_scene: "bridge_to_next_scene";
1963
+ anchor_scene_style: "anchor_scene_style";
1964
+ audit_images: "audit_images";
1965
+ fix_continuity: "fix_continuity";
1966
+ validate_match_cut: "validate_match_cut";
1967
+ }>;
1968
+ type SceneHelperName = z.infer<typeof SceneHelperNameSchema>;
1969
+ /**
1970
+ * UI-gating set used by `scene-helper-buttons.tsx` to render active vs disabled
1971
+ * buttons. Phase 1C.1 promoted the 3 vision-keyframe helpers from disabled →
1972
+ * active; the constant name is preserved for compat (it remains "the set of
1973
+ * helpers currently shipped"), and {@link ACTIVE_SCENE_HELPERS} is a clearer
1974
+ * alias for new code.
1975
+ */
1976
+ declare const HELPERS_SHIPPED_IN_1B3: ReadonlySet<SceneHelperName>;
1977
+ /** Cleaner-named alias for {@link HELPERS_SHIPPED_IN_1B3}. */
1978
+ declare const ACTIVE_SCENE_HELPERS: ReadonlySet<"audit_prompt" | "improve_prompt" | "generate_motion" | "optimize_for_model" | "add_broll" | "bridge_to_next_scene" | "anchor_scene_style" | "audit_images" | "fix_continuity" | "validate_match_cut">;
1979
+ declare const AuditPromptIssueSchema: z.ZodObject<{
1980
+ shot_id: z.ZodString;
1981
+ severity: z.ZodEnum<{
1982
+ warning: "warning";
1983
+ blocking: "blocking";
1984
+ info: "info";
1985
+ }>;
1986
+ issue_type: z.ZodEnum<{
1987
+ contradiction: "contradiction";
1988
+ missing_beat: "missing_beat";
1989
+ off_format: "off_format";
1990
+ camera_motion_mismatch: "camera_motion_mismatch";
1991
+ }>;
1992
+ message: z.ZodString;
1993
+ suggested_fix: z.ZodString;
1994
+ }, z.core.$strip>;
1995
+ declare const AuditPromptResultSchema: z.ZodObject<{
1996
+ scene_id: z.ZodString;
1997
+ ok: z.ZodBoolean;
1998
+ issues_per_shot: z.ZodArray<z.ZodObject<{
1999
+ shot_id: z.ZodString;
2000
+ severity: z.ZodEnum<{
2001
+ warning: "warning";
2002
+ blocking: "blocking";
2003
+ info: "info";
2004
+ }>;
2005
+ issue_type: z.ZodEnum<{
2006
+ contradiction: "contradiction";
2007
+ missing_beat: "missing_beat";
2008
+ off_format: "off_format";
2009
+ camera_motion_mismatch: "camera_motion_mismatch";
2010
+ }>;
2011
+ message: z.ZodString;
2012
+ suggested_fix: z.ZodString;
2013
+ }, z.core.$strip>>;
2014
+ scene_level_notes: z.ZodString;
2015
+ }, z.core.$strip>;
2016
+ type AuditPromptResult = z.infer<typeof AuditPromptResultSchema>;
2017
+ declare const ImprovePromptInputSchema: z.ZodObject<{
2018
+ shot_ids: z.ZodArray<z.ZodString>;
2019
+ field_targets: z.ZodArray<z.ZodEnum<{
2020
+ dialogue: "dialogue";
2021
+ action: "action";
2022
+ motion_prompt: "motion_prompt";
2023
+ }>>;
2024
+ }, z.core.$strip>;
2025
+ type ImprovePromptInput = z.infer<typeof ImprovePromptInputSchema>;
2026
+ declare const ImprovePromptResultSchema: z.ZodObject<{
2027
+ scene_id: z.ZodString;
2028
+ shots: z.ZodArray<z.ZodObject<{
2029
+ shot_id: z.ZodString;
2030
+ action: z.ZodOptional<z.ZodString>;
2031
+ motion_prompt: z.ZodOptional<z.ZodString>;
2032
+ dialogue_line: z.ZodOptional<z.ZodString>;
2033
+ reasoning: z.ZodString;
2034
+ }, z.core.$strip>>;
2035
+ }, z.core.$strip>;
2036
+ type ImprovePromptResult = z.infer<typeof ImprovePromptResultSchema>;
2037
+ declare const GenerateMotionInputSchema: z.ZodObject<{
2038
+ shot_ids: z.ZodArray<z.ZodString>;
2039
+ }, z.core.$strip>;
2040
+ declare const GenerateMotionResultSchema: z.ZodObject<{
2041
+ scene_id: z.ZodString;
2042
+ shots: z.ZodArray<z.ZodObject<{
2043
+ shot_id: z.ZodString;
2044
+ motion_prompt: z.ZodString;
2045
+ }, z.core.$strip>>;
2046
+ }, z.core.$strip>;
2047
+ type GenerateMotionResult = z.infer<typeof GenerateMotionResultSchema>;
2048
+ declare const OptimizeForModelInputSchema: z.ZodObject<{
2049
+ target_model: z.ZodString;
2050
+ }, z.core.$strip>;
2051
+ declare const OptimizeForModelResultSchema: z.ZodObject<{
2052
+ scene_id: z.ZodString;
2053
+ target_model: z.ZodString;
2054
+ shots: z.ZodArray<z.ZodObject<{
2055
+ shot_id: z.ZodString;
2056
+ action: z.ZodString;
2057
+ motion_prompt: z.ZodString;
2058
+ }, z.core.$strip>>;
2059
+ rationale: z.ZodString;
2060
+ }, z.core.$strip>;
2061
+ type OptimizeForModelResult = z.infer<typeof OptimizeForModelResultSchema>;
2062
+ declare const AddBRollResultSchema: z.ZodObject<{
2063
+ scene_id: z.ZodString;
2064
+ candidates: z.ZodArray<z.ZodObject<{
2065
+ proposed_insert_after_shot_id: z.ZodString;
2066
+ insert_kind: z.ZodEnum<{
2067
+ transition: "transition";
2068
+ reaction_shot: "reaction_shot";
2069
+ cutaway: "cutaway";
2070
+ establishing: "establishing";
2071
+ }>;
2072
+ shot: z.ZodObject<{
2073
+ shot_id: z.ZodString;
2074
+ camera: z.ZodObject<{
2075
+ shot_type: z.ZodEnum<{
2076
+ wide: "wide";
2077
+ medium: "medium";
2078
+ close_up: "close_up";
2079
+ extreme_close_up: "extreme_close_up";
2080
+ pov: "pov";
2081
+ over_shoulder: "over_shoulder";
2082
+ }>;
2083
+ angle: z.ZodEnum<{
2084
+ high: "high";
2085
+ low: "low";
2086
+ eye_level: "eye_level";
2087
+ dutch: "dutch";
2088
+ birds_eye: "birds_eye";
2089
+ }>;
2090
+ motion: z.ZodEnum<{
2091
+ pan: "pan";
2092
+ static: "static";
2093
+ tilt: "tilt";
2094
+ dolly: "dolly";
2095
+ tracking: "tracking";
2096
+ handheld: "handheld";
2097
+ }>;
2098
+ }, z.core.$strip>;
2099
+ shot_intensity_kind: z.ZodEnum<{
2100
+ establishing_shot: "establishing_shot";
2101
+ action_shot: "action_shot";
2102
+ dialogue_shot: "dialogue_shot";
2103
+ reaction_shot: "reaction_shot";
2104
+ climactic_shot: "climactic_shot";
2105
+ transition_shot: "transition_shot";
2106
+ }>;
2107
+ action: z.ZodString;
2108
+ dialogue_line: z.ZodNullable<z.ZodString>;
2109
+ duration_seconds: z.ZodNumber;
2110
+ motion_prompt: z.ZodString;
2111
+ start_state: z.ZodString;
2112
+ end_state: z.ZodString;
2113
+ continuity_with_previous: z.ZodNullable<z.ZodString>;
2114
+ shot_intent: z.ZodObject<{
2115
+ needs_multishot_reference: z.ZodDefault<z.ZodBoolean>;
2116
+ is_loopable: z.ZodDefault<z.ZodBoolean>;
2117
+ needs_music_suppression: z.ZodDefault<z.ZodBoolean>;
2118
+ is_match_cut: z.ZodDefault<z.ZodBoolean>;
2119
+ }, z.core.$strip>;
2120
+ visual_keyframe_prompt: z.ZodString;
2121
+ end_keyframe_prompt: z.ZodOptional<z.ZodString>;
2122
+ extends_shot_id: z.ZodOptional<z.ZodString>;
2123
+ bridge_image_prompt: z.ZodOptional<z.ZodString>;
2124
+ interpolation_keyframes: z.ZodOptional<z.ZodArray<z.ZodObject<{
2125
+ timestamp_sec: z.ZodNumber;
2126
+ prompt: z.ZodString;
2127
+ }, z.core.$strip>>>;
2128
+ interpolation_keyframe_urls: z.ZodOptional<z.ZodArray<z.ZodString>>;
2129
+ camera_path_directive: z.ZodOptional<z.ZodObject<{
2130
+ path_kind: z.ZodEnum<{
2131
+ dolly: "dolly";
2132
+ orbit: "orbit";
2133
+ crane: "crane";
2134
+ arc: "arc";
2135
+ reveal: "reveal";
2136
+ }>;
2137
+ parameters: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
2138
+ }, z.core.$strip>>;
2139
+ keyframe_asset_id: z.ZodOptional<z.ZodString>;
2140
+ keyframe_url: z.ZodOptional<z.ZodString>;
2141
+ video_asset_id: z.ZodOptional<z.ZodString>;
2142
+ video_url: z.ZodOptional<z.ZodString>;
2143
+ last_frame_asset_id: z.ZodOptional<z.ZodString>;
2144
+ last_frame_url: z.ZodOptional<z.ZodString>;
2145
+ audio_asset_id: z.ZodOptional<z.ZodString>;
2146
+ audio_url: z.ZodOptional<z.ZodString>;
2147
+ lipsynced_asset_id: z.ZodOptional<z.ZodString>;
2148
+ lipsynced_url: z.ZodOptional<z.ZodString>;
2149
+ bridged_frame_url: z.ZodOptional<z.ZodString>;
2150
+ accepted_match_cut_break: z.ZodOptional<z.ZodBoolean>;
2151
+ has_dialogue: z.ZodDefault<z.ZodBoolean>;
2152
+ actual_audio_duration_sec: z.ZodOptional<z.ZodNumber>;
2153
+ dialogue_no_cut_zone: z.ZodOptional<z.ZodNullable<z.ZodObject<{
2154
+ start: z.ZodNumber;
2155
+ end: z.ZodNumber;
2156
+ }, z.core.$strip>>>;
2157
+ cut_decision: z.ZodOptional<z.ZodObject<{
2158
+ in_offset_sec: z.ZodDefault<z.ZodNumber>;
2159
+ out_offset_sec: z.ZodDefault<z.ZodNumber>;
2160
+ transition_to_next: z.ZodEnum<{
2161
+ dissolve: "dissolve";
2162
+ hard_cut: "hard_cut";
2163
+ match_cut: "match_cut";
2164
+ overlap: "overlap";
2165
+ }>;
2166
+ transition_duration_sec: z.ZodOptional<z.ZodNumber>;
2167
+ beat_snap_seconds: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
2168
+ }, z.core.$strip>>;
2169
+ }, z.core.$strip>;
2170
+ rationale: z.ZodString;
2171
+ }, z.core.$strip>>;
2172
+ scene_duration_delta: z.ZodNumber;
2173
+ }, z.core.$strip>;
2174
+ type AddBRollResult = z.infer<typeof AddBRollResultSchema>;
2175
+ declare const BridgeToNextSceneInputSchema: z.ZodObject<{
2176
+ target_shot_id: z.ZodString;
2177
+ }, z.core.$strip>;
2178
+ declare const BridgeToNextSceneResultSchema: z.ZodObject<{
2179
+ scene_id: z.ZodString;
2180
+ target_shot_id: z.ZodString;
2181
+ bridge_image_prompt: z.ZodString;
2182
+ reasoning: z.ZodString;
2183
+ }, z.core.$strip>;
2184
+ type BridgeToNextSceneResult = z.infer<typeof BridgeToNextSceneResultSchema>;
2185
+ declare const AnchorSceneStyleResultSchema: z.ZodObject<{
2186
+ scene_id: z.ZodString;
2187
+ anchor_prompt: z.ZodString;
2188
+ asset_id: z.ZodString;
2189
+ asset_url: z.ZodString;
2190
+ credits_spent: z.ZodNumber;
2191
+ }, z.core.$strip>;
2192
+ type AnchorSceneStyleResult = z.infer<typeof AnchorSceneStyleResultSchema>;
2193
+ declare const AuditImagesShotEntrySchema: z.ZodObject<{
2194
+ shot_id: z.ZodString;
2195
+ ok: z.ZodBoolean;
2196
+ verdict: z.ZodNullable<z.ZodObject<{
2197
+ ok: z.ZodBoolean;
2198
+ issues: z.ZodArray<z.ZodObject<{
2199
+ type: z.ZodEnum<{
2200
+ style_drift: "style_drift";
2201
+ prompt_mismatch: "prompt_mismatch";
2202
+ continuity_break: "continuity_break";
2203
+ identity_mismatch: "identity_mismatch";
2204
+ composition_break: "composition_break";
2205
+ wardrobe_inconsistency: "wardrobe_inconsistency";
2206
+ }>;
2207
+ severity: z.ZodEnum<{
2208
+ warning: "warning";
2209
+ blocking: "blocking";
2210
+ info: "info";
2211
+ }>;
2212
+ message: z.ZodString;
2213
+ suggested_fix: z.ZodOptional<z.ZodString>;
2214
+ }, z.core.$strip>>;
2215
+ notes: z.ZodString;
2216
+ }, z.core.$strip>>;
2217
+ skipped: z.ZodBoolean;
2218
+ }, z.core.$strip>;
2219
+ type AuditImagesShotEntry = z.infer<typeof AuditImagesShotEntrySchema>;
2220
+ declare const AuditImagesResultSchema: z.ZodObject<{
2221
+ scene_id: z.ZodString;
2222
+ ok: z.ZodBoolean;
2223
+ shot_issues: z.ZodArray<z.ZodObject<{
2224
+ shot_id: z.ZodString;
2225
+ ok: z.ZodBoolean;
2226
+ verdict: z.ZodNullable<z.ZodObject<{
2227
+ ok: z.ZodBoolean;
2228
+ issues: z.ZodArray<z.ZodObject<{
2229
+ type: z.ZodEnum<{
2230
+ style_drift: "style_drift";
2231
+ prompt_mismatch: "prompt_mismatch";
2232
+ continuity_break: "continuity_break";
2233
+ identity_mismatch: "identity_mismatch";
2234
+ composition_break: "composition_break";
2235
+ wardrobe_inconsistency: "wardrobe_inconsistency";
2236
+ }>;
2237
+ severity: z.ZodEnum<{
2238
+ warning: "warning";
2239
+ blocking: "blocking";
2240
+ info: "info";
2241
+ }>;
2242
+ message: z.ZodString;
2243
+ suggested_fix: z.ZodOptional<z.ZodString>;
2244
+ }, z.core.$strip>>;
2245
+ notes: z.ZodString;
2246
+ }, z.core.$strip>>;
2247
+ skipped: z.ZodBoolean;
2248
+ }, z.core.$strip>>;
2249
+ summary: z.ZodString;
2250
+ }, z.core.$strip>;
2251
+ type AuditImagesResult = z.infer<typeof AuditImagesResultSchema>;
2252
+ declare const FixContinuityInputSchema: z.ZodObject<{
2253
+ target_shot_id: z.ZodString;
2254
+ }, z.core.$strip>;
2255
+ type FixContinuityInput = z.infer<typeof FixContinuityInputSchema>;
2256
+ declare const FixContinuityResultSchema: z.ZodObject<{
2257
+ scene_id: z.ZodString;
2258
+ target_shot_id: z.ZodString;
2259
+ action: z.ZodEnum<{
2260
+ regenerated: "regenerated";
2261
+ no_action_needed: "no_action_needed";
2262
+ }>;
2263
+ critic_verdict: z.ZodObject<{
2264
+ ok: z.ZodBoolean;
2265
+ issues: z.ZodArray<z.ZodObject<{
2266
+ type: z.ZodEnum<{
2267
+ style_drift: "style_drift";
2268
+ prompt_mismatch: "prompt_mismatch";
2269
+ continuity_break: "continuity_break";
2270
+ identity_mismatch: "identity_mismatch";
2271
+ composition_break: "composition_break";
2272
+ wardrobe_inconsistency: "wardrobe_inconsistency";
2273
+ }>;
2274
+ severity: z.ZodEnum<{
2275
+ warning: "warning";
2276
+ blocking: "blocking";
2277
+ info: "info";
2278
+ }>;
2279
+ message: z.ZodString;
2280
+ suggested_fix: z.ZodOptional<z.ZodString>;
2281
+ }, z.core.$strip>>;
2282
+ notes: z.ZodString;
2283
+ }, z.core.$strip>;
2284
+ new_keyframe_url: z.ZodOptional<z.ZodString>;
2285
+ new_keyframe_asset_id: z.ZodOptional<z.ZodString>;
2286
+ }, z.core.$strip>;
2287
+ type FixContinuityResult = z.infer<typeof FixContinuityResultSchema>;
2288
+ declare const ValidateMatchCutInputSchema: z.ZodObject<{
2289
+ target_shot_id: z.ZodString;
2290
+ }, z.core.$strip>;
2291
+ type ValidateMatchCutInput = z.infer<typeof ValidateMatchCutInputSchema>;
2292
+ declare const ValidateMatchCutResultSchema: z.ZodObject<{
2293
+ scene_id: z.ZodString;
2294
+ shot_pair: z.ZodTuple<[z.ZodString, z.ZodString], null>;
2295
+ match_strength: z.ZodEnum<{
2296
+ strong: "strong";
2297
+ moderate: "moderate";
2298
+ weak: "weak";
2299
+ break: "break";
2300
+ }>;
2301
+ critic_verdict: z.ZodObject<{
2302
+ ok: z.ZodBoolean;
2303
+ issues: z.ZodArray<z.ZodObject<{
2304
+ type: z.ZodEnum<{
2305
+ style_drift: "style_drift";
2306
+ prompt_mismatch: "prompt_mismatch";
2307
+ continuity_break: "continuity_break";
2308
+ identity_mismatch: "identity_mismatch";
2309
+ composition_break: "composition_break";
2310
+ wardrobe_inconsistency: "wardrobe_inconsistency";
2311
+ }>;
2312
+ severity: z.ZodEnum<{
2313
+ warning: "warning";
2314
+ blocking: "blocking";
2315
+ info: "info";
2316
+ }>;
2317
+ message: z.ZodString;
2318
+ suggested_fix: z.ZodOptional<z.ZodString>;
2319
+ }, z.core.$strip>>;
2320
+ notes: z.ZodString;
2321
+ }, z.core.$strip>;
2322
+ suggested_adjustments: z.ZodString;
2323
+ }, z.core.$strip>;
2324
+ type ValidateMatchCutResult = z.infer<typeof ValidateMatchCutResultSchema>;
2325
+
2326
+ /**
2327
+ * The parts of `settings.studio` that must not leave the owner's account.
2328
+ *
2329
+ * A shared production is read by anyone with the link. Three things inside the
2330
+ * document are the OWNER'S working state and nobody else's business:
2331
+ *
2332
+ * - `trash` — the recycle bin, which holds every shot, still and clip they
2333
+ * deleted, with prompts and urls intact. A share viewer receiving the bin is
2334
+ * the sharpest of the three: it hands out work the owner explicitly threw away.
2335
+ * - the in-flight job markers — `pendingClips` / `pendingStills` per shot, and
2336
+ * `pendingMusic` / `pendingDraft` on the document. A viewer cannot land any
2337
+ * of them and does not own them; all they carry across is job ids.
2338
+ * - `freecutDraftUrl` — an unsaved editor draft.
2339
+ *
2340
+ * Two more things are the owner's alone though neither is transient: a
2341
+ * scene's EMPTY media slots — unsubmitted drafts ({@link STUDIO_SHOT_DRAFT_KEYS})
2342
+ * — and a finished take's VOICE RECORD ({@link STUDIO_TAKE_VOICE_KEYS}), which
2343
+ * rides the canvas node's result rows rather than `settings`. The owner's own
2344
+ * reads and exports keep both; every other reader's projection drops them, and
2345
+ * drops them from the bin's deleted entries too.
2346
+ *
2347
+ * So is a LINKED (keyframe / sequence) production's owner state (T87), on the
2348
+ * same terms: the director's sequence recommendations
2349
+ * ({@link STUDIO_SEQUENCE_PLANNING_KEYS}), the current generation preferences
2350
+ * ({@link STUDIO_SEQUENCE_POLICY_KEYS} — emptied, not dropped), a take's
2351
+ * endpoint pins ({@link STUDIO_TAKE_SEQUENCE_KEYS}, on the result rows), a
2352
+ * sequence take unit's continuation review
2353
+ * ({@link STUDIO_SEQUENCE_UNIT_REVIEW_KEYS}), a unit result's frozen request
2354
+ * ({@link STUDIO_SEQUENCE_UNIT_MANIFEST_KEYS}), a keyframe's in-flight runs
2355
+ * and review record ({@link STUDIO_KEYFRAME_NODE_TRANSIENT_KEYS},
2356
+ * {@link STUDIO_KEYFRAME_TRANSIENT_KEYS}, {@link STUDIO_KEYFRAME_REVIEW_KEYS}),
2357
+ * and the owner's reason for waiving a keyframe's requirements, inside its
2358
+ * acceptance ({@link STUDIO_KEYFRAME_ACCEPTANCE_PRIVATE_KEYS}).
2359
+ *
2360
+ * They do NOT all live at the same level, and that is the whole reason this
2361
+ * file exists rather than one array: the writer puts `trash` and
2362
+ * `freecutDraftUrl` on `settings.studio` itself, and puts the per-shot markers
2363
+ * on the `settings.studio.shots[]` entry. A strip that walked only the top
2364
+ * level would pass its own test and still hand a share viewer every marker in
2365
+ * the production.
2366
+ *
2367
+ * It lives in `@nodaro/shared` because two independent readers need the SAME
2368
+ * list: the public share read (which is the reason the list exists) and the
2369
+ * production writer's own bundle projection. A second copy of a list like this
2370
+ * does not stay equal — it goes one key stale and the stale side is the one
2371
+ * that publishes.
2372
+ *
2373
+ * This is a plain JSON walker on purpose. `settings` is a free-form column that
2374
+ * a client owns end to end; the projection reads the keys it must drop and
2375
+ * nothing else, so it never needs — and must never grow — a dependency on
2376
+ * whatever writes the rest of the document.
2377
+ */
2378
+ /**
2379
+ * `settings.studio`'s OWN transient keys.
2380
+ *
2381
+ * The per-shot pending lists are on this list as well as the shot one on
2382
+ * purpose: nothing writes them here today, and a stray one from an older
2383
+ * client — or from a client that is not the studio editor at all — still must
2384
+ * not ride out to a viewer.
2385
+ */
2386
+ declare const STUDIO_TRANSIENT_KEYS: readonly ["trash", "pendingStills", "pendingClips", "pendingMusic", "pendingDraft", "freecutDraftUrl"];
2387
+ /**
2388
+ * ...and a SHOT entry's, which is where the per-shot markers actually are.
2389
+ *
2390
+ * `pendingClip` (singular) is the pre-concurrent-markers shape; the editor's
2391
+ * reader still migrates it on parse, so a row can still be carrying one and it
2392
+ * is still in-flight state.
2393
+ */
2394
+ declare const STUDIO_SHOT_TRANSIENT_KEYS: readonly ["pendingClips", "pendingClip", "pendingStills"];
2395
+ /**
2396
+ * ...and a SHOT entry's owner DRAFTS: the studio's empty media slots — a slot
2397
+ * the owner opened and filled in but has not generated from yet.
2398
+ *
2399
+ * Not transient — the owner's own exports and copies keep them — so they are
2400
+ * NOT on {@link STUDIO_SHOT_TRANSIENT_KEYS}. They are unsubmitted prose and
2401
+ * reference urls the owner never generated, so no OTHER reader receives them.
2402
+ * The studio codec keeps its own copy of these two keys for its own non-owner
2403
+ * projection.
2404
+ */
2405
+ declare const STUDIO_SHOT_DRAFT_KEYS: readonly ["stillSlots", "clipSlots"];
2406
+ /**
2407
+ * ...and a SHOT's 3D previsualization RUN STATE, on `shots[].previsualization`:
2408
+ * `pendingJobs` (the scene runs in flight) and `proSubmission` (a 3D Render Pro
2409
+ * submission's idempotency key and its exact priced body). Same reason as the
2410
+ * per-shot markers — they name jobs on the owner's account — and a sharper one
2411
+ * for the Pro key: carried out, it would let a replay adopt the owner's paid
2412
+ * run. A finished render and an unadopted result (`pendingPlan`) are results,
2413
+ * not run state, and stay.
2414
+ *
2415
+ * The PUBLIC share read's strip only ({@link stripStudioTransientSettings}),
2416
+ * mirroring the studio codec's non-owner projection (`stripTransientSettings`,
2417
+ * which drops the same two keys). A `view` read keeps them, as the codec's
2418
+ * read-only load does ({@link stripStudioDraftSettings}).
2419
+ */
2420
+ declare const STUDIO_PREVIZ_RUN_STATE_KEYS: readonly ["pendingJobs", "proSubmission"];
2421
+ /**
2422
+ * ...and a finished TAKE's voice record (studio ruling T42): the plan a clip
2423
+ * was recast with (`revoiceTo` — the owner's voice ids) and the Voice control's
2424
+ * mode (`voiceMode`). Both live on the RESULT, so on a canvas node's
2425
+ * `data.generatedResults` rows — never on `settings.studio.shots[]`, which is
2426
+ * why no settings strip reaches them ({@link stripStudioTakeVoiceRecords} does).
2427
+ *
2428
+ * Results only: a scene recipe's `voiceMode` and a clip's `revoicedVoiceId` /
2429
+ * `revoicedVoiceName` are not a take's record and stay. The studio codec keeps
2430
+ * its own copy of these two keys (`READER_PRIVATE_TAKE_KEYS`) for its own
2431
+ * non-owner projections, as it does the slot pair.
2432
+ */
2433
+ declare const STUDIO_TAKE_VOICE_KEYS: readonly ["revoiceTo", "voiceMode"];
2434
+ /**
2435
+ * ...and a finished TAKE's SEQUENCE PINS (studio ruling T87): the exact
2436
+ * keyframe results a linked scene's clip was generated between
2437
+ * (`sequenceEndpoints`). Like the voice record it rides the RESULT, on a canvas
2438
+ * node's `data.generatedResults` rows, so the same walker drops both
2439
+ * ({@link stripStudioTakeVoiceRecords}). The in-flight marker carrying the same
2440
+ * pins (`pendingClips[].sequenceEndpoints`) already goes whole with
2441
+ * {@link STUDIO_SHOT_TRANSIENT_KEYS}.
2442
+ */
2443
+ declare const STUDIO_TAKE_SEQUENCE_KEYS: readonly ["sequenceEndpoints"];
2444
+ /**
2445
+ * ...and a LINKED production's SEQUENCE PLANNING state on `settings.studio`
2446
+ * itself (T87): `sequenceRecommendations`, the director's suggested generation
2447
+ * policies for each sequence, with their reasons and provenance.
2448
+ *
2449
+ * The studio codec's non-owner view withholds more than the lists here carry
2450
+ * — a take's `policy` and `compilation`, a unit's result rows (on the unit
2451
+ * video node's `data.sequenceUnitResults`, mirrored in its `generatedResults`),
2452
+ * a keyframe's `plan`, its `acceptance` record and all its results but the
2453
+ * preview and the accepted one — because it builds that view AFTER reading
2454
+ * the row. These strips drop KEYS from the stored row; they never filter rows
2455
+ * or rewrite records, so all of it still goes out, the acceptance without its
2456
+ * waiver reason ({@link STUDIO_KEYFRAME_ACCEPTANCE_PRIVATE_KEYS}).
2457
+ *
2458
+ * Part of it the codec's reader requires (0.13.0's `parseProduction`; without
2459
+ * it every reader's load of the production fails): each take's `policy` and
2460
+ * `compilation`; every unit result row some take selects, plus, for the take
2461
+ * selected for export, the existing-clip opening row its policy names; a
2462
+ * keyframe plan's `id`, `label`, `revision`, `frame` (any record, `{}`
2463
+ * included) and `requirements` (a list, empty included); and the result its
2464
+ * `previewResultKey` names. The rest it can do without: the unit node's
2465
+ * mirror, the unit results no take selects, a keyframe's other results, its
2466
+ * plan's `frame` content and `references`, and its `acceptance` — from which
2467
+ * the non-owner view reads the accepted result. Studio ruling T94 keeps all of
2468
+ * it visible.
2469
+ */
2470
+ declare const STUDIO_SEQUENCE_PLANNING_KEYS: readonly ["sequenceRecommendations"];
2471
+ /**
2472
+ * ...and a sequence TAKE's per-unit review (T87), on
2473
+ * `settings.studio.sequenceTakes[].units[]`: `continuationAcceptance` — which
2474
+ * result the owner accepted as the next continuation's predecessor, who, when,
2475
+ * and the review checks.
2476
+ */
2477
+ declare const STUDIO_SEQUENCE_UNIT_REVIEW_KEYS: readonly ["continuationAcceptance"];
2478
+ /**
2479
+ * ...and a LINKED production's current GENERATION PREFERENCES on
2480
+ * `settings.studio` (T87): `sequenceGenerationPolicies`, the policy the owner
2481
+ * last set for each sequence — what its next take would be made with.
2482
+ *
2483
+ * EMPTIED, never deleted: a non-empty record goes out as `{}`. The codec's
2484
+ * reader parses the key as a record whenever a production has takes, and
2485
+ * reads an empty one fine. A row that does not carry the key never gains it:
2486
+ * that reader takes the key alone for take state, and refuses it on a
2487
+ * production that never declared takes. Each take's own `policy` — the one it
2488
+ * was made with — stays (the reader requires it), so `{}` withholds the
2489
+ * owner's current preference, not the takes' history.
2490
+ */
2491
+ declare const STUDIO_SEQUENCE_POLICY_KEYS: readonly ["sequenceGenerationPolicies"];
2492
+ /**
2493
+ * ...and a sequence unit RESULT's frozen request (T87), on a unit video node's
2494
+ * `data.sequenceUnitResults[]` rows: `requestManifest` — the submission as the
2495
+ * host froze it, with the compiled prompts, the reference media, the endpoint
2496
+ * pins, the take's policy and snapshots of the owner's scenes as they stood
2497
+ * then. Optional to the codec's reader; the rest of the row stays.
2498
+ */
2499
+ declare const STUDIO_SEQUENCE_UNIT_MANIFEST_KEYS: readonly ["requestManifest"];
2500
+ /**
2501
+ * ...and a KEYFRAME's in-flight image runs (T87, on T22's terms), which the
2502
+ * writer keeps on the frame's image node: `data.keyframePendingImages`. Each
2503
+ * names a job on the owner's account, with the frame it was submitted with and
2504
+ * that submission's provenance; a reader can land none of them.
2505
+ */
2506
+ declare const STUDIO_KEYFRAME_NODE_TRANSIENT_KEYS: readonly ["keyframePendingImages"];
2507
+ /**
2508
+ * ...and the same runs on a DELETED keyframe, where the bin keeps the whole
2509
+ * frame (`trash[].keyframe`, `kind: "keyframe"`) and calls them `pendingImages`.
2510
+ */
2511
+ declare const STUDIO_KEYFRAME_TRANSIENT_KEYS: readonly ["pendingImages"];
2512
+ /**
2513
+ * ...and a KEYFRAME's review record (T87): `rejections` — which of its results
2514
+ * the owner sent back for revision, who, when and why — on each
2515
+ * `settings.studio.keyframes[]` entry and on a deleted keyframe in the bin.
2516
+ * Optional to the codec's reader. The frame's `acceptance` stays, without its
2517
+ * waiver reason ({@link STUDIO_KEYFRAME_ACCEPTANCE_PRIVATE_KEYS}): every reader
2518
+ * is shown the accepted result, and that is where the reader finds it.
2519
+ */
2520
+ declare const STUDIO_KEYFRAME_REVIEW_KEYS: readonly ["rejections"];
2521
+ /**
2522
+ * ...and a KEYFRAME acceptance's private part (T87): `waivedReason`, the
2523
+ * owner's own words on why the requirements they waived are acceptable. It is
2524
+ * one level down, inside the `acceptance` record of each
2525
+ * `settings.studio.keyframes[]` entry and of a deleted keyframe in the bin, so
2526
+ * the walk goes into the record ({@link keyframeForReader}).
2527
+ *
2528
+ * Optional to the codec's reader; the rest of the record stays, the waived
2529
+ * requirement checks included. Only the codec's resolution of an accepted
2530
+ * frame checks the reason (`reviewValid`): in a copy made from a stripped row,
2531
+ * a frame that waived a requirement must be accepted again before the codec
2532
+ * resolves it for a dependent frame or a clip.
2533
+ */
2534
+ declare const STUDIO_KEYFRAME_ACCEPTANCE_PRIVATE_KEYS: readonly ["waivedReason"];
2535
+ /**
2536
+ * A production's `settings` with the owner's working state removed.
2537
+ *
2538
+ * Copy-on-write, and structurally: it rebuilds the objects without those keys
2539
+ * rather than deleting from the caller's, so the stored row is untouched. A
2540
+ * `settings` with no `studio` comes back unchanged — this is a studio concern,
2541
+ * and a workflow that is not a production has nothing here to strip.
2542
+ *
2543
+ * Takes and returns `unknown` because the column is free-form and every caller
2544
+ * already holds it as whatever its own layer calls JSON; narrowing here would
2545
+ * only move the cast one line up.
2546
+ */
2547
+ declare function stripStudioTransientSettings(settings: unknown): unknown;
2548
+ /**
2549
+ * A workflow's `nodes` without the owner's state that rides a NODE rather
2550
+ * than `settings`: every result row's voice record
2551
+ * ({@link STUDIO_TAKE_VOICE_KEYS}, T42) and sequence pins
2552
+ * ({@link STUDIO_TAKE_SEQUENCE_KEYS}, T87), every sequence unit result's
2553
+ * frozen request ({@link STUDIO_SEQUENCE_UNIT_MANIFEST_KEYS}, T87), and a
2554
+ * keyframe image node's in-flight runs
2555
+ * ({@link STUDIO_KEYFRAME_NODE_TRANSIENT_KEYS}, T87). Named for the first.
2556
+ *
2557
+ * Every node is walked, not only a clip, unit or keyframe node: the keys exist
2558
+ * only on those, and a type list would be one more thing to keep in step.
2559
+ * Copy-on-write, and the SAME array back when no node carries any of the keys.
2560
+ * Anything that is not node-shaped rides through untouched: this runs on
2561
+ * whatever is in the column.
2562
+ */
2563
+ declare function stripStudioTakeVoiceRecords(nodes: unknown): unknown;
2564
+ /**
2565
+ * `settings` with every SHOT's owner-private state removed — its empty media
2566
+ * slots ({@link STUDIO_SHOT_DRAFT_KEYS}) and its in-flight run markers
2567
+ * ({@link STUDIO_SHOT_TRANSIENT_KEYS}) — and the bin kept WITHOUT the owner's
2568
+ * drafts in it ({@link stripBin}: deleted empty slots, deleted takes' voice
2569
+ * records) — and without a linked production's owner state
2570
+ * ({@link stripLinkedOwnerState}, T87). The document-level markers and
2571
+ * everything else stay.
2572
+ *
2573
+ * For a reader the owner let LOOK but not edit: a `view` reader's
2574
+ * `GET /v1/workflows/:id` and `GET /v1/workflows/:id/export`, and the MCP
2575
+ * `get_workflow_json` / `export_workflow` tools on the same access — each
2576
+ * through {@link stripStudioDraftWorkflow}, which strips the nodes as well.
2577
+ * The markers go with the slots because a viewer cannot land the owner's runs,
2578
+ * and a marker for a run started from a slot carries that slot's unsent
2579
+ * inputs. An editor keeps all of it: their editor saves `settings` back whole.
2580
+ *
2581
+ * The very same object back when neither a shot, the bin nor the linked
2582
+ * owner state carries any of it.
2583
+ */
2584
+ declare function stripStudioDraftSettings(settings: unknown): unknown;
2585
+ /**
2586
+ * A workflow row as a reader the owner let LOOK but not edit receives it: the
2587
+ * owner's state off its `nodes` ({@link stripStudioTakeVoiceRecords}) and the
2588
+ * owner's drafts, runs and linked-production state off its `settings`
2589
+ * ({@link stripStudioDraftSettings}).
2590
+ *
2591
+ * The ONE strip every `view` door applies, so no door can strip the settings
2592
+ * and forget the nodes. A half the row does not carry is not added. Copy-on-
2593
+ * write, and the very same row back when neither half changed.
2594
+ */
2595
+ declare function stripStudioDraftWorkflow<T extends {
2596
+ nodes?: unknown;
2597
+ settings?: unknown;
2598
+ }>(row: T): T;
2599
+
2600
+ /** Public workflow capability marker; creative planning stays in the Studio codec. */
2601
+ declare const STUDIO_DEPENDENT_FRAMES_CAPABILITY = "studio-dependent-frames-v1";
2602
+ declare class SequenceExecutionRequiredError extends Error {
2603
+ readonly nodeIds: readonly string[];
2604
+ readonly code = "sequence_execution_required";
2605
+ readonly statusCode = 400;
2606
+ constructor(nodeIds: readonly string[]);
2607
+ }
2608
+ /** A missing declaration must not make a recognizable dependency node runnable. */
2609
+ declare function requiresSequenceExecution(node: {
2610
+ data?: unknown;
2611
+ }): boolean;
2612
+ declare function assertCanvasExecutionAllowed(nodes: readonly {
2613
+ id: string;
2614
+ data?: unknown;
2615
+ }[]): void;
2616
+
2617
+ export { ACTIVE_SCENE_HELPERS, ANIMATE_SUB_GATES, type AddBRollResult, AddBRollResultSchema, type AnchorSceneStyleResult, AnchorSceneStyleResultSchema, type AnimateSubGate, AnimateSubGateSchema, type AuditImagesResult, AuditImagesResultSchema, type AuditImagesShotEntry, AuditImagesShotEntrySchema, AuditPromptIssueSchema, type AuditPromptResult, AuditPromptResultSchema, BridgeToNextSceneInputSchema, type BridgeToNextSceneResult, BridgeToNextSceneResultSchema, CHAT_ENABLED_STAGES, CHAT_STAGES, CHAT_TURN_CAPS, CHAT_WIRED_STAGES, type CastCoverageCriticVerdict, CastCoverageCriticVerdictSchema, type CharacterImageCriticVerdict, CharacterImageCriticVerdictSchema, CharacterMetadataSchema, type CharacterVoiceSpec, type ChatEnabledStage, type ChatTurnResponse, ChatTurnResponseSchema, CriticIssueSchema, DEFAULT_CHARACTER_ANGLE_COUNT, DEFAULT_CHARACTER_EXPRESSION_COUNT, type DetectionResult, DetectionResultSchema, type DialogueLine, EMOTIONAL_BEAT, ENTITY_STATUSES, ENTITY_TOOL_RETRY_CAP, ENTITY_TYPES, type EntityMetadata, EntityMetadataSchema, type EntityRejectInput, EntityRejectInputSchema, type EntityStaleEvent, EntityStaleEventSchema, type EntityStateChangeEvent, EntityStateChangeEventSchema, type EntityStatus, type EntityType, type FixContinuityInput, FixContinuityInputSchema, type FixContinuityResult, FixContinuityResultSchema, GLOBAL_MAX_DURATION_SECONDS, GenerateMotionInputSchema, type GenerateMotionResult, GenerateMotionResultSchema, HELPERS_SHIPPED_IN_1B3, IMAGE_CRITIC_LEAF_MODES, IMAGE_CRITIC_MAX_RETRIES, IMAGE_CRITIC_METADATA_KEYS, IMAGE_CRITIC_MIN_ADHERENCE_SCORE, IMAGE_CRITIC_MODES, IMAGE_CRITIC_UNRESOLVABLE, type ImageCriticIssue, ImageCriticIssueSchema, type ImageCriticLeafMode, type ImageCriticMetadataKey, type ImageCriticMode, type ImageCriticNodeIssue, type ImageCriticResult, ImageCriticResultSchema, type ImageCriticVerdict, ImageCriticVerdictSchema, type ImprovePromptInput, ImprovePromptInputSchema, type ImprovePromptResult, ImprovePromptResultSchema, type JsonPatch, type LocationImageCriticVerdict, LocationImageCriticVerdictSchema, LocationMetadataSchema, LocationsCoverageCriticIssueSchema, type LocationsCoverageCriticVerdict, LocationsCoverageCriticVerdictSchema, MATCH_CUT_BREAK_GATE, MAX_LOCATION_VARIANTS, ObjectMetadataSchema, type ObjectsValidationIssue, type ObjectsValidationResult, OptimizeForModelInputSchema, type OptimizeForModelResult, OptimizeForModelResultSchema, PER_FORMAT_DURATION_BOUNDS, PIPELINE_ACCEPTED_IMAGE_MODELS, PIPELINE_ACCEPTED_SCRIPT_LLMS, PIPELINE_ACTIVATION_MODES, PIPELINE_FORMATS, PIPELINE_HARD_TIMEOUT_MS, PIPELINE_LEGACY_PINNED_IMAGE_MODELS, PIPELINE_LEGACY_PINNED_SCRIPT_LLMS, PIPELINE_MODEL_STAGES, PIPELINE_MODES, PIPELINE_OUTPUT_RESOLUTIONS, PIPELINE_PINNABLE_IMAGE_MODELS, PIPELINE_PINNABLE_SCRIPT_LLMS, PIPELINE_PINNABLE_VIDEO_MODELS, PIPELINE_STAGE_NAMES, PIPELINE_STAGE_TIMEOUT_MS, PIPELINE_TYPES, type PipelineActivationMode, type PipelineCompletedEvent, PipelineCompletedEventSchema, type PipelineConfig, PipelineConfigSchema, type PipelineDriftSummary, PipelineDriftSummarySchema, type PipelineEditorDecisionsReadyEvent, PipelineEditorDecisionsReadyEventSchema, type PipelineEvent, type PipelineForkedEvent, PipelineForkedEventSchema, type PipelineFormat, type PipelineInput, PipelineInputSchema, type PipelineLifecycleEvent, type PipelineMode, type PipelineModelStage, type PipelineMusicReadyEvent, PipelineMusicReadyEventSchema, type PipelineOutputResolution, type PipelinePinnableImageModel, type PipelinePinnableScriptLlm, type PipelinePinnableVideoModel, type PipelineStageName, PipelineStageNameSchema, type PipelineStageStatus, PipelineStageStatusSchema, type PipelineState, PipelineStateSchema, type PipelineStatus, PipelineStatusSchema, type PipelineType, type ProposedChange, type ResolvedDialogueVoiceLine, SCENE_HELPER_NAMES, SHORT_FILM_ANGLE_COUNT, SHORT_FILM_EXPRESSION_COUNT, SHORT_FILM_VARIANT_THRESHOLD_SEC, STAGE_PATCH_SCHEMA, STUDIO_DEPENDENT_FRAMES_CAPABILITY, STUDIO_KEYFRAME_ACCEPTANCE_PRIVATE_KEYS, STUDIO_KEYFRAME_NODE_TRANSIENT_KEYS, STUDIO_KEYFRAME_REVIEW_KEYS, STUDIO_KEYFRAME_TRANSIENT_KEYS, STUDIO_PREVIZ_RUN_STATE_KEYS, STUDIO_SEQUENCE_PLANNING_KEYS, STUDIO_SEQUENCE_POLICY_KEYS, STUDIO_SEQUENCE_UNIT_MANIFEST_KEYS, STUDIO_SEQUENCE_UNIT_REVIEW_KEYS, STUDIO_SHOT_DRAFT_KEYS, STUDIO_SHOT_TRANSIENT_KEYS, STUDIO_TAKE_SEQUENCE_KEYS, STUDIO_TAKE_VOICE_KEYS, STUDIO_TRANSIENT_KEYS, type SceneHelperName, SceneHelperNameSchema, SceneSpecSchema, type ScriptCriticVerdict, ScriptCriticVerdictSchema, SequenceExecutionRequiredError, type SharedVoice, type ShowrunnerPlan, ShowrunnerPlanSchema, type StageAwaitingSubGateEvent, StageAwaitingSubGateEventSchema, type StoryboardCohesionCriticVerdict, StoryboardCohesionCriticVerdictSchema, type StyleDirectives, StyleDirectivesSchema, type SubGateName, SubGateNameSchema, TIER_MAX_PIPELINE_COST_CREDITS, TIER_PIPELINE_PARALLELISM, VIDEO_CRITIC_FRAME_MODES, VIDEO_CRITIC_MAX_RETRIES, VIDEO_CRITIC_METADATA_KEYS, VIDEO_CRITIC_MIN_ADHERENCE_SCORE, VIDEO_CRITIC_RESERVED_CREDITS_PER_SHOT, type ValidateMatchCutInput, ValidateMatchCutInputSchema, type ValidateMatchCutResult, ValidateMatchCutResultSchema, type VideoCriticFrameMode, type VideoCriticMetadataKey, type VideoCriticShotFields, type VideoCriticVerdict, VideoCriticVerdictSchema, type Voice, type VoiceClone, type VoiceLibraryParams, type VoiceLibraryResponse, type VoiceMatch, VoiceMatchSchema, type VoiceType, assertCanvasExecutionAllowed, clearImageCriticMetadata, clearVideoCriticMetadata, parseAttributedDialogue, requiresSequenceExecution, resolveDialogueVoices, resolvePipelineModel, stripStudioDraftSettings, stripStudioDraftWorkflow, stripStudioTakeVoiceRecords, stripStudioTransientSettings, validateDurationForFormat, validateModeActivation, validateObjects };