tubeless 0.2.12 → 0.2.13

package/dist/core/pipeline-run-state.js.map

@@ -1 +1 @@
-{"version":3,"file":"pipeline-run-state.js","sourceRoot":"","sources":["../../src/core/pipeline-run-state.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,iBAAiB,EAAE,MAAM,mBAAmB,CAAC;AAiCtD,MAAM,UAAU,kBAAkB,CAAC,MAAgC;IACjE,OAAO,MAAM,CAAC,MAAM,GAAG,CAAC,IAAI,MAAM,CAAC,KAAK,CAAC,CAAC,EAAE,IAAI,EAAE,EAAE,EAAE,CAAC,IAAI,KAAK,cAAc,CAAC,CAAC;AAClF,CAAC;AAED,SAAS,iBAAiB,CAAC,MAAgC;IACzD,IAAI,MAAM,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,WAAW,CAAC;IAC5C,OAAO,kBAAkB,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,WAAW,CAAC,CAAC,CAAC,QAAQ,CAAC;AAC7D,CAAC;AAED,SAAS,oBAAoB,CAC3B,KAAqE;IAErE,MAAM,IAAI,GAAG;QACX,EAAE,EAAE,KAAK,CAAC,EAAE;QACZ,IAAI,EAAE,KAAK,CAAC,IAAI;QAChB,WAAW,EAAE,KAAK,CAAC,WAAW;QAC9B,YAAY,EAAE,KAAK,CAAC,YAAY;KACjC,CAAC;IACF,QAAQ,KAAK,CAAC,MAAM,EAAE,CAAC;QACrB,KAAK,WAAW;YACd,OAAO;gBACL,GAAG,IAAI;gBACP,SAAS,EAAE,KAAK,CAAC,SAAS;gBAC1B,WAAW,EAAE,KAAK,CAAC,WAAW;gBAC9B,MAAM,EAAE,WAAW;aACpB,CAAC;QACJ,KAAK,QAAQ;YACX,OAAO;gBACL,GAAG,IAAI;gBACP,SAAS,EAAE,KAAK,CAAC,SAAS;gBAC1B,KAAK,EAAE,KAAK,CAAC,KAAK;gBAClB,WAAW,EAAE,KAAK,CAAC,WAAW;gBAC9B,MAAM,EAAE,QAAQ;aACjB,CAAC;QACJ,KAAK,WAAW,EAAE,CAAC;YACjB,MAAM,MAAM,GAAgC;gBAC1C,GAAG,IAAI;gBACP,KAAK,EAAE,KAAK,CAAC,KAAK;gBAClB,MAAM,EAAE,WAAW;aACpB,CAAC;YACF,IAAI,KAAK,CAAC,SAAS;gBAAE,MAAM,CAAC,SAAS,GAAG,KAAK,CAAC,SAAS,CAAC;YACxD,IAAI,KAAK,CAAC,WAAW,KAAK,SAAS;gBAAE,MAAM,CAAC,WAAW,GAAG,KAAK,CAAC,WAAW,CAAC;YAC5E,OAAO,MAAM,CAAC;QAChB,CAAC;QACD,KAAK,SAAS,EAAE,CAAC;YACf,MAAM,MAAM,GAA8B;gBACxC,GAAG,IAAI;gBACP,MAAM,EAAE,KAAK,CAAC,MAAM;gBACpB,MAAM,EAAE,SAAS;aAClB,CAAC;YACF,IAAI,KAAK,CAAC,SAAS;gBAAE,MAAM,CAAC,SAAS,GAAG,KAAK,CAAC,SAAS,CAAC;YACxD,IAAI,KAAK,CAAC,WAAW,KAAK,SAAS;gBAAE,MAAM,CAAC,WAAW,GAAG,KAAK,CAAC,WAAW,CAAC;YAC5E,IAAI,KAAK,CAAC,YAAY;gBAAE,MAAM,CAAC,YAAY,GAAG,KAAK,CAAC,YAAY,CAAC;YACjE,IAAI,KAAK,CAAC,OAAO;gBAAE,MAAM,CAAC,OAAO,GAAG,KAAK,CAAC,OAAO,CAAC;YAClD,OAAO,MAAM,CAAC;QAChB,CAAC;IACH,CAAC;AACH,CAAC;AAED,MAAM,OAAO,gBAAgB;IAchB,UAAU;IACV,MAAM;IACN,WAAW;IACX,QAAQ;IACR,GAAG;IACH,SAAS;IAlBX,oBAAoB,GAAG,IAAI,GAAG,EAAwC,CAAC;IACvE,OAAO,GAAoB,EAAE,CAAC;IAC9B,UAAU,GAAG,IAAI,GAAG,EAAiB,CAAC;IACtC,QAAQ,GAAG,IAAI,GAAG,EAAmB,CAAC;IACtC,UAAU,GAAG,IAAI,GAAG,EAAkB,CAAC;IACvC,gBAAgB,GAAG,IAAI,GAAG,EAA8B,CAAC;IAClE,mBAAmB,CAAoC;IACvD,sBAAsB,GAAG,KAAK,CAAC;IAC/B,aAAa,GAAkC,EAAE,SAAS,EAAE,KAAK,EAAE,KAAK,EAAE,SAAS,EAAE,CAAC;IACtF,oBAAoB,GAAG,CAAC,CAAC;IACzB,MAAM,GAAa,SAAS,CAAC;IAE7B,YACW,UAAkB,EAClB,MAAe,EACf,WAAmB,EACnB,QAAyE,EACzE,GAAiB,EACjB,SAAoC;0BALpC,UAAU;sBACV,MAAM;2BACN,WAAW;wBACX,QAAQ;mBACR,GAAG;yBACH,SAAS;IACjB,CAAC;IAEJ,IAAI,MAAM;QACR,OAAO,IAAI,CAAC,OAAO,CAAC;IACtB,CAAC;IAED,IAAI,OAAO;QACT,OAAO,IAAI,CAAC,QAAQ,CAAC;IACvB,CAAC;IAED,IAAI,eAAe;QACjB,OAAO,IAAI,CAAC,gBAAgB,CAAC;IAC/B,CAAC;IAED,KAAK,CAAC,IAAkB,EAAE,SAA4B;QACpD,IAAI,CAAC,YAAY,CAAC,SAAS,CAAC,CAAC;QAC7B,IAAI,CAAC,MAAM,GAAG,SAAS,CAAC;QACxB,IAAI,CAAC,mBAAmB,GAAG,IAAI,CAAC,UAAU,EAAE,QAAQ,CAAC;QACrD,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,IAAI,EAAE,KAAK,EAAE,EAAE,CAAC,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,EAAE,KAAK,CAAC,CAAC,CAAC;QACzE,IAAI,CAAC,SAAS,CAAC,aAAa,CAAC,IAAI,EAAE,SAAS,CAAC,CAAC;IAChD,CAAC;IAED,QAAQ,CAAC,IAAsB;QAC7B,IAAI,CAAC,gBAAgB,CAAC,EAAE,UAAU,EAAE,IAAI,CAAC,UAAU,EAAE,MAAM,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IAClF,CAAC;IAED,YAAY,CAAC,IAAsB,EAAE,WAAW,GAAG,IAAI,CAAC,GAAG,EAAE;QAC3D,MAAM,OAAO,GAAG;YACd,SAAS,EAAE,GAAG,IAAI,CAAC,QAAQ,CAAC,KAAK,YAAY,CAAC,IAAI,CAAC,oBAAoB,IAAI,CAAC,CAAC,CAAC,QAAQ,CAAC,EAAE,CAAC,EAAE;YAC5F,WAAW;SACZ,CAAC;QACF,IAAI,CAAC,gBAAgB,CAAC;YACpB,SAAS,EAAE,OAAO,CAAC,SAAS;YAC5B,UAAU,EAAE,IAAI,CAAC,UAAU;YAC3B,MAAM,EAAE,SAAS;YACjB,IAAI;SACL,CAAC,CAAC;QACH,OAAO,OAAO,CAAC;IACjB,CAAC;IAED,cAAc,CACZ,IAAsB,EACtB,OAA4B,EAC5B,QAA8B;QAE9B,IAAI,CAAC,gBAAgB,CAAC;YACpB,SAAS,EAAE,OAAO,CAAC,SAAS;YAC5B,UAAU,EAAE,IAAI,CAAC,UAAU;YAC3B,QAAQ;YACR,MAAM,EAAE,SAAS;YACjB,IAAI;SACL,CAAC,CAAC;IACL,CAAC;IAED,YAAY,CAAC,IAAsB,EAAE,OAA4B,EAAE,KAAc;QAC/E,MAAM,MAAM,GAA+B;YACzC,SAAS,EAAE,OAAO,CAAC,SAAS;YAC5B,EAAE,EAAE,IAAI,CAAC,EAAE;YACX,IAAI,EAAE,IAAI,CAAC,IAAI;YACf,WAAW,EAAE,IAAI,CAAC,WAAW;YAC7B,YAAY,EAAE,IAAI,CAAC,GAAG,EAAE;YACxB,WAAW,EAAE,OAAO,CAAC,WAAW;YAChC,MAAM,EAAE,WAAW;SACpB,CAAC;QACF,IAAI,CAAC,gBAAgB,CAAC,EAAE,GAAG,MAAM,EAAE,UAAU,EAAE,IAAI,CAAC,UAAU,EAAE,IAAI,EAAE,EAAE,EAAE,MAAM,EAAE,EAAE,KAAK,EAAE,EAAE,CAAC,CAAC;IACjG,CAAC;IAED,QAAQ,CACN,IAAsB,EACtB,KAMC;QAED,MAAM,MAAM,GAA8B;YACxC,EAAE,EAAE,IAAI,CAAC,EAAE;YACX,IAAI,EAAE,IAAI,CAAC,IAAI;YACf,WAAW,EAAE,IAAI,CAAC,WAAW;YAC7B,YAAY,EAAE,IAAI,CAAC,GAAG,EAAE;YACxB,MAAM,EAAE,KAAK,CAAC,MAAM;YACpB,MAAM,EAAE,SAAS;SAClB,CAAC;QACF,IAAI,KAAK,CAAC,OAAO,EAAE,CAAC;YAClB,MAAM,CAAC,SAAS,GAAG,KAAK,CAAC,OAAO,CAAC,SAAS,CAAC;YAC3C,MAAM,CAAC,WAAW,GAAG,KAAK,CAAC,OAAO,CAAC,WAAW,CAAC;QACjD,CAAC;QACD,IAAI,KAAK,CAAC,YAAY;YAAE,MAAM,CAAC,YAAY,GAAG,KAAK,CAAC,YAAY,CAAC;QACjE,IAAI,KAAK,CAAC,OAAO;YAAE,MAAM,CAAC,OAAO,GAAG,KAAK,CAAC,OAAO,CAAC;QAClD,IAAI,CAAC,gBAAgB,CACnB,EAAE,GAAG,MAAM,EAAE,UAAU,EAAE,IAAI,CAAC,UAAU,EAAE,IAAI,EAAE,EAChD,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,KAAK,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC,SAAS,CACpD,CAAC;IACJ,CAAC;IAED,QAAQ,CAAC,IAAsB,EAAE,OAA4B,EAAE,KAAoB;QACjF,IAAI,KAAK,CAAC,IAAI,KAAK,cAAc,EAAE,CAAC;YAClC,IAAI,CAAC,UAAU,CAAC,IAAI,EAAE,KAAK,EAAE,IAAI,EAAE,OAAO,CAAC,CAAC;YAC5C,OAAO;QACT,CAAC;QACD,MAAM,MAAM,GAA6B;YACvC,SAAS,EAAE,OAAO,CAAC,SAAS;YAC5B,EAAE,EAAE,IAAI,CAAC,EAAE;YACX,IAAI,EAAE,IAAI,CAAC,IAAI;YACf,WAAW,EAAE,IAAI,CAAC,WAAW;YAC7B,KAAK;YACL,YAAY,EAAE,IAAI,CAAC,GAAG,EAAE;YACxB,WAAW,EAAE,OAAO,CAAC,WAAW;YAChC,MAAM,EAAE,QAAQ;SACjB,CAAC;QACF,IAAI,CAAC,gBAAgB,CACnB,EAAE,GAAG,MAAM,EAAE,UAAU,EAAE,IAAI,CAAC,UAAU,EAAE,IAAI,EAAE,EAChD,EAAE,KAAK,EAAE,EAAE,MAAM,EAAE,IAAI,EAAE,KAAK,EAAE,KAAK,EAAE,EAAE,CAC1C,CAAC;IACJ,CAAC;IAED,UAAU,CACR,IAAsB,EACtB,KAAoB,EACpB,WAAoB,EACpB,OAA6B;QAE7B,MAAM,MAAM,GAAgC;YAC1C,EAAE,EAAE,IAAI,CAAC,EAAE;YACX,IAAI,EAAE,IAAI,CAAC,IAAI;YACf,WAAW,EAAE,IAAI,CAAC,WAAW;YAC7B,KAAK;YACL,YAAY,EAAE,IAAI,CAAC,GAAG,EAAE;YACxB,MAAM,EAAE,WAAW;SACpB,CAAC;QACF,IAAI,OAAO,EAAE,CAAC;YACZ,MAAM,CAAC,SAAS,GAAG,OAAO,CAAC,SAAS,CAAC;YACrC,MAAM,CAAC,WAAW,GAAG,OAAO,CAAC,WAAW,CAAC;QAC3C,CAAC;QACD,IAAI,CAAC,gBAAgB,CACnB,EAAE,GAAG,MAAM,EAAE,UAAU,EAAE,IAAI,CAAC,UAAU,EAAE,IAAI,EAAE,EAChD,EAAE,KAAK,EAAE,EAAE,MAAM,EAAE,WAAW,EAAE,KAAK,EAAE,KAAK,EAAE,EAAE,CACjD,CAAC;IACJ,CAAC;IAED,eAAe,CAAC,MAAgC;QAC9C,IAAI,CAAC,YAAY,CAAC,SAAS,CAAC,CAAC;QAC7B,KAAK,MAAM,KAAK,IAAI,MAAM;YAAE,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC;QACvD,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,GAAG,MAAM,CAAC,CAAC;IAC/B,CAAC;IAED,iBAAiB;QACf,IAAI,CAAC,YAAY,CAAC,SAAS,CAAC,CAAC;QAC7B,IAAI,CAAC,uBAAuB,EAAE,CAAC;QAC/B,IAAI,IAAI,CAAC,sBAAsB;YAAE,MAAM,IAAI,KAAK,CAAC,yCAAyC,CAAC,CAAC;QAC5F,IAAI,CAAC,sBAAsB,GAAG,IAAI,CAAC;QACnC,IAAI,CAAC,MAAM,GAAG,YAAY,CAAC;QAC3B,IAAI,CAAC,SAAS,CAAC,aAAa,EAAE,CAAC;IACjC,CAAC;IAED,oBAAoB,CAAC,KAAc,EAAE,UAAkB;QACrD,IAAI,CAAC,YAAY,CAAC,YAAY,CAAC,CAAC;QAChC,IAAI,CAAC,aAAa,GAAG,EAAE,SAAS,EAAE,IAAI,EAAE,KAAK,EAAE,CAAC;QAChD,IAAI,CAAC,MAAM,GAAG,SAAS,CAAC;QACxB,IAAI,CAAC,SAAS,CAAC,gBAAgB,CAAC,UAAU,EAAE,KAAK,CAAC,CAAC;IACrD,CAAC;IAED,gBAAgB,CAAC,KAAoB,EAAE,UAAkB;QACvD,IAAI,CAAC,YAAY,CAAC,YAAY,CAAC,CAAC;QAChC,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;QACzB,IAAI,CAAC,MAAM,GAAG,SAAS,CAAC;QACxB,IAAI,CAAC,SAAS,CAAC,aAAa,CAAC,KAAK,EAAE,UAAU,CAAC,CAAC;IAClD,CAAC;IAED,KAAK,CAAC,MAAM;QACV,IAAI,CAAC,YAAY,CAAC,SAAS,CAAC,CAAC;QAC7B,IAAI,CAAC,uBAAuB,EAAE,CAAC;QAC/B,IAAI,CAAC,MAAM,GAAG,UAAU,CAAC;QACzB,MAAM,UAAU,GAAG,CAAC,KAAoB,EAAU,EAAE;YAClD,8EAA8E;YAC9E,IAAI,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,KAAK,CAAC;gBAAE,OAAO,CAAC,CAAC,CAAC;YAC1C,IAAI,KAAK,CAAC,KAAK,KAAK,cAAc;gBAAE,OAAO,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC;YAChE,OAAO,KAAK,CAAC,MAAM,KAAK,SAAS,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,KAAK,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;QACrF,CAAC,CAAC;QACF,qFAAqF;QACrF,MAAM,MAAM,GAAG,CAAC,GAAG,IAAI,CAAC,OAAO,CAAC,CAAC,IAAI,CAAC,CAAC,IAAI,EAAE,KAAK,EAAE,EAAE,CAAC,UAAU,CAAC,IAAI,CAAC,GAAG,UAAU,CAAC,KAAK,CAAC,CAAC,CAAC;QAC7F,MAAM,KAAK,GAAG,CAAC,GAAG,IAAI,CAAC,gBAAgB,CAAC,MAAM,EAAE,CAAC,CAAC,IAAI,CACpD,CAAC,IAAI,EAAE,KAAK,EAAE,EAAE,CAAC,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,CAAE,GAAG,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,KAAK,CAAC,EAAE,CAAE,CAChF,CAAC;QACF,MAAM,MAAM,GAAyB;YACnC,UAAU,EAAE,IAAI,CAAC,UAAU;YAC3B,MAAM,EAAE,IAAI,CAAC,MAAM;YACnB,MAAM;YACN,YAAY,EAAE,IAAI,CAAC,GAAG,EAAE;YACxB,KAAK,EAAE,IAAI,CAAC,QAAQ,CAAC,KAAK;YAC1B,WAAW,EAAE,IAAI,CAAC,WAAW;YAC7B,MAAM,EAAE,iBAAiB,CAAC,IAAI,CAAC,OAAO,CAAC;YACvC,KAAK;YACL,OAAO,EAAE,iBAAiB;YAC1B,GAAG,IAAI,CAAC,aAAa;SACtB,CAAC;QACF,IAAI,IAAI,CAAC,mBAAmB;YAAE,MAAM,CAAC,kBAAkB,GAAG,IAAI,CAAC,mBAAmB,CAAC;QACnF,IAAI,IAAI,CAAC,QAAQ,CAAC,aAAa,KAAK,SAAS,EAAE,CAAC;YAC9C,MAAM,CAAC,aAAa,GAAG,IAAI,CAAC,QAAQ,CAAC,aAAa,CAAC;QACrD,CAAC;QACD,IAAI,IAAI,CAAC,QAAQ,CAAC,WAAW;YAAE,MAAM,CAAC,WAAW,GAAG,IAAI,CAAC,QAAQ,CAAC,WAAW,CAAC;QAC9E,IAAI,CAAC,SAAS,CAAC,gBAAgB,CAAC,MAAM,CAAC,CAAC;QACxC,MAAM,IAAI,CAAC,SAAS,CAAC,KAAK,EAAE,CAAC;QAC7B,OAAO,MAAM,CAAC;IAChB,CAAC;IAED,gBAAgB,CAAC,KAAyB,EAAE,OAAO,GAA0B,EAAE;QAC7E,IAAI,CAAC,YAAY,CAAC,SAAS,CAAC,CAAC;QAC7B,MAAM,QAAQ,GAAG,IAAI,CAAC,oBAAoB,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;QAC9D,MAAM,KAAK,GACT,CAAC,QAAQ,KAAK,SAAS,IAAI,KAAK,CAAC,MAAM,KAAK,SAAS,CAAC;YACtD,CAAC,QAAQ,KAAK,SAAS;gBACrB,CAAC,KAAK,CAAC,MAAM,KAAK,SAAS;oBACzB,KAAK,CAAC,MAAM,KAAK,SAAS;oBAC1B,KAAK,CAAC,MAAM,KAAK,WAAW,CAAC,CAAC;YAClC,CAAC,QAAQ,KAAK,SAAS;gBACrB,CAAC,KAAK,CAAC,MAAM,KAAK,SAAS;oBACzB,KAAK,CAAC,MAAM,KAAK,WAAW;oBAC5B,KAAK,CAAC,MAAM,KAAK,SAAS;oBAC1B,KAAK,CAAC,MAAM,KAAK,WAAW;oBAC5B,KAAK,CAAC,MAAM,KAAK,QAAQ,CAAC,CAAC,CAAC;QAClC,IAAI,CAAC,KAAK,EAAE,CAAC;YACX,MAAM,IAAI,KAAK,CACb,sCAAsC,KAAK,CAAC,IAAI,CAAC,EAAE,KAAK,QAAQ,IAAI,YAAY,OAAO,KAAK,CAAC,MAAM,EAAE,CACtG,CAAC;QACJ,CAAC;QAED,IAAI,CAAC,oBAAoB,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC,EAAE,EAAE,KAAK,CAAC,MAAM,CAAC,CAAC;QAC3D,IAAI,KAAK,CAAC,MAAM,KAAK,SAAS,IAAI,KAAK,CAAC,MAAM,KAAK,SAAS,EAAE,CAAC;YAC7D,MAAM,MAAM,GAAG,oBAAoB,CAAC,KAAK,CAAC,CAAC;YAC3C,IAAI,CAAC,gBAAgB,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC,EAAE,EAAE,MAAM,CAAC,CAAC;QACnD,CAAC;QACD,IAAI,OAAO,CAAC,MAAM;YAAE,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC,EAAE,EAAE,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;QAC3E,IAAI,OAAO,CAAC,KAAK,EAAE,MAAM;YAAE,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,OAAO,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;QAClE,IAAI,CAAC,SAAS,CAAC,UAAU,CAAC,KAAK,CAAC,CAAC;IACnC,CAAC;IAED,YAAY,CAAC,QAAkB;QAC7B,IAAI,IAAI,CAAC,MAAM,KAAK,QAAQ,EAAE,CAAC;YAC7B,MAAM,IAAI,KAAK,CACb,6CAA6C,QAAQ,WAAW,IAAI,CAAC,MAAM,EAAE,CAC9E,CAAC;QACJ,CAAC;IACH,CAAC;IAED,uBAAuB;QACrB,KAAK,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,IAAI,IAAI,CAAC,oBAAoB,EAAE,CAAC;YACzD,IAAI,MAAM,KAAK,SAAS,IAAI,MAAM,KAAK,SAAS,EAAE,CAAC;gBACjD,MAAM,IAAI,KAAK,CAAC,yCAAyC,MAAM,OAAO,MAAM,EAAE,CAAC,CAAC;YAClF,CAAC;QACH,CAAC;IACH,CAAC;CACF","sourcesContent":["import type { PipelineLifecycleObserver } from \"./lifecycle.js\";\nimport { RUN_MODEL_VERSION } from \"./pipeline-ids.js\";\nimport type {\n  PipelineError,\n  PipelinePlan,\n  PipelinePlanStep,\n  PipelineRun,\n  PipelineRunStatus,\n  PipelineStepCancelledReport,\n  PipelineStepCompleteReport,\n  PipelineStepFailedReport,\n  PipelineStepProgress,\n  PipelineStepReport,\n  PipelineStepSkipReason,\n  PipelineStepSkippedReport,\n  PipelineStepStatus,\n} from \"./pipeline-types.js\";\n\nexport interface PipelineStepAttempt {\n  attemptId: string;\n  startedAtMs: number;\n}\n\ntype RunPhase = \"created\" | \"finalizing\" | \"finished\" | \"running\";\n\ntype StepTransitionEffects = {\n  error?: { record: boolean; value: PipelineError };\n  output?: { value: unknown };\n};\n\ntype PipelineFinalization<TResult> =\n  | { finalized: false; value: undefined }\n  | { finalized: true; value: TResult };\n\nexport function isCancellationOnly(errors: readonly PipelineError[]): boolean {\n  return errors.length > 0 && errors.every(({ kind }) => kind === \"cancellation\");\n}\n\nfunction terminalRunStatus(errors: readonly PipelineError[]): PipelineRunStatus {\n  if (errors.length === 0) return \"completed\";\n  return isCancellationOnly(errors) ? \"cancelled\" : \"failed\";\n}\n\nfunction stepReportFromStatus(\n  event: Exclude<PipelineStepStatus, { status: \"planned\" | \"running\" }>\n): PipelineStepReport {\n  const base = {\n    id: event.id,\n    name: event.name,\n    description: event.description,\n    finishedAtMs: event.finishedAtMs,\n  };\n  switch (event.status) {\n    case \"completed\":\n      return {\n        ...base,\n        attemptId: event.attemptId,\n        startedAtMs: event.startedAtMs,\n        status: \"completed\",\n      };\n    case \"failed\":\n      return {\n        ...base,\n        attemptId: event.attemptId,\n        error: event.error,\n        startedAtMs: event.startedAtMs,\n        status: \"failed\",\n      };\n    case \"cancelled\": {\n      const report: PipelineStepCancelledReport = {\n        ...base,\n        error: event.error,\n        status: \"cancelled\",\n      };\n      if (event.attemptId) report.attemptId = event.attemptId;\n      if (event.startedAtMs !== undefined) report.startedAtMs = event.startedAtMs;\n      return report;\n    }\n    case \"skipped\": {\n      const report: PipelineStepSkippedReport = {\n        ...base,\n        reason: event.reason,\n        status: \"skipped\",\n      };\n      if (event.attemptId) report.attemptId = event.attemptId;\n      if (event.startedAtMs !== undefined) report.startedAtMs = event.startedAtMs;\n      if (event.dependencyId) report.dependencyId = event.dependencyId;\n      if (event.message) report.message = event.message;\n      return report;\n    }\n  }\n}\n\nexport class PipelineRunState<TResult> {\n  readonly #currentStepStatuses = new Map<string, PipelineStepStatus[\"status\"]>();\n  readonly #errors: PipelineError[] = [];\n  readonly #runErrors = new Set<PipelineError>();\n  readonly #outputs = new Map<string, unknown>();\n  readonly #stepOrder = new Map<string, number>();\n  readonly #reportsByStepId = new Map<string, PipelineStepReport>();\n  #definitionIdentity: PipelineRun[\"definitionIdentity\"];\n  #finalizationAttempted = false;\n  #finalization: PipelineFinalization<TResult> = { finalized: false, value: undefined };\n  #nextAttemptSequence = 0;\n  #phase: RunPhase = \"created\";\n\n  constructor(\n    readonly pipelineId: string,\n    readonly dryRun: boolean,\n    readonly startedAtMs: number,\n    readonly identity: { correlationId?: string; parentRunId?: string; runId: string },\n    readonly now: () => number,\n    readonly lifecycle: PipelineLifecycleObserver\n  ) {}\n\n  get errors(): readonly PipelineError[] {\n    return this.#errors;\n  }\n\n  get outputs(): ReadonlyMap<string, unknown> {\n    return this.#outputs;\n  }\n\n  get reportsByStepId(): ReadonlyMap<string, PipelineStepReport> {\n    return this.#reportsByStepId;\n  }\n\n  start(plan: PipelinePlan, targetIds: readonly string[]): void {\n    this.#expectPhase(\"created\");\n    this.#phase = \"running\";\n    this.#definitionIdentity = plan.definition?.identity;\n    plan.steps.forEach((step, index) => this.#stepOrder.set(step.id, index));\n    this.lifecycle.pipelineStart(plan, targetIds);\n  }\n\n  planStep(step: PipelinePlanStep): void {\n    this.#applyStepStatus({ pipelineId: this.pipelineId, status: \"planned\", step });\n  }\n\n  beginAttempt(step: PipelinePlanStep, startedAtMs = this.now()): PipelineStepAttempt {\n    const attempt = {\n      attemptId: `${this.identity.runId}:attempt:${(this.#nextAttemptSequence += 1).toString(36)}`,\n      startedAtMs,\n    };\n    this.#applyStepStatus({\n      attemptId: attempt.attemptId,\n      pipelineId: this.pipelineId,\n      status: \"running\",\n      step,\n    });\n    return attempt;\n  }\n\n  reportProgress(\n    step: PipelinePlanStep,\n    attempt: PipelineStepAttempt,\n    progress: PipelineStepProgress\n  ): void {\n    this.#applyStepStatus({\n      attemptId: attempt.attemptId,\n      pipelineId: this.pipelineId,\n      progress,\n      status: \"running\",\n      step,\n    });\n  }\n\n  completeStep(step: PipelinePlanStep, attempt: PipelineStepAttempt, value: unknown): void {\n    const report: PipelineStepCompleteReport = {\n      attemptId: attempt.attemptId,\n      id: step.id,\n      name: step.name,\n      description: step.description,\n      finishedAtMs: this.now(),\n      startedAtMs: attempt.startedAtMs,\n      status: \"completed\",\n    };\n    this.#applyStepStatus({ ...report, pipelineId: this.pipelineId, step }, { output: { value } });\n  }\n\n  skipStep(\n    step: PipelinePlanStep,\n    input: {\n      attempt?: PipelineStepAttempt;\n      dependencyId?: string;\n      message?: string;\n      output?: { value: unknown };\n      reason: PipelineStepSkipReason;\n    }\n  ): void {\n    const report: PipelineStepSkippedReport = {\n      id: step.id,\n      name: step.name,\n      description: step.description,\n      finishedAtMs: this.now(),\n      reason: input.reason,\n      status: \"skipped\",\n    };\n    if (input.attempt) {\n      report.attemptId = input.attempt.attemptId;\n      report.startedAtMs = input.attempt.startedAtMs;\n    }\n    if (input.dependencyId) report.dependencyId = input.dependencyId;\n    if (input.message) report.message = input.message;\n    this.#applyStepStatus(\n      { ...report, pipelineId: this.pipelineId, step },\n      input.output ? { output: input.output } : undefined\n    );\n  }\n\n  failStep(step: PipelinePlanStep, attempt: PipelineStepAttempt, error: PipelineError): void {\n    if (error.kind === \"cancellation\") {\n      this.cancelStep(step, error, true, attempt);\n      return;\n    }\n    const report: PipelineStepFailedReport = {\n      attemptId: attempt.attemptId,\n      id: step.id,\n      name: step.name,\n      description: step.description,\n      error,\n      finishedAtMs: this.now(),\n      startedAtMs: attempt.startedAtMs,\n      status: \"failed\",\n    };\n    this.#applyStepStatus(\n      { ...report, pipelineId: this.pipelineId, step },\n      { error: { record: true, value: error } }\n    );\n  }\n\n  cancelStep(\n    step: PipelinePlanStep,\n    error: PipelineError,\n    recordError: boolean,\n    attempt?: PipelineStepAttempt\n  ): void {\n    const report: PipelineStepCancelledReport = {\n      id: step.id,\n      name: step.name,\n      description: step.description,\n      error,\n      finishedAtMs: this.now(),\n      status: \"cancelled\",\n    };\n    if (attempt) {\n      report.attemptId = attempt.attemptId;\n      report.startedAtMs = attempt.startedAtMs;\n    }\n    this.#applyStepStatus(\n      { ...report, pipelineId: this.pipelineId, step },\n      { error: { record: recordError, value: error } }\n    );\n  }\n\n  recordRunErrors(errors: readonly PipelineError[]): void {\n    this.#expectPhase(\"running\");\n    for (const error of errors) this.#runErrors.add(error);\n    this.#errors.push(...errors);\n  }\n\n  beginFinalization(): void {\n    this.#expectPhase(\"running\");\n    this.#expectAllStepsTerminal();\n    if (this.#finalizationAttempted) throw new Error(\"Pipeline finalization already attempted\");\n    this.#finalizationAttempted = true;\n    this.#phase = \"finalizing\";\n    this.lifecycle.finalizeStart();\n  }\n\n  completeFinalization(value: TResult, durationMs: number): void {\n    this.#expectPhase(\"finalizing\");\n    this.#finalization = { finalized: true, value };\n    this.#phase = \"running\";\n    this.lifecycle.finalizeComplete(durationMs, value);\n  }\n\n  failFinalization(error: PipelineError, durationMs: number): void {\n    this.#expectPhase(\"finalizing\");\n    this.#errors.push(error);\n    this.#phase = \"running\";\n    this.lifecycle.finalizeError(error, durationMs);\n  }\n\n  async finish(): Promise<PipelineRun<TResult>> {\n    this.#expectPhase(\"running\");\n    this.#expectAllStepsTerminal();\n    this.#phase = \"finished\";\n    const errorOrder = (error: PipelineError): number => {\n      // A run-level diagnostic may identify a step without becoming a step failure.\n      if (this.#runErrors.has(error)) return -1;\n      if (error.phase === \"finalization\") return this.#stepOrder.size;\n      return error.stepId === undefined ? -1 : (this.#stepOrder.get(error.stepId) ?? -1);\n    };\n    // Live observations retain event order; only the finished record is ordered by plan.\n    const errors = [...this.#errors].sort((left, right) => errorOrder(left) - errorOrder(right));\n    const steps = [...this.#reportsByStepId.values()].sort(\n      (left, right) => this.#stepOrder.get(left.id)! - this.#stepOrder.get(right.id)!\n    );\n    const result: PipelineRun<TResult> = {\n      pipelineId: this.pipelineId,\n      dryRun: this.dryRun,\n      errors,\n      finishedAtMs: this.now(),\n      runId: this.identity.runId,\n      startedAtMs: this.startedAtMs,\n      status: terminalRunStatus(this.#errors),\n      steps,\n      version: RUN_MODEL_VERSION,\n      ...this.#finalization,\n    };\n    if (this.#definitionIdentity) result.definitionIdentity = this.#definitionIdentity;\n    if (this.identity.correlationId !== undefined) {\n      result.correlationId = this.identity.correlationId;\n    }\n    if (this.identity.parentRunId) result.parentRunId = this.identity.parentRunId;\n    this.lifecycle.pipelineComplete(result);\n    await this.lifecycle.flush();\n    return result;\n  }\n\n  #applyStepStatus(event: PipelineStepStatus, effects: StepTransitionEffects = {}): void {\n    this.#expectPhase(\"running\");\n    const previous = this.#currentStepStatuses.get(event.step.id);\n    const valid =\n      (previous === undefined && event.status === \"planned\") ||\n      (previous === \"planned\" &&\n        (event.status === \"running\" ||\n          event.status === \"skipped\" ||\n          event.status === \"cancelled\")) ||\n      (previous === \"running\" &&\n        (event.status === \"running\" ||\n          event.status === \"completed\" ||\n          event.status === \"skipped\" ||\n          event.status === \"cancelled\" ||\n          event.status === \"failed\"));\n    if (!valid) {\n      throw new Error(\n        `Invalid step status transition for ${event.step.id}: ${previous ?? \"unobserved\"} -> ${event.status}`\n      );\n    }\n\n    this.#currentStepStatuses.set(event.step.id, event.status);\n    if (event.status !== \"planned\" && event.status !== \"running\") {\n      const report = stepReportFromStatus(event);\n      this.#reportsByStepId.set(event.step.id, report);\n    }\n    if (effects.output) this.#outputs.set(event.step.id, effects.output.value);\n    if (effects.error?.record) this.#errors.push(effects.error.value);\n    this.lifecycle.stepStatus(event);\n  }\n\n  #expectPhase(expected: RunPhase): void {\n    if (this.#phase !== expected) {\n      throw new Error(\n        `Invalid pipeline run transition: expected ${expected}, found ${this.#phase}`\n      );\n    }\n  }\n\n  #expectAllStepsTerminal(): void {\n    for (const [stepId, status] of this.#currentStepStatuses) {\n      if (status === \"planned\" || status === \"running\") {\n        throw new Error(`Cannot finish pipeline run while step ${stepId} is ${status}`);\n      }\n    }\n  }\n}\n"]}
+{"version":3,"file":"pipeline-run-state.js","sourceRoot":"","sources":["../../src/core/pipeline-run-state.ts"],"names":[],"mappings":"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","sourcesContent":["import { isCancellationOnly } from \"./pipeline-execution-error.js\";\nimport type { PipelineLifecycleObserver } from \"./lifecycle.js\";\nimport { RUN_MODEL_VERSION } from \"./pipeline-ids.js\";\nimport type {\n  PipelineError,\n  PipelinePlan,\n  PipelinePlanStep,\n  PipelineRun,\n  PipelineRunStatus,\n  PipelineStepCancelledReport,\n  PipelineStepCompleteReport,\n  PipelineStepFailedReport,\n  PipelineStepProgress,\n  PipelineStepReport,\n  PipelineStepSkipReason,\n  PipelineStepSkippedReport,\n  PipelineStepStatus,\n} from \"./pipeline-types.js\";\n\nexport interface PipelineStepAttempt {\n  outputSource?: \"override\";\n  attemptId: string;\n  startedAtMs: number;\n}\n\ntype RunPhase = \"created\" | \"finalizing\" | \"finished\" | \"running\";\n\ntype StepTransitionEffects = {\n  error?: { record: boolean; value: PipelineError };\n  output?: { value: unknown };\n};\n\ntype PipelineFinalization<TResult> =\n  | { finalized: false; value: undefined }\n  | { finalized: true; value: TResult };\n\nfunction terminalRunStatus(errors: readonly PipelineError[]): PipelineRunStatus {\n  if (errors.length === 0) return \"completed\";\n  return isCancellationOnly(errors) ? \"cancelled\" : \"failed\";\n}\n\nfunction stepReportFromStatus(\n  event: Exclude<PipelineStepStatus, { status: \"planned\" | \"running\" }>\n): PipelineStepReport {\n  const base = {\n    id: event.id,\n    name: event.name,\n    description: event.description,\n    finishedAtMs: event.finishedAtMs,\n    ...(event.outputSource ? { outputSource: event.outputSource } : {}),\n  };\n  switch (event.status) {\n    case \"completed\":\n      return {\n        ...base,\n        attemptId: event.attemptId,\n        startedAtMs: event.startedAtMs,\n        status: \"completed\",\n      };\n    case \"failed\":\n      return {\n        ...base,\n        attemptId: event.attemptId,\n        error: event.error,\n        startedAtMs: event.startedAtMs,\n        status: \"failed\",\n      };\n    case \"cancelled\": {\n      const report: PipelineStepCancelledReport = {\n        ...base,\n        error: event.error,\n        status: \"cancelled\",\n      };\n      if (event.attemptId) report.attemptId = event.attemptId;\n      if (event.startedAtMs !== undefined) report.startedAtMs = event.startedAtMs;\n      return report;\n    }\n    case \"skipped\": {\n      const report: PipelineStepSkippedReport = {\n        ...base,\n        reason: event.reason,\n        status: \"skipped\",\n      };\n      if (event.attemptId) report.attemptId = event.attemptId;\n      if (event.startedAtMs !== undefined) report.startedAtMs = event.startedAtMs;\n      if (event.dependencyId) report.dependencyId = event.dependencyId;\n      if (event.message) report.message = event.message;\n      return report;\n    }\n  }\n}\n\nexport class PipelineRunState<TResult> {\n  readonly #currentStepStatuses = new Map<string, PipelineStepStatus[\"status\"]>();\n  readonly #errors: PipelineError[] = [];\n  readonly #runErrors = new Set<PipelineError>();\n  readonly #outputs = new Map<string, unknown>();\n  readonly #stepOrder = new Map<string, number>();\n  readonly #reportsByStepId = new Map<string, PipelineStepReport>();\n  #definitionIdentity: PipelineRun[\"definitionIdentity\"];\n  #finalizationAttempted = false;\n  #finalization: PipelineFinalization<TResult> = { finalized: false, value: undefined };\n  #nextAttemptSequence = 0;\n  #phase: RunPhase = \"created\";\n\n  constructor(\n    readonly pipelineId: string,\n    readonly dryRun: boolean,\n    readonly startedAtMs: number,\n    readonly identity: { correlationId?: string; parentRunId?: string; runId: string },\n    readonly now: () => number,\n    readonly lifecycle: Pick<\n      PipelineLifecycleObserver,\n      | \"pipelineStart\"\n      | \"stepStatus\"\n      | \"finalizeStart\"\n      | \"finalizeComplete\"\n      | \"finalizeError\"\n      | \"pipelineComplete\"\n      | \"flush\"\n    >\n  ) {}\n\n  get errors(): readonly PipelineError[] {\n    return this.#errors;\n  }\n\n  get outputs(): ReadonlyMap<string, unknown> {\n    return this.#outputs;\n  }\n\n  get reportsByStepId(): ReadonlyMap<string, PipelineStepReport> {\n    return this.#reportsByStepId;\n  }\n\n  start(plan: PipelinePlan, targetIds: readonly string[]): void {\n    this.#expectPhase(\"created\");\n    this.#phase = \"running\";\n    this.#definitionIdentity = plan.definition?.identity;\n    plan.steps.forEach((step, index) => this.#stepOrder.set(step.id, index));\n    this.lifecycle.pipelineStart(plan, targetIds);\n  }\n\n  planStep(step: PipelinePlanStep): void {\n    this.#applyStepStatus({ pipelineId: this.pipelineId, status: \"planned\", step });\n  }\n\n  beginAttempt(\n    step: PipelinePlanStep,\n    startedAtMs = this.now(),\n    outputSource?: \"override\"\n  ): PipelineStepAttempt {\n    const attempt = {\n      attemptId: `${this.identity.runId}:attempt:${(this.#nextAttemptSequence += 1).toString(36)}`,\n      startedAtMs,\n      ...(outputSource ? { outputSource } : {}),\n    };\n    this.#applyStepStatus({\n      attemptId: attempt.attemptId,\n      ...(attempt.outputSource ? { outputSource: attempt.outputSource } : {}),\n      pipelineId: this.pipelineId,\n      status: \"running\",\n      step,\n    });\n    return attempt;\n  }\n\n  reportProgress(\n    step: PipelinePlanStep,\n    attempt: PipelineStepAttempt,\n    progress: PipelineStepProgress\n  ): void {\n    this.#applyStepStatus({\n      attemptId: attempt.attemptId,\n      ...(attempt.outputSource ? { outputSource: attempt.outputSource } : {}),\n      pipelineId: this.pipelineId,\n      progress,\n      status: \"running\",\n      step,\n    });\n  }\n\n  completeStep(step: PipelinePlanStep, attempt: PipelineStepAttempt, value: unknown): void {\n    const report: PipelineStepCompleteReport = {\n      ...attempt,\n      id: step.id,\n      name: step.name,\n      description: step.description,\n      finishedAtMs: this.now(),\n      status: \"completed\",\n    };\n    this.#applyStepStatus({ ...report, pipelineId: this.pipelineId, step }, { output: { value } });\n  }\n\n  skipStep(\n    step: PipelinePlanStep,\n    input: {\n      attempt?: PipelineStepAttempt;\n      dependencyId?: string;\n      message?: string;\n      output?: { value: unknown };\n      reason: PipelineStepSkipReason;\n    }\n  ): void {\n    const report: PipelineStepSkippedReport = {\n      ...input.attempt,\n      id: step.id,\n      name: step.name,\n      description: step.description,\n      finishedAtMs: this.now(),\n      reason: input.reason,\n      status: \"skipped\",\n    };\n    if (input.dependencyId) report.dependencyId = input.dependencyId;\n    if (input.message) report.message = input.message;\n    this.#applyStepStatus(\n      { ...report, pipelineId: this.pipelineId, step },\n      input.output ? { output: input.output } : undefined\n    );\n  }\n\n  failStep(step: PipelinePlanStep, attempt: PipelineStepAttempt, error: PipelineError): void {\n    if (error.kind === \"cancellation\") {\n      this.cancelStep(step, error, true, attempt);\n      return;\n    }\n    const report: PipelineStepFailedReport = {\n      ...attempt,\n      id: step.id,\n      name: step.name,\n      description: step.description,\n      error,\n      finishedAtMs: this.now(),\n      status: \"failed\",\n    };\n    this.#applyStepStatus(\n      { ...report, pipelineId: this.pipelineId, step },\n      { error: { record: true, value: error } }\n    );\n  }\n\n  cancelStep(\n    step: PipelinePlanStep,\n    error: PipelineError,\n    recordError: boolean,\n    attempt?: PipelineStepAttempt\n  ): void {\n    const report: PipelineStepCancelledReport = {\n      ...attempt,\n      id: step.id,\n      name: step.name,\n      description: step.description,\n      error,\n      finishedAtMs: this.now(),\n      status: \"cancelled\",\n    };\n    this.#applyStepStatus(\n      { ...report, pipelineId: this.pipelineId, step },\n      { error: { record: recordError, value: error } }\n    );\n  }\n\n  recordRunErrors(errors: readonly PipelineError[]): void {\n    this.#expectPhase(\"running\");\n    for (const error of errors) this.#runErrors.add(error);\n    this.#errors.push(...errors);\n  }\n\n  beginFinalization(): void {\n    this.#expectPhase(\"running\");\n    this.#expectAllStepsTerminal();\n    if (this.#finalizationAttempted) throw new Error(\"Pipeline finalization already attempted\");\n    this.#finalizationAttempted = true;\n    this.#phase = \"finalizing\";\n    this.lifecycle.finalizeStart();\n  }\n\n  completeFinalization(value: TResult, durationMs: number): void {\n    this.#expectPhase(\"finalizing\");\n    this.#finalization = { finalized: true, value };\n    this.#phase = \"running\";\n    this.lifecycle.finalizeComplete(durationMs, value);\n  }\n\n  failFinalization(error: PipelineError, durationMs: number): void {\n    this.#expectPhase(\"finalizing\");\n    this.#errors.push(error);\n    this.#phase = \"running\";\n    this.lifecycle.finalizeError(error, durationMs);\n  }\n\n  async finish(): Promise<PipelineRun<TResult>> {\n    this.#expectPhase(\"running\");\n    this.#expectAllStepsTerminal();\n    this.#phase = \"finished\";\n    const errorOrder = (error: PipelineError): number => {\n      // A run-level diagnostic may identify a step without becoming a step failure.\n      if (this.#runErrors.has(error)) return -1;\n      if (error.phase === \"finalization\") return this.#stepOrder.size;\n      return error.stepId === undefined ? -1 : (this.#stepOrder.get(error.stepId) ?? -1);\n    };\n    // Live observations retain event order; only the finished record is ordered by plan.\n    const errors = [...this.#errors].sort((left, right) => errorOrder(left) - errorOrder(right));\n    const steps = [...this.#reportsByStepId.values()].sort(\n      (left, right) => this.#stepOrder.get(left.id)! - this.#stepOrder.get(right.id)!\n    );\n    const result: PipelineRun<TResult> = {\n      pipelineId: this.pipelineId,\n      dryRun: this.dryRun,\n      errors,\n      finishedAtMs: this.now(),\n      runId: this.identity.runId,\n      startedAtMs: this.startedAtMs,\n      status: terminalRunStatus(this.#errors),\n      steps,\n      version: RUN_MODEL_VERSION,\n      ...this.#finalization,\n    };\n    if (this.#definitionIdentity) result.definitionIdentity = this.#definitionIdentity;\n    if (this.identity.correlationId !== undefined) {\n      result.correlationId = this.identity.correlationId;\n    }\n    if (this.identity.parentRunId) result.parentRunId = this.identity.parentRunId;\n    this.lifecycle.pipelineComplete(result);\n    await this.lifecycle.flush();\n    return result;\n  }\n\n  #applyStepStatus(event: PipelineStepStatus, effects: StepTransitionEffects = {}): void {\n    this.#expectPhase(\"running\");\n    const previous = this.#currentStepStatuses.get(event.step.id);\n    const valid =\n      (previous === undefined && event.status === \"planned\") ||\n      (previous === \"planned\" &&\n        (event.status === \"running\" ||\n          event.status === \"skipped\" ||\n          event.status === \"cancelled\")) ||\n      (previous === \"running\" &&\n        (event.status === \"running\" ||\n          event.status === \"completed\" ||\n          event.status === \"skipped\" ||\n          event.status === \"cancelled\" ||\n          event.status === \"failed\"));\n    if (!valid) {\n      throw new Error(\n        `Invalid step status transition for ${event.step.id}: ${previous ?? \"unobserved\"} -> ${event.status}`\n      );\n    }\n\n    this.#currentStepStatuses.set(event.step.id, event.status);\n    if (event.status !== \"planned\" && event.status !== \"running\") {\n      const report = stepReportFromStatus(event);\n      this.#reportsByStepId.set(event.step.id, report);\n    }\n    if (effects.output) this.#outputs.set(event.step.id, effects.output.value);\n    if (effects.error?.record) this.#errors.push(effects.error.value);\n    this.lifecycle.stepStatus(event);\n  }\n\n  #expectPhase(expected: RunPhase): void {\n    if (this.#phase !== expected) {\n      throw new Error(\n        `Invalid pipeline run transition: expected ${expected}, found ${this.#phase}`\n      );\n    }\n  }\n\n  #expectAllStepsTerminal(): void {\n    for (const [stepId, status] of this.#currentStepStatuses) {\n      if (status === \"planned\" || status === \"running\") {\n        throw new Error(`Cannot finish pipeline run while step ${stepId} is ${status}`);\n      }\n    }\n  }\n}\n"]}

package/dist/core/pipeline-step-executor.d.ts

@@ -1,3 +1,4 @@
+import { type ArtifactRecord } from "../tracing/artifact-metadata.js";
 import type { AnyStep } from "./pipeline-steps.js";
 import type { PipelineExecutionContext, PipelineLogger, PipelineStepProgress } from "./pipeline-types.js";
 import type { PipelineTraceAttributes } from "../tracing/tracing-contracts.js";
@@ -13,6 +14,7 @@ export declare function executeStepAttempt<TOptions extends object>(input: {
     dryRun: boolean;
     inputs: Record<string, unknown>;
     log: PipelineLogger;
+    onArtifact?(record: ArtifactRecord, preview: boolean): void;
     onProgress(progress: PipelineStepProgress): void;
     onReportAttempt(attempt: number, attributes?: PipelineTraceAttributes): void;
     outputBoundary: string;

package/dist/core/pipeline-step-executor.js

@@ -1,3 +1,4 @@
+import { artifactRecordSchema } from "../tracing/artifact-metadata.js";
 import { validateStandardSchema } from "./pipeline-validation.js";
 function normalizeStepSkipDecision(decision) {
     if (decision == null || decision === false)
@@ -26,14 +27,21 @@ export async function validateStepOutput(step, value, boundary) {
 }
 export async function executeStepAttempt(input) {
     const { step } = input;
-    let acceptsProgress = true;
+    let acceptsReports = true;
     const stepContext = {
         ...input.context,
+        recordArtifact: (record) => {
+            if (!acceptsReports)
+                return;
+            const snapshot = artifactRecordSchema.decode(record, "artifact record");
+            const preview = input.dryRun && (typeof step.dryRun === "function" || snapshot.operation === "write");
+            input.onArtifact?.(snapshot, preview);
+        },
         attemptId: input.attemptId,
         log: input.log,
         reportAttempt: input.onReportAttempt,
         reportProgress: (progress) => {
-            if (acceptsProgress)
+            if (acceptsReports)
                 input.onProgress(progress);
         },
     };
@@ -45,7 +53,7 @@ export async function executeStepAttempt(input) {
                 : await step.run(input.inputs, stepContext);
     }
     finally {
-        acceptsProgress = false;
+        acceptsReports = false;
     }
     return validateStepOutput(step, output, input.outputBoundary);
 }

package/dist/core/pipeline-step-executor.js.map

@@ -1 +1 @@
-{"version":3,"file":"pipeline-step-executor.js","sourceRoot":"","sources":["../../src/core/pipeline-step-executor.ts"],"names":[],"mappings":"AAQA,OAAO,EAAE,sBAAsB,EAAE,MAAM,0BAA0B,CAAC;AAOlE,SAAS,yBAAyB,CAAC,QAA0B;IAC3D,IAAI,QAAQ,IAAI,IAAI,IAAI,QAAQ,KAAK,KAAK;QAAE,OAAO,IAAI,CAAC;IACxD,IAAI,OAAO,QAAQ,KAAK,QAAQ,EAAE,CAAC;QACjC,MAAM,MAAM,GAAG,QAAQ,CAAC,IAAI,EAAE,CAAC;QAC/B,OAAO,MAAM,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC;IAC/C,CAAC;IACD,IAAI,OAAO,QAAQ,KAAK,QAAQ,IAAI,OAAO,QAAQ,CAAC,MAAM,KAAK,QAAQ,EAAE,CAAC;QACxE,MAAM,MAAM,GAAG,QAAQ,CAAC,MAAM,CAAC,IAAI,EAAE,CAAC;QACtC,IAAI,MAAM,CAAC,MAAM,KAAK,CAAC;YAAE,OAAO,IAAI,CAAC;QACrC,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,QAAQ,CAAC,KAAK,EAAE,CAAC;IAC3C,CAAC;IACD,OAAO,IAAI,CAAC;AACd,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,gBAAgB,CACpC,IAAuB,EACvB,MAA+B,EAC/B,OAA2C;IAE3C,IAAI,OAAO,IAAI,CAAC,IAAI,KAAK,UAAU;QAAE,OAAO,IAAI,CAAC;IACjD,OAAO,yBAAyB,CAAC,MAAM,IAAI,CAAC,IAAI,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC;AACrE,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,kBAAkB,CACtC,IAAuB,EACvB,KAAc,EACd,QAAgB;IAEhB,OAAO,IAAI,CAAC,YAAY;QACtB,CAAC,CAAC,sBAAsB,CAAC,IAAI,CAAC,YAAY,EAAE,KAAK,EAAE,QAAQ,CAAC;QAC5D,CAAC,CAAC,OAAO,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC;AAC7B,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,kBAAkB,CAA0B,KAUjE;IACC,MAAM,EAAE,IAAI,EAAE,GAAG,KAAK,CAAC;IACvB,IAAI,eAAe,GAAG,IAAI,CAAC;IAC3B,MAAM,WAAW,GAAG;QAClB,GAAG,KAAK,CAAC,OAAO;QAChB,SAAS,EAAE,KAAK,CAAC,SAAS;QAC1B,GAAG,EAAE,KAAK,CAAC,GAAG;QACd,aAAa,EAAE,KAAK,CAAC,eAAe;QACpC,cAAc,EAAE,CAAC,QAA8B,EAAE,EAAE;YACjD,IAAI,eAAe;gBAAE,KAAK,CAAC,UAAU,CAAC,QAAQ,CAAC,CAAC;QAClD,CAAC;KACF,CAAC;IACF,IAAI,MAAe,CAAC;IACpB,IAAI,CAAC;QACH,MAAM;YACJ,KAAK,CAAC,MAAM,IAAI,OAAO,IAAI,CAAC,MAAM,KAAK,UAAU;gBAC/C,CAAC,CAAC,MAAM,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,MAAM,EAAE,WAAW,CAAC;gBAC9C,CAAC,CAAC,MAAM,IAAI,CAAC,GAAG,CAAC,KAAK,CAAC,MAAM,EAAE,WAAW,CAAC,CAAC;IAClD,CAAC;YAAS,CAAC;QACT,eAAe,GAAG,KAAK,CAAC;IAC1B,CAAC;IACD,OAAO,kBAAkB,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,CAAC,cAAc,CAAC,CAAC;AAChE,CAAC","sourcesContent":["import type { AnyStep } from \"./pipeline-steps.js\";\nimport type {\n  PipelineExecutionContext,\n  PipelineLogger,\n  PipelineStepProgress,\n  StepSkipDecision,\n} from \"./pipeline-types.js\";\nimport type { PipelineTraceAttributes } from \"../tracing/tracing-contracts.js\";\nimport { validateStandardSchema } from \"./pipeline-validation.js\";\n\nexport interface NormalizedStepSkipDecision {\n  reason: string;\n  value?: unknown;\n}\n\nfunction normalizeStepSkipDecision(decision: StepSkipDecision): NormalizedStepSkipDecision | null {\n  if (decision == null || decision === false) return null;\n  if (typeof decision === \"string\") {\n    const reason = decision.trim();\n    return reason.length > 0 ? { reason } : null;\n  }\n  if (typeof decision === \"object\" && typeof decision.reason === \"string\") {\n    const reason = decision.reason.trim();\n    if (reason.length === 0) return null;\n    return { reason, value: decision.value };\n  }\n  return null;\n}\n\nexport async function evaluateStepSkip<TOptions extends object>(\n  step: AnyStep<TOptions>,\n  inputs: Record<string, unknown>,\n  context: PipelineExecutionContext<TOptions>\n): Promise<NormalizedStepSkipDecision | null> {\n  if (typeof step.skip !== \"function\") return null;\n  return normalizeStepSkipDecision(await step.skip(inputs, context));\n}\n\nexport async function validateStepOutput<TOptions extends object>(\n  step: AnyStep<TOptions>,\n  value: unknown,\n  boundary: string\n): Promise<unknown> {\n  return step.outputSchema\n    ? validateStandardSchema(step.outputSchema, value, boundary)\n    : Promise.resolve(value);\n}\n\nexport async function executeStepAttempt<TOptions extends object>(input: {\n  attemptId: string;\n  context: PipelineExecutionContext<TOptions>;\n  dryRun: boolean;\n  inputs: Record<string, unknown>;\n  log: PipelineLogger;\n  onProgress(progress: PipelineStepProgress): void;\n  onReportAttempt(attempt: number, attributes?: PipelineTraceAttributes): void;\n  outputBoundary: string;\n  step: AnyStep<TOptions>;\n}): Promise<unknown> {\n  const { step } = input;\n  let acceptsProgress = true;\n  const stepContext = {\n    ...input.context,\n    attemptId: input.attemptId,\n    log: input.log,\n    reportAttempt: input.onReportAttempt,\n    reportProgress: (progress: PipelineStepProgress) => {\n      if (acceptsProgress) input.onProgress(progress);\n    },\n  };\n  let output: unknown;\n  try {\n    output =\n      input.dryRun && typeof step.dryRun === \"function\"\n        ? await step.dryRun(input.inputs, stepContext)\n        : await step.run(input.inputs, stepContext);\n  } finally {\n    acceptsProgress = false;\n  }\n  return validateStepOutput(step, output, input.outputBoundary);\n}\n"]}
+{"version":3,"file":"pipeline-step-executor.js","sourceRoot":"","sources":["../../src/core/pipeline-step-executor.ts"],"names":[],"mappings":"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","sourcesContent":["import { artifactRecordSchema, type ArtifactRecord } from \"../tracing/artifact-metadata.js\";\nimport type { AnyStep } from \"./pipeline-steps.js\";\nimport type {\n  PipelineExecutionContext,\n  PipelineLogger,\n  PipelineStepProgress,\n  StepSkipDecision,\n} from \"./pipeline-types.js\";\nimport type { PipelineTraceAttributes } from \"../tracing/tracing-contracts.js\";\nimport { validateStandardSchema } from \"./pipeline-validation.js\";\n\nexport interface NormalizedStepSkipDecision {\n  reason: string;\n  value?: unknown;\n}\n\nfunction normalizeStepSkipDecision(decision: StepSkipDecision): NormalizedStepSkipDecision | null {\n  if (decision == null || decision === false) return null;\n  if (typeof decision === \"string\") {\n    const reason = decision.trim();\n    return reason.length > 0 ? { reason } : null;\n  }\n  if (typeof decision === \"object\" && typeof decision.reason === \"string\") {\n    const reason = decision.reason.trim();\n    if (reason.length === 0) return null;\n    return { reason, value: decision.value };\n  }\n  return null;\n}\n\nexport async function evaluateStepSkip<TOptions extends object>(\n  step: AnyStep<TOptions>,\n  inputs: Record<string, unknown>,\n  context: PipelineExecutionContext<TOptions>\n): Promise<NormalizedStepSkipDecision | null> {\n  if (typeof step.skip !== \"function\") return null;\n  return normalizeStepSkipDecision(await step.skip(inputs, context));\n}\n\nexport async function validateStepOutput<TOptions extends object>(\n  step: AnyStep<TOptions>,\n  value: unknown,\n  boundary: string\n): Promise<unknown> {\n  return step.outputSchema\n    ? validateStandardSchema(step.outputSchema, value, boundary)\n    : Promise.resolve(value);\n}\n\nexport async function executeStepAttempt<TOptions extends object>(input: {\n  attemptId: string;\n  context: PipelineExecutionContext<TOptions>;\n  dryRun: boolean;\n  inputs: Record<string, unknown>;\n  log: PipelineLogger;\n  onArtifact?(record: ArtifactRecord, preview: boolean): void;\n  onProgress(progress: PipelineStepProgress): void;\n  onReportAttempt(attempt: number, attributes?: PipelineTraceAttributes): void;\n  outputBoundary: string;\n  step: AnyStep<TOptions>;\n}): Promise<unknown> {\n  const { step } = input;\n  let acceptsReports = true;\n  const stepContext = {\n    ...input.context,\n    recordArtifact: (record: ArtifactRecord) => {\n      if (!acceptsReports) return;\n      const snapshot = artifactRecordSchema.decode(record, \"artifact record\");\n      const preview =\n        input.dryRun && (typeof step.dryRun === \"function\" || snapshot.operation === \"write\");\n      input.onArtifact?.(snapshot, preview);\n    },\n    attemptId: input.attemptId,\n    log: input.log,\n    reportAttempt: input.onReportAttempt,\n    reportProgress: (progress: PipelineStepProgress) => {\n      if (acceptsReports) input.onProgress(progress);\n    },\n  };\n  let output: unknown;\n  try {\n    output =\n      input.dryRun && typeof step.dryRun === \"function\"\n        ? await step.dryRun(input.inputs, stepContext)\n        : await step.run(input.inputs, stepContext);\n  } finally {\n    acceptsReports = false;\n  }\n  return validateStepOutput(step, output, input.outputBoundary);\n}\n"]}

package/dist/core/pipeline-steps.d.ts

@@ -1,3 +1,5 @@
+import { type ArtifactLoader, type ArtifactSaver, type ArtifactResult } from "./pipeline-artifacts.js";
+import { type IterationDecision, type IterationState } from "./iteration.js";
 import type { ToMappedChildStepProgressOptions } from "./mapped-child-progress.js";
 import { STEP_NESTED_PIPELINE, STEP_OPTIONS_SCHEMA, STEP_REMOTE } from "./pipeline-step-metadata.js";
 import type { InferSchemaInput, InferSchemaOutput, Pipeline, PipelineExecutionContext, PipelinePlanStep, PipelineRun, PipelineRunControls, PipelineStepContext, RemoteStepAdapter, StandardSchemaV1, StepSkipDecision } from "./pipeline-types.js";
@@ -168,6 +170,12 @@ declare function createStepFactory<TOptions extends object, TInputOptions extend
             skip?: never;
         }): TOptionsSchema extends StandardSchemaV1<unknown, unknown> ? Step<TId, TOut, TOptions, TInputOptions, TOut, TOptionsSchema> : Step<TId, TOut, TOptions, TInputOptions, TOut, StandardSchemaV1<unknown, unknown> | undefined>;
     };
+    loadArtifact: <TId extends string, const TDeps extends readonly AnyStep<TOptions>[] = [], const TOptionalDeps extends readonly AnyStep<TOptions>[] = [], TValue = unknown>(id: TId, definition: Omit<PlainStepFields<TOptions, TDeps, TOptionalDeps, ArtifactResult<TValue>>, "run"> & {
+        load: ArtifactLoader<RequiredInputs<TDeps> & OptionalInputs<TOptionalDeps>, TValue, TOptions>;
+    }) => TOptionsSchema extends StandardSchemaV1<unknown, unknown> ? Step<TId, TValue, TOptions, TInputOptions, TValue, TOptionsSchema> : Step<TId, TValue, TOptions, TInputOptions, TValue, StandardSchemaV1<unknown, unknown> | undefined>;
+    saveArtifact: <TId extends string, const TDeps extends readonly AnyStep<TOptions>[] = [], const TOptionalDeps extends readonly AnyStep<TOptions>[] = [], TValue = unknown>(id: TId, definition: Omit<PlainStepFields<TOptions, TDeps, TOptionalDeps, ArtifactResult<TValue>>, "run"> & {
+        save: ArtifactSaver<RequiredInputs<TDeps> & OptionalInputs<TOptionalDeps>, TValue, TOptions>;
+    }) => TOptionsSchema extends StandardSchemaV1<unknown, unknown> ? Step<TId, TValue, TOptions, TInputOptions, TValue, TOptionsSchema> : Step<TId, TValue, TOptions, TInputOptions, TValue, StandardSchemaV1<unknown, unknown> | undefined>;
     fromPipeline: {
         <TId extends string, TChildPipeline extends Pipeline<object, unknown>, const TDeps extends readonly AnyStep<TOptions>[] = [], const TOptionalDeps extends readonly AnyStep<TOptions>[] = []>(id: TId, definition: ChildPipelineStepDefinition<TOptions, TDeps, TOptionalDeps, TChildPipeline> & {
             skip?: never;
@@ -212,5 +220,17 @@ declare function createStepFactory<TOptions extends object, TInputOptions extend
             mapResult(value: PipelineResultOf<TChildPipeline>, result: PipelineRun<PipelineResultOf<TChildPipeline>>, item: TItem, index: number, context: PipelineStepContext<TOptions>): TOut;
         }): TOptionsSchema extends StandardSchemaV1<unknown, unknown> ? Step<TId, PolicySkippedOutput<readonly TOut[], TDecision>, TOptions, TInputOptions, PolicySkippedOutput<readonly TOut[], TDecision>, TOptionsSchema> : Step<TId, PolicySkippedOutput<readonly TOut[], TDecision>, TOptions, TInputOptions, PolicySkippedOutput<readonly TOut[], TDecision>, StandardSchemaV1<unknown, unknown> | undefined>;
     };
+    iteratePipeline: <const TId extends string, TChild extends Pipeline<object, unknown>, TState, TResult, const TDeps extends readonly AnyStep<TOptions>[] = []>(id: TId, definition: {
+        pipeline: TChild;
+        name?: string;
+        description?: string;
+        dependsOn?: TDeps;
+        maxIterations: number;
+        dryRun?: "skip";
+        controls?: PipelineRunControlsOf<TChild>;
+        initialState(inputs: RequiredInputs<TDeps>, context: PipelineExecutionContext<TOptions>): TState;
+        mapOptions(state: IterationState<NoInfer<TState>>, inputs: RequiredInputs<TDeps>, context: PipelineExecutionContext<TOptions>): PipelineOptionsOf<TChild>;
+        transition(result: PipelineResultOf<TChild>, state: IterationState<NoInfer<TState>>, context: PipelineExecutionContext<TOptions>): IterationDecision<NoInfer<TState>, TResult> | Promise<IterationDecision<NoInfer<TState>, TResult>>;
+    }) => TOptionsSchema extends StandardSchemaV1<unknown, unknown> ? Step<TId, Awaited<TResult>, TOptions, TInputOptions, Awaited<TResult>, TOptionsSchema> : Step<TId, Awaited<TResult>, TOptions, TInputOptions, Awaited<TResult>, StandardSchemaV1<unknown, unknown> | undefined>;
 };
 export {};

package/dist/core/pipeline-steps.js

@@ -1,4 +1,6 @@
+import {} from "./pipeline-artifacts.js";
 import { createMappedChildRunner, createSingleChildRunner } from "./child-execution.js";
+import { createIterationRunner } from "./iteration.js";
 import { STEP_NESTED_PIPELINE, STEP_OPTIONS_SCHEMA, STEP_REMOTE, } from "./pipeline-step-metadata.js";
 export function createSteps(optionsSchema) {
     return createStepFactory(optionsSchema);
@@ -14,6 +16,34 @@ function createStepFactory(optionsSchema) {
     function step(id, definition) {
         return buildStep(id, definition);
     }
+    /** Read an artifact as an ordinary step, publishing only its typed value. */
+    function loadArtifact(id, definition) {
+        const { load, dryRun, ...fields } = definition;
+        const wrap = (handler) => async (inputs, context) => {
+            const loaded = await handler(inputs, context);
+            context.recordArtifact({ operation: "read", artifact: loaded.artifact });
+            return loaded.value;
+        };
+        return step(id, {
+            ...fields,
+            run: wrap(load),
+            dryRun: typeof dryRun === "function" ? wrap(dryRun) : dryRun,
+        });
+    }
+    /** Write an artifact as an ordinary step. Dry runs skip unless a preview is supplied. */
+    function saveArtifact(id, definition) {
+        const { save, dryRun, ...fields } = definition;
+        const wrap = (handler) => async (inputs, context) => {
+            const saved = await handler(inputs, context);
+            context.recordArtifact({ operation: "write", artifact: saved.artifact });
+            return saved.value;
+        };
+        return step(id, {
+            ...fields,
+            run: wrap(save),
+            dryRun: typeof dryRun === "function" ? wrap(dryRun) : "skip",
+        });
+    }
     const buildPipelineStep = (id, config) => {
         const definition = {
             [STEP_NESTED_PIPELINE]: {
@@ -89,11 +119,43 @@ function createStepFactory(optionsSchema) {
     function forEachPipeline(id, definition) {
         return buildMappedPipelineStep(id, definition);
     }
+    function iteratePipeline(id, definition) {
+        if (!Number.isSafeInteger(definition.maxIterations) || definition.maxIterations < 1) {
+            throw new RangeError("iteratePipeline maxIterations must be a positive safe integer");
+        }
+        const controls = definition.controls ? structuredClone(definition.controls) : undefined;
+        if (controls) {
+            if (controls.targets)
+                Object.freeze(controls.targets);
+            if (controls.stepIds)
+                Object.freeze(controls.stepIds);
+            Object.freeze(controls);
+        }
+        const config = { ...definition, stepId: id, controls };
+        return buildStep(id, {
+            [STEP_NESTED_PIPELINE]: {
+                mode: "iterate",
+                maxIterations: config.maxIterations,
+                controls: config.controls,
+                pipelineId: config.pipeline.id,
+                identity: config.pipeline.definition?.identity,
+                stepIds: config.pipeline.stepIds,
+            },
+            name: config.name,
+            description: config.description,
+            dependsOn: config.dependsOn,
+            dryRun: config.dryRun,
+            run: createIterationRunner(config),
+        });
+    }
     const factory = {
         step,
+        loadArtifact,
+        saveArtifact,
         fromPipeline,
         fromRemote,
         forEachPipeline,
+        iteratePipeline,
     };
     return factory;
 }

package/dist/core/pipeline-steps.js.map

@@ -1 +1 @@
-{"version":3,"file":"pipeline-steps.js","sourceRoot":"","sources":["../../src/core/pipeline-steps.ts"],"names":[],"mappings":"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","sourcesContent":["import { createMappedChildRunner, createSingleChildRunner } from \"./child-execution.js\";\nimport type { ToMappedChildStepProgressOptions } from \"./mapped-child-progress.js\";\nimport {\n  STEP_NESTED_PIPELINE,\n  STEP_OPTIONS_SCHEMA,\n  STEP_REMOTE,\n} from \"./pipeline-step-metadata.js\";\nimport type {\n  InferSchemaInput,\n  InferSchemaOutput,\n  Pipeline,\n  PipelineExecutionContext,\n  PipelinePlanStep,\n  PipelineRun,\n  PipelineRunControls,\n  PipelineStepContext,\n  RemoteStepAdapter,\n  StandardSchemaV1,\n  StepSkipDecision,\n} from \"./pipeline-types.js\";\n\n/**\n * A step's dependencies are references to the dependency's own step object, not string ids\n * into a hand-maintained output-type map. This buys two things no amount of extra generics\n * on a string-keyed design could:\n *  - a step used before its dependency exists is a compile error (JS temporal dead zone on\n *    `const`), so out-of-order and self/cyclic dependencies are caught by the language, not\n *    a bespoke runtime check\n *  - each step only ever states its own id/deps; the output-type map is derived, never\n *    restated, and callers of `definePipeline`/`createSteps` never write out its generics\n */\ntype AnyStepDryRunHandler<TOptions extends object> = {\n  bivarianceHack(\n    inputs: Record<string, unknown>,\n    context: PipelineStepContext<TOptions>\n  ): unknown | Promise<unknown>;\n}[\"bivarianceHack\"];\n\n/** Runtime shape shared by every declared pipeline step. */\nexport interface AnyStep<TOptions extends object = object> {\n  readonly [STEP_NESTED_PIPELINE]?: NonNullable<PipelinePlanStep[\"nestedPipeline\"]>;\n  readonly [STEP_REMOTE]?: NonNullable<PipelinePlanStep[\"remote\"]>;\n  readonly [STEP_OPTIONS_SCHEMA]?: StandardSchemaV1;\n  readonly id: string;\n  readonly dependsOn?: readonly AnyStep<TOptions>[];\n  readonly optionalDependsOn?: readonly AnyStep<TOptions>[];\n  readonly skipAfterFailureOf?: readonly AnyStep<TOptions>[];\n  /** Optional human-facing display name. Stable machine identity remains `id`. */\n  readonly name?: string;\n  readonly description?: string;\n  /**\n   * Dry-run policy. Omitted runs the normal handler, `\"skip\"` structurally\n   * skips it, and a handler substitutes for `run` while preserving its output.\n   */\n  readonly dryRun?: \"skip\" | AnyStepDryRunHandler<TOptions>;\n  /** Optional Standard Schema for values published by this step. */\n  readonly outputSchema?: StandardSchemaV1;\n  /**\n   * Optional runtime skip. Return a non-empty reason (or `{ reason, value }`) to\n   * skip without calling `run`. Policy skips unlock dependents; structural skips\n   * (dry-run, filtered, …) do not use this hook.\n   */\n  skip?(\n    inputs: Record<string, unknown>,\n    context: PipelineExecutionContext<TOptions>\n  ): StepSkipDecision | Promise<StepSkipDecision>;\n  run(inputs: Record<string, unknown>, context: PipelineStepContext<TOptions>): unknown;\n}\n\n/** The step fields that `buildStep` merges onto the id-bearing shell. */\ntype StepDefinitionBody<TOptions extends object> = Omit<AnyStep<TOptions>, \"id\">;\n\n/** Typed pipeline step carrying its stable ID, output, and option types. */\nexport interface Step<\n  TId extends string,\n  TOut,\n  TOptions extends object,\n  TInputOptions extends object = TOptions,\n  TRunOut = TOut,\n  TOptionsSchema extends StandardSchemaV1 | undefined = StandardSchemaV1 | undefined,\n> extends AnyStep<TOptions> {\n  readonly [STEP_OPTIONS_SCHEMA]?: TOptionsSchema;\n  readonly id: TId;\n  run(\n    inputs: Record<string, unknown>,\n    context: PipelineStepContext<TOptions>\n  ): TRunOut | Promise<TRunOut>;\n  /** Type-only: carries this step's output type for sibling inference. Never set at runtime. */\n  readonly __outputType?: TOut;\n  /** Type-only: carries pre-validation run options for pipeline call-site inference. */\n  readonly __inputOptionsType?: TInputOptions;\n}\n\n/**\n * Extract a step's output type for dependency typing.\n * Prefer matching `Step<…, TOut, …>` over `{ __outputType?: infer T }`: optional-property\n * inference collapses `TOut | undefined` to `TOut`, which hides policy-skip widening.\n */\nexport type StepOutput<S> =\n  S extends Step<string, infer TOut, infer _TOptions, infer _TInputOptions, infer _TRunOut>\n    ? TOut\n    : never;\n\ninterface StepToken {\n  readonly id: string;\n  readonly __outputType?: unknown;\n}\n\ntype RequiredInputs<TDeps extends readonly StepToken[]> = {\n  [S in TDeps[number] as S[\"id\"]]: StepOutput<S>;\n};\n\ntype OptionalInputs<TDeps extends readonly StepToken[]> = {\n  [S in TDeps[number] as S[\"id\"]]?: StepOutput<S>;\n};\n\ntype PipelineResultOf<TPipeline> =\n  TPipeline extends Pipeline<object, infer TResult, infer _TStepId, infer _TTargetId>\n    ? TResult\n    : never;\n\ntype PipelineOptionsOf<TPipeline> =\n  TPipeline extends Pipeline<infer TOptions, unknown, infer _TStepId, infer _TTargetId>\n    ? TOptions\n    : never;\n\ntype PipelineRunControlsOf<TPipeline> =\n  TPipeline extends Pipeline<infer _TOptions, unknown, infer TStepId, infer TTargetId>\n    ? PipelineRunControls<TStepId, TTargetId>\n    : never;\n\ntype ChildPipelineStepDefinitionBase<\n  TParentOptions extends object,\n  TDeps extends readonly AnyStep<TParentOptions>[],\n  TOptionalDeps extends readonly AnyStep<TParentOptions>[],\n  TChildPipeline extends Pipeline<object, unknown>,\n> = {\n  pipeline: TChildPipeline;\n  dependsOn?: TDeps;\n  optionalDependsOn?: TOptionalDeps;\n  skipAfterFailureOf?: readonly AnyStep<TParentOptions>[];\n  name?: string;\n  description?: string;\n  dryRun?: \"skip\";\n  controls?:\n    | PipelineRunControlsOf<TChildPipeline>\n    | ((\n        inputs: RequiredInputs<TDeps> & OptionalInputs<TOptionalDeps>,\n        context: PipelineExecutionContext<TParentOptions>\n      ) => PipelineRunControlsOf<TChildPipeline>);\n} & ([TParentOptions] extends [PipelineOptionsOf<NoInfer<TChildPipeline>>]\n  ? {\n      mapOptions?(\n        inputs: RequiredInputs<TDeps> & OptionalInputs<TOptionalDeps>,\n        context: PipelineExecutionContext<TParentOptions>\n      ): PipelineOptionsOf<TChildPipeline>;\n    }\n  : {\n      mapOptions(\n        inputs: RequiredInputs<TDeps> & OptionalInputs<TOptionalDeps>,\n        context: PipelineExecutionContext<TParentOptions>\n      ): PipelineOptionsOf<TChildPipeline>;\n    });\n\n/** Child step without policy skip (dependents see the full child result type). */\ntype ChildPipelineStepDefinition<\n  TParentOptions extends object,\n  TDeps extends readonly AnyStep<TParentOptions>[],\n  TOptionalDeps extends readonly AnyStep<TParentOptions>[],\n  TChildPipeline extends Pipeline<object, unknown>,\n> = ChildPipelineStepDefinitionBase<TParentOptions, TDeps, TOptionalDeps, TChildPipeline>;\n\n/**\n * Presentation options for opaque `forEachPipeline` progress.\n * Defaults are domain-neutral (`N/M items · K running · key/step`).\n * Override `formatMessage` when a domain wants its own noun (images, shards, …).\n */\nexport type MappedChildProgressOptions = ToMappedChildStepProgressOptions;\n\ntype MappedChildPipelineStepDefinition<\n  TParentOptions extends object,\n  TDeps extends readonly AnyStep<TParentOptions>[],\n  TOptionalDeps extends readonly AnyStep<TParentOptions>[],\n  TChildPipeline extends Pipeline<object, unknown>,\n  TItem,\n> = {\n  pipeline: TChildPipeline;\n  dependsOn?: TDeps;\n  optionalDependsOn?: TOptionalDeps;\n  skipAfterFailureOf?: readonly AnyStep<TParentOptions>[];\n  name?: string;\n  description?: string;\n  dryRun?: \"skip\";\n  items(\n    inputs: RequiredInputs<TDeps> & OptionalInputs<TOptionalDeps>,\n    context: PipelineExecutionContext<TParentOptions>\n  ): readonly TItem[] | Promise<readonly TItem[]>;\n  key(item: TItem, index: number): string;\n  concurrency?:\n    | number\n    | ((\n        inputs: RequiredInputs<TDeps> & OptionalInputs<TOptionalDeps>,\n        context: PipelineExecutionContext<TParentOptions>\n      ) => number);\n  /**\n   * How the opaque parent step reports live fan-out progress.\n   * Purely presentational — does not change scheduling or results.\n   */\n  progress?: MappedChildProgressOptions;\n  controls?:\n    | PipelineRunControlsOf<TChildPipeline>\n    | ((\n        item: TItem,\n        index: number,\n        inputs: RequiredInputs<TDeps> & OptionalInputs<TOptionalDeps>,\n        context: PipelineExecutionContext<TParentOptions>\n      ) => PipelineRunControlsOf<TChildPipeline>);\n  mapOptions(\n    item: TItem,\n    index: number,\n    inputs: RequiredInputs<TDeps> & OptionalInputs<TOptionalDeps>,\n    context: PipelineExecutionContext<TParentOptions>\n  ): PipelineOptionsOf<TChildPipeline>;\n};\n\ntype StepSkipPredicate<\n  TOptions extends object,\n  TDeps extends readonly AnyStep<TOptions>[],\n  TOptionalDeps extends readonly AnyStep<TOptions>[],\n  TOut,\n  TDecision extends StepSkipDecision<TOut> = StepSkipDecision<TOut>,\n> = (\n  inputs: RequiredInputs<TDeps> & OptionalInputs<TOptionalDeps>,\n  context: PipelineExecutionContext<TOptions>\n) => TDecision | Promise<TDecision>;\n\ntype PolicySkippedOutput<TOut, TDecision> = [\n  Exclude<Awaited<TDecision>, false | null | undefined>,\n] extends [{ reason: string; value: unknown }]\n  ? TOut\n  : TOut | undefined;\n\ntype StepDryRunPolicy<\n  TOptions extends object,\n  TDeps extends readonly AnyStep<TOptions>[],\n  TOptionalDeps extends readonly AnyStep<TOptions>[],\n  TOut,\n> =\n  | \"skip\"\n  | ((\n      inputs: RequiredInputs<TDeps> & OptionalInputs<TOptionalDeps>,\n      context: PipelineStepContext<TOptions>\n    ) => TOut | Promise<TOut>);\n\ntype PlainStepFields<\n  TOptions extends object,\n  TDeps extends readonly AnyStep<TOptions>[],\n  TOptionalDeps extends readonly AnyStep<TOptions>[],\n  TOut,\n> = {\n  dependsOn?: TDeps;\n  optionalDependsOn?: TOptionalDeps;\n  skipAfterFailureOf?: readonly AnyStep<TOptions>[];\n  name?: string;\n  description?: string;\n  dryRun?: StepDryRunPolicy<TOptions, TDeps, TOptionalDeps, TOut>;\n  outputSchema?: never;\n  run(\n    inputs: RequiredInputs<TDeps> & OptionalInputs<TOptionalDeps>,\n    context: PipelineStepContext<TOptions>\n  ): TOut | Promise<TOut>;\n};\n\ntype SchemaStepFields<\n  TOptions extends object,\n  TDeps extends readonly AnyStep<TOptions>[],\n  TOptionalDeps extends readonly AnyStep<TOptions>[],\n  TSchema extends StandardSchemaV1,\n> = Omit<\n  PlainStepFields<TOptions, TDeps, TOptionalDeps, InferSchemaInput<TSchema>>,\n  \"outputSchema\"\n> & {\n  outputSchema: TSchema;\n};\n\ntype RemoteStepDefinitionBase<\n  TParentOptions extends object,\n  TDeps extends readonly AnyStep<TParentOptions>[],\n  TOptionalDeps extends readonly AnyStep<TParentOptions>[],\n  TPayload,\n  TSchema extends StandardSchemaV1,\n> = {\n  adapter: RemoteStepAdapter<TParentOptions, TPayload, InferSchemaInput<TSchema>>;\n  mapInput(\n    inputs: RequiredInputs<TDeps> & OptionalInputs<TOptionalDeps>,\n    context: PipelineStepContext<TParentOptions>\n  ): TPayload;\n  outputSchema: TSchema;\n  dependsOn?: TDeps;\n  optionalDependsOn?: TOptionalDeps;\n  skipAfterFailureOf?: readonly AnyStep<TParentOptions>[];\n  name?: string;\n  description?: string;\n  dryRun?: StepDryRunPolicy<TParentOptions, TDeps, TOptionalDeps, InferSchemaInput<TSchema>>;\n};\n\n/** Step constructors scoped to one pipeline's domain option types. */\ntype StepFactory<\n  TOptions extends object,\n  TInputOptions extends object = TOptions,\n  TOptionsSchema extends StandardSchemaV1 | undefined = undefined,\n> = ReturnType<typeof createStepFactory<TOptions, TInputOptions, TOptionsSchema>>;\n\n/**\n * Create typed step constructors for one pipeline definition.\n * Returns a step factory scoped to one pipeline's domain options. Pass built-in\n * run controls as the second argument to `run` / `runOrThrow`, or through a\n * child step's separate `controls` field.\n */\nexport function createSteps<TOptions extends object = {}>(): StepFactory<TOptions>;\nexport function createSteps<const TSchema extends StandardSchemaV1<object, object> | undefined>(\n  optionsSchema: TSchema\n): StepFactory<\n  TSchema extends StandardSchemaV1 ? InferSchemaOutput<TSchema> : object,\n  TSchema extends StandardSchemaV1 ? InferSchemaInput<TSchema> : object,\n  TSchema\n>;\nexport function createSteps(\n  optionsSchema?: StandardSchemaV1<object, object>\n): StepFactory<object, object, StandardSchemaV1 | undefined> {\n  return createStepFactory<object, object, StandardSchemaV1 | undefined>(optionsSchema);\n}\n\nfunction createStepFactory<\n  TOptions extends object,\n  TInputOptions extends object = TOptions,\n  TOptionsSchema extends StandardSchemaV1 | undefined = undefined,\n>(optionsSchema?: TOptionsSchema) {\n  // Preserve the runtime schema in the step type so adapters cannot infer flags\n  // from erased TypeScript-only options.\n  type BuiltStep<\n    TId extends string,\n    TOut,\n    TStepOptions extends object,\n    TInput extends object,\n    TRunOut = TOut,\n  > = TOptionsSchema extends StandardSchemaV1\n    ? Step<TId, TOut, TStepOptions, TInput, TRunOut, TOptionsSchema>\n    : Step<TId, TOut, TStepOptions, TInput, TRunOut>;\n  const buildStep = (id: string, definition: StepDefinitionBody<TOptions>): AnyStep<TOptions> => {\n    const built: AnyStep<TOptions> = { id, ...definition };\n    if (optionsSchema) {\n      Object.defineProperty(built, STEP_OPTIONS_SCHEMA, { value: optionsSchema });\n    }\n    return built;\n  };\n\n  function step<\n    TId extends string,\n    TSchema extends StandardSchemaV1,\n    const TDeps extends readonly AnyStep<TOptions>[] = [],\n    const TOptionalDeps extends readonly AnyStep<TOptions>[] = [],\n    TDecision extends StepSkipDecision<InferSchemaInput<TSchema>> = StepSkipDecision<\n      InferSchemaInput<TSchema>\n    >,\n  >(\n    id: TId,\n    definition: SchemaStepFields<TOptions, TDeps, TOptionalDeps, TSchema> & {\n      skip:\n        | StepSkipPredicate<TOptions, TDeps, TOptionalDeps, InferSchemaInput<TSchema>, TDecision>\n        | undefined;\n    }\n  ): BuiltStep<\n    TId,\n    PolicySkippedOutput<InferSchemaOutput<TSchema>, TDecision>,\n    TOptions,\n    TInputOptions,\n    InferSchemaInput<TSchema>\n  >;\n  function step<\n    TId extends string,\n    const TDeps extends readonly AnyStep<TOptions>[] = [],\n    const TOptionalDeps extends readonly AnyStep<TOptions>[] = [],\n    TOut = unknown,\n    TDecision extends StepSkipDecision<NoInfer<TOut>> = StepSkipDecision<NoInfer<TOut>>,\n  >(\n    id: TId,\n    definition: PlainStepFields<TOptions, TDeps, TOptionalDeps, TOut> & {\n      skip: StepSkipPredicate<TOptions, TDeps, TOptionalDeps, NoInfer<TOut>, TDecision> | undefined;\n    }\n  ): BuiltStep<TId, PolicySkippedOutput<TOut, TDecision>, TOptions, TInputOptions>;\n  function step<\n    TId extends string,\n    TSchema extends StandardSchemaV1,\n    const TDeps extends readonly AnyStep<TOptions>[] = [],\n    const TOptionalDeps extends readonly AnyStep<TOptions>[] = [],\n  >(\n    id: TId,\n    definition: SchemaStepFields<TOptions, TDeps, TOptionalDeps, TSchema> & { skip?: never }\n  ): BuiltStep<TId, InferSchemaOutput<TSchema>, TOptions, TInputOptions, InferSchemaInput<TSchema>>;\n  function step<\n    TId extends string,\n    const TDeps extends readonly AnyStep<TOptions>[] = [],\n    const TOptionalDeps extends readonly AnyStep<TOptions>[] = [],\n    TOut = unknown,\n  >(\n    id: TId,\n    definition: PlainStepFields<TOptions, TDeps, TOptionalDeps, TOut> & { skip?: never }\n  ): BuiltStep<TId, TOut, TOptions, TInputOptions>;\n  function step(id: string, definition: StepDefinitionBody<TOptions>): AnyStep<TOptions> {\n    return buildStep(id, definition);\n  }\n\n  const buildPipelineStep = (\n    id: string,\n    config: ChildPipelineStepDefinitionBase<\n      TOptions,\n      readonly AnyStep<TOptions>[],\n      readonly AnyStep<TOptions>[],\n      Pipeline<object, unknown>\n    > & {\n      skip?: StepSkipPredicate<\n        TOptions,\n        readonly AnyStep<TOptions>[],\n        readonly AnyStep<TOptions>[],\n        unknown\n      >;\n      mapResult?: (\n        value: unknown,\n        result: PipelineRun<unknown>,\n        context: PipelineStepContext<TOptions>\n      ) => unknown;\n    }\n  ) => {\n    const definition: StepDefinitionBody<TOptions> = {\n      [STEP_NESTED_PIPELINE]: {\n        mode: \"single\" as const,\n        pipelineId: config.pipeline.id,\n        identity: config.pipeline.definition?.identity,\n        stepIds: config.pipeline.stepIds,\n      },\n      dependsOn: config.dependsOn,\n      optionalDependsOn: config.optionalDependsOn,\n      skipAfterFailureOf: config.skipAfterFailureOf,\n      name: config.name,\n      description: config.description,\n      dryRun: config.dryRun,\n      run: createSingleChildRunner(config),\n    };\n\n    const skip = config.skip;\n    if (skip !== undefined) {\n      definition.skip = skip;\n    }\n    return buildStep(id, definition);\n  };\n\n  function fromPipeline<\n    TId extends string,\n    TChildPipeline extends Pipeline<object, unknown>,\n    const TDeps extends readonly AnyStep<TOptions>[] = [],\n    const TOptionalDeps extends readonly AnyStep<TOptions>[] = [],\n  >(\n    id: TId,\n    definition: ChildPipelineStepDefinition<TOptions, TDeps, TOptionalDeps, TChildPipeline> & {\n      skip?: never;\n      mapResult?: undefined;\n    }\n  ): BuiltStep<TId, PipelineResultOf<TChildPipeline>, TOptions, TInputOptions>;\n  function fromPipeline<\n    TId extends string,\n    TChildPipeline extends Pipeline<object, unknown>,\n    TOut,\n    const TDeps extends readonly AnyStep<TOptions>[] = [],\n    const TOptionalDeps extends readonly AnyStep<TOptions>[] = [],\n  >(\n    id: TId,\n    definition: ChildPipelineStepDefinitionBase<TOptions, TDeps, TOptionalDeps, TChildPipeline> & {\n      skip?: never;\n      mapResult(\n        value: PipelineResultOf<TChildPipeline>,\n        result: PipelineRun<PipelineResultOf<TChildPipeline>>,\n        context: PipelineStepContext<TOptions>\n      ): TOut;\n    }\n  ): BuiltStep<TId, Awaited<TOut>, TOptions, TInputOptions>;\n  function fromPipeline<\n    TId extends string,\n    TChildPipeline extends Pipeline<object, unknown>,\n    const TDeps extends readonly AnyStep<TOptions>[] = [],\n    const TOptionalDeps extends readonly AnyStep<TOptions>[] = [],\n    TDecision extends StepSkipDecision<PipelineResultOf<TChildPipeline>> = StepSkipDecision<\n      PipelineResultOf<TChildPipeline>\n    >,\n  >(\n    id: TId,\n    definition: ChildPipelineStepDefinitionBase<TOptions, TDeps, TOptionalDeps, TChildPipeline> & {\n      skip:\n        | StepSkipPredicate<\n            TOptions,\n            TDeps,\n            TOptionalDeps,\n            PipelineResultOf<TChildPipeline>,\n            TDecision\n          >\n        | undefined;\n      mapResult?: undefined;\n    }\n  ): BuiltStep<\n    TId,\n    PolicySkippedOutput<PipelineResultOf<TChildPipeline>, TDecision>,\n    TOptions,\n    TInputOptions\n  >;\n  function fromPipeline<\n    TId extends string,\n    TChildPipeline extends Pipeline<object, unknown>,\n    TOut,\n    const TDeps extends readonly AnyStep<TOptions>[] = [],\n    const TOptionalDeps extends readonly AnyStep<TOptions>[] = [],\n    TDecision extends StepSkipDecision<NoInfer<Awaited<TOut>>> = StepSkipDecision<\n      NoInfer<Awaited<TOut>>\n    >,\n  >(\n    id: TId,\n    definition: ChildPipelineStepDefinitionBase<TOptions, TDeps, TOptionalDeps, TChildPipeline> & {\n      skip:\n        | StepSkipPredicate<TOptions, TDeps, TOptionalDeps, NoInfer<Awaited<TOut>>, TDecision>\n        | undefined;\n      mapResult(\n        value: PipelineResultOf<TChildPipeline>,\n        result: PipelineRun<PipelineResultOf<TChildPipeline>>,\n        context: PipelineStepContext<TOptions>\n      ): TOut;\n    }\n  ): BuiltStep<TId, PolicySkippedOutput<Awaited<TOut>, TDecision>, TOptions, TInputOptions>;\n  function fromPipeline(\n    id: string,\n    definition: Parameters<typeof buildPipelineStep>[1]\n  ): AnyStep<TOptions> {\n    return buildPipelineStep(id, definition);\n  }\n\n  const buildRemoteStep = (\n    id: string,\n    config: {\n      adapter: RemoteStepAdapter<object, unknown, unknown>;\n      mapInput(inputs: Record<string, unknown>, context: PipelineStepContext<TOptions>): unknown;\n      outputSchema: StandardSchemaV1;\n      dependsOn?: readonly AnyStep<TOptions>[];\n      optionalDependsOn?: readonly AnyStep<TOptions>[];\n      skipAfterFailureOf?: readonly AnyStep<TOptions>[];\n      name?: string;\n      description?: string;\n      dryRun?: \"skip\" | AnyStepDryRunHandler<TOptions>;\n      skip?: StepSkipPredicate<\n        TOptions,\n        readonly AnyStep<TOptions>[],\n        readonly AnyStep<TOptions>[],\n        unknown\n      >;\n    }\n  ) => {\n    const remote: NonNullable<PipelinePlanStep[\"remote\"]> = { engine: config.adapter.engine };\n    if (config.adapter.target !== undefined) remote.target = config.adapter.target;\n    const definition: StepDefinitionBody<TOptions> = {\n      [STEP_REMOTE]: remote,\n      dependsOn: config.dependsOn,\n      optionalDependsOn: config.optionalDependsOn,\n      skipAfterFailureOf: config.skipAfterFailureOf,\n      name: config.name,\n      description: config.description,\n      dryRun: config.dryRun,\n      outputSchema: config.outputSchema,\n      run: (inputs: Record<string, unknown>, context: PipelineStepContext<TOptions>) =>\n        config.adapter.invoke(config.mapInput(inputs, context), context),\n    };\n    const skip = config.skip;\n    if (skip !== undefined) {\n      definition.skip = skip;\n    }\n    return buildStep(id, definition);\n  };\n\n  function fromRemote<\n    TId extends string,\n    TSchema extends StandardSchemaV1,\n    TPayload,\n    const TDeps extends readonly AnyStep<TOptions>[] = [],\n    const TOptionalDeps extends readonly AnyStep<TOptions>[] = [],\n  >(\n    id: TId,\n    definition: RemoteStepDefinitionBase<TOptions, TDeps, TOptionalDeps, TPayload, TSchema> & {\n      skip?: never;\n    }\n  ): BuiltStep<TId, InferSchemaOutput<TSchema>, TOptions, TInputOptions, InferSchemaInput<TSchema>>;\n  function fromRemote<\n    TId extends string,\n    TSchema extends StandardSchemaV1,\n    TPayload,\n    const TDeps extends readonly AnyStep<TOptions>[] = [],\n    const TOptionalDeps extends readonly AnyStep<TOptions>[] = [],\n    TDecision extends StepSkipDecision<InferSchemaInput<TSchema>> = StepSkipDecision<\n      InferSchemaInput<TSchema>\n    >,\n  >(\n    id: TId,\n    definition: RemoteStepDefinitionBase<TOptions, TDeps, TOptionalDeps, TPayload, TSchema> & {\n      skip:\n        | StepSkipPredicate<TOptions, TDeps, TOptionalDeps, InferSchemaInput<TSchema>, TDecision>\n        | undefined;\n    }\n  ): BuiltStep<\n    TId,\n    PolicySkippedOutput<InferSchemaOutput<TSchema>, TDecision>,\n    TOptions,\n    TInputOptions,\n    InferSchemaInput<TSchema>\n  >;\n  function fromRemote(\n    id: string,\n    definition: Parameters<typeof buildRemoteStep>[1]\n  ): AnyStep<TOptions> {\n    return buildRemoteStep(id, definition);\n  }\n\n  const buildMappedPipelineStep = (\n    id: string,\n    config: MappedChildPipelineStepDefinition<\n      TOptions,\n      readonly AnyStep<TOptions>[],\n      readonly AnyStep<TOptions>[],\n      Pipeline<object, unknown>,\n      unknown\n    > & {\n      mapResult?: (\n        value: unknown,\n        result: PipelineRun<unknown>,\n        item: unknown,\n        index: number,\n        context: PipelineStepContext<TOptions>\n      ) => unknown;\n      skip?: StepSkipPredicate<\n        TOptions,\n        readonly AnyStep<TOptions>[],\n        readonly AnyStep<TOptions>[],\n        unknown\n      >;\n    }\n  ) => {\n    const definition: StepDefinitionBody<TOptions> = {\n      [STEP_NESTED_PIPELINE]: {\n        mode: \"for-each\" as const,\n        concurrency:\n          typeof config.concurrency === \"function\" ? \"dynamic\" : (config.concurrency ?? 1),\n        pipelineId: config.pipeline.id,\n        identity: config.pipeline.definition?.identity,\n        stepIds: config.pipeline.stepIds,\n      },\n      dependsOn: config.dependsOn,\n      optionalDependsOn: config.optionalDependsOn,\n      skipAfterFailureOf: config.skipAfterFailureOf,\n      name: config.name,\n      description: config.description,\n      dryRun: config.dryRun,\n      run: createMappedChildRunner(config),\n    };\n\n    const skip = config.skip;\n    if (skip !== undefined) {\n      definition.skip = skip;\n    }\n    return buildStep(id, definition);\n  };\n\n  function forEachPipeline<\n    TId extends string,\n    TChildPipeline extends Pipeline<object, unknown>,\n    TItem,\n    const TDeps extends readonly AnyStep<TOptions>[] = [],\n    const TOptionalDeps extends readonly AnyStep<TOptions>[] = [],\n  >(\n    id: TId,\n    definition: MappedChildPipelineStepDefinition<\n      TOptions,\n      TDeps,\n      TOptionalDeps,\n      TChildPipeline,\n      TItem\n    > & {\n      skip?: never;\n      mapResult?: undefined;\n    }\n  ): BuiltStep<TId, readonly PipelineResultOf<TChildPipeline>[], TOptions, TInputOptions>;\n  function forEachPipeline<\n    TId extends string,\n    TChildPipeline extends Pipeline<object, unknown>,\n    TItem,\n    TOut,\n    const TDeps extends readonly AnyStep<TOptions>[] = [],\n    const TOptionalDeps extends readonly AnyStep<TOptions>[] = [],\n  >(\n    id: TId,\n    definition: MappedChildPipelineStepDefinition<\n      TOptions,\n      TDeps,\n      TOptionalDeps,\n      TChildPipeline,\n      TItem\n    > & {\n      skip?: never;\n      mapResult(\n        value: PipelineResultOf<TChildPipeline>,\n        result: PipelineRun<PipelineResultOf<TChildPipeline>>,\n        item: TItem,\n        index: number,\n        context: PipelineStepContext<TOptions>\n      ): TOut;\n    }\n  ): BuiltStep<TId, readonly TOut[], TOptions, TInputOptions>;\n  function forEachPipeline<\n    TId extends string,\n    TChildPipeline extends Pipeline<object, unknown>,\n    TItem,\n    const TDeps extends readonly AnyStep<TOptions>[] = [],\n    const TOptionalDeps extends readonly AnyStep<TOptions>[] = [],\n    TDecision extends StepSkipDecision<readonly PipelineResultOf<TChildPipeline>[]> =\n      StepSkipDecision<readonly PipelineResultOf<TChildPipeline>[]>,\n  >(\n    id: TId,\n    definition: MappedChildPipelineStepDefinition<\n      TOptions,\n      TDeps,\n      TOptionalDeps,\n      TChildPipeline,\n      TItem\n    > & {\n      skip:\n        | StepSkipPredicate<\n            TOptions,\n            TDeps,\n            TOptionalDeps,\n            readonly PipelineResultOf<TChildPipeline>[],\n            TDecision\n          >\n        | undefined;\n      mapResult?: undefined;\n    }\n  ): BuiltStep<\n    TId,\n    PolicySkippedOutput<readonly PipelineResultOf<TChildPipeline>[], TDecision>,\n    TOptions,\n    TInputOptions\n  >;\n  function forEachPipeline<\n    TId extends string,\n    TChildPipeline extends Pipeline<object, unknown>,\n    TItem,\n    TOut,\n    const TDeps extends readonly AnyStep<TOptions>[] = [],\n    const TOptionalDeps extends readonly AnyStep<TOptions>[] = [],\n    TDecision extends StepSkipDecision<NoInfer<readonly TOut[]>> = StepSkipDecision<\n      NoInfer<readonly TOut[]>\n    >,\n  >(\n    id: TId,\n    definition: MappedChildPipelineStepDefinition<\n      TOptions,\n      TDeps,\n      TOptionalDeps,\n      TChildPipeline,\n      TItem\n    > & {\n      skip:\n        | StepSkipPredicate<TOptions, TDeps, TOptionalDeps, NoInfer<readonly TOut[]>, TDecision>\n        | undefined;\n      mapResult(\n        value: PipelineResultOf<TChildPipeline>,\n        result: PipelineRun<PipelineResultOf<TChildPipeline>>,\n        item: TItem,\n        index: number,\n        context: PipelineStepContext<TOptions>\n      ): TOut;\n    }\n  ): BuiltStep<TId, PolicySkippedOutput<readonly TOut[], TDecision>, TOptions, TInputOptions>;\n  function forEachPipeline(\n    id: string,\n    definition: Parameters<typeof buildMappedPipelineStep>[1]\n  ): AnyStep<TOptions> {\n    return buildMappedPipelineStep(id, definition);\n  }\n\n  const factory = {\n    step,\n    fromPipeline,\n    fromRemote,\n    forEachPipeline,\n  };\n\n  return factory;\n}\n"]}
+{"version":3,"file":"pipeline-steps.js","sourceRoot":"","sources":["../../src/core/pipeline-steps.ts"],"names":[],"mappings":"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","sourcesContent":["import {\n  type ArtifactLoader,\n  type ArtifactSaver,\n  type ArtifactResult,\n} from \"./pipeline-artifacts.js\";\nimport { createMappedChildRunner, createSingleChildRunner } from \"./child-execution.js\";\nimport { createIterationRunner, type IterationDecision, type IterationState } from \"./iteration.js\";\nimport type { ToMappedChildStepProgressOptions } from \"./mapped-child-progress.js\";\nimport {\n  STEP_NESTED_PIPELINE,\n  STEP_OPTIONS_SCHEMA,\n  STEP_REMOTE,\n} from \"./pipeline-step-metadata.js\";\nimport type {\n  InferSchemaInput,\n  InferSchemaOutput,\n  Pipeline,\n  PipelineExecutionContext,\n  PipelinePlanStep,\n  PipelineRun,\n  PipelineRunControls,\n  PipelineStepContext,\n  RemoteStepAdapter,\n  StandardSchemaV1,\n  StepSkipDecision,\n} from \"./pipeline-types.js\";\n\n/**\n * A step's dependencies are references to the dependency's own step object, not string ids\n * into a hand-maintained output-type map. This buys two things no amount of extra generics\n * on a string-keyed design could:\n *  - a step used before its dependency exists is a compile error (JS temporal dead zone on\n *    `const`), so out-of-order and self/cyclic dependencies are caught by the language, not\n *    a bespoke runtime check\n *  - each step only ever states its own id/deps; the output-type map is derived, never\n *    restated, and callers of `definePipeline`/`createSteps` never write out its generics\n */\ntype AnyStepDryRunHandler<TOptions extends object> = {\n  bivarianceHack(\n    inputs: Record<string, unknown>,\n    context: PipelineStepContext<TOptions>\n  ): unknown | Promise<unknown>;\n}[\"bivarianceHack\"];\n\n/** Runtime shape shared by every declared pipeline step. */\nexport interface AnyStep<TOptions extends object = object> {\n  readonly [STEP_NESTED_PIPELINE]?: NonNullable<PipelinePlanStep[\"nestedPipeline\"]>;\n  readonly [STEP_REMOTE]?: NonNullable<PipelinePlanStep[\"remote\"]>;\n  readonly [STEP_OPTIONS_SCHEMA]?: StandardSchemaV1;\n  readonly id: string;\n  readonly dependsOn?: readonly AnyStep<TOptions>[];\n  readonly optionalDependsOn?: readonly AnyStep<TOptions>[];\n  readonly skipAfterFailureOf?: readonly AnyStep<TOptions>[];\n  /** Optional human-facing display name. Stable machine identity remains `id`. */\n  readonly name?: string;\n  readonly description?: string;\n  /**\n   * Dry-run policy. Omitted runs the normal handler, `\"skip\"` structurally\n   * skips it, and a handler substitutes for `run` while preserving its output.\n   */\n  readonly dryRun?: \"skip\" | AnyStepDryRunHandler<TOptions>;\n  /** Optional Standard Schema for values published by this step. */\n  readonly outputSchema?: StandardSchemaV1;\n  /**\n   * Optional runtime skip. Return a non-empty reason (or `{ reason, value }`) to\n   * skip without calling `run`. Policy skips unlock dependents; structural skips\n   * (dry-run, filtered, …) do not use this hook.\n   */\n  skip?(\n    inputs: Record<string, unknown>,\n    context: PipelineExecutionContext<TOptions>\n  ): StepSkipDecision | Promise<StepSkipDecision>;\n  run(inputs: Record<string, unknown>, context: PipelineStepContext<TOptions>): unknown;\n}\n\n/** The step fields that `buildStep` merges onto the id-bearing shell. */\ntype StepDefinitionBody<TOptions extends object> = Omit<AnyStep<TOptions>, \"id\">;\n\n/** Typed pipeline step carrying its stable ID, output, and option types. */\nexport interface Step<\n  TId extends string,\n  TOut,\n  TOptions extends object,\n  TInputOptions extends object = TOptions,\n  TRunOut = TOut,\n  TOptionsSchema extends StandardSchemaV1 | undefined = StandardSchemaV1 | undefined,\n> extends AnyStep<TOptions> {\n  readonly [STEP_OPTIONS_SCHEMA]?: TOptionsSchema;\n  readonly id: TId;\n  run(\n    inputs: Record<string, unknown>,\n    context: PipelineStepContext<TOptions>\n  ): TRunOut | Promise<TRunOut>;\n  /** Type-only: carries this step's output type for sibling inference. Never set at runtime. */\n  readonly __outputType?: TOut;\n  /** Type-only: carries pre-validation run options for pipeline call-site inference. */\n  readonly __inputOptionsType?: TInputOptions;\n}\n\n/**\n * Extract a step's output type for dependency typing.\n * Prefer matching `Step<…, TOut, …>` over `{ __outputType?: infer T }`: optional-property\n * inference collapses `TOut | undefined` to `TOut`, which hides policy-skip widening.\n */\nexport type StepOutput<S> =\n  S extends Step<string, infer TOut, infer _TOptions, infer _TInputOptions, infer _TRunOut>\n    ? TOut\n    : never;\n\ninterface StepToken {\n  readonly id: string;\n  readonly __outputType?: unknown;\n}\n\ntype RequiredInputs<TDeps extends readonly StepToken[]> = {\n  [S in TDeps[number] as S[\"id\"]]: StepOutput<S>;\n};\n\ntype OptionalInputs<TDeps extends readonly StepToken[]> = {\n  [S in TDeps[number] as S[\"id\"]]?: StepOutput<S>;\n};\n\ntype PipelineResultOf<TPipeline> =\n  TPipeline extends Pipeline<object, infer TResult, infer _TStepId, infer _TTargetId>\n    ? TResult\n    : never;\n\ntype PipelineOptionsOf<TPipeline> =\n  TPipeline extends Pipeline<infer TOptions, unknown, infer _TStepId, infer _TTargetId>\n    ? TOptions\n    : never;\n\ntype PipelineRunControlsOf<TPipeline> =\n  TPipeline extends Pipeline<infer _TOptions, unknown, infer TStepId, infer TTargetId>\n    ? PipelineRunControls<TStepId, TTargetId>\n    : never;\n\ntype ChildPipelineStepDefinitionBase<\n  TParentOptions extends object,\n  TDeps extends readonly AnyStep<TParentOptions>[],\n  TOptionalDeps extends readonly AnyStep<TParentOptions>[],\n  TChildPipeline extends Pipeline<object, unknown>,\n> = {\n  pipeline: TChildPipeline;\n  dependsOn?: TDeps;\n  optionalDependsOn?: TOptionalDeps;\n  skipAfterFailureOf?: readonly AnyStep<TParentOptions>[];\n  name?: string;\n  description?: string;\n  dryRun?: \"skip\";\n  controls?:\n    | PipelineRunControlsOf<TChildPipeline>\n    | ((\n        inputs: RequiredInputs<TDeps> & OptionalInputs<TOptionalDeps>,\n        context: PipelineExecutionContext<TParentOptions>\n      ) => PipelineRunControlsOf<TChildPipeline>);\n} & ([TParentOptions] extends [PipelineOptionsOf<NoInfer<TChildPipeline>>]\n  ? {\n      mapOptions?(\n        inputs: RequiredInputs<TDeps> & OptionalInputs<TOptionalDeps>,\n        context: PipelineExecutionContext<TParentOptions>\n      ): PipelineOptionsOf<TChildPipeline>;\n    }\n  : {\n      mapOptions(\n        inputs: RequiredInputs<TDeps> & OptionalInputs<TOptionalDeps>,\n        context: PipelineExecutionContext<TParentOptions>\n      ): PipelineOptionsOf<TChildPipeline>;\n    });\n\n/** Child step without policy skip (dependents see the full child result type). */\ntype ChildPipelineStepDefinition<\n  TParentOptions extends object,\n  TDeps extends readonly AnyStep<TParentOptions>[],\n  TOptionalDeps extends readonly AnyStep<TParentOptions>[],\n  TChildPipeline extends Pipeline<object, unknown>,\n> = ChildPipelineStepDefinitionBase<TParentOptions, TDeps, TOptionalDeps, TChildPipeline>;\n\n/**\n * Presentation options for opaque `forEachPipeline` progress.\n * Defaults are domain-neutral (`N/M items · K running · key/step`).\n * Override `formatMessage` when a domain wants its own noun (images, shards, …).\n */\nexport type MappedChildProgressOptions = ToMappedChildStepProgressOptions;\n\ntype MappedChildPipelineStepDefinition<\n  TParentOptions extends object,\n  TDeps extends readonly AnyStep<TParentOptions>[],\n  TOptionalDeps extends readonly AnyStep<TParentOptions>[],\n  TChildPipeline extends Pipeline<object, unknown>,\n  TItem,\n> = {\n  pipeline: TChildPipeline;\n  dependsOn?: TDeps;\n  optionalDependsOn?: TOptionalDeps;\n  skipAfterFailureOf?: readonly AnyStep<TParentOptions>[];\n  name?: string;\n  description?: string;\n  dryRun?: \"skip\";\n  items(\n    inputs: RequiredInputs<TDeps> & OptionalInputs<TOptionalDeps>,\n    context: PipelineExecutionContext<TParentOptions>\n  ): readonly TItem[] | Promise<readonly TItem[]>;\n  key(item: TItem, index: number): string;\n  concurrency?:\n    | number\n    | ((\n        inputs: RequiredInputs<TDeps> & OptionalInputs<TOptionalDeps>,\n        context: PipelineExecutionContext<TParentOptions>\n      ) => number);\n  /**\n   * How the opaque parent step reports live fan-out progress.\n   * Purely presentational — does not change scheduling or results.\n   */\n  progress?: MappedChildProgressOptions;\n  controls?:\n    | PipelineRunControlsOf<TChildPipeline>\n    | ((\n        item: TItem,\n        index: number,\n        inputs: RequiredInputs<TDeps> & OptionalInputs<TOptionalDeps>,\n        context: PipelineExecutionContext<TParentOptions>\n      ) => PipelineRunControlsOf<TChildPipeline>);\n  mapOptions(\n    item: TItem,\n    index: number,\n    inputs: RequiredInputs<TDeps> & OptionalInputs<TOptionalDeps>,\n    context: PipelineExecutionContext<TParentOptions>\n  ): PipelineOptionsOf<TChildPipeline>;\n};\n\ntype StepSkipPredicate<\n  TOptions extends object,\n  TDeps extends readonly AnyStep<TOptions>[],\n  TOptionalDeps extends readonly AnyStep<TOptions>[],\n  TOut,\n  TDecision extends StepSkipDecision<TOut> = StepSkipDecision<TOut>,\n> = (\n  inputs: RequiredInputs<TDeps> & OptionalInputs<TOptionalDeps>,\n  context: PipelineExecutionContext<TOptions>\n) => TDecision | Promise<TDecision>;\n\ntype PolicySkippedOutput<TOut, TDecision> = [\n  Exclude<Awaited<TDecision>, false | null | undefined>,\n] extends [{ reason: string; value: unknown }]\n  ? TOut\n  : TOut | undefined;\n\ntype StepDryRunPolicy<\n  TOptions extends object,\n  TDeps extends readonly AnyStep<TOptions>[],\n  TOptionalDeps extends readonly AnyStep<TOptions>[],\n  TOut,\n> =\n  | \"skip\"\n  | ((\n      inputs: RequiredInputs<TDeps> & OptionalInputs<TOptionalDeps>,\n      context: PipelineStepContext<TOptions>\n    ) => TOut | Promise<TOut>);\n\ntype PlainStepFields<\n  TOptions extends object,\n  TDeps extends readonly AnyStep<TOptions>[],\n  TOptionalDeps extends readonly AnyStep<TOptions>[],\n  TOut,\n> = {\n  dependsOn?: TDeps;\n  optionalDependsOn?: TOptionalDeps;\n  skipAfterFailureOf?: readonly AnyStep<TOptions>[];\n  name?: string;\n  description?: string;\n  dryRun?: StepDryRunPolicy<TOptions, TDeps, TOptionalDeps, TOut>;\n  outputSchema?: never;\n  run(\n    inputs: RequiredInputs<TDeps> & OptionalInputs<TOptionalDeps>,\n    context: PipelineStepContext<TOptions>\n  ): TOut | Promise<TOut>;\n};\n\ntype SchemaStepFields<\n  TOptions extends object,\n  TDeps extends readonly AnyStep<TOptions>[],\n  TOptionalDeps extends readonly AnyStep<TOptions>[],\n  TSchema extends StandardSchemaV1,\n> = Omit<\n  PlainStepFields<TOptions, TDeps, TOptionalDeps, InferSchemaInput<TSchema>>,\n  \"outputSchema\"\n> & {\n  outputSchema: TSchema;\n};\n\ntype RemoteStepDefinitionBase<\n  TParentOptions extends object,\n  TDeps extends readonly AnyStep<TParentOptions>[],\n  TOptionalDeps extends readonly AnyStep<TParentOptions>[],\n  TPayload,\n  TSchema extends StandardSchemaV1,\n> = {\n  adapter: RemoteStepAdapter<TParentOptions, TPayload, InferSchemaInput<TSchema>>;\n  mapInput(\n    inputs: RequiredInputs<TDeps> & OptionalInputs<TOptionalDeps>,\n    context: PipelineStepContext<TParentOptions>\n  ): TPayload;\n  outputSchema: TSchema;\n  dependsOn?: TDeps;\n  optionalDependsOn?: TOptionalDeps;\n  skipAfterFailureOf?: readonly AnyStep<TParentOptions>[];\n  name?: string;\n  description?: string;\n  dryRun?: StepDryRunPolicy<TParentOptions, TDeps, TOptionalDeps, InferSchemaInput<TSchema>>;\n};\n\n/** Step constructors scoped to one pipeline's domain option types. */\ntype StepFactory<\n  TOptions extends object,\n  TInputOptions extends object = TOptions,\n  TOptionsSchema extends StandardSchemaV1 | undefined = undefined,\n> = ReturnType<typeof createStepFactory<TOptions, TInputOptions, TOptionsSchema>>;\n\n/**\n * Create typed step constructors for one pipeline definition.\n * Returns a step factory scoped to one pipeline's domain options. Pass built-in\n * run controls as the second argument to `run` / `runOrThrow`, or through a\n * child step's separate `controls` field.\n */\nexport function createSteps<TOptions extends object = {}>(): StepFactory<TOptions>;\nexport function createSteps<const TSchema extends StandardSchemaV1<object, object> | undefined>(\n  optionsSchema: TSchema\n): StepFactory<\n  TSchema extends StandardSchemaV1 ? InferSchemaOutput<TSchema> : object,\n  TSchema extends StandardSchemaV1 ? InferSchemaInput<TSchema> : object,\n  TSchema\n>;\nexport function createSteps(\n  optionsSchema?: StandardSchemaV1<object, object>\n): StepFactory<object, object, StandardSchemaV1 | undefined> {\n  return createStepFactory<object, object, StandardSchemaV1 | undefined>(optionsSchema);\n}\n\nfunction createStepFactory<\n  TOptions extends object,\n  TInputOptions extends object = TOptions,\n  TOptionsSchema extends StandardSchemaV1 | undefined = undefined,\n>(optionsSchema?: TOptionsSchema) {\n  // Preserve the runtime schema in the step type so adapters cannot infer flags\n  // from erased TypeScript-only options.\n  type BuiltStep<\n    TId extends string,\n    TOut,\n    TStepOptions extends object,\n    TInput extends object,\n    TRunOut = TOut,\n  > = TOptionsSchema extends StandardSchemaV1\n    ? Step<TId, TOut, TStepOptions, TInput, TRunOut, TOptionsSchema>\n    : Step<TId, TOut, TStepOptions, TInput, TRunOut>;\n  const buildStep = (id: string, definition: StepDefinitionBody<TOptions>): AnyStep<TOptions> => {\n    const built: AnyStep<TOptions> = { id, ...definition };\n    if (optionsSchema) {\n      Object.defineProperty(built, STEP_OPTIONS_SCHEMA, { value: optionsSchema });\n    }\n    return built;\n  };\n\n  function step<\n    TId extends string,\n    TSchema extends StandardSchemaV1,\n    const TDeps extends readonly AnyStep<TOptions>[] = [],\n    const TOptionalDeps extends readonly AnyStep<TOptions>[] = [],\n    TDecision extends StepSkipDecision<InferSchemaInput<TSchema>> = StepSkipDecision<\n      InferSchemaInput<TSchema>\n    >,\n  >(\n    id: TId,\n    definition: SchemaStepFields<TOptions, TDeps, TOptionalDeps, TSchema> & {\n      skip:\n        | StepSkipPredicate<TOptions, TDeps, TOptionalDeps, InferSchemaInput<TSchema>, TDecision>\n        | undefined;\n    }\n  ): BuiltStep<\n    TId,\n    PolicySkippedOutput<InferSchemaOutput<TSchema>, TDecision>,\n    TOptions,\n    TInputOptions,\n    InferSchemaInput<TSchema>\n  >;\n  function step<\n    TId extends string,\n    const TDeps extends readonly AnyStep<TOptions>[] = [],\n    const TOptionalDeps extends readonly AnyStep<TOptions>[] = [],\n    TOut = unknown,\n    TDecision extends StepSkipDecision<NoInfer<TOut>> = StepSkipDecision<NoInfer<TOut>>,\n  >(\n    id: TId,\n    definition: PlainStepFields<TOptions, TDeps, TOptionalDeps, TOut> & {\n      skip: StepSkipPredicate<TOptions, TDeps, TOptionalDeps, NoInfer<TOut>, TDecision> | undefined;\n    }\n  ): BuiltStep<TId, PolicySkippedOutput<TOut, TDecision>, TOptions, TInputOptions>;\n  function step<\n    TId extends string,\n    TSchema extends StandardSchemaV1,\n    const TDeps extends readonly AnyStep<TOptions>[] = [],\n    const TOptionalDeps extends readonly AnyStep<TOptions>[] = [],\n  >(\n    id: TId,\n    definition: SchemaStepFields<TOptions, TDeps, TOptionalDeps, TSchema> & { skip?: never }\n  ): BuiltStep<TId, InferSchemaOutput<TSchema>, TOptions, TInputOptions, InferSchemaInput<TSchema>>;\n  function step<\n    TId extends string,\n    const TDeps extends readonly AnyStep<TOptions>[] = [],\n    const TOptionalDeps extends readonly AnyStep<TOptions>[] = [],\n    TOut = unknown,\n  >(\n    id: TId,\n    definition: PlainStepFields<TOptions, TDeps, TOptionalDeps, TOut> & { skip?: never }\n  ): BuiltStep<TId, TOut, TOptions, TInputOptions>;\n  function step(id: string, definition: StepDefinitionBody<TOptions>): AnyStep<TOptions> {\n    return buildStep(id, definition);\n  }\n\n  /** Read an artifact as an ordinary step, publishing only its typed value. */\n  function loadArtifact<\n    TId extends string,\n    const TDeps extends readonly AnyStep<TOptions>[] = [],\n    const TOptionalDeps extends readonly AnyStep<TOptions>[] = [],\n    TValue = unknown,\n  >(\n    id: TId,\n    definition: Omit<\n      PlainStepFields<TOptions, TDeps, TOptionalDeps, ArtifactResult<TValue>>,\n      \"run\"\n    > & {\n      load: ArtifactLoader<RequiredInputs<TDeps> & OptionalInputs<TOptionalDeps>, TValue, TOptions>;\n    }\n  ): BuiltStep<TId, TValue, TOptions, TInputOptions> {\n    const { load, dryRun, ...fields } = definition;\n    const wrap =\n      (handler: typeof load) =>\n      async (\n        inputs: RequiredInputs<TDeps> & OptionalInputs<TOptionalDeps>,\n        context: PipelineStepContext<TOptions>\n      ) => {\n        const loaded = await handler(inputs, context);\n        context.recordArtifact({ operation: \"read\", artifact: loaded.artifact });\n        return loaded.value;\n      };\n    return step(id, {\n      ...fields,\n      run: wrap(load),\n      dryRun: typeof dryRun === \"function\" ? wrap(dryRun) : dryRun,\n    });\n  }\n\n  /** Write an artifact as an ordinary step. Dry runs skip unless a preview is supplied. */\n  function saveArtifact<\n    TId extends string,\n    const TDeps extends readonly AnyStep<TOptions>[] = [],\n    const TOptionalDeps extends readonly AnyStep<TOptions>[] = [],\n    TValue = unknown,\n  >(\n    id: TId,\n    definition: Omit<\n      PlainStepFields<TOptions, TDeps, TOptionalDeps, ArtifactResult<TValue>>,\n      \"run\"\n    > & {\n      save: ArtifactSaver<RequiredInputs<TDeps> & OptionalInputs<TOptionalDeps>, TValue, TOptions>;\n    }\n  ): BuiltStep<TId, TValue, TOptions, TInputOptions> {\n    const { save, dryRun, ...fields } = definition;\n    const wrap =\n      (handler: typeof save) =>\n      async (\n        inputs: RequiredInputs<TDeps> & OptionalInputs<TOptionalDeps>,\n        context: PipelineStepContext<TOptions>\n      ) => {\n        const saved = await handler(inputs, context);\n        context.recordArtifact({ operation: \"write\", artifact: saved.artifact });\n        return saved.value;\n      };\n    return step(id, {\n      ...fields,\n      run: wrap(save),\n      dryRun: typeof dryRun === \"function\" ? wrap(dryRun) : \"skip\",\n    });\n  }\n\n  const buildPipelineStep = (\n    id: string,\n    config: ChildPipelineStepDefinitionBase<\n      TOptions,\n      readonly AnyStep<TOptions>[],\n      readonly AnyStep<TOptions>[],\n      Pipeline<object, unknown>\n    > & {\n      skip?: StepSkipPredicate<\n        TOptions,\n        readonly AnyStep<TOptions>[],\n        readonly AnyStep<TOptions>[],\n        unknown\n      >;\n      mapResult?: (\n        value: unknown,\n        result: PipelineRun<unknown>,\n        context: PipelineStepContext<TOptions>\n      ) => unknown;\n    }\n  ) => {\n    const definition: StepDefinitionBody<TOptions> = {\n      [STEP_NESTED_PIPELINE]: {\n        mode: \"single\" as const,\n        pipelineId: config.pipeline.id,\n        identity: config.pipeline.definition?.identity,\n        stepIds: config.pipeline.stepIds,\n      },\n      dependsOn: config.dependsOn,\n      optionalDependsOn: config.optionalDependsOn,\n      skipAfterFailureOf: config.skipAfterFailureOf,\n      name: config.name,\n      description: config.description,\n      dryRun: config.dryRun,\n      run: createSingleChildRunner(config),\n    };\n\n    const skip = config.skip;\n    if (skip !== undefined) {\n      definition.skip = skip;\n    }\n    return buildStep(id, definition);\n  };\n\n  function fromPipeline<\n    TId extends string,\n    TChildPipeline extends Pipeline<object, unknown>,\n    const TDeps extends readonly AnyStep<TOptions>[] = [],\n    const TOptionalDeps extends readonly AnyStep<TOptions>[] = [],\n  >(\n    id: TId,\n    definition: ChildPipelineStepDefinition<TOptions, TDeps, TOptionalDeps, TChildPipeline> & {\n      skip?: never;\n      mapResult?: undefined;\n    }\n  ): BuiltStep<TId, PipelineResultOf<TChildPipeline>, TOptions, TInputOptions>;\n  function fromPipeline<\n    TId extends string,\n    TChildPipeline extends Pipeline<object, unknown>,\n    TOut,\n    const TDeps extends readonly AnyStep<TOptions>[] = [],\n    const TOptionalDeps extends readonly AnyStep<TOptions>[] = [],\n  >(\n    id: TId,\n    definition: ChildPipelineStepDefinitionBase<TOptions, TDeps, TOptionalDeps, TChildPipeline> & {\n      skip?: never;\n      mapResult(\n        value: PipelineResultOf<TChildPipeline>,\n        result: PipelineRun<PipelineResultOf<TChildPipeline>>,\n        context: PipelineStepContext<TOptions>\n      ): TOut;\n    }\n  ): BuiltStep<TId, Awaited<TOut>, TOptions, TInputOptions>;\n  function fromPipeline<\n    TId extends string,\n    TChildPipeline extends Pipeline<object, unknown>,\n    const TDeps extends readonly AnyStep<TOptions>[] = [],\n    const TOptionalDeps extends readonly AnyStep<TOptions>[] = [],\n    TDecision extends StepSkipDecision<PipelineResultOf<TChildPipeline>> = StepSkipDecision<\n      PipelineResultOf<TChildPipeline>\n    >,\n  >(\n    id: TId,\n    definition: ChildPipelineStepDefinitionBase<TOptions, TDeps, TOptionalDeps, TChildPipeline> & {\n      skip:\n        | StepSkipPredicate<\n            TOptions,\n            TDeps,\n            TOptionalDeps,\n            PipelineResultOf<TChildPipeline>,\n            TDecision\n          >\n        | undefined;\n      mapResult?: undefined;\n    }\n  ): BuiltStep<\n    TId,\n    PolicySkippedOutput<PipelineResultOf<TChildPipeline>, TDecision>,\n    TOptions,\n    TInputOptions\n  >;\n  function fromPipeline<\n    TId extends string,\n    TChildPipeline extends Pipeline<object, unknown>,\n    TOut,\n    const TDeps extends readonly AnyStep<TOptions>[] = [],\n    const TOptionalDeps extends readonly AnyStep<TOptions>[] = [],\n    TDecision extends StepSkipDecision<NoInfer<Awaited<TOut>>> = StepSkipDecision<\n      NoInfer<Awaited<TOut>>\n    >,\n  >(\n    id: TId,\n    definition: ChildPipelineStepDefinitionBase<TOptions, TDeps, TOptionalDeps, TChildPipeline> & {\n      skip:\n        | StepSkipPredicate<TOptions, TDeps, TOptionalDeps, NoInfer<Awaited<TOut>>, TDecision>\n        | undefined;\n      mapResult(\n        value: PipelineResultOf<TChildPipeline>,\n        result: PipelineRun<PipelineResultOf<TChildPipeline>>,\n        context: PipelineStepContext<TOptions>\n      ): TOut;\n    }\n  ): BuiltStep<TId, PolicySkippedOutput<Awaited<TOut>, TDecision>, TOptions, TInputOptions>;\n  function fromPipeline(\n    id: string,\n    definition: Parameters<typeof buildPipelineStep>[1]\n  ): AnyStep<TOptions> {\n    return buildPipelineStep(id, definition);\n  }\n\n  const buildRemoteStep = (\n    id: string,\n    config: {\n      adapter: RemoteStepAdapter<object, unknown, unknown>;\n      mapInput(inputs: Record<string, unknown>, context: PipelineStepContext<TOptions>): unknown;\n      outputSchema: StandardSchemaV1;\n      dependsOn?: readonly AnyStep<TOptions>[];\n      optionalDependsOn?: readonly AnyStep<TOptions>[];\n      skipAfterFailureOf?: readonly AnyStep<TOptions>[];\n      name?: string;\n      description?: string;\n      dryRun?: \"skip\" | AnyStepDryRunHandler<TOptions>;\n      skip?: StepSkipPredicate<\n        TOptions,\n        readonly AnyStep<TOptions>[],\n        readonly AnyStep<TOptions>[],\n        unknown\n      >;\n    }\n  ) => {\n    const remote: NonNullable<PipelinePlanStep[\"remote\"]> = { engine: config.adapter.engine };\n    if (config.adapter.target !== undefined) remote.target = config.adapter.target;\n    const definition: StepDefinitionBody<TOptions> = {\n      [STEP_REMOTE]: remote,\n      dependsOn: config.dependsOn,\n      optionalDependsOn: config.optionalDependsOn,\n      skipAfterFailureOf: config.skipAfterFailureOf,\n      name: config.name,\n      description: config.description,\n      dryRun: config.dryRun,\n      outputSchema: config.outputSchema,\n      run: (inputs: Record<string, unknown>, context: PipelineStepContext<TOptions>) =>\n        config.adapter.invoke(config.mapInput(inputs, context), context),\n    };\n    const skip = config.skip;\n    if (skip !== undefined) {\n      definition.skip = skip;\n    }\n    return buildStep(id, definition);\n  };\n\n  function fromRemote<\n    TId extends string,\n    TSchema extends StandardSchemaV1,\n    TPayload,\n    const TDeps extends readonly AnyStep<TOptions>[] = [],\n    const TOptionalDeps extends readonly AnyStep<TOptions>[] = [],\n  >(\n    id: TId,\n    definition: RemoteStepDefinitionBase<TOptions, TDeps, TOptionalDeps, TPayload, TSchema> & {\n      skip?: never;\n    }\n  ): BuiltStep<TId, InferSchemaOutput<TSchema>, TOptions, TInputOptions, InferSchemaInput<TSchema>>;\n  function fromRemote<\n    TId extends string,\n    TSchema extends StandardSchemaV1,\n    TPayload,\n    const TDeps extends readonly AnyStep<TOptions>[] = [],\n    const TOptionalDeps extends readonly AnyStep<TOptions>[] = [],\n    TDecision extends StepSkipDecision<InferSchemaInput<TSchema>> = StepSkipDecision<\n      InferSchemaInput<TSchema>\n    >,\n  >(\n    id: TId,\n    definition: RemoteStepDefinitionBase<TOptions, TDeps, TOptionalDeps, TPayload, TSchema> & {\n      skip:\n        | StepSkipPredicate<TOptions, TDeps, TOptionalDeps, InferSchemaInput<TSchema>, TDecision>\n        | undefined;\n    }\n  ): BuiltStep<\n    TId,\n    PolicySkippedOutput<InferSchemaOutput<TSchema>, TDecision>,\n    TOptions,\n    TInputOptions,\n    InferSchemaInput<TSchema>\n  >;\n  function fromRemote(\n    id: string,\n    definition: Parameters<typeof buildRemoteStep>[1]\n  ): AnyStep<TOptions> {\n    return buildRemoteStep(id, definition);\n  }\n\n  const buildMappedPipelineStep = (\n    id: string,\n    config: MappedChildPipelineStepDefinition<\n      TOptions,\n      readonly AnyStep<TOptions>[],\n      readonly AnyStep<TOptions>[],\n      Pipeline<object, unknown>,\n      unknown\n    > & {\n      mapResult?: (\n        value: unknown,\n        result: PipelineRun<unknown>,\n        item: unknown,\n        index: number,\n        context: PipelineStepContext<TOptions>\n      ) => unknown;\n      skip?: StepSkipPredicate<\n        TOptions,\n        readonly AnyStep<TOptions>[],\n        readonly AnyStep<TOptions>[],\n        unknown\n      >;\n    }\n  ) => {\n    const definition: StepDefinitionBody<TOptions> = {\n      [STEP_NESTED_PIPELINE]: {\n        mode: \"for-each\" as const,\n        concurrency:\n          typeof config.concurrency === \"function\" ? \"dynamic\" : (config.concurrency ?? 1),\n        pipelineId: config.pipeline.id,\n        identity: config.pipeline.definition?.identity,\n        stepIds: config.pipeline.stepIds,\n      },\n      dependsOn: config.dependsOn,\n      optionalDependsOn: config.optionalDependsOn,\n      skipAfterFailureOf: config.skipAfterFailureOf,\n      name: config.name,\n      description: config.description,\n      dryRun: config.dryRun,\n      run: createMappedChildRunner(config),\n    };\n\n    const skip = config.skip;\n    if (skip !== undefined) {\n      definition.skip = skip;\n    }\n    return buildStep(id, definition);\n  };\n\n  function forEachPipeline<\n    TId extends string,\n    TChildPipeline extends Pipeline<object, unknown>,\n    TItem,\n    const TDeps extends readonly AnyStep<TOptions>[] = [],\n    const TOptionalDeps extends readonly AnyStep<TOptions>[] = [],\n  >(\n    id: TId,\n    definition: MappedChildPipelineStepDefinition<\n      TOptions,\n      TDeps,\n      TOptionalDeps,\n      TChildPipeline,\n      TItem\n    > & {\n      skip?: never;\n      mapResult?: undefined;\n    }\n  ): BuiltStep<TId, readonly PipelineResultOf<TChildPipeline>[], TOptions, TInputOptions>;\n  function forEachPipeline<\n    TId extends string,\n    TChildPipeline extends Pipeline<object, unknown>,\n    TItem,\n    TOut,\n    const TDeps extends readonly AnyStep<TOptions>[] = [],\n    const TOptionalDeps extends readonly AnyStep<TOptions>[] = [],\n  >(\n    id: TId,\n    definition: MappedChildPipelineStepDefinition<\n      TOptions,\n      TDeps,\n      TOptionalDeps,\n      TChildPipeline,\n      TItem\n    > & {\n      skip?: never;\n      mapResult(\n        value: PipelineResultOf<TChildPipeline>,\n        result: PipelineRun<PipelineResultOf<TChildPipeline>>,\n        item: TItem,\n        index: number,\n        context: PipelineStepContext<TOptions>\n      ): TOut;\n    }\n  ): BuiltStep<TId, readonly TOut[], TOptions, TInputOptions>;\n  function forEachPipeline<\n    TId extends string,\n    TChildPipeline extends Pipeline<object, unknown>,\n    TItem,\n    const TDeps extends readonly AnyStep<TOptions>[] = [],\n    const TOptionalDeps extends readonly AnyStep<TOptions>[] = [],\n    TDecision extends StepSkipDecision<readonly PipelineResultOf<TChildPipeline>[]> =\n      StepSkipDecision<readonly PipelineResultOf<TChildPipeline>[]>,\n  >(\n    id: TId,\n    definition: MappedChildPipelineStepDefinition<\n      TOptions,\n      TDeps,\n      TOptionalDeps,\n      TChildPipeline,\n      TItem\n    > & {\n      skip:\n        | StepSkipPredicate<\n            TOptions,\n            TDeps,\n            TOptionalDeps,\n            readonly PipelineResultOf<TChildPipeline>[],\n            TDecision\n          >\n        | undefined;\n      mapResult?: undefined;\n    }\n  ): BuiltStep<\n    TId,\n    PolicySkippedOutput<readonly PipelineResultOf<TChildPipeline>[], TDecision>,\n    TOptions,\n    TInputOptions\n  >;\n  function forEachPipeline<\n    TId extends string,\n    TChildPipeline extends Pipeline<object, unknown>,\n    TItem,\n    TOut,\n    const TDeps extends readonly AnyStep<TOptions>[] = [],\n    const TOptionalDeps extends readonly AnyStep<TOptions>[] = [],\n    TDecision extends StepSkipDecision<NoInfer<readonly TOut[]>> = StepSkipDecision<\n      NoInfer<readonly TOut[]>\n    >,\n  >(\n    id: TId,\n    definition: MappedChildPipelineStepDefinition<\n      TOptions,\n      TDeps,\n      TOptionalDeps,\n      TChildPipeline,\n      TItem\n    > & {\n      skip:\n        | StepSkipPredicate<TOptions, TDeps, TOptionalDeps, NoInfer<readonly TOut[]>, TDecision>\n        | undefined;\n      mapResult(\n        value: PipelineResultOf<TChildPipeline>,\n        result: PipelineRun<PipelineResultOf<TChildPipeline>>,\n        item: TItem,\n        index: number,\n        context: PipelineStepContext<TOptions>\n      ): TOut;\n    }\n  ): BuiltStep<TId, PolicySkippedOutput<readonly TOut[], TDecision>, TOptions, TInputOptions>;\n  function forEachPipeline(\n    id: string,\n    definition: Parameters<typeof buildMappedPipelineStep>[1]\n  ): AnyStep<TOptions> {\n    return buildMappedPipelineStep(id, definition);\n  }\n\n  function iteratePipeline<\n    const TId extends string,\n    TChild extends Pipeline<object, unknown>,\n    TState,\n    TResult,\n    const TDeps extends readonly AnyStep<TOptions>[] = [],\n  >(\n    id: TId,\n    definition: {\n      pipeline: TChild;\n      name?: string;\n      description?: string;\n      dependsOn?: TDeps;\n      maxIterations: number;\n      dryRun?: \"skip\";\n      controls?: PipelineRunControlsOf<TChild>;\n      initialState(\n        inputs: RequiredInputs<TDeps>,\n        context: PipelineExecutionContext<TOptions>\n      ): TState;\n      mapOptions(\n        state: IterationState<NoInfer<TState>>,\n        inputs: RequiredInputs<TDeps>,\n        context: PipelineExecutionContext<TOptions>\n      ): PipelineOptionsOf<TChild>;\n      transition(\n        result: PipelineResultOf<TChild>,\n        state: IterationState<NoInfer<TState>>,\n        context: PipelineExecutionContext<TOptions>\n      ):\n        | IterationDecision<NoInfer<TState>, TResult>\n        | Promise<IterationDecision<NoInfer<TState>, TResult>>;\n    }\n  ): BuiltStep<TId, Awaited<TResult>, TOptions, TInputOptions>;\n  function iteratePipeline(\n    id: string,\n    definition: Omit<Parameters<typeof createIterationRunner<TOptions>>[0], \"stepId\"> & {\n      name?: string;\n      description?: string;\n      dependsOn?: readonly AnyStep<TOptions>[];\n      dryRun?: \"skip\";\n    }\n  ): AnyStep<TOptions> {\n    if (!Number.isSafeInteger(definition.maxIterations) || definition.maxIterations < 1) {\n      throw new RangeError(\"iteratePipeline maxIterations must be a positive safe integer\");\n    }\n    const controls = definition.controls ? structuredClone(definition.controls) : undefined;\n    if (controls) {\n      if (controls.targets) Object.freeze(controls.targets);\n      if (controls.stepIds) Object.freeze(controls.stepIds);\n      Object.freeze(controls);\n    }\n    const config = { ...definition, stepId: id, controls };\n    return buildStep(id, {\n      [STEP_NESTED_PIPELINE]: {\n        mode: \"iterate\",\n        maxIterations: config.maxIterations,\n        controls: config.controls,\n        pipelineId: config.pipeline.id,\n        identity: config.pipeline.definition?.identity,\n        stepIds: config.pipeline.stepIds,\n      },\n      name: config.name,\n      description: config.description,\n      dependsOn: config.dependsOn,\n      dryRun: config.dryRun,\n      run: createIterationRunner(config),\n    });\n  }\n\n  const factory = {\n    step,\n    loadArtifact,\n    saveArtifact,\n    fromPipeline,\n    fromRemote,\n    forEachPipeline,\n    iteratePipeline,\n  };\n\n  return factory;\n}\n"]}

package/dist/core/pipeline-types.d.ts

@@ -1,3 +1,4 @@
+import type { ArtifactRecord } from "../tracing/artifact-metadata.js";
 import type { PipelineDefinitionIdentityContract, PipelineDefinitionSnapshotContract } from "../tracing/tracing-schema.js";
 /** Versioned graph identity, separate from the optional handler implementation version. */
 export type PipelineDefinitionIdentity = Readonly<PipelineDefinitionIdentityContract>;
@@ -79,6 +80,8 @@ export interface PipelineExecutionContext<TOptions extends object> extends Pipel
 export type PipelineStepProgressDetailStatus = "cancelled" | "completed" | "failed" | "pending" | "running" | "skipped";
 /** One optional nested row in a step progress snapshot. */
 export interface PipelineStepProgressDetail {
+    /** Provenance of a supplied test output, independent of the row status. */
+    outputSource?: "override";
     /** Stable identity for the row (item key, path, job id, …). */
     id: string;
     /** Optional display name; identity remains `id`. */
@@ -112,6 +115,8 @@ export interface PipelineStepProgress {
 export interface PipelineStepContext<TOptions extends object> extends PipelineExecutionContext<TOptions> {
     /** Stable identity for this execution of the current step. */
     attemptId: string;
+    /** Record completed I/O without changing the step output. Calls after the handler settles are ignored. */
+    recordArtifact(record: ArtifactRecord): void;
     /** Emit a retry/attempt trace event for this step when tracing is enabled. */
     reportAttempt(attempt: number, attributes?: PipelineTraceAttributes): void;
     /** Publish the latest progress snapshot for this step. */
@@ -226,6 +231,8 @@ export interface PipelineErrorCause {
     sourceCode?: string;
 }
 interface PipelineStepReportBase {
+    /** Present once a supplied test output enters validation, including failed/cancelled attempts. */
+    outputSource?: "override";
     /** Present when the step started an execution attempt. */
     attemptId?: string;
     id: string;
@@ -327,6 +334,8 @@ export type PipelineStepStatus = {
 } | {
     attemptId: string;
     pipelineId: string;
+    /** Supplied test output; the normal step handler is not executing. */
+    outputSource?: "override";
     progress?: PipelineStepProgress;
     status: "running";
     step: PipelinePlanStep;
@@ -441,8 +450,12 @@ export interface PipelinePlanStep {
     name?: string;
     /** Static child structure when this opaque step executes another pipeline. */
     nestedPipeline?: {
-        /** One child execution or one child execution per runtime item. */
-        mode: "single" | "for-each";
+        /** One child, runtime fan-out, or bounded sequential iteration. */
+        mode: "single" | "for-each" | "iterate";
+        /** Upper bound for a dynamically repeated child. */
+        maxIterations?: number;
+        /** Static child controls, recorded for iteration identity and inspection. */
+        controls?: PipelineRunControls;
         identity?: PipelineDefinitionIdentity;
         concurrency?: number | "dynamic";
         pipelineId: string;