@ai-agent-forge/plugin-memory 0.88.13 → 0.88.15

package/dist/memory/curator.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"curator.js","sourceRoot":"","sources":["../../src/memory/curator.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AACH,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AACzC,OAAO,EAAE,UAAU,EAAE,KAAK,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAC;AAC/D,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AASjC,OAAO,EAAE,iBAAiB,EAAqB,MAAM,iBAAiB,CAAC;AAIvE,OAAO,EAAE,0BAA0B,EAAE,MAAM,eAAe,CAAC;AAG3D,mFAAsC;AACtC,MAAM,CAAC,MAAM,oCAAoC,GAAG,wBAAwB,CAAC;AAC7E,8DAAwC;AACxC,MAAM,CAAC,MAAM,8BAA8B,GAAG,CAAC,CAAC;AAEhD,6DAAyB;AACzB,MAAM,CAAC,MAAM,0BAA0B,GAAG,GAAG,CAAC;AAC9C,8EAA4C;AAC5C,MAAM,CAAC,MAAM,mBAAmB,GAAG,EAAE,CAAC;AACtC,8EAAsC;AACtC,MAAM,CAAC,MAAM,kCAAkC,GAAG,GAAG,CAAC;AACtD,kEAAkC;AAClC,MAAM,CAAC,MAAM,wCAAwC,GAAG,GAAG,CAAC;AAC5D,mEAAqC;AACrC,MAAM,CAAC,MAAM,sBAAsB,GAAG,EAAE,CAAC;AACzC,6FAAyD;AACzD,MAAM,CAAC,MAAM,4BAA4B,GAAG,GAAG,CAAC;AAChD,kFAAgC;AAChC,MAAM,CAAC,MAAM,0BAA0B,GAAG,MAAM,CAAC;AACjD,oGAAsE;AACtE,MAAM,wBAAwB,GAAG,gBAAgB,CAAC;AAClD,8GAAkE;AAClE,MAAM,0BAA0B,GAAG,MAAM,CAAC;AAC1C,2GAA+D;AAC/D,MAAM,8BAA8B,GAAG,IAAI,CAAC,SAAS,EAAE,UAAU,EAAE,wBAAwB,CAAC,CAAC;AAE7F;;;;;GAKG;AACH,MAAM,CAAC,MAAM,gCAAgC,GAAG,EAAE,EAAE,EAAE,kBAAkB,EAAE,OAAO,EAAE,CAAC,EAAW,CAAC;AAmFhG,kFAAgE;AAChE,MAAM,UAAU,iBAAiB,CAAC,SAAiB,EAAE,gBAAmC,EAAU;IACjG,MAAM,IAAI,GAAG,UAAU,CAAC,QAAQ,CAAC,CAAC;IAClC,IAAI,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC;IACvB,KAAK,MAAM,MAAM,IAAI,gBAAgB;QAAE,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC;IAC3D,OAAO,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;AAAA,CAC1B;AAED,4EAA0D;AAC1D,MAAM,UAAU,uBAAuB,CAAC,SAAiB,EAAU;IAClE,OAAO,UAAU,CAAC,QAAQ,CAAC,CAAC,MAAM,CAAC,SAAS,EAAE,MAAM,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;AAAA,CACpE;AAED;;;GAGG;AACH,SAAS,gBAAgB,CAAC,KAA8B,EAAW;IAClE,IAAI,KAAK,CAAC,MAAM,KAAK,MAAM,IAAI,KAAK,CAAC,MAAM,KAAK,SAAS;QAAE,OAAO,KAAK,CAAC;IACxE,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,UAAU,CAAC,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,OAAO,CAAC;QAAE,OAAO,KAAK,CAAC;IACpF,OAAO,KAAK,CAAC,UAAU,CAAC,KAAK,CAC5B,CAAC,IAAI,EAAE,EAAE,CACR,aAAa,CAAC,IAAI,CAAC;QACnB,OAAO,IAAI,CAAC,SAAS,KAAK,QAAQ;QAClC,IAAI,CAAC,SAAS,KAAK,EAAE;QACrB,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,MAAM,CAAC;QAC1B,IAAI,CAAC,MAAM,CAAC,KAAK,CAChB,CAAC,KAAK,EAAE,EAAE,CAAC,aAAa,CAAC,KAAK,CAAC,IAAI,OAAO,KAAK,CAAC,GAAG,KAAK,QAAQ,IAAI,OAAO,KAAK,CAAC,KAAK,KAAK,QAAQ,CACnG,CACF,CAAC;AAAA,CACF;AAED;;;;;;;GAOG;AACH,KAAK,UAAU,qBAAqB,CACnC,WAAmB,EACnB,SAAiB,EACjB,MAA+B,EACmB;IAClD,IAAI,IAAY,CAAC;IACjB,IAAI,CAAC;QACJ,IAAI,GAAG,MAAM,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC,CAAC;IAC5C,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QAChB,IAAK,KAA+B,CAAC,IAAI,KAAK,QAAQ;YAAE,OAAO,SAAS,CAAC;QACzE,MAAM,KAAK,CAAC;IACb,CAAC;IAMD,MAAM,eAAe,GAAG,IAAI,GAAG,EAA6B,CAAC;IAC7D,KAAK,MAAM,CAAC,IAAI,EAAE,GAAG,CAAC,IAAI,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC;QACtD,IAAI,GAAG,CAAC,IAAI,EAAE,KAAK,EAAE;YAAE,SAAS;QAChC,IAAI,MAAe,CAAC;QACpB,IAAI,CAAC;YACJ,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;QAC1B,CAAC;QAAC,MAAM,CAAC;YACR,MAAM,EAAE,IAAI,CAAC,gCAAgC,IAAI,GAAG,CAAC,6BAA6B,CAAC,CAAC;YACpF,SAAS;QACV,CAAC;QACD,IAAI,CAAC,aAAa,CAAC,MAAM,CAAC,IAAI,MAAM,CAAC,SAAS,KAAK,SAAS;YAAE,SAAS;QACvE,MAAM,OAAO,GAAG,MAAM,CAAC,OAAO,CAAC;QAC/B,IAAI,OAAO,OAAO,KAAK,QAAQ,IAAI,OAAO,KAAK,EAAE;YAAE,SAAS;QAC5D,IAAI,MAAM,CAAC,MAAM,KAAK,WAAW,EAAE,CAAC;YACnC,eAAe,CAAC,GAAG,CAAC,OAAO,EAAE,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,IAAI,EAAE,SAAS,EAAE,CAAC,CAAC;YACtE,SAAS;QACV,CAAC;QACD,IAAI,CAAC,gBAAgB,CAAC,MAAM,CAAC,EAAE,CAAC;YAC/B,MAAM,EAAE,IAAI,CAAC,gCAAgC,IAAI,GAAG,CAAC,qCAAqC,CAAC,CAAC;YAC5F,SAAS;QACV,CAAC;QACD,eAAe,CAAC,GAAG,CAAC,OAAO,EAAE,EAAE,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,IAAI,EAAE,MAA+C,EAAE,CAAC,CAAC;IAC9G,CAAC;IACD,IAAI,MAAqC,CAAC;IAC1C,KAAK,MAAM,MAAM,IAAI,eAAe,CAAC,MAAM,EAAE,EAAE,CAAC;QAC/C,IAAI,MAAM,CAAC,MAAM,IAAI,MAAM,CAAC,IAAI,KAAK,SAAS;YAAE,SAAS;QACzD,IAAI,MAAM,KAAK,SAAS,IAAI,MAAM,CAAC,IAAI,GAAG,MAAM,CAAC,IAAI;YAAE,MAAM,GAAG,MAAM,CAAC;IACxE,CAAC;IACD,OAAO,MAAM,EAAE,IAAI,CAAC;AAAA,CACpB;AAED,+FAAmD;AACnD,KAAK,UAAU,0BAA0B,CACxC,WAAmB,EACnB,OAAe,EACf,SAAiB,EACjB,GAAiB,EACD;IAChB,MAAM,KAAK,GAAoC;QAC9C,OAAO;QACP,SAAS;QACT,EAAE,EAAE,IAAI,IAAI,CAAC,GAAG,EAAE,CAAC,CAAC,WAAW,EAAE;QACjC,MAAM,EAAE,WAAW;KACnB,CAAC;IACF,MAAM,UAAU,CAAC,WAAW,EAAE,GAAG,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC;AAAA,CACpE;AAED;;;;GAIG;AACH,MAAM,UAAU,gBAAgB,CAAC,KAUhC,EAAgB;IAChB,MAAM,aAAa,GAAG,YAAY,KAAK,CAAC,OAAO,IAAI,KAAK,CAAC,KAAK,EAAE,CAAC;IACjE,MAAM,QAAQ,GAAG,OAAO,KAAK,CAAC,YAAY,CAAC,GAAG,KAAK,CAAC,KAAK,SAAS,aAAa,EAAE,CAAC,EAAE,CAAC;IACrF,MAAM,UAAU,GAAG,IAAI,IAAI,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,CAAC,WAAW,EAAE,CAAC;IACvD,OAAO,iBAAiB,CAAC;QACxB,QAAQ;QACR,eAAe,EAAE,0BAA0B;QAC3C,aAAa,EAAE,CAAC;QAChB,KAAK,EAAE,WAAW;QAClB,aAAa,EAAE,0BAA0B;QACzC,KAAK,EAAE,KAAK,CAAC,KAAK;QAClB,SAAS,EAAE,KAAK,CAAC,UAAU;QAC3B,GAAG,CAAC,KAAK,CAAC,MAAM,CAAC,IAAI,KAAK,OAAO,CAAC,CAAC,CAAC,EAAE,OAAO,EAAE,KAAK,CAAC,MAAM,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QAC3E,sBAAsB,EAAE,aAAa;QACrC,UAAU,EAAE,WAAW;QACvB,OAAO,EAAE,EAAE,SAAS,EAAE,KAAK,CAAC,QAAQ,CAAC,SAAS,EAAE;QAChD,UAAU;QACV,UAAU,EAAE,UAAU;QACtB,qGAA4C;QAC5C,UAAU,EAAE,EAAE;QACd,aAAa;QACb,WAAW,EAAE,EAAE;QACf,iBAAiB,EAAE,EAAE;QACrB,WAAW,EAAE,EAAE;QACf,WAAW,EAAE,EAAE;QACf,MAAM,EAAE,KAAK,CAAC,QAAQ,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC;YAC7C,SAAS,EAAE,wBAAwB;YACnC,aAAa,EAAE,CAAC;YAChB,GAAG,EAAE,KAAK,CAAC,GAAG;YACd,KAAK,EAAE,KAAK,CAAC,KAAK;SAClB,CAAC,CAAC;QACH,SAAS,EAAE,EAAE;QACb,iGAAsD;QACtD,UAAU,EAAE,GAAG;QACf,UAAU,EAAE,GAAG;QACf,aAAa,EAAE,SAAS;QACxB,eAAe,EAAE,KAAK,KAAK,CAAC,YAAY,CAAC,KAAK,CAAC,QAAQ,CAAC,SAAS,CAAC,EAAE;QACpE,WAAW,EAAE,GAAG,KAAK,CAAC,UAAU,WAAW;KAC3C,CAAC,CAAC;AAAA,CACH;AAED;;;;;;;GAOG;AACH,SAAS,gBAAgB,CACxB,IAAyB,EACzB,QAA+C,EAC/C,OAAe,EAC6B;IAC5C,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,GAAG,IAAI,CAAC,aAAa,EAAE,CAAC;IAChD,MAAM,iBAAiB,GAAG,IAAI,GAAG,CAAC,MAAM,CAAC,aAAa,EAAE,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC,CAAC;IACvF,IAAI,SAAS,GAAG,CAAC,CAAC;IAClB,IAAI,UAAU,GAAG,CAAC,CAAC;IACnB,KAAK,MAAM,CAAC,KAAK,EAAE,QAAQ,CAAC,IAAI,QAAQ,CAAC,OAAO,EAAE,EAAE,CAAC;QACpD,MAAM,IAAI,GAAG,gBAAgB,CAAC;YAC7B,QAAQ;YACR,OAAO;YACP,KAAK;YACL,KAAK,EAAE,IAAI,CAAC,KAAK;YACjB,MAAM;YACN,UAAU,EAAE,IAAI,CAAC,QAAQ,CAAC,EAAE;YAC5B,GAAG,EAAE,IAAI,CAAC,GAAG;YACb,YAAY,EAAE,IAAI,CAAC,YAAY;SAC/B,CAAC,CAAC;QACH,MAAM,QAAQ,GAAG,iBAAiB,CAAC,GAAG,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;QACtD,IAAI,QAAQ,IAAI,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,IAAI,CAAC,QAAQ,EAAE,EAAE,KAAK,EAAE,IAAI,CAAC,KAAK,EAAE,CAAC,KAAK,SAAS,EAAE,CAAC;YACpF,UAAU,IAAI,CAAC,CAAC;YAChB,SAAS;QACV,CAAC;QACD,IAAI,CAAC,QAAQ;YAAE,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;QACnC,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;QACxB,IAAI,CAAC,gBAAgB,CAAC,UAAU,CAAC,IAAI,CAAC,CAAC;QACvC,SAAS,IAAI,CAAC,CAAC;IAChB,CAAC;IACD,OAAO,EAAE,SAAS,EAAE,UAAU,EAAE,CAAC;AAAA,CACjC;AAsCD,8FAAoE;AACpE,SAAS,eAAe,CAAC,OAAgB,EAAU;IAClD,IAAI,OAAO,KAAK,IAAI,IAAI,OAAO,OAAO,KAAK,QAAQ,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,OAAO,CAAC,EAAE,CAAC;QAChF,MAAM,SAAS,GAAI,OAAmC,CAAC,SAAS,CAAC;QACjE,IAAI,OAAO,SAAS,KAAK,QAAQ;YAAE,OAAO,SAAS,CAAC;IACrD,CAAC;IACD,OAAO,IAAI,CAAC,SAAS,CAAC,OAAO,CAAC,CAAC;AAAA,CAC/B;AAED,MAAM,gBAAgB,GAAG,CAAC,KAAc,EAAU,EAAE,CAAC;IACpD,MAAM,OAAO,GAAG,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;IACvE,MAAM,UAAU,GAAG,KAAK,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;IACvC,OAAO,UAAU,CAAC,MAAM,IAAI,GAAG,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,GAAG,UAAU,CAAC,KAAK,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC,IAAI,CAAC,EAAE,CAAC,KAAG,CAAC;AAAA,CACpF,CAAC;AAEF,MAAM,aAAa,GAAG,CAAC,KAAc,EAAoC,EAAE,CAC1E,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,KAAK,IAAI,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC;AAEtE;;;;;GAKG;AACH,SAAS,iBAAiB,CACzB,GAAY,EACZ,MAA+B,EACsE;IACrG,IAAI,CAAC,aAAa,CAAC,GAAG,CAAC,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,GAAG,CAAC,SAAS,CAAC;QAAE,OAAO,SAAS,CAAC;IAC3E,MAAM,QAAQ,GAAiC,EAAE,CAAC;IAClD,IAAI,OAAO,GAAG,CAAC,CAAC;IAChB,KAAK,MAAM,CAAC,KAAK,EAAE,IAAI,CAAC,IAAI,GAAG,CAAC,SAAS,CAAC,OAAO,EAAE,EAAE,CAAC;QACrD,IAAI,QAAQ,CAAC,MAAM,IAAI,sBAAsB,EAAE,CAAC;YAC/C,OAAO,IAAI,CAAC,CAAC;YACb,SAAS;QACV,CAAC;QACD,IAAI,CAAC,aAAa,CAAC,IAAI,CAAC,IAAI,OAAO,IAAI,CAAC,SAAS,KAAK,QAAQ,EAAE,CAAC;YAChE,MAAM,EAAE,IAAI,CAAC,oCAAoC,KAAK,+BAA+B,CAAC,CAAC;YACvF,OAAO,IAAI,CAAC,CAAC;YACb,SAAS;QACV,CAAC;QACD,MAAM,SAAS,GAAG,IAAI,CAAC,SAAS,CAAC;QACjC,IAAI,SAAS,CAAC,IAAI,EAAE,KAAK,EAAE,EAAE,CAAC;YAC7B,MAAM,EAAE,IAAI,CAAC,oCAAoC,KAAK,uBAAuB,CAAC,CAAC;YAC/E,OAAO,IAAI,CAAC,CAAC;YACb,SAAS;QACV,CAAC;QACD,IAAI,SAAS,CAAC,MAAM,GAAG,4BAA4B,EAAE,CAAC;YACrD,MAAM,EAAE,IAAI,CACX,oCAAoC,KAAK,mBAAmB,SAAS,CAAC,MAAM,sBAAsB,4BAA4B,GAAG,CACjI,CAAC;YACF,OAAO,IAAI,CAAC,CAAC;YACb,SAAS;QACV,CAAC;QACD,IAAI,IAAI,CAAC,MAAM,KAAK,SAAS,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,MAAM,CAAC,EAAE,CAAC;YAC9D,MAAM,EAAE,IAAI,CAAC,oCAAoC,KAAK,yCAAyC,CAAC,CAAC;YACjG,OAAO,IAAI,CAAC,CAAC;YACb,SAAS;QACV,CAAC;QACD,MAAM,MAAM,GAAqC,EAAE,CAAC;QACpD,KAAK,MAAM,CAAC,UAAU,EAAE,QAAQ,CAAC,IAAI,CAAC,IAAI,CAAC,MAAM,IAAI,EAAE,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC;YACpE,IACC,CAAC,aAAa,CAAC,QAAQ,CAAC;gBACxB,OAAO,QAAQ,CAAC,GAAG,KAAK,QAAQ;gBAChC,QAAQ,CAAC,GAAG,CAAC,IAAI,EAAE,KAAK,EAAE;gBAC1B,OAAO,QAAQ,CAAC,KAAK,KAAK,QAAQ;gBAClC,QAAQ,CAAC,KAAK,CAAC,IAAI,EAAE,KAAK,EAAE,EAC3B,CAAC;gBACF,MAAM,EAAE,IAAI,CACX,oCAAoC,KAAK,WAAW,UAAU,wCAAwC,CACtG,CAAC;gBACF,SAAS;YACV,CAAC;YACD,MAAM,CAAC,IAAI,CAAC,EAAE,GAAG,EAAE,QAAQ,CAAC,GAAG,EAAE,KAAK,EAAE,QAAQ,CAAC,KAAK,EAAE,CAAC,CAAC;QAC3D,CAAC;QACD,QAAQ,CAAC,IAAI,CAAC,EAAE,SAAS,EAAE,MAAM,EAAE,CAAC,CAAC;IACtC,CAAC;IACD,IAAI,OAAO,GAAG,CAAC,EAAE,CAAC;QACjB,MAAM,EAAE,IAAI,CAAC,2BAA2B,OAAO,kDAAkD,CAAC,CAAC;IACpG,CAAC;IACD,OAAO,EAAE,QAAQ,EAAE,OAAO,EAAE,CAAC;AAAA,CAC7B;AAED;;;GAGG;AACH,KAAK,UAAU,iBAAiB,CAC/B,MAAgC,EAChC,MAA+B,EAG9B;IACD,IAAI,KAAiC,CAAC;IACtC,0GAA4C;IAC5C,IAAI,QAAwF,CAAC;IAC7F,IAAI,MAAM,KAAK,SAAS,EAAE,CAAC;QAC1B,QAAQ,GAAG,CAAC,GAAG,EAAE,CAAC;YACjB,IAAI,QAA+C,CAAC;YACpD,MAAM,OAAO,GAAG,GAAG,EAAE,CAAC,QAAQ,EAAE,CAAC,IAAI,KAAK,CAAC,qDAAqD,CAAC,CAAC,CAAC;YACnG,MAAM,OAAO,GAAG,IAAI,OAAO,CAAQ,CAAC,CAAC,EAAE,MAAM,EAAE,EAAE,CAAC;gBACjD,QAAQ,GAAG,MAAM,CAAC;gBAClB,IAAI,MAAM,CAAC,OAAO;oBAAE,MAAM,CAAC,IAAI,KAAK,CAAC,qDAAqD,CAAC,CAAC,CAAC;;oBACxF,MAAM,CAAC,gBAAgB,CAAC,OAAO,EAAE,OAAO,EAAE,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC;YAAA,CAC/D,CAAC,CAAC;YACH,OAAO,EAAE,OAAO,EAAE,OAAO,EAAE,GAAG,EAAE,CAAC,MAAM,CAAC,mBAAmB,CAAC,OAAO,EAAE,OAAO,CAAC,EAAE,CAAC;QAAA,CAChF,CAAC,EAAE,CAAC;IACN,CAAC;IACD,IAAI,CAAC;QACJ,MAAM,KAAK,GAAG,MAAM,OAAO,CAAC,IAAI,CAAC;YAChC,MAAM,CAAC,MAAM;YACb,IAAI,OAAO,CAAQ,CAAC,CAAC,EAAE,MAAM,EAAE,EAAE,CAAC;gBACjC,KAAK,GAAG,UAAU,CACjB,GAAG,EAAE,CAAC,MAAM,CAAC,IAAI,KAAK,CAAC,gDAAgD,0BAA0B,IAAI,CAAC,CAAC,EACvG,0BAA0B,CAC1B,CAAC;gBACF,KAAK,CAAC,KAAK,EAAE,EAAE,CAAC;YAAA,CAChB,CAAC;YACF,GAAG,CAAC,QAAQ,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC;SACrD,CAAC,CAAC;QACH,OAAO,EAAE,EAAE,EAAE,IAAI,EAAE,KAAK,EAAE,CAAC;IAC5B,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QAChB,MAAM,OAAO,GAAG,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;QACvE,IAAI,OAAO,CAAC,QAAQ,CAAC,uBAAuB,CAAC;YAAE,OAAO,EAAE,EAAE,EAAE,KAAK,EAAE,MAAM,EAAE,gBAAgB,EAAE,KAAK,EAAE,CAAC;QACrG,IAAI,OAAO,CAAC,QAAQ,CAAC,oBAAoB,CAAC;YAAE,OAAO,EAAE,EAAE,EAAE,KAAK,EAAE,MAAM,EAAE,SAAS,EAAE,KAAK,EAAE,CAAC;QAC3F,OAAO,EAAE,EAAE,EAAE,KAAK,EAAE,MAAM,EAAE,cAAc,EAAE,KAAK,EAAE,CAAC;IACrD,CAAC;YAAS,CAAC;QACV,IAAI,KAAK,KAAK,SAAS;YAAE,YAAY,CAAC,KAAK,CAAC,CAAC;QAC7C,QAAQ,EAAE,OAAO,EAAE,CAAC;IACrB,CAAC;AAAA,CACD;AAED;;;;;;;GAOG;AACH,MAAM,CAAC,KAAK,UAAU,aAAa,CAAC,IAAyB,EAAE,SAAiB,EAAsC;IACrH,MAAM,EAAE,GAAG,EAAE,cAAc,EAAE,KAAK,EAAE,KAAK,EAAE,GAAG,IAAI,CAAC;IACnD,MAAM,MAAM,GAAG,GAAG,CAAC,MAAM,CAAC;IAC1B,IAAI,cAAc,KAAK,SAAS,EAAE,CAAC;QAClC,4EAAsC;QACtC,MAAM,EAAE,IAAI,CAAC,uCAAuC,SAAS,wCAAwC,CAAC,CAAC;QACvG,OAAO,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,YAAY,EAAE,CAAC;IACpD,CAAC;IACD,yGAAqC;IACrC,MAAM,cAAc,GAAG,MAAM,cAAc,CAAC,cAAc,CAAC,SAAS,CAAC,CAAC;IACtE,IAAI,cAAc,KAAK,SAAS;QAAE,OAAO,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,iBAAiB,EAAE,CAAC;IAC1F,IAAI,cAAc,KAAK,SAAS;QAAE,OAAO,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,iBAAiB,EAAE,CAAC;IAE1F,MAAM,WAAW,GAAG,IAAI,CAAC,IAAI,CAAC,QAAQ,EAAE,8BAA8B,CAAC,CAAC;IACxE,2GAAiD;IACjD,mGAAqD;IACrD,mGAAqD;IACrD,yGAAyC;IACzC,4GAAsC;IACtC,mFAAmC;IACnC,MAAM,SAAS,GAAG,MAAM,qBAAqB,CAAC,WAAW,EAAE,SAAS,EAAE,MAAM,CAAC,CAAC;IAC9E,IAAI,SAAS,KAAK,SAAS,EAAE,CAAC;QAC7B,MAAM,QAAQ,GAAiC,SAAS,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC;YAClF,SAAS,EAAE,IAAI,CAAC,SAAS;YACzB,MAAM,EAAE,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC,EAAE,GAAG,EAAE,KAAK,CAAC,GAAG,EAAE,KAAK,EAAE,KAAK,CAAC,KAAK,EAAE,CAAC,CAAC;SAC5E,CAAC,CAAC,CAAC;QACJ,MAAM,EAAE,SAAS,EAAE,UAAU,EAAE,GAAG,gBAAgB,CAAC,IAAI,EAAE,QAAQ,EAAE,SAAS,CAAC,OAAO,CAAC,CAAC;QACtF,MAAM,0BAA0B,CAAC,WAAW,EAAE,SAAS,CAAC,OAAO,EAAE,SAAS,EAAE,IAAI,CAAC,GAAG,CAAC,CAAC;QACtF,MAAM,EAAE,IAAI,CACX,uCAAuC,SAAS,CAAC,OAAO,gBAAgB,SAAS,KAAK,SAAS,eAAe,UAAU,kBAAkB,CAC1I,CAAC;QACF,MAAM,cAAc,CAAC,cAAc,CAAC,SAAS,EAAE,SAAS,EAAE,EAAE,OAAO,EAAE,SAAS,CAAC,OAAO,EAAE,CAAC,CAAC;QAC1F,OAAO,EAAE,MAAM,EAAE,SAAS,EAAE,OAAO,EAAE,SAAS,CAAC,OAAO,EAAE,SAAS,EAAE,UAAU,EAAE,CAAC;IACjF,CAAC;IAED,yFAAiE;IACjE,yGAA6C;IAC7C,IAAI,YAAuC,CAAC;IAC5C,IAAI,CAAC;QACJ,YAAY,GAAG,GAAG,CAAC,YAAY,CAAC,OAAO,CAAC,oCAAoC,EAAE;YAC7E,OAAO,EAAE,8BAA8B;SACvC,CAAC,CAAC;IACJ,CAAC;IAAC,MAAM,CAAC;QACR,MAAM,cAAc,CAAC,cAAc,CAAC,SAAS,EAAE,SAAS,CAAC,CAAC;QAC1D,OAAO,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,gBAAgB,EAAE,CAAC;IACxD,CAAC;IAED,4GAA4C;IAC5C,2DAAmC;IACnC,MAAM,MAAM,GAAoC,EAAE,CAAC;IACnD,IAAI,MAA0B,CAAC;IAC/B,KAAK,IAAI,KAAK,GAAG,CAAC,EAAE,KAAK,GAAG,mBAAmB,EAAE,KAAK,IAAI,CAAC,EAAE,CAAC;QAC7D,MAAM,KAAK,GAAG,MAAM,cAAc,CAAC,WAAW,CAAC,SAAS,EAAE;YACzD,MAAM;YACN,KAAK,EAAE,0BAA0B;SACjC,CAAC,CAAC;QACH,IAAI,KAAK,CAAC,OAAO,CAAC,MAAM,GAAG,CAAC;YAAE,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;QACzD,MAAM,GAAG,KAAK,CAAC,UAAU,CAAC;QAC1B,IAAI,MAAM,KAAK,SAAS;YAAE,MAAM;IACjC,CAAC;IACD,MAAM,SAAS,GAAG,MAAM,KAAK,SAAS,CAAC;IAEvC,sGAA0D;IAC1D,MAAM,WAAW,GAAG,IAAI,GAAG,EAAU,CAAC;IACtC,KAAK,MAAM,MAAM,IAAI,KAAK,CAAC,IAAI,CAAC,EAAE,KAAK,EAAE,CAAC,EAAE,CAAC;QAC5C,IAAI,WAAW,CAAC,IAAI,IAAI,kCAAkC;YAAE,MAAM;QAClE,WAAW,CAAC,GAAG,CAAC,eAAe,CAAC,MAAM,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC,KAAK,CAAC,CAAC,EAAE,wCAAwC,CAAC,CAAC,CAAC;IAC1G,CAAC;IACD,MAAM,kBAAkB,GAAG,CAAC,GAAG,WAAW,CAAC,CAAC;IAC5C,IAAI,SAAS,EAAE,CAAC;QACf,kBAAkB,CAAC,IAAI,CACtB,kCAAkC,mBAAmB,YAAY,mBAAmB,GAAG,0BAA0B,qDAAqD,CACtK,CAAC;IACH,CAAC;IAED,2GAA8C;IAC9C,yGAAmD;IACnD,wGAAkD;IAClD,uDAAqC;IACrC,MAAM,QAAQ,GAAiC,EAAE,CAAC;IAClD,KAAK,MAAM,CAAC,UAAU,EAAE,KAAK,CAAC,IAAI,MAAM,CAAC,OAAO,EAAE,EAAE,CAAC;QACpD,IAAI,WAEmF,CAAC;QACxF,IAAI,CAAC;YACJ,WAAW,GAAG,MAAM,iBAAiB,CACpC,YAAY,CAAC,IAAI,CAAC;gBACjB,EAAE,EAAE,SAAS;gBACb,SAAS;gBACT,MAAM,EAAE,CAAC,KAAK,CAAC;gBACf,kBAAkB;aACqB,CAAC,EACzC,GAAG,CAAC,kBAAkB,EAAE,EAAE,CAC1B,CAAC;QACH,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YAChB,WAAW,GAAG,EAAE,EAAE,EAAE,KAAK,EAAE,MAAM,EAAE,cAAc,EAAE,KAAK,EAAE,CAAC;QAC5D,CAAC;QACD,IAAI,CAAC,WAAW,CAAC,EAAE,EAAE,CAAC;YACrB,MAAM,EAAE,IAAI,CACX,sCAAsC,SAAS,KAAK,WAAW,CAAC,MAAM,cAAc,UAAU,GAAG,CAAC,IAAI,MAAM,CAAC,MAAM,KAAK,gBAAgB,CAAC,WAAW,CAAC,KAAK,CAAC,EAAE,CAC7J,CAAC;YACF,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,WAAW,CAAC,MAAM,EAAE,CAAC;QACzD,CAAC;QACD,MAAM,SAAS,GAAG,iBAAiB,CAAC,WAAW,CAAC,KAAK,EAAE,MAAM,CAAC,CAAC;QAC/D,IAAI,SAAS,KAAK,SAAS,EAAE,CAAC;YAC7B,MAAM,EAAE,IAAI,CACX,sCAAsC,SAAS,yDAAyD,UAAU,GAAG,CAAC,IAAI,MAAM,CAAC,MAAM,EAAE,CACzI,CAAC;YACF,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,gBAAgB,EAAE,CAAC;QACvD,CAAC;QACD,QAAQ,CAAC,IAAI,CAAC,GAAG,SAAS,CAAC,QAAQ,CAAC,CAAC;IACtC,CAAC;IACD,8GAA6C;IAC7C,IAAI,QAAQ,CAAC,MAAM,GAAG,sBAAsB,EAAE,CAAC;QAC9C,MAAM,OAAO,GAAG,QAAQ,CAAC,MAAM,GAAG,sBAAsB,CAAC;QACzD,QAAQ,CAAC,MAAM,CAAC,sBAAsB,CAAC,CAAC;QACxC,MAAM,EAAE,IAAI,CACX,2BAA2B,OAAO,0CAA0C,sBAAsB,EAAE,CACpG,CAAC;IACH,CAAC;IAED,0FAAgE;IAChE,yFAAqC;IACrC,MAAM,OAAO,GAAG,QAAQ,CAAC,GAAG,CAAC,CAAC,QAAQ,EAAE,EAAE,CAAC,uBAAuB,CAAC,QAAQ,CAAC,SAAS,CAAC,CAAC,CAAC;IACxF,MAAM,OAAO,GAAG,iBAAiB,CAAC,SAAS,EAAE,OAAO,CAAC,CAAC;IACtD,MAAM,YAAY,GAA+B;QAChD,OAAO;QACP,SAAS;QACT,EAAE,EAAE,IAAI,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE,CAAC,CAAC,WAAW,EAAE;QACtC,MAAM,EAAE,MAAM;QACd,UAAU,EAAE,QAAQ,CAAC,GAAG,CAAC,CAAC,QAAQ,EAAE,EAAE,CAAC,CAAC,EAAE,SAAS,EAAE,QAAQ,CAAC,SAAS,EAAE,MAAM,EAAE,QAAQ,CAAC,MAAM,EAAE,CAAC,CAAC;QACpG,OAAO;KACP,CAAC;IACF,MAAM,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,QAAQ,EAAE,SAAS,EAAE,UAAU,CAAC,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IAC7E,MAAM,UAAU,CAAC,WAAW,EAAE,GAAG,IAAI,CAAC,SAAS,CAAC,YAAY,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC;IAE3E,wGAA+C;IAC/C,4EAAwC;IACxC,MAAM,EAAE,SAAS,EAAE,UAAU,EAAE,GAAG,gBAAgB,CAAC,IAAI,EAAE,QAAQ,EAAE,OAAO,CAAC,CAAC;IAC5E,MAAM,0BAA0B,CAAC,WAAW,EAAE,OAAO,EAAE,SAAS,EAAE,IAAI,CAAC,GAAG,CAAC,CAAC;IAC5E,MAAM,cAAc,CAAC,cAAc,CAAC,SAAS,EAAE,SAAS,EAAE,EAAE,OAAO,EAAE,CAAC,CAAC;IACvE,OAAO,EAAE,MAAM,EAAE,SAAS,EAAE,OAAO,EAAE,SAAS,EAAE,UAAU,EAAE,CAAC;AAAA,CAC7D;AAED;;;;;;;GAOG;AACH,MAAM,UAAU,mBAAmB,CAAC,IAAyB,EAAmB;IAC/E,MAAM,EAAE,GAAG,EAAE,cAAc,EAAE,GAAG,IAAI,CAAC;IACrC,MAAM,MAAM,GAAG,GAAG,CAAC,MAAM,CAAC;IAC1B,IAAI,cAAc,KAAK,SAAS;QAAE,OAAO,EAAE,aAAa,EAAE,EAAE,EAAE,CAAC;IAE/D,MAAM,MAAM,GAAG,IAAI,GAAG,EAA8C,CAAC;IACrE,MAAM,OAAO,GAAG,CAAC,SAAiB,EAAQ,EAAE,CAAC;QAC5C,8FAA0C;QAC1C,gEAAgC;QAChC,MAAM,IAAI,GAAG,MAAM,CAAC,GAAG,CAAC,SAAS,CAAC,IAAI,OAAO,CAAC,OAAO,EAAE,CAAC;QACxD,MAAM,IAAI,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,SAAS,CAAC,CAAC,IAAI,CAAC,GAAG,EAAE,CAAC,aAAa,CAAC,IAAI,EAAE,SAAS,CAAC,CAAC,CAAC;QACpF,MAAM,CAAC,GAAG,CAAC,SAAS,EAAE,IAAI,CAAC,CAAC;QAC5B,KAAK,IAAI,CAAC,KAAK,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC;YAC1B,MAAM,EAAE,IAAI,CAAC,sCAAsC,SAAS,KAAK,gBAAgB,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC;QAAA,CAC5F,CAAC,CAAC;QACH,4FAAwC;QACxC,6DAA+C;QAC/C,KAAK,IAAI;aACP,KAAK,CAAC,GAAG,EAAE,CAAC,SAAS,CAAC;aACtB,OAAO,CAAC,GAAG,EAAE,CAAC;YACd,IAAI,MAAM,CAAC,GAAG,CAAC,SAAS,CAAC,KAAK,IAAI;gBAAE,MAAM,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC;QAAA,CAC7D,CAAC,CAAC;IAAA,CACJ,CAAC;IAEF,4GAAgD;IAChD,MAAM,KAAK,GAAG,KAAK,IAAmB,EAAE,CAAC;QACxC,IAAI,CAAC;YACJ,MAAM,QAAQ,GAAG,MAAM,cAAc,CAAC,YAAY,EAAE,CAAC;YACrD,KAAK,MAAM,IAAI,IAAI,QAAQ,EAAE,CAAC;gBAC7B,IAAI,IAAI,CAAC,QAAQ,KAAK,SAAS;oBAAE,SAAS;gBAC1C,OAAO,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;YACzB,CAAC;QACF,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YAChB,MAAM,EAAE,IAAI,CAAC,yCAAyC,gBAAgB,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC;QAClF,CAAC;IAAA,CACD,CAAC;IACF,KAAK,KAAK,EAAE,CAAC;IAEb,MAAM,aAAa,GAA6B,EAAE,CAAC;IACnD,8FAA0D;IAC1D,yFAAyC;IACzC,IAAI,GAAG,CAAC,SAAS,KAAK,SAAS,EAAE,CAAC;QACjC,aAAa,CAAC,IAAI,CACjB,GAAG,CAAC,SAAS,CAAC,eAAe,CAAmC,gCAAgC,EAAE,CAAC,KAAK,EAAE,EAAE,CAAC;YAC5G,OAAO,CAAC,KAAK,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;QAAA,CAC9B,CAAC,CACF,CAAC;IACH,CAAC;SAAM,CAAC;QACP,MAAM,EAAE,IAAI,CAAC,yFAAyF,CAAC,CAAC;IACzG,CAAC;IACD,OAAO,EAAE,aAAa,EAAE,CAAC;AAAA,CACzB","sourcesContent":["/**\n * 归档会话整理器（记忆归档与整理设计 §5-§7，2026-10-22 裁决落地）：\n * 归档即后台整理。memory 插件负责调度、切片预算、批次协议、幂等提交与\n * 生命周期；\"从会话里提炼什么\"由经 `memory.curation-policy@1` 能力目录\n * require 到的整理策略插件回答（第一方默认策略是 plugins/memory-curation，\n * 与第三方策略走同一公共契约，本模块对两者无差别）。\n *\n * 与来源切割（§6 用户裁决）：整理产物是独立原子——不带 sessionRefs、不带指向\n * 会话条目的 sourceRefs、不写 provenance；删除会话不触碰记忆原子。操作凭据\n * 留在本侧 journal（`<agentDir>/archive/sessions/curation-journal.jsonl`，\n * batchId + 内容 digest，不含会话原文）。\n *\n * 批次协议（§5.3.6/§5.3.7）：journal 是批次的可恢复事实来源——追加式 JSONL，\n * 行带 status：\"open\" 行先落盘（批次完整结果），全部原子提交完成后追加\n * \"committed\" 事实行，同 batchId 以文件末条为准。curateSession 开始时先查\n * 该会话的 open 批次：存在则不调策略、不读会话，直接按持久化的 statements\n * 以相同确定性 observationId 重放提交（已提交条目去重跳过，剩余补齐），收口\n * 后照常 reportCuration——旧批次未处理时不开始新批次，两批各自不完整的原子\n * 不可能并存；重放发现批次实际早已全部提交（全部幂等跳过）也走完收口。\n * 旧版无 status 字段的行等价 open（旧版在提交前一刻落盘，语义相同）。\n *\n * 暂停/续跑（§5.4 用户裁决）：策略抛错、超时（60s 上限）或会话中止信号触发时\n * 返回 paused——不写 curated、不落 journal、不留部分提交；curation 维度保持\n * 缺失，归档事件重投或启动 sweep 会自然续跑。已提交条目经确定性 memoryId\n * （owner + `curation:<batchId>:<index>`）在 store 回查去重，同 batchId 重试\n * 不会产生重复原子。\n */\nimport { createHash } from \"node:crypto\";\nimport { appendFile, mkdir, readFile } from \"node:fs/promises\";\nimport { join } from \"node:path\";\nimport type {\n\tCapabilityAPI,\n\tCapabilityHandle,\n\tDisposableRegistration,\n\tOperationHandle,\n\tSessionArchiveHostV1,\n\tSessionEntryView,\n} from \"@agent-forge/plugin-sdk\";\nimport { buildMemoryAtomV1, type MemoryAtomV1 } from \"./foundation.ts\";\nimport type { DurableMemoryLedgerV1 } from \"./ledger.ts\";\nimport type { MemoryStoreV1 } from \"./store.ts\";\nimport type { SuiteMemoryDomainV1 } from \"./suite-memory.ts\";\nimport { MEMORY_CONTRACT_VERSION_V2 } from \"./transfer.ts\";\nimport type { MemoryVectorProjectionV1 } from \"./vector-projection.ts\";\n\n/** 整理策略能力 id（记忆归档与整理设计 §7.2 冻结契约）。 */\nexport const MEMORY_CURATION_POLICY_CAPABILITY_ID = \"memory.curation-policy\";\n/** 整理策略能力版本（exact version matching）。 */\nexport const MEMORY_CURATION_POLICY_VERSION = 1;\n\n/** 每片最大条目数（有界切片，按条数）。 */\nexport const CURATION_SLICE_MAX_ENTRIES = 200;\n/** 最多片数；超出截断并在 existingStatements 摘要里说明。 */\nexport const CURATION_MAX_SLICES = 20;\n/** 传给策略的既有 statement 摘要条数上限（去重参考）。 */\nexport const CURATION_EXISTING_STATEMENTS_LIMIT = 100;\n/** 既有 statement 摘要的每条截断长度（字符）。 */\nexport const CURATION_EXISTING_STATEMENT_PREFIX_CHARS = 200;\n/** 单批 proposal 条数上限；超出部分丢弃并 warn。 */\nexport const CURATION_MAX_PROPOSALS = 20;\n/** 单条 statement 上限（与 memory_write 内容契约同口径，UTF-16 单元）。 */\nexport const CURATION_STATEMENT_MAX_CHARS = 700;\n/** 策略调用硬截止；超时按暂停处理（模型恢复后续跑）。 */\nexport const CURATION_POLICY_TIMEOUT_MS = 60_000;\n/** 整理产物 facets 的 capability 命名空间（与 tag facet 同域 \"builtin.memory\"）。 */\nconst CURATION_FACET_NAMESPACE = \"builtin.memory\";\n/** 整理产物保留档（first-party retention registry \"long\"，随记忆自身周期朝生暮死）。 */\nconst CURATION_RETENTION_MODE_ID = \"long\";\n/** 整理批次 journal 路径（相对 agentDir；只含 batchId/digest/结果，无会话原文）。 */\nconst CURATION_JOURNAL_RELATIVE_PATH = join(\"archive\", \"sessions\", \"curation-journal.jsonl\");\n\n/**\n * `session.archived@1`（宿主 lifecycle catalog）数据的结构化收窄——只取整理器\n * 读的字段。订阅走 `{id, version}` 引用形式：定义归宿主 bootstrap lifecycle\n * 插件所有，宿主未定义该事件时注册被结构性拒绝（D-028 插件装载失败，绝不会\n * 变成会话失败）。\n */\nexport const SESSION_ARCHIVED_EVENT_REFERENCE = { id: \"session.archived\", version: 1 } as const;\n\n/** Structural narrowing of the host catalog's `SessionArchivedEventDataV1`. */\nexport interface MemorySessionArchivedEventDataV1 {\n\treadonly version: 1;\n\treadonly sessionId: string;\n}\n\n/** 策略 `propose` 输入（记忆归档与整理设计 §7.2 冻结形状）。 */\nexport interface CurationPolicyProposeInputV1 {\n\treadonly op: \"propose\";\n\treadonly sessionId: string;\n\t/**\n\t * 有界输入（§5.4）：整理器逐片调用策略——每片一次 propose、每次恰好一片\n\t * （≤ {@link CURATION_SLICE_MAX_ENTRIES} 条），保留数组形状以维持 §7.2\n\t * 冻结契约；最多 {@link CURATION_MAX_SLICES} 片（超出截断并在\n\t * existingStatements 附说明项）。\n\t */\n\treadonly slices: readonly (readonly SessionEntryView[])[];\n\t/** 既有记忆 statement 前 200 字符列表（≤100 条，去重参考；截断时附说明项）。 */\n\treadonly existingStatements: readonly string[];\n}\n\n/** 策略 `propose` 单条候选（原始形状，提交前由 memory 校验）。 */\nexport interface CurationProposalV1 {\n\treadonly statement: string;\n\treadonly facets?: readonly unknown[];\n}\n\n/** 策略 `propose` 结果（候选——提交与否由 memory 决定）。 */\nexport interface CurationPolicyProposeResultV1 {\n\treadonly proposals: readonly CurationProposalV1[];\n}\n\n/** 校验后进入批次的候选：statement 合法，facets 已规范化。 */\nexport interface AcceptedCurationProposalV1 {\n\treadonly statement: string;\n\treadonly facets: readonly { readonly key: string; readonly value: string }[];\n}\n\n/** 单次 curateSession 的运行结论。 */\nexport type MemoryCurationRunResultV1 =\n\t| {\n\t\t\treadonly status: \"curated\";\n\t\t\treadonly batchId: string;\n\t\t\t/** 本次新提交的原子数。 */\n\t\t\treadonly committed: number;\n\t\t\t/** 同 batchId 重试时已存在而跳过的原子数。 */\n\t\t\treadonly duplicates: number;\n\t  }\n\t| {\n\t\t\treadonly status: \"skipped\";\n\t\t\treadonly reason: \"no-archive\" | \"policy-missing\" | \"already-curated\" | \"already-skipped\";\n\t  }\n\t| {\n\t\t\treadonly status: \"paused\";\n\t\t\treadonly reason: \"policy-error\" | \"policy-timeout\" | \"aborted\" | \"invalid-result\";\n\t  };\n\n/** journal open 行：批次的完整结果（§5.3 重试只读它，不再重新生成）。 */\nexport interface CurationJournalOpenEntryV1 {\n\treadonly batchId: string;\n\treadonly sessionId: string;\n\treadonly at: string;\n\treadonly status: \"open\";\n\treadonly statements: readonly {\n\t\treadonly statement: string;\n\t\treadonly facets: readonly { readonly key: string; readonly value: string }[];\n\t}[];\n\treadonly digests: readonly string[];\n}\n\n/** journal committed 事实行：批次全部原子落库后的追加式收口（同 batchId 以文件末条为准）。 */\nexport interface CurationJournalCommittedEntryV1 {\n\treadonly batchId: string;\n\treadonly sessionId: string;\n\treadonly at: string;\n\treadonly status: \"committed\";\n}\n\n/** 整理批次 journal 行（冻结契约：不含会话原文；追加式，按 batchId 取末条）。 */\nexport type CurationJournalEntryV1 = CurationJournalOpenEntryV1 | CurationJournalCommittedEntryV1;\n\n/** 批次凭据：batchId = sha256(sessionId + 各 statement digest 拼接)。 */\nexport function curationBatchIdOf(sessionId: string, statementDigests: readonly string[]): string {\n\tconst hash = createHash(\"sha256\");\n\thash.update(sessionId);\n\tfor (const digest of statementDigests) hash.update(digest);\n\treturn hash.digest(\"hex\");\n}\n\n/** 单条 statement 的 sha256 digest（journal 与 batchId 共用）。 */\nexport function curationStatementDigest(statement: string): string {\n\treturn createHash(\"sha256\").update(statement, \"utf8\").digest(\"hex\");\n}\n\n/**\n * open 行形状校验（journal 由本模块写出，重放前仍校验——防崩溃残行与外手改写\n * 产生非法原子）。旧版行无 status 字段：形状同 open，等价 open 处理。\n */\nfunction isOpenEntryShape(value: Record<string, unknown>): boolean {\n\tif (value.status !== \"open\" && value.status !== undefined) return false;\n\tif (!Array.isArray(value.statements) || !Array.isArray(value.digests)) return false;\n\treturn value.statements.every(\n\t\t(item) =>\n\t\t\tisPlainRecord(item) &&\n\t\t\ttypeof item.statement === \"string\" &&\n\t\t\titem.statement !== \"\" &&\n\t\t\tArray.isArray(item.facets) &&\n\t\t\titem.facets.every(\n\t\t\t\t(facet) => isPlainRecord(facet) && typeof facet.key === \"string\" && typeof facet.value === \"string\",\n\t\t\t),\n\t);\n}\n\n/**\n * 读取该会话的未完成批次（§5.3.6 崩溃重试入口，§5.3.7 新批次守卫的依据）：\n * journal 是追加式事实流，同 batchId 以文件末条为准；末条仍为 open 即未完成。\n * 多个 open 批次并存时（仅可能来自协议启用前的旧文件）取文件序最后一条。\n * 文件不存在返回 undefined；JSON 解析失败的残行告警跳过（只可能是崩溃中追加\n * 的末行，不影响更早的完整行）；不可重放的 open 行属于事实来源损坏，向上抛错\n * ——按 §5.3.7 拒绝开始新批次，而不是在坏批次之上再开一批。\n */\nasync function readOpenCurationBatch(\n\tjournalPath: string,\n\tsessionId: string,\n\tlogger: CapabilityAPI[\"logger\"],\n): Promise<CurationJournalOpenEntryV1 | undefined> {\n\tlet text: string;\n\ttry {\n\t\ttext = await readFile(journalPath, \"utf8\");\n\t} catch (error) {\n\t\tif ((error as NodeJS.ErrnoException).code === \"ENOENT\") return undefined;\n\t\tthrow error;\n\t}\n\tinterface JournalLineRecord {\n\t\treadonly line: number;\n\t\treadonly closed: boolean;\n\t\treadonly open: CurationJournalOpenEntryV1 | undefined;\n\t}\n\tconst lastLineByBatch = new Map<string, JournalLineRecord>();\n\tfor (const [line, raw] of text.split(\"\\n\").entries()) {\n\t\tif (raw.trim() === \"\") continue;\n\t\tlet parsed: unknown;\n\t\ttry {\n\t\t\tparsed = JSON.parse(raw);\n\t\t} catch {\n\t\t\tlogger?.warn(`memory curation journal line ${line + 1} is not valid JSON; skipped`);\n\t\t\tcontinue;\n\t\t}\n\t\tif (!isPlainRecord(parsed) || parsed.sessionId !== sessionId) continue;\n\t\tconst batchId = parsed.batchId;\n\t\tif (typeof batchId !== \"string\" || batchId === \"\") continue;\n\t\tif (parsed.status === \"committed\") {\n\t\t\tlastLineByBatch.set(batchId, { line, closed: true, open: undefined });\n\t\t\tcontinue;\n\t\t}\n\t\tif (!isOpenEntryShape(parsed)) {\n\t\t\tlogger?.warn(`memory curation journal line ${line + 1} has an unrecognized shape; skipped`);\n\t\t\tcontinue;\n\t\t}\n\t\tlastLineByBatch.set(batchId, { line, closed: false, open: parsed as unknown as CurationJournalOpenEntryV1 });\n\t}\n\tlet latest: JournalLineRecord | undefined;\n\tfor (const record of lastLineByBatch.values()) {\n\t\tif (record.closed || record.open === undefined) continue;\n\t\tif (latest === undefined || record.line > latest.line) latest = record;\n\t}\n\treturn latest?.open;\n}\n\n/** 追加 committed 事实行（open 行落盘时目录已创建，此处无需 mkdir）。 */\nasync function appendCommittedJournalLine(\n\tjournalPath: string,\n\tbatchId: string,\n\tsessionId: string,\n\tnow: () => number,\n): Promise<void> {\n\tconst entry: CurationJournalCommittedEntryV1 = {\n\t\tbatchId,\n\t\tsessionId,\n\t\tat: new Date(now()).toISOString(),\n\t\tstatus: \"committed\",\n\t};\n\tawait appendFile(journalPath, `${JSON.stringify(entry)}\\n`, \"utf8\");\n}\n\n/**\n * 确定性构造整理原子（记忆归档与整理设计 §5.2 冻结字段表）。不复用 buildWriteAtom——\n * 那里 observationId 前缀写死 memory_write 会话序列。identityHash 由装配方\n * 注入（capability.ts 的 FNV-1a，同一写入身份口径）。\n */\nexport function buildCuratedAtom(input: {\n\treadonly proposal: AcceptedCurationProposalV1;\n\treadonly batchId: string;\n\treadonly index: number;\n\treadonly owner: string;\n\t/** 提交域（当前会话的 suite 绑定解析结果）：suite 域原子带 suiteId 读边界。 */\n\treadonly domain: SuiteMemoryDomainV1;\n\treadonly manifestId: string;\n\treadonly now: () => number;\n\treadonly identityHash: (value: string) => string;\n}): MemoryAtomV1 {\n\tconst observationId = `curation:${input.batchId}:${input.index}`;\n\tconst memoryId = `mem-${input.identityHash(`${input.owner}\\u0000${observationId}`)}`;\n\tconst occurredAt = new Date(input.now()).toISOString();\n\treturn buildMemoryAtomV1({\n\t\tmemoryId,\n\t\tcontractVersion: MEMORY_CONTRACT_VERSION_V2,\n\t\tschemaVersion: 1,\n\t\tscope: \"long-term\",\n\t\tretentionMode: CURATION_RETENTION_MODE_ID,\n\t\towner: input.owner,\n\t\tprofileId: input.manifestId,\n\t\t...(input.domain.kind === \"suite\" ? { suiteId: input.domain.suiteId } : {}),\n\t\tretentionPolicyVersion: \"retention@1\",\n\t\tmemoryKind: \"synthesis\",\n\t\tpayload: { statement: input.proposal.statement },\n\t\toccurredAt,\n\t\trecordedAt: occurredAt,\n\t\t// 记忆与来源会话彻底切割（§6）：无来源引用、无会话引用、无 provenance。\n\t\tsourceRefs: [],\n\t\tobservationId,\n\t\tsessionRefs: [],\n\t\tagentInstanceRefs: [],\n\t\tprojectRefs: [],\n\t\tsubjectRefs: [],\n\t\tfacets: input.proposal.facets.map((facet) => ({\n\t\t\tnamespace: CURATION_FACET_NAMESPACE,\n\t\t\tschemaVersion: 1,\n\t\t\tkey: facet.key,\n\t\t\tvalue: facet.value,\n\t\t})),\n\t\trelations: [],\n\t\t// 模型归纳内容（§5.2 evidenceClass derived）：保守置信与推断写入同档 0.6。\n\t\tconfidence: 0.6,\n\t\timportance: 0.5,\n\t\tevidenceClass: \"derived\",\n\t\tcontentRevision: `c-${input.identityHash(input.proposal.statement)}`,\n\t\twriteReason: `${input.manifestId}/curation`,\n\t});\n}\n\n/**\n * 逐条提交批次原子（顺序照 write-face 工具路径：先账本后可见，投影埋点收尾）。\n * 幂等判定同时看 store 与账本快照（§5.3 崩溃重试语义的提交侧，新批次与 journal\n * 重放共用）：提交循环可能在\"账本已 append、store 未 commit\"的窗口被打断——\n * 账本是持久事实，重放对该窗口内的原子只补齐 store 可见性与投影，不再 append\n * 重复账本行；两侧都在的条目跳过，都缺的整条提交。调用方负责 journal 状态收口\n * 与 reportCuration。\n */\nfunction commitBatchAtoms(\n\tdeps: MemoryCuratorDepsV1,\n\taccepted: readonly AcceptedCurationProposalV1[],\n\tbatchId: string,\n): { committed: number; duplicates: number } {\n\tconst { domain, ledger } = deps.resolveDomain();\n\tconst ledgeredMemoryIds = new Set(ledger.atomsSnapshot().map((atom) => atom.memoryId));\n\tlet committed = 0;\n\tlet duplicates = 0;\n\tfor (const [index, proposal] of accepted.entries()) {\n\t\tconst atom = buildCuratedAtom({\n\t\t\tproposal,\n\t\t\tbatchId,\n\t\t\tindex,\n\t\t\towner: deps.owner,\n\t\t\tdomain,\n\t\t\tmanifestId: deps.manifest.id,\n\t\t\tnow: deps.now,\n\t\t\tidentityHash: deps.identityHash,\n\t\t});\n\t\tconst ledgered = ledgeredMemoryIds.has(atom.memoryId);\n\t\tif (ledgered && deps.store.get(atom.memoryId, { owner: deps.owner }) !== undefined) {\n\t\t\tduplicates += 1;\n\t\t\tcontinue;\n\t\t}\n\t\tif (!ledgered) ledger.append(atom);\n\t\tdeps.store.commit(atom);\n\t\tdeps.vectorProjection.upsertAtom(atom);\n\t\tcommitted += 1;\n\t}\n\treturn { committed, duplicates };\n}\n\n/** 整理器对 capability 闭包的显式依赖视图。 */\nexport interface MemoryCuratorDepsV1 {\n\t/** capability API：logger / capabilities（策略 require）/ lifecycle / sessionAbortSignal。 */\n\treadonly api: CapabilityAPI;\n\t/** agent 根目录：journal 落在 `<agentDir>/archive/sessions/`。 */\n\treadonly agentDir: string;\n\t/** 检索行 owner（capability.BUILTIN_MEMORY_OWNER）。 */\n\treadonly owner: string;\n\t/** 时钟（harness now）。 */\n\treadonly now: () => number;\n\t/** capability 清单：profileId 与 writeReason `<manifest.id>/curation` 来源。 */\n\treadonly manifest: { readonly id: string };\n\t/** canonical store（per-capability 单例）：幂等回查 + 既有 statement 摘要来源。 */\n\treadonly store: MemoryStoreV1;\n\t/** 域解析（capability.resolveDomain）：批次提交前解析一次，取 per-domain ledger。 */\n\treadonly resolveDomain: () => {\n\t\treadonly domain: SuiteMemoryDomainV1;\n\t\treadonly domainName: string;\n\t\treadonly ledger: DurableMemoryLedgerV1;\n\t};\n\t/** 写侧投影（slice 3a 的 vectorProjection）：提交后埋点。 */\n\treadonly vectorProjection: MemoryVectorProjectionV1;\n\t/** 写入身份哈希（capability.ts FNV-1a，经 deps 注入避免双头定义）。 */\n\treadonly identityHash: (value: string) => string;\n\t/**\n\t * 会话归档协调面（宿主服务，context/`api.host.sessionArchive` 已解析）。\n\t * undefined = 宿主不开放归档：两个触发都不注册，记忆家族其余能力不受影响。\n\t */\n\treadonly sessionArchive: SessionArchiveHostV1 | undefined;\n}\n\n/** 整理器工厂产物：随 capability 注册/卸载的观察项（归档面缺席时为空）。 */\nexport interface MemoryCuratorV1 {\n\treadonly registrations: readonly DisposableRegistration[];\n}\n\n/** payload `{ statement }` 约定的读取投影（与 capability.statementOf 同构）。 */\nfunction statementTextOf(payload: unknown): string {\n\tif (payload !== null && typeof payload === \"object\" && !Array.isArray(payload)) {\n\t\tconst statement = (payload as { statement?: unknown }).statement;\n\t\tif (typeof statement === \"string\") return statement;\n\t}\n\treturn JSON.stringify(payload);\n}\n\nconst boundedErrorText = (error: unknown): string => {\n\tconst message = error instanceof Error ? error.message : String(error);\n\tconst codePoints = Array.from(message);\n\treturn codePoints.length <= 200 ? message : `${codePoints.slice(0, 200).join(\"\")}…`;\n};\n\nconst isPlainRecord = (value: unknown): value is Record<string, unknown> =>\n\ttypeof value === \"object\" && value !== null && !Array.isArray(value);\n\n/**\n * proposals 校验（提交闸门在 memory 侧，记忆归档与整理设计 §7.2）：statement 非空且\n * ≤700 字符、条数 ≤20（超出丢弃并 warn）、facets 形状非法整条丢弃。facets 内\n * 单项 key/value 非空字符串校验，非法项丢弃该 facet（不连坐整条）。结果整体\n * 非 { proposals: [...] } 形状 = 策略契约失败，返回 undefined 交由调用方暂停。\n */\nfunction validateProposals(\n\traw: unknown,\n\tlogger: CapabilityAPI[\"logger\"],\n): { readonly accepted: readonly AcceptedCurationProposalV1[]; readonly dropped: number } | undefined {\n\tif (!isPlainRecord(raw) || !Array.isArray(raw.proposals)) return undefined;\n\tconst accepted: AcceptedCurationProposalV1[] = [];\n\tlet dropped = 0;\n\tfor (const [index, item] of raw.proposals.entries()) {\n\t\tif (accepted.length >= CURATION_MAX_PROPOSALS) {\n\t\t\tdropped += 1;\n\t\t\tcontinue;\n\t\t}\n\t\tif (!isPlainRecord(item) || typeof item.statement !== \"string\") {\n\t\t\tlogger?.warn(`memory curation dropped proposal[${index}]: statement must be a string`);\n\t\t\tdropped += 1;\n\t\t\tcontinue;\n\t\t}\n\t\tconst statement = item.statement;\n\t\tif (statement.trim() === \"\") {\n\t\t\tlogger?.warn(`memory curation dropped proposal[${index}]: statement is empty`);\n\t\t\tdropped += 1;\n\t\t\tcontinue;\n\t\t}\n\t\tif (statement.length > CURATION_STATEMENT_MAX_CHARS) {\n\t\t\tlogger?.warn(\n\t\t\t\t`memory curation dropped proposal[${index}]: statement is ${statement.length} characters (limit ${CURATION_STATEMENT_MAX_CHARS})`,\n\t\t\t);\n\t\t\tdropped += 1;\n\t\t\tcontinue;\n\t\t}\n\t\tif (item.facets !== undefined && !Array.isArray(item.facets)) {\n\t\t\tlogger?.warn(`memory curation dropped proposal[${index}]: facets must be an array when present`);\n\t\t\tdropped += 1;\n\t\t\tcontinue;\n\t\t}\n\t\tconst facets: { key: string; value: string }[] = [];\n\t\tfor (const [facetIndex, rawFacet] of (item.facets ?? []).entries()) {\n\t\t\tif (\n\t\t\t\t!isPlainRecord(rawFacet) ||\n\t\t\t\ttypeof rawFacet.key !== \"string\" ||\n\t\t\t\trawFacet.key.trim() === \"\" ||\n\t\t\t\ttypeof rawFacet.value !== \"string\" ||\n\t\t\t\trawFacet.value.trim() === \"\"\n\t\t\t) {\n\t\t\t\tlogger?.warn(\n\t\t\t\t\t`memory curation dropped proposal[${index}] facet[${facetIndex}]: key/value must be non-empty strings`,\n\t\t\t\t);\n\t\t\t\tcontinue;\n\t\t\t}\n\t\t\tfacets.push({ key: rawFacet.key, value: rawFacet.value });\n\t\t}\n\t\taccepted.push({ statement, facets });\n\t}\n\tif (dropped > 0) {\n\t\tlogger?.warn(`memory curation dropped ${dropped} invalid proposal(s) before committing the batch`);\n\t}\n\treturn { accepted, dropped };\n}\n\n/**\n * 策略调用竞速：`handle.result` vs 60s 硬截止 vs 会话中止信号。三个败因都收敛\n * 为 paused 的 reason（模型不可用/挂起 → 暂停续跑语义，§5.4 用户裁决）。\n */\nasync function awaitPolicyResult(\n\thandle: OperationHandle<unknown>,\n\tsignal: AbortSignal | undefined,\n): Promise<\n\t{ ok: true; value: unknown } | { ok: false; reason: \"policy-timeout\" | \"aborted\" | \"policy-error\"; error: unknown }\n> {\n\tlet timer: NodeJS.Timeout | undefined;\n\t// 中止信号 → 立即拒绝的竞速臂；dispose 摘除监听，竞速已定时不再持有信号。\n\tlet abortArm: { readonly promise: Promise<never>; readonly dispose: () => void } | undefined;\n\tif (signal !== undefined) {\n\t\tabortArm = (() => {\n\t\t\tlet rejectFn: ((reason: Error) => void) | undefined;\n\t\t\tconst onAbort = () => rejectFn?.(new Error(\"memory curation aborted: session abort signal fired\"));\n\t\t\tconst promise = new Promise<never>((_, reject) => {\n\t\t\t\trejectFn = reject;\n\t\t\t\tif (signal.aborted) reject(new Error(\"memory curation aborted: session abort signal fired\"));\n\t\t\t\telse signal.addEventListener(\"abort\", onAbort, { once: true });\n\t\t\t});\n\t\t\treturn { promise, dispose: () => signal.removeEventListener(\"abort\", onAbort) };\n\t\t})();\n\t}\n\ttry {\n\t\tconst value = await Promise.race([\n\t\t\thandle.result,\n\t\t\tnew Promise<never>((_, reject) => {\n\t\t\t\ttimer = setTimeout(\n\t\t\t\t\t() => reject(new Error(`memory curation policy did not settle within ${CURATION_POLICY_TIMEOUT_MS}ms`)),\n\t\t\t\t\tCURATION_POLICY_TIMEOUT_MS,\n\t\t\t\t);\n\t\t\t\ttimer.unref?.();\n\t\t\t}),\n\t\t\t...(abortArm === undefined ? [] : [abortArm.promise]),\n\t\t]);\n\t\treturn { ok: true, value };\n\t} catch (error) {\n\t\tconst message = error instanceof Error ? error.message : String(error);\n\t\tif (message.includes(\"did not settle within\")) return { ok: false, reason: \"policy-timeout\", error };\n\t\tif (message.includes(\"abort signal fired\")) return { ok: false, reason: \"aborted\", error };\n\t\treturn { ok: false, reason: \"policy-error\", error };\n\t} finally {\n\t\tif (timer !== undefined) clearTimeout(timer);\n\t\tabortArm?.dispose();\n\t}\n}\n\n/**\n * 整理一个归档会话（记忆归档与整理设计 §5 批次协议）：幂等状态回查 → journal\n * open 批次重放（有则不调策略、不读会话，按持久化结果补齐提交并收口，§5.3.6/\n * §5.3.7）→ 策略 require → 有界分页读 → 逐片策略 propose（每片一次调用；任一\n * 片失败/超时/中止/非法结果即整批暂停，§5.4）→ 合并候选 → journal open 行落盘\n * → 逐条幂等提交 → journal committed 收口 → 回写 curated。任何暂停/失败路径都\n * 不写 curated、不留部分提交。\n */\nexport async function curateSession(deps: MemoryCuratorDepsV1, sessionId: string): Promise<MemoryCurationRunResultV1> {\n\tconst { api, sessionArchive, store, owner } = deps;\n\tconst logger = api.logger;\n\tif (sessionArchive === undefined) {\n\t\t// 无归档面则 reportCuration 不可能：本地记录后直接返回。\n\t\tlogger?.warn(`memory curation skipped for session ${sessionId}: host exposes no session-archive face`);\n\t\treturn { status: \"skipped\", reason: \"no-archive\" };\n\t}\n\t// 幂等：该会话已有整理结论时不再跑批（重试链路与事件重投的自然短路）。\n\tconst existingStatus = await sessionArchive.curationStatus(sessionId);\n\tif (existingStatus === \"curated\") return { status: \"skipped\", reason: \"already-curated\" };\n\tif (existingStatus === \"skipped\") return { status: \"skipped\", reason: \"already-skipped\" };\n\n\tconst journalPath = join(deps.agentDir, CURATION_JOURNAL_RELATIVE_PATH);\n\t// 批次协议（§5.3.6/§5.3.7）：open 批次是唯一事实来源——不调策略、不读会话，\n\t// 直接按持久化的 statements 以相同确定性 observationId 重放提交（已提交条目\n\t// 去重跳过，剩余补齐），全部落库后收口 committed 并 reportCuration。\"旧批次\n\t// 未处理时拒绝开始新批次\"由此自然成立：open 批次永远优先重放，两批各自不\n\t// 完整的原子不可能并存；全部幂等跳过（实际早已提交完）也走完收口。重放不\n\t// 依赖策略能力——journal 不依赖策略，策略缺席不阻塞恢复。\n\tconst openBatch = await readOpenCurationBatch(journalPath, sessionId, logger);\n\tif (openBatch !== undefined) {\n\t\tconst accepted: AcceptedCurationProposalV1[] = openBatch.statements.map((item) => ({\n\t\t\tstatement: item.statement,\n\t\t\tfacets: item.facets.map((facet) => ({ key: facet.key, value: facet.value })),\n\t\t}));\n\t\tconst { committed, duplicates } = commitBatchAtoms(deps, accepted, openBatch.batchId);\n\t\tawait appendCommittedJournalLine(journalPath, openBatch.batchId, sessionId, deps.now);\n\t\tlogger?.info(\n\t\t\t`memory curation replayed open batch ${openBatch.batchId} for session ${sessionId}: ${committed} committed, ${duplicates} already present`,\n\t\t);\n\t\tawait sessionArchive.reportCuration(sessionId, \"curated\", { batchId: openBatch.batchId });\n\t\treturn { status: \"curated\", batchId: openBatch.batchId, committed, duplicates };\n\t}\n\n\t// 策略 require（optional 消费模式，coding-tools requireCoordination 先例）：\n\t// 未装策略 = 整理不可用，会话按 skipped 回写（宿主确认框须明示未经整理）。\n\tlet policyHandle: CapabilityHandle<unknown>;\n\ttry {\n\t\tpolicyHandle = api.capabilities.require(MEMORY_CURATION_POLICY_CAPABILITY_ID, {\n\t\t\tversion: MEMORY_CURATION_POLICY_VERSION,\n\t\t});\n\t} catch {\n\t\tawait sessionArchive.reportCuration(sessionId, \"skipped\");\n\t\treturn { status: \"skipped\", reason: \"policy-missing\" };\n\t}\n\n\t// 有界分页读（整理器读归档会话的唯一公共路径）：每片 ≤200 条，最多 20 片，\n\t// 超出截断并在 existingStatements 摘要里说明。\n\tconst slices: (readonly SessionEntryView[])[] = [];\n\tlet offset: number | undefined;\n\tfor (let slice = 0; slice < CURATION_MAX_SLICES; slice += 1) {\n\t\tconst chunk = await sessionArchive.readEntries(sessionId, {\n\t\t\toffset,\n\t\t\tlimit: CURATION_SLICE_MAX_ENTRIES,\n\t\t});\n\t\tif (chunk.entries.length > 0) slices.push(chunk.entries);\n\t\toffset = chunk.nextOffset;\n\t\tif (offset === undefined) break;\n\t}\n\tconst truncated = offset !== undefined;\n\n\t// 既有 statement 摘要（当前 store 实例内，owner 边界；≤100 条，前 200 字符）。\n\tconst existingSet = new Set<string>();\n\tfor (const record of store.list({ owner })) {\n\t\tif (existingSet.size >= CURATION_EXISTING_STATEMENTS_LIMIT) break;\n\t\texistingSet.add(statementTextOf(record.atom.payload).slice(0, CURATION_EXISTING_STATEMENT_PREFIX_CHARS));\n\t}\n\tconst existingStatements = [...existingSet];\n\tif (truncated) {\n\t\texistingStatements.push(\n\t\t\t`[session input truncated after ${CURATION_MAX_SLICES} slices (${CURATION_MAX_SLICES * CURATION_SLICE_MAX_ENTRIES} entries); entries beyond this bound were not read]`,\n\t\t);\n\t}\n\n\t// 策略调用（逐片，§5.4 单次模型调用输入有界）：每片一次 propose、顺序执行；\n\t// 任一片失败/超时/中止 → 整批暂停（不写 curated、不留部分提交；curation 维度\n\t// 保持缺失，重投或 sweep 自然续跑）。call 本身同步抛错（宿主分派失败/handler\n\t// 同步 throw）与 result 的 rejection 同语义。\n\tconst accepted: AcceptedCurationProposalV1[] = [];\n\tfor (const [sliceIndex, slice] of slices.entries()) {\n\t\tlet callOutcome:\n\t\t\t| { ok: true; value: unknown }\n\t\t\t| { ok: false; reason: \"policy-timeout\" | \"aborted\" | \"policy-error\"; error: unknown };\n\t\ttry {\n\t\t\tcallOutcome = await awaitPolicyResult(\n\t\t\t\tpolicyHandle.call({\n\t\t\t\t\top: \"propose\",\n\t\t\t\t\tsessionId,\n\t\t\t\t\tslices: [slice],\n\t\t\t\t\texistingStatements,\n\t\t\t\t} satisfies CurationPolicyProposeInputV1),\n\t\t\t\tapi.sessionAbortSignal?.(),\n\t\t\t);\n\t\t} catch (error) {\n\t\t\tcallOutcome = { ok: false, reason: \"policy-error\", error };\n\t\t}\n\t\tif (!callOutcome.ok) {\n\t\t\tlogger?.warn(\n\t\t\t\t`memory curation paused for session ${sessionId} (${callOutcome.reason}) at slice ${sliceIndex + 1}/${slices.length}: ${boundedErrorText(callOutcome.error)}`,\n\t\t\t);\n\t\t\treturn { status: \"paused\", reason: callOutcome.reason };\n\t\t}\n\t\tconst validated = validateProposals(callOutcome.value, logger);\n\t\tif (validated === undefined) {\n\t\t\tlogger?.warn(\n\t\t\t\t`memory curation paused for session ${sessionId}: policy returned a malformed propose result at slice ${sliceIndex + 1}/${slices.length}`,\n\t\t\t);\n\t\t\treturn { status: \"paused\", reason: \"invalid-result\" };\n\t\t}\n\t\taccepted.push(...validated.accepted);\n\t}\n\t// 批次条数上限（§7.2 提交闸门）跨片生效：单批上限不变，超出部分丢弃并 warn。\n\tif (accepted.length > CURATION_MAX_PROPOSALS) {\n\t\tconst dropped = accepted.length - CURATION_MAX_PROPOSALS;\n\t\taccepted.splice(CURATION_MAX_PROPOSALS);\n\t\tlogger?.warn(\n\t\t\t`memory curation dropped ${dropped} proposal(s) beyond the batch limit of ${CURATION_MAX_PROPOSALS}`,\n\t\t);\n\t}\n\n\t// 批次凭据：batchId = sha256(sessionId + 各 statement digest 拼接)；完整结果\n\t// 先落 journal（可恢复的事实来源，不含会话原文），再逐条提交。\n\tconst digests = accepted.map((proposal) => curationStatementDigest(proposal.statement));\n\tconst batchId = curationBatchIdOf(sessionId, digests);\n\tconst journalEntry: CurationJournalOpenEntryV1 = {\n\t\tbatchId,\n\t\tsessionId,\n\t\tat: new Date(deps.now()).toISOString(),\n\t\tstatus: \"open\",\n\t\tstatements: accepted.map((proposal) => ({ statement: proposal.statement, facets: proposal.facets })),\n\t\tdigests,\n\t};\n\tawait mkdir(join(deps.agentDir, \"archive\", \"sessions\"), { recursive: true });\n\tawait appendFile(journalPath, `${JSON.stringify(journalEntry)}\\n`, \"utf8\");\n\n\t// 逐条提交（§5.3 崩溃重试语义的提交侧），完成后追加 committed 事实行收口，\n\t// 再回写 curated——重试读到 committed 即不再重放该批次。\n\tconst { committed, duplicates } = commitBatchAtoms(deps, accepted, batchId);\n\tawait appendCommittedJournalLine(journalPath, batchId, sessionId, deps.now);\n\tawait sessionArchive.reportCuration(sessionId, \"curated\", { batchId });\n\treturn { status: \"curated\", batchId, committed, duplicates };\n}\n\n/**\n * 装配归档整理器（记忆归档与整理设计 §5-§7）：\n * - 启动 sweep：`sessionArchive.listArchived()` 找 curation 缺失的会话逐个整理；\n * - `session.archived@1` 事件观察：归档即后台整理（handler 同步返回，整理在\n *   后台跑，不阻塞事件投递）。\n * 同一会话的整理经每会话一条 promise 链串行（sweep 与事件重投并发时天然去重）。\n * 归档面缺席（testkit/老宿主）时两个触发都不注册，返回空注册列表。\n */\nexport function createMemoryCurator(deps: MemoryCuratorDepsV1): MemoryCuratorV1 {\n\tconst { api, sessionArchive } = deps;\n\tconst logger = api.logger;\n\tif (sessionArchive === undefined) return { registrations: [] };\n\n\tconst chains = new Map<string, Promise<MemoryCurationRunResultV1>>();\n\tconst enqueue = (sessionId: string): void => {\n\t\t// 每会话一条链: 前一链的失败不阻断后续 (catch 抹平), 同会话并发触发\n\t\t// (事件重投 + sweep) 在链上串行, 不会并发跑批。\n\t\tconst last = chains.get(sessionId) ?? Promise.resolve();\n\t\tconst next = last.catch(() => undefined).then(() => curateSession(deps, sessionId));\n\t\tchains.set(sessionId, next);\n\t\tvoid next.catch((error) => {\n\t\t\tlogger?.warn(`memory curation failed for session ${sessionId}: ${boundedErrorText(error)}`);\n\t\t});\n\t\t// 链落定后摘除表项 (守卫: 已被更新的链接手时不删)。catch 抹平后的\n\t\t// finally 臂自身不会 reject, 无 unhandled rejection。\n\t\tvoid next\n\t\t\t.catch(() => undefined)\n\t\t\t.finally(() => {\n\t\t\t\tif (chains.get(sessionId) === next) chains.delete(sessionId);\n\t\t\t});\n\t};\n\n\t// 启动 sweep：后台串行补齐历史归档会话的整理（curation 维度已有结论的跳过）。\n\tconst sweep = async (): Promise<void> => {\n\t\ttry {\n\t\t\tconst archived = await sessionArchive.listArchived();\n\t\t\tfor (const item of archived) {\n\t\t\t\tif (item.curation !== undefined) continue;\n\t\t\t\tenqueue(item.sessionId);\n\t\t\t}\n\t\t} catch (error) {\n\t\t\tlogger?.warn(`memory curation startup sweep failed: ${boundedErrorText(error)}`);\n\t\t}\n\t};\n\tvoid sweep();\n\n\tconst registrations: DisposableRegistration[] = [];\n\t// lifecycle 在 CapabilityAPI 类型上是必选成员（experimental），最小宿主可以\n\t// 不带该面；事件触发缺席时启动 sweep 仍可用，与 hooks 同款降级。\n\tif (api.lifecycle !== undefined) {\n\t\tregistrations.push(\n\t\t\tapi.lifecycle.registerObserve<MemorySessionArchivedEventDataV1>(SESSION_ARCHIVED_EVENT_REFERENCE, (event) => {\n\t\t\t\tenqueue(event.data.sessionId);\n\t\t\t}),\n\t\t);\n\t} else {\n\t\tlogger?.warn(\"memory curator: host exposes no lifecycle face; session.archived trigger is unavailable\");\n\t}\n\treturn { registrations };\n}\n"]}

package/dist/memory/enabling.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"enabling.d.ts","sourceRoot":"","sources":["../../src/memory/enabling.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAMH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,yBAAyB,CAAC;AAG5D,4FAA+D;AAC/D,eAAO,MAAM,uBAAuB,EAAE,QAAQ,CAAC,MAAM,CAAC,OAAO,CAAC,YAAY,EAAE,KAAK,CAAC,EAAE,MAAM,CAAC,CAG1F,CAAC;AACF;;;;GAIG;AACH,eAAO,MAAM,sBAAsB,EAAE,QAAQ,CAAC,MAAM,CAAC,OAAO,CAAC,YAAY,EAAE,KAAK,CAAC,EAAE,MAAM,CAAC,CAGzF,CAAC;AACF,eAAO,MAAM,yBAAyB,QAAmB,CAAC;AAI1D,+GAA0D;AAC1D,UAAU,oBAAoB;IAC7B,QAAQ,CAAC,gBAAgB,EAAE,MAAM,CAAC;IAClC,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,0GAAoD;IACpD,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;CAC7B;AAED,eAAO,MAAM,mBAAmB,EAAE,oBAIjC,CAAC;AACF,eAAO,MAAM,kBAAkB,EAAE,oBAIhC,CAAC;AAIF,wFAA0C;AAC1C,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,OAAO,CAAC,YAAY,EAAE,KAAK,CAAC,GAAG,oBAAoB,CAE5F;AAED;;;;GAIG;AACH,wBAAgB,+BAA+B,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,CAGxE;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,sBAAsB,IAAI,SAAS,MAAM,EAAE,CAO1D;AAsBD,wBAAgB,iBAAiB,CAAC,aAAa,CAAC,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAkC5E;AAED;;;;GAIG;AACH,wBAAgB,+BAA+B,CAAC,SAAS,EAAE,MAAM,GAAG,MAAM,CASzE;AAED;;;;;;;GAOG;AACH,wBAAgB,6BAA6B,CAC5C,OAAO,EAAE;IAAE,OAAO,CAAC,EAAE,MAAM,CAAC;IAAC,YAAY,CAAC,EAAE,MAAM,CAAA;CAAE,EACpD,aAAa,EAAE,CAAC,SAAS,EAAE,MAAM,KAAK,MAAM,GAC1C,MAAM,EAAE,CAeV;AAED;;;;;;GAMG;AACH,wBAAgB,eAAe,CAAC,QAAQ,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,cAAc,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAoB7G;AAED;;;;;;GAMG;AACH,wBAAsB,iBAAiB,CAAC,QAAQ,EAAE,MAAM,EAAE,YAAY,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,GAAG,SAAS,CAAC,CAyB3G;AAED,6EAA0C;AAC1C,wBAAgB,kBAAkB,CAAC,aAAa,EAAE,MAAM,EAAE,WAAW,EAAE,YAAY,GAAG,SAAS,MAAM,EAAE,CAUtG;AAQD,+EAAiD;AACjD,eAAO,MAAM,6BAA6B,aAAa,CAAC;AACxD,yFAA6D;AAC7D,eAAO,MAAM,qCAAqC,QAA8C,CAAC;AAgCjG,0FAAoD;AACpD,wBAAgB,sBAAsB,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,GAAG,MAAM,GAAG,SAAS,CAGrF;AAED;;;;;;GAMG;AACH,wBAAgB,0BAA0B,CAAC,QAAQ,EAAE,MAAM,GAAG,IAAI,CAMjE;AAED;;;;;;GAMG;AACH,wBAAgB,uBAAuB,CAAC,QAAQ,EAAE,MAAM,EAAE,IAAI,EAAE,OAAO,GAAG,MAAM,GAAG,IAAI,CAKtF","sourcesContent":["/**\n * enabling 前置检查、档位预设与镜像源（capability 拆分战役 slice 1）：纯函数,\n * 无闭包依赖。\n */\n\nimport { existsSync, mkdirSync, readdirSync, readFileSync, renameSync, statSync, writeFileSync } from \"node:fs\";\nimport { statfs } from \"node:fs/promises\";\nimport { createRequire } from \"node:module\";\nimport { dirname, join, resolve } from \"node:path\";\nimport type { MemoryModeV1 } from \"@agent-forge/plugin-sdk\";\nimport { purgeZeroByteCacheArtifacts } from \"./model-cache-hygiene.ts\";\n\n/** 开启前磁盘余量下限 (设计 §3.2 checking): light ≥ 500MB, full ≥ 2GB。 */\nexport const DISK_HEADROOM_MIN_BYTES: Readonly<Record<Exclude<MemoryModeV1, \"off\">, number>> = {\n\tlight: 500 * 1024 * 1024,\n\tfull: 2 * 1024 * 1024 * 1024,\n};\n/**\n * 模型文件大小下限 (防截断/空文件的 sanity 下限, 非精确体积): 高档 embedding\n * (bge-m3 q8) 数百 MB → 下限 256MB, 精排器 (bge-reranker-base q8) ~280MB →\n * 下限 64MB, 低档 (bge-small-zh q8) ~24MB → 下限 8MB。真实校验由加载冒烟承担。\n */\nexport const MODEL_MIN_WEIGHT_BYTES: Readonly<Record<Exclude<MemoryModeV1, \"off\">, number>> = {\n\tlight: 8 * 1024 * 1024,\n\tfull: 256 * 1024 * 1024,\n};\nexport const RERANKER_MIN_WEIGHT_BYTES = 64 * 1024 * 1024;\n/** 自定义镜像源环境变量 (失败行动清单第一项指向它)。 */\nconst HF_MIRRORS_ENV = \"AGENT_FORGE_HF_MIRRORS\";\n\n/** 两档预设 (实施计划 §2): light = 纯中文强项低配档, full = 跨语言大规模默认档。 */\ninterface MemoryVectorPresetV1 {\n\treadonly embeddingModelId: string;\n\treadonly dimensions: number;\n\t/** 查询侧指令前缀 (bge-small-zh 系查询侧指令由调用方负责添加; 写入侧不加)。 */\n\treadonly queryPrefix: string;\n}\n\nexport const VECTOR_PRESET_LIGHT: MemoryVectorPresetV1 = {\n\tembeddingModelId: \"Xenova/bge-small-zh-v1.5\",\n\tdimensions: 512,\n\tqueryPrefix: \"为这个句子生成表示以用于检索相关文章：\",\n};\nexport const VECTOR_PRESET_FULL: MemoryVectorPresetV1 = {\n\tembeddingModelId: \"Xenova/bge-m3\",\n\tdimensions: 1024,\n\tqueryPrefix: \"\",\n};\n/** 镜像序列 (实施计划 §7): 直连 huggingface.co 超时时回落 hf-mirror.com。 */\nconst VECTOR_REMOTE_HOSTS: readonly string[] = [\"https://huggingface.co\", \"https://hf-mirror.com\"];\n\n/** 档位预设: mode → 模型组合。off 在进入装配前已被门控拦截。 */\nexport function vectorPresetForMode(mode: Exclude<MemoryModeV1, \"off\">): MemoryVectorPresetV1 {\n\treturn mode === \"light\" ? VECTOR_PRESET_LIGHT : VECTOR_PRESET_FULL;\n}\n\n/**\n * agentDir 身份归一化 (2026-10-06 串线修复): 绝对路径解析抹平分隔符与相对段,\n * win32 再 casefold —— 同一目录在 Windows 下的大小写差异 (盘符/路径段) 不得\n * 误判为跨 agent-dir 串线。仅用于身份比对, 不触碰文件系统语义。\n */\nexport function normalizeMemoryAgentDirIdentity(agentDir: string): string {\n\tconst resolvedPath = resolve(agentDir);\n\treturn process.platform === \"win32\" ? resolvedPath.toLowerCase() : resolvedPath;\n}\n\n/**\n * 自定义镜像源 (失败行动清单第一项指向它): env `AGENT_FORGE_HF_MIRRORS` 逗号\n * 分隔 host 列表, 排在默认镜像序列之前优先尝试; 默认序列直连 huggingface.co\n * 超时时回落 hf-mirror.com。\n *\n * env 条目归一化 (2026-10-06 live E2E 修复): 裸主机名补 `https://` — 用户\n * 按行动清单写 `AGENT_FORGE_HF_MIRRORS=hf-mirror.com` 时, 无 scheme 的\n * remoteHost 会让 transformers 的文件请求按相对 URL 解析并在模块内留下\n * 毒化状态, 连后续带 scheme 的镜像重试也崩; 行动清单推荐的自救手段本身\n * 不能是断的。已带 scheme 的条目原样保留, 尾部 `/` 去除。\n */\nexport function remoteHostsForEnabling(): readonly string[] {\n\tconst custom = process.env[HF_MIRRORS_ENV]\n\t\t?.split(\",\")\n\t\t.map((host) => host.trim().replace(/\\/+$/, \"\"))\n\t\t.map((host) => (host === \"\" || host.includes(\"://\") ? host : `https://${host}`))\n\t\t.filter((host) => host !== \"\");\n\treturn custom === undefined || custom.length === 0 ? VECTOR_REMOTE_HOSTS : [...custom, ...VECTOR_REMOTE_HOSTS];\n}\n\n/**\n * 本地检查 1: native .node sidecar 可解析 (设计 §3.2 checking)。布局:\n * onnxruntime-node/bin 下的 napi-vN/<platform>/<arch> 原生模块 — 缺失 = 安装\n * 损坏。容错: 不钉死 napi 版本号, 逐目录扫描。\n *\n * 解析基点双通道: jiti（安装店加载缝）注入的 `require` 走宿主 alias 表\n * （宿主 node_modules 副本, 店内无依赖树）; 纯 ESM（源码/工作区直载）下裸\n * `require` 未定义（typeof 探测不抛 ReferenceError）, 回落原生 createRequire。\n */\nfunction resolveOnnxRuntimeEntryPath(): string {\n\tif (typeof require === \"function\") {\n\t\ttry {\n\t\t\treturn require.resolve(\"onnxruntime-node\");\n\t\t} catch {\n\t\t\t// jiti 解析失败（alias 未覆盖等）→ 继续走原生解析再报结构化错误。\n\t\t}\n\t}\n\treturn createRequire(import.meta.url).resolve(\"onnxruntime-node\");\n}\n\nexport function nativeBinaryCheck(hostEntryPath?: string): string | undefined {\n\t// 两种失败要区分 (D-075 安装店路径修复后前者成为真实可达路径):\n\t// (a) 宿主未注入入口路径且插件位置自解析不到 — 不是安装损坏, 行动是宿主侧\n\t//     安装重依赖后重启会话, 不是重装插件;\n\t// (b) 路径存在但原生二进制缺失/损坏 — 保留损坏类文案。\n\tlet entryPath: string;\n\tif (hostEntryPath === undefined) {\n\t\ttry {\n\t\t\tentryPath = resolveOnnxRuntimeEntryPath();\n\t\t} catch (error) {\n\t\t\tconst detail = error instanceof Error ? error.message : String(error);\n\t\t\treturn `onnxruntime-node is not provided by the host installation and could not be resolved from the plugin location (${detail}); to enable memory features, install onnxruntime-node in the host project (npm i onnxruntime-node) and restart the session`;\n\t\t}\n\t} else {\n\t\tentryPath = hostEntryPath;\n\t}\n\ttry {\n\t\tlet packageDir = dirname(entryPath);\n\t\twhile (packageDir !== dirname(packageDir) && !existsSync(join(packageDir, \"package.json\"))) {\n\t\t\tpackageDir = dirname(packageDir);\n\t\t}\n\t\tconst binDir = join(packageDir, \"bin\");\n\t\tif (!existsSync(binDir)) return `onnxruntime native binary directory not found: ${binDir}`;\n\t\tfor (const napiEntry of readdirSync(binDir, { withFileTypes: true })) {\n\t\t\tif (!napiEntry.isDirectory() || !napiEntry.name.startsWith(\"napi-v\")) continue;\n\t\t\tconst platformDir = join(binDir, napiEntry.name, process.platform, process.arch);\n\t\t\tif (!existsSync(platformDir)) continue;\n\t\t\tconst binaries = readdirSync(platformDir).filter((file) => file.endsWith(\".node\"));\n\t\t\tif (binaries.length > 0) return undefined;\n\t\t}\n\t\treturn `onnxruntime native binary for ${process.platform}/${process.arch} not found under ${binDir}`;\n\t} catch (error) {\n\t\treturn `onnxruntime native binary could not be resolved (${error instanceof Error ? error.message : String(error)}); the installation looks damaged — reinstall the package`;\n\t}\n}\n\n/**\n * 重依赖自解析默认实现 (missingHeavyDependencyModules 生产接线): 双通道与\n * {@link resolveOnnxRuntimeEntryPath} 一致 — jiti（安装店加载缝）注入的\n * `require` 走宿主 alias 表; 纯 ESM（源码/工作区直载）下回落原生 createRequire。\n */\nexport function resolveHeavyDependencyEntryPath(specifier: string): string {\n\tif (typeof require === \"function\") {\n\t\ttry {\n\t\t\treturn require.resolve(specifier);\n\t\t} catch {\n\t\t\t// jiti 解析失败（alias 未覆盖等）→ 继续走原生解析。\n\t\t}\n\t}\n\treturn createRequire(import.meta.url).resolve(specifier);\n}\n\n/**\n * 本地检查 1b: 重依赖供给 (设计 §3.2 checking)。`@lancedb/lancedb` 与\n * `@huggingface/transformers` 逐个判定 — entries 提供宿主入口路径 = 可用\n * (不触自解析); 未提供时 resolveModule 自解析成功 = 可用, 抛错 = 计入缺失。\n * 返回缺失 specifier 列表 (空 = 通过)。纯函数零 IO; 导出仅供测试 (与宿主侧\n * buildHostDependencyAliases 同一模式), 生产接线传插件位置自解析 — 把加载步\n * 的 \"Cannot find module\" 泛化包装前置成精准缺供文案, 省掉模型下载等前置工作。\n */\nexport function missingHeavyDependencyModules(\n\tentries: { lancedb?: string; transformers?: string },\n\tresolveModule: (specifier: string) => string,\n): string[] {\n\tconst missing: string[] = [];\n\tconst supplies: readonly (readonly [specifier: string, entryPath: string | undefined])[] = [\n\t\t[\"@lancedb/lancedb\", entries.lancedb],\n\t\t[\"@huggingface/transformers\", entries.transformers],\n\t];\n\tfor (const [specifier, entryPath] of supplies) {\n\t\tif (entryPath !== undefined) continue;\n\t\ttry {\n\t\t\tresolveModule(specifier);\n\t\t} catch {\n\t\t\tmissing.push(specifier);\n\t\t}\n\t}\n\treturn missing;\n}\n\n/**\n * transformers.js 缓存布局的容错存在性检查 (设计 §3.2 手动导入路径):\n * `<cacheDir>/<modelId>/` 下需有非空 tokenizer 文件与 `onnx/` 权重文件。\n * 返回 undefined = 检查通过; \"missing\" = 目录/文件缺失或仅剩 0 字节残骸\n * (失败下载产物, 清理后进入下载阶段, 见 model-cache-hygiene); 其他字符串 =\n * 文件存在但可疑 (截断/非空过小), 属失败。\n */\nexport function modelFilesCheck(cacheDir: string, modelId: string, minWeightBytes: number): string | undefined {\n\tconst modelDir = join(cacheDir, modelId);\n\tif (!existsSync(modelDir)) return \"missing\";\n\t// tokenizer 只剩 0 字节文件 = 失败下载残骸 (真 tokenizer.json 不可能为空):\n\t// 清掉按缺失处理可重下; 非空文件不动 (手动导入布局不受影响)。\n\tconst tokenizerNames = [\"tokenizer.json\", \"tokenizer.model\"].filter((name) => existsSync(join(modelDir, name)));\n\tconst hasTokenizer = tokenizerNames.some((name) => statSync(join(modelDir, name)).size > 0);\n\tif (!hasTokenizer) {\n\t\tif (tokenizerNames.length > 0) purgeZeroByteCacheArtifacts(modelDir);\n\t\treturn \"missing\";\n\t}\n\tconst onnxDir = join(modelDir, \"onnx\");\n\tif (!existsSync(onnxDir)) return `onnx weight directory missing under ${modelDir}`;\n\tconst weights = readdirSync(onnxDir).filter((name) => name.includes(\".onnx\"));\n\tif (weights.length === 0) return `no onnx weight file under ${onnxDir}`;\n\tconst largest = Math.max(...weights.map((name) => statSync(join(onnxDir, name)).size));\n\tif (largest < minWeightBytes) {\n\t\treturn `largest onnx weight under ${onnxDir} is ${largest} bytes, below the expected minimum ${minWeightBytes} — the download looks truncated`;\n\t}\n\treturn undefined;\n}\n\n/**\n * 本地检查 3: 磁盘余量 (设计 §3.2 checking, node:fs statfs, 零新依赖)。\n * 以 agentDir 所在卷为准 (cacheDir 同卷创建)。agentDir 可能尚不存在 (全新\n * 机器首启, 下载前无人创建过它 — 2026-10-06 live E2E 实测踩中) — statfs\n * ENOENT 时逐级上溯最近存在的祖先目录, 同卷即同余量; 上溯到根仍失败才按\n * 无法判定报告。\n */\nexport async function diskHeadroomCheck(agentDir: string, minimumBytes: number): Promise<string | undefined> {\n\tlet freeBytes: number | undefined;\n\tlet probe: string | undefined = agentDir;\n\tfor (let attempt = 0; probe !== undefined && attempt < 16; attempt++) {\n\t\ttry {\n\t\t\tconst stats = await statfs(probe);\n\t\t\tfreeBytes = stats.bfree * stats.bsize;\n\t\t\tbreak;\n\t\t} catch (error) {\n\t\t\tif (!(error instanceof Error) || !String(error.message).includes(\"ENOENT\")) {\n\t\t\t\treturn `disk free space could not be determined for ${agentDir} (probing ${probe}: ${\n\t\t\t\t\terror instanceof Error ? error.message : String(error)\n\t\t\t\t})`;\n\t\t\t}\n\t\t\tconst parent = dirname(probe);\n\t\t\tprobe = parent === probe ? undefined : parent;\n\t\t}\n\t}\n\tif (freeBytes === undefined) {\n\t\treturn `disk free space could not be determined for ${agentDir} (no existing ancestor directory to statfs)`;\n\t}\n\tif (freeBytes < minimumBytes) {\n\t\treturn `disk free space is ${freeBytes} bytes, below the required ${minimumBytes}`;\n\t}\n\treturn undefined;\n}\n\n/** enabling 失败的五选一行动清单 (设计 §3.2 硬性要求)。 */\nexport function enablingActionList(modelCacheDir: string, currentMode: MemoryModeV1): readonly string[] {\n\treturn [\n\t\t`Switch to a reachable mirror: set ${HF_MIRRORS_ENV} to a comma-separated host list (tried before the defaults)`,\n\t\t`Install the heavy dependencies in the host project (npm i onnxruntime-node @lancedb/lancedb @huggingface/transformers) so the host can supply them via hostDependencyPaths, then restart the session`,\n\t\t`Download the models manually and place them under ${modelCacheDir} (layout: <modelId>/tokenizer.json + <modelId>/onnx/model*.onnx)`,\n\t\tcurrentMode === \"full\"\n\t\t\t? 'Downgrade to memory.mode \"light\" (much smaller models)'\n\t\t\t: 'Keep memory.mode \"light\" and retry with a reachable mirror',\n\t\t'Give up: leave memory.mode \"off\" (the default) so the memory family stays unregistered',\n\t];\n}\n\n// ---------------------------------------------------------------------------\n// 征询持久化 (capability 拆分战役 slice 3b 随迁, 征询域): agent-dir 配置文件\n// 的读写与征询拒绝/档位落盘。纯函数, 路径域显式传入; capability.ts 经\n// re-export 维持历史导出面, 向量通道 (vector-channel.ts) 直接 import。\n// ---------------------------------------------------------------------------\n\n/** agent-dir 配置文件里的征询拒绝标记值 (memoryConsent 键)。 */\nexport const MEMORY_CONSENT_DECLINED_VALUE = \"declined\";\n/** memory 插件 agent-dir 配置通道 (entry 读、capability 写, 同一路径)。 */\nexport const MEMORY_AGENT_DIR_CONFIG_RELATIVE_PATH = join(\"capabilities\", \"builtin.memory.json\");\n\nfunction readMemoryAgentDirConfig(agentDir: string): Record<string, unknown> {\n\tconst configPath = join(agentDir, MEMORY_AGENT_DIR_CONFIG_RELATIVE_PATH);\n\tif (existsSync(configPath)) {\n\t\ttry {\n\t\t\tconst parsed: unknown = JSON.parse(readFileSync(configPath, \"utf8\"));\n\t\t\tif (parsed !== null && typeof parsed === \"object\" && !Array.isArray(parsed)) {\n\t\t\t\treturn parsed as Record<string, unknown>;\n\t\t\t}\n\t\t} catch {\n\t\t\t// 既有文件非法时以本次写入为准 (持久化是显式用户动作, 不被脏文件阻塞)。\n\t\t}\n\t}\n\treturn {};\n}\n\n/**\n * 写 agent-dir 配置的原子替换 (2026-10-06 复审 P1-2): temp 文件 + rename —\n * 自动升档引入了无人值守写者, 与其它进程的 /memory off (会删档位键) 读改写\n * 交错时, 直接 writeFileSync 可能留下半截 JSON 让并发读者拿到空配置 (整块\n * 丢键: 抹掉并发 decline 或升档)。rename 在同一目录内原子替换, 读者要么见\n * 旧文件要么见新文件。\n */\nfunction writeMemoryAgentDirConfig(agentDir: string, config: Record<string, unknown>): void {\n\tconst configPath = join(agentDir, MEMORY_AGENT_DIR_CONFIG_RELATIVE_PATH);\n\tmkdirSync(dirname(configPath), { recursive: true });\n\tconst tempPath = `${configPath}.${process.pid}.tmp`;\n\twriteFileSync(tempPath, `${JSON.stringify(config, null, \"\\t\")}\\n`, \"utf8\");\n\trenameSync(tempPath, configPath);\n}\n\n/** agent-dir 配置里用户显式持久化的档位键 (无 / 该键即 undefined)。 */\nexport function readMemorySettingsMode(agentDir: string): \"light\" | \"full\" | undefined {\n\tconst value = readMemoryAgentDirConfig(agentDir).memorySettingsMode;\n\treturn value === \"light\" || value === \"full\" ? value : undefined;\n}\n\n/**\n * 拒绝/跳过的持久化 (2026-10-05 用户裁决): 写入插件自己的 agent-dir 配置文件,\n * 不改写用户 settings.json。语义是「用户对默认档说了不」——仅抑制默认档;\n * 用户日后显式设置 settings.json `memory.mode` (light/full) 时显式值仍然生效。\n * 同时移除 /memory light|full 持久化的档位键, 保证\"先升 full 再 off\"不会留下\n * 一个压过 settings 的陈旧档位。\n */\nexport function writeMemoryConsentDeclined(agentDir: string): void {\n\tconst config = readMemoryAgentDirConfig(agentDir);\n\tconfig.memoryConsent = MEMORY_CONSENT_DECLINED_VALUE;\n\tdelete config.memorySettingsMode;\n\tdelete config.memoryMode;\n\twriteMemoryAgentDirConfig(agentDir, config);\n}\n\n/**\n * 档位升级/降级的持久化 (/memory light|full): 写入插件 agent-dir 配置的\n * `memorySettingsMode` 键——与 settings.json `memory.mode` 同一解析层 (持久\n * 配置面, env 仍可临时覆盖)。插件无 settings.json 写通道 (HostCapabilities\n * 无该面), 本文件键在其上, 即命令是比 settings 更近一次的显式表达。同时清\n * 除拒绝标记: 显式升/降档是最新的用户意图, 压过此前的\"对默认档说不\"。\n */\nexport function writeMemorySettingsMode(agentDir: string, mode: \"light\" | \"full\"): void {\n\tconst config = readMemoryAgentDirConfig(agentDir);\n\tconfig.memorySettingsMode = mode;\n\tdelete config.memoryConsent;\n\twriteMemoryAgentDirConfig(agentDir, config);\n}\n"]}
+{"version":3,"file":"enabling.d.ts","sourceRoot":"","sources":["../../src/memory/enabling.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAMH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,yBAAyB,CAAC;AAG5D,4FAA+D;AAC/D,eAAO,MAAM,uBAAuB,EAAE,QAAQ,CAAC,MAAM,CAAC,OAAO,CAAC,YAAY,EAAE,KAAK,CAAC,EAAE,MAAM,CAAC,CAG1F,CAAC;AACF;;;;GAIG;AACH,eAAO,MAAM,sBAAsB,EAAE,QAAQ,CAAC,MAAM,CAAC,OAAO,CAAC,YAAY,EAAE,KAAK,CAAC,EAAE,MAAM,CAAC,CAGzF,CAAC;AACF,eAAO,MAAM,yBAAyB,QAAmB,CAAC;AAI1D,+GAA0D;AAC1D,UAAU,oBAAoB;IAC7B,QAAQ,CAAC,gBAAgB,EAAE,MAAM,CAAC;IAClC,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,0GAAoD;IACpD,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;CAC7B;AAED,eAAO,MAAM,mBAAmB,EAAE,oBAIjC,CAAC;AACF,eAAO,MAAM,kBAAkB,EAAE,oBAIhC,CAAC;AAIF,wFAA0C;AAC1C,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,OAAO,CAAC,YAAY,EAAE,KAAK,CAAC,GAAG,oBAAoB,CAE5F;AAED;;;;GAIG;AACH,wBAAgB,+BAA+B,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,CAGxE;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,sBAAsB,IAAI,SAAS,MAAM,EAAE,CAO1D;AAsBD,wBAAgB,iBAAiB,CAAC,aAAa,CAAC,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAwC5E;AAED;;;;GAIG;AACH,wBAAgB,+BAA+B,CAAC,SAAS,EAAE,MAAM,GAAG,MAAM,CASzE;AAED;;;;;;;GAOG;AACH,wBAAgB,6BAA6B,CAC5C,OAAO,EAAE;IAAE,OAAO,CAAC,EAAE,MAAM,CAAC;IAAC,YAAY,CAAC,EAAE,MAAM,CAAA;CAAE,EACpD,aAAa,EAAE,CAAC,SAAS,EAAE,MAAM,KAAK,MAAM,GAC1C,MAAM,EAAE,CAeV;AAED;;;;;;GAMG;AACH,wBAAgB,eAAe,CAAC,QAAQ,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,cAAc,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAoB7G;AAED;;;;;;GAMG;AACH,wBAAsB,iBAAiB,CAAC,QAAQ,EAAE,MAAM,EAAE,YAAY,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,GAAG,SAAS,CAAC,CAyB3G;AAED,6EAA0C;AAC1C,wBAAgB,kBAAkB,CAAC,aAAa,EAAE,MAAM,EAAE,WAAW,EAAE,YAAY,GAAG,SAAS,MAAM,EAAE,CAUtG;AAQD,+EAAiD;AACjD,eAAO,MAAM,6BAA6B,aAAa,CAAC;AACxD,yFAA6D;AAC7D,eAAO,MAAM,qCAAqC,QAA8C,CAAC;AAgCjG,0FAAoD;AACpD,wBAAgB,sBAAsB,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,GAAG,MAAM,GAAG,SAAS,CAGrF;AAED;;;;;;GAMG;AACH,wBAAgB,0BAA0B,CAAC,QAAQ,EAAE,MAAM,GAAG,IAAI,CAMjE;AAED;;;;;;GAMG;AACH,wBAAgB,uBAAuB,CAAC,QAAQ,EAAE,MAAM,EAAE,IAAI,EAAE,OAAO,GAAG,MAAM,GAAG,IAAI,CAKtF","sourcesContent":["/**\n * enabling 前置检查、档位预设与镜像源（capability 拆分战役 slice 1）：纯函数,\n * 无闭包依赖。\n */\n\nimport { existsSync, mkdirSync, readdirSync, readFileSync, renameSync, statSync, writeFileSync } from \"node:fs\";\nimport { statfs } from \"node:fs/promises\";\nimport { createRequire } from \"node:module\";\nimport { dirname, join, resolve } from \"node:path\";\nimport type { MemoryModeV1 } from \"@agent-forge/plugin-sdk\";\nimport { purgeZeroByteCacheArtifacts } from \"./model-cache-hygiene.ts\";\n\n/** 开启前磁盘余量下限 (设计 §3.2 checking): light ≥ 500MB, full ≥ 2GB。 */\nexport const DISK_HEADROOM_MIN_BYTES: Readonly<Record<Exclude<MemoryModeV1, \"off\">, number>> = {\n\tlight: 500 * 1024 * 1024,\n\tfull: 2 * 1024 * 1024 * 1024,\n};\n/**\n * 模型文件大小下限 (防截断/空文件的 sanity 下限, 非精确体积): 高档 embedding\n * (bge-m3 q8) 数百 MB → 下限 256MB, 精排器 (bge-reranker-base q8) ~280MB →\n * 下限 64MB, 低档 (bge-small-zh q8) ~24MB → 下限 8MB。真实校验由加载冒烟承担。\n */\nexport const MODEL_MIN_WEIGHT_BYTES: Readonly<Record<Exclude<MemoryModeV1, \"off\">, number>> = {\n\tlight: 8 * 1024 * 1024,\n\tfull: 256 * 1024 * 1024,\n};\nexport const RERANKER_MIN_WEIGHT_BYTES = 64 * 1024 * 1024;\n/** 自定义镜像源环境变量 (失败行动清单第一项指向它)。 */\nconst HF_MIRRORS_ENV = \"AGENT_FORGE_HF_MIRRORS\";\n\n/** 两档预设 (实施计划 §2): light = 纯中文强项低配档, full = 跨语言大规模默认档。 */\ninterface MemoryVectorPresetV1 {\n\treadonly embeddingModelId: string;\n\treadonly dimensions: number;\n\t/** 查询侧指令前缀 (bge-small-zh 系查询侧指令由调用方负责添加; 写入侧不加)。 */\n\treadonly queryPrefix: string;\n}\n\nexport const VECTOR_PRESET_LIGHT: MemoryVectorPresetV1 = {\n\tembeddingModelId: \"Xenova/bge-small-zh-v1.5\",\n\tdimensions: 512,\n\tqueryPrefix: \"为这个句子生成表示以用于检索相关文章：\",\n};\nexport const VECTOR_PRESET_FULL: MemoryVectorPresetV1 = {\n\tembeddingModelId: \"Xenova/bge-m3\",\n\tdimensions: 1024,\n\tqueryPrefix: \"\",\n};\n/** 镜像序列 (实施计划 §7): 直连 huggingface.co 超时时回落 hf-mirror.com。 */\nconst VECTOR_REMOTE_HOSTS: readonly string[] = [\"https://huggingface.co\", \"https://hf-mirror.com\"];\n\n/** 档位预设: mode → 模型组合。off 在进入装配前已被门控拦截。 */\nexport function vectorPresetForMode(mode: Exclude<MemoryModeV1, \"off\">): MemoryVectorPresetV1 {\n\treturn mode === \"light\" ? VECTOR_PRESET_LIGHT : VECTOR_PRESET_FULL;\n}\n\n/**\n * agentDir 身份归一化 (2026-10-06 串线修复): 绝对路径解析抹平分隔符与相对段,\n * win32 再 casefold —— 同一目录在 Windows 下的大小写差异 (盘符/路径段) 不得\n * 误判为跨 agent-dir 串线。仅用于身份比对, 不触碰文件系统语义。\n */\nexport function normalizeMemoryAgentDirIdentity(agentDir: string): string {\n\tconst resolvedPath = resolve(agentDir);\n\treturn process.platform === \"win32\" ? resolvedPath.toLowerCase() : resolvedPath;\n}\n\n/**\n * 自定义镜像源 (失败行动清单第一项指向它): env `AGENT_FORGE_HF_MIRRORS` 逗号\n * 分隔 host 列表, 排在默认镜像序列之前优先尝试; 默认序列直连 huggingface.co\n * 超时时回落 hf-mirror.com。\n *\n * env 条目归一化 (2026-10-06 live E2E 修复): 裸主机名补 `https://` — 用户\n * 按行动清单写 `AGENT_FORGE_HF_MIRRORS=hf-mirror.com` 时, 无 scheme 的\n * remoteHost 会让 transformers 的文件请求按相对 URL 解析并在模块内留下\n * 毒化状态, 连后续带 scheme 的镜像重试也崩; 行动清单推荐的自救手段本身\n * 不能是断的。已带 scheme 的条目原样保留, 尾部 `/` 去除。\n */\nexport function remoteHostsForEnabling(): readonly string[] {\n\tconst custom = process.env[HF_MIRRORS_ENV]\n\t\t?.split(\",\")\n\t\t.map((host) => host.trim().replace(/\\/+$/, \"\"))\n\t\t.map((host) => (host === \"\" || host.includes(\"://\") ? host : `https://${host}`))\n\t\t.filter((host) => host !== \"\");\n\treturn custom === undefined || custom.length === 0 ? VECTOR_REMOTE_HOSTS : [...custom, ...VECTOR_REMOTE_HOSTS];\n}\n\n/**\n * 本地检查 1: native .node sidecar 可解析 (设计 §3.2 checking)。布局:\n * onnxruntime-node/bin 下的 napi-vN/<platform>/<arch> 原生模块 — 缺失 = 安装\n * 损坏。容错: 不钉死 napi 版本号, 逐目录扫描。\n *\n * 解析基点双通道: jiti（安装店加载缝）注入的 `require` 走宿主 alias 表\n * （宿主 node_modules 副本, 店内无依赖树）; 纯 ESM（源码/工作区直载）下裸\n * `require` 未定义（typeof 探测不抛 ReferenceError）, 回落原生 createRequire。\n */\nfunction resolveOnnxRuntimeEntryPath(): string {\n\tif (typeof require === \"function\") {\n\t\ttry {\n\t\t\treturn require.resolve(\"onnxruntime-node\");\n\t\t} catch {\n\t\t\t// jiti 解析失败（alias 未覆盖等）→ 继续走原生解析再报结构化错误。\n\t\t}\n\t}\n\treturn createRequire(import.meta.url).resolve(\"onnxruntime-node\");\n}\n\nexport function nativeBinaryCheck(hostEntryPath?: string): string | undefined {\n\t// 两种失败要区分 (D-075 安装店路径修复后前者成为真实可达路径):\n\t// (a) 宿主未注入入口路径且插件位置自解析不到 — 不是安装损坏, 行动是宿主侧\n\t//     安装重依赖后重启会话, 不是重装插件;\n\t// (b) 路径存在但原生二进制缺失/损坏 — 保留损坏类文案。\n\tlet entryPath: string;\n\tif (hostEntryPath === undefined) {\n\t\ttry {\n\t\t\tentryPath = resolveOnnxRuntimeEntryPath();\n\t\t} catch (error) {\n\t\t\tconst detail = error instanceof Error ? error.message : String(error);\n\t\t\treturn `onnxruntime-node is not provided by the host installation and could not be resolved from the plugin location (${detail}); to enable memory features, install onnxruntime-node in the host project (npm i onnxruntime-node) and restart the session`;\n\t\t}\n\t} else {\n\t\tentryPath = hostEntryPath;\n\t}\n\ttry {\n\t\tlet packageDir = dirname(entryPath);\n\t\twhile (packageDir !== dirname(packageDir) && !existsSync(join(packageDir, \"package.json\"))) {\n\t\t\tpackageDir = dirname(packageDir);\n\t\t}\n\t\tconst binDir = join(packageDir, \"bin\");\n\t\t// 走到文件系统根仍未找到 package.json：这是损坏/伪造的安装树，不能\n\t\t// 拿根目录的 bin（POSIX 上 /bin 真实存在）继续探测，否则会把损坏误报成\n\t\t// 平台二进制缺失。\n\t\tif (!existsSync(join(packageDir, \"package.json\"))) {\n\t\t\treturn `onnxruntime native binary directory not found: ${binDir}`;\n\t\t}\n\t\tif (!existsSync(binDir)) return `onnxruntime native binary directory not found: ${binDir}`;\n\t\tfor (const napiEntry of readdirSync(binDir, { withFileTypes: true })) {\n\t\t\tif (!napiEntry.isDirectory() || !napiEntry.name.startsWith(\"napi-v\")) continue;\n\t\t\tconst platformDir = join(binDir, napiEntry.name, process.platform, process.arch);\n\t\t\tif (!existsSync(platformDir)) continue;\n\t\t\tconst binaries = readdirSync(platformDir).filter((file) => file.endsWith(\".node\"));\n\t\t\tif (binaries.length > 0) return undefined;\n\t\t}\n\t\treturn `onnxruntime native binary for ${process.platform}/${process.arch} not found under ${binDir}`;\n\t} catch (error) {\n\t\treturn `onnxruntime native binary could not be resolved (${error instanceof Error ? error.message : String(error)}); the installation looks damaged — reinstall the package`;\n\t}\n}\n\n/**\n * 重依赖自解析默认实现 (missingHeavyDependencyModules 生产接线): 双通道与\n * {@link resolveOnnxRuntimeEntryPath} 一致 — jiti（安装店加载缝）注入的\n * `require` 走宿主 alias 表; 纯 ESM（源码/工作区直载）下回落原生 createRequire。\n */\nexport function resolveHeavyDependencyEntryPath(specifier: string): string {\n\tif (typeof require === \"function\") {\n\t\ttry {\n\t\t\treturn require.resolve(specifier);\n\t\t} catch {\n\t\t\t// jiti 解析失败（alias 未覆盖等）→ 继续走原生解析。\n\t\t}\n\t}\n\treturn createRequire(import.meta.url).resolve(specifier);\n}\n\n/**\n * 本地检查 1b: 重依赖供给 (设计 §3.2 checking)。`@lancedb/lancedb` 与\n * `@huggingface/transformers` 逐个判定 — entries 提供宿主入口路径 = 可用\n * (不触自解析); 未提供时 resolveModule 自解析成功 = 可用, 抛错 = 计入缺失。\n * 返回缺失 specifier 列表 (空 = 通过)。纯函数零 IO; 导出仅供测试 (与宿主侧\n * buildHostDependencyAliases 同一模式), 生产接线传插件位置自解析 — 把加载步\n * 的 \"Cannot find module\" 泛化包装前置成精准缺供文案, 省掉模型下载等前置工作。\n */\nexport function missingHeavyDependencyModules(\n\tentries: { lancedb?: string; transformers?: string },\n\tresolveModule: (specifier: string) => string,\n): string[] {\n\tconst missing: string[] = [];\n\tconst supplies: readonly (readonly [specifier: string, entryPath: string | undefined])[] = [\n\t\t[\"@lancedb/lancedb\", entries.lancedb],\n\t\t[\"@huggingface/transformers\", entries.transformers],\n\t];\n\tfor (const [specifier, entryPath] of supplies) {\n\t\tif (entryPath !== undefined) continue;\n\t\ttry {\n\t\t\tresolveModule(specifier);\n\t\t} catch {\n\t\t\tmissing.push(specifier);\n\t\t}\n\t}\n\treturn missing;\n}\n\n/**\n * transformers.js 缓存布局的容错存在性检查 (设计 §3.2 手动导入路径):\n * `<cacheDir>/<modelId>/` 下需有非空 tokenizer 文件与 `onnx/` 权重文件。\n * 返回 undefined = 检查通过; \"missing\" = 目录/文件缺失或仅剩 0 字节残骸\n * (失败下载产物, 清理后进入下载阶段, 见 model-cache-hygiene); 其他字符串 =\n * 文件存在但可疑 (截断/非空过小), 属失败。\n */\nexport function modelFilesCheck(cacheDir: string, modelId: string, minWeightBytes: number): string | undefined {\n\tconst modelDir = join(cacheDir, modelId);\n\tif (!existsSync(modelDir)) return \"missing\";\n\t// tokenizer 只剩 0 字节文件 = 失败下载残骸 (真 tokenizer.json 不可能为空):\n\t// 清掉按缺失处理可重下; 非空文件不动 (手动导入布局不受影响)。\n\tconst tokenizerNames = [\"tokenizer.json\", \"tokenizer.model\"].filter((name) => existsSync(join(modelDir, name)));\n\tconst hasTokenizer = tokenizerNames.some((name) => statSync(join(modelDir, name)).size > 0);\n\tif (!hasTokenizer) {\n\t\tif (tokenizerNames.length > 0) purgeZeroByteCacheArtifacts(modelDir);\n\t\treturn \"missing\";\n\t}\n\tconst onnxDir = join(modelDir, \"onnx\");\n\tif (!existsSync(onnxDir)) return `onnx weight directory missing under ${modelDir}`;\n\tconst weights = readdirSync(onnxDir).filter((name) => name.includes(\".onnx\"));\n\tif (weights.length === 0) return `no onnx weight file under ${onnxDir}`;\n\tconst largest = Math.max(...weights.map((name) => statSync(join(onnxDir, name)).size));\n\tif (largest < minWeightBytes) {\n\t\treturn `largest onnx weight under ${onnxDir} is ${largest} bytes, below the expected minimum ${minWeightBytes} — the download looks truncated`;\n\t}\n\treturn undefined;\n}\n\n/**\n * 本地检查 3: 磁盘余量 (设计 §3.2 checking, node:fs statfs, 零新依赖)。\n * 以 agentDir 所在卷为准 (cacheDir 同卷创建)。agentDir 可能尚不存在 (全新\n * 机器首启, 下载前无人创建过它 — 2026-10-06 live E2E 实测踩中) — statfs\n * ENOENT 时逐级上溯最近存在的祖先目录, 同卷即同余量; 上溯到根仍失败才按\n * 无法判定报告。\n */\nexport async function diskHeadroomCheck(agentDir: string, minimumBytes: number): Promise<string | undefined> {\n\tlet freeBytes: number | undefined;\n\tlet probe: string | undefined = agentDir;\n\tfor (let attempt = 0; probe !== undefined && attempt < 16; attempt++) {\n\t\ttry {\n\t\t\tconst stats = await statfs(probe);\n\t\t\tfreeBytes = stats.bfree * stats.bsize;\n\t\t\tbreak;\n\t\t} catch (error) {\n\t\t\tif (!(error instanceof Error) || !String(error.message).includes(\"ENOENT\")) {\n\t\t\t\treturn `disk free space could not be determined for ${agentDir} (probing ${probe}: ${\n\t\t\t\t\terror instanceof Error ? error.message : String(error)\n\t\t\t\t})`;\n\t\t\t}\n\t\t\tconst parent = dirname(probe);\n\t\t\tprobe = parent === probe ? undefined : parent;\n\t\t}\n\t}\n\tif (freeBytes === undefined) {\n\t\treturn `disk free space could not be determined for ${agentDir} (no existing ancestor directory to statfs)`;\n\t}\n\tif (freeBytes < minimumBytes) {\n\t\treturn `disk free space is ${freeBytes} bytes, below the required ${minimumBytes}`;\n\t}\n\treturn undefined;\n}\n\n/** enabling 失败的五选一行动清单 (设计 §3.2 硬性要求)。 */\nexport function enablingActionList(modelCacheDir: string, currentMode: MemoryModeV1): readonly string[] {\n\treturn [\n\t\t`Switch to a reachable mirror: set ${HF_MIRRORS_ENV} to a comma-separated host list (tried before the defaults)`,\n\t\t`Install the heavy dependencies in the host project (npm i onnxruntime-node @lancedb/lancedb @huggingface/transformers) so the host can supply them via hostDependencyPaths, then restart the session`,\n\t\t`Download the models manually and place them under ${modelCacheDir} (layout: <modelId>/tokenizer.json + <modelId>/onnx/model*.onnx)`,\n\t\tcurrentMode === \"full\"\n\t\t\t? 'Downgrade to memory.mode \"light\" (much smaller models)'\n\t\t\t: 'Keep memory.mode \"light\" and retry with a reachable mirror',\n\t\t'Give up: leave memory.mode \"off\" (the default) so the memory family stays unregistered',\n\t];\n}\n\n// ---------------------------------------------------------------------------\n// 征询持久化 (capability 拆分战役 slice 3b 随迁, 征询域): agent-dir 配置文件\n// 的读写与征询拒绝/档位落盘。纯函数, 路径域显式传入; capability.ts 经\n// re-export 维持历史导出面, 向量通道 (vector-channel.ts) 直接 import。\n// ---------------------------------------------------------------------------\n\n/** agent-dir 配置文件里的征询拒绝标记值 (memoryConsent 键)。 */\nexport const MEMORY_CONSENT_DECLINED_VALUE = \"declined\";\n/** memory 插件 agent-dir 配置通道 (entry 读、capability 写, 同一路径)。 */\nexport const MEMORY_AGENT_DIR_CONFIG_RELATIVE_PATH = join(\"capabilities\", \"builtin.memory.json\");\n\nfunction readMemoryAgentDirConfig(agentDir: string): Record<string, unknown> {\n\tconst configPath = join(agentDir, MEMORY_AGENT_DIR_CONFIG_RELATIVE_PATH);\n\tif (existsSync(configPath)) {\n\t\ttry {\n\t\t\tconst parsed: unknown = JSON.parse(readFileSync(configPath, \"utf8\"));\n\t\t\tif (parsed !== null && typeof parsed === \"object\" && !Array.isArray(parsed)) {\n\t\t\t\treturn parsed as Record<string, unknown>;\n\t\t\t}\n\t\t} catch {\n\t\t\t// 既有文件非法时以本次写入为准 (持久化是显式用户动作, 不被脏文件阻塞)。\n\t\t}\n\t}\n\treturn {};\n}\n\n/**\n * 写 agent-dir 配置的原子替换 (2026-10-06 复审 P1-2): temp 文件 + rename —\n * 自动升档引入了无人值守写者, 与其它进程的 /memory off (会删档位键) 读改写\n * 交错时, 直接 writeFileSync 可能留下半截 JSON 让并发读者拿到空配置 (整块\n * 丢键: 抹掉并发 decline 或升档)。rename 在同一目录内原子替换, 读者要么见\n * 旧文件要么见新文件。\n */\nfunction writeMemoryAgentDirConfig(agentDir: string, config: Record<string, unknown>): void {\n\tconst configPath = join(agentDir, MEMORY_AGENT_DIR_CONFIG_RELATIVE_PATH);\n\tmkdirSync(dirname(configPath), { recursive: true });\n\tconst tempPath = `${configPath}.${process.pid}.tmp`;\n\twriteFileSync(tempPath, `${JSON.stringify(config, null, \"\\t\")}\\n`, \"utf8\");\n\trenameSync(tempPath, configPath);\n}\n\n/** agent-dir 配置里用户显式持久化的档位键 (无 / 该键即 undefined)。 */\nexport function readMemorySettingsMode(agentDir: string): \"light\" | \"full\" | undefined {\n\tconst value = readMemoryAgentDirConfig(agentDir).memorySettingsMode;\n\treturn value === \"light\" || value === \"full\" ? value : undefined;\n}\n\n/**\n * 拒绝/跳过的持久化 (2026-10-05 用户裁决): 写入插件自己的 agent-dir 配置文件,\n * 不改写用户 settings.json。语义是「用户对默认档说了不」——仅抑制默认档;\n * 用户日后显式设置 settings.json `memory.mode` (light/full) 时显式值仍然生效。\n * 同时移除 /memory light|full 持久化的档位键, 保证\"先升 full 再 off\"不会留下\n * 一个压过 settings 的陈旧档位。\n */\nexport function writeMemoryConsentDeclined(agentDir: string): void {\n\tconst config = readMemoryAgentDirConfig(agentDir);\n\tconfig.memoryConsent = MEMORY_CONSENT_DECLINED_VALUE;\n\tdelete config.memorySettingsMode;\n\tdelete config.memoryMode;\n\twriteMemoryAgentDirConfig(agentDir, config);\n}\n\n/**\n * 档位升级/降级的持久化 (/memory light|full): 写入插件 agent-dir 配置的\n * `memorySettingsMode` 键——与 settings.json `memory.mode` 同一解析层 (持久\n * 配置面, env 仍可临时覆盖)。插件无 settings.json 写通道 (HostCapabilities\n * 无该面), 本文件键在其上, 即命令是比 settings 更近一次的显式表达。同时清\n * 除拒绝标记: 显式升/降档是最新的用户意图, 压过此前的\"对默认档说不\"。\n */\nexport function writeMemorySettingsMode(agentDir: string, mode: \"light\" | \"full\"): void {\n\tconst config = readMemoryAgentDirConfig(agentDir);\n\tconfig.memorySettingsMode = mode;\n\tdelete config.memoryConsent;\n\twriteMemoryAgentDirConfig(agentDir, config);\n}\n"]}

package/dist/memory/enabling.js

@@ -112,6 +112,12 @@ export function nativeBinaryCheck(hostEntryPath) {
             packageDir = dirname(packageDir);
         }
         const binDir = join(packageDir, "bin");
+        // 走到文件系统根仍未找到 package.json：这是损坏/伪造的安装树，不能
+        // 拿根目录的 bin（POSIX 上 /bin 真实存在）继续探测，否则会把损坏误报成
+        // 平台二进制缺失。
+        if (!existsSync(join(packageDir, "package.json"))) {
+            return `onnxruntime native binary directory not found: ${binDir}`;
+        }
         if (!existsSync(binDir))
             return `onnxruntime native binary directory not found: ${binDir}`;
         for (const napiEntry of readdirSync(binDir, { withFileTypes: true })) {

package/dist/memory/enabling.js.map

@@ -1 +1 @@
-{"version":3,"file":"enabling.js","sourceRoot":"","sources":["../../src/memory/enabling.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * enabling 前置检查、档位预设与镜像源（capability 拆分战役 slice 1）：纯函数,\n * 无闭包依赖。\n */\n\nimport { existsSync, mkdirSync, readdirSync, readFileSync, renameSync, statSync, writeFileSync } from \"node:fs\";\nimport { statfs } from \"node:fs/promises\";\nimport { createRequire } from \"node:module\";\nimport { dirname, join, resolve } from \"node:path\";\nimport type { MemoryModeV1 } from \"@agent-forge/plugin-sdk\";\nimport { purgeZeroByteCacheArtifacts } from \"./model-cache-hygiene.ts\";\n\n/** 开启前磁盘余量下限 (设计 §3.2 checking): light ≥ 500MB, full ≥ 2GB。 */\nexport const DISK_HEADROOM_MIN_BYTES: Readonly<Record<Exclude<MemoryModeV1, \"off\">, number>> = {\n\tlight: 500 * 1024 * 1024,\n\tfull: 2 * 1024 * 1024 * 1024,\n};\n/**\n * 模型文件大小下限 (防截断/空文件的 sanity 下限, 非精确体积): 高档 embedding\n * (bge-m3 q8) 数百 MB → 下限 256MB, 精排器 (bge-reranker-base q8) ~280MB →\n * 下限 64MB, 低档 (bge-small-zh q8) ~24MB → 下限 8MB。真实校验由加载冒烟承担。\n */\nexport const MODEL_MIN_WEIGHT_BYTES: Readonly<Record<Exclude<MemoryModeV1, \"off\">, number>> = {\n\tlight: 8 * 1024 * 1024,\n\tfull: 256 * 1024 * 1024,\n};\nexport const RERANKER_MIN_WEIGHT_BYTES = 64 * 1024 * 1024;\n/** 自定义镜像源环境变量 (失败行动清单第一项指向它)。 */\nconst HF_MIRRORS_ENV = \"AGENT_FORGE_HF_MIRRORS\";\n\n/** 两档预设 (实施计划 §2): light = 纯中文强项低配档, full = 跨语言大规模默认档。 */\ninterface MemoryVectorPresetV1 {\n\treadonly embeddingModelId: string;\n\treadonly dimensions: number;\n\t/** 查询侧指令前缀 (bge-small-zh 系查询侧指令由调用方负责添加; 写入侧不加)。 */\n\treadonly queryPrefix: string;\n}\n\nexport const VECTOR_PRESET_LIGHT: MemoryVectorPresetV1 = {\n\tembeddingModelId: \"Xenova/bge-small-zh-v1.5\",\n\tdimensions: 512,\n\tqueryPrefix: \"为这个句子生成表示以用于检索相关文章：\",\n};\nexport const VECTOR_PRESET_FULL: MemoryVectorPresetV1 = {\n\tembeddingModelId: \"Xenova/bge-m3\",\n\tdimensions: 1024,\n\tqueryPrefix: \"\",\n};\n/** 镜像序列 (实施计划 §7): 直连 huggingface.co 超时时回落 hf-mirror.com。 */\nconst VECTOR_REMOTE_HOSTS: readonly string[] = [\"https://huggingface.co\", \"https://hf-mirror.com\"];\n\n/** 档位预设: mode → 模型组合。off 在进入装配前已被门控拦截。 */\nexport function vectorPresetForMode(mode: Exclude<MemoryModeV1, \"off\">): MemoryVectorPresetV1 {\n\treturn mode === \"light\" ? VECTOR_PRESET_LIGHT : VECTOR_PRESET_FULL;\n}\n\n/**\n * agentDir 身份归一化 (2026-10-06 串线修复): 绝对路径解析抹平分隔符与相对段,\n * win32 再 casefold —— 同一目录在 Windows 下的大小写差异 (盘符/路径段) 不得\n * 误判为跨 agent-dir 串线。仅用于身份比对, 不触碰文件系统语义。\n */\nexport function normalizeMemoryAgentDirIdentity(agentDir: string): string {\n\tconst resolvedPath = resolve(agentDir);\n\treturn process.platform === \"win32\" ? resolvedPath.toLowerCase() : resolvedPath;\n}\n\n/**\n * 自定义镜像源 (失败行动清单第一项指向它): env `AGENT_FORGE_HF_MIRRORS` 逗号\n * 分隔 host 列表, 排在默认镜像序列之前优先尝试; 默认序列直连 huggingface.co\n * 超时时回落 hf-mirror.com。\n *\n * env 条目归一化 (2026-10-06 live E2E 修复): 裸主机名补 `https://` — 用户\n * 按行动清单写 `AGENT_FORGE_HF_MIRRORS=hf-mirror.com` 时, 无 scheme 的\n * remoteHost 会让 transformers 的文件请求按相对 URL 解析并在模块内留下\n * 毒化状态, 连后续带 scheme 的镜像重试也崩; 行动清单推荐的自救手段本身\n * 不能是断的。已带 scheme 的条目原样保留, 尾部 `/` 去除。\n */\nexport function remoteHostsForEnabling(): readonly string[] {\n\tconst custom = process.env[HF_MIRRORS_ENV]\n\t\t?.split(\",\")\n\t\t.map((host) => host.trim().replace(/\\/+$/, \"\"))\n\t\t.map((host) => (host === \"\" || host.includes(\"://\") ? host : `https://${host}`))\n\t\t.filter((host) => host !== \"\");\n\treturn custom === undefined || custom.length === 0 ? VECTOR_REMOTE_HOSTS : [...custom, ...VECTOR_REMOTE_HOSTS];\n}\n\n/**\n * 本地检查 1: native .node sidecar 可解析 (设计 §3.2 checking)。布局:\n * onnxruntime-node/bin 下的 napi-vN/<platform>/<arch> 原生模块 — 缺失 = 安装\n * 损坏。容错: 不钉死 napi 版本号, 逐目录扫描。\n *\n * 解析基点双通道: jiti（安装店加载缝）注入的 `require` 走宿主 alias 表\n * （宿主 node_modules 副本, 店内无依赖树）; 纯 ESM（源码/工作区直载）下裸\n * `require` 未定义（typeof 探测不抛 ReferenceError）, 回落原生 createRequire。\n */\nfunction resolveOnnxRuntimeEntryPath(): string {\n\tif (typeof require === \"function\") {\n\t\ttry {\n\t\t\treturn require.resolve(\"onnxruntime-node\");\n\t\t} catch {\n\t\t\t// jiti 解析失败（alias 未覆盖等）→ 继续走原生解析再报结构化错误。\n\t\t}\n\t}\n\treturn createRequire(import.meta.url).resolve(\"onnxruntime-node\");\n}\n\nexport function nativeBinaryCheck(hostEntryPath?: string): string | undefined {\n\t// 两种失败要区分 (D-075 安装店路径修复后前者成为真实可达路径):\n\t// (a) 宿主未注入入口路径且插件位置自解析不到 — 不是安装损坏, 行动是宿主侧\n\t//     安装重依赖后重启会话, 不是重装插件;\n\t// (b) 路径存在但原生二进制缺失/损坏 — 保留损坏类文案。\n\tlet entryPath: string;\n\tif (hostEntryPath === undefined) {\n\t\ttry {\n\t\t\tentryPath = resolveOnnxRuntimeEntryPath();\n\t\t} catch (error) {\n\t\t\tconst detail = error instanceof Error ? error.message : String(error);\n\t\t\treturn `onnxruntime-node is not provided by the host installation and could not be resolved from the plugin location (${detail}); to enable memory features, install onnxruntime-node in the host project (npm i onnxruntime-node) and restart the session`;\n\t\t}\n\t} else {\n\t\tentryPath = hostEntryPath;\n\t}\n\ttry {\n\t\tlet packageDir = dirname(entryPath);\n\t\twhile (packageDir !== dirname(packageDir) && !existsSync(join(packageDir, \"package.json\"))) {\n\t\t\tpackageDir = dirname(packageDir);\n\t\t}\n\t\tconst binDir = join(packageDir, \"bin\");\n\t\tif (!existsSync(binDir)) return `onnxruntime native binary directory not found: ${binDir}`;\n\t\tfor (const napiEntry of readdirSync(binDir, { withFileTypes: true })) {\n\t\t\tif (!napiEntry.isDirectory() || !napiEntry.name.startsWith(\"napi-v\")) continue;\n\t\t\tconst platformDir = join(binDir, napiEntry.name, process.platform, process.arch);\n\t\t\tif (!existsSync(platformDir)) continue;\n\t\t\tconst binaries = readdirSync(platformDir).filter((file) => file.endsWith(\".node\"));\n\t\t\tif (binaries.length > 0) return undefined;\n\t\t}\n\t\treturn `onnxruntime native binary for ${process.platform}/${process.arch} not found under ${binDir}`;\n\t} catch (error) {\n\t\treturn `onnxruntime native binary could not be resolved (${error instanceof Error ? error.message : String(error)}); the installation looks damaged — reinstall the package`;\n\t}\n}\n\n/**\n * 重依赖自解析默认实现 (missingHeavyDependencyModules 生产接线): 双通道与\n * {@link resolveOnnxRuntimeEntryPath} 一致 — jiti（安装店加载缝）注入的\n * `require` 走宿主 alias 表; 纯 ESM（源码/工作区直载）下回落原生 createRequire。\n */\nexport function resolveHeavyDependencyEntryPath(specifier: string): string {\n\tif (typeof require === \"function\") {\n\t\ttry {\n\t\t\treturn require.resolve(specifier);\n\t\t} catch {\n\t\t\t// jiti 解析失败（alias 未覆盖等）→ 继续走原生解析。\n\t\t}\n\t}\n\treturn createRequire(import.meta.url).resolve(specifier);\n}\n\n/**\n * 本地检查 1b: 重依赖供给 (设计 §3.2 checking)。`@lancedb/lancedb` 与\n * `@huggingface/transformers` 逐个判定 — entries 提供宿主入口路径 = 可用\n * (不触自解析); 未提供时 resolveModule 自解析成功 = 可用, 抛错 = 计入缺失。\n * 返回缺失 specifier 列表 (空 = 通过)。纯函数零 IO; 导出仅供测试 (与宿主侧\n * buildHostDependencyAliases 同一模式), 生产接线传插件位置自解析 — 把加载步\n * 的 \"Cannot find module\" 泛化包装前置成精准缺供文案, 省掉模型下载等前置工作。\n */\nexport function missingHeavyDependencyModules(\n\tentries: { lancedb?: string; transformers?: string },\n\tresolveModule: (specifier: string) => string,\n): string[] {\n\tconst missing: string[] = [];\n\tconst supplies: readonly (readonly [specifier: string, entryPath: string | undefined])[] = [\n\t\t[\"@lancedb/lancedb\", entries.lancedb],\n\t\t[\"@huggingface/transformers\", entries.transformers],\n\t];\n\tfor (const [specifier, entryPath] of supplies) {\n\t\tif (entryPath !== undefined) continue;\n\t\ttry {\n\t\t\tresolveModule(specifier);\n\t\t} catch {\n\t\t\tmissing.push(specifier);\n\t\t}\n\t}\n\treturn missing;\n}\n\n/**\n * transformers.js 缓存布局的容错存在性检查 (设计 §3.2 手动导入路径):\n * `<cacheDir>/<modelId>/` 下需有非空 tokenizer 文件与 `onnx/` 权重文件。\n * 返回 undefined = 检查通过; \"missing\" = 目录/文件缺失或仅剩 0 字节残骸\n * (失败下载产物, 清理后进入下载阶段, 见 model-cache-hygiene); 其他字符串 =\n * 文件存在但可疑 (截断/非空过小), 属失败。\n */\nexport function modelFilesCheck(cacheDir: string, modelId: string, minWeightBytes: number): string | undefined {\n\tconst modelDir = join(cacheDir, modelId);\n\tif (!existsSync(modelDir)) return \"missing\";\n\t// tokenizer 只剩 0 字节文件 = 失败下载残骸 (真 tokenizer.json 不可能为空):\n\t// 清掉按缺失处理可重下; 非空文件不动 (手动导入布局不受影响)。\n\tconst tokenizerNames = [\"tokenizer.json\", \"tokenizer.model\"].filter((name) => existsSync(join(modelDir, name)));\n\tconst hasTokenizer = tokenizerNames.some((name) => statSync(join(modelDir, name)).size > 0);\n\tif (!hasTokenizer) {\n\t\tif (tokenizerNames.length > 0) purgeZeroByteCacheArtifacts(modelDir);\n\t\treturn \"missing\";\n\t}\n\tconst onnxDir = join(modelDir, \"onnx\");\n\tif (!existsSync(onnxDir)) return `onnx weight directory missing under ${modelDir}`;\n\tconst weights = readdirSync(onnxDir).filter((name) => name.includes(\".onnx\"));\n\tif (weights.length === 0) return `no onnx weight file under ${onnxDir}`;\n\tconst largest = Math.max(...weights.map((name) => statSync(join(onnxDir, name)).size));\n\tif (largest < minWeightBytes) {\n\t\treturn `largest onnx weight under ${onnxDir} is ${largest} bytes, below the expected minimum ${minWeightBytes} — the download looks truncated`;\n\t}\n\treturn undefined;\n}\n\n/**\n * 本地检查 3: 磁盘余量 (设计 §3.2 checking, node:fs statfs, 零新依赖)。\n * 以 agentDir 所在卷为准 (cacheDir 同卷创建)。agentDir 可能尚不存在 (全新\n * 机器首启, 下载前无人创建过它 — 2026-10-06 live E2E 实测踩中) — statfs\n * ENOENT 时逐级上溯最近存在的祖先目录, 同卷即同余量; 上溯到根仍失败才按\n * 无法判定报告。\n */\nexport async function diskHeadroomCheck(agentDir: string, minimumBytes: number): Promise<string | undefined> {\n\tlet freeBytes: number | undefined;\n\tlet probe: string | undefined = agentDir;\n\tfor (let attempt = 0; probe !== undefined && attempt < 16; attempt++) {\n\t\ttry {\n\t\t\tconst stats = await statfs(probe);\n\t\t\tfreeBytes = stats.bfree * stats.bsize;\n\t\t\tbreak;\n\t\t} catch (error) {\n\t\t\tif (!(error instanceof Error) || !String(error.message).includes(\"ENOENT\")) {\n\t\t\t\treturn `disk free space could not be determined for ${agentDir} (probing ${probe}: ${\n\t\t\t\t\terror instanceof Error ? error.message : String(error)\n\t\t\t\t})`;\n\t\t\t}\n\t\t\tconst parent = dirname(probe);\n\t\t\tprobe = parent === probe ? undefined : parent;\n\t\t}\n\t}\n\tif (freeBytes === undefined) {\n\t\treturn `disk free space could not be determined for ${agentDir} (no existing ancestor directory to statfs)`;\n\t}\n\tif (freeBytes < minimumBytes) {\n\t\treturn `disk free space is ${freeBytes} bytes, below the required ${minimumBytes}`;\n\t}\n\treturn undefined;\n}\n\n/** enabling 失败的五选一行动清单 (设计 §3.2 硬性要求)。 */\nexport function enablingActionList(modelCacheDir: string, currentMode: MemoryModeV1): readonly string[] {\n\treturn [\n\t\t`Switch to a reachable mirror: set ${HF_MIRRORS_ENV} to a comma-separated host list (tried before the defaults)`,\n\t\t`Install the heavy dependencies in the host project (npm i onnxruntime-node @lancedb/lancedb @huggingface/transformers) so the host can supply them via hostDependencyPaths, then restart the session`,\n\t\t`Download the models manually and place them under ${modelCacheDir} (layout: <modelId>/tokenizer.json + <modelId>/onnx/model*.onnx)`,\n\t\tcurrentMode === \"full\"\n\t\t\t? 'Downgrade to memory.mode \"light\" (much smaller models)'\n\t\t\t: 'Keep memory.mode \"light\" and retry with a reachable mirror',\n\t\t'Give up: leave memory.mode \"off\" (the default) so the memory family stays unregistered',\n\t];\n}\n\n// ---------------------------------------------------------------------------\n// 征询持久化 (capability 拆分战役 slice 3b 随迁, 征询域): agent-dir 配置文件\n// 的读写与征询拒绝/档位落盘。纯函数, 路径域显式传入; capability.ts 经\n// re-export 维持历史导出面, 向量通道 (vector-channel.ts) 直接 import。\n// ---------------------------------------------------------------------------\n\n/** agent-dir 配置文件里的征询拒绝标记值 (memoryConsent 键)。 */\nexport const MEMORY_CONSENT_DECLINED_VALUE = \"declined\";\n/** memory 插件 agent-dir 配置通道 (entry 读、capability 写, 同一路径)。 */\nexport const MEMORY_AGENT_DIR_CONFIG_RELATIVE_PATH = join(\"capabilities\", \"builtin.memory.json\");\n\nfunction readMemoryAgentDirConfig(agentDir: string): Record<string, unknown> {\n\tconst configPath = join(agentDir, MEMORY_AGENT_DIR_CONFIG_RELATIVE_PATH);\n\tif (existsSync(configPath)) {\n\t\ttry {\n\t\t\tconst parsed: unknown = JSON.parse(readFileSync(configPath, \"utf8\"));\n\t\t\tif (parsed !== null && typeof parsed === \"object\" && !Array.isArray(parsed)) {\n\t\t\t\treturn parsed as Record<string, unknown>;\n\t\t\t}\n\t\t} catch {\n\t\t\t// 既有文件非法时以本次写入为准 (持久化是显式用户动作, 不被脏文件阻塞)。\n\t\t}\n\t}\n\treturn {};\n}\n\n/**\n * 写 agent-dir 配置的原子替换 (2026-10-06 复审 P1-2): temp 文件 + rename —\n * 自动升档引入了无人值守写者, 与其它进程的 /memory off (会删档位键) 读改写\n * 交错时, 直接 writeFileSync 可能留下半截 JSON 让并发读者拿到空配置 (整块\n * 丢键: 抹掉并发 decline 或升档)。rename 在同一目录内原子替换, 读者要么见\n * 旧文件要么见新文件。\n */\nfunction writeMemoryAgentDirConfig(agentDir: string, config: Record<string, unknown>): void {\n\tconst configPath = join(agentDir, MEMORY_AGENT_DIR_CONFIG_RELATIVE_PATH);\n\tmkdirSync(dirname(configPath), { recursive: true });\n\tconst tempPath = `${configPath}.${process.pid}.tmp`;\n\twriteFileSync(tempPath, `${JSON.stringify(config, null, \"\\t\")}\\n`, \"utf8\");\n\trenameSync(tempPath, configPath);\n}\n\n/** agent-dir 配置里用户显式持久化的档位键 (无 / 该键即 undefined)。 */\nexport function readMemorySettingsMode(agentDir: string): \"light\" | \"full\" | undefined {\n\tconst value = readMemoryAgentDirConfig(agentDir).memorySettingsMode;\n\treturn value === \"light\" || value === \"full\" ? value : undefined;\n}\n\n/**\n * 拒绝/跳过的持久化 (2026-10-05 用户裁决): 写入插件自己的 agent-dir 配置文件,\n * 不改写用户 settings.json。语义是「用户对默认档说了不」——仅抑制默认档;\n * 用户日后显式设置 settings.json `memory.mode` (light/full) 时显式值仍然生效。\n * 同时移除 /memory light|full 持久化的档位键, 保证\"先升 full 再 off\"不会留下\n * 一个压过 settings 的陈旧档位。\n */\nexport function writeMemoryConsentDeclined(agentDir: string): void {\n\tconst config = readMemoryAgentDirConfig(agentDir);\n\tconfig.memoryConsent = MEMORY_CONSENT_DECLINED_VALUE;\n\tdelete config.memorySettingsMode;\n\tdelete config.memoryMode;\n\twriteMemoryAgentDirConfig(agentDir, config);\n}\n\n/**\n * 档位升级/降级的持久化 (/memory light|full): 写入插件 agent-dir 配置的\n * `memorySettingsMode` 键——与 settings.json `memory.mode` 同一解析层 (持久\n * 配置面, env 仍可临时覆盖)。插件无 settings.json 写通道 (HostCapabilities\n * 无该面), 本文件键在其上, 即命令是比 settings 更近一次的显式表达。同时清\n * 除拒绝标记: 显式升/降档是最新的用户意图, 压过此前的\"对默认档说不\"。\n */\nexport function writeMemorySettingsMode(agentDir: string, mode: \"light\" | \"full\"): void {\n\tconst config = readMemoryAgentDirConfig(agentDir);\n\tconfig.memorySettingsMode = mode;\n\tdelete config.memoryConsent;\n\twriteMemoryAgentDirConfig(agentDir, config);\n}\n"]}
+{"version":3,"file":"enabling.js","sourceRoot":"","sources":["../../src/memory/enabling.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * enabling 前置检查、档位预设与镜像源（capability 拆分战役 slice 1）：纯函数,\n * 无闭包依赖。\n */\n\nimport { existsSync, mkdirSync, readdirSync, readFileSync, renameSync, statSync, writeFileSync } from \"node:fs\";\nimport { statfs } from \"node:fs/promises\";\nimport { createRequire } from \"node:module\";\nimport { dirname, join, resolve } from \"node:path\";\nimport type { MemoryModeV1 } from \"@agent-forge/plugin-sdk\";\nimport { purgeZeroByteCacheArtifacts } from \"./model-cache-hygiene.ts\";\n\n/** 开启前磁盘余量下限 (设计 §3.2 checking): light ≥ 500MB, full ≥ 2GB。 */\nexport const DISK_HEADROOM_MIN_BYTES: Readonly<Record<Exclude<MemoryModeV1, \"off\">, number>> = {\n\tlight: 500 * 1024 * 1024,\n\tfull: 2 * 1024 * 1024 * 1024,\n};\n/**\n * 模型文件大小下限 (防截断/空文件的 sanity 下限, 非精确体积): 高档 embedding\n * (bge-m3 q8) 数百 MB → 下限 256MB, 精排器 (bge-reranker-base q8) ~280MB →\n * 下限 64MB, 低档 (bge-small-zh q8) ~24MB → 下限 8MB。真实校验由加载冒烟承担。\n */\nexport const MODEL_MIN_WEIGHT_BYTES: Readonly<Record<Exclude<MemoryModeV1, \"off\">, number>> = {\n\tlight: 8 * 1024 * 1024,\n\tfull: 256 * 1024 * 1024,\n};\nexport const RERANKER_MIN_WEIGHT_BYTES = 64 * 1024 * 1024;\n/** 自定义镜像源环境变量 (失败行动清单第一项指向它)。 */\nconst HF_MIRRORS_ENV = \"AGENT_FORGE_HF_MIRRORS\";\n\n/** 两档预设 (实施计划 §2): light = 纯中文强项低配档, full = 跨语言大规模默认档。 */\ninterface MemoryVectorPresetV1 {\n\treadonly embeddingModelId: string;\n\treadonly dimensions: number;\n\t/** 查询侧指令前缀 (bge-small-zh 系查询侧指令由调用方负责添加; 写入侧不加)。 */\n\treadonly queryPrefix: string;\n}\n\nexport const VECTOR_PRESET_LIGHT: MemoryVectorPresetV1 = {\n\tembeddingModelId: \"Xenova/bge-small-zh-v1.5\",\n\tdimensions: 512,\n\tqueryPrefix: \"为这个句子生成表示以用于检索相关文章：\",\n};\nexport const VECTOR_PRESET_FULL: MemoryVectorPresetV1 = {\n\tembeddingModelId: \"Xenova/bge-m3\",\n\tdimensions: 1024,\n\tqueryPrefix: \"\",\n};\n/** 镜像序列 (实施计划 §7): 直连 huggingface.co 超时时回落 hf-mirror.com。 */\nconst VECTOR_REMOTE_HOSTS: readonly string[] = [\"https://huggingface.co\", \"https://hf-mirror.com\"];\n\n/** 档位预设: mode → 模型组合。off 在进入装配前已被门控拦截。 */\nexport function vectorPresetForMode(mode: Exclude<MemoryModeV1, \"off\">): MemoryVectorPresetV1 {\n\treturn mode === \"light\" ? VECTOR_PRESET_LIGHT : VECTOR_PRESET_FULL;\n}\n\n/**\n * agentDir 身份归一化 (2026-10-06 串线修复): 绝对路径解析抹平分隔符与相对段,\n * win32 再 casefold —— 同一目录在 Windows 下的大小写差异 (盘符/路径段) 不得\n * 误判为跨 agent-dir 串线。仅用于身份比对, 不触碰文件系统语义。\n */\nexport function normalizeMemoryAgentDirIdentity(agentDir: string): string {\n\tconst resolvedPath = resolve(agentDir);\n\treturn process.platform === \"win32\" ? resolvedPath.toLowerCase() : resolvedPath;\n}\n\n/**\n * 自定义镜像源 (失败行动清单第一项指向它): env `AGENT_FORGE_HF_MIRRORS` 逗号\n * 分隔 host 列表, 排在默认镜像序列之前优先尝试; 默认序列直连 huggingface.co\n * 超时时回落 hf-mirror.com。\n *\n * env 条目归一化 (2026-10-06 live E2E 修复): 裸主机名补 `https://` — 用户\n * 按行动清单写 `AGENT_FORGE_HF_MIRRORS=hf-mirror.com` 时, 无 scheme 的\n * remoteHost 会让 transformers 的文件请求按相对 URL 解析并在模块内留下\n * 毒化状态, 连后续带 scheme 的镜像重试也崩; 行动清单推荐的自救手段本身\n * 不能是断的。已带 scheme 的条目原样保留, 尾部 `/` 去除。\n */\nexport function remoteHostsForEnabling(): readonly string[] {\n\tconst custom = process.env[HF_MIRRORS_ENV]\n\t\t?.split(\",\")\n\t\t.map((host) => host.trim().replace(/\\/+$/, \"\"))\n\t\t.map((host) => (host === \"\" || host.includes(\"://\") ? host : `https://${host}`))\n\t\t.filter((host) => host !== \"\");\n\treturn custom === undefined || custom.length === 0 ? VECTOR_REMOTE_HOSTS : [...custom, ...VECTOR_REMOTE_HOSTS];\n}\n\n/**\n * 本地检查 1: native .node sidecar 可解析 (设计 §3.2 checking)。布局:\n * onnxruntime-node/bin 下的 napi-vN/<platform>/<arch> 原生模块 — 缺失 = 安装\n * 损坏。容错: 不钉死 napi 版本号, 逐目录扫描。\n *\n * 解析基点双通道: jiti（安装店加载缝）注入的 `require` 走宿主 alias 表\n * （宿主 node_modules 副本, 店内无依赖树）; 纯 ESM（源码/工作区直载）下裸\n * `require` 未定义（typeof 探测不抛 ReferenceError）, 回落原生 createRequire。\n */\nfunction resolveOnnxRuntimeEntryPath(): string {\n\tif (typeof require === \"function\") {\n\t\ttry {\n\t\t\treturn require.resolve(\"onnxruntime-node\");\n\t\t} catch {\n\t\t\t// jiti 解析失败（alias 未覆盖等）→ 继续走原生解析再报结构化错误。\n\t\t}\n\t}\n\treturn createRequire(import.meta.url).resolve(\"onnxruntime-node\");\n}\n\nexport function nativeBinaryCheck(hostEntryPath?: string): string | undefined {\n\t// 两种失败要区分 (D-075 安装店路径修复后前者成为真实可达路径):\n\t// (a) 宿主未注入入口路径且插件位置自解析不到 — 不是安装损坏, 行动是宿主侧\n\t//     安装重依赖后重启会话, 不是重装插件;\n\t// (b) 路径存在但原生二进制缺失/损坏 — 保留损坏类文案。\n\tlet entryPath: string;\n\tif (hostEntryPath === undefined) {\n\t\ttry {\n\t\t\tentryPath = resolveOnnxRuntimeEntryPath();\n\t\t} catch (error) {\n\t\t\tconst detail = error instanceof Error ? error.message : String(error);\n\t\t\treturn `onnxruntime-node is not provided by the host installation and could not be resolved from the plugin location (${detail}); to enable memory features, install onnxruntime-node in the host project (npm i onnxruntime-node) and restart the session`;\n\t\t}\n\t} else {\n\t\tentryPath = hostEntryPath;\n\t}\n\ttry {\n\t\tlet packageDir = dirname(entryPath);\n\t\twhile (packageDir !== dirname(packageDir) && !existsSync(join(packageDir, \"package.json\"))) {\n\t\t\tpackageDir = dirname(packageDir);\n\t\t}\n\t\tconst binDir = join(packageDir, \"bin\");\n\t\t// 走到文件系统根仍未找到 package.json：这是损坏/伪造的安装树，不能\n\t\t// 拿根目录的 bin（POSIX 上 /bin 真实存在）继续探测，否则会把损坏误报成\n\t\t// 平台二进制缺失。\n\t\tif (!existsSync(join(packageDir, \"package.json\"))) {\n\t\t\treturn `onnxruntime native binary directory not found: ${binDir}`;\n\t\t}\n\t\tif (!existsSync(binDir)) return `onnxruntime native binary directory not found: ${binDir}`;\n\t\tfor (const napiEntry of readdirSync(binDir, { withFileTypes: true })) {\n\t\t\tif (!napiEntry.isDirectory() || !napiEntry.name.startsWith(\"napi-v\")) continue;\n\t\t\tconst platformDir = join(binDir, napiEntry.name, process.platform, process.arch);\n\t\t\tif (!existsSync(platformDir)) continue;\n\t\t\tconst binaries = readdirSync(platformDir).filter((file) => file.endsWith(\".node\"));\n\t\t\tif (binaries.length > 0) return undefined;\n\t\t}\n\t\treturn `onnxruntime native binary for ${process.platform}/${process.arch} not found under ${binDir}`;\n\t} catch (error) {\n\t\treturn `onnxruntime native binary could not be resolved (${error instanceof Error ? error.message : String(error)}); the installation looks damaged — reinstall the package`;\n\t}\n}\n\n/**\n * 重依赖自解析默认实现 (missingHeavyDependencyModules 生产接线): 双通道与\n * {@link resolveOnnxRuntimeEntryPath} 一致 — jiti（安装店加载缝）注入的\n * `require` 走宿主 alias 表; 纯 ESM（源码/工作区直载）下回落原生 createRequire。\n */\nexport function resolveHeavyDependencyEntryPath(specifier: string): string {\n\tif (typeof require === \"function\") {\n\t\ttry {\n\t\t\treturn require.resolve(specifier);\n\t\t} catch {\n\t\t\t// jiti 解析失败（alias 未覆盖等）→ 继续走原生解析。\n\t\t}\n\t}\n\treturn createRequire(import.meta.url).resolve(specifier);\n}\n\n/**\n * 本地检查 1b: 重依赖供给 (设计 §3.2 checking)。`@lancedb/lancedb` 与\n * `@huggingface/transformers` 逐个判定 — entries 提供宿主入口路径 = 可用\n * (不触自解析); 未提供时 resolveModule 自解析成功 = 可用, 抛错 = 计入缺失。\n * 返回缺失 specifier 列表 (空 = 通过)。纯函数零 IO; 导出仅供测试 (与宿主侧\n * buildHostDependencyAliases 同一模式), 生产接线传插件位置自解析 — 把加载步\n * 的 \"Cannot find module\" 泛化包装前置成精准缺供文案, 省掉模型下载等前置工作。\n */\nexport function missingHeavyDependencyModules(\n\tentries: { lancedb?: string; transformers?: string },\n\tresolveModule: (specifier: string) => string,\n): string[] {\n\tconst missing: string[] = [];\n\tconst supplies: readonly (readonly [specifier: string, entryPath: string | undefined])[] = [\n\t\t[\"@lancedb/lancedb\", entries.lancedb],\n\t\t[\"@huggingface/transformers\", entries.transformers],\n\t];\n\tfor (const [specifier, entryPath] of supplies) {\n\t\tif (entryPath !== undefined) continue;\n\t\ttry {\n\t\t\tresolveModule(specifier);\n\t\t} catch {\n\t\t\tmissing.push(specifier);\n\t\t}\n\t}\n\treturn missing;\n}\n\n/**\n * transformers.js 缓存布局的容错存在性检查 (设计 §3.2 手动导入路径):\n * `<cacheDir>/<modelId>/` 下需有非空 tokenizer 文件与 `onnx/` 权重文件。\n * 返回 undefined = 检查通过; \"missing\" = 目录/文件缺失或仅剩 0 字节残骸\n * (失败下载产物, 清理后进入下载阶段, 见 model-cache-hygiene); 其他字符串 =\n * 文件存在但可疑 (截断/非空过小), 属失败。\n */\nexport function modelFilesCheck(cacheDir: string, modelId: string, minWeightBytes: number): string | undefined {\n\tconst modelDir = join(cacheDir, modelId);\n\tif (!existsSync(modelDir)) return \"missing\";\n\t// tokenizer 只剩 0 字节文件 = 失败下载残骸 (真 tokenizer.json 不可能为空):\n\t// 清掉按缺失处理可重下; 非空文件不动 (手动导入布局不受影响)。\n\tconst tokenizerNames = [\"tokenizer.json\", \"tokenizer.model\"].filter((name) => existsSync(join(modelDir, name)));\n\tconst hasTokenizer = tokenizerNames.some((name) => statSync(join(modelDir, name)).size > 0);\n\tif (!hasTokenizer) {\n\t\tif (tokenizerNames.length > 0) purgeZeroByteCacheArtifacts(modelDir);\n\t\treturn \"missing\";\n\t}\n\tconst onnxDir = join(modelDir, \"onnx\");\n\tif (!existsSync(onnxDir)) return `onnx weight directory missing under ${modelDir}`;\n\tconst weights = readdirSync(onnxDir).filter((name) => name.includes(\".onnx\"));\n\tif (weights.length === 0) return `no onnx weight file under ${onnxDir}`;\n\tconst largest = Math.max(...weights.map((name) => statSync(join(onnxDir, name)).size));\n\tif (largest < minWeightBytes) {\n\t\treturn `largest onnx weight under ${onnxDir} is ${largest} bytes, below the expected minimum ${minWeightBytes} — the download looks truncated`;\n\t}\n\treturn undefined;\n}\n\n/**\n * 本地检查 3: 磁盘余量 (设计 §3.2 checking, node:fs statfs, 零新依赖)。\n * 以 agentDir 所在卷为准 (cacheDir 同卷创建)。agentDir 可能尚不存在 (全新\n * 机器首启, 下载前无人创建过它 — 2026-10-06 live E2E 实测踩中) — statfs\n * ENOENT 时逐级上溯最近存在的祖先目录, 同卷即同余量; 上溯到根仍失败才按\n * 无法判定报告。\n */\nexport async function diskHeadroomCheck(agentDir: string, minimumBytes: number): Promise<string | undefined> {\n\tlet freeBytes: number | undefined;\n\tlet probe: string | undefined = agentDir;\n\tfor (let attempt = 0; probe !== undefined && attempt < 16; attempt++) {\n\t\ttry {\n\t\t\tconst stats = await statfs(probe);\n\t\t\tfreeBytes = stats.bfree * stats.bsize;\n\t\t\tbreak;\n\t\t} catch (error) {\n\t\t\tif (!(error instanceof Error) || !String(error.message).includes(\"ENOENT\")) {\n\t\t\t\treturn `disk free space could not be determined for ${agentDir} (probing ${probe}: ${\n\t\t\t\t\terror instanceof Error ? error.message : String(error)\n\t\t\t\t})`;\n\t\t\t}\n\t\t\tconst parent = dirname(probe);\n\t\t\tprobe = parent === probe ? undefined : parent;\n\t\t}\n\t}\n\tif (freeBytes === undefined) {\n\t\treturn `disk free space could not be determined for ${agentDir} (no existing ancestor directory to statfs)`;\n\t}\n\tif (freeBytes < minimumBytes) {\n\t\treturn `disk free space is ${freeBytes} bytes, below the required ${minimumBytes}`;\n\t}\n\treturn undefined;\n}\n\n/** enabling 失败的五选一行动清单 (设计 §3.2 硬性要求)。 */\nexport function enablingActionList(modelCacheDir: string, currentMode: MemoryModeV1): readonly string[] {\n\treturn [\n\t\t`Switch to a reachable mirror: set ${HF_MIRRORS_ENV} to a comma-separated host list (tried before the defaults)`,\n\t\t`Install the heavy dependencies in the host project (npm i onnxruntime-node @lancedb/lancedb @huggingface/transformers) so the host can supply them via hostDependencyPaths, then restart the session`,\n\t\t`Download the models manually and place them under ${modelCacheDir} (layout: <modelId>/tokenizer.json + <modelId>/onnx/model*.onnx)`,\n\t\tcurrentMode === \"full\"\n\t\t\t? 'Downgrade to memory.mode \"light\" (much smaller models)'\n\t\t\t: 'Keep memory.mode \"light\" and retry with a reachable mirror',\n\t\t'Give up: leave memory.mode \"off\" (the default) so the memory family stays unregistered',\n\t];\n}\n\n// ---------------------------------------------------------------------------\n// 征询持久化 (capability 拆分战役 slice 3b 随迁, 征询域): agent-dir 配置文件\n// 的读写与征询拒绝/档位落盘。纯函数, 路径域显式传入; capability.ts 经\n// re-export 维持历史导出面, 向量通道 (vector-channel.ts) 直接 import。\n// ---------------------------------------------------------------------------\n\n/** agent-dir 配置文件里的征询拒绝标记值 (memoryConsent 键)。 */\nexport const MEMORY_CONSENT_DECLINED_VALUE = \"declined\";\n/** memory 插件 agent-dir 配置通道 (entry 读、capability 写, 同一路径)。 */\nexport const MEMORY_AGENT_DIR_CONFIG_RELATIVE_PATH = join(\"capabilities\", \"builtin.memory.json\");\n\nfunction readMemoryAgentDirConfig(agentDir: string): Record<string, unknown> {\n\tconst configPath = join(agentDir, MEMORY_AGENT_DIR_CONFIG_RELATIVE_PATH);\n\tif (existsSync(configPath)) {\n\t\ttry {\n\t\t\tconst parsed: unknown = JSON.parse(readFileSync(configPath, \"utf8\"));\n\t\t\tif (parsed !== null && typeof parsed === \"object\" && !Array.isArray(parsed)) {\n\t\t\t\treturn parsed as Record<string, unknown>;\n\t\t\t}\n\t\t} catch {\n\t\t\t// 既有文件非法时以本次写入为准 (持久化是显式用户动作, 不被脏文件阻塞)。\n\t\t}\n\t}\n\treturn {};\n}\n\n/**\n * 写 agent-dir 配置的原子替换 (2026-10-06 复审 P1-2): temp 文件 + rename —\n * 自动升档引入了无人值守写者, 与其它进程的 /memory off (会删档位键) 读改写\n * 交错时, 直接 writeFileSync 可能留下半截 JSON 让并发读者拿到空配置 (整块\n * 丢键: 抹掉并发 decline 或升档)。rename 在同一目录内原子替换, 读者要么见\n * 旧文件要么见新文件。\n */\nfunction writeMemoryAgentDirConfig(agentDir: string, config: Record<string, unknown>): void {\n\tconst configPath = join(agentDir, MEMORY_AGENT_DIR_CONFIG_RELATIVE_PATH);\n\tmkdirSync(dirname(configPath), { recursive: true });\n\tconst tempPath = `${configPath}.${process.pid}.tmp`;\n\twriteFileSync(tempPath, `${JSON.stringify(config, null, \"\\t\")}\\n`, \"utf8\");\n\trenameSync(tempPath, configPath);\n}\n\n/** agent-dir 配置里用户显式持久化的档位键 (无 / 该键即 undefined)。 */\nexport function readMemorySettingsMode(agentDir: string): \"light\" | \"full\" | undefined {\n\tconst value = readMemoryAgentDirConfig(agentDir).memorySettingsMode;\n\treturn value === \"light\" || value === \"full\" ? value : undefined;\n}\n\n/**\n * 拒绝/跳过的持久化 (2026-10-05 用户裁决): 写入插件自己的 agent-dir 配置文件,\n * 不改写用户 settings.json。语义是「用户对默认档说了不」——仅抑制默认档;\n * 用户日后显式设置 settings.json `memory.mode` (light/full) 时显式值仍然生效。\n * 同时移除 /memory light|full 持久化的档位键, 保证\"先升 full 再 off\"不会留下\n * 一个压过 settings 的陈旧档位。\n */\nexport function writeMemoryConsentDeclined(agentDir: string): void {\n\tconst config = readMemoryAgentDirConfig(agentDir);\n\tconfig.memoryConsent = MEMORY_CONSENT_DECLINED_VALUE;\n\tdelete config.memorySettingsMode;\n\tdelete config.memoryMode;\n\twriteMemoryAgentDirConfig(agentDir, config);\n}\n\n/**\n * 档位升级/降级的持久化 (/memory light|full): 写入插件 agent-dir 配置的\n * `memorySettingsMode` 键——与 settings.json `memory.mode` 同一解析层 (持久\n * 配置面, env 仍可临时覆盖)。插件无 settings.json 写通道 (HostCapabilities\n * 无该面), 本文件键在其上, 即命令是比 settings 更近一次的显式表达。同时清\n * 除拒绝标记: 显式升/降档是最新的用户意图, 压过此前的\"对默认档说不\"。\n */\nexport function writeMemorySettingsMode(agentDir: string, mode: \"light\" | \"full\"): void {\n\tconst config = readMemoryAgentDirConfig(agentDir);\n\tconfig.memorySettingsMode = mode;\n\tdelete config.memoryConsent;\n\twriteMemoryAgentDirConfig(agentDir, config);\n}\n"]}

package/dist/memory/hooks.d.ts

@@ -1,17 +1,15 @@
 /**
- * 注入钩子（capability 拆分战役 slice 7）：auto-recall 注入、assistant 偏好卡
- * 注入与 bash 失败教训自动沉淀。钩子经 api 注册面（loop hook + lifecycle
- * observer）订阅, 召回执行闭包/写入 atom 构造/升档旁路经 deps 注入, 不新增
+ * 注入钩子（capability 拆分战役 slice 7）：auto-recall 注入与 assistant 偏好卡
+ * 注入。钩子经 api 注册面（loop hook）订阅, 召回执行闭包经 deps 注入, 不新增
  * 模块级可变状态; 搬移函数体逐字节保留。
+ *
+ * bash 失败教训自动沉淀已停用（记忆归档与整理设计 §9/§14 裁决 1, 实时过程
+ * 无沉淀价值）: 捕获代码与 `AGENT_FORGE_MEMORY_LESSONS` 开关通道整体移除, 自动
+ * 整理改由归档触发的整理器承担（memory/curator.ts）。
  */
 import type { CapabilityAPI, DisposableRegistration } from "@agent-forge/plugin-sdk";
-import type { MemoryAtomV1 } from "./foundation.ts";
-import type { DurableMemoryLedgerV1 } from "./ledger.ts";
-import type { MemoryStoreV1 } from "./store.ts";
 import type { SuiteMemoryDomainV1 } from "./suite-memory.ts";
 import type { MemoryVectorChannelV1 } from "./vector-channel.ts";
-import type { MemoryVectorProjectionV1 } from "./vector-projection.ts";
-import { type MemoryWriteAtomInputV1 } from "./write-face.ts";
 /**
  * Marker text of the auto-recall injection message (B1 记忆自动注入, D-071 增补
  * 裁决自 sdk 迁入; pinned by test/memory-sdk-e2e.test.ts).
@@ -31,80 +29,39 @@ export declare const MEMORY_AUTO_RECALL_DEADLINE_MS = 5000;
  * user and may be outdated. Pinned verbatim by test/memory-error-lessons.test.ts.
  */
 export declare const MEMORY_AUTO_RECALL_DISCLAIMER = "(Recalled automatically from persistent memory for this request \u2014 not written by the user. Recalled items may be outdated; verify against current state before relying on them.)";
-/** bash 失败教训捕获开关取值 (§2.2)。 */
-export type MemoryLessonsSettingV1 = "on" | "off";
-/**
- * lessons 开关解析结果: `invalidEnvValue` 非空 = 配置值非法, 已 fail 回默认 on,
- * 调用方负责以此告警一次。
- */
-export interface MemoryLessonsResolutionV1 {
-    readonly lessons: MemoryLessonsSettingV1;
-    readonly invalidEnvValue?: string;
-}
-/**
- * context.memory.lessons 解析 (§2.2, resolveMemoryMode 同构): 显式值 → 环境变量
- * `AGENT_FORGE_MEMORY_LESSONS` → 默认 on。任何非法配置值回默认并在结果中携带
- * 原值供调用方告警一次, 绝不静默改开关。
- */
-export declare function resolveMemoryLessons(explicitLessons: string | undefined, env?: Readonly<Record<string, string | undefined>>): MemoryLessonsResolutionV1;
 /**
  * 钩子面对 capability 闭包的显式依赖视图 (slice 7): 逐项来自
- * createMemoryCapabilityHarness 的闭包捕获核实。状态机 (vectorChannelCtl)、
- * 写侧投影 (vectorProjection)、写入面闭包 (buildWriteAtom /
- * maybeTierUpgradeAfterWrite) 与召回执行闭包 (recallExecute) 归 capability
- * 装配所有, 本模块经引用消费; capability 模块级纯函数经 deps 注入避免双头定义。
+ * createMemoryCapabilityHarness 的闭包捕获核实。状态机 (vectorChannelCtl) 与
+ * 召回执行闭包 (recallExecute) 归 capability 装配所有, 本模块经引用消费;
+ * capability 模块级纯函数经 deps 注入避免双头定义。
  */
 export interface MemoryHooksDepsV1 {
-    /** capability 日志面 (api.logger): 注入失败/教训捕获诊断。 */
+    /** capability 日志面 (api.logger): 注入失败诊断。 */
     readonly logger: CapabilityAPI["logger"];
     /** 循环钩子注册面 (api.registerLoopHook): transformContext 注入。 */
     readonly registerLoopHook: CapabilityAPI["registerLoopHook"];
-    /** 会话面 (api.session): 分支消息回读 (auto-recall 查询与 bash 命令配对)。 */
+    /** 会话面 (api.session): 分支消息回读 (auto-recall 查询)。 */
     readonly session: CapabilityAPI["session"];
-    /** lifecycle 面 (api.lifecycle): bash 教训 observer 注册 (最小宿主可缺该面)。 */
-    readonly lifecycle: CapabilityAPI["lifecycle"];
     /** 检索行 owner (capability.BUILTIN_MEMORY_OWNER): 偏好卡读边界。 */
     readonly owner: string;
     /** agent 根目录 (MemoryCapabilityContext.agentDir): 偏好卡路径域。 */
     readonly agentDir: string;
     /** 时钟 (harness now): 注入块时间戳。 */
     readonly now: () => number;
-    /** capability 清单 (capabilityManifest): 教训 writeReason 来源。 */
-    readonly manifest: {
-        readonly id: string;
-    };
     readonly isPlainObject: (value: unknown) => value is Record<string, unknown>;
     /** 域解析 (capability.resolveSessionDomain): 偏好卡按会话域懒读 (B1 语义)。 */
     readonly resolveSessionDomain: () => SuiteMemoryDomainV1;
-    /** context.memory.lessons 原样值 (MemoryCapabilityContext.memory?.lessons)。 */
-    readonly lessonsExplicit: string | undefined;
     /** 召回执行闭包 (slice 4 recallPipeline.recallExecute): auto-recall 直连。 */
     readonly recallExecute: (first: unknown, second?: unknown) => Promise<unknown>;
     /** 向量通道 (slice 3b 的 vectorChannelCtl): 征询门只读面。 */
     readonly vectorChannelCtl: MemoryVectorChannelV1;
-    /** 域解析 (capability.resolveDomain): 教训写入时惰性解析 (B1 语义)。 */
-    readonly resolveDomain: () => {
-        readonly domain: SuiteMemoryDomainV1;
-        readonly domainName: string;
-        readonly ledger: DurableMemoryLedgerV1;
-    };
-    /** canonical store (per-capability 单例): 教训 atom 提交。 */
-    readonly store: MemoryStoreV1;
-    /** 写入 atom 构造 (slice 5 writeFace.buildWriteAtom)。 */
-    readonly buildWriteAtom: (input: MemoryWriteAtomInputV1) => MemoryAtomV1;
-    /** 写侧投影 (slice 3a 的 vectorProjection): 教训提交后埋点。 */
-    readonly vectorProjection: MemoryVectorProjectionV1;
-    /** 写后自动升档旁路 (slice 5 writeFace.maybeTierUpgradeAfterWrite)。 */
-    readonly maybeTierUpgradeAfterWrite: () => void;
 }
-/** 钩子面工厂产物: loop 钩子注册项与教训 observer 注册项。 */
+/** 钩子面工厂产物: loop 钩子注册项。 */
 export interface MemoryHooksV1 {
     /** auto-recall transformContext 钩子注册项。 */
     readonly autoRecallHook: DisposableRegistration;
     /** assistant 偏好卡 transformContext 钩子注册项。 */
     readonly preferenceCardHook: DisposableRegistration;
-    /** bash 失败教训 lifecycle observer 注册项 (lessons=off / 缺 lifecycle 面时为空)。 */
-    readonly lessonRegistrations: readonly DisposableRegistration[];
 }
 export declare function createMemoryHooks(deps: MemoryHooksDepsV1): MemoryHooksV1;
 //# sourceMappingURL=hooks.d.ts.map