@sharpee/stdlib 0.9.109 → 0.9.111

package/scope/witness-system.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"witness-system.js","sourceRoot":"","sources":["../../../../../../../repos/sharpee/packages/stdlib/src/scope/witness-system.ts"],"names":[],"mappings":";AAAA;;;;;;GAMG;;;AAEH,sDAAuE;AACvE,wCAA4C;AAC5C,mCAWiB;AAEjB;;GAEG;AACH,MAAa,qBAAqB;IAItB;IACA;IAJF,SAAS,GAA8C,IAAI,GAAG,EAAE,CAAC;IAEzE,YACU,KAAiB,EACjB,aAA4B;QAD5B,UAAK,GAAL,KAAK,CAAY;QACjB,kBAAa,GAAb,aAAa,CAAe;IACnC,CAAC;IAEJ;;OAEG;IACH,eAAe,CAAC,MAAmB;QACjC,MAAM,SAAS,GAAG,IAAI,GAAG,EAAyB,CAAC;QAEnD,uCAAuC;QACvC,MAAM,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,cAAc,EAAE,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CACpD,CAAC,CAAC,GAAG,CAAC,uBAAS,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,EAAE,KAAK,MAAM,CAAC,OAAO,CAClD,CAAC;QAEF,yCAAyC;QACzC,KAAK,MAAM,KAAK,IAAI,MAAM,EAAE,CAAC;YAC3B,MAAM,MAAM,GAAG,IAAI,CAAC,gBAAgB,CAAC,KAAK,EAAE,MAAM,CAAC,CAAC;YACpD,IAAI,MAAM,EAAE,CAAC;gBACX,SAAS,CAAC,GAAG,CAAC,KAAK,CAAC,EAAE,EAAE,MAAM,CAAC,CAAC;YAClC,CAAC;QACH,CAAC;QAED,MAAM,MAAM,GAAkB,EAAE,MAAM,EAAE,SAAS,EAAE,CAAC;QAEpD,+CAA+C;QAC/C,IAAI,CAAC,eAAe,CAAC,MAAM,CAAC,CAAC;QAE7B,OAAO,MAAM,CAAC;IAChB,CAAC;IAED;;OAEG;IACH,eAAe,CAAC,MAAqB;QACnC,KAAK,MAAM,CAAC,OAAO,EAAE,MAAM,CAAC,IAAI,MAAM,CAAC,SAAS,EAAE,CAAC;YACjD,sCAAsC;YACtC,IAAI,CAAC,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,OAAO,CAAC,EAAE,CAAC;gBACjC,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,OAAO,EAAE,IAAI,GAAG,EAAE,CAAC,CAAC;YACzC,CAAC;YACD,MAAM,cAAc,GAAG,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,OAAO,CAAE,CAAC;YAEpD,wCAAwC;YACxC,QAAQ,MAAM,CAAC,MAAM,CAAC,IAAI,EAAE,CAAC;gBAC3B,KAAK,MAAM;oBACT,IAAI,CAAC,uBAAuB,CAAC,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;oBAC7D,MAAM;gBACR,KAAK,QAAQ;oBACX,IAAI,CAAC,wBAAwB,CAAC,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;oBAC9D,MAAM;gBACR,KAAK,SAAS;oBACZ,IAAI,CAAC,0BAA0B,CAAC,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;oBAChE,MAAM;gBACR,KAAK,QAAQ;oBACX,IAAI,CAAC,2BAA2B,CAAC,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;oBACjE,MAAM;gBACR,KAAK,QAAQ;oBACX,IAAI,CAAC,qBAAqB,CAAC,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;oBAC3D,MAAM;YACV,CAAC;YAED,sBAAsB;YACtB,IAAI,CAAC,gBAAgB,CAAC,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;QACxD,CAAC;IACH,CAAC;IAED;;OAEG;IACH,gBAAgB,CAAC,OAAe;QAC9B,MAAM,cAAc,GAAG,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC;QACnD,IAAI,CAAC,cAAc;YAAE,OAAO,EAAE,CAAC;QAE/B,OAAO,KAAK,CAAC,IAAI,CAAC,cAAc,CAAC,MAAM,EAAE,CAAC,CAAC;IAC7C,CAAC;IAED;;OAEG;IACH,aAAa,CAAC,OAAe,EAAE,QAAgB;QAC7C,MAAM,cAAc,GAAG,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC;QACnD,IAAI,CAAC,cAAc;YAAE,OAAO,KAAK,CAAC;QAElC,MAAM,SAAS,GAAG,cAAc,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC;QAC/C,OAAO,SAAS,EAAE,MAAM,KAAK,IAAI,CAAC;IACpC,CAAC;IAED;;OAEG;IACH,YAAY,CAAC,OAAe,EAAE,QAAgB;QAC5C,MAAM,cAAc,GAAG,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC;QACnD,IAAI,CAAC,cAAc;YAAE,OAAO,SAAS,CAAC;QAEtC,OAAO,cAAc,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC;IACtC,CAAC;IAED;;OAEG;IACK,gBAAgB,CAAC,KAAe,EAAE,MAAmB;QAC3D,MAAM,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,SAAS,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC;QACrD,IAAI,CAAC,MAAM;YAAE,OAAO,IAAI,CAAC;QAEzB,wBAAwB;QACxB,IAAI,IAAI,CAAC,aAAa,CAAC,MAAM,CAAC,KAAK,EAAE,MAAM,CAAC,EAAE,CAAC;YAC7C,OAAO;gBACL,OAAO,EAAE,KAAK,CAAC,EAAE;gBACjB,KAAK,EAAE,iBAAS,CAAC,KAAK;gBACtB,KAAK,EAAE,IAAI,CAAC,qBAAqB,CAAC,KAAK,EAAE,MAAM,EAAE,iBAAS,CAAC,KAAK,CAAC;gBACjE,UAAU,EAAE,SAAS;aACtB,CAAC;QACJ,CAAC;QAED,IAAI,IAAI,CAAC,aAAa,CAAC,OAAO,CAAC,KAAK,EAAE,MAAM,CAAC,EAAE,CAAC;YAC9C,OAAO;gBACL,OAAO,EAAE,KAAK,CAAC,EAAE;gBACjB,KAAK,EAAE,iBAAS,CAAC,OAAO;gBACxB,KAAK,EAAE,IAAI,CAAC,qBAAqB,CAAC,KAAK,EAAE,MAAM,EAAE,iBAAS,CAAC,OAAO,CAAC;gBACnE,UAAU,EAAE,QAAQ;aACrB,CAAC;QACJ,CAAC;QAED,IAAI,IAAI,CAAC,aAAa,CAAC,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC,EAAE,CAAC;YAC/C,OAAO;gBACL,OAAO,EAAE,KAAK,CAAC,EAAE;gBACjB,KAAK,EAAE,iBAAS,CAAC,KAAK;gBACtB,KAAK,EAAE,IAAI,CAAC,qBAAqB,CAAC,KAAK,EAAE,MAAM,EAAE,iBAAS,CAAC,KAAK,CAAC;gBACjE,UAAU,EAAE,QAAQ;aACrB,CAAC;QACJ,CAAC;QAED,OAAO,IAAI,CAAC;IACd,CAAC;IAED;;OAEG;IACK,qBAAqB,CAAC,KAAe,EAAE,MAAgB,EAAE,KAAgB;QAC/E,6DAA6D;QAC7D,IAAI,KAAK,KAAK,iBAAS,CAAC,KAAK,EAAE,CAAC;YAC9B,IAAI,IAAI,CAAC,aAAa,CAAC,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC,EAAE,CAAC;gBAC/C,OAAO,oBAAY,CAAC,IAAI,CAAC;YAC3B,CAAC;YACD,OAAO,oBAAY,CAAC,OAAO,CAAC;QAC9B,CAAC;QAED,uCAAuC;QACvC,gDAAgD;QAChD,OAAO,oBAAY,CAAC,OAAO,CAAC;IAC9B,CAAC;IAED;;OAEG;IACK,uBAAuB,CAAC,OAAe,EAAE,MAAmB,EAAE,MAAqB;QACzF,MAAM,cAAc,GAAG,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,OAAO,CAAE,CAAC;QAEpD,iCAAiC;QACjC,IAAI,SAAS,GAAG,cAAc,CAAC,GAAG,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC;QACpD,IAAI,CAAC,SAAS,EAAE,CAAC;YACf,SAAS,GAAG,IAAI,CAAC,sBAAsB,CAAC,MAAM,CAAC,QAAQ,EAAE,MAAM,CAAC,CAAC;YACjE,cAAc,CAAC,GAAG,CAAC,MAAM,CAAC,QAAQ,EAAE,SAAS,CAAC,CAAC;QACjD,CAAC;QAED,uCAAuC;QACvC,IAAI,MAAM,CAAC,EAAE,EAAE,CAAC;YACd,SAAS,CAAC,iBAAiB,GAAG,MAAM,CAAC,EAAE,CAAC;QAC1C,CAAC;QAED,0BAA0B;QAC1B,IAAI,MAAM,CAAC,IAAI,IAAI,MAAM,CAAC,EAAE,EAAE,CAAC;YAC7B,IAAI,CAAC,SAAS,CAAC,eAAe,EAAE,CAAC;gBAC/B,SAAS,CAAC,eAAe,GAAG,EAAE,CAAC;YACjC,CAAC;YAED,SAAS,CAAC,eAAe,CAAC,IAAI,CAAC;gBAC7B,IAAI,EAAE,MAAM,CAAC,IAAI;gBACjB,EAAE,EAAE,MAAM,CAAC,EAAE;gBACb,WAAW,EAAE,MAAM,CAAC,SAAS;gBAC7B,WAAW,EAAE,MAAM,CAAC,KAAK;gBACzB,UAAU,EAAE,MAAM,CAAC,UAAU;aAC9B,CAAC,CAAC;YAEH,qBAAqB;YACrB,IAAI,SAAS,CAAC,eAAe,CAAC,MAAM,GAAG,EAAE,EAAE,CAAC;gBAC1C,SAAS,CAAC,eAAe,CAAC,KAAK,EAAE,CAAC;YACpC,CAAC;QACH,CAAC;QAED,mCAAmC;QACnC,IAAI,CAAC,qBAAqB,CAAC,SAAS,EAAE,MAAM,EAAE,MAAM,CAAC,SAAS,CAAC,CAAC;IAClE,CAAC;IAED;;OAEG;IACK,wBAAwB,CAAC,OAAe,EAAE,MAAmB,EAAE,MAAqB;QAC1F,MAAM,cAAc,GAAG,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,OAAO,CAAE,CAAC;QAEpD,6BAA6B;QAC7B,MAAM,SAAS,GAAG,IAAI,CAAC,sBAAsB,CAAC,MAAM,CAAC,QAAQ,EAAE,MAAM,CAAC,CAAC;QACvE,SAAS,CAAC,MAAM,GAAG,IAAI,CAAC;QACxB,SAAS,CAAC,YAAY,GAAG,MAAM,CAAC,SAAS,CAAC;QAC1C,SAAS,CAAC,YAAY,GAAG,MAAM,CAAC,KAAK,CAAC;QAEtC,cAAc,CAAC,GAAG,CAAC,MAAM,CAAC,QAAQ,EAAE,SAAS,CAAC,CAAC;IACjD,CAAC;IAED;;OAEG;IACK,0BAA0B,CAAC,OAAe,EAAE,MAAmB,EAAE,MAAqB;QAC5F,MAAM,cAAc,GAAG,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,OAAO,CAAE,CAAC;QACpD,MAAM,SAAS,GAAG,cAAc,CAAC,GAAG,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC;QAEtD,IAAI,SAAS,EAAE,CAAC;YACd,SAAS,CAAC,MAAM,GAAG,KAAK,CAAC;YACzB,IAAI,CAAC,qBAAqB,CAAC,SAAS,EAAE,MAAM,EAAE,MAAM,CAAC,SAAS,CAAC,CAAC;QAClE,CAAC;IACH,CAAC;IAED;;OAEG;IACK,2BAA2B,CAAC,OAAe,EAAE,MAAmB,EAAE,MAAqB;QAC7F,MAAM,cAAc,GAAG,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,OAAO,CAAE,CAAC;QACpD,IAAI,SAAS,GAAG,cAAc,CAAC,GAAG,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC;QAEpD,IAAI,CAAC,SAAS,EAAE,CAAC;YACf,SAAS,GAAG,IAAI,CAAC,sBAAsB,CAAC,MAAM,CAAC,QAAQ,EAAE,MAAM,CAAC,CAAC;YACjE,cAAc,CAAC,GAAG,CAAC,MAAM,CAAC,QAAQ,EAAE,SAAS,CAAC,CAAC;QACjD,CAAC;QAED,iDAAiD;QACjD,IAAI,MAAM,CAAC,KAAK,KAAK,iBAAS,CAAC,KAAK,IAAI,MAAM,CAAC,QAAQ,EAAE,CAAC;YACxD,IAAI,CAAC,SAAS,CAAC,gBAAgB,EAAE,CAAC;gBAChC,SAAS,CAAC,gBAAgB,GAAG,IAAI,GAAG,EAAE,CAAC;YACzC,CAAC;YACD,SAAS,CAAC,gBAAgB,CAAC,GAAG,CAAC,MAAM,CAAC,QAAQ,EAAE,MAAM,CAAC,QAAQ,CAAC,CAAC;QACnE,CAAC;QAED,IAAI,CAAC,qBAAqB,CAAC,SAAS,EAAE,MAAM,EAAE,MAAM,CAAC,SAAS,CAAC,CAAC;IAClE,CAAC;IAED;;OAEG;IACK,qBAAqB,CAAC,OAAe,EAAE,MAAmB,EAAE,MAAqB;QACvF,8DAA8D;QAC9D,4DAA4D;QAC5D,MAAM,cAAc,GAAG,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,OAAO,CAAE,CAAC;QAEpD,uDAAuD;QACvD,IAAI,MAAM,CAAC,OAAO,IAAI,MAAM,CAAC,OAAO,KAAK,OAAO,EAAE,CAAC;YACjD,IAAI,oBAAoB,GAAG,cAAc,CAAC,GAAG,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;YAC9D,IAAI,CAAC,oBAAoB,EAAE,CAAC;gBAC1B,oBAAoB,GAAG,IAAI,CAAC,sBAAsB,CAAC,MAAM,CAAC,OAAO,EAAE,MAAM,CAAC,CAAC;gBAC3E,cAAc,CAAC,GAAG,CAAC,MAAM,CAAC,OAAO,EAAE,oBAAoB,CAAC,CAAC;YAC3D,CAAC;YACD,IAAI,CAAC,qBAAqB,CAAC,oBAAoB,EAAE,MAAM,EAAE,MAAM,CAAC,SAAS,CAAC,CAAC;QAC7E,CAAC;QAED,kCAAkC;QAClC,IAAI,MAAM,CAAC,MAAM,EAAE,CAAC;YAClB,IAAI,eAAe,GAAG,cAAc,CAAC,GAAG,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC;YACxD,IAAI,CAAC,eAAe,EAAE,CAAC;gBACrB,eAAe,GAAG,IAAI,CAAC,sBAAsB,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;gBACrE,cAAc,CAAC,GAAG,CAAC,MAAM,CAAC,MAAM,EAAE,eAAe,CAAC,CAAC;YACrD,CAAC;YACD,IAAI,CAAC,qBAAqB,CAAC,eAAe,EAAE,MAAM,EAAE,MAAM,CAAC,SAAS,CAAC,CAAC;QACxE,CAAC;IACH,CAAC;IAED;;OAEG;IACK,sBAAsB,CAAC,QAAgB,EAAE,MAAqB;QACpE,OAAO;YACL,QAAQ;YACR,MAAM,EAAE,IAAI;YACZ,YAAY,EAAE,IAAI,CAAC,GAAG,EAAE;YACxB,YAAY,EAAE,MAAM,CAAC,KAAK;SAC3B,CAAC;IACJ,CAAC;IAED;;OAEG;IACK,qBAAqB,CAAC,SAA0B,EAAE,MAAqB,EAAE,SAAiB;QAChG,QAAQ,MAAM,CAAC,KAAK,EAAE,CAAC;YACrB,KAAK,iBAAS,CAAC,KAAK;gBAClB,SAAS,CAAC,QAAQ,GAAG,SAAS,CAAC;gBAC/B,MAAM;YACR,KAAK,iBAAS,CAAC,OAAO;gBACpB,SAAS,CAAC,SAAS,GAAG,SAAS,CAAC;gBAChC,MAAM;YACR,KAAK,iBAAS,CAAC,KAAK;gBAClB,SAAS,CAAC,WAAW,GAAG,SAAS,CAAC;gBAClC,SAAS,CAAC,aAAa,GAAG,UAAU,CAAC,CAAC,oCAAoC;gBAC1E,MAAM;QACV,CAAC;IACH,CAAC;IAED;;OAEG;IACK,gBAAgB,CAAC,OAAe,EAAE,MAAmB,EAAE,MAAqB;QAClF,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,SAAS,CAAC,OAAO,CAAC,CAAC;QAC5C,IAAI,CAAC,KAAK;YAAE,OAAO;QAEnB,IAAI,KAAK,GAAwB,IAAI,CAAC;QAEtC,QAAQ,MAAM,CAAC,IAAI,EAAE,CAAC;YACpB,KAAK,QAAQ;gBACX,KAAK,GAAG;oBACN,IAAI,EAAE,mBAAmB;oBACzB,IAAI,EAAE;wBACJ,SAAS,EAAE,OAAO;wBAClB,KAAK,EAAE,MAAM,CAAC,KAAK;wBACnB,KAAK,EAAE,MAAM,CAAC,KAAK;wBACnB,MAAM,EAAE,MAAM,CAAC,MAAM,IAAI,EAAE;wBAC3B,OAAO,EAAE,MAAM,CAAC,OAAO,IAAI,EAAE;wBAC7B,QAAQ,EAAE,MAAM,CAAC,MAAM;wBACvB,YAAY,EAAE,MAAM,CAAC,IAAI;wBACzB,UAAU,EAAE,MAAM,CAAC,EAAE;wBACrB,SAAS,EAAE,MAAM,CAAC,SAAS;qBAC5B;iBACF,CAAC;gBACF,MAAM;YAER,KAAK,MAAM;gBACT,KAAK,GAAG;oBACN,IAAI,EAAE,qBAAqB;oBAC3B,IAAI,EAAE;wBACJ,SAAS,EAAE,OAAO;wBAClB,KAAK,EAAE,MAAM,CAAC,KAAK;wBACnB,KAAK,EAAE,MAAM,CAAC,KAAK;wBACnB,QAAQ,EAAE,MAAM,CAAC,KAAK,KAAK,oBAAY,CAAC,IAAI,CAAC,CAAC,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC,CAAC,SAAS;wBAC1E,YAAY,EAAE,MAAM,CAAC,IAAI,IAAI,EAAE;wBAC/B,UAAU,EAAE,MAAM,CAAC,EAAE,IAAI,EAAE;wBAC3B,SAAS,EAAE,IAAI,CAAC,YAAY,CAAC,MAAM,CAAC,IAAI,EAAE,MAAM,CAAC,EAAE,CAAC;wBACpD,SAAS,EAAE,MAAM,CAAC,SAAS;qBAC5B;iBACF,CAAC;gBACF,MAAM;YAER,2DAA2D;QAC7D,CAAC;QAED,IAAI,KAAK,EAAE,CAAC;YACV,qCAAqC;YACrC,MAAM,SAAS,GAAQ,EAAE,KAAK,EAAE,KAAK,CAAC,EAAE,EAAE,CAAC;YAC3C,IAAI,MAAM,CAAC,QAAQ;gBAAE,SAAS,CAAC,MAAM,GAAG,MAAM,CAAC,QAAQ,CAAC;YACxD,IAAI,MAAM,CAAC,MAAM;gBAAE,SAAS,CAAC,MAAM,GAAG,MAAM,CAAC,MAAM,CAAC;YAEpD,IAAA,kBAAW,EAAC,KAAK,CAAC,IAAI,EAAE,KAAK,CAAC,IAA+B,EAAE,SAAS,CAAC,CAAC;QAC5E,CAAC;IACH,CAAC;IAED;;OAEG;IACK,YAAY,CAAC,IAAa,EAAE,EAAW;QAC7C,yEAAyE;QACzE,4BAA4B;QAC5B,OAAO,SAAS,CAAC;IACnB,CAAC;CACF;AApXD,sDAoXC"}

package/services/PerceptionService.d.ts

@@ -0,0 +1,80 @@
+/**
+ * PerceptionService - Filters events based on what the player can perceive
+ *
+ * This service sits between action execution and the text service, transforming
+ * events that describe things the player cannot perceive (due to darkness,
+ * blindness, etc.) into appropriate alternative events.
+ *
+ * @see ADR-069 Perception-Based Event Filtering
+ */
+import { ISemanticEvent } from "../../core/index";
+import { IFEntity, IWorldModel } from "../../world-model/index";
+export type { Sense, PerceptionBlockReason, PerceptionBlockedData, IPerceptionService, } from "../../if-services/index";
+import type { Sense, IPerceptionService } from "../../if-services/index";
+/**
+ * Default implementation of IPerceptionService
+ *
+ * Filters events based on environmental and actor state:
+ * - Darkness (room is dark, no light source)
+ * - Blindness (future: actor has blind trait)
+ * - Blindfold (future: actor wearing something over eyes)
+ */
+export declare class PerceptionService implements IPerceptionService {
+    /**
+     * Filter events based on what the actor can perceive.
+     *
+     * Visual events (room descriptions, contents lists) are transformed
+     * into perception-blocked events when the player cannot see.
+     */
+    filterEvents(events: ISemanticEvent[], actor: IFEntity, world: IWorldModel): ISemanticEvent[];
+    /**
+     * Check if an actor can perceive using a specific sense.
+     */
+    canPerceive(actor: IFEntity, location: IFEntity, world: IWorldModel, sense: Sense): boolean;
+    /**
+     * Check if actor can see in the given location.
+     *
+     * Checks (in order):
+     * 1. Actor blindness trait
+     * 2. Actor wearing blindfold
+     * 3. Location darkness (via VisibilityBehavior)
+     */
+    private canSeeVisually;
+    /**
+     * Check if actor can hear. Currently always true (future extension point).
+     */
+    private canHear;
+    /**
+     * Check if actor can smell. Currently always true (future extension point).
+     */
+    private canSmell;
+    /**
+     * Check if actor can touch. Currently always true (future extension point).
+     */
+    private canTouch;
+    /**
+     * Check if an actor has a blindness trait.
+     */
+    private isBlind;
+    /**
+     * Check if an actor is wearing something that blocks vision.
+     */
+    private isWearingBlindfold;
+    /**
+     * Get the room an actor is currently in.
+     */
+    private getActorRoom;
+    /**
+     * Check if an event requires visual perception.
+     */
+    private isVisualEvent;
+    /**
+     * Create a perception-blocked event to replace a filtered event.
+     */
+    private createPerceptionBlockedEvent;
+    /**
+     * Determine why perception is blocked.
+     */
+    private getBlockReason;
+}
+//# sourceMappingURL=PerceptionService.d.ts.map

package/services/PerceptionService.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"PerceptionService.d.ts","sourceRoot":"","sources":["../../../../../../repos/sharpee/packages/stdlib/src/services/PerceptionService.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,EAAE,cAAc,EAAE,MAAM,eAAe,CAAC;AAC/C,OAAO,EAAE,QAAQ,EAAE,WAAW,EAAkC,MAAM,sBAAsB,CAAC;AAG7F,YAAY,EACV,KAAK,EACL,qBAAqB,EACrB,qBAAqB,EACrB,kBAAkB,GACnB,MAAM,sBAAsB,CAAC;AAE9B,OAAO,KAAK,EACV,KAAK,EAGL,kBAAkB,EACnB,MAAM,sBAAsB,CAAC;AAE9B;;;;;;;GAOG;AACH,qBAAa,iBAAkB,YAAW,kBAAkB;IAC1D;;;;;OAKG;IACH,YAAY,CACV,MAAM,EAAE,cAAc,EAAE,EACxB,KAAK,EAAE,QAAQ,EACf,KAAK,EAAE,WAAW,GACjB,cAAc,EAAE;IAwBnB;;OAEG;IACH,WAAW,CACT,KAAK,EAAE,QAAQ,EACf,QAAQ,EAAE,QAAQ,EAClB,KAAK,EAAE,WAAW,EAClB,KAAK,EAAE,KAAK,GACX,OAAO;IAeV;;;;;;;OAOG;IACH,OAAO,CAAC,cAAc;IAwBtB;;OAEG;IACH,OAAO,CAAC,OAAO;IASf;;OAEG;IACH,OAAO,CAAC,QAAQ;IAQhB;;OAEG;IACH,OAAO,CAAC,QAAQ;IAQhB;;OAEG;IACH,OAAO,CAAC,OAAO;IAMf;;OAEG;IACH,OAAO,CAAC,kBAAkB;IAM1B;;OAEG;IACH,OAAO,CAAC,YAAY;IAIpB;;OAEG;IACH,OAAO,CAAC,aAAa;IAsBrB;;OAEG;IACH,OAAO,CAAC,4BAA4B;IAsBpC;;OAEG;IACH,OAAO,CAAC,cAAc;CAmBvB"}

package/services/PerceptionService.js

@@ -0,0 +1,185 @@
+"use strict";
+/**
+ * PerceptionService - Filters events based on what the player can perceive
+ *
+ * This service sits between action execution and the text service, transforming
+ * events that describe things the player cannot perceive (due to darkness,
+ * blindness, etc.) into appropriate alternative events.
+ *
+ * @see ADR-069 Perception-Based Event Filtering
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.PerceptionService = void 0;
+const world_model_1 = require("../../world-model/index.js");
+/**
+ * Default implementation of IPerceptionService
+ *
+ * Filters events based on environmental and actor state:
+ * - Darkness (room is dark, no light source)
+ * - Blindness (future: actor has blind trait)
+ * - Blindfold (future: actor wearing something over eyes)
+ */
+class PerceptionService {
+    /**
+     * Filter events based on what the actor can perceive.
+     *
+     * Visual events (room descriptions, contents lists) are transformed
+     * into perception-blocked events when the player cannot see.
+     */
+    filterEvents(events, actor, world) {
+        const location = this.getActorRoom(actor, world);
+        if (!location) {
+            return events; // Can't determine location, pass through
+        }
+        const canSee = this.canPerceive(actor, location, world, 'sight');
+        return events.map((event) => {
+            // Only filter visual events
+            if (!this.isVisualEvent(event)) {
+                return event;
+            }
+            // If player can see, pass through unchanged
+            if (canSee) {
+                return event;
+            }
+            // Transform to perception-blocked event
+            return this.createPerceptionBlockedEvent(event, actor, location, world);
+        });
+    }
+    /**
+     * Check if an actor can perceive using a specific sense.
+     */
+    canPerceive(actor, location, world, sense) {
+        switch (sense) {
+            case 'sight':
+                return this.canSeeVisually(actor, location, world);
+            case 'hearing':
+                return this.canHear(actor, location, world);
+            case 'smell':
+                return this.canSmell(actor, location, world);
+            case 'touch':
+                return this.canTouch(actor, location, world);
+            default:
+                return true;
+        }
+    }
+    /**
+     * Check if actor can see in the given location.
+     *
+     * Checks (in order):
+     * 1. Actor blindness trait
+     * 2. Actor wearing blindfold
+     * 3. Location darkness (via VisibilityBehavior)
+     */
+    canSeeVisually(actor, location, world) {
+        // Check actor state first
+        if (this.isBlind(actor)) {
+            return false;
+        }
+        if (this.isWearingBlindfold(actor, world)) {
+            return false;
+        }
+        // Check environmental darkness
+        // Note: VisibilityBehavior.isDark expects a concrete WorldModel
+        // We cast here since IWorldModel is compatible
+        if (world_model_1.VisibilityBehavior.isDark(location, world)) {
+            return false;
+        }
+        return true;
+    }
+    /**
+     * Check if actor can hear. Currently always true (future extension point).
+     */
+    canHear(_actor, _location, _world) {
+        // Future: check deafness trait, earplugs, etc.
+        return true;
+    }
+    /**
+     * Check if actor can smell. Currently always true (future extension point).
+     */
+    canSmell(_actor, _location, _world) {
+        return true;
+    }
+    /**
+     * Check if actor can touch. Currently always true (future extension point).
+     */
+    canTouch(_actor, _location, _world) {
+        return true;
+    }
+    /**
+     * Check if an actor has a blindness trait.
+     */
+    isBlind(_actor) {
+        // Future: check for BLIND trait
+        // For now, no actors are blind
+        return false;
+    }
+    /**
+     * Check if an actor is wearing something that blocks vision.
+     */
+    isWearingBlindfold(_actor, _world) {
+        // Future: check worn items for blindfold trait
+        // For now, no items are blindfolds
+        return false;
+    }
+    /**
+     * Get the room an actor is currently in.
+     */
+    getActorRoom(actor, world) {
+        return world.getContainingRoom(actor.id) || null;
+    }
+    /**
+     * Check if an event requires visual perception.
+     */
+    isVisualEvent(event) {
+        // Room descriptions always require sight
+        if (event.type === 'if.event.room.description') {
+            return true;
+        }
+        // Contents lists require sight
+        if (event.type === 'if.event.contents.listed') {
+            return true;
+        }
+        // action.success with contents_list messageId requires sight
+        if (event.type === 'action.success') {
+            const data = event.data;
+            if (data?.messageId === 'contents_list') {
+                return true;
+            }
+        }
+        return false;
+    }
+    /**
+     * Create a perception-blocked event to replace a filtered event.
+     */
+    createPerceptionBlockedEvent(originalEvent, actor, location, world) {
+        const reason = this.getBlockReason(actor, location, world);
+        const blockedData = {
+            originalType: originalEvent.type,
+            reason,
+            sense: 'sight',
+            originalData: originalEvent.data,
+        };
+        return {
+            ...originalEvent,
+            type: 'if.event.perception.blocked',
+            data: blockedData,
+        };
+    }
+    /**
+     * Determine why perception is blocked.
+     */
+    getBlockReason(actor, location, world) {
+        if (this.isBlind(actor)) {
+            return 'blindness';
+        }
+        if (this.isWearingBlindfold(actor, world)) {
+            return 'blindfolded';
+        }
+        if (world_model_1.VisibilityBehavior.isDark(location, world)) {
+            return 'darkness';
+        }
+        return 'unknown';
+    }
+}
+exports.PerceptionService = PerceptionService;
+//# sourceMappingURL=PerceptionService.js.map

package/services/PerceptionService.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"PerceptionService.js","sourceRoot":"","sources":["../../../../../../../repos/sharpee/packages/stdlib/src/services/PerceptionService.ts"],"names":[],"mappings":"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"}

package/services/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../../repos/sharpee/packages/stdlib/src/services/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EACL,kBAAkB,EAClB,KAAK,EACL,iBAAiB,EACjB,qBAAqB,EACrB,qBAAqB,GACtB,MAAM,qBAAqB,CAAC"}

package/services/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../../../../repos/sharpee/packages/stdlib/src/services/index.ts"],"names":[],"mappings":";AAAA;;GAEG;;;AAEH,yDAM6B;AAH3B,sHAAA,iBAAiB,OAAA"}

package/services/scoring/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../repos/sharpee/packages/stdlib/src/services/scoring/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EACL,eAAe,EACf,cAAc,EACd,oBAAoB,EACpB,iBAAiB,EACjB,UAAU,EACV,cAAc,EACd,aAAa,GACd,MAAM,mBAAmB,CAAC;AAE3B,OAAO,EACL,qBAAqB,EACrB,2BAA2B,EAC3B,cAAc,EACd,eAAe,EACf,YAAY,EACZ,cAAc,EACd,aAAa,EACb,aAAa,EACb,UAAU,EACV,YAAY,EACZ,YAAY,EACZ,qBAAqB,GACtB,MAAM,2BAA2B,CAAC"}

package/services/scoring/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../../repos/sharpee/packages/stdlib/src/services/scoring/index.ts"],"names":[],"mappings":";AAAA;;GAEG;;;AAEH,qDAQ2B;AANzB,iHAAA,cAAc,OAAA;AAKd,gHAAA,aAAa,OAAA;AAGf,qEAamC;AAZjC,gIAAA,qBAAqB,OAAA"}

package/services/scoring/scoring-event-processor.d.ts

@@ -0,0 +1,337 @@
+/**
+ * ScoringEventProcessor - Declarative scoring hooks for common patterns
+ *
+ * Provides a clean API for story authors to configure scoring without
+ * manually wiring event handlers. Supports:
+ * - Treasure scoring (take points + container bonus)
+ * - Room visit scoring (first-visit points)
+ * - Event sequences (ordered chains like rituals)
+ * - Aggregate goals (collect all X)
+ * - Conditional unlocks (state changes when conditions met)
+ *
+ * @see docs/work/scoring/assessment.md
+ */
+import { IWorldModel } from "../../../world-model/index";
+import { ISemanticEvent } from "../../../core/index";
+import { IScoringService } from './scoring-service';
+/**
+ * Interface for event processor registration
+ * Matches the EventProcessor.registerHandler signature
+ */
+export interface IEventProcessorRegistration {
+    registerHandler(eventType: string, handler: (event: ISemanticEvent, query: unknown) => unknown[]): void;
+}
+/**
+ * Configuration for a treasure's scoring behavior
+ */
+export interface TreasureConfig {
+    /** Entity ID of the treasure */
+    entityId: string;
+    /** Points awarded when first taking the treasure */
+    takePoints?: number;
+    /** Points awarded when placing in the scoring container */
+    containerPoints?: number;
+    /** Entity ID of the container that awards bonus points (e.g., trophy case) */
+    containerId?: string;
+}
+/**
+ * Configuration for room visit scoring
+ */
+export interface RoomVisitConfig {
+    /** Room entity ID */
+    roomId: string;
+    /** Points awarded on first visit */
+    points: number;
+}
+/**
+ * A step in an event sequence
+ */
+export interface SequenceStep {
+    /** Event type to match (e.g., 'if.event.taken') */
+    event: string;
+    /** Filter to match event data (all properties must match) */
+    filter?: Record<string, unknown>;
+    /** Optional name for this step (for debugging/display) */
+    name?: string;
+}
+/**
+ * Configuration for an event sequence (chained events)
+ */
+export interface SequenceConfig {
+    /** Ordered steps that must happen in sequence */
+    steps: SequenceStep[];
+    /** Number of turns before sequence resets (optional) */
+    timeout?: number;
+    /** Called when sequence completes */
+    onComplete: (processor: ScoringEventProcessor) => void;
+    /** Called after each step completes (optional) */
+    onStep?: (stepIndex: number, processor: ScoringEventProcessor) => void;
+    /** Whether sequence can be repeated (default: false) */
+    repeatable?: boolean;
+}
+/**
+ * Condition types for goals and unlocks
+ */
+export type GoalCondition = {
+    type: 'item_in_container';
+    itemId: string;
+    containerId: string;
+} | {
+    type: 'item_taken';
+    itemId: string;
+} | {
+    type: 'room_visited';
+    roomId: string;
+} | {
+    type: 'achievement';
+    id: string;
+} | {
+    type: 'sequence_complete';
+    sequenceId: string;
+} | {
+    type: 'score_reached';
+    score: number;
+} | {
+    type: 'custom';
+    check: (world: IWorldModel) => boolean;
+};
+/**
+ * Configuration for an aggregate goal
+ */
+export interface GoalConfig {
+    /** Human-readable description */
+    description?: string;
+    /** List of conditions that must all be met */
+    conditions?: GoalCondition[];
+    /** Dynamic condition function (alternative to conditions list) */
+    conditionFn?: (world: IWorldModel) => boolean;
+    /** Called when goal is completed */
+    onComplete: (processor: ScoringEventProcessor) => void;
+    /** Called when progress changes (optional) */
+    onProgress?: (progress: GoalProgress, processor: ScoringEventProcessor) => void;
+}
+/**
+ * Configuration for a conditional unlock
+ */
+export interface UnlockConfig {
+    /** Conditions that trigger the unlock */
+    conditions: GoalCondition[];
+    /** Called when unlock triggers */
+    onUnlock: (processor: ScoringEventProcessor) => void;
+}
+/**
+ * Runtime state for a sequence
+ */
+export interface SequenceState {
+    /** Current step index (0-based) */
+    currentStep: number;
+    /** Turn when last step was completed */
+    lastStepTurn: number;
+    /** Whether sequence has been completed */
+    completed: boolean;
+}
+/**
+ * Progress information for a goal
+ */
+export interface GoalProgress {
+    /** Number of conditions met */
+    completed: number;
+    /** Total number of conditions */
+    total: number;
+    /** Percentage complete (0-100) */
+    percentage: number;
+    /** IDs of remaining conditions (for condition lists) */
+    remaining: string[];
+    /** Whether goal is fully complete */
+    isComplete: boolean;
+}
+/**
+ * Serializable state for save/restore
+ */
+export interface ScoringProcessorState {
+    /** Set of treasures that have been taken (for take points) */
+    takenTreasures: string[];
+    /** Set of treasures placed in scoring container (for container points) */
+    containerTreasures: string[];
+    /** Set of rooms visited (for visit points) */
+    visitedRooms: string[];
+    /** Sequence states by ID */
+    sequences: Record<string, SequenceState>;
+    /** Set of completed goals */
+    completedGoals: string[];
+    /** Set of triggered unlocks */
+    triggeredUnlocks: string[];
+    /** Current turn count (for sequence timeouts) */
+    currentTurn: number;
+}
+/**
+ * Event processor for declarative scoring configuration
+ */
+export declare class ScoringEventProcessor {
+    private scoringService;
+    private world;
+    private treasures;
+    private roomVisits;
+    private sequences;
+    private goals;
+    private unlocks;
+    private takenTreasures;
+    private containerTreasures;
+    private visitedRooms;
+    private sequenceStates;
+    private completedGoals;
+    private triggeredUnlocks;
+    private currentTurn;
+    private defaultContainerId?;
+    private dynamicTreasureMode;
+    private dynamicContainerName?;
+    private onTreasureTake?;
+    private onTreasurePlace?;
+    constructor(scoringService: IScoringService, world: IWorldModel);
+    /**
+     * Set the default container for treasure bonus points
+     */
+    setDefaultContainer(containerId: string): this;
+    /**
+     * Enable dynamic treasure mode - detects treasures by entity properties
+     * instead of explicit registration.
+     *
+     * In this mode, entities with these properties are treated as treasures:
+     * - isTreasure: boolean (must be true)
+     * - treasureValue: number (points for taking)
+     * - trophyCaseValue: number (points for placing in container)
+     * - treasureId: string (unique ID, defaults to entity ID)
+     *
+     * @param containerName - Name of the scoring container (e.g., 'trophy case')
+     */
+    enableDynamicTreasures(containerName: string): this;
+    /**
+     * Set custom callback for treasure take scoring
+     * Use this to integrate with story-specific scoring services
+     */
+    setTreasureTakeCallback(callback: (treasureId: string, points: number) => void): this;
+    /**
+     * Set custom callback for treasure placement scoring
+     * Use this to integrate with story-specific scoring services
+     */
+    setTreasurePlaceCallback(callback: (treasureId: string, points: number) => void): this;
+    /**
+     * Register a treasure for scoring
+     */
+    registerTreasure(config: TreasureConfig): this;
+    /**
+     * Register multiple treasures at once
+     */
+    registerTreasures(configs: TreasureConfig[]): this;
+    /**
+     * Register a room for first-visit scoring
+     */
+    registerRoomVisit(roomId: string, points: number): this;
+    /**
+     * Register an event sequence
+     */
+    registerSequence(id: string, config: SequenceConfig): this;
+    /**
+     * Register an aggregate goal
+     */
+    registerGoal(id: string, config: GoalConfig): this;
+    /**
+     * Register a conditional unlock
+     */
+    registerUnlock(id: string, config: UnlockConfig): this;
+    /**
+     * Initialize event handlers via EventProcessor
+     *
+     * IMPORTANT: Must be called in onEngineReady(), not initializeWorld()!
+     * The EventProcessor doesn't exist during initializeWorld(), and
+     * world.registerEventHandler() handlers get overwritten by the engine.
+     *
+     * @param eventProcessor - The EventProcessor from engine.getEventProcessor()
+     */
+    initializeHandlers(eventProcessor: IEventProcessorRegistration): this;
+    /**
+     * Handle a taken event (item picked up)
+     */
+    handleTaken(event: ISemanticEvent): void;
+    /**
+     * Handle a put_in event (item placed in container)
+     */
+    handlePutIn(event: ISemanticEvent): void;
+    /**
+     * Handle a player_moved event (room entry)
+     */
+    handlePlayerMoved(event: ISemanticEvent): void;
+    /**
+     * Process any event for sequence advancement
+     */
+    processEventForSequences(event: ISemanticEvent): void;
+    /**
+     * Increment the turn counter (call at end of each turn)
+     */
+    incrementTurn(): void;
+    /**
+     * Get progress for a sequence
+     */
+    getSequenceProgress(id: string): SequenceState | undefined;
+    /**
+     * Get progress for a goal
+     */
+    getGoalProgress(id: string): GoalProgress | undefined;
+    /**
+     * Check if a goal is complete
+     */
+    isGoalComplete(id: string): boolean;
+    /**
+     * Check if an unlock has been triggered
+     */
+    isUnlockTriggered(id: string): boolean;
+    /**
+     * Check if a treasure's take points have been awarded
+     */
+    hasTakenTreasure(entityId: string): boolean;
+    /**
+     * Check if a treasure's container points have been awarded
+     */
+    hasPlacedTreasure(entityId: string): boolean;
+    /**
+     * Check if a room has been visited (for points)
+     */
+    hasVisitedRoom(roomId: string): boolean;
+    /**
+     * Award points once (with deduplication)
+     */
+    awardOnce(sourceId: string, points: number, reason?: string): boolean;
+    /**
+     * Get the scoring service (for direct access)
+     */
+    getScoringService(): IScoringService;
+    /**
+     * Get the world model (for condition checking)
+     */
+    getWorld(): IWorldModel;
+    /**
+     * Get serializable state for saving
+     */
+    getState(): ScoringProcessorState;
+    /**
+     * Restore state from save data
+     */
+    restoreState(state: ScoringProcessorState): void;
+    /**
+     * Check if an event matches a sequence step
+     */
+    private eventMatchesStep;
+    /**
+     * Check if a condition is met
+     */
+    private checkCondition;
+    /**
+     * Get a string ID for a condition (for progress tracking)
+     */
+    private getConditionId;
+    /**
+     * Check all goals and unlocks after a state change
+     */
+    private checkGoalsAndUnlocks;
+}
+//# sourceMappingURL=scoring-event-processor.d.ts.map

package/services/scoring/scoring-event-processor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"scoring-event-processor.d.ts","sourceRoot":"","sources":["../../../../../repos/sharpee/packages/stdlib/src/services/scoring/scoring-event-processor.ts"],"names":[],"mappings":"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"}