@nodaro/sdk 2.34.0 → 2.38.0

package/dist/{chunk-RHJRLXKY.cjs.map → chunk-7XOK277W.cjs.map}

@@ -1 +1 @@
-{"version":3,"sources":["../src/resources/edit-use-case-inputs.ts","../src/resources/edit.ts"],"names":["isUseCaseNodeType","NodaroError","USE_CASE_NODE_TYPES","ForbiddenError","resolveEditPlanSources","describeAudioSyncOffsetIssue","transcriptSpeakerLabels","speakerMapResultOf","cameraSwitchSpeakerMap","edl","remapTranscriptThroughEdl"],"mappings":";;;;;;;AA+GO,IAAM,eAAA,GAAkB,CAAC,MAAA,EAAQ,KAAA,EAAO,OAAO,MAAM;AA4BrD,IAAM,wBAAA,GAA2B;AACjC,IAAM,wBAAA,GAA2B;AAyGxC,SAAS,eAAiD,KAAA,EAAmC;AAC3F,EAAA,MAAM,EAAE,QAAA,EAAU,SAAA,EAAW,gBAAgB,OAAA,EAAS,GAAG,MAAK,GAAI,KAAA;AAClE,EAAA,IAAI,aAAa,MAAA,IAAa,SAAA,KAAc,QAAW,MAAM,IAAI,UAAU,sCAAsC,CAAA;AACjH,EAAA,MAAM,aAAa,SAAA,KAAc,QAAA,KAAa,MAAA,GAAY,CAAC,QAAQ,CAAA,GAAI,MAAA,CAAA;AACvE,EAAA,IAAI,CAAC,UAAA,EAAY,MAAM,IAAI,UAAU,4BAA4B,CAAA;AACjE,EAAA,OAAO;AAAA,IACL,SAAA,EAAW,CAAC,GAAG,UAAU,CAAA;AAAA,IACzB,GAAI,cAAA,KAAmB,MAAA,GAAY,EAAE,cAAA,KAAmB,EAAC;AAAA,IACzD,GAAI,OAAA,KAAY,MAAA,GAAY,EAAE,OAAA,KAAY,EAAC;AAAA,IAC3C,GAAG,MAAA,CAAO,WAAA,CAAY,MAAA,CAAO,QAAQ,IAAI,CAAA,CAAE,MAAA,CAAO,CAAC,GAAG,CAAC,CAAA,KAAM,CAAA,KAAM,MAAS,CAAC;AAAA,GAC/E;AACF;AAOO,SAAS,eAAA,CAAmB,OAAsC,IAAA,EAAiE;AACxI,EAAA,IAAI,IAAA;AACJ,EAAA,IAAI;AACF,IAAA,IAAA,GAAO,KAAA,EAAM;AAAA,EACf,SAAS,GAAA,EAAK;AACZ,IAAA,OAAO,OAAA,CAAQ,OAAO,GAAG,CAAA;AAAA,EAC3B;AACA,EAAA,OAAO,KAAK,IAAI,CAAA;AAClB;AAEO,SAAS,YAAY,KAAA,EAAqD;AAC/E,EAAA,OAAO,eAAe,KAAK,CAAA;AAC7B;AAEO,SAAS,aAAa,KAAA,EAAsD;AACjF,EAAA,OAAO,cAAA,CAAe;AAAA,IACpB,UAAU,KAAA,CAAM,QAAA;AAAA,IAChB,GAAI,MAAM,QAAA,KAAa,MAAA,GAAY,EAAE,QAAA,EAAU,KAAA,CAAM,QAAA,EAAS,GAAI,EAAC;AAAA,IACnE,GAAI,MAAM,YAAA,KAAiB,MAAA,GAAY,EAAE,YAAA,EAAc,KAAA,CAAM,YAAA,EAAa,GAAI,EAAC;AAAA,IAC/E,GAAI,MAAM,UAAA,KAAe,MAAA,GAAY,EAAE,UAAA,EAAY,KAAA,CAAM,UAAA,EAAW,GAAI;AAAC,GAC1E,CAAA;AACH;AAEO,SAAS,YAAY,KAAA,EAAqD;AAC/E,EAAA,OAAO,cAAA,CAAe;AAAA,IACpB,UAAU,KAAA,CAAM,QAAA;AAAA,IAChB,WAAW,KAAA,CAAM,SAAA;AAAA,IACjB,gBAAgB,KAAA,CAAM,cAAA;AAAA,IACtB,SAAS,KAAA,CAAM,OAAA;AAAA,IACf,GAAI,MAAM,YAAA,KAAiB,MAAA,GAAY,EAAE,YAAA,EAAc,KAAA,CAAM,YAAA,EAAa,GAAI,EAAC;AAAA;AAAA,IAE/E,GAAI,MAAM,OAAA,KAAY,MAAA,GAAY,EAAE,OAAA,EAAS,KAAA,CAAM,OAAA,EAAQ,GAAI,EAAC;AAAA,IAChE,GAAI,MAAM,kBAAA,KAAuB,MAAA,GAAY,EAAE,kBAAA,EAAoB,KAAA,CAAM,kBAAA,EAAmB,GAAI,EAAC;AAAA,IACjG,GAAI,MAAM,QAAA,KAAa,MAAA,GAAY,EAAE,QAAA,EAAU,KAAA,CAAM,QAAA,EAAS,GAAI,EAAC;AAAA,IACnE,GAAI,MAAM,YAAA,KAAiB,MAAA,GAAY,EAAE,YAAA,EAAc,KAAA,CAAM,YAAA,EAAa,GAAI,EAAC;AAAA,IAC/E,GAAI,MAAM,UAAA,KAAe,MAAA,GAAY,EAAE,UAAA,EAAY,KAAA,CAAM,UAAA,EAAW,GAAI;AAAC,GAC1E,CAAA;AACH;AAGO,SAAS,aAAa,KAAA,EAA+C;AAC1E,EAAA,OAAO,eAAe,KAAK,CAAA;AAC7B;AAGO,SAAS,kBAAkB,KAAA,EAAoD;AACpF,EAAA,OAAO,eAAe,KAAK,CAAA;AAC7B;ACEA,IAAM,cAAA,GAAiB,CAAC,IAAA,KAA6D,CAAA,IAAA,EAAO,IAAI,CAAA,SAAA,CAAA;AAiEhG,SAAS,mBAAmB,OAAA,EAAuE;AACjG,EAAA,OAAO,OAAA,EAAS,cAAA,GAAiB,EAAE,OAAA,EAAS,EAAE,mBAAmB,OAAA,CAAQ,cAAA,EAAe,EAAE,GAAI,EAAC;AACjG;AAsCO,IAAM,eAAN,MAAmB;AAAA,EACxB,YAAoB,MAAA,EAA0B;AAA1B,IAAA,IAAA,CAAA,MAAA,GAAA,MAAA;AAAA,EAA2B;AAAA,EAA3B,MAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAMpB,cAAc,KAAA,EAAmD;AAC/D,IAAA,OAAO,IAAA,CAAK,MAAA,CAAO,OAAA,CAAQ,MAAA,EAAQ,oBAAA,EAAsB;AAAA,MACvD,IAAA,EAAM;AAAA,QACJ,UAAU,KAAA,CAAM,QAAA;AAAA,QAChB,GAAI,MAAM,WAAA,KAAgB,MAAA,GAAY,EAAE,WAAA,EAAa,KAAA,CAAM,WAAA,EAAY,GAAI,EAAC;AAAA,QAC5E,GAAI,MAAM,YAAA,KAAiB,MAAA,GAAY,EAAE,YAAA,EAAc,KAAA,CAAM,YAAA,EAAa,GAAI,EAAC;AAAA,QAC/E,GAAI,MAAM,KAAA,KAAU,MAAA,GAAY,EAAE,KAAA,EAAO,KAAA,CAAM,KAAA,EAAM,GAAI,EAAC;AAAA,QAC1D,GAAI,MAAM,UAAA,KAAe,MAAA,GAAY,EAAE,UAAA,EAAY,KAAA,CAAM,UAAA,EAAW,GAAI;AAAC;AAC3E,KACD,CAAA;AAAA,EACH;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAWA,UAAU,KAAA,EAA+C;AACvD,IAAA,OAAO,IAAA,CAAK,MAAA,CAAO,OAAA,CAAQ,MAAA,EAAQ,gBAAA,EAAkB;AAAA,MACnD,IAAA,EAAM;AAAA,QACJ,OAAA,EAAS,KAAA,CAAM,OAAA,CAAQ,GAAA,CAAI,CAAC,CAAA,MAAO,EAAE,EAAA,EAAI,CAAA,CAAE,EAAA,EAAI,GAAA,EAAK,CAAA,CAAE,KAAI,CAAE,CAAA;AAAA,QAC5D,GAAI,MAAM,SAAA,KAAc,MAAA,GAAY,EAAE,SAAA,EAAW,KAAA,CAAM,SAAA,EAAU,GAAI,EAAC;AAAA,QACtE,GAAI,MAAM,UAAA,KAAe,MAAA,GAAY,EAAE,UAAA,EAAY,KAAA,CAAM,UAAA,EAAW,GAAI;AAAC;AAC3E,KACD,CAAA;AAAA,EACH;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EASA,WAAW,KAAA,EAAgD;AACzD,IAAA,OAAO,IAAA,CAAK,MAAA,CAAO,OAAA,CAAQ,MAAA,EAAQ,iBAAA,EAAmB;AAAA,MACpD,IAAA,EAAM;AAAA,QACJ,OAAA,EAAS,MAAM,OAAA,CAAQ,GAAA,CAAI,CAAC,CAAA,MAAO,EAAE,EAAA,EAAI,CAAA,CAAE,EAAA,EAAI,GAAA,EAAK,EAAE,GAAA,EAAK,GAAI,CAAA,CAAE,IAAA,GAAO,EAAE,IAAA,EAAM,EAAE,IAAA,EAAK,GAAI,EAAC,EAAG,CAAE,CAAA;AAAA,QACjG,YAAY,KAAA,CAAM,UAAA;AAAA,QAClB,GAAI,MAAM,OAAA,KAAY,MAAA,GAAY,EAAE,OAAA,EAAS,KAAA,CAAM,OAAA,EAAQ,GAAI,EAAC;AAAA,QAChE,GAAI,MAAM,cAAA,KAAmB,MAAA,GAAY,EAAE,cAAA,EAAgB,KAAA,CAAM,cAAA,EAAe,GAAI,EAAC;AAAA,QACrF,GAAI,MAAM,YAAA,KAAiB,MAAA,GAAY,EAAE,YAAA,EAAc,KAAA,CAAM,YAAA,EAAa,GAAI,EAAC;AAAA,QAC/E,GAAI,MAAM,QAAA,KAAa,MAAA,GAAY,EAAE,QAAA,EAAU,KAAA,CAAM,QAAA,EAAS,GAAI,EAAC;AAAA,QACnE,GAAI,MAAM,UAAA,KAAe,MAAA,GAAY,EAAE,UAAA,EAAY,KAAA,CAAM,UAAA,EAAW,GAAI;AAAC;AAC3E,KACD,CAAA;AAAA,EACH;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAQA,SAAS,KAAA,EAA8C;AACrD,IAAA,OAAO,IAAA,CAAK,MAAA,CAAO,OAAA,CAAQ,MAAA,EAAQ,eAAA,EAAiB;AAAA,MAClD,IAAA,EAAM;AAAA,QACJ,KAAK,KAAA,CAAM,GAAA;AAAA,QACX,GAAI,MAAM,OAAA,KAAY,MAAA,GAAY,EAAE,OAAA,EAAS,KAAA,CAAM,OAAA,EAAQ,GAAI,EAAC;AAAA,QAChE,GAAI,MAAM,UAAA,KAAe,MAAA,GAAY,EAAE,UAAA,EAAY,KAAA,CAAM,UAAA,EAAW,GAAI,EAAC;AAAA,QACzE,GAAI,MAAM,MAAA,KAAW,MAAA,GAAY,EAAE,MAAA,EAAQ,KAAA,CAAM,MAAA,EAAO,GAAI,EAAC;AAAA,QAC7D,GAAI,MAAM,OAAA,KAAY,MAAA,GAAY,EAAE,OAAA,EAAS,KAAA,CAAM,OAAA,EAAQ,GAAI,EAAC;AAAA,QAChE,GAAI,MAAM,WAAA,KAAgB,MAAA,GAAY,EAAE,WAAA,EAAa,KAAA,CAAM,WAAA,EAAY,GAAI,EAAC;AAAA,QAC5E,GAAI,MAAM,OAAA,KAAY,MAAA,GAAY,EAAE,OAAA,EAAS,KAAA,CAAM,OAAA,EAAQ,GAAI,EAAC;AAAA,QAChE,GAAI,MAAM,SAAA,KAAc,MAAA,GAAY,EAAE,SAAA,EAAW,KAAA,CAAM,SAAA,EAAU,GAAI,EAAC;AAAA,QACtE,GAAI,MAAM,UAAA,KAAe,MAAA,GAAY,EAAE,UAAA,EAAY,KAAA,CAAM,UAAA,EAAW,GAAI;AAAC;AAC3E,KACD,CAAA;AAAA,EACH;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAUA,cAAA,CAAe,OAA4B,OAAA,EAAmE;AAC5G,IAAA,OAAO,gBAAgB,MAAM,WAAA,CAAY,KAAK,CAAA,EAAG,CAAC,SAAS,IAAA,CAAK,MAAA,CAAO,QAAQ,MAAA,EAAQ,qBAAA,EAAuB,EAAE,IAAA,EAAM,GAAG,mBAAmB,OAAO,CAAA,EAAG,CAAC,CAAA;AAAA,EACzJ;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAQA,uBAAuB,KAAA,EAAuE;AAC5F,IAAA,OAAO,eAAA,CAAgB,MAAM,WAAA,CAAY,KAAK,GAAG,CAAC,IAAA,KAAS,IAAA,CAAK,MAAA,CAAO,QAAQ,MAAA,EAAQ,8BAAA,EAAgC,EAAE,IAAA,EAAM,CAAC,CAAA;AAAA,EAClI;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAYA,eAAA,CAAgB,OAA6B,OAAA,EAA4D;AACvG,IAAA,OAAO,gBAAgB,MAAM,YAAA,CAAa,KAAK,CAAA,EAAG,CAAC,SAAS,IAAA,CAAK,MAAA,CAAO,QAAQ,MAAA,EAAQ,sBAAA,EAAwB,EAAE,IAAA,EAAM,GAAG,mBAAmB,OAAO,CAAA,EAAG,CAAC,CAAA;AAAA,EAC3J;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAQA,wBAAwB,KAAA,EAAiE;AACvF,IAAA,OAAO,eAAA,CAAgB,MAAM,YAAA,CAAa,KAAK,GAAG,CAAC,IAAA,KAAS,IAAA,CAAK,MAAA,CAAO,QAAQ,MAAA,EAAQ,+BAAA,EAAiC,EAAE,IAAA,EAAM,CAAC,CAAA;AAAA,EACpI;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAYA,cAAA,CAAe,OAA4B,OAAA,EAA4D;AACrG,IAAA,OAAO,gBAAgB,MAAM,WAAA,CAAY,KAAK,CAAA,EAAG,CAAC,SAAS,IAAA,CAAK,MAAA,CAAO,QAAQ,MAAA,EAAQ,qBAAA,EAAuB,EAAE,IAAA,EAAM,GAAG,mBAAmB,OAAO,CAAA,EAAG,CAAC,CAAA;AAAA,EACzJ;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EASA,uBAAuB,KAAA,EAAgE;AACrF,IAAA,OAAO,eAAA,CAAgB,MAAM,WAAA,CAAY,KAAK,GAAG,CAAC,IAAA,KAAS,IAAA,CAAK,MAAA,CAAO,QAAQ,MAAA,EAAQ,8BAAA,EAAgC,EAAE,IAAA,EAAM,CAAC,CAAA;AAAA,EAClI;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAoBA,QAAA,CAAS,OAAsB,OAAA,EAA4D;AACzF,IAAA,OAAO,gBAAgB,MAAM,YAAA,CAAa,KAAK,CAAA,EAAG,CAAC,SAAS,IAAA,CAAK,MAAA,CAAO,QAAQ,MAAA,EAAQ,eAAA,EAAiB,EAAE,IAAA,EAAM,GAAG,mBAAmB,OAAO,CAAA,EAAG,CAAC,CAAA;AAAA,EACpJ;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAQA,iBAAiB,KAAA,EAA0D;AACzE,IAAA,OAAO,eAAA,CAAgB,MAAM,YAAA,CAAa,KAAK,GAAG,CAAC,IAAA,KAAS,IAAA,CAAK,MAAA,CAAO,QAAQ,MAAA,EAAQ,wBAAA,EAA0B,EAAE,IAAA,EAAM,CAAC,CAAA;AAAA,EAC7H;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAaA,aAAA,CAAc,OAA2B,OAAA,EAA4D;AACnG,IAAA,OAAO,gBAAgB,MAAM,iBAAA,CAAkB,KAAK,CAAA,EAAG,CAAC,SAAS,IAAA,CAAK,MAAA,CAAO,QAAQ,MAAA,EAAQ,oBAAA,EAAsB,EAAE,IAAA,EAAM,GAAG,mBAAmB,OAAO,CAAA,EAAG,CAAC,CAAA;AAAA,EAC9J;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAQA,sBAAsB,KAAA,EAA+D;AACnF,IAAA,OAAO,eAAA,CAAgB,MAAM,iBAAA,CAAkB,KAAK,GAAG,CAAC,IAAA,KAAS,IAAA,CAAK,MAAA,CAAO,QAAQ,MAAA,EAAQ,6BAAA,EAA+B,EAAE,IAAA,EAAM,CAAC,CAAA;AAAA,EACvI;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAeA,MAAM,eAAA,CAAgB,KAAA,EAA6B,OAAA,EAA4D;AAC7G,IAAA,IAAI,MAAM,QAAA,KAAa,MAAA,IAAa,CAACA,uBAAA,CAAkB,KAAA,CAAM,QAAQ,CAAA,EAAG;AACtE,MAAA,MAAM,IAAIC,6BAAA;AAAA,QACR,CAAA,2BAAA,EAA8B,OAAO,KAAA,CAAM,QAAQ,CAAC,CAAA,+BAAA,EAAkCC,yBAAA,CAAoB,IAAA,CAAK,IAAI,CAAC,CAAA,CAAA,CAAA;AAAA,QACpH,mBAAA;AAAA,QACA;AAAA,OACF;AAAA,IACF;AACA,IAAA,MAAM,OAAO,KAAA,CAAM,QAAA,IAAa,MAAM,IAAA,CAAK,SAAA,CAAU,MAAM,KAAK,CAAA;AAChE,IAAA,OAAO,KAAK,MAAA,CAAO,OAAA,CAAQ,MAAA,EAAQ,cAAA,CAAe,IAAI,CAAA,EAAG;AAAA,MACvD,MAAM,EAAE,KAAA,EAAO,MAAM,KAAA,EAAO,IAAA,EAAM,MAAM,IAAA,EAAM,GAAI,KAAA,CAAM,SAAA,KAAc,SAAY,EAAE,SAAA,EAAW,MAAM,SAAA,EAAU,GAAI,EAAC,EAAG;AAAA,MACvH,GAAG,mBAAmB,OAAO;AAAA,KAC9B,CAAA;AAAA,EACH;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAUA,MAAc,UAAU,KAAA,EAAyC;AAC/D,IAAA,MAAM,UAAU,MACd,IAAID,6BAAA,CAAY,0EAAA,EAAuE,yBAAyB,GAAG,CAAA;AACrH,IAAA,IAAI,GAAA;AACJ,IAAA,IAAI;AACF,MAAA,GAAA,GAAA,CAAO,MAAM,IAAA,CAAK,MAAA,CAAO,OAAA,CAAiE,KAAA,EAAO,YAAY,kBAAA,CAAmB,KAAK,CAAC,CAAA,CAAE,CAAA,EAAG,IAAA;AAAA,IAC7I,SAAS,GAAA,EAAK;AACZ,MAAA,IAAI,eAAeE,gCAAA,IAAkB,GAAA,CAAI,YAAA,KAAiB,WAAA,QAAmB,OAAA,EAAQ;AACrF,MAAA,MAAM,GAAA;AAAA,IACR;AACA,IAAA,MAAM,QAAQ,GAAA,EAAK,UAAA;AACnB,IAAA,MAAM,QAAA,GAAW,KAAA,IAAS,OAAO,KAAA,KAAU,QAAA,IAAY,CAAC,KAAA,CAAM,OAAA,CAAQ,KAAK,CAAA,GAAK,KAAA,CAA6B,IAAA,GAAO,MAAA;AACpH,IAAA,MAAM,IAAA,GAAO,OAAO,QAAA,KAAa,QAAA,IAAY,SAAS,MAAA,GAAS,CAAA,GAAI,WAAW,GAAA,EAAK,QAAA;AACnF,IAAA,IAAI,CAACH,uBAAA,CAAkB,IAAI,CAAA,QAAS,OAAA,EAAQ;AAC5C,IAAA,OAAO,IAAA;AAAA,EACT;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAaA,SAAS,KAAA,EAA8C;AAGrD,IAAA,MAAM,OAAA,GAAUI,0BAAA,CAAuB,KAAA,CAAM,OAAA,EAAS;AAAA,MACpD,SAAS,KAAA,CAAM,OAAA;AAAA,MACf,oBAAoB,KAAA,CAAM;AAAA,KAC3B,CAAA;AACD,IAAA,IAAI,CAAC,QAAQ,EAAA,EAAI;AACf,MAAA,MAAM,OAAA,GAAU,OAAA,CAAQ,MAAA,CAAO,GAAA,CAAI,CAAC,KAAA,KAAUC,gCAAA,CAA6B,KAAK,CAAC,CAAA,CAAE,IAAA,CAAK,IAAI,CAAA;AAC5F,MAAA,OAAO,OAAA,CAAQ,OAAO,IAAIJ,6BAAA,CAAY,aAAa,OAAO,CAAA,CAAA,EAAI,mBAAA,EAAqB,GAAG,CAAC,CAAA;AAAA,IACzF;AACA,IAAA,MAAM,UAAA,GAAa,OAAA,CAAQ,kBAAA,GACvB,EAAE,GAAG,KAAA,CAAM,UAAA,EAAY,QAAA,EAAU,OAAA,CAAQ,kBAAA,EAAmB,GAC5D,KAAA,CAAM,UAAA;AACV,IAAA,OAAO,IAAA,CAAK,MAAA,CAAO,OAAA,CAAQ,MAAA,EAAQ,eAAA,EAAiB;AAAA,MAClD,IAAA,EAAM;AAAA,QACJ,MAAM,KAAA,CAAM,IAAA;AAAA,QACZ,UAAU,KAAA,CAAM,QAAA;AAAA,QAChB,UAAA;AAAA,QACA,SAAS,OAAA,CAAQ,OAAA;AAAA,QACjB,GAAI,MAAM,OAAA,KAAY,MAAA,GAAY,EAAE,OAAA,EAAS,KAAA,CAAM,OAAA,EAAQ,GAAI,EAAC;AAAA,QAChE,GAAI,MAAM,YAAA,KAAiB,MAAA,GAAY,EAAE,YAAA,EAAc,KAAA,CAAM,YAAA,EAAa,GAAI,EAAC;AAAA,QAC/E,GAAI,MAAM,UAAA,KAAe,MAAA,GAAY,EAAE,UAAA,EAAY,KAAA,CAAM,UAAA,EAAW,GAAI,EAAC;AAAA,QACzE,GAAI,MAAM,KAAA,KAAU,MAAA,GAAY,EAAE,KAAA,EAAO,KAAA,CAAM,KAAA,EAAM,GAAI,EAAC;AAAA,QAC1D,GAAI,MAAM,iBAAA,KAAsB,MAAA,GAAY,EAAE,iBAAA,EAAmB,KAAA,CAAM,iBAAA,EAAkB,GAAI,EAAC;AAAA,QAC9F,GAAI,MAAM,YAAA,KAAiB,MAAA,GAAY,EAAE,YAAA,EAAc,KAAA,CAAM,YAAA,EAAa,GAAI,EAAC;AAAA,QAC/E,GAAI,MAAM,QAAA,KAAa,MAAA,GAAY,EAAE,QAAA,EAAU,KAAA,CAAM,QAAA,EAAS,GAAI,EAAC;AAAA,QACnE,GAAI,MAAM,UAAA,KAAe,MAAA,GAAY,EAAE,UAAA,EAAY,KAAA,CAAM,UAAA,EAAW,GAAI;AAAC;AAC3E,KACD,CAAA;AAAA,EACH;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAUA,aAAa,KAAA,EAAkD;AAC7D,IAAA,IAAIK,2BAAA,CAAwB,KAAA,CAAM,UAAU,CAAA,CAAE,WAAW,CAAA,EAAG;AAC1D,MAAA,OAAO,OAAA,CAAQ,OAAO,IAAIL,6BAAA;AAAA,QACxB,gGAAA;AAAA,QACA,aAAA;AAAA,QACA;AAAA,OACD,CAAA;AAAA,IACH;AACA,IAAA,MAAM,SAAS,KAAA,CAAM,gBAAA;AACrB,IAAA,IAAI,MAAA,KAAW,MAAA,IAAa,CAACM,sBAAA,CAAmB,MAAM,CAAA,EAAG,OAAO,OAAA,CAAQ,MAAA,CAAO,IAAIN,6BAAA,CAAY,oGAAA,EAAiG,mBAAA,EAAqB,GAAG,CAAC,CAAA;AACzN,IAAA,MAAM,aAAa,MAAA,KAAW,MAAA,GAAYO,2BAAuB,EAAE,UAAA,EAAY,MAAM,UAAA,EAAW,EAAG,KAAA,CAAM,GAAA,EAAK,MAAM,UAAA,EAAY,EAAE,YAAY,MAAA,EAAQ,IAAI,KAAA,CAAM,UAAA;AAChK,IAAA,OAAO,IAAA,CAAK,MAAA,CAAO,OAAA,CAAQ,MAAA,EAAQ,mBAAA,EAAqB;AAAA,MACtD,IAAA,EAAM;AAAA,QACJ,KAAK,KAAA,CAAM,GAAA;AAAA,QACX,YAAY,KAAA,CAAM,UAAA;AAAA,QAClB,GAAI,UAAA,KAAe,MAAA,GAAY,EAAE,UAAA,KAAe,EAAC;AAAA,QACjD,GAAI,MAAM,YAAA,KAAiB,MAAA,GAAY,EAAE,YAAA,EAAc,KAAA,CAAM,YAAA,EAAa,GAAI,EAAC;AAAA,QAC/E,GAAI,MAAM,SAAA,KAAc,MAAA,GAAY,EAAE,SAAA,EAAW,KAAA,CAAM,SAAA,EAAU,GAAI,EAAC;AAAA,QACtE,GAAI,MAAM,MAAA,KAAW,MAAA,GAAY,EAAE,MAAA,EAAQ,KAAA,CAAM,MAAA,EAAO,GAAI,EAAC;AAAA,QAC7D,GAAI,MAAM,SAAA,KAAc,MAAA,GAAY,EAAE,SAAA,EAAW,KAAA,CAAM,SAAA,EAAU,GAAI,EAAC;AAAA,QACtE,GAAI,MAAM,SAAA,KAAc,MAAA,GAAY,EAAE,SAAA,EAAW,KAAA,CAAM,SAAA,EAAU,GAAI,EAAC;AAAA,QACtE,GAAI,MAAM,WAAA,KAAgB,MAAA,GAAY,EAAE,WAAA,EAAa,KAAA,CAAM,WAAA,EAAY,GAAI,EAAC;AAAA,QAC5E,GAAI,MAAM,UAAA,KAAe,MAAA,GAAY,EAAE,UAAA,EAAY,KAAA,CAAM,UAAA,EAAW,GAAI;AAAC;AAC3E,KACD,CAAA;AAAA,EACH;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EASA,eAAA,CAAgBC,OAAU,UAAA,EAAoC;AAC5D,IAAA,OAAOC,6BAAA,CAA0BD,OAAK,UAAU,CAAA;AAAA,EAClD;AACF","file":"chunk-RHJRLXKY.cjs","sourcesContent":["/**\n * The inputs of the podcast use-case runs on the `edit` resource (Tighten\n * Episode, Chapters, Trailer, Clip Pack, Speaker Layout) and the request body each one sends.\n * Split from `edit.ts`, which holds the methods, the type list and the\n * continue routes; every name here is re-exported from there.\n */\nimport type { EditPlanTier, EdlTargetAspect, SpeakerEmphasisStyle, SpeakerSwitchId } from \"@nodaro/shared/edl\"\nimport type { CaptionStyle } from \"@nodaro/shared/captions\"\n\n/**\n * The recordings of a use-case run: one (`mediaUrl`), or the recordings of one\n * conversation (`mediaUrls`, in order — the cameras; one may be sound only),\n * an optional Master audio and the Cameras settings. Pass `mediaUrl` or\n * `mediaUrls`, not both.\n *\n * Several recordings or a Master audio need Speaker Map, which tells who is on\n * which camera: where it is not available to you (not yet on nodaro.ai) the\n * request is refused `403 node_not_available` — send one recording.\n */\nexport interface UseCaseRecordingsInput {\n  /** The recording — a video or audio URL, up to 3 hours. */\n  mediaUrl?: string\n  /**\n   * Instead of `mediaUrl`: the recordings of one conversation, in order — up\n   * to six in all with the Master audio; without one, two or more cameras keep\n   * a place for the sound, so up to five. With two or more the run lines them\n   * up, works out who is on which camera and cuts to whoever is talking.\n   */\n  mediaUrls?: string[]\n  /** The mixer or recorder track: the episode's sound and the clock the recordings are lined up to. */\n  masterAudioUrl?: string\n  /** With several recordings or a Master audio: the Cameras settings (ignored with one recording and no Master audio). */\n  cameras?: {\n    /** Which recording (1-based) is the wide shot, shown when a speaker has no camera of their own; `null` for none. */\n    wide?: number | null\n    /** The recordings already share one clock: skip lining them up. */\n    synced?: boolean\n    /** Who is on which camera: speaker number (`\"1\"` = the first voice heard) → recording number, 0 = the wide shot. Overrides the automatic map. */\n    speakerCameras?: Record<string, number>\n  }\n}\n\n/**\n * Input for {@link EditResource.tightenEpisode} and\n * {@link EditResource.estimateTightenEpisode}: the recording (or the\n * recordings of one conversation, see {@link UseCaseRecordingsInput}) in, the\n * tightened episode out. Only the recording is required; every other field\n * left out takes the node's default.\n */\nexport interface TightenEpisodeInput extends UseCaseRecordingsInput {\n  /** Optional music bed, ducked under the voice and ending with the episode. */\n  musicUrl?: string\n  /** `\"video\"` or `\"audio\"`; an audio recording always makes an audio episode. */\n  output?: \"video\" | \"audio\"\n  /**\n   * Frame a video episode with Speaker View: an output aspect and a layout,\n   * over automatic boxes on the speakers on screen. A layout the aspect does\n   * not draw is snapped to one it does. `null` or absent: no framing.\n   */\n  framing?: {\n    aspect: EdlTargetAspect\n    layout: \"auto\" | \"single\" | \"side-by-side\" | \"stacked\" | \"grid\" | \"pip\"\n  } | null\n  /**\n   * With a framing, how it follows the speakers: `\"static\"` (the default)\n   * splits the frame evenly by speaker; `\"tracking\"` follows faces with\n   * Speaker Frames (charged per started block of 1,000 sampled frames; a\n   * camera shared by several speakers keeps the even split until faces are\n   * named; refused 403 where Speaker Frames is not available to the caller);\n   * `\"auto\"` follows faces while Speaker Frames is available to the caller,\n   * else the even split. Ignored without a framing.\n   */\n  framingSource?: \"auto\" | \"static\" | \"tracking\"\n  /** Captions on a video episode (on by default). */\n  captions?: boolean\n  /** The captions' look. */\n  captionStyle?: CaptionStyle\n  /**\n   * Stop at a quick preview for a person to review; render the full-quality\n   * episode afterwards with {@link EditResource.continueUseCase}\n   * (`mode: \"render-final\"`).\n   */\n  reviewBeforeRender?: boolean\n  /** The planner's tier. */\n  planTier?: EditPlanTier\n  /** Editing instructions for the planner (up to 4 000 characters). */\n  instructions?: string\n  /** A style guide for the planner (up to 4 000 characters). */\n  styleGuide?: string\n  /** How far the music dips under the voice, 0–100 (default 75). */\n  musicDuckAmount?: number\n}\n\n/**\n * Input for {@link EditResource.episodeChapters} and\n * {@link EditResource.estimateEpisodeChapters}: one recording in, its chapters\n * out. Only `mediaUrl` is required; every other field left out takes the\n * node's default.\n */\nexport interface EpisodeChaptersInput {\n  /** The recording — a video or audio URL, up to 3 hours. */\n  mediaUrl: string\n  /** The planner's tier (default `\"economy\"`). */\n  planTier?: EditPlanTier\n  /** Instructions for the chapters, e.g. \"5 to 8 chapters\" (up to 4 000 characters). */\n  instructions?: string\n  /** A style guide for the chapter titles (up to 4 000 characters). */\n  styleGuide?: string\n}\n\n/** The formats a Trailer is delivered in, in delivery order (16:9 is a 1920×1080 landscape). */\nexport const TRAILER_FORMATS = [\"9:16\", \"1:1\", \"4:5\", \"16:9\"] as const\n/** One Trailer format (see {@link TRAILER_FORMATS}). */\nexport type TrailerFormat = (typeof TRAILER_FORMATS)[number]\n\n/**\n * Input for {@link EditResource.episodeTrailer} and\n * {@link EditResource.estimateEpisodeTrailer}: one video recording (or the\n * recordings of one conversation, see {@link UseCaseRecordingsInput}) in, a\n * 20–40 s trailer out in each chosen format. Only the recording is required.\n */\nexport interface EpisodeTrailerInput extends UseCaseRecordingsInput {\n  /** The recording — a video URL, up to 3 hours (a run with no picture is refused). Or `mediaUrls`. */\n  mediaUrl?: string\n  /** An optional intro card: a short video (15 s at most) played before the trailer. */\n  introCardUrl?: string\n  /** The formats to deliver, padded, never cropped (default `[\"9:16\", \"1:1\", \"4:5\"]`; an empty list is refused). */\n  formats?: TrailerFormat[]\n  /** Stop at a preview of the trailer; render every format with {@link EditResource.continueUseCase} (`mode: \"render-final\"`). */\n  reviewBeforeRender?: boolean\n  /** The planner's tier (default `\"standard\"`). */\n  planTier?: EditPlanTier\n  /** Instructions for the trailer (up to 4 000 characters). */\n  instructions?: string\n  /** A style guide for the planner (up to 4 000 characters). */\n  styleGuide?: string\n}\n\n/** The shortest and longest clip a Clip Pack asks the plan for, in seconds. */\nexport const CLIP_PACK_MIN_TARGET_SEC = 5\nexport const CLIP_PACK_MAX_TARGET_SEC = 180\n\n/**\n * A Clip Pack emphasis: `\"none\"`, or one or more of `\"scale\"`, `\"border\"` and\n * `\"dim\"` joined with `\"+\"` (each once — the route refuses a repeat).\n */\nexport type ClipPackEmphasis = SpeakerEmphasisStyle | `${Exclude<SpeakerEmphasisStyle, \"none\">}+${string}`\n\n/**\n * Input for {@link EditResource.clipPack} and\n * {@link EditResource.estimateClipPack}: the recording (or the recordings of\n * one conversation, see {@link UseCaseRecordingsInput} — each clip then cuts\n * to whoever is talking) in, a pack of short clips out. An audio recording\n * makes audio clips (no framing, no captions). Only the recording is\n * required; every other field left out takes the node's default.\n */\nexport interface ClipPackInput extends UseCaseRecordingsInput {\n  /** How many clips to find, 1–50 (default 8). The plan may find fewer. */\n  count?: number\n  /** Each clip's target length in seconds, {@link CLIP_PACK_MIN_TARGET_SEC}–{@link CLIP_PACK_MAX_TARGET_SEC} (default 60). */\n  targetDurationSec?: number\n  /**\n   * Frame each video clip with Speaker View on automatic boxes over the\n   * episode's speakers: the shape, and optionally the layout (default\n   * `\"stacked\"`; one the shape does not draw is snapped), the switch at each\n   * speaker change (default `\"pan\"`) and the emphasis (default `\"scale\"`;\n   * `\"none\"`, or `\"scale\"`, `\"border\"` and `\"dim\"` joined with `\"+\"`). Left\n   * out: 9:16, stacked, pan, scale. `null`: no framing (the recording's shape).\n   */\n  framing?: {\n    aspect: EdlTargetAspect\n    layout?: \"auto\" | \"single\" | \"side-by-side\" | \"stacked\" | \"grid\" | \"pip\"\n    switchType?: SpeakerSwitchId\n    emphasisStyle?: ClipPackEmphasis\n  } | null\n  /**\n   * With a framing, how it follows the speakers: `\"static\"` splits the frame\n   * evenly by speaker (what a request that leaves this out gets); `\"tracking\"`\n   * runs Speaker Frames once over the whole pack to follow faces (charged per\n   * started block of 1,000 sampled frames; refused 403 where Speaker Frames is\n   * not available to the caller); `\"auto\"` follows faces while Speaker Frames\n   * is available to the caller, else the even split. Ignored without a framing.\n   */\n  framingSource?: \"auto\" | \"static\" | \"tracking\"\n  /** Caption each video clip (on by default). */\n  captions?: boolean\n  /** The captions' look (default `\"karaoke\"`). */\n  captionStyle?: CaptionStyle\n  /**\n   * Stop at quick previews of the clips for a person to review; render the\n   * kept clips at full quality with {@link EditResource.continueUseCase}\n   * (`mode: \"render-final\"`, an `editedEdl` that keeps or drops clips).\n   */\n  reviewBeforeRender?: boolean\n  /** The planner's tier (default `\"standard\"`). */\n  planTier?: EditPlanTier\n  /** Instructions for picking the clips (up to 4 000 characters). */\n  instructions?: string\n  /** A style guide for the planner (up to 4 000 characters). */\n  styleGuide?: string\n}\n\n/**\n * Input for {@link EditResource.speakerLayout} and\n * {@link EditResource.estimateSpeakerLayout}: one video recording (or the\n * recordings of one conversation, see {@link UseCaseRecordingsInput}) in, the\n * whole recording framed by speaker out — the same length, nothing cut. Only\n * the recording is required; every other field left out takes the node's\n * default.\n */\nexport interface SpeakerLayoutInput extends UseCaseRecordingsInput {\n  /** The recording — a video URL, up to 3 hours (an audio-only recording is refused). Or `mediaUrls`. */\n  mediaUrl?: string\n  /** The video's shape (default `\"9:16\"`). With one recording, a video already as narrow as the shape (or narrower) is refused `400 media_shape`. */\n  targetAspect?: EdlTargetAspect\n  /** How the speakers are laid out (default `\"stacked\"`; one the shape does not draw is snapped to one it does). */\n  layout?: \"auto\" | \"single\" | \"side-by-side\" | \"stacked\" | \"grid\" | \"pip\"\n  /** The switch at each speaker change (default `\"cut\"`). */\n  switchType?: SpeakerSwitchId\n  /** How the speaker talking is emphasised (default `\"scale\"`): `\"none\"`, or `\"scale\"`, `\"border\"` and `\"dim\"` joined with `\"+\"`. */\n  emphasisStyle?: ClipPackEmphasis\n  /**\n   * How the speakers are followed: `\"auto\"` (the default) follows faces with\n   * Speaker Frames while it is available to the caller, else splits the frame\n   * evenly; `\"static\"` splits the frame evenly by speaker; `\"tracking\"`\n   * follows faces (charged per started block of 1,000 sampled frames;\n   * refused 403 where Speaker Frames is not available to the caller). Faces\n   * aren't named after a speaker yet, so a camera shared by several speakers\n   * keeps the even split.\n   */\n  framingSource?: \"auto\" | \"static\" | \"tracking\"\n  /**\n   * Stop at a quick preview for a person to review; render it at full\n   * quality with {@link EditResource.continueUseCase}\n   * (`mode: \"render-final\"`, no `editedEdl`: the layout has no cut to change).\n   */\n  reviewBeforeRender?: boolean\n}\n\n/**\n * The body's recordings (`mediaUrls`, then `masterAudioUrl` and `cameras` when\n * given), and the rest of the input as it came: the one mapper every use-case\n * body goes through. Throws before any request when the input names both\n * `mediaUrl` and `mediaUrls`, or neither.\n */\nfunction withRecordings<T extends UseCaseRecordingsInput>(input: T): Record<string, unknown> {\n  const { mediaUrl, mediaUrls, masterAudioUrl, cameras, ...rest } = input\n  if (mediaUrl !== undefined && mediaUrls !== undefined) throw new TypeError(\"pass mediaUrl or mediaUrls, not both\")\n  const recordings = mediaUrls ?? (mediaUrl !== undefined ? [mediaUrl] : undefined)\n  if (!recordings) throw new TypeError(\"pass mediaUrl or mediaUrls\")\n  return {\n    mediaUrls: [...recordings],\n    ...(masterAudioUrl !== undefined ? { masterAudioUrl } : {}),\n    ...(cameras !== undefined ? { cameras } : {}),\n    ...Object.fromEntries(Object.entries(rest).filter(([, v]) => v !== undefined)),\n  }\n}\n\n/**\n * Sends `send` the body `build` makes, or rejects (never throws) with the\n * error of an input the body cannot take — before any request, as every input\n * check of the `edit` resource rejects.\n */\nexport function withUseCaseBody<T>(build: () => Record<string, unknown>, send: (body: Record<string, unknown>) => Promise<T>): Promise<T> {\n  let body: Record<string, unknown>\n  try {\n    body = build()\n  } catch (err) {\n    return Promise.reject(err)\n  }\n  return send(body)\n}\n\nexport function tightenBody(input: TightenEpisodeInput): Record<string, unknown> {\n  return withRecordings(input)\n}\n\nexport function chaptersBody(input: EpisodeChaptersInput): Record<string, unknown> {\n  return withRecordings({\n    mediaUrl: input.mediaUrl,\n    ...(input.planTier !== undefined ? { planTier: input.planTier } : {}),\n    ...(input.instructions !== undefined ? { instructions: input.instructions } : {}),\n    ...(input.styleGuide !== undefined ? { styleGuide: input.styleGuide } : {}),\n  })\n}\n\nexport function trailerBody(input: EpisodeTrailerInput): Record<string, unknown> {\n  return withRecordings({\n    mediaUrl: input.mediaUrl,\n    mediaUrls: input.mediaUrls,\n    masterAudioUrl: input.masterAudioUrl,\n    cameras: input.cameras,\n    ...(input.introCardUrl !== undefined ? { introCardUrl: input.introCardUrl } : {}),\n    // An empty list is sent as is: the route refuses it (at least one format).\n    ...(input.formats !== undefined ? { formats: input.formats } : {}),\n    ...(input.reviewBeforeRender !== undefined ? { reviewBeforeRender: input.reviewBeforeRender } : {}),\n    ...(input.planTier !== undefined ? { planTier: input.planTier } : {}),\n    ...(input.instructions !== undefined ? { instructions: input.instructions } : {}),\n    ...(input.styleGuide !== undefined ? { styleGuide: input.styleGuide } : {}),\n  })\n}\n\n/** Clip Pack's body: what the caller set, `framing: null` included (no framing). */\nexport function clipPackBody(input: ClipPackInput): Record<string, unknown> {\n  return withRecordings(input)\n}\n\n/** Speaker Layout's body: the recordings, then what the caller set. */\nexport function speakerLayoutBody(input: SpeakerLayoutInput): Record<string, unknown> {\n  return withRecordings(input)\n}\n","import type { NodaroClientCore } from \"../core.js\"\nimport { ForbiddenError, NodaroError } from \"../errors.js\"\nimport {\n  remapTranscriptThroughEdl,\n  unwrapEditPlanOutput,\n  resolveEditPlanSources,\n  describeAudioSyncOffsetIssue,\n  transcriptSpeakerLabels,\n  cameraSwitchSpeakerMap, speakerMapResultOf, type SpeakerMapResult,\n  type Edl,\n  type Transcript,\n  type EditPlanMode,\n  type EditPlanTier,\n  type EdlClipSet,\n  type ChapterSet,\n  type EdlTargetAspect\n} from \"@nodaro/shared/edl\"\nimport { USE_CASE_NODE_TYPES, isUseCaseNodeType, type UseCaseNodeType } from \"@nodaro/shared/nodes\"\nimport type { SpeakerMapInput } from \"./speaker-map-inputs.js\"\nimport {\n  chaptersBody,\n  clipPackBody,\n  speakerLayoutBody,\n  tightenBody,\n  trailerBody,\n  withUseCaseBody,\n  type ClipPackInput,\n  type EpisodeChaptersInput,\n  type EpisodeTrailerInput,\n  type SpeakerLayoutInput,\n  type TightenEpisodeInput,\n} from \"./edit-use-case-inputs.js\"\n\nexport { CLIP_PACK_MAX_TARGET_SEC, CLIP_PACK_MIN_TARGET_SEC, TRAILER_FORMATS } from \"./edit-use-case-inputs.js\"\nexport type { ClipPackEmphasis, ClipPackInput, EpisodeChaptersInput, EpisodeTrailerInput, SpeakerLayoutInput, TightenEpisodeInput, TrailerFormat, UseCaseRecordingsInput } from \"./edit-use-case-inputs.js\"\n\n// Re-export the canonical EDL / transcript vocabulary from `@nodaro/shared`\n// (single source of truth — the shapes live at `packages/shared/src/edl.ts`).\n// `@nodaro/shared` is already a hard dep of this package, so there is no\n// bundle-size cost to importing from it, and an integration builds requests and\n// reads results with one dependency. `EdlClipSet` / `ChapterSet` are the raw\n// `output_data` shapes of the `clips` / `chapters` modes, and\n// `unwrapEditPlanOutput` is the sanctioned way to normalize any edit-plan job's\n// `output_data` (it also strips the relay's `viaNodaroCloud` marker).\nexport type { Edl, Transcript, EditPlanMode, EditPlanTier, EdlClipSet, ChapterSet }\nexport { unwrapEditPlanOutput }\n\n/**\n * A silence-detect job's `output_data.json` — the value to pass as\n * {@link EditPlanInput.silence}. It is NOT what {@link EditResource.silenceDetect}\n * returns (that is `{ jobId }`); fetch the finished job and read its\n * `output_data.json`. The planner reads the `ranges` array — an input without\n * one is silently ignored, so pass this whole object.\n */\nexport interface SilenceRanges {\n  /** Wire version of the payload. */\n  version?: number\n  /** Silence spans on the source clock, in ms. */\n  ranges: ReadonlyArray<{ startMs: number; endMs: number }>\n  /** Total source duration, in ms. */\n  durationMs?: number\n}\n\n/** Every editorial route answers with the queued job to poll. */\nexport interface EditJobResult {\n  /** The queued job id — follow it via `client.jobs.getStatus(jobId)`. */\n  jobId: string\n}\n\nexport interface SilenceDetectInput {\n  /**\n   * An audio OR video source. A single ffmpeg `silencedetect` pass runs over the\n   * source's audio proxy either way — no provider key required.\n   */\n  audioUrl: string\n  /** dBFS threshold, always ≤ 0. Default -35 (a good podcast default). */\n  thresholdDb?: number\n  /** Minimum silence length to report, in ms. Default 700. */\n  minSilenceMs?: number\n  /** Padding kept around speech, in ms — shrinks each reported range inward. Default 120. */\n  padMs?: number\n  /**\n   * Optionally associate this run with a workflow execution (display only — it\n   * ties the standalone job back to a workflow for the execution history).\n   */\n  workflowId?: string\n}\n\n/** One recording for {@link EditResource.audioSync}. */\nexport interface AudioSyncSource {\n  /**\n   * Your id for this recording (1–200 chars, unique within the request) —\n   * echoed back as its offset's `sourceId`. Use the id your EDL gives the same\n   * recording (`EdlSource.id`) and the result folds straight into it.\n   */\n  id: string\n  /** An audio OR video URL — the audio track is read either way. */\n  url: string\n}\n\nexport interface AudioSyncInput {\n  /** The 2–6 recordings of one conversation to line up (camera files and/or a master mic). */\n  sources: AudioSyncSource[]\n  /**\n   * The id of the source every offset is measured against (its own offset is\n   * 0). Must be one of `sources`' ids; default: the first source.\n   */\n  reference?: string\n  /** Optionally associate this run with a workflow execution (display only). */\n  workflowId?: string\n}\n\n/** One recording's measured clock offset in an {@link AudioSyncResult}. */\nexport interface AudioSyncOffset {\n  /** The recording's `id` from the request. */\n  sourceId: string\n  /**\n   * Where this recording sits on the reference's clock, in integer ms:\n   * `referenceMs = sourceMs + offsetMs` (the EDL's D19 sign — the value\n   * `EdlSource.offsetMs` takes when the reference is the master).\n   */\n  offsetMs: number\n  /** 0–1. Below 0.5 a `notes` line asks for a check by ear. */\n  confidence: number\n  /**\n   * Measured clock drift against the reference, in ms gained per hour; `null`\n   * when the shared stretch was too short to measure it. Drift is reported,\n   * never corrected — the offset is taken at the middle of the overlap.\n   */\n  driftMsPerHour: number | null\n}\n\n/**\n * An audio-sync job's `output_data.json`. It is NOT what\n * {@link EditResource.audioSync} returns (that is `{ jobId }`); fetch the\n * finished job and read its `output_data.json`.\n */\nexport interface AudioSyncResult {\n  /** Wire version of the payload. */\n  version: number\n  /** The source every offset is measured against (its own offset is 0). */\n  reference: string\n  offsets: AudioSyncOffset[]\n  /** Human-readable warnings: low confidence, measured drift, no shared sound. */\n  notes: string[]\n}\n\nexport interface ApplyEdlInput {\n  /** The edit decision list to render. Media resolves from each `edl.sources[i].url`. */\n  edl: Edl\n  /**\n   * Optional media-URL overrides for `edl.sources[i].url`, POSITIONAL in this\n   * array's order. Each URL is SSRF-guarded server-side like any media the\n   * platform fetches.\n   */\n  sources?: string[]\n  /**\n   * Optional transcript to remap through the cut. The rendered job returns the\n   * remapped transcript on its `json` output. A word-level multi-hour transcript\n   * is several MB — if you only need the re-timed transcript (not a render), use\n   * {@link EditResource.remapTranscript} locally instead of sending it here.\n   */\n  transcript?: Transcript\n  /** Render a full video (default) or an audio-only cut. */\n  output?: \"video\" | \"audio\"\n  /** Fast proxy draft or the final render. Default \"final\". */\n  quality?: \"proxy\" | \"final\"\n  /**\n   * Default crossfade (ms) on boundaries with no explicit transition; 0 = hard\n   * cuts. Per-boundary clamped to the ffmpeg-xfade limit server-side. Default 0.\n   */\n  crossfadeMs?: number\n  /**\n   * The plan clip this render cuts — `edlSpanKey(clip)` from `@nodaro/shared`\n   * (`\"<first inMs>-<last outMs>\"`). The job's result carries it back as\n   * `output_data.clipKey`, so renders of a clip set can be matched to their\n   * clips. Omit for a render of no plan clip.\n   */\n  clipKey?: string\n  /**\n   * The plan value this render cuts — `renderReadBasis(value)` from\n   * `@nodaro/shared` (16 lowercase hex digits), where `value` is the Edit\n   * Plan's Tighten EDL with any review applied, or the clip this render cuts.\n   * The job's result carries it back as `output_data.planBasis`, so a take can\n   * be told apart from one cut from an earlier plan. Send it only when the EDL\n   * you send IS that value (not one an intermediate step re-cut from an older\n   * plan); omit it otherwise. The result's `output_data.renderBasis` (the\n   * render's own settings and sources) is stamped by the server.\n   */\n  planBasis?: string\n  /** Optionally associate this run with a workflow execution (display only). */\n  workflowId?: string\n}\n\n/**\n * One media source for an edit-plan run. Mirrors the shape the workflow engine\n * sends: a stable `id` (adopted verbatim as the plan's `EdlSource` id), the\n * media `url`, and the `kind`, plus optional per-source annotations the planner\n * honors.\n */\nexport interface EditPlanSource {\n  /** Stable id for this source — becomes the `EdlSource` id in the returned plan. */\n  id: string\n  /** The source's media URL (SSRF-guarded server-side). */\n  url: string\n  /** This source's medium. */\n  kind: \"video\" | \"audio\"\n  /** Role annotation. `\"master-audio\"` marks the clock the plan is reserved on. */\n  role?: \"master-audio\" | \"camera\" | \"wide\" | \"screen\"\n  /** Speaker labels present in this source. */\n  speakers?: string[]\n  /**\n   * This source's origin on the master clock (masterMs = sourceMs + offsetMs).\n   * Set by hand, it wins over a measured offset from `offsets`.\n   */\n  offsetMs?: number\n}\n\nexport interface EditPlanInput {\n  /**\n   * Planning mode. The finished job's `output_data` carries the plan — read it\n   * with {@link unwrapEditPlanOutput}, which also strips the relay's\n   * `viaNodaroCloud` marker:\n   *   - `\"tighten\"`  → an `Edl`.\n   *   - `\"clips\"`    → an {@link EdlClipSet} (`{ version, clips: Edl[] }`);\n   *                    `unwrapEditPlanOutput` returns the bare `Edl[]`.\n   *   - `\"chapters\"` → a {@link ChapterSet} (`{ version, chapters: [...] }`).\n   *   - `\"trailer\"`  → an `Edl` (one short teaser cut from the strongest moments).\n   */\n  mode: EditPlanMode\n  /** Reasoning tier — affects plan quality AND the credit bucket. */\n  planTier: EditPlanTier\n  /** The timed transcript driving the plan. */\n  transcript: Transcript\n  /**\n   * Optional detected silence ranges. Pass the silence-detect JOB'S RESULT —\n   * `getStatus(jobId).data.output_data.json` (a {@link SilenceRanges} object),\n   * NOT the `{ jobId }` that {@link EditResource.silenceDetect} returns. The\n   * planner reads the `ranges` array; an input without one is silently ignored.\n   */\n  silence?: SilenceRanges\n  /** The recording's media sources (1–6). */\n  sources: EditPlanSource[]\n  /**\n   * Multicam: an {@link AudioSyncResult} (the audio-sync job's\n   * `output_data.json`) measured over these same source ids. Each source's\n   * measured offset is written onto its `offsetMs` BEFORE the request, on the\n   * master's clock (the `master-audio` source, else the first) — a source's\n   * own `offsetMs` wins. `editPlan` rejects with a {@link NodaroError}\n   * (`code: \"edit_plan_sources\"`), before any request or charge, when a\n   * source was not measured or matched weakly (confidence < 0.5 — set its\n   * `offsetMs` by hand), or the master was not measured.\n   */\n  offsets?: AudioSyncResult | string\n  /**\n   * The id of the source the transcript was made from, when you know it. The\n   * plan follows the master's clock, so a transcript made from a source that\n   * is off it is rejected the same way.\n   */\n  transcriptSourceId?: string\n  /** Free-text editing steer. */\n  instructions?: string\n  /** Style-guide text applied to the plan. */\n  styleGuide?: string\n  /** `\"clips\"` mode only: how many clips to cut. */\n  count?: number\n  /** `\"clips\"` mode only: target duration per clip, in seconds. */\n  targetDurationSec?: number\n  /** Target aspect for cut clips (`\"clips\"`) or the teaser (`\"trailer\"`). */\n  targetAspect?: \"16:9\" | \"9:16\" | \"1:1\" | \"4:5\"\n  /** Target platform hint (e.g. a social platform name). */\n  platform?: string\n  /** Optionally associate this run with a workflow execution (display only). */\n  workflowId?: string\n}\n\n/** Input for {@link EditResource.cameraSwitch} (podcast B5). */\nexport interface CameraSwitchInput {\n  /** One EDL — an `editPlan` result (`unwrapEditPlanOutput`), not a clip set. */\n  edl: Edl\n  /** The word transcript WITH speaker labels (transcribe with speaker detection). */\n  transcript: Transcript\n  /** Speaker label → the EDL source id of that speaker's camera. A speaker\n   *  left out shows the source whose `speakers` list names them, else the\n   *  `wide` camera, else any camera that filmed them. */\n  speakerMap?: Record<string, string>\n  /** A {@link EditResource.speakerMap} job's `output_data.json`: a label in `speakerMap`\n   *  wins, then this result, then the n-th speaker heard gets the n-th camera. */\n  speakerMapResult?: SpeakerMapResult | string\n  /** Speaker label → display name (on the segments and the returned transcript). */\n  speakerNames?: Record<string, string>\n  /** The shortest shot in ms (default 2 500): a shorter turn holds the shot. */\n  minShotMs?: number\n  /** Cut this long before the new speaker starts, ms (default 200). */\n  leadMs?: number\n  /** With a `wide` source: break to it after this long on one camera, ms (default 20 000). */\n  maxShotMs?: number\n  /** With a `wide` source: every N-th cut goes to the wide (default 0 = off). */\n  wideEvery?: number\n  /** Overlapping speech → a layout hint (default false; Apply EDL renders cut-only edits). */\n  layoutHints?: boolean\n  /** Optionally associate this run with a workflow execution (display only). */\n  workflowId?: string\n}\n\n/**\n * The podcast use-case node types, each one a route (`POST /v1/<type>`, and\n * `POST /v1/<type>/continue` to continue one of its runs).\n */\nexport { USE_CASE_NODE_TYPES, type UseCaseNodeType }\n\n/** The route that continues a run of `type`. */\nconst continuePathOf = (type: UseCaseNodeType): `/v1/${UseCaseNodeType}/continue` => `/v1/${type}/continue`\n\n/** What a use-case run (`tightenEpisode`, `episodeChapters`, `episodeTrailer`, `clipPack`, `speakerLayout`) and `continueUseCase` answer: the run's job to poll. */\nexport interface UseCaseJobResult extends EditJobResult {\n  /** The run's execution (absent on a deduplicated retry). */\n  executionId?: string\n  /** `true` when an `Idempotency-Key` retry found the run already started: `jobId` is that run. */\n  deduped?: boolean\n}\n\n/** What `tightenEpisode` answers (a {@link UseCaseJobResult}). */\nexport type TightenEpisodeJobResult = UseCaseJobResult\n\n/**\n * What a use-case run is estimated at (`data`). Every credit amount is 0\n * on an edition without credits; `durationSec` is `null` when the recording's\n * length could not be read.\n */\nexport interface UseCaseEstimate {\n  /** The whole run: its steps plus the fee. */\n  totalCredits: number\n  /** The steps at their own rates. */\n  stepsCredits: number\n  /** The per-run fee. */\n  feeCredits: number\n  /** The recording's length, in seconds. */\n  durationSec: number | null\n}\n\n/** What a Tighten Episode run is estimated at (a {@link UseCaseEstimate}). */\nexport type TightenEpisodeEstimate = UseCaseEstimate\n\n/** Input for {@link EditResource.continueUseCase}. */\nexport interface UseCaseContinueInput {\n  /** The run to continue: the job `tightenEpisode`, `episodeChapters`, `episodeTrailer`, `clipPack` or `speakerLayout` (or an earlier continuation) answered. */\n  jobId: string\n  /**\n   * `\"from-failed\"` re-runs what did not finish of a failed run;\n   * `\"render-final\"` renders the full-quality result after a review-on preview\n   * (a Chapters run has no preview: it is refused `render_final_not_preview`;\n   * a Clip Pack edit that drops every clip is refused `use_case_nothing_kept`).\n   */\n  mode: \"from-failed\" | \"render-final\"\n  /** Render final only: the reviewer's edit of the plan (an EDL). A Speaker Layout run has no plan: an edit is refused `400 use_case_no_plan`. */\n  editedEdl?: unknown\n  /**\n   * The run's node type: its continuation goes to `POST /v1/<nodeType>/continue`.\n   * Optional: when absent the job is read first (`GET /v1/jobs/:id`, which\n   * needs the `jobs:read` scope on an app token) for the type the run records.\n   * Required when that read cannot answer: a key without `jobs:read`, or a job\n   * that records no use-case type (the call rejects with `use_case_type_unknown`).\n   */\n  nodeType?: UseCaseNodeType\n}\n\n/** Per-call options for the use-case requests (Tighten Episode, Chapters, Trailer, Clip Pack, Speaker Layout, and their continuations). */\nexport interface UseCaseRequestOptions {\n  /**\n   * Sent as the `Idempotency-Key` header. Reuse the same value when retrying\n   * the same request and the server answers the run it already started\n   * (`deduped: true`) instead of starting a second one.\n   */\n  idempotencyKey?: string\n}\n\nfunction idempotencyHeaders(options?: UseCaseRequestOptions): { headers?: Record<string, string> } {\n  return options?.idempotencyKey ? { headers: { \"Idempotency-Key\": options.idempotencyKey } } : {}\n}\n\n/**\n * Editorial primitives for podcast / long-form video editing, single-camera\n * and multicam: measure the cameras' offsets ({@link audioSync}), plan the cut\n * ({@link editPlan}), put each cut on the speaker's camera\n * ({@link cameraSwitch}), render a Preview to review (`applyEdl` with\n * `quality: \"proxy\"`), then the final (`quality: \"final\"`).\n *\n * - {@link silenceDetect}, {@link audioSync} and {@link applyEdl} are core nodes\n *   available on every edition.\n * - {@link editPlan} and {@link cameraSwitch} run on nodaro.ai; a self-hosted\n *   install relays them once it is connected (a 503\n *   `code: \"nodaro_connection_required\"` otherwise).\n * - {@link tightenEpisode} runs the whole chain (transcribe, plan, render, and\n *   optionally captions, music and framing) in one call. It is core, but a\n *   self-hosted install needs a nodaro.ai connection for the steps that run\n *   there (a 503 `code: \"nodaro_connection_required\"` otherwise).\n *   {@link continueUseCase} continues one of its runs.\n * - {@link episodeChapters} lists a recording's chapters (transcribe, then the\n *   plan in chapters mode) in one call; nothing renders. Like\n *   {@link tightenEpisode}, a self-hosted install needs a nodaro.ai connection.\n * - {@link episodeTrailer} cuts a 20–40 s trailer of a recording and delivers\n *   it in each chosen format in one call; the same connection applies.\n * - {@link clipPack} cuts a recording into a pack of short clips (framed and\n *   captioned by default) in one call; the same connection applies.\n * - {@link speakerLayout} frames a whole recording by speaker (the same\n *   length, nothing cut) in one call; the same connection applies.\n * - {@link remapTranscript} is a PURE local transform (no request) — the same\n *   remap `applyEdl` performs on its `transcript`, exposed for callers that hold\n *   an EDL and a transcript and only want the re-timed transcript.\n *\n * Every request method except the estimates ({@link estimateTightenEpisode},\n * {@link estimateEpisodeChapters}, {@link estimateEpisodeTrailer},\n * {@link estimateClipPack}, {@link estimateSpeakerLayout}: a quote, `{ data }`) returns\n * {@link EditJobResult} (the use-case runs a {@link UseCaseJobResult}); poll the\n * `jobId` with `client.jobs.getStatus(jobId)`.\n */\nexport class EditResource {\n  constructor(private client: NodaroClientCore) {}\n\n  /**\n   * Detect silence ranges in an audio/video source (`POST /v1/silence-detect`).\n   * Keyless — one ffmpeg pass over the source's audio proxy.\n   */\n  silenceDetect(input: SilenceDetectInput): Promise<EditJobResult> {\n    return this.client.request(\"POST\", \"/v1/silence-detect\", {\n      body: {\n        audioUrl: input.audioUrl,\n        ...(input.thresholdDb !== undefined ? { thresholdDb: input.thresholdDb } : {}),\n        ...(input.minSilenceMs !== undefined ? { minSilenceMs: input.minSilenceMs } : {}),\n        ...(input.padMs !== undefined ? { padMs: input.padMs } : {}),\n        ...(input.workflowId !== undefined ? { workflowId: input.workflowId } : {}),\n      },\n    })\n  }\n\n  /**\n   * Measure how far apart the clocks of 2–6 recordings of one conversation are\n   * (`POST /v1/audio-sync`), by cross-correlating their audio — keyless, one\n   * ffmpeg decode per source. The finished job's `output_data.json` is an\n   * {@link AudioSyncResult}. A malformed request (fewer than 2 or more than 6\n   * sources, a repeated id, a `reference` that is not one of the ids) throws a\n   * typed `NodaroError` (400, `code: \"validation_error\"`) before any credits\n   * are reserved.\n   */\n  audioSync(input: AudioSyncInput): Promise<EditJobResult> {\n    return this.client.request(\"POST\", \"/v1/audio-sync\", {\n      body: {\n        sources: input.sources.map((s) => ({ id: s.id, url: s.url })),\n        ...(input.reference !== undefined ? { reference: input.reference } : {}),\n        ...(input.workflowId !== undefined ? { workflowId: input.workflowId } : {}),\n      },\n    })\n  }\n\n  /**\n   * Which camera each speaker is on, from the cameras' own microphones (`POST\n   * /v1/speaker-map`), keyless. `output_data.json` is a `SpeakerMapResult`: pass\n   * it to {@link cameraSwitch} as `speakerMapResult`. A malformed request throws\n   * a `NodaroError` (400 `validation_error`; 422 `no_speakers` for a transcript\n   * with no speaker labels) before any credits are reserved.\n   */\n  speakerMap(input: SpeakerMapInput): Promise<EditJobResult> {\n    return this.client.request(\"POST\", \"/v1/speaker-map\", {\n      body: {\n        sources: input.sources.map((s) => ({ id: s.id, url: s.url, ...(s.kind ? { kind: s.kind } : {}) })),\n        transcript: input.transcript,\n        ...(input.offsets !== undefined ? { offsets: input.offsets } : {}),\n        ...(input.masterSourceId !== undefined ? { masterSourceId: input.masterSourceId } : {}),\n        ...(input.wideSourceId !== undefined ? { wideSourceId: input.wideSourceId } : {}),\n        ...(input.marginDb !== undefined ? { marginDb: input.marginDb } : {}),\n        ...(input.workflowId !== undefined ? { workflowId: input.workflowId } : {}),\n      },\n    })\n  }\n\n  /**\n   * Render an edit decision list into a video or audio cut (`POST /v1/apply-edl`).\n   * The EDL is validated at ingress — an unresolvable source or a picture-less\n   * segment on a video edit throws a typed `NodaroError` (400, `code:\n   * \"invalid_edl\"`) before any credits are reserved.\n   */\n  applyEdl(input: ApplyEdlInput): Promise<EditJobResult> {\n    return this.client.request(\"POST\", \"/v1/apply-edl\", {\n      body: {\n        edl: input.edl,\n        ...(input.sources !== undefined ? { sources: input.sources } : {}),\n        ...(input.transcript !== undefined ? { transcript: input.transcript } : {}),\n        ...(input.output !== undefined ? { output: input.output } : {}),\n        ...(input.quality !== undefined ? { quality: input.quality } : {}),\n        ...(input.crossfadeMs !== undefined ? { crossfadeMs: input.crossfadeMs } : {}),\n        ...(input.clipKey !== undefined ? { clipKey: input.clipKey } : {}),\n        ...(input.planBasis !== undefined ? { planBasis: input.planBasis } : {}),\n        ...(input.workflowId !== undefined ? { workflowId: input.workflowId } : {}),\n      },\n    })\n  }\n\n  /**\n   * Tighten Episode (`POST /v1/tighten-episode`): tighten a podcast recording\n   * in one call — transcribe, cut the silences and filler, render, with\n   * optional captions, music and framing. Answers the run's job to poll; its\n   * `output_data` holds the episode. The run is priced as its steps at their own\n   * rates plus the listed per-run fee. Quote it first with\n   * {@link estimateTightenEpisode}.\n   */\n  tightenEpisode(input: TightenEpisodeInput, options?: UseCaseRequestOptions): Promise<TightenEpisodeJobResult> {\n    return withUseCaseBody(() => tightenBody(input), (body) => this.client.request(\"POST\", \"/v1/tighten-episode\", { body, ...idempotencyHeaders(options) }))\n  }\n\n  /**\n   * What a Tighten Episode run is estimated at (`POST /v1/tighten-episode/estimate`):\n   * its steps at their own rates plus its per-run fee. Nothing is created or\n   * charged. The estimate leans high: the render is priced at the recording's\n   * full length, while the charge follows the minutes actually rendered.\n   */\n  estimateTightenEpisode(input: TightenEpisodeInput): Promise<{ data: TightenEpisodeEstimate }> {\n    return withUseCaseBody(() => tightenBody(input), (body) => this.client.request(\"POST\", \"/v1/tighten-episode/estimate\", { body }))\n  }\n\n  /**\n   * Chapters (`POST /v1/episode-chapters`): transcribe a recording and list its\n   * chapters in one call. Answers the run's job to poll; the finished job's\n   * `output_data.text` is the list as show notes (one `0:00 Title` line per\n   * chapter; once a chapter starts at 1:00:00 or later, every line is\n   * `H:MM:SS`), `output_data.json` the list itself (`{ startMs, title }[]`, the\n   * same rows; the first starts at 0). A run that finds no chapters fails,\n   * and its fee is refunded. Priced as its steps at their own rates plus the\n   * listed per-run fee; quote it first with {@link estimateEpisodeChapters}.\n   */\n  episodeChapters(input: EpisodeChaptersInput, options?: UseCaseRequestOptions): Promise<UseCaseJobResult> {\n    return withUseCaseBody(() => chaptersBody(input), (body) => this.client.request(\"POST\", \"/v1/episode-chapters\", { body, ...idempotencyHeaders(options) }))\n  }\n\n  /**\n   * What a Chapters run is estimated at (`POST /v1/episode-chapters/estimate`):\n   * its steps at their own rates plus its per-run fee. Nothing is created or\n   * charged. A recording whose length cannot be read is estimated at the\n   * 180-minute ceiling.\n   */\n  estimateEpisodeChapters(input: EpisodeChaptersInput): Promise<{ data: UseCaseEstimate }> {\n    return withUseCaseBody(() => chaptersBody(input), (body) => this.client.request(\"POST\", \"/v1/episode-chapters/estimate\", { body }))\n  }\n\n  /**\n   * Trailer (`POST /v1/episode-trailer`): cut a 20–40 s trailer of a recording\n   * and deliver it in each chosen format (padded, never cropped), optionally\n   * after an intro card, in one call. The finished job's `output_data.formats`\n   * is `{ format, url }[]` in format order, the first also `output_data.videoUrl`;\n   * a format that failed is named in `output_data.failedFormats` (the run keeps\n   * the others). With `reviewBeforeRender` the run stops at a preview\n   * (`videoUrl`, no formats yet). Priced as its steps at their own rates plus\n   * the listed per-run fee; quote it first with {@link estimateEpisodeTrailer}.\n   */\n  episodeTrailer(input: EpisodeTrailerInput, options?: UseCaseRequestOptions): Promise<UseCaseJobResult> {\n    return withUseCaseBody(() => trailerBody(input), (body) => this.client.request(\"POST\", \"/v1/episode-trailer\", { body, ...idempotencyHeaders(options) }))\n  }\n\n  /**\n   * What a Trailer run is estimated at (`POST /v1/episode-trailer/estimate`):\n   * its steps at their own rates plus its per-run fee. Nothing is created or\n   * charged. The trailer is quoted at 40 seconds, the longest trailer the\n   * plan cuts; a Render final is quoted on the trailer the run cut (with the\n   * review's edits), plus the intro card.\n   */\n  estimateEpisodeTrailer(input: EpisodeTrailerInput): Promise<{ data: UseCaseEstimate }> {\n    return withUseCaseBody(() => trailerBody(input), (body) => this.client.request(\"POST\", \"/v1/episode-trailer/estimate\", { body }))\n  }\n\n  /**\n   * Clip Pack (`POST /v1/clip-pack`): cut a recording into a pack of short\n   * clips in one call — the plan finds the best moments (`count`, default 8,\n   * of about `targetDurationSec`, default 60), each is rendered (framed 9:16\n   * with the speakers stacked by default; `framing: null` keeps the\n   * recording's shape) and captioned. An audio recording makes audio clips.\n   * The finished job's `output_data.clips` is `{ url, title?, hook?, clipKey,\n   * thumbnailUrl?, captionsFailed? }[]` in plan order, the first also\n   * `output_data.videoUrl` (`audioUrl` for audio clips). Every clip is tried:\n   * one that cannot be rendered is skipped, not charged and counted on\n   * `failedClips` (the pack keeps the others and its fee); a clip whose\n   * captions failed comes uncaptioned (`captionsFailed`, counted on\n   * `failedCaptions`). When no clip renders the run fails and its fee is\n   * refunded. With `reviewBeforeRender` the run stops at previews; Render\n   * final ({@link continueUseCase}) renders only the clips the edit keeps.\n   * Priced as its steps at their own rates plus the listed per-run fee;\n   * quote it first with {@link estimateClipPack}.\n   */\n  clipPack(input: ClipPackInput, options?: UseCaseRequestOptions): Promise<UseCaseJobResult> {\n    return withUseCaseBody(() => clipPackBody(input), (body) => this.client.request(\"POST\", \"/v1/clip-pack\", { body, ...idempotencyHeaders(options) }))\n  }\n\n  /**\n   * What a Clip Pack run is estimated at (`POST /v1/clip-pack/estimate`): its\n   * steps at their own rates plus its per-run fee. Nothing is created or\n   * charged. Each clip is quoted at twice the target length (the plan may cut\n   * a clip longer than asked); the charge follows each clip's real length.\n   */\n  estimateClipPack(input: ClipPackInput): Promise<{ data: UseCaseEstimate }> {\n    return withUseCaseBody(() => clipPackBody(input), (body) => this.client.request(\"POST\", \"/v1/clip-pack/estimate\", { body }))\n  }\n\n  /**\n   * Speaker Layout (`POST /v1/speaker-layout`): frame a whole recording by\n   * speaker in one call — the same length, nothing cut. One recording: each\n   * speaker framed in turn; several recordings of one conversation: lined up,\n   * each speaker shown on their own camera. The finished job's\n   * `output_data.videoUrl` is the framed video, `output_data.json` the edit\n   * Speaker View drew. With `reviewBeforeRender` the run stops at a preview;\n   * {@link continueUseCase} (`mode: \"render-final\"`, no `editedEdl`) renders\n   * it at full quality. Priced as its steps at their own rates plus the listed\n   * per-run fee; quote it first with {@link estimateSpeakerLayout}.\n   */\n  speakerLayout(input: SpeakerLayoutInput, options?: UseCaseRequestOptions): Promise<UseCaseJobResult> {\n    return withUseCaseBody(() => speakerLayoutBody(input), (body) => this.client.request(\"POST\", \"/v1/speaker-layout\", { body, ...idempotencyHeaders(options) }))\n  }\n\n  /**\n   * What a Speaker Layout run is estimated at (`POST /v1/speaker-layout/estimate`):\n   * its steps at their own rates plus its per-run fee. Nothing is created or\n   * charged. A recording whose length cannot be read is estimated at the\n   * 180-minute ceiling.\n   */\n  estimateSpeakerLayout(input: SpeakerLayoutInput): Promise<{ data: UseCaseEstimate }> {\n    return withUseCaseBody(() => speakerLayoutBody(input), (body) => this.client.request(\"POST\", \"/v1/speaker-layout/estimate\", { body }))\n  }\n\n  /**\n   * Continue a use-case run as a new job (`POST /v1/<type>/continue`, the\n   * run's own type: `input.nodeType`, else the type the job records, read with\n   * `GET /v1/jobs/:id`; when that read cannot tell, this rejects with a\n   * `NodaroError` coded `use_case_type_unknown` — pass `nodeType` then):\n   * `\"from-failed\"` keeps the steps that finished and runs the rest (the fee\n   * is held again; the failed run's was refunded);\n   * `\"render-final\"` renders the full-quality result after a review-on preview,\n   * with the preview's settings and no fee. A refusal that names another job\n   * (`already_running`, `continuation_superseded`,\n   * `render_final_already_rendered`) throws a `ContinuationRefusedError`\n   * carrying that `jobId`.\n   */\n  async continueUseCase(input: UseCaseContinueInput, options?: UseCaseRequestOptions): Promise<UseCaseJobResult> {\n    if (input.nodeType !== undefined && !isUseCaseNodeType(input.nodeType)) {\n      throw new NodaroError(\n        `continueUseCase: nodeType \"${String(input.nodeType)}\" is not a use-case node type (${USE_CASE_NODE_TYPES.join(\", \")})`,\n        \"invalid_node_type\",\n        400,\n      )\n    }\n    const type = input.nodeType ?? (await this.runTypeOf(input.jobId))\n    return this.client.request(\"POST\", continuePathOf(type), {\n      body: { jobId: input.jobId, mode: input.mode, ...(input.editedEdl !== undefined ? { editedEdl: input.editedEdl } : {}) },\n      ...idempotencyHeaders(options),\n    })\n  }\n\n  /**\n   * The use-case type a run records (`input_data.type`, else its `job_type`).\n   * When the key lacks the `jobs:read` scope (403 naming that scope) or the job\n   * names no use-case type, the type cannot be read: this rejects with a\n   * `NodaroError` (`use_case_type_unknown`, 400) asking for `nodeType`, and\n   * nothing is posted (decided 2026-10-18: no route is guessed for the run).\n   * Any other failure of the read, any other 403 included, is thrown as is.\n   */\n  private async runTypeOf(jobId: string): Promise<UseCaseNodeType> {\n    const unknown = () =>\n      new NodaroError(\"continueUseCase: the run's node type cannot be read — pass nodeType\", \"use_case_type_unknown\", 400)\n    let row: { job_type?: unknown; input_data?: unknown } | undefined\n    try {\n      row = (await this.client.request<{ data?: { job_type?: unknown; input_data?: unknown } }>(\"GET\", `/v1/jobs/${encodeURIComponent(jobId)}`)).data\n    } catch (err) {\n      if (err instanceof ForbiddenError && err.missingScope === \"jobs:read\") throw unknown()\n      throw err\n    }\n    const input = row?.input_data\n    const recorded = input && typeof input === \"object\" && !Array.isArray(input) ? (input as { type?: unknown }).type : undefined\n    const type = typeof recorded === \"string\" && recorded.length > 0 ? recorded : row?.job_type\n    if (!isUseCaseNodeType(type)) throw unknown()\n    return type\n  }\n\n  /**\n   * Plan a transcript-driven cut (`POST /v1/edit-plan`). Reads a timed\n   * transcript (plus optional silence ranges) and the media sources, and plans\n   * the edit. The finished job's `output_data` holds the plan: an `Edl`\n   * (`\"tighten\"` or `\"trailer\"`), an {@link EdlClipSet} (`\"clips\"`), or a\n   * {@link ChapterSet} (`\"chapters\"`) — normalize it with {@link unwrapEditPlanOutput}.\n   *\n   * On a self-hosted install the request relays to nodaro.ai and needs the\n   * install connected (a 503 `code: \"nodaro_connection_required\"` otherwise);\n   * on nodaro.ai it runs directly.\n   */\n  editPlan(input: EditPlanInput): Promise<EditJobResult> {\n    // The same pre-dispatch check the canvas and MCP run (B4): the server never\n    // sees `offsets` — they are written onto the sources here.\n    const planned = resolveEditPlanSources(input.sources, {\n      offsets: input.offsets,\n      transcriptSourceId: input.transcriptSourceId,\n    })\n    if (!planned.ok) {\n      const message = planned.issues.map((issue) => describeAudioSyncOffsetIssue(issue)).join(\"; \")\n      return Promise.reject(new NodaroError(`editPlan: ${message}`, \"edit_plan_sources\", 400))\n    }\n    const transcript = planned.transcriptSourceId\n      ? { ...input.transcript, sourceId: planned.transcriptSourceId }\n      : input.transcript\n    return this.client.request(\"POST\", \"/v1/edit-plan\", {\n      body: {\n        mode: input.mode,\n        planTier: input.planTier,\n        transcript,\n        sources: planned.sources,\n        ...(input.silence !== undefined ? { silence: input.silence } : {}),\n        ...(input.instructions !== undefined ? { instructions: input.instructions } : {}),\n        ...(input.styleGuide !== undefined ? { styleGuide: input.styleGuide } : {}),\n        ...(input.count !== undefined ? { count: input.count } : {}),\n        ...(input.targetDurationSec !== undefined ? { targetDurationSec: input.targetDurationSec } : {}),\n        ...(input.targetAspect !== undefined ? { targetAspect: input.targetAspect } : {}),\n        ...(input.platform !== undefined ? { platform: input.platform } : {}),\n        ...(input.workflowId !== undefined ? { workflowId: input.workflowId } : {}),\n      },\n    })\n  }\n\n  /**\n   * Camera Switch (podcast B5): choose which camera shows each cut of `edl`\n   * by who is speaking — the sound never changes. Cloud edition; a flat\n   * price. The finished job's `output_data.json` is the switched EDL (feed it\n   * to {@link applyEdl}) and `output_data.transcript` the transcript with\n   * `speakerNames` applied. A transcript with no speaker labels rejects with\n   * a {@link NodaroError} (`code: \"no_speakers\"`) before any request or charge.\n   */\n  cameraSwitch(input: CameraSwitchInput): Promise<EditJobResult> {\n    if (transcriptSpeakerLabels(input.transcript).length === 0) {\n      return Promise.reject(new NodaroError(\n        \"cameraSwitch: the transcript has no speaker labels — transcribe with speaker detection on\",\n        \"no_speakers\",\n        422,\n      ))\n    }\n    const result = input.speakerMapResult\n    if (result !== undefined && !speakerMapResultOf(result)) return Promise.reject(new NodaroError(\"cameraSwitch: speakerMapResult is not a Speaker Map result — pass that job's output_data.json\", \"not_a_speaker_map\", 400))\n    const speakerMap = result !== undefined ? cameraSwitchSpeakerMap({ speakerMap: input.speakerMap }, input.edl, input.transcript, { speakerMap: result }) : input.speakerMap\n    return this.client.request(\"POST\", \"/v1/camera-switch\", {\n      body: {\n        edl: input.edl,\n        transcript: input.transcript,\n        ...(speakerMap !== undefined ? { speakerMap } : {}),\n        ...(input.speakerNames !== undefined ? { speakerNames: input.speakerNames } : {}),\n        ...(input.minShotMs !== undefined ? { minShotMs: input.minShotMs } : {}),\n        ...(input.leadMs !== undefined ? { leadMs: input.leadMs } : {}),\n        ...(input.maxShotMs !== undefined ? { maxShotMs: input.maxShotMs } : {}),\n        ...(input.wideEvery !== undefined ? { wideEvery: input.wideEvery } : {}),\n        ...(input.layoutHints !== undefined ? { layoutHints: input.layoutHints } : {}),\n        ...(input.workflowId !== undefined ? { workflowId: input.workflowId } : {}),\n      },\n    })\n  }\n\n  /**\n   * Remap a transcript through an EDL — a PURE client-side transform (NO\n   * request). Returns a new transcript whose word (and segment) timings are on\n   * the EDL's rendered output clock, dropping words that fall in cut regions and\n   * clipping straddlers. Runs `@nodaro/shared`'s canonical\n   * `remapTranscriptThroughEdl`, the same remap `applyEdl` performs server-side.\n   */\n  remapTranscript(edl: Edl, transcript: Transcript): Transcript {\n    return remapTranscriptThroughEdl(edl, transcript)\n  }\n}\n"]}
+{"version":3,"sources":["../src/resources/edit-use-case-inputs.ts","../src/resources/edit.ts"],"names":["isUseCaseNodeType","NodaroError","USE_CASE_NODE_TYPES","ForbiddenError","resolveEditPlanSources","describeAudioSyncOffsetIssue","transcriptSpeakerLabels","speakerMapResultOf","cameraSwitchSpeakerMap","edl","remapTranscriptThroughEdl"],"mappings":"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","file":"chunk-7XOK277W.cjs","sourcesContent":["/**\n * The inputs of the podcast use-case runs on the `edit` resource (Tighten\n * Episode, Chapters, Trailer, Clip Pack, Speaker Layout) and the request body each one sends.\n * Split from `edit.ts`, which holds the methods, the type list and the\n * continue routes; every name here is re-exported from there.\n */\nimport type { EditPlanTier, EdlTargetAspect, SpeakerEmphasisStyle, SpeakerSwitchId } from \"@nodaro/shared/edl\"\nimport type { CaptionStyle } from \"@nodaro/shared/captions\"\n\n/**\n * The recordings of a use-case run: one (`mediaUrl`), or the recordings of one\n * conversation (`mediaUrls`, in order — the cameras; one may be sound only),\n * an optional Master audio and the Cameras settings. Pass `mediaUrl` or\n * `mediaUrls`, not both.\n *\n * Several recordings or a Master audio need Speaker Map, which tells who is on\n * which camera: where it is not available to you (not yet on nodaro.ai) the\n * request is refused `403 node_not_available` — send one recording.\n */\nexport interface UseCaseRecordingsInput {\n  /** The recording — a video or audio URL, up to 3 hours. */\n  mediaUrl?: string\n  /**\n   * Instead of `mediaUrl`: the recordings of one conversation, in order — up\n   * to six in all with the Master audio; without one, two or more cameras keep\n   * a place for the sound, so up to five. With two or more the run lines them\n   * up, works out who is on which camera and cuts to whoever is talking.\n   */\n  mediaUrls?: string[]\n  /** The mixer or recorder track: the episode's sound and the clock the recordings are lined up to. */\n  masterAudioUrl?: string\n  /** With several recordings or a Master audio: the Cameras settings (ignored with one recording and no Master audio). */\n  cameras?: {\n    /** Which recording (1-based) is the wide shot, shown when a speaker has no camera of their own; `null` for none. */\n    wide?: number | null\n    /** The recordings already share one clock: skip lining them up. */\n    synced?: boolean\n    /** Who is on which camera: speaker number (`\"1\"` = the first voice heard) → recording number, 0 = the wide shot. Overrides the automatic map. */\n    speakerCameras?: Record<string, number>\n  }\n}\n\n/**\n * Input for {@link EditResource.tightenEpisode} and\n * {@link EditResource.estimateTightenEpisode}: the recording (or the\n * recordings of one conversation, see {@link UseCaseRecordingsInput}) in, the\n * tightened episode out. Only the recording is required; every other field\n * left out takes the node's default.\n */\nexport interface TightenEpisodeInput extends UseCaseRecordingsInput {\n  /** Optional music bed, ducked under the voice and ending with the episode. */\n  musicUrl?: string\n  /** `\"video\"` or `\"audio\"`; an audio recording always makes an audio episode. */\n  output?: \"video\" | \"audio\"\n  /**\n   * Frame a video episode with Speaker View: an output aspect and a layout,\n   * over automatic boxes on the speakers on screen. A layout the aspect does\n   * not draw is snapped to one it does. `null` or absent: no framing.\n   */\n  framing?: {\n    aspect: EdlTargetAspect\n    layout: \"auto\" | \"single\" | \"side-by-side\" | \"stacked\" | \"grid\" | \"pip\"\n  } | null\n  /**\n   * With a framing, how it follows the speakers: `\"static\"` (the default)\n   * splits the frame evenly by speaker; `\"tracking\"` follows faces with\n   * Speaker Frames (charged per started block of 1,000 sampled frames; a\n   * camera shared by several speakers keeps the even split until faces are\n   * named; refused 403 where Speaker Frames is not available to the caller);\n   * `\"auto\"` follows faces while Speaker Frames is available to the caller,\n   * else the even split. Ignored without a framing.\n   */\n  framingSource?: \"auto\" | \"static\" | \"tracking\"\n  /** Captions on a video episode (on by default). */\n  captions?: boolean\n  /** The captions' look. */\n  captionStyle?: CaptionStyle\n  /**\n   * Stop at a quick preview for a person to review; render the full-quality\n   * episode afterwards with {@link EditResource.continueUseCase}\n   * (`mode: \"render-final\"`).\n   */\n  reviewBeforeRender?: boolean\n  /** The planner's tier. */\n  planTier?: EditPlanTier\n  /** Editing instructions for the planner (up to 4 000 characters). */\n  instructions?: string\n  /** A style guide for the planner (up to 4 000 characters). */\n  styleGuide?: string\n  /** How far the music dips under the voice, 0–100 (default 75). */\n  musicDuckAmount?: number\n}\n\n/**\n * Input for {@link EditResource.episodeChapters} and\n * {@link EditResource.estimateEpisodeChapters}: one recording in, its chapters\n * out. Only `mediaUrl` is required; every other field left out takes the\n * node's default.\n */\nexport interface EpisodeChaptersInput {\n  /** The recording — a video or audio URL, up to 3 hours. */\n  mediaUrl: string\n  /** The planner's tier (default `\"economy\"`). */\n  planTier?: EditPlanTier\n  /** Instructions for the chapters, e.g. \"5 to 8 chapters\" (up to 4 000 characters). */\n  instructions?: string\n  /** A style guide for the chapter titles (up to 4 000 characters). */\n  styleGuide?: string\n}\n\n/** The formats a Trailer is delivered in, in delivery order (16:9 is a 1920×1080 landscape). */\nexport const TRAILER_FORMATS = [\"9:16\", \"1:1\", \"4:5\", \"16:9\"] as const\n/** One Trailer format (see {@link TRAILER_FORMATS}). */\nexport type TrailerFormat = (typeof TRAILER_FORMATS)[number]\n\n/**\n * Input for {@link EditResource.episodeTrailer} and\n * {@link EditResource.estimateEpisodeTrailer}: one video recording (or the\n * recordings of one conversation, see {@link UseCaseRecordingsInput}) in, a\n * 20–40 s trailer out in each chosen format. Only the recording is required.\n */\nexport interface EpisodeTrailerInput extends UseCaseRecordingsInput {\n  /** The recording — a video URL, up to 3 hours (a run with no picture is refused). Or `mediaUrls`. */\n  mediaUrl?: string\n  /** An optional intro card: a short video (15 s at most) played before the trailer. */\n  introCardUrl?: string\n  /** The formats to deliver, padded, never cropped (default `[\"9:16\", \"1:1\", \"4:5\"]`; an empty list is refused). */\n  formats?: TrailerFormat[]\n  /** Stop at a preview of the trailer; render every format with {@link EditResource.continueUseCase} (`mode: \"render-final\"`). */\n  reviewBeforeRender?: boolean\n  /** The planner's tier (default `\"standard\"`). */\n  planTier?: EditPlanTier\n  /** Instructions for the trailer (up to 4 000 characters). */\n  instructions?: string\n  /** A style guide for the planner (up to 4 000 characters). */\n  styleGuide?: string\n}\n\n/** The shortest and longest clip a Clip Pack asks the plan for, in seconds. */\nexport const CLIP_PACK_MIN_TARGET_SEC = 5\nexport const CLIP_PACK_MAX_TARGET_SEC = 180\n\n/**\n * A Clip Pack emphasis: `\"none\"`, or one or more of `\"scale\"`, `\"border\"` and\n * `\"dim\"` joined with `\"+\"` (each once — the route refuses a repeat).\n */\nexport type ClipPackEmphasis = SpeakerEmphasisStyle | `${Exclude<SpeakerEmphasisStyle, \"none\">}+${string}`\n\n/**\n * Input for {@link EditResource.clipPack} and\n * {@link EditResource.estimateClipPack}: the recording (or the recordings of\n * one conversation, see {@link UseCaseRecordingsInput} — each clip then cuts\n * to whoever is talking) in, a pack of short clips out. An audio recording\n * makes audio clips (no framing, no captions). Only the recording is\n * required; every other field left out takes the node's default.\n */\nexport interface ClipPackInput extends UseCaseRecordingsInput {\n  /** How many clips to find, 1–50 (default 8). The plan may find fewer. */\n  count?: number\n  /** Each clip's target length in seconds, {@link CLIP_PACK_MIN_TARGET_SEC}–{@link CLIP_PACK_MAX_TARGET_SEC} (default 60). */\n  targetDurationSec?: number\n  /**\n   * Frame each video clip with Speaker View on automatic boxes over the\n   * episode's speakers: the shape, and optionally the layout (default\n   * `\"stacked\"`; one the shape does not draw is snapped), the switch at each\n   * speaker change (default `\"pan\"`) and the emphasis (default `\"scale\"`;\n   * `\"none\"`, or `\"scale\"`, `\"border\"` and `\"dim\"` joined with `\"+\"`). Left\n   * out: 9:16, stacked, pan, scale. `null`: no framing (the recording's shape).\n   */\n  framing?: {\n    aspect: EdlTargetAspect\n    layout?: \"auto\" | \"single\" | \"side-by-side\" | \"stacked\" | \"grid\" | \"pip\"\n    switchType?: SpeakerSwitchId\n    emphasisStyle?: ClipPackEmphasis\n  } | null\n  /**\n   * With a framing, how it follows the speakers: `\"static\"` splits the frame\n   * evenly by speaker (what a request that leaves this out gets); `\"tracking\"`\n   * runs Speaker Frames once over the whole pack to follow faces (charged per\n   * started block of 1,000 sampled frames; refused 403 where Speaker Frames is\n   * not available to the caller); `\"auto\"` follows faces while Speaker Frames\n   * is available to the caller, else the even split. Ignored without a framing.\n   */\n  framingSource?: \"auto\" | \"static\" | \"tracking\"\n  /** Caption each video clip (on by default). */\n  captions?: boolean\n  /** The captions' look (default `\"karaoke\"`). */\n  captionStyle?: CaptionStyle\n  /**\n   * Stop at quick previews of the clips for a person to review; render the\n   * kept clips at full quality with {@link EditResource.continueUseCase}\n   * (`mode: \"render-final\"`, an `editedEdl` that keeps or drops clips).\n   */\n  reviewBeforeRender?: boolean\n  /** The planner's tier (default `\"standard\"`). */\n  planTier?: EditPlanTier\n  /** Instructions for picking the clips (up to 4 000 characters). */\n  instructions?: string\n  /** A style guide for the planner (up to 4 000 characters). */\n  styleGuide?: string\n}\n\n/**\n * Input for {@link EditResource.speakerLayout} and\n * {@link EditResource.estimateSpeakerLayout}: one video recording (or the\n * recordings of one conversation, see {@link UseCaseRecordingsInput}) in, the\n * whole recording framed by speaker out — the same length, nothing cut. Only\n * the recording is required; every other field left out takes the node's\n * default.\n */\nexport interface SpeakerLayoutInput extends UseCaseRecordingsInput {\n  /** The recording — a video URL, up to 3 hours (an audio-only recording is refused). Or `mediaUrls`. */\n  mediaUrl?: string\n  /** The video's shape (default `\"9:16\"`). With one recording, a video already as narrow as the shape (or narrower) is refused `400 media_shape`. */\n  targetAspect?: EdlTargetAspect\n  /** How the speakers are laid out (default `\"stacked\"`; one the shape does not draw is snapped to one it does). */\n  layout?: \"auto\" | \"single\" | \"side-by-side\" | \"stacked\" | \"grid\" | \"pip\"\n  /** The switch at each speaker change (default `\"cut\"`). */\n  switchType?: SpeakerSwitchId\n  /** How the speaker talking is emphasised (default `\"scale\"`): `\"none\"`, or `\"scale\"`, `\"border\"` and `\"dim\"` joined with `\"+\"`. */\n  emphasisStyle?: ClipPackEmphasis\n  /**\n   * How the speakers are followed: `\"auto\"` (the default) follows faces with\n   * Speaker Frames while it is available to the caller, else splits the frame\n   * evenly; `\"static\"` splits the frame evenly by speaker; `\"tracking\"`\n   * follows faces (charged per started block of 1,000 sampled frames;\n   * refused 403 where Speaker Frames is not available to the caller). Faces\n   * aren't named after a speaker yet, so a camera shared by several speakers\n   * keeps the even split.\n   */\n  framingSource?: \"auto\" | \"static\" | \"tracking\"\n  /**\n   * Stop at a quick preview for a person to review; render it at full\n   * quality with {@link EditResource.continueUseCase}\n   * (`mode: \"render-final\"`, no `editedEdl`: the layout has no cut to change).\n   */\n  reviewBeforeRender?: boolean\n}\n\n/**\n * The body's recordings (`mediaUrls`, then `masterAudioUrl` and `cameras` when\n * given), and the rest of the input as it came: the one mapper every use-case\n * body goes through. Throws before any request when the input names both\n * `mediaUrl` and `mediaUrls`, or neither.\n */\nfunction withRecordings<T extends UseCaseRecordingsInput>(input: T): Record<string, unknown> {\n  const { mediaUrl, mediaUrls, masterAudioUrl, cameras, ...rest } = input\n  if (mediaUrl !== undefined && mediaUrls !== undefined) throw new TypeError(\"pass mediaUrl or mediaUrls, not both\")\n  const recordings = mediaUrls ?? (mediaUrl !== undefined ? [mediaUrl] : undefined)\n  if (!recordings) throw new TypeError(\"pass mediaUrl or mediaUrls\")\n  return {\n    mediaUrls: [...recordings],\n    ...(masterAudioUrl !== undefined ? { masterAudioUrl } : {}),\n    ...(cameras !== undefined ? { cameras } : {}),\n    ...Object.fromEntries(Object.entries(rest).filter(([, v]) => v !== undefined)),\n  }\n}\n\n/**\n * Sends `send` the body `build` makes, or rejects (never throws) with the\n * error of an input the body cannot take — before any request, as every input\n * check of the `edit` resource rejects.\n */\nexport function withUseCaseBody<T>(build: () => Record<string, unknown>, send: (body: Record<string, unknown>) => Promise<T>): Promise<T> {\n  let body: Record<string, unknown>\n  try {\n    body = build()\n  } catch (err) {\n    return Promise.reject(err)\n  }\n  return send(body)\n}\n\nexport function tightenBody(input: TightenEpisodeInput): Record<string, unknown> {\n  return withRecordings(input)\n}\n\nexport function chaptersBody(input: EpisodeChaptersInput): Record<string, unknown> {\n  return withRecordings({\n    mediaUrl: input.mediaUrl,\n    ...(input.planTier !== undefined ? { planTier: input.planTier } : {}),\n    ...(input.instructions !== undefined ? { instructions: input.instructions } : {}),\n    ...(input.styleGuide !== undefined ? { styleGuide: input.styleGuide } : {}),\n  })\n}\n\nexport function trailerBody(input: EpisodeTrailerInput): Record<string, unknown> {\n  return withRecordings({\n    mediaUrl: input.mediaUrl,\n    mediaUrls: input.mediaUrls,\n    masterAudioUrl: input.masterAudioUrl,\n    cameras: input.cameras,\n    ...(input.introCardUrl !== undefined ? { introCardUrl: input.introCardUrl } : {}),\n    // An empty list is sent as is: the route refuses it (at least one format).\n    ...(input.formats !== undefined ? { formats: input.formats } : {}),\n    ...(input.reviewBeforeRender !== undefined ? { reviewBeforeRender: input.reviewBeforeRender } : {}),\n    ...(input.planTier !== undefined ? { planTier: input.planTier } : {}),\n    ...(input.instructions !== undefined ? { instructions: input.instructions } : {}),\n    ...(input.styleGuide !== undefined ? { styleGuide: input.styleGuide } : {}),\n  })\n}\n\n/** Clip Pack's body: what the caller set, `framing: null` included (no framing). */\nexport function clipPackBody(input: ClipPackInput): Record<string, unknown> {\n  return withRecordings(input)\n}\n\n/** Speaker Layout's body: the recordings, then what the caller set. */\nexport function speakerLayoutBody(input: SpeakerLayoutInput): Record<string, unknown> {\n  return withRecordings(input)\n}\n","import type { NodaroClientCore } from \"../core.js\"\nimport { ForbiddenError, NodaroError } from \"../errors.js\"\nimport {\n  remapTranscriptThroughEdl,\n  unwrapEditPlanOutput,\n  resolveEditPlanSources,\n  describeAudioSyncOffsetIssue,\n  transcriptSpeakerLabels,\n  cameraSwitchSpeakerMap, speakerMapResultOf, type SpeakerMapResult,\n  type Edl,\n  type Transcript,\n  type EditPlanMode,\n  type EditPlanTier,\n  type EdlClipSet,\n  type ChapterSet,\n  type EdlTargetAspect\n} from \"@nodaro/shared/edl\"\nimport { USE_CASE_NODE_TYPES, isUseCaseNodeType, type UseCaseNodeType } from \"@nodaro/shared/nodes\"\nimport type { SpeakerMapInput } from \"./speaker-map-inputs.js\"\nimport {\n  chaptersBody,\n  clipPackBody,\n  speakerLayoutBody,\n  tightenBody,\n  trailerBody,\n  withUseCaseBody,\n  type ClipPackInput,\n  type EpisodeChaptersInput,\n  type EpisodeTrailerInput,\n  type SpeakerLayoutInput,\n  type TightenEpisodeInput,\n} from \"./edit-use-case-inputs.js\"\n\nexport { CLIP_PACK_MAX_TARGET_SEC, CLIP_PACK_MIN_TARGET_SEC, TRAILER_FORMATS } from \"./edit-use-case-inputs.js\"\nexport type { ClipPackEmphasis, ClipPackInput, EpisodeChaptersInput, EpisodeTrailerInput, SpeakerLayoutInput, TightenEpisodeInput, TrailerFormat, UseCaseRecordingsInput } from \"./edit-use-case-inputs.js\"\n\n// Re-export the canonical EDL / transcript vocabulary from `@nodaro/shared`\n// (single source of truth — the shapes live at `packages/shared/src/edl.ts`).\n// `@nodaro/shared` is already a hard dep of this package, so there is no\n// bundle-size cost to importing from it, and an integration builds requests and\n// reads results with one dependency. `EdlClipSet` / `ChapterSet` are the raw\n// `output_data` shapes of the `clips` / `chapters` modes, and\n// `unwrapEditPlanOutput` is the sanctioned way to normalize any edit-plan job's\n// `output_data` (it also strips the relay's `viaNodaroCloud` marker).\nexport type { Edl, Transcript, EditPlanMode, EditPlanTier, EdlClipSet, ChapterSet }\nexport { unwrapEditPlanOutput }\n\n/**\n * A silence-detect job's `output_data.json` — the value to pass as\n * {@link EditPlanInput.silence}. It is NOT what {@link EditResource.silenceDetect}\n * returns (that is `{ jobId }`); fetch the finished job and read its\n * `output_data.json`. The planner reads the `ranges` array — an input without\n * one is silently ignored, so pass this whole object.\n */\nexport interface SilenceRanges {\n  /** Wire version of the payload. */\n  version?: number\n  /** Silence spans on the source clock, in ms. */\n  ranges: ReadonlyArray<{ startMs: number; endMs: number }>\n  /** Total source duration, in ms. */\n  durationMs?: number\n}\n\n/** Every editorial route answers with the queued job to poll. */\nexport interface EditJobResult {\n  /** The queued job id — follow it via `client.jobs.getStatus(jobId)`. */\n  jobId: string\n}\n\nexport interface SilenceDetectInput {\n  /**\n   * An audio OR video source. A single ffmpeg `silencedetect` pass runs over the\n   * source's audio proxy either way — no provider key required.\n   */\n  audioUrl: string\n  /** dBFS threshold, always ≤ 0. Default -35 (a good podcast default). */\n  thresholdDb?: number\n  /** Minimum silence length to report, in ms. Default 700. */\n  minSilenceMs?: number\n  /** Padding kept around speech, in ms — shrinks each reported range inward. Default 120. */\n  padMs?: number\n  /**\n   * Optionally associate this run with a workflow execution (display only — it\n   * ties the standalone job back to a workflow for the execution history).\n   */\n  workflowId?: string\n}\n\n/** One recording for {@link EditResource.audioSync}. */\nexport interface AudioSyncSource {\n  /**\n   * Your id for this recording (1–200 chars, unique within the request) —\n   * echoed back as its offset's `sourceId`. Use the id your EDL gives the same\n   * recording (`EdlSource.id`) and the result folds straight into it.\n   */\n  id: string\n  /** An audio OR video URL — the audio track is read either way. */\n  url: string\n}\n\nexport interface AudioSyncInput {\n  /** The 2–6 recordings of one conversation to line up (camera files and/or a master mic). */\n  sources: AudioSyncSource[]\n  /**\n   * The id of the source every offset is measured against (its own offset is\n   * 0). Must be one of `sources`' ids; default: the first source.\n   */\n  reference?: string\n  /** Optionally associate this run with a workflow execution (display only). */\n  workflowId?: string\n}\n\n/** One recording's measured clock offset in an {@link AudioSyncResult}. */\nexport interface AudioSyncOffset {\n  /** The recording's `id` from the request. */\n  sourceId: string\n  /**\n   * Where this recording sits on the reference's clock, in integer ms:\n   * `referenceMs = sourceMs + offsetMs` (the EDL's D19 sign — the value\n   * `EdlSource.offsetMs` takes when the reference is the master).\n   */\n  offsetMs: number\n  /** 0–1. Below 0.5 a `notes` line asks for a check by ear. */\n  confidence: number\n  /**\n   * Measured clock drift against the reference, in ms gained per hour; `null`\n   * when the shared stretch was too short to measure it. Drift is reported,\n   * never corrected — the offset is taken at the middle of the overlap.\n   */\n  driftMsPerHour: number | null\n}\n\n/**\n * An audio-sync job's `output_data.json`. It is NOT what\n * {@link EditResource.audioSync} returns (that is `{ jobId }`); fetch the\n * finished job and read its `output_data.json`.\n */\nexport interface AudioSyncResult {\n  /** Wire version of the payload. */\n  version: number\n  /** The source every offset is measured against (its own offset is 0). */\n  reference: string\n  offsets: AudioSyncOffset[]\n  /** Human-readable warnings: low confidence, measured drift, no shared sound. */\n  notes: string[]\n}\n\nexport interface ApplyEdlInput {\n  /** The edit decision list to render. Media resolves from each `edl.sources[i].url`. */\n  edl: Edl\n  /**\n   * Optional media-URL overrides for `edl.sources[i].url`, POSITIONAL in this\n   * array's order. Each URL is SSRF-guarded server-side like any media the\n   * platform fetches.\n   */\n  sources?: string[]\n  /**\n   * Optional transcript to remap through the cut. The rendered job returns the\n   * remapped transcript on its `json` output. A word-level multi-hour transcript\n   * is several MB — if you only need the re-timed transcript (not a render), use\n   * {@link EditResource.remapTranscript} locally instead of sending it here.\n   */\n  transcript?: Transcript\n  /** Render a full video (default) or an audio-only cut. */\n  output?: \"video\" | \"audio\"\n  /** Fast proxy draft or the final render. Default \"final\". */\n  quality?: \"proxy\" | \"final\"\n  /**\n   * Default crossfade (ms) on boundaries with no explicit transition; 0 = hard\n   * cuts. Per-boundary clamped to the ffmpeg-xfade limit server-side. Default 0.\n   */\n  crossfadeMs?: number\n  /**\n   * The plan clip this render cuts — `edlSpanKey(clip)` from `@nodaro/shared`\n   * (`\"<first inMs>-<last outMs>\"`). The job's result carries it back as\n   * `output_data.clipKey`, so renders of a clip set can be matched to their\n   * clips. Omit for a render of no plan clip.\n   */\n  clipKey?: string\n  /**\n   * The plan value this render cuts — `renderReadBasis(value)` from\n   * `@nodaro/shared` (16 lowercase hex digits), where `value` is the Edit\n   * Plan's Tighten EDL with any review applied, or the clip this render cuts.\n   * The job's result carries it back as `output_data.planBasis`, so a take can\n   * be told apart from one cut from an earlier plan. Send it only when the EDL\n   * you send IS that value (not one an intermediate step re-cut from an older\n   * plan); omit it otherwise. The result's `output_data.renderBasis` (the\n   * render's own settings and sources) is stamped by the server.\n   */\n  planBasis?: string\n  /** Optionally associate this run with a workflow execution (display only). */\n  workflowId?: string\n}\n\n/**\n * One media source for an edit-plan run. Mirrors the shape the workflow engine\n * sends: a stable `id` (adopted verbatim as the plan's `EdlSource` id), the\n * media `url`, and the `kind`, plus optional per-source annotations the planner\n * honors.\n */\nexport interface EditPlanSource {\n  /** Stable id for this source — becomes the `EdlSource` id in the returned plan. */\n  id: string\n  /** The source's media URL (SSRF-guarded server-side). */\n  url: string\n  /** This source's medium. */\n  kind: \"video\" | \"audio\"\n  /** Role annotation. `\"master-audio\"` marks the clock the plan is reserved on. */\n  role?: \"master-audio\" | \"camera\" | \"wide\" | \"screen\"\n  /** Speaker labels present in this source. */\n  speakers?: string[]\n  /**\n   * This source's origin on the master clock (masterMs = sourceMs + offsetMs).\n   * Set by hand, it wins over a measured offset from `offsets`.\n   */\n  offsetMs?: number\n}\n\nexport interface EditPlanInput {\n  /**\n   * Planning mode. The finished job's `output_data` carries the plan — read it\n   * with {@link unwrapEditPlanOutput}, which also strips the relay's\n   * `viaNodaroCloud` marker:\n   *   - `\"tighten\"`  → an `Edl`.\n   *   - `\"clips\"`    → an {@link EdlClipSet} (`{ version, clips: Edl[] }`);\n   *                    `unwrapEditPlanOutput` returns the bare `Edl[]`.\n   *   - `\"chapters\"` → a {@link ChapterSet} (`{ version, chapters: [...] }`).\n   *   - `\"trailer\"`  → an `Edl` (one short teaser cut from the strongest moments).\n   */\n  mode: EditPlanMode\n  /** Reasoning tier — affects plan quality AND the credit bucket. */\n  planTier: EditPlanTier\n  /** The timed transcript driving the plan. */\n  transcript: Transcript\n  /**\n   * Optional detected silence ranges. Pass the silence-detect JOB'S RESULT —\n   * `getStatus(jobId).data.output_data.json` (a {@link SilenceRanges} object),\n   * NOT the `{ jobId }` that {@link EditResource.silenceDetect} returns. The\n   * planner reads the `ranges` array; an input without one is silently ignored.\n   */\n  silence?: SilenceRanges\n  /** The recording's media sources (1–6). */\n  sources: EditPlanSource[]\n  /**\n   * Multicam: an {@link AudioSyncResult} (the audio-sync job's\n   * `output_data.json`) measured over these same source ids. Each source's\n   * measured offset is written onto its `offsetMs` BEFORE the request, on the\n   * master's clock (the `master-audio` source, else the first) — a source's\n   * own `offsetMs` wins. `editPlan` rejects with a {@link NodaroError}\n   * (`code: \"edit_plan_sources\"`), before any request or charge, when a\n   * source was not measured or matched weakly (confidence < 0.5 — set its\n   * `offsetMs` by hand), or the master was not measured.\n   */\n  offsets?: AudioSyncResult | string\n  /**\n   * The id of the source the transcript was made from, when you know it. The\n   * plan follows the master's clock, so a transcript made from a source that\n   * is off it is rejected the same way.\n   */\n  transcriptSourceId?: string\n  /** Free-text editing steer. */\n  instructions?: string\n  /** Style-guide text applied to the plan. */\n  styleGuide?: string\n  /** `\"clips\"` mode only: how many clips to cut. */\n  count?: number\n  /** `\"clips\"` mode only: target duration per clip, in seconds. */\n  targetDurationSec?: number\n  /** Target aspect for cut clips (`\"clips\"`) or the teaser (`\"trailer\"`). */\n  targetAspect?: \"16:9\" | \"9:16\" | \"1:1\" | \"4:5\"\n  /** Target platform hint (e.g. a social platform name). */\n  platform?: string\n  /** Optionally associate this run with a workflow execution (display only). */\n  workflowId?: string\n}\n\n/** Input for {@link EditResource.cameraSwitch} (podcast B5). */\nexport interface CameraSwitchInput {\n  /** One EDL — an `editPlan` result (`unwrapEditPlanOutput`), not a clip set. */\n  edl: Edl\n  /** The word transcript WITH speaker labels (transcribe with speaker detection). */\n  transcript: Transcript\n  /** Speaker label → the EDL source id of that speaker's camera. A speaker\n   *  left out shows the source whose `speakers` list names them, else the\n   *  `wide` camera, else any camera that filmed them. */\n  speakerMap?: Record<string, string>\n  /** A {@link EditResource.speakerMap} job's `output_data.json`: a label in `speakerMap`\n   *  wins, then this result, then the n-th speaker heard gets the n-th camera. */\n  speakerMapResult?: SpeakerMapResult | string\n  /** Speaker label → display name (on the segments and the returned transcript). */\n  speakerNames?: Record<string, string>\n  /** The shortest shot in ms (default 2 500): a shorter turn holds the shot. */\n  minShotMs?: number\n  /** Cut this long before the new speaker starts, ms (default 200). */\n  leadMs?: number\n  /** With a `wide` source: break to it after this long on one camera, ms (default 20 000). */\n  maxShotMs?: number\n  /** With a `wide` source: every N-th cut goes to the wide (default 0 = off). */\n  wideEvery?: number\n  /** Overlapping speech → a layout hint (default false; Apply EDL renders cut-only edits). */\n  layoutHints?: boolean\n  /** Optionally associate this run with a workflow execution (display only). */\n  workflowId?: string\n}\n\n/**\n * The podcast use-case node types, each one a route (`POST /v1/<type>`, and\n * `POST /v1/<type>/continue` to continue one of its runs).\n */\nexport { USE_CASE_NODE_TYPES, type UseCaseNodeType }\n\n/** The route that continues a run of `type`. */\nconst continuePathOf = (type: UseCaseNodeType): `/v1/${UseCaseNodeType}/continue` => `/v1/${type}/continue`\n\n/** What a use-case run (`tightenEpisode`, `episodeChapters`, `episodeTrailer`, `clipPack`, `speakerLayout`) and `continueUseCase` answer: the run's job to poll. */\nexport interface UseCaseJobResult extends EditJobResult {\n  /** The run's execution (absent on a deduplicated retry). */\n  executionId?: string\n  /** `true` when an `Idempotency-Key` retry found the run already started: `jobId` is that run. */\n  deduped?: boolean\n}\n\n/** What `tightenEpisode` answers (a {@link UseCaseJobResult}). */\nexport type TightenEpisodeJobResult = UseCaseJobResult\n\n/**\n * What a use-case run is estimated at (`data`). Every credit amount is 0\n * on an edition without credits; `durationSec` is `null` when the recording's\n * length could not be read.\n */\nexport interface UseCaseEstimate {\n  /** The whole run: its steps plus the fee. */\n  totalCredits: number\n  /** The steps at their own rates. */\n  stepsCredits: number\n  /** The per-run fee. */\n  feeCredits: number\n  /** A step is a metered LLM call's ESTIMATE (charged its actual usage), so the\n   *  total is one: show it `~N`. Absent for a fixed figure. */\n  estimate?: true\n  /** The recording's length, in seconds. */\n  durationSec: number | null\n}\n\n/** What a Tighten Episode run is estimated at (a {@link UseCaseEstimate}). */\nexport type TightenEpisodeEstimate = UseCaseEstimate\n\n/** Input for {@link EditResource.continueUseCase}. */\nexport interface UseCaseContinueInput {\n  /** The run to continue: the job `tightenEpisode`, `episodeChapters`, `episodeTrailer`, `clipPack` or `speakerLayout` (or an earlier continuation) answered. */\n  jobId: string\n  /**\n   * `\"from-failed\"` re-runs what did not finish of a failed run;\n   * `\"render-final\"` renders the full-quality result after a review-on preview\n   * (a Chapters run has no preview: it is refused `render_final_not_preview`;\n   * a Clip Pack edit that drops every clip is refused `use_case_nothing_kept`).\n   */\n  mode: \"from-failed\" | \"render-final\"\n  /** Render final only: the reviewer's edit of the plan (an EDL). A Speaker Layout run has no plan: an edit is refused `400 use_case_no_plan`. */\n  editedEdl?: unknown\n  /**\n   * The run's node type: its continuation goes to `POST /v1/<nodeType>/continue`.\n   * Optional: when absent the job is read first (`GET /v1/jobs/:id`, which\n   * needs the `jobs:read` scope on an app token) for the type the run records.\n   * Required when that read cannot answer: a key without `jobs:read`, or a job\n   * that records no use-case type (the call rejects with `use_case_type_unknown`).\n   */\n  nodeType?: UseCaseNodeType\n}\n\n/** Per-call options for the use-case requests (Tighten Episode, Chapters, Trailer, Clip Pack, Speaker Layout, and their continuations). */\nexport interface UseCaseRequestOptions {\n  /**\n   * Sent as the `Idempotency-Key` header. Reuse the same value when retrying\n   * the same request and the server answers the run it already started\n   * (`deduped: true`) instead of starting a second one.\n   */\n  idempotencyKey?: string\n}\n\nfunction idempotencyHeaders(options?: UseCaseRequestOptions): { headers?: Record<string, string> } {\n  return options?.idempotencyKey ? { headers: { \"Idempotency-Key\": options.idempotencyKey } } : {}\n}\n\n/**\n * Editorial primitives for podcast / long-form video editing, single-camera\n * and multicam: measure the cameras' offsets ({@link audioSync}), plan the cut\n * ({@link editPlan}), put each cut on the speaker's camera\n * ({@link cameraSwitch}), render a Preview to review (`applyEdl` with\n * `quality: \"proxy\"`), then the final (`quality: \"final\"`).\n *\n * - {@link silenceDetect}, {@link audioSync} and {@link applyEdl} are core nodes\n *   available on every edition.\n * - {@link editPlan} and {@link cameraSwitch} run on nodaro.ai; a self-hosted\n *   install relays them once it is connected (a 503\n *   `code: \"nodaro_connection_required\"` otherwise).\n * - {@link tightenEpisode} runs the whole chain (transcribe, plan, render, and\n *   optionally captions, music and framing) in one call. It is core, but a\n *   self-hosted install needs a nodaro.ai connection for the steps that run\n *   there (a 503 `code: \"nodaro_connection_required\"` otherwise).\n *   {@link continueUseCase} continues one of its runs.\n * - {@link episodeChapters} lists a recording's chapters (transcribe, then the\n *   plan in chapters mode) in one call; nothing renders. Like\n *   {@link tightenEpisode}, a self-hosted install needs a nodaro.ai connection.\n * - {@link episodeTrailer} cuts a 20–40 s trailer of a recording and delivers\n *   it in each chosen format in one call; the same connection applies.\n * - {@link clipPack} cuts a recording into a pack of short clips (framed and\n *   captioned by default) in one call; the same connection applies.\n * - {@link speakerLayout} frames a whole recording by speaker (the same\n *   length, nothing cut) in one call; the same connection applies.\n * - {@link remapTranscript} is a PURE local transform (no request) — the same\n *   remap `applyEdl` performs on its `transcript`, exposed for callers that hold\n *   an EDL and a transcript and only want the re-timed transcript.\n *\n * Every request method except the estimates ({@link estimateTightenEpisode},\n * {@link estimateEpisodeChapters}, {@link estimateEpisodeTrailer},\n * {@link estimateClipPack}, {@link estimateSpeakerLayout}: a quote, `{ data }`) returns\n * {@link EditJobResult} (the use-case runs a {@link UseCaseJobResult}); poll the\n * `jobId` with `client.jobs.getStatus(jobId)`.\n */\nexport class EditResource {\n  constructor(private client: NodaroClientCore) {}\n\n  /**\n   * Detect silence ranges in an audio/video source (`POST /v1/silence-detect`).\n   * Keyless — one ffmpeg pass over the source's audio proxy.\n   */\n  silenceDetect(input: SilenceDetectInput): Promise<EditJobResult> {\n    return this.client.request(\"POST\", \"/v1/silence-detect\", {\n      body: {\n        audioUrl: input.audioUrl,\n        ...(input.thresholdDb !== undefined ? { thresholdDb: input.thresholdDb } : {}),\n        ...(input.minSilenceMs !== undefined ? { minSilenceMs: input.minSilenceMs } : {}),\n        ...(input.padMs !== undefined ? { padMs: input.padMs } : {}),\n        ...(input.workflowId !== undefined ? { workflowId: input.workflowId } : {}),\n      },\n    })\n  }\n\n  /**\n   * Measure how far apart the clocks of 2–6 recordings of one conversation are\n   * (`POST /v1/audio-sync`), by cross-correlating their audio — keyless, one\n   * ffmpeg decode per source. The finished job's `output_data.json` is an\n   * {@link AudioSyncResult}. A malformed request (fewer than 2 or more than 6\n   * sources, a repeated id, a `reference` that is not one of the ids) throws a\n   * typed `NodaroError` (400, `code: \"validation_error\"`) before any credits\n   * are reserved.\n   */\n  audioSync(input: AudioSyncInput): Promise<EditJobResult> {\n    return this.client.request(\"POST\", \"/v1/audio-sync\", {\n      body: {\n        sources: input.sources.map((s) => ({ id: s.id, url: s.url })),\n        ...(input.reference !== undefined ? { reference: input.reference } : {}),\n        ...(input.workflowId !== undefined ? { workflowId: input.workflowId } : {}),\n      },\n    })\n  }\n\n  /**\n   * Which camera each speaker is on, from the cameras' own microphones (`POST\n   * /v1/speaker-map`), keyless. `output_data.json` is a `SpeakerMapResult`: pass\n   * it to {@link cameraSwitch} as `speakerMapResult`. A malformed request throws\n   * a `NodaroError` (400 `validation_error`; 422 `no_speakers` for a transcript\n   * with no speaker labels) before any credits are reserved.\n   */\n  speakerMap(input: SpeakerMapInput): Promise<EditJobResult> {\n    return this.client.request(\"POST\", \"/v1/speaker-map\", {\n      body: {\n        sources: input.sources.map((s) => ({ id: s.id, url: s.url, ...(s.kind ? { kind: s.kind } : {}) })),\n        transcript: input.transcript,\n        ...(input.offsets !== undefined ? { offsets: input.offsets } : {}),\n        ...(input.masterSourceId !== undefined ? { masterSourceId: input.masterSourceId } : {}),\n        ...(input.wideSourceId !== undefined ? { wideSourceId: input.wideSourceId } : {}),\n        ...(input.marginDb !== undefined ? { marginDb: input.marginDb } : {}),\n        ...(input.workflowId !== undefined ? { workflowId: input.workflowId } : {}),\n      },\n    })\n  }\n\n  /**\n   * Render an edit decision list into a video or audio cut (`POST /v1/apply-edl`).\n   * The EDL is validated at ingress — an unresolvable source or a picture-less\n   * segment on a video edit throws a typed `NodaroError` (400, `code:\n   * \"invalid_edl\"`) before any credits are reserved.\n   */\n  applyEdl(input: ApplyEdlInput): Promise<EditJobResult> {\n    return this.client.request(\"POST\", \"/v1/apply-edl\", {\n      body: {\n        edl: input.edl,\n        ...(input.sources !== undefined ? { sources: input.sources } : {}),\n        ...(input.transcript !== undefined ? { transcript: input.transcript } : {}),\n        ...(input.output !== undefined ? { output: input.output } : {}),\n        ...(input.quality !== undefined ? { quality: input.quality } : {}),\n        ...(input.crossfadeMs !== undefined ? { crossfadeMs: input.crossfadeMs } : {}),\n        ...(input.clipKey !== undefined ? { clipKey: input.clipKey } : {}),\n        ...(input.planBasis !== undefined ? { planBasis: input.planBasis } : {}),\n        ...(input.workflowId !== undefined ? { workflowId: input.workflowId } : {}),\n      },\n    })\n  }\n\n  /**\n   * Tighten Episode (`POST /v1/tighten-episode`): tighten a podcast recording\n   * in one call — transcribe, cut the silences and filler, render, with\n   * optional captions, music and framing. Answers the run's job to poll; its\n   * `output_data` holds the episode. The run is priced as its steps at their own\n   * rates plus the listed per-run fee. Quote it first with\n   * {@link estimateTightenEpisode}.\n   */\n  tightenEpisode(input: TightenEpisodeInput, options?: UseCaseRequestOptions): Promise<TightenEpisodeJobResult> {\n    return withUseCaseBody(() => tightenBody(input), (body) => this.client.request(\"POST\", \"/v1/tighten-episode\", { body, ...idempotencyHeaders(options) }))\n  }\n\n  /**\n   * What a Tighten Episode run is estimated at (`POST /v1/tighten-episode/estimate`):\n   * its steps at their own rates plus its per-run fee. Nothing is created or\n   * charged. The estimate leans high: the render is priced at the recording's\n   * full length, while the charge follows the minutes actually rendered.\n   */\n  estimateTightenEpisode(input: TightenEpisodeInput): Promise<{ data: TightenEpisodeEstimate }> {\n    return withUseCaseBody(() => tightenBody(input), (body) => this.client.request(\"POST\", \"/v1/tighten-episode/estimate\", { body }))\n  }\n\n  /**\n   * Chapters (`POST /v1/episode-chapters`): transcribe a recording and list its\n   * chapters in one call. Answers the run's job to poll; the finished job's\n   * `output_data.text` is the list as show notes (one `0:00 Title` line per\n   * chapter; once a chapter starts at 1:00:00 or later, every line is\n   * `H:MM:SS`), `output_data.json` the list itself (`{ startMs, title }[]`, the\n   * same rows; the first starts at 0). A run that finds no chapters fails,\n   * and its fee is refunded. Priced as its steps at their own rates plus the\n   * listed per-run fee; quote it first with {@link estimateEpisodeChapters}.\n   */\n  episodeChapters(input: EpisodeChaptersInput, options?: UseCaseRequestOptions): Promise<UseCaseJobResult> {\n    return withUseCaseBody(() => chaptersBody(input), (body) => this.client.request(\"POST\", \"/v1/episode-chapters\", { body, ...idempotencyHeaders(options) }))\n  }\n\n  /**\n   * What a Chapters run is estimated at (`POST /v1/episode-chapters/estimate`):\n   * its steps at their own rates plus its per-run fee. Nothing is created or\n   * charged. A recording whose length cannot be read is estimated at the\n   * 180-minute ceiling.\n   */\n  estimateEpisodeChapters(input: EpisodeChaptersInput): Promise<{ data: UseCaseEstimate }> {\n    return withUseCaseBody(() => chaptersBody(input), (body) => this.client.request(\"POST\", \"/v1/episode-chapters/estimate\", { body }))\n  }\n\n  /**\n   * Trailer (`POST /v1/episode-trailer`): cut a 20–40 s trailer of a recording\n   * and deliver it in each chosen format (padded, never cropped), optionally\n   * after an intro card, in one call. The finished job's `output_data.formats`\n   * is `{ format, url }[]` in format order, the first also `output_data.videoUrl`;\n   * a format that failed is named in `output_data.failedFormats` (the run keeps\n   * the others). With `reviewBeforeRender` the run stops at a preview\n   * (`videoUrl`, no formats yet). Priced as its steps at their own rates plus\n   * the listed per-run fee; quote it first with {@link estimateEpisodeTrailer}.\n   */\n  episodeTrailer(input: EpisodeTrailerInput, options?: UseCaseRequestOptions): Promise<UseCaseJobResult> {\n    return withUseCaseBody(() => trailerBody(input), (body) => this.client.request(\"POST\", \"/v1/episode-trailer\", { body, ...idempotencyHeaders(options) }))\n  }\n\n  /**\n   * What a Trailer run is estimated at (`POST /v1/episode-trailer/estimate`):\n   * its steps at their own rates plus its per-run fee. Nothing is created or\n   * charged. The trailer is quoted at 40 seconds, the longest trailer the\n   * plan cuts; a Render final is quoted on the trailer the run cut (with the\n   * review's edits), plus the intro card.\n   */\n  estimateEpisodeTrailer(input: EpisodeTrailerInput): Promise<{ data: UseCaseEstimate }> {\n    return withUseCaseBody(() => trailerBody(input), (body) => this.client.request(\"POST\", \"/v1/episode-trailer/estimate\", { body }))\n  }\n\n  /**\n   * Clip Pack (`POST /v1/clip-pack`): cut a recording into a pack of short\n   * clips in one call — the plan finds the best moments (`count`, default 8,\n   * of about `targetDurationSec`, default 60), each is rendered (framed 9:16\n   * with the speakers stacked by default; `framing: null` keeps the\n   * recording's shape) and captioned. An audio recording makes audio clips.\n   * The finished job's `output_data.clips` is `{ url, title?, hook?, clipKey,\n   * thumbnailUrl?, captionsFailed? }[]` in plan order, the first also\n   * `output_data.videoUrl` (`audioUrl` for audio clips). Every clip is tried:\n   * one that cannot be rendered is skipped, not charged and counted on\n   * `failedClips` (the pack keeps the others and its fee); a clip whose\n   * captions failed comes uncaptioned (`captionsFailed`, counted on\n   * `failedCaptions`). When no clip renders the run fails and its fee is\n   * refunded. With `reviewBeforeRender` the run stops at previews; Render\n   * final ({@link continueUseCase}) renders only the clips the edit keeps.\n   * Priced as its steps at their own rates plus the listed per-run fee;\n   * quote it first with {@link estimateClipPack}.\n   */\n  clipPack(input: ClipPackInput, options?: UseCaseRequestOptions): Promise<UseCaseJobResult> {\n    return withUseCaseBody(() => clipPackBody(input), (body) => this.client.request(\"POST\", \"/v1/clip-pack\", { body, ...idempotencyHeaders(options) }))\n  }\n\n  /**\n   * What a Clip Pack run is estimated at (`POST /v1/clip-pack/estimate`): its\n   * steps at their own rates plus its per-run fee. Nothing is created or\n   * charged. Each clip is quoted at twice the target length (the plan may cut\n   * a clip longer than asked); the charge follows each clip's real length.\n   */\n  estimateClipPack(input: ClipPackInput): Promise<{ data: UseCaseEstimate }> {\n    return withUseCaseBody(() => clipPackBody(input), (body) => this.client.request(\"POST\", \"/v1/clip-pack/estimate\", { body }))\n  }\n\n  /**\n   * Speaker Layout (`POST /v1/speaker-layout`): frame a whole recording by\n   * speaker in one call — the same length, nothing cut. One recording: each\n   * speaker framed in turn; several recordings of one conversation: lined up,\n   * each speaker shown on their own camera. The finished job's\n   * `output_data.videoUrl` is the framed video, `output_data.json` the edit\n   * Speaker View drew. With `reviewBeforeRender` the run stops at a preview;\n   * {@link continueUseCase} (`mode: \"render-final\"`, no `editedEdl`) renders\n   * it at full quality. Priced as its steps at their own rates plus the listed\n   * per-run fee; quote it first with {@link estimateSpeakerLayout}.\n   */\n  speakerLayout(input: SpeakerLayoutInput, options?: UseCaseRequestOptions): Promise<UseCaseJobResult> {\n    return withUseCaseBody(() => speakerLayoutBody(input), (body) => this.client.request(\"POST\", \"/v1/speaker-layout\", { body, ...idempotencyHeaders(options) }))\n  }\n\n  /**\n   * What a Speaker Layout run is estimated at (`POST /v1/speaker-layout/estimate`):\n   * its steps at their own rates plus its per-run fee. Nothing is created or\n   * charged. A recording whose length cannot be read is estimated at the\n   * 180-minute ceiling.\n   */\n  estimateSpeakerLayout(input: SpeakerLayoutInput): Promise<{ data: UseCaseEstimate }> {\n    return withUseCaseBody(() => speakerLayoutBody(input), (body) => this.client.request(\"POST\", \"/v1/speaker-layout/estimate\", { body }))\n  }\n\n  /**\n   * Continue a use-case run as a new job (`POST /v1/<type>/continue`, the\n   * run's own type: `input.nodeType`, else the type the job records, read with\n   * `GET /v1/jobs/:id`; when that read cannot tell, this rejects with a\n   * `NodaroError` coded `use_case_type_unknown` — pass `nodeType` then):\n   * `\"from-failed\"` keeps the steps that finished and runs the rest (the fee\n   * is held again; the failed run's was refunded);\n   * `\"render-final\"` renders the full-quality result after a review-on preview,\n   * with the preview's settings and no fee. A refusal that names another job\n   * (`already_running`, `continuation_superseded`,\n   * `render_final_already_rendered`) throws a `ContinuationRefusedError`\n   * carrying that `jobId`.\n   */\n  async continueUseCase(input: UseCaseContinueInput, options?: UseCaseRequestOptions): Promise<UseCaseJobResult> {\n    if (input.nodeType !== undefined && !isUseCaseNodeType(input.nodeType)) {\n      throw new NodaroError(\n        `continueUseCase: nodeType \"${String(input.nodeType)}\" is not a use-case node type (${USE_CASE_NODE_TYPES.join(\", \")})`,\n        \"invalid_node_type\",\n        400,\n      )\n    }\n    const type = input.nodeType ?? (await this.runTypeOf(input.jobId))\n    return this.client.request(\"POST\", continuePathOf(type), {\n      body: { jobId: input.jobId, mode: input.mode, ...(input.editedEdl !== undefined ? { editedEdl: input.editedEdl } : {}) },\n      ...idempotencyHeaders(options),\n    })\n  }\n\n  /**\n   * The use-case type a run records (`input_data.type`, else its `job_type`).\n   * When the key lacks the `jobs:read` scope (403 naming that scope) or the job\n   * names no use-case type, the type cannot be read: this rejects with a\n   * `NodaroError` (`use_case_type_unknown`, 400) asking for `nodeType`, and\n   * nothing is posted (decided 2026-10-18: no route is guessed for the run).\n   * Any other failure of the read, any other 403 included, is thrown as is.\n   */\n  private async runTypeOf(jobId: string): Promise<UseCaseNodeType> {\n    const unknown = () =>\n      new NodaroError(\"continueUseCase: the run's node type cannot be read — pass nodeType\", \"use_case_type_unknown\", 400)\n    let row: { job_type?: unknown; input_data?: unknown } | undefined\n    try {\n      row = (await this.client.request<{ data?: { job_type?: unknown; input_data?: unknown } }>(\"GET\", `/v1/jobs/${encodeURIComponent(jobId)}`)).data\n    } catch (err) {\n      if (err instanceof ForbiddenError && err.missingScope === \"jobs:read\") throw unknown()\n      throw err\n    }\n    const input = row?.input_data\n    const recorded = input && typeof input === \"object\" && !Array.isArray(input) ? (input as { type?: unknown }).type : undefined\n    const type = typeof recorded === \"string\" && recorded.length > 0 ? recorded : row?.job_type\n    if (!isUseCaseNodeType(type)) throw unknown()\n    return type\n  }\n\n  /**\n   * Plan a transcript-driven cut (`POST /v1/edit-plan`). Reads a timed\n   * transcript (plus optional silence ranges) and the media sources, and plans\n   * the edit. The finished job's `output_data` holds the plan: an `Edl`\n   * (`\"tighten\"` or `\"trailer\"`), an {@link EdlClipSet} (`\"clips\"`), or a\n   * {@link ChapterSet} (`\"chapters\"`) — normalize it with {@link unwrapEditPlanOutput}.\n   *\n   * On a self-hosted install the request relays to nodaro.ai and needs the\n   * install connected (a 503 `code: \"nodaro_connection_required\"` otherwise);\n   * on nodaro.ai it runs directly.\n   */\n  editPlan(input: EditPlanInput): Promise<EditJobResult> {\n    // The same pre-dispatch check the canvas and MCP run (B4): the server never\n    // sees `offsets` — they are written onto the sources here.\n    const planned = resolveEditPlanSources(input.sources, {\n      offsets: input.offsets,\n      transcriptSourceId: input.transcriptSourceId,\n    })\n    if (!planned.ok) {\n      const message = planned.issues.map((issue) => describeAudioSyncOffsetIssue(issue)).join(\"; \")\n      return Promise.reject(new NodaroError(`editPlan: ${message}`, \"edit_plan_sources\", 400))\n    }\n    const transcript = planned.transcriptSourceId\n      ? { ...input.transcript, sourceId: planned.transcriptSourceId }\n      : input.transcript\n    return this.client.request(\"POST\", \"/v1/edit-plan\", {\n      body: {\n        mode: input.mode,\n        planTier: input.planTier,\n        transcript,\n        sources: planned.sources,\n        ...(input.silence !== undefined ? { silence: input.silence } : {}),\n        ...(input.instructions !== undefined ? { instructions: input.instructions } : {}),\n        ...(input.styleGuide !== undefined ? { styleGuide: input.styleGuide } : {}),\n        ...(input.count !== undefined ? { count: input.count } : {}),\n        ...(input.targetDurationSec !== undefined ? { targetDurationSec: input.targetDurationSec } : {}),\n        ...(input.targetAspect !== undefined ? { targetAspect: input.targetAspect } : {}),\n        ...(input.platform !== undefined ? { platform: input.platform } : {}),\n        ...(input.workflowId !== undefined ? { workflowId: input.workflowId } : {}),\n      },\n    })\n  }\n\n  /**\n   * Camera Switch (podcast B5): choose which camera shows each cut of `edl`\n   * by who is speaking — the sound never changes. Cloud edition; a flat\n   * price. The finished job's `output_data.json` is the switched EDL (feed it\n   * to {@link applyEdl}) and `output_data.transcript` the transcript with\n   * `speakerNames` applied. A transcript with no speaker labels rejects with\n   * a {@link NodaroError} (`code: \"no_speakers\"`) before any request or charge.\n   */\n  cameraSwitch(input: CameraSwitchInput): Promise<EditJobResult> {\n    if (transcriptSpeakerLabels(input.transcript).length === 0) {\n      return Promise.reject(new NodaroError(\n        \"cameraSwitch: the transcript has no speaker labels — transcribe with speaker detection on\",\n        \"no_speakers\",\n        422,\n      ))\n    }\n    const result = input.speakerMapResult\n    if (result !== undefined && !speakerMapResultOf(result)) return Promise.reject(new NodaroError(\"cameraSwitch: speakerMapResult is not a Speaker Map result — pass that job's output_data.json\", \"not_a_speaker_map\", 400))\n    const speakerMap = result !== undefined ? cameraSwitchSpeakerMap({ speakerMap: input.speakerMap }, input.edl, input.transcript, { speakerMap: result }) : input.speakerMap\n    return this.client.request(\"POST\", \"/v1/camera-switch\", {\n      body: {\n        edl: input.edl,\n        transcript: input.transcript,\n        ...(speakerMap !== undefined ? { speakerMap } : {}),\n        ...(input.speakerNames !== undefined ? { speakerNames: input.speakerNames } : {}),\n        ...(input.minShotMs !== undefined ? { minShotMs: input.minShotMs } : {}),\n        ...(input.leadMs !== undefined ? { leadMs: input.leadMs } : {}),\n        ...(input.maxShotMs !== undefined ? { maxShotMs: input.maxShotMs } : {}),\n        ...(input.wideEvery !== undefined ? { wideEvery: input.wideEvery } : {}),\n        ...(input.layoutHints !== undefined ? { layoutHints: input.layoutHints } : {}),\n        ...(input.workflowId !== undefined ? { workflowId: input.workflowId } : {}),\n      },\n    })\n  }\n\n  /**\n   * Remap a transcript through an EDL — a PURE client-side transform (NO\n   * request). Returns a new transcript whose word (and segment) timings are on\n   * the EDL's rendered output clock, dropping words that fall in cut regions and\n   * clipping straddlers. Runs `@nodaro/shared`'s canonical\n   * `remapTranscriptThroughEdl`, the same remap `applyEdl` performs server-side.\n   */\n  remapTranscript(edl: Edl, transcript: Transcript): Transcript {\n    return remapTranscriptThroughEdl(edl, transcript)\n  }\n}\n"]}

package/dist/{chunk-3QBH2VE2.cjs → chunk-A7QSOD2S.cjs}

@@ -28,6 +28,18 @@ var JobsResource = class {
       query: { ...rest, status: listParam(status), type: listParam(type) }
     });
   }
+  /**
+   * Record an image edited in the browser as a job (`POST /v1/jobs/from-upload`):
+   * a completed, private, free `image-edit` job whose `output_data.imageUrl` is
+   * the upload, linked to its source in `input_data` (`sourceJobId` /
+   * `sourceAssetId`, `sourceImageUrl`). It then lists, rates, favorites and
+   * files into a session like any image job. One upload is one job: the same
+   * `assetId` again returns the same job. OAuth apps need the `assets:write`
+   * scope. A deployment's job policy can refuse the image ({@link JobBlockedError}).
+   */
+  fromUpload(params) {
+    return this.client.request("POST", "/v1/jobs/from-upload", { body: params });
+  }
   /**
    * Rate one of your jobs `"good"` or `"bad"`, or clear the rating with
    * `null` (`PUT /v1/jobs/:id/rating`). Only the job's owner rates it — anyone
@@ -53,7 +65,12 @@ var JobsResource = class {
   }
   /**
    * Cancel a job. Server route is `POST /v1/jobs/:jobId/cancel`.
-   * Refunds any reserved credit holds.
+   * Refunds any reserved credit holds. A running LLM job priced per model
+   * (metered) whose call has already started answers
+   * `{ success: true, cancelled: 0, inFlight: true }`: it finishes and is
+   * charged only what it used. A job stopped before its call starts is
+   * refunded, except for what an earlier attempt of the same job already used
+   * (a retry after a billed attempt): that is charged.
    */
   cancel(id) {
     return this.client.request(
@@ -76,5 +93,5 @@ var JobsResource = class {
 };
 
 exports.JobsResource = JobsResource;
-//# sourceMappingURL=chunk-3QBH2VE2.cjs.map
-//# sourceMappingURL=chunk-3QBH2VE2.cjs.map
+//# sourceMappingURL=chunk-A7QSOD2S.cjs.map
+//# sourceMappingURL=chunk-A7QSOD2S.cjs.map

package/dist/chunk-A7QSOD2S.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/resources/jobs.ts"],"names":[],"mappings":";;;AA0PA,SAAS,UAAU,KAAA,EAAmE;AACpF,EAAA,IAAI,KAAA,KAAU,QAAW,OAAO,MAAA;AAChC,EAAA,OAAO,OAAO,KAAA,KAAU,QAAA,GAAW,KAAA,GAAQ,KAAA,CAAM,KAAK,GAAG,CAAA;AAC3D;AAgCO,IAAM,eAAN,MAAmB;AAAA,EACxB,YAAoB,MAAA,EAA0B;AAA1B,IAAA,IAAA,CAAA,MAAA,GAAA,MAAA;AAAA,EAA2B;AAAA,EAA3B,MAAA;AAAA;AAAA,EAGpB,IAAI,EAAA,EAAoC;AACtC,IAAA,OAAO,IAAA,CAAK,OAAO,OAAA,CAAQ,KAAA,EAAO,YAAY,kBAAA,CAAmB,EAAE,CAAC,CAAA,CAAE,CAAA;AAAA,EACxE;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAUA,IAAA,CAAK,MAAA,GAAyB,EAAC,EAA0B;AACvD,IAAA,MAAM,EAAE,MAAA,EAAQ,IAAA,EAAM,GAAG,MAAK,GAAI,MAAA;AAClC,IAAA,OAAO,IAAA,CAAK,MAAA,CAAO,OAAA,CAAsB,KAAA,EAAO,UAAA,EAAY;AAAA,MAC1D,KAAA,EAAO,EAAE,GAAG,IAAA,EAAM,MAAA,EAAQ,SAAA,CAAU,MAAM,CAAA,EAAG,IAAA,EAAM,SAAA,CAAU,IAAI,CAAA;AAAE,KACpE,CAAA;AAAA,EACH;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAWA,WAAW,MAAA,EAAqD;AAC9D,IAAA,OAAO,IAAA,CAAK,OAAO,OAAA,CAAuB,MAAA,EAAQ,wBAAwB,EAAE,IAAA,EAAM,QAAQ,CAAA;AAAA,EAC5F;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAQA,IAAA,CAAK,IAAY,MAAA,EAAkD;AACjE,IAAA,OAAO,IAAA,CAAK,OAAO,OAAA,CAAuB,KAAA,EAAO,YAAY,kBAAA,CAAmB,EAAE,CAAC,CAAA,OAAA,CAAA,EAAW;AAAA,MAC5F,IAAA,EAAM,EAAE,MAAA;AAAO,KAChB,CAAA;AAAA,EACH;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAQA,UAAU,EAAA,EAAgD;AACxD,IAAA,OAAO,KAAK,MAAA,CAAO,OAAA;AAAA,MACjB,KAAA;AAAA,MACA,CAAA,SAAA,EAAY,kBAAA,CAAmB,EAAE,CAAC,CAAA,OAAA;AAAA,KACpC;AAAA,EACF;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAWA,OAAO,EAAA,EAAsC;AAC3C,IAAA,OAAO,KAAK,MAAA,CAAO,OAAA;AAAA,MACjB,MAAA;AAAA,MACA,CAAA,SAAA,EAAY,kBAAA,CAAmB,EAAE,CAAC,CAAA,OAAA;AAAA,KACpC;AAAA,EACF;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAQA,OAAO,EAAA,EAAsC;AAC3C,IAAA,OAAO,KAAK,MAAA,CAAO,OAAA;AAAA,MACjB,QAAA;AAAA,MACA,CAAA,SAAA,EAAY,kBAAA,CAAmB,EAAE,CAAC,CAAA;AAAA,KACpC;AAAA,EACF;AACF","file":"chunk-A7QSOD2S.cjs","sourcesContent":["import type { NodaroClientCore } from \"../core.js\"\n\n/**\n * A job's lifecycle status. Hand-copied mirror of `JOB_STATUSES` in the\n * platform's `backend/src/lib/job-status.ts` — nothing links the two at build\n * time, so a new member has to be added here in the same change.\n *\n * `pending_review` is IN-FLIGHT, NOT TERMINAL: a job policy registered by the\n * deployment held the output for a human reviewer. Treat it like `processing`\n * in a `switch` — keep waiting, do not re-run — and it resolves to `completed`\n * (approved), `failed` (rejected, carrying an `error_hint` with\n * `kind: \"policy-block\"`) or `cancelled` (a held job is cancellable like any\n * in-flight job). `credit_status` reads `\"reserved\"` for the whole hold. Only\n * appears on deployments that register a job policy; `runAndWait` throws\n * {@link JobHeldError} on the first held tick rather than waiting it out.\n */\nexport type JobStatus =\n  | \"pending\"\n  | \"queued\"\n  | \"processing\"\n  | \"pending_review\"\n  | \"completed\"\n  | \"failed\"\n  | \"cancelled\"\n\n/**\n * A PROVIDER's verdict: the model's own safety filter refused the output.\n * `class` distinguishes a deterministic block (copyright/likeness — retrying\n * the same request never helps) from `safety`, whose filter is known to be\n * non-deterministic for some models: `retried` says whether the worker\n * already spent its one extra attempt, and `suggestedProvider` — present\n * only when the catalog declares a fallback for the model that failed — is a\n * real model id the SAME prompt/references can be retried on.\n */\nexport type SafetyBlockHint = {\n  kind: \"safety-block\"\n  class: \"copyright\" | \"likeness\" | \"safety\"\n  retried: boolean\n  suggestedProvider?: string\n  /**\n   * Present when the provider refused the INPUT VIDEO itself — not the prompt,\n   * a reference image or the output. Sending a different clip is the fix.\n   */\n  subject?: \"input_video\"\n}\n\n/**\n * A NODARO-side verdict, not a provider's: a job policy registered by the\n * deployment rejected the request (`hookPoint: \"request\"` — nothing ran, and\n * the call itself failed with {@link JobBlockedError}) or the finished output\n * (`hookPoint: \"result\"` — the result was blocked and never published).\n *\n * `reason` is USER-SAFE BY CONTRACT — the platform guarantees the policy's\n * machine text (scores, labels) never reaches it — so show it to the person\n * who made the request as-is. `policyId` identifies the deployment's policy,\n * not a Nodaro product feature. Only occurs on deployments that register a\n * job policy.\n */\nexport type PolicyBlockHint = {\n  kind: \"policy-block\"\n  policyId: string\n  reason: string\n  hookPoint: \"request\" | \"result\"\n}\n\n/**\n * The job ran out of credits partway: a step that reserves its own credits\n * (for example, the video a Cast Swap or trend run dispatches) was refused —\n * the balance could not cover it, or a plan or workspace cap was reached. The\n * job failed and its credits were refunded; ask the person to top up (or raise\n * the cap), then run it again.\n *\n * `code` is the refusal's own code, a lowercase snake_case token — for\n * example `insufficient_credits`, `free_video_limit`, `instance_cap_reached`,\n * `budget_exceeded`, `member_cap_exceeded` or `user_allowance_exceeded`. Treat\n * an unknown code like `insufficient_credits`.\n */\nexport type CreditsHint = {\n  kind: \"credits\"\n  code: string\n}\n\n/**\n * The provider refused the job's input video without naming a content-policy\n * class (its message is about the file, not a policy). Treat it like any\n * other failure — no fallback model is offered — except that the input to\n * change is known: send a different clip.\n */\nexport type InputRefusedHint = {\n  kind: \"input-refused\"\n  subject: \"input_video\"\n}\n\n/**\n * A job's `jobs.error_hint` (migration 376) — a user-safe, machine-readable\n * failure verdict, so a caller can act on it without parsing `error_message`\n * prose. One column, several verdict sources; `kind` is the discriminant.\n *\n * HAND-COPIED MIRROR of `ErrorHint` in the platform's\n * `backend/src/lib/safety-block.ts` (which names this file in its own\n * comment). Nothing links the two at build time: a new arm there has to be\n * pasted here verbatim in the same change, with a changeset.\n * `packages/client/dist/index.d.ts` is REBUILT, never hand-edited.\n */\nexport type JobErrorHint = SafetyBlockHint | PolicyBlockHint | CreditsHint | InputRefusedHint\n\n/**\n * The billing lifecycle of a job's credit reservation — `usage_logs.status`\n * for the job's `usage_log_id`. `null` when the job has no usage log (e.g. a\n * free run) or hasn't reserved credits yet.\n */\nexport type CreditStatus = \"reserved\" | \"committed\" | \"refunded\"\n\n/** A job owner's rating of their job — set with {@link JobsResource.rate}. */\nexport type JobRating = \"good\" | \"bad\"\n\n/**\n * The `rating` filter of {@link JobsResource.list}: one rating, any rating\n * (`\"rated\"`) or none (`\"unrated\"`).\n */\nexport type JobRatingFilter = JobRating | \"rated\" | \"unrated\"\n\n/**\n * Job record returned to non-admin SDK consumers. Field names are snake_case\n * to match the wire format (per the OpenAPI fix in Phase 1).\n *\n * Sensitive fields stripped server-side for non-admin callers:\n * `provider`, `provider_cost`, `display_cost`, `credits_actual`. USD\n * pricing is admin-only across api/sdk/mcp — non-admin consumers see\n * only the `credits` abstraction. Server-only nested job data (including\n * Recast's private remux base) is stripped for every caller, including admins.\n */\nexport interface Job {\n  id: string\n  status: JobStatus\n  progress: number\n  user_id: string\n  input_data: unknown\n  output_data: unknown\n  error_message: string | null\n  /** Present on a failed job the worker classified as a provider\n   *  content-policy block (`kind: \"safety-block\"`) or that a deployment's job\n   *  policy rejected (`kind: \"policy-block\"`); absent/null otherwise.\n   *  User-safe by construction — narrow on `kind` before reading the rest. */\n  error_hint?: JobErrorHint | null\n  /** PR9: the job's credit reservation lifecycle, derived server-side from\n   *  `usage_logs.status`. `null` when there is no usage log to report. Never\n   *  changes the meaning of `credits` (the reserved amount) below. */\n  credit_status?: CreditStatus | null\n  /** The credits HELD when the job was accepted. Never changes — a job can\n   *  settle below it; read {@link Job.credits_charged} for what it cost. */\n  credits: number | null\n  /**\n   * What the job actually cost once its hold settled. Can be lower than\n   * `credits` (the unused part goes back to the balance), `0` when the hold was\n   * refunded, `null` while the job is still running or when it reserved\n   * nothing of its own. Sum this — not `credits` — to total spend. Returned by\n   * `get()` and `list()`.\n   */\n  credits_charged?: number | null\n  job_type: string | null\n  created_at: string\n  started_at: string | null\n  completed_at: string | null\n  /**\n   * Provenance: which kind of caller created the job — one of\n   * `\"internal\" | \"mcp\" | \"app\" | \"cli\" | \"sdk\" | \"extension\" | \"web\" | \"api\"`.\n   * `source_detail` narrows it (origin host, `extension/<name>` label,\n   * `sdk/<version>`, MCP client name, developer-app id). Descriptive only;\n   * lets a library view label or filter media by origin.\n   */\n  source?: string | null\n  source_detail?: string | null\n  /** The generation session this job was born in (the `sessionId` sent with\n   *  the generation request), or null. See `client.sessions`. */\n  session_id?: string | null\n  /**\n   * Whether the job's owner favorited it (`client.gallery.toggleFavorite`).\n   * Returned by `get()` and `list()`. Absent from an older server, and when\n   * the server could not read it for a moment — treat absent as unknown,\n   * never as `false`.\n   */\n  favorited?: boolean\n  /**\n   * The owner's rating of the job ({@link JobsResource.rate}), or `null` when\n   * unrated. Returned by `get()` and `list()`; absent like `favorited`.\n   */\n  rating?: JobRating | null\n}\n\nexport interface CancelJobResult {\n  success: true\n  cancelled: number\n  /**\n   * `true` when the job could not be stopped because its provider call is\n   * already running — a metered LLM job's call, an external provider task. It\n   * finishes and is charged only what it used.\n   */\n  inFlight?: boolean\n}\n\nexport interface DeleteJobResult {\n  success: true\n}\n\nexport interface ListJobsParams {\n  /** One status or several (a job matching any of them). An unknown status is a 400. */\n  status?: JobStatus | readonly JobStatus[]\n  /** Exact match on `input_data.type` — the route that created the job\n   *  (`\"llm-structured\"`, `\"video-analysis\"`, …). One value or several (up to 20). */\n  type?: string | readonly string[]\n  /** Exact match on `input_data.origin` — the client app that sent it. */\n  origin?: string\n  /** `true`: only jobs you favorited; `false`: only jobs you did not. */\n  favorited?: boolean\n  /** Your rating: `\"good\"`, `\"bad\"`, any (`\"rated\"`) or none (`\"unrated\"`). */\n  rating?: JobRatingFilter\n  /** The jobs of one generate-image batch (`count` / `models`) — its `batchId`. */\n  batchId?: string\n  /** Page size, 1–100 (server default 50). */\n  limit?: number\n  /** The previous page's `next`. */\n  cursor?: string\n}\n\n/** What {@link JobsResource.rate} answers: the job's rating now. */\nexport interface RateJobResult {\n  data: { jobId: string; rating: JobRating | null }\n}\n\n/**\n * {@link JobsResource.fromUpload}'s body: an image edited in the browser,\n * already stored with `client.uploads.upload`, and what it was made from.\n */\nexport interface JobFromUploadParams {\n  /** The edited image's `assetId`, as `client.uploads.upload` returned it. */\n  assetId: string\n  /** The job whose image was edited. */\n  sourceJobId?: string\n  /** Which of `sourceJobId`'s images was edited, when it made several. Default: its `imageUrl`. */\n  sourceImageUrl?: string\n  /** The upload that was edited, when the source is not a job. Not with `sourceJobId`. */\n  sourceAssetId?: string\n  /** The editor's design state, stored with `client.uploads.uploadJson`, so the edit can be reopened. */\n  editStateUrl?: string\n  /** The generation session to file the job in. */\n  sessionId?: string\n}\n\n/** A list filter value as the query string carries it: several are comma-separated. */\nfunction listParam(value: string | readonly string[] | undefined): string | undefined {\n  if (value === undefined) return undefined\n  return typeof value === \"string\" ? value : value.join(\",\")\n}\n\nexport interface ListJobsPage {\n  /**\n   * A page may hold fewer than `limit` rows — even none — and still carry a\n   * `next`. Page on `next`, never on `data.length`.\n   */\n  data: Job[]\n  /** Pass back as `cursor` for the next page; `null` on the last one. */\n  next: string | null\n}\n\n/**\n * Lean job status returned by `GET /v1/jobs/:id/status`. Skips the\n * `input_data` JSONB and cost columns. Its `output_data` still goes\n * through the server-only nested-field redaction. Intended for poll loops that\n * only need progress/output/error, and when the job finished.\n */\nexport interface JobStatusResult {\n  id: string\n  status: JobStatus\n  progress?: number\n  output_data?: unknown\n  error_message?: string | null\n  /** PR9: see {@link Job.error_hint}. */\n  error_hint?: JobErrorHint | null\n  /** PR9: see {@link Job.credit_status}. */\n  credit_status?: CreditStatus | null\n  /** When the job finished, on the server's clock; null until it has. */\n  completed_at?: string | null\n}\n\nexport class JobsResource {\n  constructor(private client: NodaroClientCore) {}\n\n  /** Get a single job by ID. */\n  get(id: string): Promise<{ data: Job }> {\n    return this.client.request(\"GET\", `/v1/jobs/${encodeURIComponent(id)}`)\n  }\n\n  /**\n   * Your jobs, newest first (`GET /v1/jobs`), cursor-paginated. `type` and\n   * `origin` filter on the job's own `input_data`, which every job carries —\n   * a client app lists its runs with `{ type: \"llm-structured\", origin: \"studio\" }`.\n   * `status` and `type` take one value or a list; `favorited` and `rating`\n   * filter on your own marks. Every filter combines with AND, and each job\n   * carries `favorited` and `rating`.\n   */\n  list(params: ListJobsParams = {}): Promise<ListJobsPage> {\n    const { status, type, ...rest } = params\n    return this.client.request<ListJobsPage>(\"GET\", \"/v1/jobs\", {\n      query: { ...rest, status: listParam(status), type: listParam(type) },\n    })\n  }\n\n  /**\n   * Record an image edited in the browser as a job (`POST /v1/jobs/from-upload`):\n   * a completed, private, free `image-edit` job whose `output_data.imageUrl` is\n   * the upload, linked to its source in `input_data` (`sourceJobId` /\n   * `sourceAssetId`, `sourceImageUrl`). It then lists, rates, favorites and\n   * files into a session like any image job. One upload is one job: the same\n   * `assetId` again returns the same job. OAuth apps need the `assets:write`\n   * scope. A deployment's job policy can refuse the image ({@link JobBlockedError}).\n   */\n  fromUpload(params: JobFromUploadParams): Promise<{ data: Job }> {\n    return this.client.request<{ data: Job }>(\"POST\", \"/v1/jobs/from-upload\", { body: params })\n  }\n\n  /**\n   * Rate one of your jobs `\"good\"` or `\"bad\"`, or clear the rating with\n   * `null` (`PUT /v1/jobs/:id/rating`). Only the job's owner rates it — anyone\n   * else's job is a `NotFoundError`. The rating reads back as `Job.rating`\n   * and filters {@link list}. OAuth apps need the `assets:write` scope.\n   */\n  rate(id: string, rating: JobRating | null): Promise<RateJobResult> {\n    return this.client.request<RateJobResult>(\"PUT\", `/v1/jobs/${encodeURIComponent(id)}/rating`, {\n      body: { rating },\n    })\n  }\n\n  /**\n   * Get the lean status of a single job (poll-loop friendly).\n   * Hits `GET /v1/jobs/:id/status` — returns only id/status/progress/\n   * output_data/error_message, with far less wire/CPU cost than `get()`.\n   * Same auth + ownership semantics as {@link get}.\n   */\n  getStatus(id: string): Promise<{ data: JobStatusResult }> {\n    return this.client.request(\n      \"GET\",\n      `/v1/jobs/${encodeURIComponent(id)}/status`,\n    )\n  }\n\n  /**\n   * Cancel a job. Server route is `POST /v1/jobs/:jobId/cancel`.\n   * Refunds any reserved credit holds. A running LLM job priced per model\n   * (metered) whose call has already started answers\n   * `{ success: true, cancelled: 0, inFlight: true }`: it finishes and is\n   * charged only what it used. A job stopped before its call starts is\n   * refunded, except for what an earlier attempt of the same job already used\n   * (a retry after a billed attempt): that is charged.\n   */\n  cancel(id: string): Promise<CancelJobResult> {\n    return this.client.request(\n      \"POST\",\n      `/v1/jobs/${encodeURIComponent(id)}/cancel`,\n    )\n  }\n\n  /**\n   * Delete a job and the private media it produced. Server route is\n   * `DELETE /v1/jobs/:jobId`. Only the job's owner (or an admin) may delete it;\n   * a job that is still running is deleted as-is — cancel it first when its\n   * worker should stop ({@link cancel}).\n   */\n  delete(id: string): Promise<DeleteJobResult> {\n    return this.client.request(\n      \"DELETE\",\n      `/v1/jobs/${encodeURIComponent(id)}`,\n    )\n  }\n}\n"]}

package/dist/{chunk-VV4TZG5S.js → chunk-AUKHMT53.js}

@@ -1,4 +1,4 @@
-import { StudioPreviewUnavailable, StudioPreviewAppliedError } from './chunk-JGS6YBDW.js';
+import { StudioPreviewUnavailable, StudioPreviewAppliedError } from './chunk-L6T44A3G.js';
 
 // src/resources/studio-productions.ts
 function isStudioGenerateEstimate(result) {
@@ -317,5 +317,5 @@ var StudioResource = class {
 };
 
 export { StudioProductionsResource, StudioResource, isStudioGenerateEstimate };
-//# sourceMappingURL=chunk-VV4TZG5S.js.map
-//# sourceMappingURL=chunk-VV4TZG5S.js.map
+//# sourceMappingURL=chunk-AUKHMT53.js.map
+//# sourceMappingURL=chunk-AUKHMT53.js.map

package/dist/chunk-AUKHMT53.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/resources/studio-productions.ts","../src/resources/studio.ts"],"names":["res"],"mappings":"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","file":"chunk-AUKHMT53.js","sourcesContent":["import type { NodaroClientCore } from \"../core.js\"\nimport { StudioPreviewAppliedError, StudioPreviewUnavailable } from \"../errors.js\"\n\n/**\n * Studio productions — `/v1/studio/productions`.\n *\n * A production is a Nodaro workflow whose `settings.studio` holds the shots:\n * each shot a framed still, an optional animated clip, and the plan, looks,\n * cast bindings and voice that made them. These routes are the platform's own\n * reader and writer of that document, so an agent, a script and the studio app\n * are looking at ONE production rather than three opinions about one row.\n *\n * Two rules run through the whole surface:\n *\n * - **Every change is an OPERATION** ({@link StudioProductionsResource.ops}),\n *   addressed by stable key — a shot id, a role slug, a result's job id or url\n *   — and never by position. That is what lets two writers hold the same\n *   production open: a batch composed against a slightly older version still\n *   applies correctly to the newest one, and the response says whether it was\n *   rebased.\n * - **Generation is run-then-poll.** A still or clip run returns job ids and\n *   records a marker on the production; the results land when anyone — your\n *   poll, the app, a later {@link StudioProductionsResource.reconcile} —\n *   reports the finished job. Nothing waits minutes inside a request.\n *\n * Reads are `detail: \"summary\"` by default (counts and the active urls);\n * `detail: \"full\"` adds every result with the context that regenerates it.\n *\n * **The ENVELOPES are typed here; the production DOCUMENT is not.** A view, a\n * summary, a shot and an operation are open JSON on this surface\n * ({@link StudioProduction}, `ops: unknown[]`) — their field-level types ship\n * with the studio app, which is the one consumer that narrows them, and a\n * second spelling of that vocabulary in the SDK would drift from it the first\n * time either grew. Everything a caller branches on — `version`, `rebased`,\n * `receipts`, `warnings`, a quote's `credits`, a run's `jobIds` — is typed.\n *\n * Cloud edition only: these routes 404 on deployments that do not serve them.\n * Feature-detect once with `list()` — a deployment without them 404s that too,\n * where a deployment with them answers an empty page.\n */\n\n/**\n * A production, a summary, a shot, a receipt's target: open JSON.\n *\n * Deliberately not narrowed here — see the note at the top of this module.\n */\nexport type StudioProduction = Record<string, unknown>\n\n/** How much of a production a read returns. */\nexport type StudioProductionDetail = \"summary\" | \"full\"\n\n/** One thing wrong with a plan, addressed at the field that is wrong. */\nexport interface StudioPlanIssue {\n  path: string\n  message: string\n  hint?: string\n}\n\n/** `GET …/skill` — the authoring skill, rendered at request time from what is live. */\nexport interface StudioSkillResponse {\n  /** The authoring guide. */\n  skill: string\n  /** Every picker, model and enum, in full. */\n  catalog: string\n  /** The strict JSON Schema a plan is validated against. */\n  schema: Record<string, unknown>\n  /** The operating guide: the tool map, the loops, the rules. */\n  operating: string\n  /** The versions the three were rendered from — bare semver, no package names. */\n  generatedFrom: { prompts: string; shared: string; codec: string }\n}\n\nexport interface StudioValidatePlanResponse {\n  valid: boolean\n  errors: StudioPlanIssue[]\n  warnings: StudioPlanIssue[]\n  summary?: {\n    name?: string\n    scenes: number\n    shots: number\n    cast: number\n    /** Cast entries that matched a row in the caller's library. */\n    bound: number\n  }\n}\n\nexport interface StudioListProductionsResponse {\n  data: StudioProduction[]\n  nextCursor?: string\n}\n\n/** What a create or an import did, in the words a receipt would use. */\nexport interface StudioImportSummary {\n  shotsAdded: number\n  castEnrolled: number\n  /** Cast entries that resolved to a row in the caller's library. */\n  castBound: number\n}\n\nexport interface StudioProductionResponse {\n  production: StudioProduction\n  warnings?: StudioPlanIssue[]\n  summary?: StudioImportSummary\n}\n\nexport interface StudioCreateProductionRequest {\n  name?: string\n  plan?: Record<string, unknown>\n}\n\n/** The caller's own retry token — 8–128 chars of `A-Za-z0-9_.:-`, never derived. */\nexport type StudioClientRequestId = string\n\n/**\n * A batch of operations, applied atomically.\n *\n * `ops` is `unknown[]`: the operation union is the studio app's vocabulary and\n * the route validates it, refusing the whole batch with the offending index.\n * The served operating guide is the runtime reference for what an operation\n * looks like.\n */\nexport interface StudioOpsRequest {\n  /** Applied in order. At most 100 per request. */\n  ops: unknown[]\n  /**\n   * The version the batch was composed against. INFORMATIONAL by default: the\n   * operations address by stable KEY, so a batch built on a slightly older\n   * document still applies exactly to the newest one, and the response says\n   * `rebased: true`. Omitting it means \"apply to whatever is there\".\n   */\n  baseVersion?: number\n  /**\n   * Refuse to rebase. With `strict: true` a `baseVersion` older than the stored\n   * one is a 409 `workflow_conflict` carrying the current production, instead\n   * of a rebased apply — for the rare \"replace exactly what I read\" intent.\n   */\n  strict?: boolean\n  /** Your own token for this batch, so a transport retry is not applied twice. */\n  clientRequestId?: StudioClientRequestId\n}\n\n/**\n * What else an operation touched — the work that now has to follow it.\n *\n * Reported by the operations whose effect reaches past the thing they name: a\n * frame review re-opens every frame derived from it and every shot bound to\n * those, a sequence fork mints a whole parallel set. Both lists are always\n * present and either may be empty; ids, never counts, because the caller's job\n * is to go and refresh THOSE.\n */\nexport interface StudioOpsImpact {\n  /** Planned frames the operation reaches, the named one first. */\n  keyframeIds: string[]\n  /** Shots bound to any of those frames. */\n  shotIds: string[]\n}\n\n/**\n * A sentence as data: the id of the template a client words it from, and the\n * values that fill the template's slots.\n *\n * It travels beside the English wording, never instead of it. A client that\n * words the sentence in the person's language builds it from `template` and\n * `vars`, and shows the English wording whenever it has no wording for\n * `template` or `vars` does not fill it — so a template id it has never heard of\n * costs nothing. A template id is permanent: a change to its slots or its\n * meaning ships as a new id.\n */\nexport interface StudioOpsText {\n  /** The template's id. */\n  template: string\n  /** What fills the template's slots, by slot name. */\n  vars: Record<string, string | number>\n}\n\n/**\n * One line of what an operation did, in the words a change log would use.\n *\n * Past tense, the target named the way the user sees it, the side effect in a\n * trailing parenthetical: `Deleted take 2 of Shot 1 (in the bin).`\n */\nexport interface StudioOpsReceipt {\n  /** The operation this line reports, by name. */\n  op: string\n  /** Past tense, naming the target the way a person would. */\n  summary: string\n  /**\n   * `summary` as data, for a client that words receipts in the person's\n   * language. `summary` is always present and always English; read `detail`\n   * only when you have wording for its template, and show `summary` when you do\n   * not. Absent when the studio service that answered predates it.\n   */\n  detail?: StudioOpsText\n  /** Ids the operation MINTED — never ids the caller supplied. */\n  ids?: string[]\n  /**\n   * The dependency scope, where the operation reports one — absent for the\n   * many that touch only what they name. The route projects a receipt ONCE for\n   * both answers, so this reads the same on an apply and on a preview.\n   */\n  impact?: StudioOpsImpact\n}\n\n/** What a batch produced. Adopt `production` whole; do not merge into it. */\nexport interface StudioOpsResponse {\n  /** The canonical production AFTER the batch. */\n  production: StudioProduction\n  /** The version the batch produced. Carry it as the next `baseVersion`. */\n  version: number\n  /** True when the batch was applied to a newer document than it named. */\n  rebased: boolean\n  /** One per operation, in order. */\n  receipts: StudioOpsReceipt[]\n  /**\n   * Things worth saying that are not failures — an operation that changed\n   * nothing, a rename that rewrote four prompts. A warning never rejects a\n   * batch; a refusal does.\n   */\n  warnings: string[]\n  /**\n   * `warnings` as data, by position: entry `i` words `warnings[i]`, and `null`\n   * means that warning has no wording but the English one. The service sends it\n   * only when it is exactly as long as `warnings`, so treat a list of any other\n   * length as absent. Absent too when the studio service that answered predates\n   * it.\n   */\n  warningDetails?: Array<StudioOpsText | null>\n}\n\n/**\n * An operation's confirmation class — the vocabulary's own four letters.\n *\n * `S` safe · `D` delete · `P` changes who can reach the work · `$` spends\n * credits. The table that assigns them ships with the production codec and is\n * pinned complete over the operation union there; this is the wire's spelling\n * of its values, not a second table.\n */\nexport type StudioOpClass = \"S\" | \"D\" | \"P\" | \"$\"\n\n/**\n * One line of what an operation WOULD do, for a person deciding whether to let\n * it. Everything {@link StudioOpsReceipt} says — the same summary, the same ids\n * and the same {@link StudioOpsImpact}, read in the conditional — plus the two\n * things the decision turns on and only a preview needs: which kind of change\n * it is, and whether it can be taken back.\n */\nexport interface StudioOpsDryRunReceipt extends StudioOpsReceipt {\n  /**\n   * The confirmation class, read out of the operation vocabulary's own table:\n   * `S` safe, `D` deletes, `P` changes who can reach the work, `$` spends\n   * credits. Narrow rather than open, because it is what a caller branches on\n   * — a rule like \"never a `D` without asking\" is only writable if the\n   * compiler knows the letters.\n   */\n  class: StudioOpClass\n  /**\n   * Present, and always `true`, when this operation put something in the bin\n   * that can be brought back. ABSENT is the honest answer for everything else,\n   * including a delete that destroys: there is no entry to name, so there is no\n   * promise to make. Read it as `restorable ?? false`, never as `!restorable`\n   * meaning \"kept\".\n   */\n  restorable?: true\n}\n\n/**\n * What a batch WOULD do. Nothing was written: there is no production here and\n * no new version, because none was produced.\n */\nexport interface StudioOpsDryRunResponse {\n  /** Always present, and the marker the two-request protocol reads. */\n  dryRun: true\n  /** The version the preview was computed against. */\n  version: number\n  /** One per operation, in order. */\n  receipts: StudioOpsDryRunReceipt[]\n  /** The same things an apply would have said. */\n  warnings: string[]\n  /** The same data behind them an apply would have sent: see {@link StudioOpsResponse.warningDetails}. */\n  warningDetails?: Array<StudioOpsText | null>\n}\n\n/** What landing the finished jobs did. */\nexport interface StudioReconcileResponse {\n  /** Job ids whose media is now on the production. */\n  landed: string[]\n  /** Job ids still running — their markers stay; call again later. */\n  pending: string[]\n  /** Job ids that failed or were cancelled; their markers are cleared. */\n  failed: string[]\n  /** One line per landing that had something to say. */\n  warnings: string[]\n  /** The production after the landings. */\n  production: StudioProduction\n  /** Its version — unchanged when nothing landed. */\n  version: number\n}\n\n/** `POST …/:id/describe` — a Director run that will land as scenes. */\nexport interface StudioDescribeRequest {\n  brief: string\n  llmModel: string\n  /** `\"append\"` adds the drafted scenes; `\"replace\"` rewrites the film. */\n  mode?: \"append\" | \"replace\"\n  label?: string\n  clientRequestId?: StudioClientRequestId\n}\n\n/**\n * `POST …/:id/generate` — one framing or directing run for one shot.\n *\n * `overrides` is what the CALL owns over what the shot's plan says: the model,\n * the prose, the aspect, the direction ids. Open JSON, because the request\n * builders' own option types are the contract and they ship with the studio.\n */\nexport interface StudioGenerateRequest {\n  kind: \"still\" | \"clip\"\n  shotId: string\n  /** Candidates to fan out (stills); the builder clamps it to the catalog's range. */\n  count?: number\n  /**\n   * The directing input mode for a clip; absent ⇒ derived from the scene's saved\n   * inputs (a pinned end frame included). `start` sends ONLY the start frame;\n   * `start-end` sends the start and the end frame.\n   */\n  mode?: \"start\" | \"start-end\" | \"references\"\n  /** Price the run and return; nothing is submitted and nothing is written. */\n  dryRun?: boolean\n  clientRequestId?: StudioClientRequestId\n  overrides?: Record<string, unknown>\n}\n\n/** Which video route a directing run went to — chosen from the inputs, never asked for. */\nexport type StudioVideoLane = \"generate-video\" | \"text-to-video\"\n\n/** `dryRun: true` — what this run would cost, and nothing else. */\nexport interface StudioGenerateEstimate {\n  dryRun: true\n  provider: string\n  count: number\n  /** `null` when the model is unpriced or the instance runs without credits. */\n  credits: number | null\n  lane?: StudioVideoLane\n}\n\n/**\n * A started (or already-started) run.\n *\n * `deduped` means the same `clientRequestId` came back and the job ids were\n * answered from the production's own markers — nothing was submitted and\n * nothing was charged, so `production` is absent.\n */\nexport interface StudioGenerateResponse {\n  jobIds: string[]\n  lane?: StudioVideoLane\n  deduped?: true\n  production?: StudioProduction\n  receipts?: StudioOpsReceipt[]\n  warnings?: string[]\n}\n\n/** `POST …/:id/frame` — a still pulled out of the shot's clip. */\nexport interface StudioFrameRequest {\n  shotId: string\n  mode?: \"first\" | \"last\" | \"timestamp\"\n  /** Seconds, when `mode` is `\"timestamp\"`. */\n  timestamp?: number\n  /** Where the grabbed image lands. `\"new-shot\"` inserts a shot after this one. */\n  target?: \"new-shot\" | \"start-frame\" | \"end-frame\" | \"still\"\n  clientRequestId?: StudioClientRequestId\n}\n\n/** `POST …/:id/voice` — synthesize a shot's spoken line and record it. */\nexport interface StudioVoiceRequest {\n  shotId: string\n  text: string\n  voiceId?: string\n  voiceType?: \"premade\" | \"custom\" | \"library\"\n  ttsProvider?: string\n  /** The delivery levers; the text-to-speech route owns their bounds. */\n  delivery?: Record<string, number>\n  clientRequestId?: StudioClientRequestId\n}\n\n/** `POST …/:id/revoice` — recast the voices of the shot's active clip. */\nexport interface StudioRevoiceRequest {\n  shotId: string\n  /** The speaker-ordered recast plan, forwarded to the voice route verbatim. */\n  plan: Record<string, unknown>\n  clientRequestId?: StudioClientRequestId\n}\n\n/** `POST …/:id/music` — the film's soundtrack. */\nexport interface StudioMusicRequest {\n  prompt: string\n  duration?: number\n  instrumental?: boolean\n  vocalGender?: string\n  model?: string\n  clientRequestId?: StudioClientRequestId\n}\n\n/**\n * What a route that finished its work answers with: the production as it now\n * stands, plus whatever that route produced.\n *\n * `jobId` is present on the routes that only STARTED something (a revoice, a\n * soundtrack, a draft) — the result lands through its marker.\n */\nexport interface StudioMediaResponse {\n  production: StudioProduction\n  /** The grabbed frame's url, on the frame route. */\n  url?: string\n  jobId?: string\n  receipts?: StudioOpsReceipt[]\n  warnings?: string[]\n}\n\n/**\n * `GET …/:id/export-plan` — the ordered steps an export would run.\n *\n * The caller runs them with the verbs that already exist; a route that chained\n * three minutes-long jobs is the long-lived request every client times out on.\n */\nexport interface StudioExportPlanResponse {\n  /** False when the production has fewer than two clips — nothing to stitch. */\n  canExport: boolean\n  steps: StudioExportStep[]\n  /** The step whose output IS the film, or `null` when nothing can run. */\n  resultStepId: string | null\n  /** Total credits, or `null` when ANY step is unpriced (a partial sum understates). */\n  estimate: number | null\n  /** The credit models with no price, each named once, in step order. */\n  unpriced: string[]\n}\n\nexport interface StudioExportStep {\n  /** Stable within one plan and derived from the production, never minted. */\n  id: string\n  label: string\n  /** The node this step runs — `merge-video-audio`, `combine-videos`, `video-upscale`. */\n  node: string\n  creditModel: string\n  credits: number | null\n  params: Record<string, unknown>\n}\n\n/** `POST …/:id/clone` — a copy, which always starts private and visible. */\nexport interface StudioCloneRequest {\n  name?: string\n}\n\n/** Either arm of a generation reply: the quote, or the run that started. */\nexport type StudioGenerateResult = StudioGenerateEstimate | StudioGenerateResponse\n\n/** True when a generation reply is the `dryRun` QUOTE rather than a started run. */\nexport function isStudioGenerateEstimate(\n  result: StudioGenerateResult,\n): result is StudioGenerateEstimate {\n  return (result as StudioGenerateEstimate).dryRun === true\n}\n\n/** What a `generateStill` / `generateClip` call decides, beyond `kind` and the shot. */\nexport type StudioGenerateOptions = Omit<StudioGenerateRequest, \"kind\" | \"shotId\">\n\n/**\n * A route that only STARTED something — a draft, a revoice, a soundtrack. Its\n * `jobId` is always there, which is what makes `const { jobId } = await …` and\n * a poll the honest next line.\n *\n * `StudioMediaResponse` leaves `jobId` optional because the routes that FINISH\n * their work (a frame, a voiceover) share the shape and have no job to name.\n */\nexport type StudioJobStartedResponse = StudioMediaResponse & { jobId: string }\n\nexport interface ListStudioProductionsOptions {\n  limit?: number\n  /** From a previous page's `nextCursor`. */\n  cursor?: string\n  /** Include the rows the dashboard hides. Off by default. */\n  includeArchived?: boolean\n}\n\nexport interface GetProductionOptions {\n  detail?: StudioProductionDetail\n  /** Read ONE shot — the cheap way to re-read after a generation. */\n  shotId?: string\n}\n\nexport interface StudioExportPlanOptions {\n  /** Plan the 4K finish too. Expensive, so it is always explicit. */\n  upscale?: boolean\n}\n\n/** `client.studio.productions` — see the note at the top of this module. */\nexport class StudioProductionsResource {\n  constructor(private client: NodaroClientCore) {}\n\n  private path(productionId: string, suffix = \"\"): string {\n    return `/v1/studio/productions/${encodeURIComponent(productionId)}${suffix}`\n  }\n\n  // ── reads ────────────────────────────────────────────────────────────────\n\n  /**\n   * The authoring guide, the full catalog, the plan's JSON Schema and the\n   * operating guide — rendered server-side from the version that is live, so\n   * they describe the platform you are actually talking to. Free.\n   */\n  async skill(): Promise<StudioSkillResponse> {\n    const res = await this.client.request<{ data: StudioSkillResponse }>(\n      \"GET\",\n      \"/v1/studio/productions/skill\",\n    )\n    return res.data\n  }\n\n  /**\n   * Check a plan before it becomes anything. Free, persists nothing, and\n   * resolves cast names against YOUR library — loop on `errors` until\n   * `valid: true`, then `create({ plan })`.\n   */\n  async validatePlan(plan: Record<string, unknown>): Promise<StudioValidatePlanResponse> {\n    const res = await this.client.request<{ data: StudioValidatePlanResponse }>(\n      \"POST\",\n      \"/v1/studio/productions/validate\",\n      { body: { plan } },\n    )\n    return res.data\n  }\n\n  /** Your productions, newest first. Archived rows are hidden unless asked for. */\n  async list(opts: ListStudioProductionsOptions = {}): Promise<StudioListProductionsResponse> {\n    const res = await this.client.request<{ data: StudioListProductionsResponse }>(\n      \"GET\",\n      \"/v1/studio/productions\",\n      {\n        query: {\n          limit: opts.limit,\n          cursor: opts.cursor,\n          includeArchived: opts.includeArchived,\n        },\n      },\n    )\n    return res.data\n  }\n\n  /**\n   * One production. A pure read — it never lands a finished job, so call\n   * {@link reconcile} first if you are waiting on one.\n   */\n  async get(\n    productionId: string,\n    opts: GetProductionOptions = {},\n  ): Promise<StudioProduction> {\n    const res = await this.client.request<{ data: { production: StudioProduction } }>(\n      \"GET\",\n      this.path(productionId),\n      { query: { detail: opts.detail, shot_id: opts.shotId } },\n    )\n    return res.data.production\n  }\n\n  /**\n   * The ordered steps that assemble the film, with what they will cost. Run\n   * them yourself with the ordinary verbs — nothing here blocks for minutes,\n   * and nothing here spends.\n   */\n  async exportPlan(\n    productionId: string,\n    opts: StudioExportPlanOptions = {},\n  ): Promise<StudioExportPlanResponse> {\n    const res = await this.client.request<{ data: StudioExportPlanResponse }>(\n      \"GET\",\n      this.path(productionId, \"/export-plan\"),\n      { query: { upscale: opts.upscale } },\n    )\n    return res.data\n  }\n\n  // ── writes ───────────────────────────────────────────────────────────────\n\n  /** A new production, optionally landed from a plan in the same call. */\n  async create(input: StudioCreateProductionRequest = {}): Promise<StudioProductionResponse> {\n    const res = await this.client.request<{ data: StudioProductionResponse }>(\n      \"POST\",\n      \"/v1/studio/productions\",\n      { body: input },\n    )\n    return res.data\n  }\n\n  /**\n   * Apply a batch of operations. Atomic: one bad operation refuses the whole\n   * batch with a `StudioOpError` naming its index, and nothing is written. On\n   * success adopt `production` wholesale and carry `version` forward as the\n   * next `baseVersion`.\n   *\n   * `dryRun: true` — the LITERAL, which is what selects the preview reply —\n   * asks what the batch would do, so a person can approve an assistant's edits\n   * before they land. Spell it in THIS call's own object literal: a flag passed\n   * through a variable widens `true` to `boolean`, which selects the apply\n   * overload while the runtime still takes the preview path.\n   *\n   * A preview is TWO requests, deliberately. The route's body is parsed in\n   * strip mode, so a deployment that predates the preview drops the flag and\n   * APPLIES the batch: a caller that sent its batch and read the answer\n   * afterwards would already have written it. So the flag is proved on an EMPTY\n   * batch first and the real batch goes only when that answer carries the\n   * marker. An older deployment either answers the apply shape — this throws\n   * `StudioPreviewUnavailable`, and the batch never leaves — or refuses the\n   * empty batch with its own error, which is passed through as it stands.\n   *\n   * The ping proves the deployment that answered IT, and a fleet mid-rollout\n   * can serve the second request from another one. So the second answer is\n   * checked too: when the batch came back APPLIED, this throws\n   * `StudioPreviewAppliedError`, which carries that write. The SDK cannot\n   * un-send a request; what it can do is refuse to call the result a preview.\n   *\n   * An apply stays exactly one request.\n   */\n  ops(\n    productionId: string,\n    input: StudioOpsRequest & { dryRun: true },\n  ): Promise<StudioOpsDryRunResponse>\n  ops(productionId: string, input: StudioOpsRequest): Promise<StudioOpsResponse>\n  async ops(\n    productionId: string,\n    input: StudioOpsRequest & { dryRun?: true },\n  ): Promise<StudioOpsResponse | StudioOpsDryRunResponse> {\n    if (input.dryRun !== true) {\n      const res = await this.client.request<{ data: StudioOpsResponse }>(\n        \"POST\",\n        this.path(productionId, \"/ops\"),\n        { body: input },\n      )\n      return res.data\n    }\n\n    // The ping carries nothing of the caller's batch, because an old deployment\n    // takes whatever it is sent at face value; an empty batch with no\n    // `clientRequestId` spends neither the caller's operations nor the retry\n    // token that would make a real batch unrepeatable.\n    const ping = await this.client.request<{ data?: { dryRun?: unknown } } | undefined>(\n      \"POST\",\n      this.path(productionId, \"/ops\"),\n      { body: { ops: [], dryRun: true } },\n    )\n    // Read through: an older deployment can answer no envelope at all, or a 204\n    // that `request` reads as `undefined`. Absent is a \"no\" like any other, and\n    // the caller who catches `NodaroError` should not get a `TypeError`.\n    if (ping?.data?.dryRun !== true) throw new StudioPreviewUnavailable()\n\n    const res = await this.client.request<\n      { data?: StudioOpsDryRunResponse | StudioOpsResponse } | undefined\n    >(\"POST\", this.path(productionId, \"/ops\"), { body: input })\n    // The answer that matters most: this request may have landed on a different\n    // deployment from the ping, and an applied batch is not a preview.\n    const data = res?.data\n    if ((data as { dryRun?: unknown } | undefined)?.dryRun !== true) {\n      throw new StudioPreviewAppliedError(data as StudioOpsResponse)\n    }\n    return data as StudioOpsDryRunResponse\n  }\n\n  /**\n   * Land every generation that has finished since you last looked, and report\n   * what is still running. The one call that turns finished jobs into results\n   * without a browser open. It writes only when something actually landed.\n   */\n  async reconcile(productionId: string): Promise<StudioReconcileResponse> {\n    const res = await this.client.request<{ data: StudioReconcileResponse }>(\n      \"POST\",\n      this.path(productionId, \"/reconcile\"),\n    )\n    return res.data\n  }\n\n  /** Add a plan's scenes to a production that already exists. */\n  async importPlan(\n    productionId: string,\n    plan: Record<string, unknown>,\n    opts: { mode?: \"append\" } = {},\n  ): Promise<StudioProductionResponse> {\n    const res = await this.client.request<{ data: StudioProductionResponse }>(\n      \"POST\",\n      this.path(productionId, \"/import\"),\n      { body: { plan, mode: opts.mode ?? \"append\" } },\n    )\n    return res.data\n  }\n\n  /**\n   * Turn a brief into scenes. The run is a platform job: poll it, and its\n   * scenes land through {@link reconcile}. The production comes back with the\n   * run recorded on it as a pending draft.\n   */\n  async describe(\n    productionId: string,\n    input: StudioDescribeRequest,\n  ): Promise<StudioJobStartedResponse> {\n    const res = await this.client.request<{ data: StudioJobStartedResponse }>(\n      \"POST\",\n      this.path(productionId, \"/describe\"),\n      { body: input },\n    )\n    return res.data\n  }\n\n  // ── generation ───────────────────────────────────────────────────────────\n\n  /**\n   * Frame or animate one shot.\n   *\n   * The request is assembled server-side from the shot's own plan, looks and\n   * bound references, so a scripted run and a press of the button in the app\n   * produce the same media; `overrides` changes THIS run without changing the\n   * shot. Prefer {@link generateStill} / {@link generateClip}, which say which\n   * kind they mean.\n   *\n   * `dryRun: true` returns the quote and writes nothing — narrow the reply with\n   * {@link isStudioGenerateEstimate}.\n   */\n  generate(\n    productionId: string,\n    input: StudioGenerateRequest & { dryRun: true },\n  ): Promise<StudioGenerateEstimate>\n  generate(\n    productionId: string,\n    input: StudioGenerateRequest,\n  ): Promise<StudioGenerateResult>\n  async generate(\n    productionId: string,\n    input: StudioGenerateRequest,\n  ): Promise<StudioGenerateResult> {\n    const res = await this.client.request<{ data: StudioGenerateResult }>(\n      \"POST\",\n      this.path(productionId, \"/generate\"),\n      { body: input },\n    )\n    return res.data\n  }\n\n  /**\n   * Frame a shot: submit `count` candidates and record a pending marker for\n   * each. Results ACCUMULATE — a generate never replaces what is there.\n   *\n   * `clientRequestId` makes a retry safe: the same token answers with the jobs\n   * the first call started (`deduped: true`) and submits nothing. Never retry a\n   * spend without it.\n   */\n  generateStill(\n    productionId: string,\n    shotId: string,\n    opts: StudioGenerateOptions & { dryRun: true },\n  ): Promise<StudioGenerateEstimate>\n  generateStill(\n    productionId: string,\n    shotId: string,\n    opts?: StudioGenerateOptions,\n  ): Promise<StudioGenerateResult>\n  generateStill(\n    productionId: string,\n    shotId: string,\n    opts: StudioGenerateOptions = {},\n  ): Promise<StudioGenerateResult> {\n    return this.generate(productionId, { ...opts, kind: \"still\", shotId })\n  }\n\n  /**\n   * Animate a shot. The LANE is chosen from the shot's inputs (a start frame,\n   * references, a prompt) — never passed in — and reported back as `lane`.\n   */\n  generateClip(\n    productionId: string,\n    shotId: string,\n    opts: StudioGenerateOptions & { dryRun: true },\n  ): Promise<StudioGenerateEstimate>\n  generateClip(\n    productionId: string,\n    shotId: string,\n    opts?: StudioGenerateOptions,\n  ): Promise<StudioGenerateResult>\n  generateClip(\n    productionId: string,\n    shotId: string,\n    opts: StudioGenerateOptions = {},\n  ): Promise<StudioGenerateResult> {\n    return this.generate(productionId, { ...opts, kind: \"clip\", shotId })\n  }\n\n  // ── media on one shot ────────────────────────────────────────────────────\n\n  /**\n   * Extract a frame from a shot's active clip and put it where `target` says —\n   * a new shot after this one (the default), this shot's sticky start or end\n   * frame, or another still of the same shot. Seconds, not minutes: this one\n   * waits for the job and answers with the changed production.\n   */\n  async frame(\n    productionId: string,\n    input: StudioFrameRequest,\n  ): Promise<StudioMediaResponse> {\n    const res = await this.client.request<{ data: StudioMediaResponse }>(\n      \"POST\",\n      this.path(productionId, \"/frame\"),\n      { body: input },\n    )\n    return res.data\n  }\n\n  /** Synthesize a shot's spoken line and record it. Waits for the job. */\n  async voice(\n    productionId: string,\n    input: StudioVoiceRequest,\n  ): Promise<StudioMediaResponse> {\n    const res = await this.client.request<{ data: StudioMediaResponse }>(\n      \"POST\",\n      this.path(productionId, \"/voice\"),\n      { body: input },\n    )\n    return res.data\n  }\n\n  /**\n   * Recast the voices of a shot's active clip. Minutes of work, so it answers\n   * `jobId` and the new clip lands as a result through its own marker.\n   */\n  async revoice(\n    productionId: string,\n    input: StudioRevoiceRequest,\n  ): Promise<StudioJobStartedResponse> {\n    const res = await this.client.request<{ data: StudioJobStartedResponse }>(\n      \"POST\",\n      this.path(productionId, \"/revoice\"),\n      { body: input },\n    )\n    return res.data\n  }\n\n  /** Score the film. The finished track lands through its pending marker. */\n  async music(\n    productionId: string,\n    input: StudioMusicRequest,\n  ): Promise<StudioJobStartedResponse> {\n    const res = await this.client.request<{ data: StudioJobStartedResponse }>(\n      \"POST\",\n      this.path(productionId, \"/music\"),\n      { body: input },\n    )\n    return res.data\n  }\n\n  // ── audience and copies ──────────────────────────────────────────────────\n\n  /**\n   * Open the share-by-link read. Deliberately its own route rather than an\n   * operation: who may see the work is decided by the owner, never as a side\n   * effect of a batch that was editing something else.\n   */\n  async share(productionId: string): Promise<StudioProduction> {\n    const res = await this.client.request<{ data: StudioMediaResponse }>(\n      \"POST\",\n      this.path(productionId, \"/share\"),\n      { body: { shared: true } },\n    )\n    return res.data.production\n  }\n\n  /** Close it again. Sharing is opt-in AND reversible. */\n  async unshare(productionId: string): Promise<StudioProduction> {\n    const res = await this.client.request<{ data: StudioMediaResponse }>(\n      \"POST\",\n      this.path(productionId, \"/unshare\"),\n    )\n    return res.data.production\n  }\n\n  /**\n   * Copy a production you own or can see into your own Studio project. The\n   * copy starts PRIVATE and visible — sharing and archiving never travel — and\n   * it is copied through YOUR view of the source, so somebody else's bin does\n   * not come with it.\n   */\n  async clone(\n    productionId: string,\n    input: StudioCloneRequest = {},\n  ): Promise<StudioProduction> {\n    const res = await this.client.request<{ data: { production: StudioProduction } }>(\n      \"POST\",\n      this.path(productionId, \"/clone\"),\n      { body: input },\n    )\n    return res.data.production\n  }\n}\n\n","import type { NodaroClientCore } from \"../core.js\"\nimport { StudioProductionsResource } from \"./studio-productions.js\"\nexport * from \"./studio-productions.js\"\n\n/** Public response/transport contracts only; document validation and planning\n * remain in the private Studio codec on the server. */\nexport type StudioDocumentJson = Record<string, unknown>\n\nexport interface StudioProductionCapabilities {\n  planVersions: number[]\n  operations: {\n    readKeyframes: boolean\n    saveEditorState?: boolean\n    editableSharedCopies?: boolean\n    revisionedSharing?: boolean\n    cloneLinkedProductions?: boolean\n    importPlannedBundles?: boolean\n    importLinkedBundles?: boolean\n    appendPlannedBundles?: boolean\n    appendLinkedBundles?: boolean\n    editKeyframes: boolean\n    generateKeyframes: boolean\n    acceptKeyframes: boolean\n    rejectKeyframes?: boolean\n    editSequencePlans?: boolean\n    generateLinkedClips: boolean\n    retakeLinkedClips?: boolean\n    /** The host keeps a scene's empty media slots. */\n    mediaSlots?: boolean\n    /** The host keeps a clip's inputs on its clip slot. */\n    clipSlotInputs?: boolean\n  }\n  sourceFrameReferences: boolean\n  automaticAcceptance: false\n  unattendedGeneration: false\n}\n\nexport interface StudioKeyframeRecord {\n  id: string\n  label: string\n  revision: number\n  nodeId: string\n  parentKeyframeId?: string\n  previewResultKey: string | null\n  previewUrl: string | null\n  acceptedResultKey: string | null\n  acceptedUrl: string | null\n  count: number\n  pending: Array<{ jobId: string; startedAt: string }>\n  /** Owner-only working state. Recorded acceptance is not an execution grant. */\n  plan?: StudioDocumentJson\n  acceptance?: StudioDocumentJson\n  results?: StudioDocumentJson[]\n}\n\nexport interface StudioProductionRecord {\n  id: string\n  name: string\n  version: number\n  updatedAt: string\n  thumbnailUrl: string | null\n  shared: boolean\n  archived: boolean\n  requiredCapabilities?: string[]\n  keyframes?: StudioKeyframeRecord[]\n  sequences?: StudioDocumentJson[]\n  shots: StudioDocumentJson[]\n  pending: { stills: number; clips: number; keyframes?: number; music: boolean; draft: StudioDocumentJson | null }\n  [field: string]: unknown\n}\n\nexport interface StudioProductionReply {\n  production: StudioProductionRecord\n  capabilities?: StudioProductionCapabilities\n  warnings?: unknown[]\n  [field: string]: unknown\n}\n\nexport interface StudioEditInput {\n  ops: ReadonlyArray<{ op: string; [field: string]: unknown }>\n  baseVersion?: number\n  strict?: boolean\n  clientRequestId?: string\n}\n\nexport interface StudioKeyframeGenerationInput {\n  keyframeId: string\n  expectedRevision: number\n  clientRequestId?: string\n  overrides?: StudioDocumentJson\n}\n\nexport interface StudioKeyframeAcceptanceInput {\n  keyframeId: string\n  expectedRevision: number\n  resultKey: string\n  expectedAcceptedResultKey: string | null\n  requirementChecks: Array<{ requirementId: string; outcome: \"pass\" | \"waived\" }>\n  waivedReason?: string\n}\n\nexport interface StudioShotGenerationInput {\n  kind: \"still\" | \"clip\"\n  shotId: string\n  clientRequestId?: string\n  count?: number\n  mode?: \"start\" | \"start-end\" | \"references\"\n  dryRun?: boolean\n  /** Linked clips only: require the exact inputs returned by a reviewed quote. */\n  expectedInputHash?: string\n  /** Retake a native linked take using its original request and retained endpoints. */\n  retakeResultKey?: string\n  overrides?: StudioDocumentJson\n}\n\nexport type StudioGenerationReply = {\n  jobIds: string[]\n  production?: StudioProductionRecord\n  deduped?: true\n  lane?: string\n  [field: string]: unknown\n} | {\n  dryRun: true; provider: string; count: number; credits: number | null; lane?: string\n  /** Linked-clip quotes include normalized settings and accepted endpoint pins. */\n  inputHash?: string\n  endpointPins?: StudioDocumentJson\n  creditIdentifier?: string\n  duration?: number\n  resolution?: string\n  aspectRatio?: string\n  sound?: boolean\n}\n\nconst root = \"/v1/studio/productions\"\nconst path = (id: string) => `${root}/${encodeURIComponent(id)}`\n\n/** Cloud plugin routes. Check capabilities before exposing dependency controls.\n * Reads do not reconcile jobs, submit media or accept generated candidates. */\nexport class StudioResource {\n  readonly productions: StudioProductionsResource\n\n  constructor(private readonly client: NodaroClientCore) {\n    this.productions = new StudioProductionsResource(client)\n  }\n\n  capabilities(): Promise<{ data: StudioProductionCapabilities }> {\n    return this.client.request(\"GET\", `${root}/capabilities`)\n  }\n\n  skill(): Promise<{ data: StudioDocumentJson }> {\n    return this.client.request(\"GET\", `${root}/skill`)\n  }\n\n  list(options: { limit?: number; cursor?: string; includeArchived?: boolean } = {}): Promise<{ data: {\n    data: Array<{ id: string; name: string; version: number; updatedAt: string; thumbnailUrl: string | null; shared: boolean; archived: boolean; shotCount: number }>\n    nextCursor?: string\n  } }> {\n    return this.client.request(\"GET\", root, { query: options })\n  }\n\n  get(id: string, options: { detail?: \"summary\" | \"full\"; shotId?: string } = {}): Promise<{ data: StudioProductionReply }> {\n    return this.client.request(\"GET\", path(id), { query: { detail: options.detail, shot_id: options.shotId } })\n  }\n\n  validatePlan(plan: StudioDocumentJson): Promise<{ data: { valid: boolean; errors: StudioDocumentJson[]; warnings: StudioDocumentJson[]; summary?: StudioDocumentJson } }> {\n    return this.client.request(\"POST\", `${root}/validate`, { body: { plan } })\n  }\n\n  create(input: { name?: string; plan?: StudioDocumentJson }): Promise<{ data: StudioProductionReply }> {\n    return this.client.request(\"POST\", root, { body: input })\n  }\n\n  /** Import a portable document through the compatible server writer.\n   * Retained frame media requires an authorized source; acceptance never transfers. */\n  importBundle(input: { bundle: StudioDocumentJson; projectId?: string }): Promise<{ data: StudioProductionReply }> {\n    return this.client.request(\"POST\", `${root}/import-bundle`, { body: input })\n  }\n\n  /** Append a bundle's scenes and frame closure under an exact destination revision. */\n  appendBundle(id: string, input: { bundle: StudioDocumentJson; expectedVersion: number;\n    afterShotId?: string; applyFilm?: boolean }): Promise<{ data: {\n      production: StudioProductionRecord; importedShotIds: string[]; importedKeyframeIds: string[];\n    } }> {\n    return this.client.request(\"POST\", `${path(id)}/import-bundle`, { body: input })\n  }\n\n  /** Copy a saved production. Linked copies retain verified inputs, remap\n   * dependencies and require fresh frame acceptance; they start no media jobs. */\n  clone(id: string, input: { name?: string; projectId?: string; expectedVersion?: number } = {}): Promise<{ data: StudioProductionReply }> {\n    return this.client.request(\"POST\", `${path(id)}/clone`, { body: input })\n  }\n\n  edit(id: string, input: StudioEditInput): Promise<{ data: StudioProductionReply & { version: number; rebased: boolean; receipts: StudioDocumentJson[] } }> {\n    return this.client.request(\"POST\", `${path(id)}/ops`, { body: input })\n  }\n\n  /** Audience-authorized sharing; an expected revision prevents publication\n   * of concurrent edits the caller has not reviewed. */\n  setShared(id: string, input: { shared: boolean; allowEditableCopy?: boolean; expectedVersion?: number }): Promise<{ data: StudioProductionReply }> {\n    return this.client.request(\"POST\", `${path(id)}/share`, { body: input })\n  }\n\n  /** Save ordinary editor fields against the loaded revision. Protected frame\n   * and job state can only change through their dedicated semantic actions. */\n  saveEditorState(id: string, input: { expectedVersion: number; graph: object; clientRequestId?: string }) {\n    return this.edit(id, {\n      baseVersion: input.expectedVersion, strict: true,\n      ...(input.clientRequestId ? { clientRequestId: input.clientRequestId } : {}),\n      ops: [{ op: \"save_editor_state\", expectedVersion: input.expectedVersion, graph: input.graph }],\n    })\n  }\n\n  generateKeyframe(id: string, input: StudioKeyframeGenerationInput): Promise<{ data: Exclude<StudioGenerationReply, { dryRun: true }> }> {\n    return this.client.request(\"POST\", `${path(id)}/generate`, { body: { ...input, kind: \"keyframe\" } })\n  }\n\n  generateShot(id: string, input: StudioShotGenerationInput): Promise<{ data: StudioGenerationReply }> {\n    return this.client.request(\"POST\", `${path(id)}/generate`, { body: input })\n  }\n\n  /** A separate explicit review action; generation never calls this method. */\n  acceptKeyframe(id: string, input: StudioKeyframeAcceptanceInput,\n    concurrency: Pick<StudioEditInput, \"baseVersion\" | \"strict\" | \"clientRequestId\"> = {}) {\n    return this.edit(id, { ...concurrency, ops: [{ ...input, op: \"accept_keyframe_result\" }] })\n  }\n\n  reconcile(id: string): Promise<{ data: StudioProductionReply & { landed: string[]; pending: string[]; failed: string[]; version: number } }> {\n    return this.client.request(\"POST\", `${path(id)}/reconcile`, { body: {} })\n  }\n}\n"]}