npm - @agent-native/core - Versions diffs - 0.85.6 → 0.86.0 - Mend

@agent-native/core 0.85.6 → 0.86.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (1069) hide show

package/dist/collab/client.js.map CHANGED Viewed

	@@ -1 +1 @@
1	- {"version":3,"file":"client.js","sourceRoot":"","sources":["../../src/collab/client.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AAEH,OAAO,EAAE,SAAS,EAAE,MAAM,EAAE,QAAQ,EAAE,OAAO,EAAE,MAAM,OAAO,CAAC;AAC7D,OAAO,EAAE,SAAS,EAAE,MAAM,uBAAuB,CAAC;AAClD,OAAO,KAAK,CAAC,MAAM,KAAK,CAAC;AAEzB,OAAO,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AACxD,OAAO,EAAE,eAAe,EAAE,MAAM,qBAAqB,CAAC;AA0CtD,4CAA4C;AAC5C,MAAM,aAAa,GAAG;IACpB,SAAS;IACT,SAAS;IACT,SAAS;IACT,SAAS;IACT,SAAS;IACT,SAAS;IACT,SAAS;IACT,SAAS;IACT,SAAS;IACT,SAAS;CACV,CAAC;AAEF,4DAA4D;AAC5D,MAAM,UAAU,YAAY,CAAC,KAAa;IACxC,IAAI,IAAI,GAAG,CAAC,CAAC;IACb,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,KAAK,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;QACtC,IAAI,GAAG,CAAC,CAAC,IAAI,IAAI,CAAC,CAAC,GAAG,IAAI,GAAG,KAAK,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC;IACxD,CAAC;IACD,OAAO,aAAa,CAAC,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,GAAG,aAAa,CAAC,MAAM,CAAC,CAAC;AAC9D,CAAC;AAED,mDAAmD;AACnD,MAAM,UAAU,WAAW,CAAC,KAAa;IACvC,MAAM,KAAK,GAAG,KAAK,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,IAAI,KAAK,CAAC;IAC3C,OAAO,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,WAAW,EAAE,GAAG,KAAK,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;AACxD,CAAC;AAED,SAAS,oBAAoB,CAAC,KAAa;IACzC,OAAO,KAAK,CAAC,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC;AACpC,CAAC;AAED,SAAS,gBAAgB;IACvB,OAAO,CACL,OAAO,QAAQ,KAAK,WAAW,IAAI,QAAQ,CAAC,eAAe,KAAK,QAAQ,CACzE,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,wBAAwB,CAAC,KAAmB;IAC1D,MAAM,OAAO,GAAG,IAAI,GAAG,EAAsB,CAAC;IAC9C,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;QACzB,MAAM,KAAK,GAAG,oBAAoB,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;QAC/C,IAAI,CAAC,KAAK,IAAI,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC;YAAE,SAAS;QAC3C,OAAO,CAAC,GAAG,CAAC,KAAK,EAAE;YACjB,IAAI,EAAE,IAAI,CAAC,IAAI,IAAI,WAAW,CAAC,KAAK,CAAC;YACrC,KAAK;YACL,KAAK,EAAE,IAAI,CAAC,KAAK,IAAI,YAAY,CAAC,KAAK,CAAC;SACzC,CAAC,CAAC;IACL,CAAC;IACD,OAAO,KAAK,CAAC,IAAI,CAAC,OAAO,CAAC,MAAM,EAAE,CAAC,CAAC;AACtC,CAAC;AAED;;;;;;;;;;;;;;;;GAgBG;AACH,MAAM,UAAU,qBAAqB,CACnC,SAAuC,EACvC,aAAwC;IAExC,IAAI,aAAa,IAAI,IAAI;QAAE,OAAO,KAAK,CAAC;IACxC,IAAI,CAAC,SAAS;QAAE,OAAO,IAAI,CAAC,CAAC,iCAAiC;IAE9D,IAAI,OAAO,GAAG,KAAK,CAAC;IACpB,IAAI,UAAU,GAAG,aAAa,CAAC;IAC/B,SAAS,CAAC,SAAS,EAAE,CAAC,OAAO,CAAC,CAAC,KAAK,EAAE,QAAQ,EAAE,EAAE;QAChD,IAAI,QAAQ,KAAK,eAAe;YAAE,OAAO,CAAC,oBAAoB;QAC9D,IAAI,QAAQ,KAAK,aAAa;YAAE,OAAO;QACvC,MAAM,CAAC,GAAG,KAA8C,CAAC;QACzD,IAAI,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI;YAAE,OAAO,CAAC,2BAA2B;QACtD,OAAO,GAAG,IAAI,CAAC;QACf,+EAA+E;QAC/E,4EAA4E;QAC5E,IAAI,CAAC,CAAC,OAAO,KAAK,KAAK,IAAI,QAAQ,GAAG,UAAU;YAAE,UAAU,GAAG,QAAQ,CAAC;IAC1E,CAAC,CAAC,CAAC;IAEH,4EAA4E;IAC5E,oEAAoE;IACpE,IAAI,CAAC,OAAO;QAAE,OAAO,IAAI,CAAC;IAE1B,8EAA8E;IAC9E,6EAA6E;IAC7E,4EAA4E;IAC5E,0EAA0E;IAC1E,MAAM,WAAW,GACf,OAAO,QAAQ,KAAK,WAAW,IAAI,QAAQ,CAAC,eAAe,KAAK,QAAQ,CAAC;IAC3E,IAAI,WAAW;QAAE,OAAO,KAAK,CAAC;IAC9B,OAAO,aAAa,IAAI,UAAU,CAAC;AACrC,CAAC;AAOD,MAAM,UAAU,8BAA8B,CAC5C,MAA4B,EAC5B,aAAqB,EACrB,YAAuC;IAEvC,MAAM,QAAQ,GAAG,IAAI,GAAG,EAAU,CAAC;IACnC,MAAM,KAAK,GAAa,EAAE,CAAC;IAC3B,MAAM,OAAO,GAAa,EAAE,CAAC;IAC7B,MAAM,OAAO,GAAa,EAAE,CAAC;IAE7B,KAAK,MAAM,MAAM,IAAI,YAAY,EAAE,CAAC;QAClC,IACE,CAAC,MAAM,CAAC,QAAQ,CAAC,MAAM,CAAC,QAAQ,CAAC;YACjC,MAAM,CAAC,QAAQ,KAAK,aAAa,EACjC,CAAC;YACD,SAAS;QACX,CAAC;QACD,QAAQ,CAAC,GAAG,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC;QAC9B,MAAM,QAAQ,GAAG,MAAM,CAAC,GAAG,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC;QAC7C,MAAM,CAAC,GAAG,CAAC,MAAM,CAAC,QAAQ,EAAE,MAAM,CAAC,KAAK,CAAC,CAAC;QAC1C,CAAC,QAAQ,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC;IACrD,CAAC;IAED,KAAK,MAAM,QAAQ,IAAI,KAAK,CAAC,IAAI,CAAC,MAAM,CAAC,IAAI,EAAE,CAAC,EAAE,CAAC;QACjD,IAAI,QAAQ,KAAK,aAAa;YAAE,SAAS;QACzC,IAAI,QAAQ,CAAC,GAAG,CAAC,QAAQ,CAAC;YAAE,SAAS;QACrC,MAAM,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC;QACxB,OAAO,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;IACzB,CAAC;IAED,OAAO,EAAE,KAAK,EAAE,OAAO,EAAE,OAAO,EAAE,CAAC;AACrC,CAAC;AAED,iBAAiB;AACjB,SAAS,kBAAkB,CAAC,GAAe;IACzC,IAAI,MAAM,GAAG,EAAE,CAAC;IAChB,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,GAAG,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;QACpC,MAAM,IAAI,MAAM,CAAC,YAAY,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC;IACxC,CAAC;IACD,OAAO,IAAI,CAAC,MAAM,CAAC,CAAC;AACtB,CAAC;AAED,SAAS,kBAAkB,CAAC,GAAW;IACrC,MAAM,MAAM,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC;IACzB,MAAM,GAAG,GAAG,IAAI,UAAU,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC;IAC1C,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;QACvC,GAAG,CAAC,CAAC,CAAC,GAAG,MAAM,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC;IAChC,CAAC;IACD,OAAO,GAAG,CAAC;AACb,CAAC;AAED,iEAAiE;AACjE,MAAM,kBAAkB,GAAG,EAAE,CAAC;AAE9B,4EAA4E;AAC5E,MAAM,2BAA2B,GAAG,EAAE,CAAC;AAEvC,mEAAmE;AACnE,MAAM,qBAAqB,GAAG,GAAG,CAAC;AAElC,kEAAkE;AAClE,MAAM,eAAe,GAAG,GAAG,CAAC;AAC5B,MAAM,cAAc,GAAG,MAAM,CAAC;AAE9B,SAAS,WAAW,CAAC,iBAAyB;IAC5C,MAAM,GAAG,GAAG,IAAI,CAAC,GAAG,CAAC,iBAAiB,EAAE,EAAE,CAAC,CAAC;IAC5C,MAAM,KAAK,GAAG,eAAe,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC;IACjD,mBAAmB;IACnB,MAAM,MAAM,GAAG,KAAK,GAAG,IAAI,GAAG,CAAC,IAAI,CAAC,MAAM,EAAE,GAAG,CAAC,GAAG,CAAC,CAAC,CAAC;IACtD,OAAO,IAAI,CAAC,GAAG,CAAC,KAAK,GAAG,MAAM,EAAE,cAAc,CAAC,CAAC;AAClD,CAAC;AAED,8EAA8E;AAC9E,yEAAyE;AACzE,8EAA8E;AAC9E,8EAA8E;AAE9E,MAAM,wBAAwB,GAAG,IAAI,GAAG,EAGrC,CAAC;AAEJ,SAAS,qBAAqB,CAC5B,OAAe,EACf,KAAa,EACb,QAAgB,EAChB,QAA8C;IAE9C,IAAI,OAAO,MAAM,KAAK,WAAW;QAAE,OAAO;IAC1C,MAAM,GAAG,GAAG,GAAG,KAAK,KAAK,QAAQ,EAAE,CAAC;IACpC,IAAI,wBAAwB,CAAC,GAAG,CAAC,GAAG,CAAC;QAAE,OAAO,CAAC,oBAAoB;IAEnE,MAAM,KAAK,GAAG,UAAU,CAAC,GAAG,EAAE;QAC5B,wBAAwB,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;QACrC,MAAM,KAAK,GAAG,QAAQ,EAAE,CAAC;QACzB,KAAK,CAAC,GAAG,OAAO,IAAI,KAAK,YAAY,EAAE;YACrC,MAAM,EAAE,MAAM;YACd,OAAO,EAAE,EAAE,cAAc,EAAE,kBAAkB,EAAE;YAC/C,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC;gBACnB,QAAQ;gBACR,KAAK,EAAE,KAAK,CAAC,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,IAAI;aAC5C,CAAC;SACH,CAAC,CAAC,KAAK,CAAC,GAAG,EAAE,GAAE,CAAC,CAAC,CAAC,CAAC,mDAAmD;IACzE,CAAC,EAAE,GAAG,CAAC,CAAC;IAER,wBAAwB,CAAC,GAAG,CAAC,GAAG,EAAE,KAAK,CAAC,CAAC;AAC3C,CAAC;AAED,MAAM,UAAU,mBAAmB,CACjC,OAAmC;IAEnC,MAAM,EACJ,KAAK,EACL,YAAY,GAAG,IAAI,EACnB,mBAAmB,GAAG,KAAK,EAC3B,eAAe,GAAG,IAAI,EACtB,OAAO,GAAG,eAAe,CAAC,uBAAuB,CAAC,EAClD,aAAa,EACb,IAAI,GACL,GAAG,OAAO,CAAC;IAEZ,yBAAyB;IACzB,MAAM,IAAI,GAAG,OAAO,CAAC,GAAG,EAAE;QACxB,IAAI,CAAC,KAAK;YAAE,OAAO,IAAI,CAAC;QACxB,OAAO,IAAI,CAAC,CAAC,GAAG,EAAE,CAAC;IACrB,CAAC,EAAE,CAAC,KAAK,CAAC,CAAC,CAAC;IAEZ,4BAA4B;IAC5B,MAAM,SAAS,GAAG,OAAO,CAAC,GAAG,EAAE;QAC7B,IAAI,CAAC,IAAI;YAAE,OAAO,IAAI,CAAC;QACvB,OAAO,IAAI,SAAS,CAAC,IAAI,CAAC,CAAC;IAC7B,CAAC,EAAE,CAAC,IAAI,CAAC,CAAC,CAAC;IAEX,MAAM,CAAC,SAAS,EAAE,YAAY,CAAC,GAAG,QAAQ,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC;IACpD,MAAM,CAAC,QAAQ,EAAE,WAAW,CAAC,GAAG,QAAQ,CAAC,KAAK,CAAC,CAAC;IAChD,MAAM,CAAC,WAAW,EAAE,cAAc,CAAC,GAAG,QAAQ,CAAe,EAAE,CAAC,CAAC;IACjE,MAAM,CAAC,WAAW,EAAE,cAAc,CAAC,GAAG,QAAQ,CAAC,KAAK,CAAC,CAAC;IACtD,MAAM,CAAC,YAAY,EAAE,eAAe,CAAC,GAAG,QAAQ,CAAC,KAAK,CAAC,CAAC;IACxD,yEAAyE;IACzE,2EAA2E;IAC3E,6BAA6B;IAC7B,MAAM,CAAC,UAAU,EAAE,aAAa,CAAC,GAAG,QAAQ,CAAC,KAAK,CAAC,CAAC;IACpD,MAAM,aAAa,GAAG,MAAM,CAAuC,IAAI,CAAC,CAAC;IACzE,MAAM,cAAc,GAAG,MAAM,CAAC,CAAC,CAAC,CAAC;IAEjC,6EAA6E;IAC7E,yEAAyE;IACzE,6EAA6E;IAC7E,+BAA+B;IAC/B,SAAS,CAAC,GAAG,EAAE;QACb,IAAI,CAAC,SAAS,IAAI,CAAC,IAAI;YAAE,OAAO;QAChC,SAAS,CAAC,kBAAkB,CAAC,MAAM,EAAE;YACnC,IAAI,EAAE,IAAI,CAAC,IAAI;YACf,KAAK,EAAE,IAAI,CAAC,KAAK;YACjB,KAAK,EAAE,IAAI,CAAC,KAAK;SAClB,CAAC,CAAC;QACH,SAAS,CAAC,kBAAkB,CAAC,SAAS,EAAE,CAAC,gBAAgB,EAAE,CAAC,CAAC;IAC/D,CAAC,EAAE,CAAC,SAAS,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,KAAK,EAAE,IAAI,EAAE,KAAK,CAAC,CAAC,CAAC;IAEtD,wEAAwE;IACxE,2EAA2E;IAC3E,0EAA0E;IAC1E,+EAA+E;IAC/E,SAAS,CAAC,GAAG,EAAE;QACb,IAAI,CAAC,SAAS,IAAI,CAAC,IAAI,IAAI,CAAC,KAAK,IAAI,CAAC,IAAI;YAAE,OAAO;QACnD,MAAM,QAAQ,GAAG,IAAI,CAAC,QAAQ,CAAC;QAE/B,MAAM,kBAAkB,GAAG,GAAG,EAAE;YAC9B,qBAAqB,CACnB,OAAO,EACP,KAAK,EACL,QAAQ,EACR,GAAG,EAAE,CAAC,SAAS,CAAC,aAAa,EAAoC,CAClE,CAAC;QACJ,CAAC,CAAC;QAEF,iFAAiF;QACjF,SAAS,CAAC,EAAE,CAAC,QAAQ,EAAE,kBAAkB,CAAC,CAAC;QAC3C,OAAO,GAAG,EAAE;YACV,SAAS,CAAC,GAAG,CAAC,QAAQ,EAAE,kBAAkB,CAAC,CAAC;QAC9C,CAAC,CAAC;IACJ,CAAC,EAAE,CAAC,SAAS,EAAE,IAAI,EAAE,KAAK,EAAE,OAAO,EAAE,IAAI,CAAC,CAAC,CAAC;IAE5C,4CAA4C;IAC5C,SAAS,CAAC,GAAG,EAAE;QACb,IAAI,CAAC,SAAS;YAAE,OAAO;QAEvB,MAAM,WAAW,GAAG,GAAG,EAAE;YACvB,MAAM,KAAK,GAAiB,EAAE,CAAC;YAC/B,IAAI,QAAQ,GAAG,KAAK,CAAC;YACrB,SAAS,CAAC,SAAS,EAAE,CAAC,OAAO,CAAC,CAAC,KAAK,EAAE,QAAQ,EAAE,EAAE;gBAChD,IAAI,QAAQ,KAAK,IAAI,EAAE,QAAQ;oBAAE,OAAO,CAAC,YAAY;gBACrD,IAAI,KAAK,CAAC,IAAI,EAAE,CAAC;oBACf,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,IAAkB,CAAC,CAAC;oBACrC,IAAK,KAAK,CAAC,IAAmB,CAAC,KAAK,KAAK,cAAc,EAAE,CAAC;wBACxD,QAAQ,GAAG,IAAI,CAAC;oBAClB,CAAC;gBACH,CAAC;YACH,CAAC,CAAC,CAAC;YACH,cAAc,CAAC,wBAAwB,CAAC,KAAK,CAAC,CAAC,CAAC;YAChD,eAAe,CAAC,QAAQ,CAAC,CAAC;QAC5B,CAAC,CAAC;QAEF,SAAS,CAAC,EAAE,CAAC,QAAQ,EAAE,WAAW,CAAC,CAAC;QACpC,OAAO,GAAG,EAAE;YACV,SAAS,CAAC,GAAG,CAAC,QAAQ,EAAE,WAAW,CAAC,CAAC;QACvC,CAAC,CAAC;IACJ,CAAC,EAAE,CAAC,SAAS,EAAE,IAAI,CAAC,CAAC,CAAC;IAEtB,sCAAsC;IACtC,SAAS,CAAC,GAAG,EAAE;QACb,OAAO,GAAG,EAAE;YACV,SAAS,EAAE,OAAO,EAAE,CAAC;YACrB,IAAI,EAAE,OAAO,EAAE,CAAC;QAClB,CAAC,CAAC;IACJ,CAAC,EAAE,CAAC,IAAI,EAAE,SAAS,CAAC,CAAC,CAAC;IAEtB,+CAA+C;IAC/C,SAAS,CAAC,GAAG,EAAE;QACb,IAAI,CAAC,IAAI,IAAI,CAAC,KAAK,EAAE,CAAC;YACpB,YAAY,CAAC,KAAK,CAAC,CAAC;YACpB,OAAO;QACT,CAAC;QAED,IAAI,SAAS,GAAG,KAAK,CAAC;QACtB,YAAY,CAAC,IAAI,CAAC,CAAC;QACnB,WAAW,CAAC,KAAK,CAAC,CAAC;QACnB,aAAa,CAAC,KAAK,CAAC,CAAC;QAErB,KAAK,CAAC,GAAG,OAAO,IAAI,KAAK,QAAQ,CAAC;aAC/B,IAAI,CAAC,KAAK,EAAE,GAAG,EAAE,EAAE;YAClB,IAAI,SAAS;gBAAE,OAAO;YACtB,IAAI,GAAG,CAAC,MAAM,KAAK,GAAG,IAAI,GAAG,CAAC,MAAM,KAAK,GAAG,EAAE,CAAC;gBAC7C,aAAa,CAAC,IAAI,CAAC,CAAC;gBACpB,YAAY,CAAC,KAAK,CAAC,CAAC;gBACpB,WAAW,CAAC,IAAI,CAAC,CAAC;gBAClB,OAAO;YACT,CAAC;YACD,MAAM,IAAI,GAAG,CAAC,MAAM,GAAG,CAAC,IAAI,EAAE,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,IAAI,CAAC,CAExC,CAAC;YACT,IAAI,IAAI,EAAE,KAAK,EAAE,CAAC;gBAChB,MAAM,MAAM,GAAG,kBAAkB,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;gBAC9C,IAAI,MAAM,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;oBACtB,CAAC,CAAC,WAAW,CAAC,IAAI,EAAE,MAAM,EAAE,QAAQ,CAAC,CAAC;gBACxC,CAAC;YACH,CAAC;YACD,YAAY,CAAC,KAAK,CAAC,CAAC;YACpB,WAAW,CAAC,IAAI,CAAC,CAAC;QACpB,CAAC,CAAC;aACD,KAAK,CAAC,GAAG,EAAE;YACV,IAAI,SAAS;gBAAE,OAAO;YACtB,YAAY,CAAC,KAAK,CAAC,CAAC;YACpB,WAAW,CAAC,IAAI,CAAC,CAAC;QACpB,CAAC,CAAC,CAAC;QAEL,OAAO,GAAG,EAAE;YACV,SAAS,GAAG,IAAI,CAAC;QACnB,CAAC,CAAC;IACJ,CAAC,EAAE,CAAC,IAAI,EAAE,KAAK,EAAE,OAAO,CAAC,CAAC,CAAC;IAE3B,8EAA8E;IAC9E,EAAE;IACF,+EAA+E;IAC/E,2EAA2E;IAC3E,+EAA+E;IAC/E,2EAA2E;IAC3E,SAAS,CAAC,GAAG,EAAE;QACb,IAAI,CAAC,IAAI,IAAI,CAAC,KAAK,IAAI,UAAU;YAAE,OAAO;QAE1C,IAAI,cAAc,GAAiB,EAAE,CAAC;QACtC,IAAI,UAAU,GAAyC,IAAI,CAAC;QAE5D,MAAM,mBAAmB,GAAG,CAAC,SAAS,GAAG,KAAK,EAAE,EAAE;YAChD,IAAI,UAAU,EAAE,CAAC;gBACf,YAAY,CAAC,UAAU,CAAC,CAAC;gBACzB,UAAU,GAAG,IAAI,CAAC;YACpB,CAAC;YACD,IAAI,cAAc,CAAC,MAAM,KAAK,CAAC;gBAAE,OAAO;YACxC,MAAM,MAAM,GAAG,cAAc,CAAC;YAC9B,cAAc,GAAG,EAAE,CAAC;YAEpB,MAAM,MAAM,GAAG,MAAM,CAAC,MAAM,KAAK,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,YAAY,CAAC,MAAM,CAAC,CAAC;YACxE,KAAK,CAAC,GAAG,OAAO,IAAI,KAAK,SAAS,EAAE;gBAClC,MAAM,EAAE,MAAM;gBACd,OAAO,EAAE,EAAE,cAAc,EAAE,kBAAkB,EAAE;gBAC/C,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC;oBACnB,MAAM,EAAE,kBAAkB,CAAC,MAAM,CAAC;oBAClC,aAAa;iBACd,CAAC;gBACF,GAAG,CAAC,SAAS,CAAC,CAAC,CAAC,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;aAC1C,CAAC,CAAC,KAAK,CAAC,GAAG,EAAE,GAAE,CAAC,CAAC,CAAC;QACrB,CAAC,CAAC;QAEF,6EAA6E;QAC7E,uEAAuE;QACvE,uDAAuD;QACtD,IAAY,CAAC,aAAa,GAAG,mBAAmB,CAAC;QAElD,MAAM,OAAO,GAAG,CAAC,MAAkB,EAAE,MAAe,EAAE,EAAE;YACtD,IAAI,MAAM,KAAK,QAAQ;gBAAE,OAAO;YAChC,cAAc,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;YAC5B,IAAI,UAAU;gBAAE,YAAY,CAAC,UAAU,CAAC,CAAC;YACzC,UAAU,GAAG,UAAU,CAAC,mBAAmB,EAAE,kBAAkB,CAAC,CAAC;QACnE,CAAC,CAAC;QAEF,MAAM,cAAc,GAAG,GAAG,EAAE;YAC1B,mBAAmB,CAAC,IAAI,CAAC,eAAe,CAAC,CAAC;QAC5C,CAAC,CAAC;QAEF,IAAI,CAAC,EAAE,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC;QAC3B,IAAI,OAAO,MAAM,KAAK,WAAW,EAAE,CAAC;YAClC,MAAM,CAAC,gBAAgB,CAAC,UAAU,EAAE,cAAc,CAAC,CAAC;QACtD,CAAC;QAED,OAAO,GAAG,EAAE;YACV,IAAI,CAAC,GAAG,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC;YAC5B,OAAQ,IAAY,CAAC,aAAa,CAAC;YACnC,IAAI,OAAO,MAAM,KAAK,WAAW,EAAE,CAAC;gBAClC,MAAM,CAAC,mBAAmB,CAAC,UAAU,EAAE,cAAc,CAAC,CAAC;YACzD,CAAC;YACD,0CAA0C;YAC1C,mBAAmB,CAAC,IAAI,CAAC,CAAC;QAC5B,CAAC,CAAC;IACJ,CAAC,EAAE,CAAC,IAAI,EAAE,KAAK,EAAE,OAAO,EAAE,aAAa,EAAE,UAAU,CAAC,CAAC,CAAC;IAEtD,oEAAoE;IACpE,SAAS,CAAC,GAAG,EAAE;QACb,IAAI,CAAC,IAAI,IAAI,CAAC,KAAK,IAAI,UAAU;YAAE,OAAO;QAC1C,0EAA0E;QAC1E,4CAA4C;QAC5C,MAAM,GAAG,GAAU,IAAI,CAAC;QAExB,IAAI,OAAO,GAAG,KAAK,CAAC;QACpB,IAAI,KAAK,GAAyC,IAAI,CAAC;QACvD,IAAI,iBAAiB,GAAG,CAAC,CAAC;QAC1B,IAAI,cAAc,GAAG,CAAC,CAAC;QACvB,4EAA4E;QAC5E,sDAAsD;QACtD,IAAI,iBAAiB,GAAG,cAAc,CAAC,OAAO,CAAC;QAE/C,uEAAuE;QACvE,IAAI,SAAS,GAAG,KAAK,CAAC;QACtB,IAAI,cAAc,GAAuB,IAAI,CAAC;QAE9C,oEAAoE;QACpE,4DAA4D;QAC5D,qEAAqE;QACrE,+CAA+C;QAC/C,EAAE;QACF,yEAAyE;QACzE,2EAA2E;QAC3E,oEAAoE;QACpE,SAAS,OAAO;YACd,IAAI,OAAO,WAAW,KAAK,WAAW;gBAAE,OAAO;YAC/C,IAAI,CAAC;gBACH,MAAM,EAAE,GAAG,IAAI,WAAW,CAAC,eAAe,CAAC,uBAAuB,CAAC,CAAC,CAAC;gBACrE,cAAc,GAAG,EAAE,CAAC;gBAEpB,EAAE,CAAC,MAAM,GAAG,GAAG,EAAE;oBACf,SAAS,GAAG,IAAI,CAAC;oBACjB,iBAAiB,GAAG,CAAC,CAAC;gBACxB,CAAC,CAAC;gBAEF,EAAE,CAAC,SAAS,GAAG,CAAC,EAAE,EAAE,EAAE;oBACpB,IAAI,CAAC;wBACH,MAAM,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC,IAAI,CAMhC,CAAC;wBAEF,IACE,MAAM,CAAC,MAAM,KAAK,QAAQ;4BAC1B,MAAM,CAAC,KAAK,KAAK,KAAK;4BACtB,MAAM,CAAC,MAAM,EACb,CAAC;4BACD,IAAI,aAAa,IAAI,MAAM,CAAC,aAAa,KAAK,aAAa;gCACzD,OAAO;4BACT,IAAI,CAAC;gCACH,CAAC,CAAC,WAAW,CAAC,GAAG,EAAE,kBAAkB,CAAC,MAAM,CAAC,MAAM,CAAC,EAAE,QAAQ,CAAC,CAAC;4BAClE,CAAC;4BAAC,MAAM,CAAC;gCACP,6DAA6D;4BAC/D,CAAC;4BAED,IAAI,MAAM,CAAC,aAAa,KAAK,OAAO,EAAE,CAAC;gCACrC,cAAc,CAAC,IAAI,CAAC,CAAC;gCACrB,IAAI,aAAa,CAAC,OAAO;oCAAE,YAAY,CAAC,aAAa,CAAC,OAAO,CAAC,CAAC;gCAC/D,aAAa,CAAC,OAAO,GAAG,UAAU,CAChC,GAAG,EAAE,CAAC,cAAc,CAAC,KAAK,CAAC,EAC3B,IAAI,CACL,CAAC;4BACJ,CAAC;wBACH,CAAC;wBAED,+DAA+D;wBAC/D,gDAAgD;wBAChD,IAAI,OAAO,MAAM,CAAC,OAAO,KAAK,QAAQ,EAAE,CAAC;4BACvC,cAAc,CAAC,OAAO,GAAG,IAAI,CAAC,GAAG,CAC/B,cAAc,CAAC,OAAO,EACtB,MAAM,CAAC,OAAO,CACf,CAAC;wBACJ,CAAC;oBACH,CAAC;oBAAC,MAAM,CAAC;wBACP,0BAA0B;oBAC5B,CAAC;gBACH,CAAC,CAAC;gBAEF,EAAE,CAAC,OAAO,GAAG,GAAG,EAAE;oBAChB,SAAS,GAAG,KAAK,CAAC;oBAClB,EAAE,CAAC,KAAK,EAAE,CAAC;oBACX,cAAc,GAAG,IAAI,CAAC;oBACtB,gCAAgC;oBAChC,IAAI,CAAC,OAAO,EAAE,CAAC;wBACb,UAAU,CAAC,OAAO,EAAE,KAAK,GAAG,IAAI,CAAC,MAAM,EAAE,GAAG,KAAK,CAAC,CAAC;oBACrD,CAAC;gBACH,CAAC,CAAC;YACJ,CAAC;YAAC,MAAM,CAAC;gBACP,qEAAqE;gBACrE,SAAS,GAAG,KAAK,CAAC;YACpB,CAAC;QACH,CAAC;QAED,2DAA2D;QAC3D,IAAI,OAAO,WAAW,KAAK,WAAW,EAAE,CAAC;YACvC,OAAO,EAAE,CAAC;QACZ,CAAC;QAED,mEAAmE;QACnE,SAAS,qBAAqB;YAC5B,OAAO,SAAS,CAAC,CAAC,CAAC,mBAAmB,CAAC,CAAC,CAAC,YAAY,CAAC;QACxD,CAAC;QAED,SAAS,YAAY;YACnB,IAAI,OAAO;gBAAE,OAAO;YACpB,IAAI,eAAe,IAAI,gBAAgB,EAAE;gBAAE,OAAO;YAClD,KAAK,GAAG,UAAU,CAAC,IAAI,EAAE,qBAAqB,EAAE,CAAC,CAAC;QACpD,CAAC;QAED,KAAK,UAAU,gBAAgB;YAC7B,IAAI,CAAC;gBACH,MAAM,WAAW,GAAG,kBAAkB,CAAC,CAAC,CAAC,iBAAiB,CAAC,GAAG,CAAC,CAAC,CAAC;gBACjE,MAAM,QAAQ,GAAG,MAAM,KAAK,CAC1B,GAAG,OAAO,IAAI,KAAK,sBAAsB,kBAAkB,CAAC,WAAW,CAAC,EAAE,CAC3E,CAAC;gBACF,IAAI,QAAQ,CAAC,EAAE,EAAE,CAAC;oBAChB,MAAM,SAAS,GAAG,CAAC,MAAM,QAAQ,CAAC,IAAI,EAAE,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,IAAI,CAAC,CAElD,CAAC;oBACT,IAAI,SAAS,EAAE,KAAK,EAAE,CAAC;wBACrB,MAAM,MAAM,GAAG,kBAAkB,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC;wBACnD,IAAI,MAAM,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;4BACtB,CAAC,CAAC,WAAW,CAAC,GAAG,EAAE,MAAM,EAAE,QAAQ,CAAC,CAAC;wBACvC,CAAC;oBACH,CAAC;gBACH,CAAC;YACH,CAAC;YAAC,MAAM,CAAC;gBACP,4CAA4C;YAC9C,CAAC;QACH,CAAC;QAED,KAAK,UAAU,IAAI;YACjB,IAAI,OAAO;gBAAE,OAAO;YAEpB,uEAAuE;YACvE,8CAA8C;YAC9C,MAAM,KAAK,GAAI,IAAY,CAAC,aAEf,CAAC;YACd,KAAK,EAAE,EAAE,CAAC;YAEV,IAAI,CAAC;gBACH,MAAM,GAAG,GAAG,MAAM,KAAK,CACrB,eAAe,CACb,6BAA6B,cAAc,CAAC,OAAO,EAAE,CACtD,CACF,CAAC;gBACF,IAAI,CAAC,GAAG,CAAC,EAAE;oBAAE,MAAM,IAAI,KAAK,CAAC,OAAO,GAAG,GAAG,CAAC,MAAM,CAAC,CAAC;gBAEnD,MAAM,IAAI,GAAG,MAAM,GAAG,CAAC,IAAI,EAAE,CAAC;gBAC9B,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,GAAG,IAQ3B,CAAC;gBAEF,sEAAsE;gBACtE,wEAAwE;gBACxE,8BAA8B;gBAC9B,MAAM,UAAU,GAAG,OAAO,GAAG,iBAAiB,CAAC;gBAC/C,MAAM,MAAM,GAAG,UAAU,GAAG,qBAAqB,CAAC;gBAElD,KAAK,MAAM,GAAG,IAAI,MAAM,EAAE,CAAC;oBACzB,IAAI,GAAG,CAAC,MAAM,KAAK,QAAQ,IAAI,GAAG,CAAC,KAAK,KAAK,KAAK,IAAI,GAAG,CAAC,MAAM,EAAE,CAAC;wBACjE,IAAI,aAAa,IAAI,GAAG,CAAC,aAAa,KAAK,aAAa;4BAAE,SAAS;wBACnE,IAAI,CAAC;4BACH,CAAC,CAAC,WAAW,CAAC,GAAG,EAAE,kBAAkB,CAAC,GAAG,CAAC,MAAM,CAAC,EAAE,QAAQ,CAAC,CAAC;wBAC/D,CAAC;wBAAC,MAAM,CAAC;4BACP,kDAAkD;4BAClD,MAAM,gBAAgB,EAAE,CAAC;wBAC3B,CAAC;wBAED,IAAI,GAAG,CAAC,aAAa,KAAK,OAAO,EAAE,CAAC;4BAClC,cAAc,CAAC,IAAI,CAAC,CAAC;4BACrB,IAAI,aAAa,CAAC,OAAO;gCAAE,YAAY,CAAC,aAAa,CAAC,OAAO,CAAC,CAAC;4BAC/D,aAAa,CAAC,OAAO,GAAG,UAAU,CAChC,GAAG,EAAE,CAAC,cAAc,CAAC,KAAK,CAAC,EAC3B,IAAI,CACL,CAAC;wBACJ,CAAC;oBACH,CAAC;gBACH,CAAC;gBAED,cAAc,CAAC,OAAO,GAAG,OAAO,CAAC;gBACjC,iBAAiB,GAAG,OAAO,CAAC;gBAC5B,cAAc,EAAE,CAAC;gBACjB,iBAAiB,GAAG,CAAC,CAAC;gBAEtB,uCAAuC;gBACvC,sDAAsD;gBACtD,0EAA0E;gBAC1E,4EAA4E;gBAC5E,MAAM,sBAAsB,GAC1B,MAAM,IAAI,cAAc,GAAG,2BAA2B,KAAK,CAAC,CAAC;gBAE/D,IAAI,sBAAsB,EAAE,CAAC;oBAC3B,MAAM,gBAAgB,EAAE,CAAC;gBAC3B,CAAC;gBAED,oCAAoC;gBACpC,IAAI,SAAS,EAAE,CAAC;oBACd,MAAM,UAAU,GAAG,SAAS,CAAC,aAAa,EAAE,CAAC;oBAC7C,IAAI,UAAU,EAAE,CAAC;wBACf,IAAI,CAAC;4BACH,MAAM,YAAY,GAAG,MAAM,KAAK,CAC9B,GAAG,OAAO,IAAI,KAAK,YAAY,EAC/B;gCACE,MAAM,EAAE,MAAM;gCACd,OAAO,EAAE,EAAE,cAAc,EAAE,kBAAkB,EAAE;gCAC/C,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC;oCACnB,QAAQ,EAAE,GAAG,CAAC,QAAQ;oCACtB,KAAK,EAAE,IAAI,CAAC,SAAS,CAAC,UAAU,CAAC;iCAClC,CAAC;6BACH,CACF,CAAC;4BACF,IAAI,YAAY,CAAC,EAAE,EAAE,CAAC;gCACpB,MAAM,aAAa,GAAG,MAAM,YAAY,CAAC,IAAI,EAAE,CAAC;gCAChD,MAAM,YAAY,GAA8B,EAAE,CAAC;gCACnD,KAAK,MAAM,MAAM,IAAI,aAAa,CAAC,MAAM,IAAI,EAAE,EAAE,CAAC;oCAChD,IAAI,CAAC;wCACH,MAAM,WAAW,GAAG,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;wCAC7C,YAAY,CAAC,IAAI,CAAC;4CAChB,QAAQ,EAAE,MAAM,CAAC,MAAM,CAAC,QAAQ,CAAC;4CACjC,KAAK,EAAE,WAAW;yCACnB,CAAC,CAAC;oCACL,CAAC;oCAAC,MAAM,CAAC;wCACP,uBAAuB;oCACzB,CAAC;gCACH,CAAC;gCACD,MAAM,OAAO,GAAG,8BAA8B,CAC5C,SAAS,CAAC,SAAS,EAA0B,EAC7C,GAAG,CAAC,QAAQ,EACZ,YAAY,CACb,CAAC;gCACF,IACE,OAAO,CAAC,KAAK,CAAC,MAAM;oCACpB,OAAO,CAAC,OAAO,CAAC,MAAM;oCACtB,OAAO,CAAC,OAAO,CAAC,MAAM,EACtB,CAAC;oCACD,SAAS,CAAC,IAAI,CAAC,QAAQ,EAAE,CAAC,OAAO,EAAE,QAAQ,CAAC,CAAC,CAAC;gCAChD,CAAC;4BACH,CAAC;wBACH,CAAC;wBAAC,MAAM,CAAC;4BACP,sCAAsC;wBACxC,CAAC;oBACH,CAAC;gBACH,CAAC;YACH,CAAC;YAAC,MAAM,CAAC;gBACP,sCAAsC;gBACtC,iBAAiB,EAAE,CAAC;gBACpB,MAAM,OAAO,GAAG,WAAW,CAAC,iBAAiB,CAAC,CAAC;gBAC/C,IAAI,CAAC,OAAO,EAAE,CAAC;oBACb,KAAK,GAAG,UAAU,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC;oBAClC,OAAO;gBACT,CAAC;YACH,CAAC;YAED,YAAY,EAAE,CAAC;QACjB,CAAC;QAED,SAAS,OAAO;YACd,IAAI,eAAe,IAAI,gBAAgB,EAAE;gBAAE,OAAO;YAClD,IAAI,KAAK,EAAE,CAAC;gBACV,YAAY,CAAC,KAAK,CAAC,CAAC;gBACpB,KAAK,GAAG,IAAI,CAAC;YACf,CAAC;YACD,KAAK,IAAI,EAAE,CAAC;QACd,CAAC;QAED,2EAA2E;QAC3E,4EAA4E;QAC5E,0EAA0E;QAC1E,8EAA8E;QAC9E,SAAS,iBAAiB,CAAC,OAAgB;YACzC,IAAI,CAAC,SAAS;gBAAE,OAAO;YACvB,SAAS,CAAC,kBAAkB,CAAC,SAAS,EAAE,OAAO,CAAC,CAAC;YACjD,MAAM,UAAU,GAAG,SAAS,CAAC,aAAa,EAAE,CAAC;YAC7C,IAAI,CAAC,UAAU;gBAAE,OAAO;YACxB,KAAK,CAAC,GAAG,OAAO,IAAI,KAAK,YAAY,EAAE;gBACrC,MAAM,EAAE,MAAM;gBACd,OAAO,EAAE,EAAE,cAAc,EAAE,kBAAkB,EAAE;gBAC/C,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC;oBACnB,QAAQ,EAAE,GAAG,CAAC,QAAQ;oBACtB,KAAK,EAAE,IAAI,CAAC,SAAS,CAAC,UAAU,CAAC;iBAClC,CAAC;gBACF,SAAS,EAAE,IAAI;aAChB,CAAC,CAAC,KAAK,CAAC,GAAG,EAAE,GAAE,CAAC,CAAC,CAAC;QACrB,CAAC;QAED,SAAS,sBAAsB;YAC7B,MAAM,OAAO,GAAG,QAAQ,CAAC,eAAe,KAAK,SAAS,CAAC;YACvD,iBAAiB,CAAC,OAAO,CAAC,CAAC;YAC3B,IAAI,OAAO,EAAE,CAAC;gBACZ,4DAA4D;gBAC5D,MAAM,KAAK,GAAI,IAAY,CAAC,aAEf,CAAC;gBACd,KAAK,EAAE,EAAE,CAAC;gBACV,OAAO,EAAE,CAAC;YACZ,CAAC;iBAAM,IAAI,eAAe,IAAI,KAAK,EAAE,CAAC;gBACpC,YAAY,CAAC,KAAK,CAAC,CAAC;gBACpB,KAAK,GAAG,IAAI,CAAC;YACf,CAAC;QACH,CAAC;QAED,IAAI,CAAC,eAAe,IAAI,CAAC,gBAAgB,EAAE,EAAE,CAAC;YAC5C,KAAK,IAAI,EAAE,CAAC;QACd,CAAC;QACD,MAAM,CAAC,gBAAgB,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC;QAC1C,QAAQ,CAAC,gBAAgB,CAAC,kBAAkB,EAAE,sBAAsB,CAAC,CAAC;QAEtE,OAAO,GAAG,EAAE;YACV,OAAO,GAAG,IAAI,CAAC;YACf,IAAI,KAAK;gBAAE,YAAY,CAAC,KAAK,CAAC,CAAC;YAC/B,IAAI,cAAc,EAAE,CAAC;gBACnB,cAAc,CAAC,KAAK,EAAE,CAAC;gBACvB,cAAc,GAAG,IAAI,CAAC;YACxB,CAAC;YACD,MAAM,CAAC,mBAAmB,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC;YAC7C,QAAQ,CAAC,mBAAmB,CAAC,kBAAkB,EAAE,sBAAsB,CAAC,CAAC;QAC3E,CAAC,CAAC;IACJ,CAAC,EAAE;QACD,IAAI;QACJ,SAAS;QACT,KAAK;QACL,YAAY;QACZ,mBAAmB;QACnB,eAAe;QACf,aAAa;QACb,OAAO;QACP,UAAU;KACX,CAAC,CAAC;IAEH,4EAA4E;IAC5E,wEAAwE;IACxE,4DAA4D;IAC5D,0DAA0D;IAC1D,SAAS,CAAC,GAAG,EAAE;QACb,IAAI,CAAC,IAAI,IAAI,CAAC,KAAK,IAAI,CAAC,SAAS,IAAI,OAAO,WAAW,KAAK,WAAW,EAAE,CAAC;YACxE,OAAO;QACT,CAAC;QACD,sEAAsE;QACtE,MAAM,YAAY,GAAG,IAAI,CAAC;QAC1B,MAAM,iBAAiB,GAAG,SAAS,CAAC;QACpC,MAAM,MAAM,GAAG,eAAe,CAAC,uBAAuB,CAAC,CAAC;QACxD,IAAI,MAAM,GAAuB,IAAI,CAAC;QACtC,IAAI,OAAO,GAAG,KAAK,CAAC;QAEpB,SAAS,OAAO;YACd,IAAI,OAAO,IAAI,MAAM;gBAAE,OAAO;YAC9B,MAAM,GAAG,IAAI,WAAW,CAAC,MAAM,CAAC,CAAC;YACjC,MAAM,CAAC,SAAS,GAAG,CAAC,GAAG,EAAE,EAAE;gBACzB,IAAI,OAAO;oBAAE,OAAO;gBACpB,IAAI,CAAC;oBACH,MAAM,IAAI,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,IAAc,CAKzC,CAAC;oBACF,IACE,IAAI,CAAC,MAAM,KAAK,WAAW;wBAC3B,IAAI,CAAC,IAAI,KAAK,kBAAkB;wBAChC,IAAI,CAAC,KAAK,KAAK,KAAK,EACpB,CAAC;wBACD,OAAO;oBACT,CAAC;oBACD,MAAM,YAAY,GAA8B,EAAE,CAAC;oBACnD,KAAK,MAAM,MAAM,IAAI,IAAI,CAAC,MAAM,IAAI,EAAE,EAAE,CAAC;wBACvC,IAAI,CAAC;4BACH,YAAY,CAAC,IAAI,CAAC;gCAChB,QAAQ,EAAE,MAAM,CAAC,MAAM,CAAC,QAAQ,CAAC;gCACjC,KAAK,EAAE,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,KAAK,CAAC;6BAChC,CAAC,CAAC;wBACL,CAAC;wBAAC,MAAM,CAAC;4BACP,6BAA6B;wBAC/B,CAAC;oBACH,CAAC;oBACD,MAAM,OAAO,GAAG,8BAA8B,CAC5C,iBAAiB,CAAC,SAAS,EAA0B,EACrD,YAAY,CAAC,QAAQ,EACrB,YAAY,CACb,CAAC;oBACF,IACE,OAAO,CAAC,KAAK,CAAC,MAAM;wBACpB,OAAO,CAAC,OAAO,CAAC,MAAM;wBACtB,OAAO,CAAC,OAAO,CAAC,MAAM,EACtB,CAAC;wBACD,iBAAiB,CAAC,IAAI,CAAC,QAAQ,EAAE,CAAC,OAAO,EAAE,QAAQ,CAAC,CAAC,CAAC;oBACxD,CAAC;gBACH,CAAC;gBAAC,MAAM,CAAC;oBACP,6DAA6D;gBAC/D,CAAC;YACH,CAAC,CAAC;YACF,MAAM,CAAC,OAAO,GAAG,GAAG,EAAE;gBACpB,kEAAkE;gBAClE,IAAI,MAAM,IAAI,MAAM,CAAC,UAAU,KAAK,WAAW,CAAC,MAAM,EAAE,CAAC;oBACvD,MAAM,GAAG,IAAI,CAAC;gBAChB,CAAC;YACH,CAAC,CAAC;QACJ,CAAC;QAED,OAAO,EAAE,CAAC;QAEV,SAAS,OAAO;YACd,IAAI,CAAC,MAAM,IAAI,MAAM,CAAC,UAAU,KAAK,WAAW,CAAC,MAAM,EAAE,CAAC;gBACxD,MAAM,EAAE,KAAK,EAAE,CAAC;gBAChB,MAAM,GAAG,IAAI,CAAC;gBACd,OAAO,EAAE,CAAC;YACZ,CAAC;QACH,CAAC;QAED,MAAM,CAAC,gBAAgB,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC;QAC1C,OAAO,GAAG,EAAE;YACV,OAAO,GAAG,IAAI,CAAC;YACf,MAAM,EAAE,KAAK,EAAE,CAAC;YAChB,MAAM,GAAG,IAAI,CAAC;YACd,MAAM,CAAC,mBAAmB,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC;QAC/C,CAAC,CAAC;IACJ,CAAC,EAAE,CAAC,IAAI,EAAE,KAAK,EAAE,SAAS,CAAC,CAAC,CAAC;IAE7B,OAAO;QACL,IAAI;QACJ,SAAS;QACT,SAAS;QACT,QAAQ;QACR,WAAW;QACX,WAAW;QACX,YAAY;KACb,CAAC;AACJ,CAAC","sourcesContent":["/*\n Client-side hook for collaborative document editing via Yjs.\n \n Creates a STABLE Y.Doc per docId that never changes identity. This allows\n * TipTap's Collaboration extension to bind once without editor recreation.\n * Server state is applied to the existing doc when it arrives.\n \n Also manages Yjs Awareness for cursor positions and user presence,\n * synced via polling to the server's awareness endpoint.\n \n Transport improvements (vs previous version):\n * - Local update POSTs are debounced and coalesced with Y.mergeUpdates (~80ms)\n * to avoid per-keystroke requests. The batch is flushed immediately on\n * visibilitychange/pagehide and before each poll/awareness cycle.\n * - GET state?stateVector= is NOT fetched on every poll cycle. It is fetched:\n * (a) on (re)connect / initial load, (b) when a poll response indicates a\n * gap (version jump > ring-buffer size), (c) after applying an update fails,\n * and (d) as a low-frequency safety net every STATE_VECTOR_FETCH_INTERVAL\n * poll cycles (~15×).\n * - Network errors use exponential backoff with jitter (cap ~15s), reset on\n * success.\n * - SSE fast-path: collab events are received push-style from\n * /_agent-native/events (the framework SSE stream). While SSE is\n * healthy the poll loop relaxes to a slow cadence (10–15s). If SSE is\n * unavailable the 2s poll resumes automatically.\n /\n\nimport { useEffect, useRef, useState, useMemo } from \"react\";\nimport { Awareness } from \"y-protocols/awareness\";\nimport as Y from \"yjs\";\n\nimport { agentNativePath } from \"../client/api-path.js\";\nimport { AGENT_CLIENT_ID } from \"./agent-identity.js\";\n\nexport interface CollabUser {\n name: string;\n email: string;\n color: string;\n}\n\nexport interface UseCollaborativeDocOptions {\n /** Document ID to collaborate on. Pass null to disable. /\n docId: string \| null;\n /* Poll interval in ms when SSE is unavailable. Default: 2000 /\n pollInterval?: number;\n /* Poll interval in ms while SSE is healthy. Default: 12000 /\n pollIntervalWithSse?: number;\n /* Pause remote update/presence polling while the tab is hidden. Default: true /\n pauseWhenHidden?: boolean;\n /* Base URL for collab endpoints. Default: \"/_agent-native/collab\" /\n baseUrl?: string;\n /* Request source ID for jitter prevention (e.g., tab ID). /\n requestSource?: string;\n /* Current user info for cursor labels. /\n user?: CollabUser;\n}\n\nexport interface UseCollaborativeDocResult {\n /* The Yjs document instance. Stable per docId — never changes identity. /\n ydoc: Y.Doc \| null;\n /* Yjs Awareness instance for cursor/presence sync. /\n awareness: Awareness \| null;\n /* Whether the initial state is still loading from the server. /\n isLoading: boolean;\n /* Whether the doc is synced with the server. /\n isSynced: boolean;\n /* Active users on this document (from awareness). /\n activeUsers: CollabUser[];\n /* True briefly when the AI agent makes an edit (for presence indicator). /\n agentActive: boolean;\n /* True when the AI agent has an active awareness entry (durable presence). /\n agentPresent: boolean;\n}\n\n// Consistent color palette for user cursors\nconst CURSOR_COLORS = [\n \"#f87171\",\n \"#fb923c\",\n \"#fbbf24\",\n \"#a3e635\",\n \"#34d399\",\n \"#22d3ee\",\n \"#60a5fa\",\n \"#14b8a6\",\n \"#f472b6\",\n \"#e879f9\",\n];\n\n/* Hash a string to a consistent color from the palette. /\nexport function emailToColor(email: string): string {\n let hash = 0;\n for (let i = 0; i < email.length; i++) {\n hash = ((hash << 5) - hash + email.charCodeAt(i)) \| 0;\n }\n return CURSOR_COLORS[Math.abs(hash) % CURSOR_COLORS.length];\n}\n\n/* Derive a display name from an email address. /\nexport function emailToName(email: string): string {\n const local = email.split(\"@\")[0] \|\| email;\n return local.charAt(0).toUpperCase() + local.slice(1);\n}\n\nfunction normalizeCollabEmail(email: string): string {\n return email.trim().toLowerCase();\n}\n\nfunction isDocumentHidden(): boolean {\n return (\n typeof document !== \"undefined\" && document.visibilityState === \"hidden\"\n );\n}\n\nexport function dedupeCollabUsersByEmail(users: CollabUser[]): CollabUser[] {\n const byEmail = new Map<string, CollabUser>();\n for (const user of users) {\n const email = normalizeCollabEmail(user.email);\n if (!email \|\| byEmail.has(email)) continue;\n byEmail.set(email, {\n name: user.name \|\| emailToName(email),\n email,\n color: user.color \|\| emailToColor(email),\n });\n }\n return Array.from(byEmail.values());\n}\n\n/\n Leader election for applying authoritative external snapshots into a shared\n * collaborative document.\n \n When the agent (or a Notion pull, or any full-document rewrite) writes new\n * content to SQL, the open editor reconciles it into the live Y.Doc with\n * `setContent`. If EVERY connected client did that independently, each would\n * diff the same snapshot into the CRDT and the changed region would be inserted\n * N times (concurrent inserts at the same position → duplicated text). So only\n * ONE client — the \"lead\" — applies the snapshot; every other client receives\n * the result through normal Yjs sync.\n \n The lead is the present client with the lowest Yjs `clientID`. The agent's\n * awareness entry uses `AGENT_CLIENT_ID` (max int) so it can never be the lead,\n * and a client editing alone is always the lead. This is deterministic across\n * clients with no coordination round-trip.\n /\nexport function isReconcileLeadClient(\n awareness: Awareness \| null \| undefined,\n localClientId: number \| null \| undefined,\n): boolean {\n if (localClientId == null) return false;\n if (!awareness) return true; // standalone / tests — act alone\n\n let hasPeer = false;\n let minVisible = localClientId;\n awareness.getStates().forEach((state, clientId) => {\n if (clientId === AGENT_CLIENT_ID) return; // agent never leads\n if (clientId === localClientId) return;\n const s = state as { user?: unknown; visible?: boolean };\n if (!s \|\| !s.user) return; // skip empty/stale entries\n hasPeer = true;\n // Only VISIBLE peers can act; a peer published `visible: false` (backgrounded)\n // is skipped. A peer that hasn't published the field is treated as visible.\n if (s.visible !== false && clientId < minVisible) minVisible = clientId;\n });\n\n // Sole client: always the applier — no other client can duplicate the edit,\n // so single-user agent edits apply even if this tab reports hidden.\n if (!hasPeer) return true;\n\n // With peers present, exactly one VISIBLE client applies (the lowest clientId\n // among visible ones). A backgrounded tab pauses its poll and can't reliably\n // act, so it yields — otherwise an agent edit would never reach the tab the\n // user is actually looking at. The caller re-elects on visibility change.\n const localHidden =\n typeof document !== \"undefined\" && document.visibilityState === \"hidden\";\n if (localHidden) return false;\n return localClientId <= minVisible;\n}\n\nexport interface RemoteAwarenessSnapshot {\n clientId: number;\n state: unknown;\n}\n\nexport function reconcileRemoteAwarenessStates(\n states: Map<number, unknown>,\n localClientId: number,\n remoteStates: RemoteAwarenessSnapshot[],\n): { added: number[]; updated: number[]; removed: number[] } {\n const incoming = new Set<number>();\n const added: number[] = [];\n const updated: number[] = [];\n const removed: number[] = [];\n\n for (const remote of remoteStates) {\n if (\n !Number.isFinite(remote.clientId) \|\|\n remote.clientId === localClientId\n ) {\n continue;\n }\n incoming.add(remote.clientId);\n const hadState = states.has(remote.clientId);\n states.set(remote.clientId, remote.state);\n (hadState ? updated : added).push(remote.clientId);\n }\n\n for (const clientId of Array.from(states.keys())) {\n if (clientId === localClientId) continue;\n if (incoming.has(clientId)) continue;\n states.delete(clientId);\n removed.push(clientId);\n }\n\n return { added, updated, removed };\n}\n\n// Base64 helpers\nfunction uint8ArrayToBase64(arr: Uint8Array): string {\n let binary = \"\";\n for (let i = 0; i < arr.length; i++) {\n binary += String.fromCharCode(arr[i]);\n }\n return btoa(binary);\n}\n\nfunction base64ToUint8Array(b64: string): Uint8Array {\n const binary = atob(b64);\n const arr = new Uint8Array(binary.length);\n for (let i = 0; i < binary.length; i++) {\n arr[i] = binary.charCodeAt(i);\n }\n return arr;\n}\n\n/* Debounce delay for coalescing local Yjs update POSTs (ms). /\nconst UPDATE_DEBOUNCE_MS = 80;\n\n/* Fetch state-vector every N poll cycles as a low-frequency safety net. /\nconst STATE_VECTOR_FETCH_INTERVAL = 15;\n\n/* Poll ring-buffer size on the server (MAX_BUFFER in poll.ts). /\nconst POLL_RING_BUFFER_SIZE = 200;\n\n/* Exponential backoff: base delay (ms), multiplier, cap (ms). /\nconst BACKOFF_BASE_MS = 500;\nconst BACKOFF_MAX_MS = 15_000;\n\nfunction calcBackoff(consecutiveErrors: number): number {\n const exp = Math.min(consecutiveErrors, 10);\n const delay = BACKOFF_BASE_MS Math.pow(2, exp);\n // Add jitter: ±25%\n const jitter = delay * 0.25 * (Math.random() * 2 - 1);\n return Math.min(delay + jitter, BACKOFF_MAX_MS);\n}\n\n// ---------------------------------------------------------------------------\n// Fast awareness helper — throttled per (docId, ydocId) pair so multiple\n// setLocalStateField calls within a 150ms window are coalesced into one POST.\n// ---------------------------------------------------------------------------\n\nconst _awarenessThrottleTimers = new Map<\n string,\n ReturnType<typeof setTimeout>\n>();\n\nfunction scheduleAwarenessPush(\n baseUrl: string,\n docId: string,\n clientId: number,\n getState: () => Record<string, unknown> \| null,\n): void {\n if (typeof window === \"undefined\") return;\n const key = `${docId}::${clientId}`;\n if (_awarenessThrottleTimers.has(key)) return; // already scheduled\n\n const timer = setTimeout(() => {\n _awarenessThrottleTimers.delete(key);\n const state = getState();\n fetch(`${baseUrl}/${docId}/awareness`, {\n method: \"POST\",\n headers: { \"Content-Type\": \"application/json\" },\n body: JSON.stringify({\n clientId,\n state: state ? JSON.stringify(state) : null,\n }),\n }).catch(() => {}); // best-effort; poll cycle is the baseline fallback\n }, 150);\n\n _awarenessThrottleTimers.set(key, timer);\n}\n\nexport function useCollaborativeDoc(\n options: UseCollaborativeDocOptions,\n): UseCollaborativeDocResult {\n const {\n docId,\n pollInterval = 2000,\n pollIntervalWithSse = 12000,\n pauseWhenHidden = true,\n baseUrl = agentNativePath(\"/_agent-native/collab\"),\n requestSource,\n user,\n } = options;\n\n // Stable Y.Doc per docId\n const ydoc = useMemo(() => {\n if (!docId) return null;\n return new Y.Doc();\n }, [docId]);\n\n // Stable Awareness per ydoc\n const awareness = useMemo(() => {\n if (!ydoc) return null;\n return new Awareness(ydoc);\n }, [ydoc]);\n\n const [isLoading, setIsLoading] = useState(!!docId);\n const [isSynced, setIsSynced] = useState(false);\n const [activeUsers, setActiveUsers] = useState<CollabUser[]>([]);\n const [agentActive, setAgentActive] = useState(false);\n const [agentPresent, setAgentPresent] = useState(false);\n // Set when the initial state fetch returns 404/403 — stops the awareness\n // poll so we don't spam the console with errors against a doc that doesn't\n // exist or isn't accessible.\n const [docMissing, setDocMissing] = useState(false);\n const agentTimerRef = useRef<ReturnType<typeof setTimeout> \| null>(null);\n const pollVersionRef = useRef(0);\n\n // Set local awareness state (user info for cursor labels). Also publish this\n // tab's visibility so peers can elect a VISIBLE client to apply external\n // snapshots (see isReconcileLeadClient) — a backgrounded tab pauses its poll\n // and must not hold that role.\n useEffect(() => {\n if (!awareness \|\| !user) return;\n awareness.setLocalStateField(\"user\", {\n name: user.name,\n email: user.email,\n color: user.color,\n });\n awareness.setLocalStateField(\"visible\", !isDocumentHidden());\n }, [awareness, user?.name, user?.email, user?.color]);\n\n // Fast awareness push: whenever local state changes (e.g. cursor moves,\n // setPresence() calls), schedule a throttled POST so peers receive updates\n // at ~150ms instead of waiting for the next 2s poll cycle. The poll cycle\n // remains the authoritative baseline (cursors degrade gracefully without SSE).\n useEffect(() => {\n if (!awareness \|\| !ydoc \|\| !docId \|\| !user) return;\n const clientId = ydoc.clientID;\n\n const onLocalStateChange = () => {\n scheduleAwarenessPush(\n baseUrl,\n docId,\n clientId,\n () => awareness.getLocalState() as Record<string, unknown> \| null,\n );\n };\n\n // awareness emits \"change\" for local state changes too (when origin is \"local\").\n awareness.on(\"change\", onLocalStateChange);\n return () => {\n awareness.off(\"change\", onLocalStateChange);\n };\n }, [awareness, ydoc, docId, baseUrl, user]);\n\n // Track active users from awareness changes\n useEffect(() => {\n if (!awareness) return;\n\n const updateUsers = () => {\n const users: CollabUser[] = [];\n let hasAgent = false;\n awareness.getStates().forEach((state, clientId) => {\n if (clientId === ydoc?.clientID) return; // Skip self\n if (state.user) {\n users.push(state.user as CollabUser);\n if ((state.user as CollabUser).email === \"agent@system\") {\n hasAgent = true;\n }\n }\n });\n setActiveUsers(dedupeCollabUsersByEmail(users));\n setAgentPresent(hasAgent);\n };\n\n awareness.on(\"change\", updateUsers);\n return () => {\n awareness.off(\"change\", updateUsers);\n };\n }, [awareness, ydoc]);\n\n // Clean up on unmount or docId change\n useEffect(() => {\n return () => {\n awareness?.destroy();\n ydoc?.destroy();\n };\n }, [ydoc, awareness]);\n\n // Fetch server state and apply to existing doc\n useEffect(() => {\n if (!ydoc \|\| !docId) {\n setIsLoading(false);\n return;\n }\n\n let cancelled = false;\n setIsLoading(true);\n setIsSynced(false);\n setDocMissing(false);\n\n fetch(`${baseUrl}/${docId}/state`)\n .then(async (res) => {\n if (cancelled) return;\n if (res.status === 404 \|\| res.status === 403) {\n setDocMissing(true);\n setIsLoading(false);\n setIsSynced(true);\n return;\n }\n const data = (await res.json().catch(() => null)) as {\n state?: string;\n } \| null;\n if (data?.state) {\n const binary = base64ToUint8Array(data.state);\n if (binary.length > 4) {\n Y.applyUpdate(ydoc, binary, \"remote\");\n }\n }\n setIsLoading(false);\n setIsSynced(true);\n })\n .catch(() => {\n if (cancelled) return;\n setIsLoading(false);\n setIsSynced(true);\n });\n\n return () => {\n cancelled = true;\n };\n }, [ydoc, docId, baseUrl]);\n\n // Send local updates to server — debounced and coalesced with Y.mergeUpdates.\n //\n // Instead of firing one POST per Yjs update (one per keystroke), we accumulate\n // updates in a buffer for UPDATE_DEBOUNCE_MS then merge them into a single\n // request. The buffer is also flushed immediately on visibilitychange/pagehide\n // and before each poll/awareness cycle so we don't hold stale local state.\n useEffect(() => {\n if (!ydoc \|\| !docId \|\| docMissing) return;\n\n let pendingUpdates: Uint8Array[] = [];\n let flushTimer: ReturnType<typeof setTimeout> \| null = null;\n\n const flushPendingUpdates = (keepalive = false) => {\n if (flushTimer) {\n clearTimeout(flushTimer);\n flushTimer = null;\n }\n if (pendingUpdates.length === 0) return;\n const toSend = pendingUpdates;\n pendingUpdates = [];\n\n const merged = toSend.length === 1 ? toSend[0] : Y.mergeUpdates(toSend);\n fetch(`${baseUrl}/${docId}/update`, {\n method: \"POST\",\n headers: { \"Content-Type\": \"application/json\" },\n body: JSON.stringify({\n update: uint8ArrayToBase64(merged),\n requestSource,\n }),\n ...(keepalive ? { keepalive: true } : {}),\n }).catch(() => {});\n };\n\n // Expose flush to the poll loop via a ref so it can flush before each cycle.\n // We store the flusher in a closure-captured variable; the poll effect\n // below reads it through the shared `pendingFlushRef`.\n (ydoc as any).__collabFlush = flushPendingUpdates;\n\n const handler = (update: Uint8Array, origin: unknown) => {\n if (origin === \"remote\") return;\n pendingUpdates.push(update);\n if (flushTimer) clearTimeout(flushTimer);\n flushTimer = setTimeout(flushPendingUpdates, UPDATE_DEBOUNCE_MS);\n };\n\n const handlePageHide = () => {\n flushPendingUpdates(true /* keepalive /);\n };\n\n ydoc.on(\"update\", handler);\n if (typeof window !== \"undefined\") {\n window.addEventListener(\"pagehide\", handlePageHide);\n }\n\n return () => {\n ydoc.off(\"update\", handler);\n delete (ydoc as any).__collabFlush;\n if (typeof window !== \"undefined\") {\n window.removeEventListener(\"pagehide\", handlePageHide);\n }\n // Flush any remaining updates on teardown\n flushPendingUpdates(true);\n };\n }, [ydoc, docId, baseUrl, requestSource, docMissing]);\n\n // Poll for remote doc updates + awareness sync, with SSE fast-path.\n useEffect(() => {\n if (!ydoc \|\| !docId \|\| docMissing) return;\n // Non-null capture: null branch returned early above; async closures lose\n // the narrowing on the outer ydoc variable.\n const doc: Y.Doc = ydoc;\n\n let stopped = false;\n let timer: ReturnType<typeof setTimeout> \| null = null;\n let consecutiveErrors = 0;\n let pollCycleCount = 0;\n // Track the last version we successfully polled. Used to detect ring-buffer\n // overflow (version gap larger than the ring buffer).\n let lastPolledVersion = pollVersionRef.current;\n\n // SSE connection state. When SSE is healthy, poll interval is relaxed.\n let sseActive = false;\n let sseEventSource: EventSource \| null = null;\n\n // ── SSE fast-path ────────────────────────────────────────────────\n // Wire into the framework /_agent-native/events SSE stream.\n // Collab update events arrive push-style; we apply them immediately,\n // avoiding ~2s polling latency for peer edits.\n //\n // NOTE: SSE events are subject to the same server-side access scoping as\n // polling — the server only pushes events that canSeeChangeForUser allows.\n // The server tags collab events with owner/orgId (security commit).\n function initSSE() {\n if (typeof EventSource === \"undefined\") return;\n try {\n const es = new EventSource(agentNativePath(\"/_agent-native/events\"));\n sseEventSource = es;\n\n es.onopen = () => {\n sseActive = true;\n consecutiveErrors = 0;\n };\n\n es.onmessage = (ev) => {\n try {\n const change = JSON.parse(ev.data) as {\n source?: string;\n docId?: string;\n update?: string;\n requestSource?: string;\n version?: number;\n };\n\n if (\n change.source === \"collab\" &&\n change.docId === docId &&\n change.update\n ) {\n if (requestSource && change.requestSource === requestSource)\n return;\n try {\n Y.applyUpdate(doc, base64ToUint8Array(change.update), \"remote\");\n } catch {\n // Malformed update — trigger state-vector fetch on next poll\n }\n\n if (change.requestSource === \"agent\") {\n setAgentActive(true);\n if (agentTimerRef.current) clearTimeout(agentTimerRef.current);\n agentTimerRef.current = setTimeout(\n () => setAgentActive(false),\n 3000,\n );\n }\n }\n\n // Keep pollVersionRef updated from SSE events so the poll loop\n // starts from the right version when SSE drops.\n if (typeof change.version === \"number\") {\n pollVersionRef.current = Math.max(\n pollVersionRef.current,\n change.version,\n );\n }\n } catch {\n // Ignore malformed events\n }\n };\n\n es.onerror = () => {\n sseActive = false;\n es.close();\n sseEventSource = null;\n // Retry SSE after a short delay\n if (!stopped) {\n setTimeout(initSSE, 5_000 + Math.random() 5_000);\n }\n };\n } catch {\n // SSE not available (edge runtime, etc.) — fall back to polling only\n sseActive = false;\n }\n }\n\n // Only set up SSE in browser environments that support it.\n if (typeof EventSource !== \"undefined\") {\n initSSE();\n }\n\n // ── Poll loop ───────────────────────────────────────────────────\n function getActivePollInterval(): number {\n return sseActive ? pollIntervalWithSse : pollInterval;\n }\n\n function schedulePoll() {\n if (stopped) return;\n if (pauseWhenHidden && isDocumentHidden()) return;\n timer = setTimeout(poll, getActivePollInterval());\n }\n\n async function fetchStateVector(): Promise<void> {\n try {\n const stateVector = uint8ArrayToBase64(Y.encodeStateVector(doc));\n const stateRes = await fetch(\n `${baseUrl}/${docId}/state?stateVector=${encodeURIComponent(stateVector)}`,\n );\n if (stateRes.ok) {\n const stateData = (await stateRes.json().catch(() => null)) as {\n state?: string;\n } \| null;\n if (stateData?.state) {\n const binary = base64ToUint8Array(stateData.state);\n if (binary.length > 2) {\n Y.applyUpdate(doc, binary, \"remote\");\n }\n }\n }\n } catch {\n // Non-fatal; the next poll cycle will retry\n }\n }\n\n async function poll() {\n if (stopped) return;\n\n // Flush any pending local updates before polling so the server has the\n // latest state before we read remote changes.\n const flush = (ydoc as any).__collabFlush as\n \| ((keepalive?: boolean) => void)\n \| undefined;\n flush?.();\n\n try {\n const res = await fetch(\n agentNativePath(\n `/_agent-native/poll?since=${pollVersionRef.current}`,\n ),\n );\n if (!res.ok) throw new Error(\"HTTP \" + res.status);\n\n const data = await res.json();\n const { version, events } = data as {\n version: number;\n events: Array<{\n source: string;\n docId?: string;\n update?: string;\n requestSource?: string;\n }>;\n };\n\n // Detect ring-buffer overflow: if the version jumped by more than the\n // ring buffer size, some events were evicted and we need a state-vector\n // fetch to reconcile the gap.\n const versionGap = version - lastPolledVersion;\n const hadGap = versionGap > POLL_RING_BUFFER_SIZE;\n\n for (const evt of events) {\n if (evt.source === \"collab\" && evt.docId === docId && evt.update) {\n if (requestSource && evt.requestSource === requestSource) continue;\n try {\n Y.applyUpdate(doc, base64ToUint8Array(evt.update), \"remote\");\n } catch {\n // Failed to apply — fetch full state-vector below\n await fetchStateVector();\n }\n\n if (evt.requestSource === \"agent\") {\n setAgentActive(true);\n if (agentTimerRef.current) clearTimeout(agentTimerRef.current);\n agentTimerRef.current = setTimeout(\n () => setAgentActive(false),\n 3000,\n );\n }\n }\n }\n\n pollVersionRef.current = version;\n lastPolledVersion = version;\n pollCycleCount++;\n consecutiveErrors = 0;\n\n // Fetch state-vector only when needed:\n // 1. Ring-buffer overflow detected (missed events).\n // 2. Low-frequency safety net every STATE_VECTOR_FETCH_INTERVAL cycles.\n // 3. NOT on every cycle (the previous behavior causing 3 requests/cycle).\n const shouldFetchStateVector =\n hadGap \|\| pollCycleCount % STATE_VECTOR_FETCH_INTERVAL === 0;\n\n if (shouldFetchStateVector) {\n await fetchStateVector();\n }\n\n // Sync awareness (cursor positions)\n if (awareness) {\n const localState = awareness.getLocalState();\n if (localState) {\n try {\n const awarenessRes = await fetch(\n `${baseUrl}/${docId}/awareness`,\n {\n method: \"POST\",\n headers: { \"Content-Type\": \"application/json\" },\n body: JSON.stringify({\n clientId: doc.clientID,\n state: JSON.stringify(localState),\n }),\n },\n );\n if (awarenessRes.ok) {\n const awarenessData = await awarenessRes.json();\n const remoteStates: RemoteAwarenessSnapshot[] = [];\n for (const remote of awarenessData.states \|\| []) {\n try {\n const remoteState = JSON.parse(remote.state);\n remoteStates.push({\n clientId: Number(remote.clientId),\n state: remoteState,\n });\n } catch {\n // Invalid state — skip\n }\n }\n const changes = reconcileRemoteAwarenessStates(\n awareness.getStates() as Map<number, unknown>,\n doc.clientID,\n remoteStates,\n );\n if (\n changes.added.length \|\|\n changes.updated.length \|\|\n changes.removed.length\n ) {\n awareness.emit(\"change\", [changes, \"remote\"]);\n }\n }\n } catch {\n // Awareness sync failure is non-fatal\n }\n }\n }\n } catch {\n // Network error — exponential backoff\n consecutiveErrors++;\n const backoff = calcBackoff(consecutiveErrors);\n if (!stopped) {\n timer = setTimeout(poll, backoff);\n return;\n }\n }\n\n schedulePoll();\n }\n\n function pollNow() {\n if (pauseWhenHidden && isDocumentHidden()) return;\n if (timer) {\n clearTimeout(timer);\n timer = null;\n }\n void poll();\n }\n\n // Publish this tab's visibility to peers. A hidden tab pauses its poll, so\n // we push the state immediately (keepalive) instead of waiting for the next\n // cycle — otherwise peers keep treating a backgrounded tab as the visible\n // lead and an agent edit never lands on the tab the user is actually viewing.\n function publishVisibility(visible: boolean) {\n if (!awareness) return;\n awareness.setLocalStateField(\"visible\", visible);\n const localState = awareness.getLocalState();\n if (!localState) return;\n fetch(`${baseUrl}/${docId}/awareness`, {\n method: \"POST\",\n headers: { \"Content-Type\": \"application/json\" },\n body: JSON.stringify({\n clientId: doc.clientID,\n state: JSON.stringify(localState),\n }),\n keepalive: true,\n }).catch(() => {});\n }\n\n function handleVisibilityChange() {\n const visible = document.visibilityState === \"visible\";\n publishVisibility(visible);\n if (visible) {\n // Also flush any pending updates when coming back into view\n const flush = (ydoc as any).__collabFlush as\n \| ((keepalive?: boolean) => void)\n \| undefined;\n flush?.();\n pollNow();\n } else if (pauseWhenHidden && timer) {\n clearTimeout(timer);\n timer = null;\n }\n }\n\n if (!pauseWhenHidden \|\| !isDocumentHidden()) {\n void poll();\n }\n window.addEventListener(\"focus\", pollNow);\n document.addEventListener(\"visibilitychange\", handleVisibilityChange);\n\n return () => {\n stopped = true;\n if (timer) clearTimeout(timer);\n if (sseEventSource) {\n sseEventSource.close();\n sseEventSource = null;\n }\n window.removeEventListener(\"focus\", pollNow);\n document.removeEventListener(\"visibilitychange\", handleVisibilityChange);\n };\n }, [\n ydoc,\n awareness,\n docId,\n pollInterval,\n pollIntervalWithSse,\n pauseWhenHidden,\n requestSource,\n baseUrl,\n docMissing,\n ]);\n\n // SSE fast-path for awareness: subscribe to the framework events stream and\n // apply any awareness-change events immediately so peers receive cursor\n // moves push-style without waiting for the next poll cycle.\n // Polling fallback keeps working when SSE is unavailable.\n useEffect(() => {\n if (!ydoc \|\| !docId \|\| !awareness \|\| typeof EventSource === \"undefined\") {\n return;\n }\n // Non-null captures for closures: null branches returned early above.\n const capturedYdoc = ydoc;\n const capturedAwareness = awareness;\n const sseUrl = agentNativePath(\"/_agent-native/events\");\n let source: EventSource \| null = null;\n let stopped = false;\n\n function connect() {\n if (stopped \|\| source) return;\n source = new EventSource(sseUrl);\n source.onmessage = (msg) => {\n if (stopped) return;\n try {\n const data = JSON.parse(msg.data as string) as {\n source?: string;\n type?: string;\n docId?: string;\n states?: Array<{ clientId: number; state: string }>;\n };\n if (\n data.source !== \"awareness\" \|\|\n data.type !== \"awareness-change\" \|\|\n data.docId !== docId\n ) {\n return;\n }\n const remoteStates: RemoteAwarenessSnapshot[] = [];\n for (const remote of data.states ?? []) {\n try {\n remoteStates.push({\n clientId: Number(remote.clientId),\n state: JSON.parse(remote.state),\n });\n } catch {\n // Invalid state entry — skip\n }\n }\n const changes = reconcileRemoteAwarenessStates(\n capturedAwareness.getStates() as Map<number, unknown>,\n capturedYdoc.clientID,\n remoteStates,\n );\n if (\n changes.added.length \|\|\n changes.updated.length \|\|\n changes.removed.length\n ) {\n capturedAwareness.emit(\"change\", [changes, \"remote\"]);\n }\n } catch {\n // Ignore malformed SSE frames; poll cycle is the safety net.\n }\n };\n source.onerror = () => {\n // On permanent close let go of the ref so re-focus can reconnect.\n if (source && source.readyState === EventSource.CLOSED) {\n source = null;\n }\n };\n }\n\n connect();\n\n function onFocus() {\n if (!source \|\| source.readyState === EventSource.CLOSED) {\n source?.close();\n source = null;\n connect();\n }\n }\n\n window.addEventListener(\"focus\", onFocus);\n return () => {\n stopped = true;\n source?.close();\n source = null;\n window.removeEventListener(\"focus\", onFocus);\n };\n }, [ydoc, docId, awareness]);\n\n return {\n ydoc,\n awareness,\n isLoading,\n isSynced,\n activeUsers,\n agentActive,\n agentPresent,\n };\n}\n"]}
1	+ {"version":3,"file":"client.js","sourceRoot":"","sources":["../../src/collab/client.ts"],"names":[],"mappings":"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","sourcesContent":["/*\n Client-side hook for collaborative document editing via Yjs.\n \n Creates a STABLE Y.Doc per docId that never changes identity. This allows\n * TipTap's Collaboration extension to bind once without editor recreation.\n * Server state is applied to the existing doc when it arrives.\n \n Also manages Yjs Awareness for cursor positions and user presence,\n * synced via polling to the server's awareness endpoint.\n \n Transport improvements (vs previous version):\n * - Local update POSTs are debounced and coalesced with Y.mergeUpdates (~80ms)\n * to avoid per-keystroke requests. The batch is flushed immediately on\n * visibilitychange/pagehide and before each poll/awareness cycle.\n * - GET state?stateVector= is NOT fetched on every poll cycle. It is fetched:\n * (a) on (re)connect / initial load, (b) when a poll response indicates a\n * gap (version jump > ring-buffer size), (c) after applying an update fails,\n * and (d) as a low-frequency safety net every STATE_VECTOR_FETCH_INTERVAL\n * poll cycles (~15×).\n * - Network errors use exponential backoff with jitter (cap ~15s), reset on\n * success.\n * - SSE fast-path: collab events are received push-style from\n * /_agent-native/events (the framework SSE stream). While SSE is\n * healthy the poll loop relaxes to a slow cadence (10–15s). If SSE is\n * unavailable the 2s poll resumes automatically.\n /\n\nimport { useEffect, useRef, useState, useMemo } from \"react\";\nimport { Awareness } from \"y-protocols/awareness\";\nimport as Y from \"yjs\";\n\nimport { agentNativePath } from \"../client/api-path.js\";\nimport { subscribeSyncEvents, type SyncEvent } from \"../client/use-db-sync.js\";\nimport { AGENT_CLIENT_ID } from \"./agent-identity.js\";\n\nexport interface CollabUser {\n name: string;\n email: string;\n color: string;\n /** Profile image shown in presence avatars, cursor flags, and edit tags. /\n avatarUrl?: string;\n}\n\nexport interface UseCollaborativeDocOptions {\n /* Document ID to collaborate on. Pass null to disable. /\n docId: string \| null;\n /* Poll interval in ms when SSE is unavailable. Default: 2000 /\n pollInterval?: number;\n /* Poll interval in ms while SSE is healthy. Default: 12000 /\n pollIntervalWithSse?: number;\n /* Pause remote update/presence polling while the tab is hidden. Default: true /\n pauseWhenHidden?: boolean;\n /* Base URL for collab endpoints. Default: \"/_agent-native/collab\" /\n baseUrl?: string;\n /* Request source ID for jitter prevention (e.g., tab ID). /\n requestSource?: string;\n /* Current user info for cursor labels. /\n user?: CollabUser;\n}\n\nexport interface UseCollaborativeDocResult {\n /* The Yjs document instance. Stable per docId — never changes identity. /\n ydoc: Y.Doc \| null;\n /* Yjs Awareness instance for cursor/presence sync. /\n awareness: Awareness \| null;\n /* Whether the initial state is still loading from the server. /\n isLoading: boolean;\n /* Whether the doc is synced with the server. /\n isSynced: boolean;\n /* Active users on this document (from awareness). /\n activeUsers: CollabUser[];\n /* True briefly when the AI agent makes an edit (for presence indicator). /\n agentActive: boolean;\n /* True when the AI agent has an active awareness entry (durable presence). /\n agentPresent: boolean;\n}\n\n// Consistent color palette for user cursors\nconst CURSOR_COLORS = [\n \"#f87171\",\n \"#fb923c\",\n \"#fbbf24\",\n \"#a3e635\",\n \"#34d399\",\n \"#22d3ee\",\n \"#60a5fa\",\n \"#14b8a6\",\n \"#f472b6\",\n \"#e879f9\",\n];\n\n/* Hash a string to a consistent color from the palette. /\nexport function emailToColor(email: string): string {\n let hash = 0;\n for (let i = 0; i < email.length; i++) {\n hash = ((hash << 5) - hash + email.charCodeAt(i)) \| 0;\n }\n return CURSOR_COLORS[Math.abs(hash) % CURSOR_COLORS.length];\n}\n\n/* Derive a display name from an email address. /\nexport function emailToName(email: string): string {\n const local = email.split(\"@\")[0] \|\| email;\n return local.charAt(0).toUpperCase() + local.slice(1);\n}\n\nfunction normalizeCollabEmail(email: string): string {\n return email.trim().toLowerCase();\n}\n\nfunction isDocumentHidden(): boolean {\n return (\n typeof document !== \"undefined\" && document.visibilityState === \"hidden\"\n );\n}\n\nexport function dedupeCollabUsersByEmail(users: CollabUser[]): CollabUser[] {\n const byEmail = new Map<string, CollabUser>();\n for (const user of users) {\n const email = normalizeCollabEmail(user.email);\n if (!email \|\| byEmail.has(email)) continue;\n byEmail.set(email, {\n name: user.name \|\| emailToName(email),\n email,\n color: user.color \|\| emailToColor(email),\n });\n }\n return Array.from(byEmail.values());\n}\n\n/\n Leader election for applying authoritative external snapshots into a shared\n * collaborative document.\n \n When the agent (or a Notion pull, or any full-document rewrite) writes new\n * content to SQL, the open editor reconciles it into the live Y.Doc with\n * `setContent`. If EVERY connected client did that independently, each would\n * diff the same snapshot into the CRDT and the changed region would be inserted\n * N times (concurrent inserts at the same position → duplicated text). So only\n * ONE client — the \"lead\" — applies the snapshot; every other client receives\n * the result through normal Yjs sync.\n \n The lead is the present client with the lowest Yjs `clientID`. The agent's\n * awareness entry uses `AGENT_CLIENT_ID` (max int) so it can never be the lead,\n * and a client editing alone is always the lead. This is deterministic across\n * clients with no coordination round-trip.\n /\nexport function isReconcileLeadClient(\n awareness: Awareness \| null \| undefined,\n localClientId: number \| null \| undefined,\n): boolean {\n if (localClientId == null) return false;\n if (!awareness) return true; // standalone / tests — act alone\n\n let hasPeer = false;\n let minVisible = localClientId;\n awareness.getStates().forEach((state, clientId) => {\n if (clientId === AGENT_CLIENT_ID) return; // agent never leads\n if (clientId === localClientId) return;\n const s = state as { user?: unknown; visible?: boolean };\n if (!s \|\| !s.user) return; // skip empty/stale entries\n hasPeer = true;\n // Only VISIBLE peers can act; a peer published `visible: false` (backgrounded)\n // is skipped. A peer that hasn't published the field is treated as visible.\n if (s.visible !== false && clientId < minVisible) minVisible = clientId;\n });\n\n // Sole client: always the applier — no other client can duplicate the edit,\n // so single-user agent edits apply even if this tab reports hidden.\n if (!hasPeer) return true;\n\n // With peers present, exactly one VISIBLE client applies (the lowest clientId\n // among visible ones). A backgrounded tab pauses its poll and can't reliably\n // act, so it yields — otherwise an agent edit would never reach the tab the\n // user is actually looking at. The caller re-elects on visibility change.\n const localHidden =\n typeof document !== \"undefined\" && document.visibilityState === \"hidden\";\n if (localHidden) return false;\n return localClientId <= minVisible;\n}\n\nexport interface RemoteAwarenessSnapshot {\n clientId: number;\n state: unknown;\n}\n\nexport function reconcileRemoteAwarenessStates(\n states: Map<number, unknown>,\n localClientId: number,\n remoteStates: RemoteAwarenessSnapshot[],\n): { added: number[]; updated: number[]; removed: number[] } {\n const incoming = new Set<number>();\n const added: number[] = [];\n const updated: number[] = [];\n const removed: number[] = [];\n\n for (const remote of remoteStates) {\n if (\n !Number.isFinite(remote.clientId) \|\|\n remote.clientId === localClientId\n ) {\n continue;\n }\n incoming.add(remote.clientId);\n const hadState = states.has(remote.clientId);\n states.set(remote.clientId, remote.state);\n (hadState ? updated : added).push(remote.clientId);\n }\n\n for (const clientId of Array.from(states.keys())) {\n if (clientId === localClientId) continue;\n if (incoming.has(clientId)) continue;\n states.delete(clientId);\n removed.push(clientId);\n }\n\n return { added, updated, removed };\n}\n\n// Base64 helpers\nfunction uint8ArrayToBase64(arr: Uint8Array): string {\n let binary = \"\";\n for (let i = 0; i < arr.length; i++) {\n binary += String.fromCharCode(arr[i]);\n }\n return btoa(binary);\n}\n\nfunction base64ToUint8Array(b64: string): Uint8Array {\n const binary = atob(b64);\n const arr = new Uint8Array(binary.length);\n for (let i = 0; i < binary.length; i++) {\n arr[i] = binary.charCodeAt(i);\n }\n return arr;\n}\n\n/* Debounce delay for coalescing local Yjs update POSTs (ms). /\nconst UPDATE_DEBOUNCE_MS = 80;\n\n/* Fetch state-vector every N poll cycles as a low-frequency safety net. /\nconst STATE_VECTOR_FETCH_INTERVAL = 15;\n\n/* Poll ring-buffer size on the server (MAX_BUFFER in poll.ts). /\nconst POLL_RING_BUFFER_SIZE = 200;\n\n/* Exponential backoff: base delay (ms), multiplier, cap (ms). /\nconst BACKOFF_BASE_MS = 500;\nconst BACKOFF_MAX_MS = 15_000;\n\nfunction calcBackoff(consecutiveErrors: number): number {\n const exp = Math.min(consecutiveErrors, 10);\n const delay = BACKOFF_BASE_MS Math.pow(2, exp);\n // Add jitter: ±25%\n const jitter = delay * 0.25 * (Math.random() * 2 - 1);\n return Math.min(delay + jitter, BACKOFF_MAX_MS);\n}\n\n// ---------------------------------------------------------------------------\n// Fast awareness helper — throttled per (docId, ydocId) pair so multiple\n// setLocalStateField calls within a 150ms window are coalesced into one POST.\n// ---------------------------------------------------------------------------\n\nconst _awarenessThrottleTimers = new Map<\n string,\n ReturnType<typeof setTimeout>\n>();\n\nfunction scheduleAwarenessPush(\n baseUrl: string,\n docId: string,\n clientId: number,\n getState: () => Record<string, unknown> \| null,\n): void {\n if (typeof window === \"undefined\") return;\n const key = `${docId}::${clientId}`;\n if (_awarenessThrottleTimers.has(key)) return; // already scheduled\n\n const timer = setTimeout(() => {\n _awarenessThrottleTimers.delete(key);\n const state = getState();\n fetch(`${baseUrl}/${docId}/awareness`, {\n method: \"POST\",\n headers: { \"Content-Type\": \"application/json\" },\n body: JSON.stringify({\n clientId,\n state: state ? JSON.stringify(state) : null,\n }),\n }).catch(() => {}); // best-effort; poll cycle is the baseline fallback\n }, 150);\n\n _awarenessThrottleTimers.set(key, timer);\n}\n\nexport function useCollaborativeDoc(\n options: UseCollaborativeDocOptions,\n): UseCollaborativeDocResult {\n const {\n docId,\n pollInterval = 2000,\n pollIntervalWithSse = 12000,\n pauseWhenHidden = true,\n baseUrl = agentNativePath(\"/_agent-native/collab\"),\n requestSource,\n user,\n } = options;\n\n // Stable Y.Doc per docId\n const ydoc = useMemo(() => {\n if (!docId) return null;\n return new Y.Doc();\n }, [docId]);\n\n // Stable Awareness per ydoc\n const awareness = useMemo(() => {\n if (!ydoc) return null;\n return new Awareness(ydoc);\n }, [ydoc]);\n\n const [isLoading, setIsLoading] = useState(!!docId);\n const [isSynced, setIsSynced] = useState(false);\n const [activeUsers, setActiveUsers] = useState<CollabUser[]>([]);\n const [agentActive, setAgentActive] = useState(false);\n const [agentPresent, setAgentPresent] = useState(false);\n // Set when the initial state fetch returns 404/403 — stops the awareness\n // poll so we don't spam the console with errors against a doc that doesn't\n // exist or isn't accessible.\n const [docMissing, setDocMissing] = useState(false);\n const agentTimerRef = useRef<ReturnType<typeof setTimeout> \| null>(null);\n const pollVersionRef = useRef(0);\n\n // Set local awareness state (user info for cursor labels). Also publish this\n // tab's visibility so peers can elect a VISIBLE client to apply external\n // snapshots (see isReconcileLeadClient) — a backgrounded tab pauses its poll\n // and must not hold that role.\n useEffect(() => {\n if (!awareness \|\| !user) return;\n awareness.setLocalStateField(\"user\", {\n name: user.name,\n email: user.email,\n color: user.color,\n });\n awareness.setLocalStateField(\"visible\", !isDocumentHidden());\n }, [awareness, user?.name, user?.email, user?.color]);\n\n // Fast awareness push: whenever local state changes (e.g. cursor moves,\n // setPresence() calls), schedule a throttled POST so peers receive updates\n // at ~150ms instead of waiting for the next 2s poll cycle. The poll cycle\n // remains the authoritative baseline (cursors degrade gracefully without SSE).\n useEffect(() => {\n if (!awareness \|\| !ydoc \|\| !docId \|\| !user) return;\n const clientId = ydoc.clientID;\n\n const onLocalStateChange = () => {\n scheduleAwarenessPush(\n baseUrl,\n docId,\n clientId,\n () => awareness.getLocalState() as Record<string, unknown> \| null,\n );\n };\n\n // awareness emits \"change\" for local state changes too (when origin is \"local\").\n awareness.on(\"change\", onLocalStateChange);\n return () => {\n awareness.off(\"change\", onLocalStateChange);\n };\n }, [awareness, ydoc, docId, baseUrl, user]);\n\n // Track active users from awareness changes\n useEffect(() => {\n if (!awareness) return;\n\n const updateUsers = () => {\n const users: CollabUser[] = [];\n let hasAgent = false;\n awareness.getStates().forEach((state, clientId) => {\n if (clientId === ydoc?.clientID) return; // Skip self\n if (state.user) {\n users.push(state.user as CollabUser);\n if ((state.user as CollabUser).email === \"agent@system\") {\n hasAgent = true;\n }\n }\n });\n setActiveUsers(dedupeCollabUsersByEmail(users));\n setAgentPresent(hasAgent);\n };\n\n awareness.on(\"change\", updateUsers);\n return () => {\n awareness.off(\"change\", updateUsers);\n };\n }, [awareness, ydoc]);\n\n // Clean up on unmount or docId change\n useEffect(() => {\n return () => {\n awareness?.destroy();\n ydoc?.destroy();\n };\n }, [ydoc, awareness]);\n\n // Fetch server state and apply to existing doc\n useEffect(() => {\n if (!ydoc \|\| !docId) {\n setIsLoading(false);\n return;\n }\n\n let cancelled = false;\n setIsLoading(true);\n setIsSynced(false);\n setDocMissing(false);\n\n fetch(`${baseUrl}/${docId}/state`)\n .then(async (res) => {\n if (cancelled) return;\n if (res.status === 404 \|\| res.status === 403) {\n setDocMissing(true);\n setIsLoading(false);\n setIsSynced(true);\n return;\n }\n const data = (await res.json().catch(() => null)) as {\n state?: string;\n } \| null;\n if (data?.state) {\n const binary = base64ToUint8Array(data.state);\n if (binary.length > 4) {\n Y.applyUpdate(ydoc, binary, \"remote\");\n }\n }\n setIsLoading(false);\n setIsSynced(true);\n })\n .catch(() => {\n if (cancelled) return;\n setIsLoading(false);\n setIsSynced(true);\n });\n\n return () => {\n cancelled = true;\n };\n }, [ydoc, docId, baseUrl]);\n\n // Send local updates to server — debounced and coalesced with Y.mergeUpdates.\n //\n // Instead of firing one POST per Yjs update (one per keystroke), we accumulate\n // updates in a buffer for UPDATE_DEBOUNCE_MS then merge them into a single\n // request. The buffer is also flushed immediately on visibilitychange/pagehide\n // and before each poll/awareness cycle so we don't hold stale local state.\n useEffect(() => {\n if (!ydoc \|\| !docId \|\| docMissing) return;\n\n let pendingUpdates: Uint8Array[] = [];\n let flushTimer: ReturnType<typeof setTimeout> \| null = null;\n\n const flushPendingUpdates = (keepalive = false) => {\n if (flushTimer) {\n clearTimeout(flushTimer);\n flushTimer = null;\n }\n if (pendingUpdates.length === 0) return;\n const toSend = pendingUpdates;\n pendingUpdates = [];\n\n const merged = toSend.length === 1 ? toSend[0] : Y.mergeUpdates(toSend);\n fetch(`${baseUrl}/${docId}/update`, {\n method: \"POST\",\n headers: { \"Content-Type\": \"application/json\" },\n body: JSON.stringify({\n update: uint8ArrayToBase64(merged),\n requestSource,\n }),\n ...(keepalive ? { keepalive: true } : {}),\n }).catch(() => {});\n };\n\n // Expose flush to the poll loop via a ref so it can flush before each cycle.\n // We store the flusher in a closure-captured variable; the poll effect\n // below reads it through the shared `pendingFlushRef`.\n (ydoc as any).__collabFlush = flushPendingUpdates;\n\n const handler = (update: Uint8Array, origin: unknown) => {\n if (origin === \"remote\") return;\n pendingUpdates.push(update);\n if (flushTimer) clearTimeout(flushTimer);\n flushTimer = setTimeout(flushPendingUpdates, UPDATE_DEBOUNCE_MS);\n };\n\n const handlePageHide = () => {\n flushPendingUpdates(true /* keepalive */);\n };\n\n ydoc.on(\"update\", handler);\n if (typeof window !== \"undefined\") {\n window.addEventListener(\"pagehide\", handlePageHide);\n }\n\n return () => {\n ydoc.off(\"update\", handler);\n delete (ydoc as any).__collabFlush;\n if (typeof window !== \"undefined\") {\n window.removeEventListener(\"pagehide\", handlePageHide);\n }\n // Flush any remaining updates on teardown\n flushPendingUpdates(true);\n };\n }, [ydoc, docId, baseUrl, requestSource, docMissing]);\n\n // Poll for remote doc updates + awareness sync, with SSE fast-path.\n useEffect(() => {\n if (!ydoc \|\| !docId \|\| docMissing) return;\n // Non-null capture: null branch returned early above; async closures lose\n // the narrowing on the outer ydoc variable.\n const doc: Y.Doc = ydoc;\n\n let stopped = false;\n let timer: ReturnType<typeof setTimeout> \| null = null;\n let consecutiveErrors = 0;\n let pollCycleCount = 0;\n // Track the last version we successfully polled. Used to detect ring-buffer\n // overflow (version gap larger than the ring buffer).\n let lastPolledVersion = pollVersionRef.current;\n\n // SSE connection state. When SSE is healthy, poll interval is relaxed.\n let sseActive = false;\n\n // ── SSE fast-path ────────────────────────────────────────────────\n // Subscribe to the SHARED framework transport for /_agent-native/events\n // instead of opening a dedicated EventSource per collab doc. A tab holds\n // exactly one SSE connection regardless of how many docs are mounted —\n // extra streams eat the browser's per-origin connection budget and can\n // starve regular data fetches (worst on HTTP/1.1 dev servers).\n // Collab update events arrive push-style; we apply them immediately,\n // avoiding ~2s polling latency for peer edits.\n //\n // NOTE: SSE events are subject to the same server-side access scoping as\n // polling — the server only pushes events that canSeeChangeForUser allows.\n // The server tags collab events with owner/orgId (security commit).\n const handleSharedEvent = (change: SyncEvent) => {\n if (\n change.source === \"collab\" &&\n change.docId === docId &&\n typeof change.update === \"string\"\n ) {\n if (requestSource && change.requestSource === requestSource) return;\n try {\n Y.applyUpdate(doc, base64ToUint8Array(change.update), \"remote\");\n } catch {\n // Malformed update — trigger state-vector fetch on next poll\n }\n\n if (change.requestSource === \"agent\") {\n setAgentActive(true);\n if (agentTimerRef.current) clearTimeout(agentTimerRef.current);\n agentTimerRef.current = setTimeout(() => setAgentActive(false), 3000);\n }\n }\n\n // Keep pollVersionRef updated from shared-transport events so the poll\n // loop starts from the right version when SSE drops.\n if (typeof change.version === \"number\") {\n pollVersionRef.current = Math.max(\n pollVersionRef.current,\n change.version,\n );\n }\n };\n\n const unsubscribeSharedEvents = subscribeSyncEvents({\n onEvents: (events) => {\n if (stopped) return;\n for (const change of events) handleSharedEvent(change);\n },\n onSseStateChange: (connected) => {\n sseActive = connected;\n if (connected) consecutiveErrors = 0;\n },\n pauseWhenHidden,\n });\n\n // ── Poll loop ───────────────────────────────────────────────────\n function getActivePollInterval(): number {\n return sseActive ? pollIntervalWithSse : pollInterval;\n }\n\n function schedulePoll() {\n if (stopped) return;\n if (pauseWhenHidden && isDocumentHidden()) return;\n timer = setTimeout(poll, getActivePollInterval());\n }\n\n async function fetchStateVector(): Promise<void> {\n try {\n const stateVector = uint8ArrayToBase64(Y.encodeStateVector(doc));\n const stateRes = await fetch(\n `${baseUrl}/${docId}/state?stateVector=${encodeURIComponent(stateVector)}`,\n );\n if (stateRes.ok) {\n const stateData = (await stateRes.json().catch(() => null)) as {\n state?: string;\n } \| null;\n if (stateData?.state) {\n const binary = base64ToUint8Array(stateData.state);\n if (binary.length > 2) {\n Y.applyUpdate(doc, binary, \"remote\");\n }\n }\n }\n } catch {\n // Non-fatal; the next poll cycle will retry\n }\n }\n\n async function poll() {\n if (stopped) return;\n\n // Flush any pending local updates before polling so the server has the\n // latest state before we read remote changes.\n const flush = (ydoc as any).__collabFlush as\n \| ((keepalive?: boolean) => void)\n \| undefined;\n flush?.();\n\n try {\n const res = await fetch(\n agentNativePath(\n `/_agent-native/poll?since=${pollVersionRef.current}`,\n ),\n );\n if (!res.ok) throw new Error(\"HTTP \" + res.status);\n\n const data = await res.json();\n const { version, events } = data as {\n version: number;\n events: Array<{\n source: string;\n docId?: string;\n update?: string;\n requestSource?: string;\n }>;\n };\n\n // Detect ring-buffer overflow: if the version jumped by more than the\n // ring buffer size, some events were evicted and we need a state-vector\n // fetch to reconcile the gap.\n const versionGap = version - lastPolledVersion;\n const hadGap = versionGap > POLL_RING_BUFFER_SIZE;\n\n for (const evt of events) {\n if (evt.source === \"collab\" && evt.docId === docId && evt.update) {\n if (requestSource && evt.requestSource === requestSource) continue;\n try {\n Y.applyUpdate(doc, base64ToUint8Array(evt.update), \"remote\");\n } catch {\n // Failed to apply — fetch full state-vector below\n await fetchStateVector();\n }\n\n if (evt.requestSource === \"agent\") {\n setAgentActive(true);\n if (agentTimerRef.current) clearTimeout(agentTimerRef.current);\n agentTimerRef.current = setTimeout(\n () => setAgentActive(false),\n 3000,\n );\n }\n }\n }\n\n pollVersionRef.current = version;\n lastPolledVersion = version;\n pollCycleCount++;\n consecutiveErrors = 0;\n\n // Fetch state-vector only when needed:\n // 1. Ring-buffer overflow detected (missed events).\n // 2. Low-frequency safety net every STATE_VECTOR_FETCH_INTERVAL cycles.\n // 3. NOT on every cycle (the previous behavior causing 3 requests/cycle).\n const shouldFetchStateVector =\n hadGap \|\| pollCycleCount % STATE_VECTOR_FETCH_INTERVAL === 0;\n\n if (shouldFetchStateVector) {\n await fetchStateVector();\n }\n\n // Sync awareness (cursor positions)\n if (awareness) {\n const localState = awareness.getLocalState();\n if (localState) {\n try {\n const awarenessRes = await fetch(\n `${baseUrl}/${docId}/awareness`,\n {\n method: \"POST\",\n headers: { \"Content-Type\": \"application/json\" },\n body: JSON.stringify({\n clientId: doc.clientID,\n state: JSON.stringify(localState),\n }),\n },\n );\n if (awarenessRes.ok) {\n const awarenessData = await awarenessRes.json();\n const remoteStates: RemoteAwarenessSnapshot[] = [];\n for (const remote of awarenessData.states \|\| []) {\n try {\n const remoteState = JSON.parse(remote.state);\n remoteStates.push({\n clientId: Number(remote.clientId),\n state: remoteState,\n });\n } catch {\n // Invalid state — skip\n }\n }\n const changes = reconcileRemoteAwarenessStates(\n awareness.getStates() as Map<number, unknown>,\n doc.clientID,\n remoteStates,\n );\n if (\n changes.added.length \|\|\n changes.updated.length \|\|\n changes.removed.length\n ) {\n awareness.emit(\"change\", [changes, \"remote\"]);\n }\n }\n } catch {\n // Awareness sync failure is non-fatal\n }\n }\n }\n } catch {\n // Network error — exponential backoff\n consecutiveErrors++;\n const backoff = calcBackoff(consecutiveErrors);\n if (!stopped) {\n timer = setTimeout(poll, backoff);\n return;\n }\n }\n\n schedulePoll();\n }\n\n function pollNow() {\n if (pauseWhenHidden && isDocumentHidden()) return;\n if (timer) {\n clearTimeout(timer);\n timer = null;\n }\n void poll();\n }\n\n // Publish this tab's visibility to peers. A hidden tab pauses its poll, so\n // we push the state immediately (keepalive) instead of waiting for the next\n // cycle — otherwise peers keep treating a backgrounded tab as the visible\n // lead and an agent edit never lands on the tab the user is actually viewing.\n function publishVisibility(visible: boolean) {\n if (!awareness) return;\n awareness.setLocalStateField(\"visible\", visible);\n const localState = awareness.getLocalState();\n if (!localState) return;\n fetch(`${baseUrl}/${docId}/awareness`, {\n method: \"POST\",\n headers: { \"Content-Type\": \"application/json\" },\n body: JSON.stringify({\n clientId: doc.clientID,\n state: JSON.stringify(localState),\n }),\n keepalive: true,\n }).catch(() => {});\n }\n\n function handleVisibilityChange() {\n const visible = document.visibilityState === \"visible\";\n publishVisibility(visible);\n if (visible) {\n // Also flush any pending updates when coming back into view\n const flush = (ydoc as any).__collabFlush as\n \| ((keepalive?: boolean) => void)\n \| undefined;\n flush?.();\n pollNow();\n } else if (pauseWhenHidden && timer) {\n clearTimeout(timer);\n timer = null;\n }\n }\n\n if (!pauseWhenHidden \|\| !isDocumentHidden()) {\n void poll();\n }\n window.addEventListener(\"focus\", pollNow);\n document.addEventListener(\"visibilitychange\", handleVisibilityChange);\n\n return () => {\n stopped = true;\n if (timer) clearTimeout(timer);\n unsubscribeSharedEvents();\n window.removeEventListener(\"focus\", pollNow);\n document.removeEventListener(\"visibilitychange\", handleVisibilityChange);\n };\n }, [\n ydoc,\n awareness,\n docId,\n pollInterval,\n pollIntervalWithSse,\n pauseWhenHidden,\n requestSource,\n baseUrl,\n docMissing,\n ]);\n\n // SSE fast-path for awareness: listen on the SHARED framework transport and\n // apply any awareness-change events immediately so peers receive cursor\n // moves push-style without waiting for the next poll cycle.\n // Polling fallback keeps working when SSE is unavailable. Reconnection and\n // focus/visibility handling live inside the shared transport.\n useEffect(() => {\n if (!ydoc \|\| !docId \|\| !awareness) {\n return;\n }\n // Non-null captures for closures: null branches returned early above.\n const capturedYdoc = ydoc;\n const capturedAwareness = awareness;\n let stopped = false;\n\n const applyAwarenessEvent = (data: SyncEvent) => {\n if (\n data.source !== \"awareness\" \|\|\n data.type !== \"awareness-change\" \|\|\n data.docId !== docId\n ) {\n return;\n }\n const states = Array.isArray(data.states)\n ? (data.states as Array<{ clientId: number; state: string }>)\n : [];\n const remoteStates: RemoteAwarenessSnapshot[] = [];\n for (const remote of states) {\n try {\n remoteStates.push({\n clientId: Number(remote.clientId),\n state: JSON.parse(remote.state),\n });\n } catch {\n // Invalid state entry — skip\n }\n }\n const changes = reconcileRemoteAwarenessStates(\n capturedAwareness.getStates() as Map<number, unknown>,\n capturedYdoc.clientID,\n remoteStates,\n );\n if (\n changes.added.length \|\|\n changes.updated.length \|\|\n changes.removed.length\n ) {\n capturedAwareness.emit(\"change\", [changes, \"remote\"]);\n }\n };\n\n const unsubscribe = subscribeSyncEvents({\n onEvents: (events) => {\n if (stopped) return;\n for (const data of events) applyAwarenessEvent(data);\n },\n });\n\n return () => {\n stopped = true;\n unsubscribe();\n };\n }, [ydoc, docId, awareness]);\n\n return {\n ydoc,\n awareness,\n isLoading,\n isSynced,\n activeUsers,\n agentActive,\n agentPresent,\n };\n}\n"]}

package/dist/collab/index.d.ts CHANGED Viewed

@@ -7,7 +7,9 @@ export { getCollabState, postCollabUpdate, postCollabText, postCollabSearchRepla
 export { seedYDocFromJson, yMapToJson, yArrayToJson, yDocToJson, applyJsonDiff, applyJsonPatch, initYDocWithJson, type PatchOp, } from "./json-to-yjs.js";
 export { postCollabJson, getCollabJson, postCollabPatch, } from "./struct-routes.js";
 export { AGENT_CLIENT_ID, DEFAULT_AGENT_IDENTITY, type AgentIdentity, } from "./agent-identity.js";
-export { agentEnterDocument, agentLeaveDocument, agentUpdateSelection, agentApplyEditsIncrementally, agentApplyPatchesIncrementally, } from "./agent-presence.js";
+export { agentEnterDocument, agentLeaveDocument, agentUpdateSelection, agentTouchDocument, agentApplyEditsIncrementally, agentApplyPatchesIncrementally, AGENT_PRESENCE_LINGER_MS, type AgentLeaveOptions, type AgentTouchOptions, } from "./agent-presence.js";
+export { appendRecentEdit, collectRecentEdits, publishRecentEdit, useRecentEdits, RECENT_EDITS_MAX, RECENT_EDIT_TTL_MS, type RecentEdit, type RecentEditDescriptor, type AttributedRecentEdit, type UseRecentEditsOptions, } from "./recent-edits.js";
+export { useCollabUndo, useLocalOpUndo, createLocalOpUndoController, type UseCollabUndoOptions, type UseCollabUndoResult, type CollabUndoScope, type UseLocalOpUndoOptions, type UseLocalOpUndoResult, type LocalOpUndoEntry, type LocalOpUndoController, type CreateLocalOpUndoOptions, type UndoKeyboardOptions, } from "./undo.js";
 export { getDocAwareness, getAwarenessEmitter, emitAwarenessChange, AWARENESS_CHANGE_EVENT, type AwarenessEntry, type AwarenessChangeEvent, } from "./awareness.js";
 export { usePresence, toNormalized, fromNormalized, type OtherPresence, type PresencePayload, type UsePresenceResult, type NormalizedPoint, } from "./presence.js";
 export { useFollowUser, type UseFollowUserOptions, type UseFollowUserResult, type ViewportDescriptor, } from "./follow-mode.js";

package/dist/collab/index.d.ts.map CHANGED Viewed

	@@ -1 +1 @@
1	- {"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/collab/index.ts"],"names":[],"mappings":"AAGA,OAAO,EACL,aAAa,EACb,aAAa,EACb,cAAc,EACd,iBAAiB,EACjB,kBAAkB,EAClB,kBAAkB,GACnB,MAAM,cAAc,CAAC;AAGtB,OAAO,EACL,MAAM,EACN,WAAW,EACX,SAAS,EACT,OAAO,EACP,QAAQ,EACR,YAAY,EACZ,YAAY,EACZ,UAAU,EACV,gBAAgB,EAChB,SAAS,EACT,aAAa,EACb,OAAO,EACP,YAAY,GACb,MAAM,mBAAmB,CAAC;AAG3B,OAAO,EAAE,sBAAsB,EAAE,mBAAmB,EAAE,MAAM,cAAc,CAAC;AAG3E,OAAO,EAAE,eAAe,EAAE,gBAAgB,EAAE,MAAM,kBAAkB,CAAC;AAGrE,OAAO,EACL,gBAAgB,EAChB,gBAAgB,EAChB,KAAK,WAAW,GACjB,MAAM,cAAc,CAAC;AAGtB,OAAO,EACL,cAAc,EACd,gBAAgB,EAChB,cAAc,EACd,uBAAuB,GACxB,MAAM,aAAa,CAAC;AAGrB,OAAO,EACL,gBAAgB,EAChB,UAAU,EACV,YAAY,EACZ,UAAU,EACV,aAAa,EACb,cAAc,EACd,gBAAgB,EAChB,KAAK,OAAO,GACb,MAAM,kBAAkB,CAAC;AAG1B,OAAO,EACL,cAAc,EACd,aAAa,EACb,eAAe,GAChB,MAAM,oBAAoB,CAAC;AAG5B,OAAO,EACL,eAAe,EACf,sBAAsB,EACtB,KAAK,aAAa,GACnB,MAAM,qBAAqB,CAAC;AAG7B,OAAO,EACL,kBAAkB,EAClB,kBAAkB,EAClB,oBAAoB,EACpB,4BAA4B,EAC5B,8BAA8B,~~GAC/B~~,MAAM,qBAAqB,CAAC;AAG7B,OAAO,EACL,eAAe,EACf,mBAAmB,EACnB,mBAAmB,EACnB,sBAAsB,EACtB,KAAK,cAAc,EACnB,KAAK,oBAAoB,GAC1B,MAAM,gBAAgB,CAAC;AAGxB,OAAO,EACL,WAAW,EACX,YAAY,EACZ,cAAc,EACd,KAAK,aAAa,EAClB,KAAK,eAAe,EACpB,KAAK,iBAAiB,EACtB,KAAK,eAAe,GACrB,MAAM,eAAe,CAAC;AAGvB,OAAO,EACL,aAAa,EACb,KAAK,oBAAoB,EACzB,KAAK,mBAAmB,EACxB,KAAK,kBAAkB,GACxB,MAAM,kBAAkB,CAAC"}
1	+ {"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/collab/index.ts"],"names":[],"mappings":"AAGA,OAAO,EACL,aAAa,EACb,aAAa,EACb,cAAc,EACd,iBAAiB,EACjB,kBAAkB,EAClB,kBAAkB,GACnB,MAAM,cAAc,CAAC;AAGtB,OAAO,EACL,MAAM,EACN,WAAW,EACX,SAAS,EACT,OAAO,EACP,QAAQ,EACR,YAAY,EACZ,YAAY,EACZ,UAAU,EACV,gBAAgB,EAChB,SAAS,EACT,aAAa,EACb,OAAO,EACP,YAAY,GACb,MAAM,mBAAmB,CAAC;AAG3B,OAAO,EAAE,sBAAsB,EAAE,mBAAmB,EAAE,MAAM,cAAc,CAAC;AAG3E,OAAO,EAAE,eAAe,EAAE,gBAAgB,EAAE,MAAM,kBAAkB,CAAC;AAGrE,OAAO,EACL,gBAAgB,EAChB,gBAAgB,EAChB,KAAK,WAAW,GACjB,MAAM,cAAc,CAAC;AAGtB,OAAO,EACL,cAAc,EACd,gBAAgB,EAChB,cAAc,EACd,uBAAuB,GACxB,MAAM,aAAa,CAAC;AAGrB,OAAO,EACL,gBAAgB,EAChB,UAAU,EACV,YAAY,EACZ,UAAU,EACV,aAAa,EACb,cAAc,EACd,gBAAgB,EAChB,KAAK,OAAO,GACb,MAAM,kBAAkB,CAAC;AAG1B,OAAO,EACL,cAAc,EACd,aAAa,EACb,eAAe,GAChB,MAAM,oBAAoB,CAAC;AAG5B,OAAO,EACL,eAAe,EACf,sBAAsB,EACtB,KAAK,aAAa,GACnB,MAAM,qBAAqB,CAAC;AAG7B,OAAO,EACL,kBAAkB,EAClB,kBAAkB,EAClB,oBAAoB,EACpB,kBAAkB,EAClB,4BAA4B,EAC5B,8BAA8B,EAC9B,wBAAwB,EACxB,KAAK,iBAAiB,EACtB,KAAK,iBAAiB,GACvB,MAAM,qBAAqB,CAAC;AAG7B,OAAO,EACL,gBAAgB,EAChB,kBAAkB,EAClB,iBAAiB,EACjB,cAAc,EACd,gBAAgB,EAChB,kBAAkB,EAClB,KAAK,UAAU,EACf,KAAK,oBAAoB,EACzB,KAAK,oBAAoB,EACzB,KAAK,qBAAqB,GAC3B,MAAM,mBAAmB,CAAC;AAG3B,OAAO,EACL,aAAa,EACb,cAAc,EACd,2BAA2B,EAC3B,KAAK,oBAAoB,EACzB,KAAK,mBAAmB,EACxB,KAAK,eAAe,EACpB,KAAK,qBAAqB,EAC1B,KAAK,oBAAoB,EACzB,KAAK,gBAAgB,EACrB,KAAK,qBAAqB,EAC1B,KAAK,wBAAwB,EAC7B,KAAK,mBAAmB,GACzB,MAAM,WAAW,CAAC;AAGnB,OAAO,EACL,eAAe,EACf,mBAAmB,EACnB,mBAAmB,EACnB,sBAAsB,EACtB,KAAK,cAAc,EACnB,KAAK,oBAAoB,GAC1B,MAAM,gBAAgB,CAAC;AAGxB,OAAO,EACL,WAAW,EACX,YAAY,EACZ,cAAc,EACd,KAAK,aAAa,EAClB,KAAK,eAAe,EACpB,KAAK,iBAAiB,EACtB,KAAK,eAAe,GACrB,MAAM,eAAe,CAAC;AAGvB,OAAO,EACL,aAAa,EACb,KAAK,oBAAoB,EACzB,KAAK,mBAAmB,EACxB,KAAK,kBAAkB,GACxB,MAAM,kBAAkB,CAAC"}

package/dist/collab/index.js CHANGED Viewed

@@ -18,7 +18,11 @@ export { postCollabJson, getCollabJson, postCollabPatch, } from "./struct-routes
 // Agent identity
 export { AGENT_CLIENT_ID, DEFAULT_AGENT_IDENTITY, } from "./agent-identity.js";
 // Agent presence lifecycle
-export { agentEnterDocument, agentLeaveDocument, agentUpdateSelection, agentApplyEditsIncrementally, agentApplyPatchesIncrementally, } from "./agent-presence.js";
+export { agentEnterDocument, agentLeaveDocument, agentUpdateSelection, agentTouchDocument, agentApplyEditsIncrementally, agentApplyPatchesIncrementally, AGENT_PRESENCE_LINGER_MS, } from "./agent-presence.js";
+// Recent-edit attribution (lingering highlights)
+export { appendRecentEdit, collectRecentEdits, publishRecentEdit, useRecentEdits, RECENT_EDITS_MAX, RECENT_EDIT_TTL_MS, } from "./recent-edits.js";
+// Per-user undo/redo
+export { useCollabUndo, useLocalOpUndo, createLocalOpUndoController, } from "./undo.js";
 // Awareness (re-export for agent-presence consumers)
 export { getDocAwareness, getAwarenessEmitter, emitAwarenessChange, AWARENESS_CHANGE_EVENT, } from "./awareness.js";
 // Presence kit

package/dist/collab/index.js.map CHANGED Viewed

	@@ -1 +1 @@
1	- {"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/collab/index.ts"],"names":[],"mappings":"AAAA,2CAA2C;AAE3C,UAAU;AACV,OAAO,EACL,aAAa,EACb,aAAa,EACb,cAAc,EACd,iBAAiB,EACjB,kBAAkB,EAClB,kBAAkB,GACnB,MAAM,cAAc,CAAC;AAEtB,eAAe;AACf,OAAO,EACL,MAAM,EACN,WAAW,EACX,SAAS,EACT,OAAO,EACP,QAAQ,EACR,YAAY,EACZ,YAAY,EACZ,UAAU,EACV,gBAAgB,EAChB,SAAS,EACT,aAAa,EACb,OAAO,EACP,YAAY,GACb,MAAM,mBAAmB,CAAC;AAE3B,yBAAyB;AACzB,OAAO,EAAE,sBAAsB,EAAE,mBAAmB,EAAE,MAAM,cAAc,CAAC;AAE3E,qBAAqB;AACrB,OAAO,EAAE,eAAe,EAAE,gBAAgB,EAAE,MAAM,kBAAkB,CAAC;AAErE,UAAU;AACV,OAAO,EACL,gBAAgB,EAChB,gBAAgB,GAEjB,MAAM,cAAc,CAAC;AAEtB,iBAAiB;AACjB,OAAO,EACL,cAAc,EACd,gBAAgB,EAChB,cAAc,EACd,uBAAuB,GACxB,MAAM,aAAa,CAAC;AAErB,uCAAuC;AACvC,OAAO,EACL,gBAAgB,EAChB,UAAU,EACV,YAAY,EACZ,UAAU,EACV,aAAa,EACb,cAAc,EACd,gBAAgB,GAEjB,MAAM,kBAAkB,CAAC;AAE1B,iCAAiC;AACjC,OAAO,EACL,cAAc,EACd,aAAa,EACb,eAAe,GAChB,MAAM,oBAAoB,CAAC;AAE5B,iBAAiB;AACjB,OAAO,EACL,eAAe,EACf,sBAAsB,GAEvB,MAAM,qBAAqB,CAAC;AAE7B,2BAA2B;AAC3B,OAAO,EACL,kBAAkB,EAClB,kBAAkB,EAClB,oBAAoB,EACpB,4BAA4B,EAC5B,8BAA8B,~~GAC/B~~,MAAM,qBAAqB,CAAC;AAE7B,qDAAqD;AACrD,OAAO,EACL,eAAe,EACf,mBAAmB,EACnB,mBAAmB,EACnB,sBAAsB,GAGvB,MAAM,gBAAgB,CAAC;AAExB,eAAe;AACf,OAAO,EACL,WAAW,EACX,YAAY,EACZ,cAAc,GAKf,MAAM,eAAe,CAAC;AAEvB,cAAc;AACd,OAAO,EACL,aAAa,GAId,MAAM,kBAAkB,CAAC","sourcesContent":["// Public API for @agent-native/core/collab\n\n// Storage\nexport {\n loadYDocState,\n saveYDocState,\n hasCollabState,\n deleteCollabState,\n uint8ArrayToBase64,\n base64ToUint8Array,\n} from \"./storage.js\";\n\n// YDoc manager\nexport {\n getDoc,\n applyUpdate,\n applyText,\n getText,\n getState,\n getIncUpdate,\n seedFromText,\n releaseDoc,\n searchAndReplace,\n applyJson,\n applyPatchOps,\n getJson,\n seedFromJson,\n} from \"./ydoc-manager.js\";\n\n// XmlFragment operations\nexport { searchAndReplaceInYXml, extractTextFromYXml } from \"./xml-ops.js\";\n\n// Text-to-Yjs bridge\nexport { applyTextToYDoc, initYDocWithText } from \"./text-to-yjs.js\";\n\n// Emitter\nexport {\n getCollabEmitter,\n emitCollabUpdate,\n type CollabEvent,\n} from \"./emitter.js\";\n\n// Route handlers\nexport {\n getCollabState,\n postCollabUpdate,\n postCollabText,\n postCollabSearchReplace,\n} from \"./routes.js\";\n\n// JSON-to-Yjs bridge (structured data)\nexport {\n seedYDocFromJson,\n yMapToJson,\n yArrayToJson,\n yDocToJson,\n applyJsonDiff,\n applyJsonPatch,\n initYDocWithJson,\n type PatchOp,\n} from \"./json-to-yjs.js\";\n\n// Structured data route handlers\nexport {\n postCollabJson,\n getCollabJson,\n postCollabPatch,\n} from \"./struct-routes.js\";\n\n// Agent identity\nexport {\n AGENT_CLIENT_ID,\n DEFAULT_AGENT_IDENTITY,\n type AgentIdentity,\n} from \"./agent-identity.js\";\n\n// Agent presence lifecycle\nexport {\n agentEnterDocument,\n agentLeaveDocument,\n agentUpdateSelection,\n agentApplyEditsIncrementally,\n agentApplyPatchesIncrementally,\n} from \"./agent-presence.js\";\n\n// Awareness (re-export for agent-presence consumers)\nexport {\n getDocAwareness,\n getAwarenessEmitter,\n emitAwarenessChange,\n AWARENESS_CHANGE_EVENT,\n type AwarenessEntry,\n type AwarenessChangeEvent,\n} from \"./awareness.js\";\n\n// Presence kit\nexport {\n usePresence,\n toNormalized,\n fromNormalized,\n type OtherPresence,\n type PresencePayload,\n type UsePresenceResult,\n type NormalizedPoint,\n} from \"./presence.js\";\n\n// Follow mode\nexport {\n useFollowUser,\n type UseFollowUserOptions,\n type UseFollowUserResult,\n type ViewportDescriptor,\n} from \"./follow-mode.js\";\n"]}
1	+ {"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/collab/index.ts"],"names":[],"mappings":"AAAA,2CAA2C;AAE3C,UAAU;AACV,OAAO,EACL,aAAa,EACb,aAAa,EACb,cAAc,EACd,iBAAiB,EACjB,kBAAkB,EAClB,kBAAkB,GACnB,MAAM,cAAc,CAAC;AAEtB,eAAe;AACf,OAAO,EACL,MAAM,EACN,WAAW,EACX,SAAS,EACT,OAAO,EACP,QAAQ,EACR,YAAY,EACZ,YAAY,EACZ,UAAU,EACV,gBAAgB,EAChB,SAAS,EACT,aAAa,EACb,OAAO,EACP,YAAY,GACb,MAAM,mBAAmB,CAAC;AAE3B,yBAAyB;AACzB,OAAO,EAAE,sBAAsB,EAAE,mBAAmB,EAAE,MAAM,cAAc,CAAC;AAE3E,qBAAqB;AACrB,OAAO,EAAE,eAAe,EAAE,gBAAgB,EAAE,MAAM,kBAAkB,CAAC;AAErE,UAAU;AACV,OAAO,EACL,gBAAgB,EAChB,gBAAgB,GAEjB,MAAM,cAAc,CAAC;AAEtB,iBAAiB;AACjB,OAAO,EACL,cAAc,EACd,gBAAgB,EAChB,cAAc,EACd,uBAAuB,GACxB,MAAM,aAAa,CAAC;AAErB,uCAAuC;AACvC,OAAO,EACL,gBAAgB,EAChB,UAAU,EACV,YAAY,EACZ,UAAU,EACV,aAAa,EACb,cAAc,EACd,gBAAgB,GAEjB,MAAM,kBAAkB,CAAC;AAE1B,iCAAiC;AACjC,OAAO,EACL,cAAc,EACd,aAAa,EACb,eAAe,GAChB,MAAM,oBAAoB,CAAC;AAE5B,iBAAiB;AACjB,OAAO,EACL,eAAe,EACf,sBAAsB,GAEvB,MAAM,qBAAqB,CAAC;AAE7B,2BAA2B;AAC3B,OAAO,EACL,kBAAkB,EAClB,kBAAkB,EAClB,oBAAoB,EACpB,kBAAkB,EAClB,4BAA4B,EAC5B,8BAA8B,EAC9B,wBAAwB,GAGzB,MAAM,qBAAqB,CAAC;AAE7B,iDAAiD;AACjD,OAAO,EACL,gBAAgB,EAChB,kBAAkB,EAClB,iBAAiB,EACjB,cAAc,EACd,gBAAgB,EAChB,kBAAkB,GAKnB,MAAM,mBAAmB,CAAC;AAE3B,qBAAqB;AACrB,OAAO,EACL,aAAa,EACb,cAAc,EACd,2BAA2B,GAU5B,MAAM,WAAW,CAAC;AAEnB,qDAAqD;AACrD,OAAO,EACL,eAAe,EACf,mBAAmB,EACnB,mBAAmB,EACnB,sBAAsB,GAGvB,MAAM,gBAAgB,CAAC;AAExB,eAAe;AACf,OAAO,EACL,WAAW,EACX,YAAY,EACZ,cAAc,GAKf,MAAM,eAAe,CAAC;AAEvB,cAAc;AACd,OAAO,EACL,aAAa,GAId,MAAM,kBAAkB,CAAC","sourcesContent":["// Public API for @agent-native/core/collab\n\n// Storage\nexport {\n loadYDocState,\n saveYDocState,\n hasCollabState,\n deleteCollabState,\n uint8ArrayToBase64,\n base64ToUint8Array,\n} from \"./storage.js\";\n\n// YDoc manager\nexport {\n getDoc,\n applyUpdate,\n applyText,\n getText,\n getState,\n getIncUpdate,\n seedFromText,\n releaseDoc,\n searchAndReplace,\n applyJson,\n applyPatchOps,\n getJson,\n seedFromJson,\n} from \"./ydoc-manager.js\";\n\n// XmlFragment operations\nexport { searchAndReplaceInYXml, extractTextFromYXml } from \"./xml-ops.js\";\n\n// Text-to-Yjs bridge\nexport { applyTextToYDoc, initYDocWithText } from \"./text-to-yjs.js\";\n\n// Emitter\nexport {\n getCollabEmitter,\n emitCollabUpdate,\n type CollabEvent,\n} from \"./emitter.js\";\n\n// Route handlers\nexport {\n getCollabState,\n postCollabUpdate,\n postCollabText,\n postCollabSearchReplace,\n} from \"./routes.js\";\n\n// JSON-to-Yjs bridge (structured data)\nexport {\n seedYDocFromJson,\n yMapToJson,\n yArrayToJson,\n yDocToJson,\n applyJsonDiff,\n applyJsonPatch,\n initYDocWithJson,\n type PatchOp,\n} from \"./json-to-yjs.js\";\n\n// Structured data route handlers\nexport {\n postCollabJson,\n getCollabJson,\n postCollabPatch,\n} from \"./struct-routes.js\";\n\n// Agent identity\nexport {\n AGENT_CLIENT_ID,\n DEFAULT_AGENT_IDENTITY,\n type AgentIdentity,\n} from \"./agent-identity.js\";\n\n// Agent presence lifecycle\nexport {\n agentEnterDocument,\n agentLeaveDocument,\n agentUpdateSelection,\n agentTouchDocument,\n agentApplyEditsIncrementally,\n agentApplyPatchesIncrementally,\n AGENT_PRESENCE_LINGER_MS,\n type AgentLeaveOptions,\n type AgentTouchOptions,\n} from \"./agent-presence.js\";\n\n// Recent-edit attribution (lingering highlights)\nexport {\n appendRecentEdit,\n collectRecentEdits,\n publishRecentEdit,\n useRecentEdits,\n RECENT_EDITS_MAX,\n RECENT_EDIT_TTL_MS,\n type RecentEdit,\n type RecentEditDescriptor,\n type AttributedRecentEdit,\n type UseRecentEditsOptions,\n} from \"./recent-edits.js\";\n\n// Per-user undo/redo\nexport {\n useCollabUndo,\n useLocalOpUndo,\n createLocalOpUndoController,\n type UseCollabUndoOptions,\n type UseCollabUndoResult,\n type CollabUndoScope,\n type UseLocalOpUndoOptions,\n type UseLocalOpUndoResult,\n type LocalOpUndoEntry,\n type LocalOpUndoController,\n type CreateLocalOpUndoOptions,\n type UndoKeyboardOptions,\n} from \"./undo.js\";\n\n// Awareness (re-export for agent-presence consumers)\nexport {\n getDocAwareness,\n getAwarenessEmitter,\n emitAwarenessChange,\n AWARENESS_CHANGE_EVENT,\n type AwarenessEntry,\n type AwarenessChangeEvent,\n} from \"./awareness.js\";\n\n// Presence kit\nexport {\n usePresence,\n toNormalized,\n fromNormalized,\n type OtherPresence,\n type PresencePayload,\n type UsePresenceResult,\n type NormalizedPoint,\n} from \"./presence.js\";\n\n// Follow mode\nexport {\n useFollowUser,\n type UseFollowUserOptions,\n type UseFollowUserResult,\n type ViewportDescriptor,\n} from \"./follow-mode.js\";\n"]}

package/dist/collab/presence.d.ts.map CHANGED Viewed

	@@ -1 +1 @@
1	- {"version":3,"file":"presence.d.ts","sourceRoot":"","sources":["../../src/collab/presence.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAGH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,uBAAuB,CAAC;AAGvD,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAE9C,kEAAkE;AAClE,MAAM,MAAM,eAAe,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;AAEtD,qDAAqD;AACrD,MAAM,WAAW,aAAa;IAC5B,qBAAqB;IACrB,QAAQ,EAAE,MAAM,CAAC;IACjB,mDAAmD;IACnD,IAAI,EAAE,UAAU,CAAC;IACjB,gFAAgF;IAChF,QAAQ,EAAE,eAAe,CAAC;IAC1B,kDAAkD;IAClD,OAAO,EAAE,OAAO,CAAC;CAClB;AAED,MAAM,WAAW,iBAAiB;IAChC,uDAAuD;IACvD,MAAM,EAAE,aAAa,EAAE,CAAC;IACxB;;;;OAIG;IACH,WAAW,EAAE,CAAC,OAAO,EAAE,eAAe,KAAK,IAAI,CAAC;CACjD;AAED;;;;;GAKG;AACH,wBAAgB,WAAW,CACzB,SAAS,EAAE,SAAS,GAAG,IAAI,GAAG,SAAS,EACvC,aAAa,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,GACvC,iBAAiB,~~CAuEnB~~;AAMD,MAAM,WAAW,eAAe;IAC9B,uCAAuC;IACvC,CAAC,EAAE,MAAM,CAAC;IACV,wCAAwC;IACxC,CAAC,EAAE,MAAM,CAAC;CACX;AAED,4DAA4D;AAC5D,wBAAgB,YAAY,CAC1B,OAAO,EAAE,MAAM,EACf,OAAO,EAAE,MAAM,EACf,SAAS,EAAE,OAAO,GACjB,eAAe,CAKjB;AAED,6EAA6E;AAC7E,wBAAgB,cAAc,CAC5B,KAAK,EAAE,eAAe,EACtB,SAAS,EAAE,OAAO,GACjB;IAAE,CAAC,EAAE,MAAM,CAAC;IAAC,CAAC,EAAE,MAAM,CAAA;CAAE,CAK1B"}
1	+ {"version":3,"file":"presence.d.ts","sourceRoot":"","sources":["../../src/collab/presence.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAGH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,uBAAuB,CAAC;AAGvD,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAE9C,kEAAkE;AAClE,MAAM,MAAM,eAAe,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;AAEtD,qDAAqD;AACrD,MAAM,WAAW,aAAa;IAC5B,qBAAqB;IACrB,QAAQ,EAAE,MAAM,CAAC;IACjB,mDAAmD;IACnD,IAAI,EAAE,UAAU,CAAC;IACjB,gFAAgF;IAChF,QAAQ,EAAE,eAAe,CAAC;IAC1B,kDAAkD;IAClD,OAAO,EAAE,OAAO,CAAC;CAClB;AAED,MAAM,WAAW,iBAAiB;IAChC,uDAAuD;IACvD,MAAM,EAAE,aAAa,EAAE,CAAC;IACxB;;;;OAIG;IACH,WAAW,EAAE,CAAC,OAAO,EAAE,eAAe,KAAK,IAAI,CAAC;CACjD;AAED;;;;;GAKG;AACH,wBAAgB,WAAW,CACzB,SAAS,EAAE,SAAS,GAAG,IAAI,GAAG,SAAS,EACvC,aAAa,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,GACvC,iBAAiB,CAmInB;AAMD,MAAM,WAAW,eAAe;IAC9B,uCAAuC;IACvC,CAAC,EAAE,MAAM,CAAC;IACV,wCAAwC;IACxC,CAAC,EAAE,MAAM,CAAC;CACX;AAED,4DAA4D;AAC5D,wBAAgB,YAAY,CAC1B,OAAO,EAAE,MAAM,EACf,OAAO,EAAE,MAAM,EACf,SAAS,EAAE,OAAO,GACjB,eAAe,CAKjB;AAED,6EAA6E;AAC7E,wBAAgB,cAAc,CAC5B,KAAK,EAAE,eAAe,EACtB,SAAS,EAAE,OAAO,GACjB;IAAE,CAAC,EAAE,MAAM,CAAC;IAAC,CAAC,EAAE,MAAM,CAAA;CAAE,CAK1B"}

package/dist/collab/presence.js CHANGED Viewed

@@ -26,6 +26,36 @@ export function usePresence(awareness, localClientId) {
             setOthers([]);
             return;
         }
+        // Keep the last derived snapshot so genuinely no-op change events (e.g. a
+        // local-only awareness field flip that doesn't affect any remote entry)
+        // can bail out without triggering a subscriber re-render.
+        let lastOthers = [];
+        function shallowEqualOthers(a, b) {
+            if (a === b)
+                return true;
+            if (a.length !== b.length)
+                return false;
+            for (let i = 0; i < a.length; i += 1) {
+                const left = a[i];
+                const right = b[i];
+                if (left === right)
+                    continue;
+                if (left.clientId !== right.clientId ||
+                    left.isAgent !== right.isAgent ||
+                    left.user.name !== right.user.name ||
+                    left.user.email !== right.user.email ||
+                    left.user.color !== right.user.color) {
+                    return false;
+                }
+                // Compare presence payloads with a stable JSON.stringify — presence
+                // fields (cursor/selection/viewport) are small JSON-safe records, so
+                // this is cheap and avoids a re-render when nothing actually changed.
+                if (JSON.stringify(left.presence) !== JSON.stringify(right.presence)) {
+                    return false;
+                }
+            }
+            return true;
+        }
         function derive() {
             const result = [];
             awareness.getStates().forEach((state, clientId) => {
@@ -61,11 +91,32 @@ export function usePresence(awareness, localClientId) {
             });
             return result;
         }
-        function onAwarenessChange() {
-            setOthers(derive());
+        function onAwarenessChange(changes) {
+            // The awareness "change" event fires for local-only state edits too
+            // (e.g. this hook's own setPresence() calls, or the doc's
+            // activeFileId/visible fields). When every changed client id is the
+            // local client, the derived `others` array (which excludes the local
+            // client) cannot have changed, so skip the re-render entirely.
+            if (changes) {
+                const changedIds = [
+                    ...changes.added,
+                    ...changes.updated,
+                    ...changes.removed,
+                ];
+                if (changedIds.length > 0 &&
+                    changedIds.every((id) => id === localClientId)) {
+                    return;
+                }
+            }
+            const next = derive();
+            if (shallowEqualOthers(lastOthers, next))
+                return;
+            lastOthers = next;
+            setOthers(next);
         }
         // Derive immediately.
-        setOthers(derive());
+        lastOthers = derive();
+        setOthers(lastOthers);
         awareness.on("change", onAwarenessChange);
         return () => {
             awareness.off("change", onAwarenessChange);

package/dist/collab/presence.js.map CHANGED Viewed

	@@ -1 +1 @@
1	- {"version":3,"file":"presence.js","sourceRoot":"","sources":["../../src/collab/presence.ts"],"names":[],"mappings":"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","sourcesContent":["/*\n Presence kit — Liveblocks/collaboration-grade presence primitives.\n \n usePresence(awareness) returns:\n * - others: reactive array of remote participants (human + agent)\n * - setPresence(partial): merge fields into local awareness state\n \n The hook re-renders on every awareness change event and always includes\n * the agent participant (AGENT_CLIENT_ID) as isAgent: true.\n /\n\nimport { useState, useEffect, useCallback, useRef } from \"react\";\nimport type { Awareness } from \"y-protocols/awareness\";\n\nimport { AGENT_CLIENT_ID } from \"./agent-identity.js\";\nimport type { CollabUser } from \"./client.js\";\n\n/* Arbitrary JSON presence payload published by a participant. /\nexport type PresencePayload = Record<string, unknown>;\n\n/* A remote participant's full presence snapshot. /\nexport interface OtherPresence {\n /* Yjs client ID. /\n clientId: number;\n /* User identity (from awareness `user` field). /\n user: CollabUser;\n /* Arbitrary presence fields set via setPresence() / agentUpdateSelection(). /\n presence: PresencePayload;\n /* True when this participant is the AI agent. /\n isAgent: boolean;\n}\n\nexport interface UsePresenceResult {\n /* All remote participants (excludes local client). /\n others: OtherPresence[];\n /\n Merge fields into the local awareness state. These are broadcast to\n * peers by the fast-awareness path in useCollaborativeDoc.\n * Call this to publish cursor position, viewport, or selection.\n /\n setPresence: (partial: PresencePayload) => void;\n}\n\n/\n Derive OtherPresence entries from an Awareness instance.\n \n @param awareness Awareness instance from useCollaborativeDoc.\n * @param localClientId The local Yjs client ID (to exclude self).\n /\nexport function usePresence(\n awareness: Awareness \| null \| undefined,\n localClientId: number \| null \| undefined,\n): UsePresenceResult {\n const [others, setOthers] = useState<OtherPresence[]>([]);\n\n // Keep the latest awareness ref so setPresence closure doesn't go stale.\n const awarenessRef = useRef(awareness);\n awarenessRef.current = awareness;\n\n useEffect(() => {\n if (!awareness) {\n setOthers([]);\n return;\n }\n\n function derive(): OtherPresence[] {\n const result: OtherPresence[] = [];\n awareness!.getStates().forEach((state, clientId) => {\n if (clientId === localClientId) return; // skip self\n const s = state as Record<string, unknown>;\n const isAgent = clientId === AGENT_CLIENT_ID;\n\n // User identity — fall back to agent defaults or anonymous.\n let user: CollabUser;\n if (isAgent) {\n user = {\n name: (s.user as CollabUser)?.name ?? \"AI Assistant\",\n email: (s.user as CollabUser)?.email ?? \"agent@system\",\n color: (s.user as CollabUser)?.color ?? \"#00B5FF\",\n };\n } else {\n const u = s.user as CollabUser \| undefined;\n user = {\n name: u?.name ?? \"Unknown\",\n email: u?.email ?? `client-${clientId}`,\n color: u?.color ?? \"#94a3b8\",\n };\n }\n\n // Everything that isn't `user` or `visible` is presence payload.\n const presence: PresencePayload = {};\n for (const [k, v] of Object.entries(s)) {\n if (k !== \"user\" && k !== \"visible\") {\n presence[k] = v;\n }\n }\n\n result.push({ clientId, user, presence, isAgent });\n });\n return result;\n }\n\n function onAwarenessChange() {\n setOthers(derive());\n }\n\n // Derive immediately.\n setOthers(derive());\n awareness.on(\"change\", onAwarenessChange);\n return () => {\n awareness.off(\"change\", onAwarenessChange);\n };\n }, [awareness, localClientId]);\n\n const setPresence = useCallback((partial: PresencePayload) => {\n const aw = awarenessRef.current;\n if (!aw) return;\n for (const [k, v] of Object.entries(partial)) {\n aw.setLocalStateField(k, v);\n }\n }, []);\n\n return { others, setPresence };\n}\n\n// ---------------------------------------------------------------------------\n// Normalized cursor coordinate helpers\n// ---------------------------------------------------------------------------\n\nexport interface NormalizedPoint {\n /* 0–1 fraction of container width. /\n x: number;\n /* 0–1 fraction of container height. /\n y: number;\n}\n\n/* Convert a pointer event offset to a normalized point. /\nexport function toNormalized(\n clientX: number,\n clientY: number,\n container: DOMRect,\n): NormalizedPoint {\n return {\n x: Math.max(0, Math.min(1, (clientX - container.left) / container.width)),\n y: Math.max(0, Math.min(1, (clientY - container.top) / container.height)),\n };\n}\n\n/* Convert a normalized point back to absolute offset within a container. /\nexport function fromNormalized(\n point: NormalizedPoint,\n container: DOMRect,\n): { x: number; y: number } {\n return {\n x: point.x container.width,\n y: point.y * container.height,\n };\n}\n"]}
1	+ {"version":3,"file":"presence.js","sourceRoot":"","sources":["../../src/collab/presence.ts"],"names":[],"mappings":"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","sourcesContent":["/*\n Presence kit — Liveblocks/collaboration-grade presence primitives.\n \n usePresence(awareness) returns:\n * - others: reactive array of remote participants (human + agent)\n * - setPresence(partial): merge fields into local awareness state\n \n The hook re-renders on every awareness change event and always includes\n * the agent participant (AGENT_CLIENT_ID) as isAgent: true.\n /\n\nimport { useState, useEffect, useCallback, useRef } from \"react\";\nimport type { Awareness } from \"y-protocols/awareness\";\n\nimport { AGENT_CLIENT_ID } from \"./agent-identity.js\";\nimport type { CollabUser } from \"./client.js\";\n\n/* Arbitrary JSON presence payload published by a participant. /\nexport type PresencePayload = Record<string, unknown>;\n\n/* A remote participant's full presence snapshot. /\nexport interface OtherPresence {\n /* Yjs client ID. /\n clientId: number;\n /* User identity (from awareness `user` field). /\n user: CollabUser;\n /* Arbitrary presence fields set via setPresence() / agentUpdateSelection(). /\n presence: PresencePayload;\n /* True when this participant is the AI agent. /\n isAgent: boolean;\n}\n\nexport interface UsePresenceResult {\n /* All remote participants (excludes local client). /\n others: OtherPresence[];\n /\n Merge fields into the local awareness state. These are broadcast to\n * peers by the fast-awareness path in useCollaborativeDoc.\n * Call this to publish cursor position, viewport, or selection.\n /\n setPresence: (partial: PresencePayload) => void;\n}\n\n/\n Derive OtherPresence entries from an Awareness instance.\n \n @param awareness Awareness instance from useCollaborativeDoc.\n * @param localClientId The local Yjs client ID (to exclude self).\n /\nexport function usePresence(\n awareness: Awareness \| null \| undefined,\n localClientId: number \| null \| undefined,\n): UsePresenceResult {\n const [others, setOthers] = useState<OtherPresence[]>([]);\n\n // Keep the latest awareness ref so setPresence closure doesn't go stale.\n const awarenessRef = useRef(awareness);\n awarenessRef.current = awareness;\n\n useEffect(() => {\n if (!awareness) {\n setOthers([]);\n return;\n }\n\n // Keep the last derived snapshot so genuinely no-op change events (e.g. a\n // local-only awareness field flip that doesn't affect any remote entry)\n // can bail out without triggering a subscriber re-render.\n let lastOthers: OtherPresence[] = [];\n\n function shallowEqualOthers(\n a: readonly OtherPresence[],\n b: readonly OtherPresence[],\n ): boolean {\n if (a === b) return true;\n if (a.length !== b.length) return false;\n for (let i = 0; i < a.length; i += 1) {\n const left = a[i]!;\n const right = b[i]!;\n if (left === right) continue;\n if (\n left.clientId !== right.clientId \|\|\n left.isAgent !== right.isAgent \|\|\n left.user.name !== right.user.name \|\|\n left.user.email !== right.user.email \|\|\n left.user.color !== right.user.color\n ) {\n return false;\n }\n // Compare presence payloads with a stable JSON.stringify — presence\n // fields (cursor/selection/viewport) are small JSON-safe records, so\n // this is cheap and avoids a re-render when nothing actually changed.\n if (JSON.stringify(left.presence) !== JSON.stringify(right.presence)) {\n return false;\n }\n }\n return true;\n }\n\n function derive(): OtherPresence[] {\n const result: OtherPresence[] = [];\n awareness!.getStates().forEach((state, clientId) => {\n if (clientId === localClientId) return; // skip self\n const s = state as Record<string, unknown>;\n const isAgent = clientId === AGENT_CLIENT_ID;\n\n // User identity — fall back to agent defaults or anonymous.\n let user: CollabUser;\n if (isAgent) {\n user = {\n name: (s.user as CollabUser)?.name ?? \"AI Assistant\",\n email: (s.user as CollabUser)?.email ?? \"agent@system\",\n color: (s.user as CollabUser)?.color ?? \"#00B5FF\",\n };\n } else {\n const u = s.user as CollabUser \| undefined;\n user = {\n name: u?.name ?? \"Unknown\",\n email: u?.email ?? `client-${clientId}`,\n color: u?.color ?? \"#94a3b8\",\n };\n }\n\n // Everything that isn't `user` or `visible` is presence payload.\n const presence: PresencePayload = {};\n for (const [k, v] of Object.entries(s)) {\n if (k !== \"user\" && k !== \"visible\") {\n presence[k] = v;\n }\n }\n\n result.push({ clientId, user, presence, isAgent });\n });\n return result;\n }\n\n function onAwarenessChange(changes?: {\n added: number[];\n updated: number[];\n removed: number[];\n }) {\n // The awareness \"change\" event fires for local-only state edits too\n // (e.g. this hook's own setPresence() calls, or the doc's\n // activeFileId/visible fields). When every changed client id is the\n // local client, the derived `others` array (which excludes the local\n // client) cannot have changed, so skip the re-render entirely.\n if (changes) {\n const changedIds = [\n ...changes.added,\n ...changes.updated,\n ...changes.removed,\n ];\n if (\n changedIds.length > 0 &&\n changedIds.every((id) => id === localClientId)\n ) {\n return;\n }\n }\n const next = derive();\n if (shallowEqualOthers(lastOthers, next)) return;\n lastOthers = next;\n setOthers(next);\n }\n\n // Derive immediately.\n lastOthers = derive();\n setOthers(lastOthers);\n awareness.on(\"change\", onAwarenessChange);\n return () => {\n awareness.off(\"change\", onAwarenessChange);\n };\n }, [awareness, localClientId]);\n\n const setPresence = useCallback((partial: PresencePayload) => {\n const aw = awarenessRef.current;\n if (!aw) return;\n for (const [k, v] of Object.entries(partial)) {\n aw.setLocalStateField(k, v);\n }\n }, []);\n\n return { others, setPresence };\n}\n\n// ---------------------------------------------------------------------------\n// Normalized cursor coordinate helpers\n// ---------------------------------------------------------------------------\n\nexport interface NormalizedPoint {\n /* 0–1 fraction of container width. /\n x: number;\n /* 0–1 fraction of container height. /\n y: number;\n}\n\n/* Convert a pointer event offset to a normalized point. /\nexport function toNormalized(\n clientX: number,\n clientY: number,\n container: DOMRect,\n): NormalizedPoint {\n return {\n x: Math.max(0, Math.min(1, (clientX - container.left) / container.width)),\n y: Math.max(0, Math.min(1, (clientY - container.top) / container.height)),\n };\n}\n\n/* Convert a normalized point back to absolute offset within a container. /\nexport function fromNormalized(\n point: NormalizedPoint,\n container: DOMRect,\n): { x: number; y: number } {\n return {\n x: point.x container.width,\n y: point.y * container.height,\n };\n}\n"]}

package/dist/collab/recent-edits.d.ts ADDED Viewed

@@ -0,0 +1,87 @@
+/**
+ * Recent-edit attribution for collaborative documents.
+ *
+ * Every participant (human or agent) may publish a short ring of recent edits
+ * in its awareness state under the `recentEdits` key. Clients render these as
+ * lingering, fading highlights ("Google Docs / Figma collaborator just edited
+ * this") for a few seconds after the edit lands, with the editor's name and
+ * color next to the highlighted region.
+ *
+ * The descriptor is intentionally open-ended — each app publishes whatever its
+ * surfaces can resolve back to a DOM rect:
+ *   - `{ kind: "text", quote }`         rich-text apps resolve by text search
+ *   - `{ kind: "selector", selector }`  canvas/DOM apps resolve by querySelector
+ *   - `{ kind: "paths", paths }`        structured apps resolve JSON paths
+ *     (e.g. `slides.3.content`) to their rendered element
+ *   - `{ kind: "doc" }`                 whole-document change (no region)
+ */
+import type { OtherPresence } from "./presence.js";
+export type RecentEditDescriptor = {
+    kind: "text";
+    quote: string;
+} | {
+    kind: "selector";
+    selector: string;
+} | {
+    kind: "paths";
+    paths: string[];
+} | {
+    kind: "doc";
+} | {
+    kind: string;
+    [key: string]: unknown;
+};
+export interface RecentEdit {
+    descriptor: RecentEditDescriptor;
+    /** Short human-readable label, e.g. "Rewrote intro" or "Slide 3". */
+    label?: string;
+    /** Epoch ms when the edit landed. */
+    at: number;
+}
+/** A recent edit attributed to the participant who made it. */
+export interface AttributedRecentEdit extends RecentEdit {
+    clientId: number;
+    user: OtherPresence["user"];
+    isAgent: boolean;
+}
+/** Max entries kept in a participant's recentEdits ring. */
+export declare const RECENT_EDITS_MAX = 5;
+/**
+ * Default time a recent-edit highlight stays visible, measured from the
+ * edit's `at` timestamp. Awareness delivery adds up to ~3s (poll cadence),
+ * and some actions do post-write work before a viewer looks, so this is
+ * deliberately generous — the fade consumes the final 40% of the window.
+ */
+export declare const RECENT_EDIT_TTL_MS = 10000;
+/**
+ * Append an edit to a recentEdits ring, keeping the newest
+ * {@link RECENT_EDITS_MAX} entries. Pure — returns a new array.
+ */
+export declare function appendRecentEdit(existing: RecentEdit[] | undefined, edit: RecentEdit): RecentEdit[];
+/**
+ * Flatten non-expired recent edits from remote participants, newest last.
+ * Pure — exported for tests and non-React consumers.
+ */
+export declare function collectRecentEdits(others: OtherPresence[], ttlMs: number, now: number): AttributedRecentEdit[];
+export interface UseRecentEditsOptions {
+    /** How long a highlight lingers after the edit. Default 6000ms. */
+    ttlMs?: number;
+}
+/**
+ * Reactive list of remote participants' recent edits that haven't expired.
+ * Ticks internally (~500ms) while any highlight is visible so consumers can
+ * render a smooth fade-out without wiring their own timers.
+ */
+export declare function useRecentEdits(others: OtherPresence[], options?: UseRecentEditsOptions): AttributedRecentEdit[];
+/**
+ * Publish a local edit into this client's awareness ring so peers render a
+ * lingering highlight for it. Call from app mutation paths (throttled by the
+ * ring size + TTL; safe to call per committed edit, not per keystroke).
+ */
+export declare function publishRecentEdit(awareness: {
+    getLocalState: () => Record<string, unknown> | null;
+    setLocalStateField: (field: string, value: unknown) => void;
+}, edit: Omit<RecentEdit, "at"> & {
+    at?: number;
+}): void;
+//# sourceMappingURL=recent-edits.d.ts.map

package/dist/collab/recent-edits.d.ts.map ADDED Viewed

@@ -0,0 +1 @@

+ {"version":3,"file":"recent-edits.d.ts","sourceRoot":"","sources":["../../src/collab/recent-edits.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAIH,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,eAAe,CAAC;AAEnD,MAAM,MAAM,oBAAoB,GAC5B;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,GAC/B;IAAE,IAAI,EAAE,UAAU,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAA;CAAE,GACtC;IAAE,IAAI,EAAE,OAAO,CAAC;IAAC,KAAK,EAAE,MAAM,EAAE,CAAA;CAAE,GAClC;IAAE,IAAI,EAAE,KAAK,CAAA;CAAE,GACf;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAA;CAAE,CAAC;AAE7C,MAAM,WAAW,UAAU;IACzB,UAAU,EAAE,oBAAoB,CAAC;IACjC,qEAAqE;IACrE,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,qCAAqC;IACrC,EAAE,EAAE,MAAM,CAAC;CACZ;AAED,+DAA+D;AAC/D,MAAM,WAAW,oBAAqB,SAAQ,UAAU;IACtD,QAAQ,EAAE,MAAM,CAAC;IACjB,IAAI,EAAE,aAAa,CAAC,MAAM,CAAC,CAAC;IAC5B,OAAO,EAAE,OAAO,CAAC;CAClB;AAED,4DAA4D;AAC5D,eAAO,MAAM,gBAAgB,IAAI,CAAC;AAElC;;;;;GAKG;AACH,eAAO,MAAM,kBAAkB,QAAS,CAAC;AAEzC;;;GAGG;AACH,wBAAgB,gBAAgB,CAC9B,QAAQ,EAAE,UAAU,EAAE,GAAG,SAAS,EAClC,IAAI,EAAE,UAAU,GACf,UAAU,EAAE,CAOd;AAED;;;GAGG;AACH,wBAAgB,kBAAkB,CAChC,MAAM,EAAE,aAAa,EAAE,EACvB,KAAK,EAAE,MAAM,EACb,GAAG,EAAE,MAAM,GACV,oBAAoB,EAAE,CAmBxB;AAED,MAAM,WAAW,qBAAqB;IACpC,mEAAmE;IACnE,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED;;;;GAIG;AACH,wBAAgB,cAAc,CAC5B,MAAM,EAAE,aAAa,EAAE,EACvB,OAAO,CAAC,EAAE,qBAAqB,GAC9B,oBAAoB,EAAE,CA0BxB;AAED;;;;GAIG;AACH,wBAAgB,iBAAiB,CAC/B,SAAS,EAAE;IACT,aAAa,EAAE,MAAM,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,CAAC;IACpD,kBAAkB,EAAE,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,KAAK,IAAI,CAAC;CAC7D,EACD,IAAI,EAAE,IAAI,CAAC,UAAU,EAAE,IAAI,CAAC,GAAG;IAAE,EAAE,CAAC,EAAE,MAAM,CAAA;CAAE,GAC7C,IAAI,CAON"}