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