usesteady 0.1.0-alpha.1

package/dist/src/intake/intake-service.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"intake-service.js","sourceRoot":"","sources":["../../../src/intake/intake-service.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAoCG;AAKH,OAAO,EAAE,eAAe,EAAE,MAAM,gDAAgD,CAAC;AACjF,OAAO,EAAE,cAAc,EAAE,MAAM,8DAA8D,CAAC;AAC9F,OAAO,EAAE,qBAAqB,EAAE,MAAM,kCAAkC,CAAC;AACzE,OAAO,EACL,wBAAwB,EACxB,sBAAsB,GACvB,MAAM,wCAAwC,CAAC;AAEhD,OAAO,EAAE,MAAM,EAAE,MAAM,eAAe,CAAC;AACvC,OAAO,EAAE,aAAa,EAAE,MAAM,0BAA0B,CAAC;AACzD,OAAO,EAAE,mBAAmB,EAAE,MAAM,4CAA4C,CAAC;AACjF,OAAO,EAAE,iBAAiB,EAAE,MAAM,0CAA0C,CAAC;AAC7E,OAAO,EAAE,aAAa,EAAE,MAAM,wCAAwC,CAAC;AACvE,OAAO,EACL,cAAc,EACd,wBAAwB,EACxB,sBAAsB,EACtB,kBAAkB,GACnB,MAAM,uBAAuB,CAAC;AAC/B,OAAO,EAAE,mBAAmB,EAAE,MAAM,4BAA4B,CAAC;AACjE,OAAO,EAAE,YAAY,EAAE,MAAM,uBAAuB,CAAC;AASrD,SAAS,WAAW,CAAC,KAAa,EAAE,GAAkB;IACpD,iEAAiE;IACjE,MAAM,aAAa,GAAG;QACpB,eAAe,EAAE,GAAG,CAAC,UAAU,CAAC,eAAe;QAC/C,GAAG,CAAC,GAAG,CAAC,UAAU,CAAC,SAAS,KAAM,SAAS,CAAC,CAAC,CAAC,EAAE,SAAS,EAAG,GAAG,CAAC,UAAU,CAAC,SAAS,EAAG,CAAC,CAAC,CAAC,EAAE,CAAC;QAC7F,GAAG,CAAC,GAAG,CAAC,UAAU,CAAC,UAAU,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,UAAU,EAAE,GAAG,CAAC,UAAU,CAAC,UAAU,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;KAC9F,CAAC;IAEF,+EAA+E;IAC/E,MAAM,SAAS,GAAG,MAAM,CAAC,KAAK,EAAE,GAAG,CAAC,UAAU,CAAC,CAAC;IAChD,IAAI,CAAC,SAAS,CAAC,EAAE,EAAE,CAAC;QAClB,MAAM,MAAM,GAAiB,EAAE,IAAI,EAAE,eAAe,EAAE,MAAM,EAAE,SAAS,EAAE,CAAC;QAC1E,OAAO;YACL,MAAM,EAAE,EAAE,IAAI,EAAE,SAAS,EAAE,MAAM,EAAE,SAAS,CAAC,MAAM,EAAE,MAAM,EAAE,WAAW,EAAE,WAAW,EAAE;YACvF,KAAK,EAAG;gBACN,SAAS,EAAO,KAAK;gBACrB,aAAa,EAAG,aAAa;gBAC7B,WAAW,EAAK,aAAa;gBAC7B,YAAY,EAAI,aAAa;gBAC7B,cAAc,EAAE,aAAa;gBAC7B,WAAW,EAAK,KAAK;aACtB;SACF,CAAC;IACJ,CAAC;IAED,gFAAgF;IAChF,MAAM,YAAY,GAAG,aAAa,CAAC,KAAK,CAAC,CAAC;IAC1C,MAAM,YAAY,GAAG,cAAc,CAAC,YAAY,CAAC,CAAC;IAClD,IAAI,YAAY,KAAK,IAAI,EAAE,CAAC;QAC1B,MAAM,KAAK,GAAM,mBAAmB,CAAC,YAAY,CAAC,CAAC;QACnD,MAAM,QAAQ,GAAG,YAAY,CAAC,KAAK,CAAC,CAAC;QACrC,OAAO;YACL,MAAM,EAAE;gBACN,IAAI,EAAS,QAAQ,CAAC,IAAI;gBAC1B,MAAM,EAAO,YAAY,CAAC,IAAI,IAAI,QAAQ,CAAC,MAAM;gBACjD,MAAM,EAAO,YAAY;gBACzB,WAAW,EAAE,KAAK;aACnB;YACD,KAAK,EAAE;gBACL,SAAS,EAAO,IAAI;gBACpB,aAAa,EAAG,OAAO;gBACvB,WAAW,EAAK,aAAa;gBAC7B,YAAY,EAAI,aAAa;gBAC7B,cAAc,EAAE,aAAa;gBAC7B,WAAW,EAAK,KAAK;aACtB;SACF,CAAC;IACJ,CAAC;IAED,gFAAgF;IAChF,MAAM,aAAa,GAAG,mBAAmB,CAAC,KAAK,EAAE,aAAa,CAAC,CAAC;IAChE,MAAM,aAAa,GAAG,wBAAwB,CAAC,aAAa,CAAC,CAAC;IAC9D,IAAI,aAAa,KAAK,IAAI,EAAE,CAAC;QAC3B,MAAM,KAAK,GAAM,mBAAmB,CAAC,aAAa,CAAC,CAAC;QACpD,MAAM,QAAQ,GAAG,YAAY,CAAC,KAAK,CAAC,CAAC;QACrC,OAAO;YACL,MAAM,EAAE;gBACN,IAAI,EAAS,QAAQ,CAAC,IAAI;gBAC1B,MAAM,EAAO,aAAa,CAAC,IAAI,KAAK,eAAe,CAAC,CAAC,CAAC,aAAa,CAAC,MAAM,CAAC,CAAC,CAAC,QAAQ,CAAC,MAAM;gBAC5F,MAAM,EAAO,aAAa;gBAC1B,WAAW,EAAE,KAAK;aACnB;YACD,KAAK,EAAE;gBACL,SAAS,EAAO,IAAI;gBACpB,aAAa,EAAG,OAAO;gBACvB,WAAW,EAAK,aAAa,CAAC,IAAI;gBAClC,YAAY,EAAI,aAAa;gBAC7B,cAAc,EAAE,aAAa;gBAC7B,WAAW,EAAK,KAAK;aACtB;SACF,CAAC;IACJ,CAAC;IAED,gFAAgF;IAChF,+DAA+D;IAC/D,4CAA4C;IAC5C,4EAA4E;IAC5E,MAAM,cAAc,GAAG,iBAAiB,CAAC,KAAK,CAAC,CAAC;IAChD,MAAM,cAAc,GAAG,sBAAsB,CAAC,cAAc,CAAC,CAAC;IAC9D,IAAI,cAAc,KAAK,IAAI,EAAE,CAAC;QAC5B,MAAM,KAAK,GAAM,mBAAmB,CAAC,cAAc,CAAC,CAAC;QACrD,MAAM,QAAQ,GAAG,YAAY,CAAC,KAAK,CAAC,CAAC;QACrC,OAAO;YACL,MAAM,EAAE;gBACN,IAAI,EAAS,QAAQ,CAAC,IAAI;gBAC1B,MAAM,EAAO,cAAc,CAAC,IAAI,KAAK,WAAW,CAAC,CAAC,CAAC,cAAc,CAAC,MAAM,CAAC,CAAC,CAAC,QAAQ,CAAC,MAAM;gBAC1F,MAAM,EAAO,cAAc;gBAC3B,WAAW,EAAE,KAAK;aACnB;YACD,KAAK,EAAE;gBACL,SAAS,EAAO,IAAI;gBACpB,aAAa,EAAG,OAAO;gBACvB,WAAW,EAAK,SAAS;gBACzB,YAAY,EAAI,cAAc,CAAC,IAAI;gBACnC,cAAc,EAAE,aAAa;gBAC7B,WAAW,EAAK,KAAK;aACtB;SACF,CAAC;IACJ,CAAC;IAED,gEAAgE;IAChE,MAAM,kBAAkB,GAAG,cAAc,CAAC,IAAI,CAAC;IAE/C,gFAAgF;IAChF,+EAA+E;IAC/E,MAAM,gBAAgB,GAAG,aAAa,CAAC,KAAK,EAAE,aAAa,CAAC,CAAC;IAC7D,MAAM,gBAAgB,GAAG,kBAAkB,CAAC,gBAAgB,CAAC,CAAC;IAC9D,MAAM,KAAK,GAAc,mBAAmB,CAAC,gBAAgB,CAAC,CAAC;IAC/D,MAAM,QAAQ,GAAW,YAAY,CAAC,KAAK,CAAC,CAAC;IAE7C,gGAAgG;IAChG,IAAI,gBAAgB,CAAC,IAAI,KAAK,UAAU,EAAE,CAAC;QACzC,MAAM,cAAc,GAAG,eAAe,CAAC,KAAK,CAAC,IAAI,SAAS,CAAC;QAC3D,MAAM,MAAM,GAAiB;YAC3B,IAAI,EAAS,QAAQ,CAAC,IAAI;YAC1B,MAAM,EAAO,QAAQ,CAAC,MAAM;YAC5B,MAAM,EAAO,gBAAgB;YAC7B,WAAW,EAAE,KAAK;SACnB,CAAC;QACF,OAAO;YACL,MAAM,EAAE,cAAc,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,GAAG,MAAM,EAAE,cAAc,EAAE,CAAC,CAAC,CAAC,MAAM;YAC7E,KAAK,EAAG;gBACN,SAAS,EAAO,IAAI;gBACpB,aAAa,EAAG,OAAO;gBACvB,WAAW,EAAK,SAAS;gBACzB,YAAY,EAAI,kBAAkB;gBAClC,cAAc,EAAE,UAAU;gBAC1B,WAAW,EAAK,KAAK;aACtB;SACF,CAAC;IACJ,CAAC;IAED,mDAAmD;IACnD,EAAE;IACF,+EAA+E;IAC/E,4DAA4D;IAC5D,EAAE;IACF,+EAA+E;IAC/E,gFAAgF;IAChF,EAAE;IACF,0EAA0E;IAC1E,gDAAgD;IAChD,MAAM,gBAAgB,GACpB,cAAc,CAAC,KAAK,EAAE,gBAAgB,EAAE,aAAa,CAAC,IAAI;QACxD,OAAO,EAAI,gBAAgB,CAAC,OAAO;QACnC,SAAS,EAAE,gBAAgB,CAAC,SAAS;KACtC,CAAC;IAEJ,yFAAyF;IACzF,qFAAqF;IACrF,MAAM,cAAc,GAClB,gBAAgB,CAAC,IAAI,KAAK,iBAAiB,IAAI,gBAAgB,CAAC,IAAI,KAAK,YAAY,CAAC;IACxF,MAAM,WAAW,GACf,cAAc,IAAI,gBAAgB,CAAC,cAAc,KAAK,SAAS,CAAC;IAElE,gFAAgF;IAChF,+EAA+E;IAC/E,kFAAkF;IAClF,MAAM,mBAAmB,GACvB,cAAc,IAAI,CAAC,WAAW,CAAC,CAAC,CAAC,wBAAwB,CAAC,CAAC,CAAC,SAAS,CAAC;IAExE,2EAA2E;IAC3E,EAAE;IACF,8EAA8E;IAC9E,4EAA4E;IAC5E,EAAE;IACF,8BAA8B;IAC9B,sEAAsE;IACtE,iEAAiE;IACjE,8DAA8D;IAC9D,mCAAmC;IACnC,mCAAmC;IACnC,8CAA8C;IAC9C,gFAAgF;IAChF,MAAM,kBAAkB,GACtB,mBAAmB,KAAK,wBAAwB;QAC9C,CAAC,CAAC,wBAAwB,CAAC,KAAK,CAAC;QACjC,CAAC,CAAC,SAAS,CAAC;IAEhB,MAAM,kBAAkB,GACtB,kBAAkB,KAAK,SAAS;QAC9B,CAAC,CAAC;YACE,OAAO,EAAI,gBAAgB,CAAC,OAAO;YACnC,SAAS,EAAE,sBAAsB,CAAC,kBAAkB,CAAC;YACrD,uEAAuE;YACvE,GAAG,CAAC,gBAAgB,CAAC,cAAc,KAAK,SAAS;gBAC/C,CAAC,CAAC,EAAE,cAAc,EAAE,gBAAgB,CAAC,cAAc,EAAE;gBACrD,CAAC,CAAC,EAAE,CAAC;SACR;QACH,CAAC,CAAC,gBAAgB,CAAC;IAEvB,gEAAgE;IAChE,0EAA0E;IAC1E,+DAA+D;IAC/D,yDAAyD;IACzD,EAAE;IACF,aAAa;IACb,mDAAmD;IACnD,8BAA8B;IAC9B,mCAAmC;IACnC,8EAA8E;IAC9E,MAAM,QAAQ,GAAG,qBAAqB,CACpC,kBAAkB,EAClB,GAAG,CAAC,mBAAmB,CAAC,sBAAsB,CAC/C,CAAC;IAEF,OAAO;QACL,MAAM,EAAE;YACN,IAAI,EAAS,QAAQ,CAAC,IAAI;YAC1B,MAAM,EAAO,gBAAgB,CAAC,MAAM;YACpC,MAAM,EAAO,gBAAgB;YAC7B,WAAW,EAAE,KAAK;YAClB,QAAQ;SACT;QACD,KAAK,EAAE;YACL,SAAS,EAAO,IAAI;YACpB,aAAa,EAAG,OAAO;YACvB,WAAW,EAAK,SAAS;YACzB,YAAY,EAAI,kBAAkB;YAClC,cAAc,EAAE,gBAAgB,CAAC,IAAI;YACrC,WAAW;YACX,GAAG,CAAC,mBAAmB,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,mBAAmB,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;YACrE,GAAG,CAAC,kBAAkB,KAAM,SAAS,CAAC,CAAC,CAAC,EAAE,kBAAkB,EAAG,CAAC,CAAC,CAAC,EAAE,CAAC;SACtE;KACF,CAAC;AACJ,CAAC;AAED,iFAAiF;AAEjF;;;;GAIG;AACH,MAAM,UAAU,SAAS,CAAC,KAAa,EAAE,GAAkB;IACzD,OAAO,WAAW,CAAC,KAAK,EAAE,GAAG,CAAC,CAAC,MAAM,CAAC;AACxC,CAAC;AAED;;;;;;;GAOG;AACH,MAAM,UAAU,kBAAkB,CAChC,KAAa,EACb,GAAkB;IAElB,OAAO,WAAW,CAAC,KAAK,EAAE,GAAG,CAAC,CAAC;AACjC,CAAC;AAgBD,OAAO,EAAE,mBAAmB,EAAE,MAAmB,8BAA8B,CAAC;AAChF,OAAO,EAAE,gBAAgB,EAAE,MAAsB,2BAA2B,CAAC;AAC7E,OAAO,EAAE,mBAAmB,EAAE,MAAmB,8BAA8B,CAAC;AAChF,OAAO,EAAE,oBAAoB,EAAE,MAAkB,+BAA+B,CAAC;AACjF,OAAO,EAAE,2BAA2B,EAAE,MAAW,sCAAsC,CAAC;AACxF,OAAO,EAAE,uBAAuB,EAAE,MAAe,kCAAkC,CAAC;AACpF,OAAO,EAAE,iCAAiC,EAAE,MAAM,6CAA6C,CAAC;AAChG,OAAO,EAAE,iCAAiC,EAAE,MAAM,6CAA6C,CAAC;AAChG,OAAO,EAAE,qBAAqB,EAAE,MAAiB,gCAAgC,CAAC;AAClF,OAAO,EAAE,uBAAuB,EAAE,MAAe,mCAAmC,CAAC;AAiCrF;;;;;;;;;;;;;;;GAeG;AACH,MAAM,UAAU,gBAAgB,CAC9B,KAAa,EACb,GAAkB;IAElB,uEAAuE;IACvE,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,GAAG,WAAW,CAAC,KAAK,EAAE,GAAG,CAAC,CAAC;IAElD,wEAAwE;IACxE,MAAM,cAAc,GAAG,mBAAmB,CAAC,KAAK,CAAC,CAAC;IAElD,0EAA0E;IAC1E,MAAM,aAAa,GAAG;QACpB,eAAe,EAAE,GAAG,CAAC,UAAU,CAAC,eAAe;QAC/C,GAAG,CAAC,GAAG,CAAC,UAAU,CAAC,SAAS,KAAM,SAAS,CAAC,CAAC,CAAC,EAAE,SAAS,EAAG,GAAG,CAAC,UAAU,CAAC,SAAS,EAAG,CAAC,CAAC,CAAC,EAAE,CAAC;QAC7F,GAAG,CAAC,GAAG,CAAC,UAAU,CAAC,UAAU,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,UAAU,EAAE,GAAG,CAAC,UAAU,CAAC,UAAU,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;KAC9F,CAAC;IAEF,8EAA8E;IAC9E,MAAM,SAAS,GAAM,MAAM,CAAC,KAAK,EAAE,GAAG,CAAC,UAAU,CAAC,CAAC;IACnD,MAAM,WAAW,GAAI,gBAAgB,CAAC,SAAS,CAAC,CAAC;IAEjD,wEAAwE;IACxE,+EAA+E;IAC/E,MAAM,YAAY,GAAG,EAAE,QAAQ,EAAE,cAAc,CAAC,EAAE,EAAE,MAAM,EAAE,cAAc,CAAC,EAAE,EAAE,CAAC;IAEhF,IAAI,CAAC,SAAS,CAAC,EAAE,EAAE,CAAC;QAClB,yEAAyE;QACzE,OAAO;YACL,MAAM;YACN,KAAK;YACL,GAAG,EAAE;gBACH,MAAM,EAAM,cAAc;gBAC1B,GAAG,EAAS,WAAW;gBACvB,QAAQ,EAAI,qBAAqB,CAAC,MAAM,EAAE,YAAY,CAAC;gBACvD,UAAU,EAAE,uBAAuB,CAAC,KAAK,CAAC;aAC3C;SACF,CAAC;IACJ,CAAC;IAED,8EAA8E;IAC9E,MAAM,YAAY,GAAK,aAAa,CAAC,KAAK,CAAC,CAAC;IAC5C,MAAM,cAAc,GAAG,mBAAmB,CAAC,YAAY,CAAC,CAAC;IAEzD,IAAI,YAAY,CAAC,OAAO,KAAK,OAAO,EAAE,CAAC;QACrC,OAAO;YACL,MAAM;YACN,KAAK;YACL,GAAG,EAAE;gBACH,MAAM,EAAM,cAAc;gBAC1B,GAAG,EAAS,WAAW;gBACvB,MAAM,EAAM,cAAc;gBAC1B,QAAQ,EAAI,qBAAqB,CAAC,MAAM,EAAE,YAAY,CAAC;gBACvD,UAAU,EAAE,uBAAuB,CAAC,KAAK,CAAC;aAC3C;SACF,CAAC;IACJ,CAAC;IAED,8EAA8E;IAC9E,MAAM,aAAa,GAAK,mBAAmB,CAAC,KAAK,EAAE,aAAa,CAAC,CAAC;IAClE,MAAM,eAAe,GAAG,oBAAoB,CAAC,aAAa,CAAC,CAAC;IAE5D,IAAI,aAAa,CAAC,IAAI,KAAK,SAAS,EAAE,CAAC;QACrC,OAAO;YACL,MAAM;YACN,KAAK;YACL,GAAG,EAAE;gBACH,MAAM,EAAM,cAAc;gBAC1B,GAAG,EAAS,WAAW;gBACvB,MAAM,EAAM,cAAc;gBAC1B,OAAO,EAAK,eAAe;gBAC3B,QAAQ,EAAI,qBAAqB,CAAC,MAAM,EAAE,YAAY,CAAC;gBACvD,UAAU,EAAE,uBAAuB,CAAC,KAAK,CAAC;aAC3C;SACF,CAAC;IACJ,CAAC;IAED,8EAA8E;IAC9E,MAAM,cAAc,GAAK,iBAAiB,CAAC,KAAK,CAAC,CAAC;IAClD,MAAM,gBAAgB,GAAG,2BAA2B,CAAC,cAAc,CAAC,CAAC;IAErE,IAAI,cAAc,CAAC,IAAI,KAAK,WAAW,EAAE,CAAC;QACxC,OAAO;YACL,MAAM;YACN,KAAK;YACL,GAAG,EAAE;gBACH,MAAM,EAAU,cAAc;gBAC9B,GAAG,EAAa,WAAW;gBAC3B,MAAM,EAAU,cAAc;gBAC9B,OAAO,EAAS,eAAe;gBAC/B,cAAc,EAAE,gBAAgB;gBAChC,QAAQ,EAAQ,qBAAqB,CAAC,MAAM,EAAE,YAAY,CAAC;gBAC3D,UAAU,EAAM,uBAAuB,CAAC,KAAK,CAAC;aAC/C;SACF,CAAC;IACJ,CAAC;IAED,8EAA8E;IAC9E,MAAM,gBAAgB,GAAK,aAAa,CAAC,KAAK,EAAE,aAAa,CAAC,CAAC;IAC/D,MAAM,kBAAkB,GAAG,uBAAuB,CAAC,gBAAgB,CAAC,CAAC;IAErE,8EAA8E;IAC9E,MAAM,oBAAoB,GACxB,MAAM,CAAC,cAAc,KAAK,SAAS;QACjC,CAAC,CAAC,iCAAiC,CAAC,MAAM,CAAC,cAAc,CAAC;QAC1D,CAAC,CAAC,SAAS,CAAC;IAEhB,MAAM,oBAAoB,GACxB,MAAM,CAAC,QAAQ,EAAE,cAAc,KAAK,SAAS;QAC3C,CAAC,CAAC,iCAAiC,CAAC,MAAM,CAAC,QAAQ,CAAC,cAAc,CAAC;QACnE,CAAC,CAAC,SAAS,CAAC;IAEhB,OAAO;QACL,MAAM;QACN,KAAK;QACL,GAAG,EAAE;YACH,MAAM,EAAiC,cAAc;YACrD,GAAG,EAAoC,WAAW;YAClD,MAAM,EAAiC,cAAc;YACrD,OAAO,EAAgC,eAAe;YACtD,cAAc,EAAyB,gBAAgB;YACvD,UAAU,EAA6B,kBAAkB;YACzD,GAAG,CAAC,oBAAoB,KAAM,SAAS,CAAC,CAAC,CAAC,EAAE,oBAAoB,EAAG,oBAAoB,EAAG,CAAC,CAAC,CAAC,EAAE,CAAC;YAChG,GAAG,CAAC,oBAAoB,KAAM,SAAS,CAAC,CAAC,CAAC,EAAE,oBAAoB,EAAG,oBAAoB,EAAG,CAAC,CAAC,CAAC,EAAE,CAAC;YAChG,QAAQ,EAAI,qBAAqB,CAAC,MAAM,EAAE,YAAY,CAAC;YACvD,UAAU,EAAE,uBAAuB,CAAC,KAAK,CAAC;SAC3C;KACF,CAAC;AACJ,CAAC"}

package/dist/src/intake/response-planner.d.ts

@@ -0,0 +1,25 @@
+/**
+ * Response Planner — maps IntentStates to ResponseModes.
+ *
+ * This is the final authority on what action the system takes.
+ * It is deterministic, explicit, and documented per case.
+ *
+ * Hard rule: ResponseMode "execute" is ONLY returned for IntentState "clear".
+ * No other path reaches execution.
+ *
+ * Mapping:
+ *   unsafe          → refuse   (blocked; explain refusal)
+ *   non_literal     → ignore   (social input; no task processing)
+ *   ambiguous       → clarify  (ask for disambiguation)
+ *   incomplete      → guide    (reserved alias; not used directly by classifier)
+ *   guided_recovery → guide    (provide next steps)
+ *   clear           → execute  (deterministic, actionable)
+ */
+import type { IntentState, ResponseMode } from "./types.js";
+type PlannerDecision = {
+    readonly mode: ResponseMode;
+    readonly reason: string;
+};
+export declare function planResponse(state: IntentState): PlannerDecision;
+export {};
+//# sourceMappingURL=response-planner.d.ts.map

package/dist/src/intake/response-planner.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"response-planner.d.ts","sourceRoot":"","sources":["../../../src/intake/response-planner.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAEH,OAAO,KAAK,EAAE,WAAW,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAE5D,KAAK,eAAe,GAAG;IACrB,QAAQ,CAAC,IAAI,EAAE,YAAY,CAAC;IAC5B,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;CACzB,CAAC;AAEF,wBAAgB,YAAY,CAAC,KAAK,EAAE,WAAW,GAAG,eAAe,CAuChE"}

package/dist/src/intake/response-planner.js

@@ -0,0 +1,52 @@
+/**
+ * Response Planner — maps IntentStates to ResponseModes.
+ *
+ * This is the final authority on what action the system takes.
+ * It is deterministic, explicit, and documented per case.
+ *
+ * Hard rule: ResponseMode "execute" is ONLY returned for IntentState "clear".
+ * No other path reaches execution.
+ *
+ * Mapping:
+ *   unsafe          → refuse   (blocked; explain refusal)
+ *   non_literal     → ignore   (social input; no task processing)
+ *   ambiguous       → clarify  (ask for disambiguation)
+ *   incomplete      → guide    (reserved alias; not used directly by classifier)
+ *   guided_recovery → guide    (provide next steps)
+ *   clear           → execute  (deterministic, actionable)
+ */
+export function planResponse(state) {
+    switch (state) {
+        case "unsafe":
+            return {
+                mode: "refuse",
+                reason: "Input matched a safety pattern and cannot be processed.",
+            };
+        case "non_literal":
+            return {
+                mode: "ignore",
+                reason: "Input is conversational and does not represent a task request.",
+            };
+        case "ambiguous":
+            return {
+                mode: "clarify",
+                reason: "Input has multiple possible interpretations. Clarification is required.",
+            };
+        case "incomplete":
+            return {
+                mode: "guide",
+                reason: "Input is safe but underspecified. Guidance provided.",
+            };
+        case "guided_recovery":
+            return {
+                mode: "guide",
+                reason: "Input does not match a supported deterministic format. Next steps provided.",
+            };
+        case "clear":
+            return {
+                mode: "execute",
+                reason: "Input is a deterministic, self-contained request.",
+            };
+    }
+}
+//# sourceMappingURL=response-planner.js.map

package/dist/src/intake/response-planner.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"response-planner.js","sourceRoot":"","sources":["../../../src/intake/response-planner.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AASH,MAAM,UAAU,YAAY,CAAC,KAAkB;IAC7C,QAAQ,KAAK,EAAE,CAAC;QACd,KAAK,QAAQ;YACX,OAAO;gBACL,IAAI,EAAE,QAAQ;gBACd,MAAM,EAAE,yDAAyD;aAClE,CAAC;QAEJ,KAAK,aAAa;YAChB,OAAO;gBACL,IAAI,EAAE,QAAQ;gBACd,MAAM,EAAE,gEAAgE;aACzE,CAAC;QAEJ,KAAK,WAAW;YACd,OAAO;gBACL,IAAI,EAAE,SAAS;gBACf,MAAM,EAAE,yEAAyE;aAClF,CAAC;QAEJ,KAAK,YAAY;YACf,OAAO;gBACL,IAAI,EAAE,OAAO;gBACb,MAAM,EAAE,sDAAsD;aAC/D,CAAC;QAEJ,KAAK,iBAAiB;YACpB,OAAO;gBACL,IAAI,EAAE,OAAO;gBACb,MAAM,EACJ,6EAA6E;aAChF,CAAC;QAEJ,KAAK,OAAO;YACV,OAAO;gBACL,IAAI,EAAE,SAAS;gBACf,MAAM,EAAE,mDAAmD;aAC5D,CAAC;IACN,CAAC;AACH,CAAC"}

package/dist/src/intake/signal-extractor.d.ts

@@ -0,0 +1,25 @@
+/**
+ * Signal extractor — converts layer results into canonical IntakeSignals.
+ *
+ * Disambiguation note:
+ *   `unknown` from disambiguation is NOT converted to a signal.
+ *   It returns null (fall-through to completion), matching `clear`.
+ *   Rationale: disambiguation `unknown` is an internal intermediate state.
+ *   It means "no ambiguity detected." The caller sees only the final outcome.
+ *   Completion is the authority on what happens next for unrecognised inputs.
+ */
+import type { IntakeSignal } from "./types.js";
+import type { SafetyResult } from "../safety/types.js";
+import type { ContextAlignmentResult } from "../understand/context/types.js";
+import type { DisambiguationResult } from "../understand/disambiguation/types.js";
+import type { CompletionResult } from "../understand/completion/types.js";
+export declare function safetyToSignal(result: SafetyResult): IntakeSignal | null;
+export declare function contextAlignmentToSignal(result: ContextAlignmentResult): IntakeSignal | null;
+/**
+ * `unknown` → null (fall-through; completion is the authority).
+ * `clear`   → null (disambiguation confirmed no ambiguity; completion decides).
+ * `ambiguous` → signal (explicit short-circuit before completion).
+ */
+export declare function disambiguationToSignal(result: DisambiguationResult): IntakeSignal | null;
+export declare function completionToSignal(result: CompletionResult): IntakeSignal;
+//# sourceMappingURL=signal-extractor.d.ts.map

package/dist/src/intake/signal-extractor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"signal-extractor.d.ts","sourceRoot":"","sources":["../../../src/intake/signal-extractor.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAC/C,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AACvD,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,gCAAgC,CAAC;AAC7E,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,uCAAuC,CAAC;AAClF,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,mCAAmC,CAAC;AAE1E,wBAAgB,cAAc,CAAC,MAAM,EAAE,YAAY,GAAG,YAAY,GAAG,IAAI,CAIxE;AAED,wBAAgB,wBAAwB,CACtC,MAAM,EAAE,sBAAsB,GAC7B,YAAY,GAAG,IAAI,CAMrB;AAED;;;;GAIG;AACH,wBAAgB,sBAAsB,CACpC,MAAM,EAAE,oBAAoB,GAC3B,YAAY,GAAG,IAAI,CAMrB;AAED,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,gBAAgB,GAAG,YAAY,CAMzE"}

package/dist/src/intake/signal-extractor.js

@@ -0,0 +1,42 @@
+/**
+ * Signal extractor — converts layer results into canonical IntakeSignals.
+ *
+ * Disambiguation note:
+ *   `unknown` from disambiguation is NOT converted to a signal.
+ *   It returns null (fall-through to completion), matching `clear`.
+ *   Rationale: disambiguation `unknown` is an internal intermediate state.
+ *   It means "no ambiguity detected." The caller sees only the final outcome.
+ *   Completion is the authority on what happens next for unrecognised inputs.
+ */
+export function safetyToSignal(result) {
+    return result.verdict === "block"
+        ? { type: "unsafe", source: "safety" }
+        : null;
+}
+export function contextAlignmentToSignal(result) {
+    switch (result.kind) {
+        case "non_literal": return { type: "non_literal", source: "context" };
+        case "hard_mismatch": return { type: "hard_mismatch", source: "context" };
+        case "aligned": return null;
+    }
+}
+/**
+ * `unknown` → null (fall-through; completion is the authority).
+ * `clear`   → null (disambiguation confirmed no ambiguity; completion decides).
+ * `ambiguous` → signal (explicit short-circuit before completion).
+ */
+export function disambiguationToSignal(result) {
+    switch (result.kind) {
+        case "ambiguous": return { type: "ambiguous", source: "disambiguation" };
+        case "unknown": return null;
+        case "clear": return null;
+    }
+}
+export function completionToSignal(result) {
+    switch (result.kind) {
+        case "complete": return { type: "complete", source: "completion" };
+        case "incomplete": return { type: "incomplete", source: "completion" };
+        case "guided_recovery": return { type: "guided_recovery", source: "completion" };
+    }
+}
+//# sourceMappingURL=signal-extractor.js.map

package/dist/src/intake/signal-extractor.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"signal-extractor.js","sourceRoot":"","sources":["../../../src/intake/signal-extractor.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAQH,MAAM,UAAU,cAAc,CAAC,MAAoB;IACjD,OAAO,MAAM,CAAC,OAAO,KAAK,OAAO;QAC/B,CAAC,CAAC,EAAE,IAAI,EAAE,QAAQ,EAAE,MAAM,EAAE,QAAQ,EAAE;QACtC,CAAC,CAAC,IAAI,CAAC;AACX,CAAC;AAED,MAAM,UAAU,wBAAwB,CACtC,MAA8B;IAE9B,QAAQ,MAAM,CAAC,IAAI,EAAE,CAAC;QACpB,KAAK,aAAa,CAAC,CAAG,OAAO,EAAE,IAAI,EAAE,aAAa,EAAG,MAAM,EAAE,SAAS,EAAE,CAAC;QACzE,KAAK,eAAe,CAAC,CAAC,OAAO,EAAE,IAAI,EAAE,eAAe,EAAE,MAAM,EAAE,SAAS,EAAE,CAAC;QAC1E,KAAK,SAAS,CAAC,CAAO,OAAO,IAAI,CAAC;IACpC,CAAC;AACH,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,sBAAsB,CACpC,MAA4B;IAE5B,QAAQ,MAAM,CAAC,IAAI,EAAE,CAAC;QACpB,KAAK,WAAW,CAAC,CAAC,OAAO,EAAE,IAAI,EAAE,WAAW,EAAE,MAAM,EAAE,gBAAgB,EAAE,CAAC;QACzE,KAAK,SAAS,CAAC,CAAG,OAAO,IAAI,CAAC;QAC9B,KAAK,OAAO,CAAC,CAAK,OAAO,IAAI,CAAC;IAChC,CAAC;AACH,CAAC;AAED,MAAM,UAAU,kBAAkB,CAAC,MAAwB;IACzD,QAAQ,MAAM,CAAC,IAAI,EAAE,CAAC;QACpB,KAAK,UAAU,CAAC,CAAQ,OAAO,EAAE,IAAI,EAAE,UAAU,EAAS,MAAM,EAAE,YAAY,EAAE,CAAC;QACjF,KAAK,YAAY,CAAC,CAAM,OAAO,EAAE,IAAI,EAAE,YAAY,EAAO,MAAM,EAAE,YAAY,EAAE,CAAC;QACjF,KAAK,iBAAiB,CAAC,CAAC,OAAO,EAAE,IAAI,EAAE,iBAAiB,EAAE,MAAM,EAAE,YAAY,EAAE,CAAC;IACnF,CAAC;AACH,CAAC"}

package/dist/src/intake/trace.d.ts

@@ -0,0 +1,157 @@
+/**
+ * DebugTrace — the internal pipeline trace for observability.
+ *
+ * Produced by runIntakeWithTrace. Absent from normal runIntake output.
+ *
+ * ── Purpose ───────────────────────────────────────────────────────────────────
+ *
+ * Answers the developer question: "At each gate, what fired and why?"
+ *
+ * Without this, reasoning about guide vs clarify vs execute requires
+ * mentally re-running the full pipeline. With trace, you can see:
+ *
+ *   - Did PRV pass?
+ *   - Did safety block early?
+ *   - Was the input aligned, social, or a context mismatch?
+ *   - Was disambiguation ambiguous?
+ *   - What did completion decide?
+ *   - Did the Intent Interpretation Bridge fire and classify something?
+ *   - If the bridge was silent, which guidance template was applied?
+ *
+ * ── Zero authority ────────────────────────────────────────────────────────────
+ *
+ * DebugTrace is observability data only.
+ * It has zero effect on IntakeResult.
+ * It does not change mode, signal, intentState, or guidance.
+ * It does not change safety verdicts.
+ * It does not change what executes.
+ *
+ * Any code that reads DebugTrace to make a decision is wrong.
+ *
+ * ── "not_reached" sentinel ────────────────────────────────────────────────────
+ *
+ * When a pipeline step short-circuits (PRV fails, safety blocks, etc.),
+ * subsequent steps never ran. Their fields show "not_reached" to make
+ * the short-circuit point explicit and inspectable — not a default value.
+ */
+import type { SilentGuidanceMode } from "../understand/silent-guidance/types.js";
+export type DebugTrace = {
+    /**
+     * PRV result.
+     * false = PRV found a context-dependency marker with no available context.
+     * true  = PRV passed (either no marker, or context is available).
+     */
+    readonly prvPassed: boolean;
+    /**
+     * Safety Gate verdict.
+     * "allow"       = gate passed
+     * "block"       = input matched a safety detector
+     * "not_reached" = PRV short-circuited before safety ran
+     */
+    readonly safetyVerdict: "allow" | "block" | "not_reached";
+    /**
+     * Context Alignment classification.
+     * "aligned"      = normal task input
+     * "non_literal"  = social / greeting
+     * "hard_mismatch"= context reference with no context available
+     * "not_reached"  = an earlier step short-circuited
+     */
+    readonly contextKind: "aligned" | "non_literal" | "hard_mismatch" | "not_reached";
+    /**
+     * Disambiguation classification.
+     * "clear"       = input was positively normalized
+     * "ambiguous"   = multiple valid interpretations, short-circuited to clarify
+     * "unknown"     = no ambiguity detected, fell through to completion
+     * "not_reached" = an earlier step short-circuited
+     */
+    readonly disambigKind: "clear" | "ambiguous" | "unknown" | "not_reached";
+    /**
+     * Completion result kind.
+     * "complete"        = input is actionable
+     * "incomplete"      = intent is clear, a required field is missing
+     * "guided_recovery" = intent is vague, safe next-step path provided
+     * "not_reached"     = an earlier step short-circuited
+     */
+    readonly completionKind: "complete" | "incomplete" | "guided_recovery" | "not_reached";
+    /**
+     * Whether the Intent Interpretation Bridge ran and produced a classification.
+     *
+     * true  = bridge ran (guided_recovery or incomplete completion) AND an interpreter
+     *         claimed the input (guidance.interpretation is present in the result)
+     * false = bridge did not run (completion was not guide-mode), or ran but no
+     *         interpreter claimed the input (guidance.interpretation is absent)
+     *
+     * This is the most useful single signal for debugging guide mode behavior.
+     * If guide mode feels unhelpful, bridgeFired: false tells you the bridge had
+     * no signal to work with. See bridgeSilenceReason for the runtime observable cause.
+     */
+    readonly bridgeFired: boolean;
+    /**
+     * Why the bridge stayed silent on this guide flow.
+     *
+     * Present ONLY when:
+     *   - completionKind is "guided_recovery" or "incomplete" (bridge was eligible to run), AND
+     *   - bridgeFired === false (no interpreter claimed the input)
+     *
+     * This separates three cleanly distinct states:
+     *   bridgeFired = true                          → bridge ran and classified the input
+     *   bridgeFired = false + silenceReason present → bridge was eligible; nothing claimed it
+     *   bridgeFired = false + silenceReason absent  → bridge was not eligible (non-guide path)
+     *
+     * ── Current values ────────────────────────────────────────────────────────
+     *
+     * "no_interpreter_claimed"
+     *   The bridge ran the full interpreter registry; every interpreter returned null.
+     *   This is the ONLY observable runtime fact. The specific reason why no interpreter
+     *   claimed the input (ambiguous domain, value invention required, safety adjacency, etc.)
+     *   is a human gate evaluation — not a runtime decision.
+     *   See: tests/intake/when-not-to-build.test.ts for the formal per-flow rationale.
+     *
+     * ── Closed enum rule (LOCKED) ─────────────────────────────────────────────
+     *
+     *   bridgeSilenceReason is observational only.
+     *   It MUST remain a closed, runtime-provable enum.
+     *
+     *   A new value may ONLY be added if it is:
+     *     1. Directly observable   — detectable mechanically at bridge-run time
+     *     2. Mechanically provable — not inferred, not assumed, not approximated
+     *     3. Non-interpretive      — does not explain WHY (that is the human gate's job)
+     *
+     *   DO NOT add values that:
+     *     - Encode gate criteria (C1–C5) — those are human evaluations, not runtime facts
+     *     - Explain ambiguity or domain mismatch — those require inference
+     *     - Duplicate information already in completionKind or other trace fields
+     *
+     * ── Internal-only, never exposed to users ────────────────────────────────
+     *
+     *   This field MUST NOT:
+     *     - Appear in IntakeResult
+     *     - Appear in GuidancePayload
+     *     - Affect mode, guidance, interpretation, or any decision path
+     *
+     *   Any code that reads bridgeSilenceReason to make a decision is wrong.
+     */
+    readonly bridgeSilenceReason?: "no_interpreter_claimed";
+    /**
+     * The silent guidance mode applied to this bridge-silent flow.
+     *
+     * Present ONLY when bridgeSilenceReason === "no_interpreter_claimed".
+     * Records which generic guidance template was selected to replace the
+     * default code-patch steps.
+     *
+     * ── Zero authority ────────────────────────────────────────────────────────
+     *
+     *   This field is observational only.
+     *   It records the template decision; it does not drive any other decision.
+     *
+     *   This field MUST NOT:
+     *     - Appear in IntakeResult
+     *     - Appear in GuidancePayload (beyond nextSteps being shaped by it)
+     *     - Affect mode, signal, intentState, or interpretation
+     *     - Enter UCP envelopes
+     *
+     *   Any code that reads silentGuidanceMode to make a routing decision is wrong.
+     */
+    readonly silentGuidanceMode?: SilentGuidanceMode;
+};
+//# sourceMappingURL=trace.d.ts.map

package/dist/src/intake/trace.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"trace.d.ts","sourceRoot":"","sources":["../../../src/intake/trace.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAmCG;AAEH,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,wCAAwC,CAAC;AAEjF,MAAM,MAAM,UAAU,GAAG;IACvB;;;;OAIG;IACH,QAAQ,CAAC,SAAS,EAAE,OAAO,CAAC;IAE5B;;;;;OAKG;IACH,QAAQ,CAAC,aAAa,EAAE,OAAO,GAAG,OAAO,GAAG,aAAa,CAAC;IAE1D;;;;;;OAMG;IACH,QAAQ,CAAC,WAAW,EAAE,SAAS,GAAG,aAAa,GAAG,eAAe,GAAG,aAAa,CAAC;IAElF;;;;;;OAMG;IACH,QAAQ,CAAC,YAAY,EAAE,OAAO,GAAG,WAAW,GAAG,SAAS,GAAG,aAAa,CAAC;IAEzE;;;;;;OAMG;IACH,QAAQ,CAAC,cAAc,EAAE,UAAU,GAAG,YAAY,GAAG,iBAAiB,GAAG,aAAa,CAAC;IAEvF;;;;;;;;;;;OAWG;IACH,QAAQ,CAAC,WAAW,EAAE,OAAO,CAAC;IAE9B;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;OA4CG;IACH,QAAQ,CAAC,mBAAmB,CAAC,EAAE,wBAAwB,CAAC;IAExD;;;;;;;;;;;;;;;;;;;OAmBG;IACH,QAAQ,CAAC,kBAAkB,CAAC,EAAE,kBAAkB,CAAC;CAClD,CAAC"}

package/dist/src/intake/trace.js

@@ -0,0 +1,38 @@
+/**
+ * DebugTrace — the internal pipeline trace for observability.
+ *
+ * Produced by runIntakeWithTrace. Absent from normal runIntake output.
+ *
+ * ── Purpose ───────────────────────────────────────────────────────────────────
+ *
+ * Answers the developer question: "At each gate, what fired and why?"
+ *
+ * Without this, reasoning about guide vs clarify vs execute requires
+ * mentally re-running the full pipeline. With trace, you can see:
+ *
+ *   - Did PRV pass?
+ *   - Did safety block early?
+ *   - Was the input aligned, social, or a context mismatch?
+ *   - Was disambiguation ambiguous?
+ *   - What did completion decide?
+ *   - Did the Intent Interpretation Bridge fire and classify something?
+ *   - If the bridge was silent, which guidance template was applied?
+ *
+ * ── Zero authority ────────────────────────────────────────────────────────────
+ *
+ * DebugTrace is observability data only.
+ * It has zero effect on IntakeResult.
+ * It does not change mode, signal, intentState, or guidance.
+ * It does not change safety verdicts.
+ * It does not change what executes.
+ *
+ * Any code that reads DebugTrace to make a decision is wrong.
+ *
+ * ── "not_reached" sentinel ────────────────────────────────────────────────────
+ *
+ * When a pipeline step short-circuits (PRV fails, safety blocks, etc.),
+ * subsequent steps never ran. Their fields show "not_reached" to make
+ * the short-circuit point explicit and inspectable — not a default value.
+ */
+export {};
+//# sourceMappingURL=trace.js.map

package/dist/src/intake/trace.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"trace.js","sourceRoot":"","sources":["../../../src/intake/trace.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAmCG"}

package/dist/src/intake/types.d.ts

@@ -0,0 +1,70 @@
+/**
+ * Intake pipeline types.
+ *
+ * ── Signal contract ───────────────────────────────────────────────────────────
+ *
+ *   IntakeSignal is the PUBLIC output signal.
+ *   It does NOT include `unknown` from disambiguation — that is an internal
+ *   intermediate state meaning "no ambiguity detected; fall through to completion."
+ *
+ * ── Dual interpretation contract ──────────────────────────────────────────────
+ *
+ *   IntakeResult carries two distinct, independent interpretation fields:
+ *
+ *   guidance.interpretation (IntentInterpretation)
+ *     → Present when mode === "guide" AND vague intent was classified
+ *     → Describes what the user appears to be TRYING TO DO
+ *     → Produced by Intent Interpretation Bridge (understand/intent-interpretation/)
+ *
+ *   interpretation (InterpretationResult)
+ *     → Present when mode === "execute" AND input is a structured change command
+ *     → Describes what the change MEANS (impact, confidence, category)
+ *     → Produced by Change Interpretation (understand/interpretation/)
+ *
+ * ── Guide mode contract ───────────────────────────────────────────────────────
+ *
+ *   When mode === "guide", IntakeResult MUST carry `guidance`.
+ *   No consumer should need to recompute completion to get next steps.
+ */
+import type { PRVContext } from "../prv/types.js";
+import type { InteractionContract } from "../interaction/types.js";
+import type { InterpretationResult } from "../understand/interpretation/types.js";
+export type { GuidancePayload } from "../understand/intent-interpretation/types.js";
+export type IntakeSignal = {
+    readonly type: "unsafe";
+    readonly source: "safety";
+} | {
+    readonly type: "non_literal";
+    readonly source: "context";
+} | {
+    readonly type: "hard_mismatch";
+    readonly source: "context";
+} | {
+    readonly type: "ambiguous";
+    readonly source: "disambiguation";
+} | {
+    readonly type: "incomplete";
+    readonly source: "completion";
+} | {
+    readonly type: "guided_recovery";
+    readonly source: "completion";
+} | {
+    readonly type: "complete";
+    readonly source: "completion";
+};
+export type IntentState = "unsafe" | "non_literal" | "ambiguous" | "incomplete" | "guided_recovery" | "clear";
+export type ResponseMode = "refuse" | "ignore" | "clarify" | "guide" | "execute";
+export type IntakeContext = {
+    readonly prvContext: PRVContext;
+    readonly interactionContract: InteractionContract;
+};
+import type { GuidancePayload } from "../understand/intent-interpretation/types.js";
+export type IntakeResult = {
+    readonly mode: ResponseMode;
+    readonly reason: string;
+    readonly signal: IntakeSignal;
+    readonly intentState: IntentState;
+    readonly guidance?: GuidancePayload;
+    readonly interpretation?: InterpretationResult;
+};
+//# sourceMappingURL=types.d.ts.map

package/dist/src/intake/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/intake/types.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2BG;AAEH,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAClD,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,yBAAyB,CAAC;AACnE,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,uCAAuC,CAAC;AAGlF,YAAY,EAAE,eAAe,EAAE,MAAM,8CAA8C,CAAC;AAIpF,MAAM,MAAM,YAAY,GACpB;IAAE,QAAQ,CAAC,IAAI,EAAE,QAAQ,CAAC;IAAU,QAAQ,CAAC,MAAM,EAAE,QAAQ,CAAA;CAAE,GAC/D;IAAE,QAAQ,CAAC,IAAI,EAAE,aAAa,CAAC;IAAK,QAAQ,CAAC,MAAM,EAAE,SAAS,CAAA;CAAE,GAChE;IAAE,QAAQ,CAAC,IAAI,EAAE,eAAe,CAAC;IAAG,QAAQ,CAAC,MAAM,EAAE,SAAS,CAAA;CAAE,GAChE;IAAE,QAAQ,CAAC,IAAI,EAAE,WAAW,CAAC;IAAO,QAAQ,CAAC,MAAM,EAAE,gBAAgB,CAAA;CAAE,GACvE;IAAE,QAAQ,CAAC,IAAI,EAAE,YAAY,CAAC;IAAM,QAAQ,CAAC,MAAM,EAAE,YAAY,CAAA;CAAE,GACnE;IAAE,QAAQ,CAAC,IAAI,EAAE,iBAAiB,CAAC;IAAC,QAAQ,CAAC,MAAM,EAAE,YAAY,CAAA;CAAE,GACnE;IAAE,QAAQ,CAAC,IAAI,EAAE,UAAU,CAAC;IAAQ,QAAQ,CAAC,MAAM,EAAE,YAAY,CAAA;CAAE,CAAC;AAIxE,MAAM,MAAM,WAAW,GACnB,QAAQ,GACR,aAAa,GACb,WAAW,GACX,YAAY,GACZ,iBAAiB,GACjB,OAAO,CAAC;AAIZ,MAAM,MAAM,YAAY,GACpB,QAAQ,GACR,QAAQ,GACR,SAAS,GACT,OAAO,GACP,SAAS,CAAC;AAId,MAAM,MAAM,aAAa,GAAG;IAC1B,QAAQ,CAAC,UAAU,EAAE,UAAU,CAAC;IAChC,QAAQ,CAAC,mBAAmB,EAAE,mBAAmB,CAAC;CACnD,CAAC;AAIF,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,8CAA8C,CAAC;AAEpF,MAAM,MAAM,YAAY,GAAG;IACzB,QAAQ,CAAC,IAAI,EAAE,YAAY,CAAC;IAC5B,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,MAAM,EAAE,YAAY,CAAC;IAC9B,QAAQ,CAAC,WAAW,EAAE,WAAW,CAAC;IAClC,QAAQ,CAAC,QAAQ,CAAC,EAAE,eAAe,CAAC;IACpC,QAAQ,CAAC,cAAc,CAAC,EAAE,oBAAoB,CAAC;CAKhD,CAAC"}

package/dist/src/intake/types.js

@@ -0,0 +1,30 @@
+/**
+ * Intake pipeline types.
+ *
+ * ── Signal contract ───────────────────────────────────────────────────────────
+ *
+ *   IntakeSignal is the PUBLIC output signal.
+ *   It does NOT include `unknown` from disambiguation — that is an internal
+ *   intermediate state meaning "no ambiguity detected; fall through to completion."
+ *
+ * ── Dual interpretation contract ──────────────────────────────────────────────
+ *
+ *   IntakeResult carries two distinct, independent interpretation fields:
+ *
+ *   guidance.interpretation (IntentInterpretation)
+ *     → Present when mode === "guide" AND vague intent was classified
+ *     → Describes what the user appears to be TRYING TO DO
+ *     → Produced by Intent Interpretation Bridge (understand/intent-interpretation/)
+ *
+ *   interpretation (InterpretationResult)
+ *     → Present when mode === "execute" AND input is a structured change command
+ *     → Describes what the change MEANS (impact, confidence, category)
+ *     → Produced by Change Interpretation (understand/interpretation/)
+ *
+ * ── Guide mode contract ───────────────────────────────────────────────────────
+ *
+ *   When mode === "guide", IntakeResult MUST carry `guidance`.
+ *   No consumer should need to recompute completion to get next steps.
+ */
+export {};
+//# sourceMappingURL=types.js.map

package/dist/src/intake/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../src/intake/types.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2BG"}

package/dist/src/interaction/defaults.d.ts

@@ -0,0 +1,12 @@
+/**
+ * Default InteractionContract.
+ *
+ * Applied to any new subject that has no prior contract.
+ * All modes start at balanced/plain_first/syntax_first.
+ * All observedIntentPatterns counts start at zero.
+ */
+import type { InteractionContract, ObservedIntentPatterns } from "./types.js";
+export declare const DEFAULT_OBSERVED_INTENT_PATTERNS: Readonly<ObservedIntentPatterns>;
+export declare const DEFAULT_CONTRACT: Readonly<InteractionContract>;
+export declare function createDefaultContract(subjectId: string, createdAt?: string): InteractionContract;
+//# sourceMappingURL=defaults.d.ts.map

package/dist/src/interaction/defaults.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"defaults.d.ts","sourceRoot":"","sources":["../../../src/interaction/defaults.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,EAAE,mBAAmB,EAAE,sBAAsB,EAAE,MAAM,YAAY,CAAC;AAE9E,eAAO,MAAM,gCAAgC,EAAE,QAAQ,CAAC,sBAAsB,CAI7E,CAAC;AAEF,eAAO,MAAM,gBAAgB,EAAE,QAAQ,CAAC,mBAAmB,CAS1D,CAAC;AAEF,wBAAgB,qBAAqB,CACnC,SAAS,EAAE,MAAM,EACjB,SAAS,GAAE,MAAiC,GAC3C,mBAAmB,CAErB"}

package/dist/src/interaction/defaults.js

@@ -0,0 +1,26 @@
+/**
+ * Default InteractionContract.
+ *
+ * Applied to any new subject that has no prior contract.
+ * All modes start at balanced/plain_first/syntax_first.
+ * All observedIntentPatterns counts start at zero.
+ */
+export const DEFAULT_OBSERVED_INTENT_PATTERNS = {
+    visual_color: 0,
+    text_change: 0,
+    config_change: 0,
+};
+export const DEFAULT_CONTRACT = {
+    version: 1,
+    subjectId: "anonymous",
+    ambiguityMode: "balanced",
+    explanationMode: "plain_first",
+    unsupportedGuidanceMode: "syntax_first",
+    updatedAt: "1970-01-01T00:00:00.000Z",
+    source: "default",
+    observedIntentPatterns: DEFAULT_OBSERVED_INTENT_PATTERNS,
+};
+export function createDefaultContract(subjectId, createdAt = new Date().toISOString()) {
+    return { ...DEFAULT_CONTRACT, subjectId, updatedAt: createdAt };
+}
+//# sourceMappingURL=defaults.js.map

package/dist/src/interaction/defaults.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"defaults.js","sourceRoot":"","sources":["../../../src/interaction/defaults.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAIH,MAAM,CAAC,MAAM,gCAAgC,GAAqC;IAChF,YAAY,EAAG,CAAC;IAChB,WAAW,EAAI,CAAC;IAChB,aAAa,EAAE,CAAC;CACjB,CAAC;AAEF,MAAM,CAAC,MAAM,gBAAgB,GAAkC;IAC7D,OAAO,EAAmB,CAAC;IAC3B,SAAS,EAAiB,WAAW;IACrC,aAAa,EAAa,UAAU;IACpC,eAAe,EAAW,aAAa;IACvC,uBAAuB,EAAG,cAAc;IACxC,SAAS,EAAiB,0BAA0B;IACpD,MAAM,EAAoB,SAAS;IACnC,sBAAsB,EAAI,gCAAgC;CAC3D,CAAC;AAEF,MAAM,UAAU,qBAAqB,CACnC,SAAiB,EACjB,YAAoB,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;IAE5C,OAAO,EAAE,GAAG,gBAAgB,EAAE,SAAS,EAAE,SAAS,EAAE,SAAS,EAAE,CAAC;AAClE,CAAC"}

package/dist/src/interaction/guidance-order.d.ts

@@ -0,0 +1,53 @@
+/**
+ * applyGuidanceOrdering — session-aware guidance step ordering.
+ *
+ * This is Phase B2 of session memory alignment. It takes a finalized
+ * GuidancePayload and applies two purely presentational adjustments based
+ * on observedIntentPatterns from the InteractionContract:
+ *
+ *   1. Step type ordering: read_first always before use_exact_format (defensive).
+ *   2. Label emphasis: when the user is familiar with a category
+ *      (≥ FAMILIARITY_THRESHOLD observations), the read_first label
+ *      shortens to action-first form (drops "first" — they know the flow).
+ *
+ * ── HARD INVARIANTS (must never be violated) ─────────────────────────────────
+ *
+ *   1. Step count never changes. No step is added. No step is removed.
+ *   2. missing[] is never modified.
+ *   3. interpretation (category, confidence, summary, basis) is never modified.
+ *   4. mode, reason, signal, intentState are NOT touched (not in this type).
+ *   5. Counts may only affect ordering and label text — never content truth.
+ *   6. A required safe step (read_first) is never suppressed.
+ *   7. If counts tie across categories, ordering is deterministic (stable sort).
+ *   8. Label changes use only the current guidance's interpretation category.
+ *      A high text_change count never alters a visual_color label.
+ *
+ * ── This function is purely presentational ───────────────────────────────────
+ *
+ * It is called after all intake decisions are made. It cannot and must not
+ * feed back into PRV, safety, context alignment, disambiguation, completion,
+ * response planning, or interpretation category/confidence.
+ */
+import type { ObservedIntentPatterns } from "./types.js";
+import type { GuidancePayload } from "../understand/intent-interpretation/types.js";
+/**
+ * Number of same-category guided recovery observations required before
+ * the read_first label switches to the shorter, action-first form.
+ *
+ * Below threshold → default label (explains the "why" for new users).
+ * At or above threshold → familiar label (shorter, action-first).
+ */
+export declare const FAMILIARITY_THRESHOLD = 3;
+/**
+ * Apply session-aware ordering to a GuidancePayload.
+ *
+ * Returns a new GuidancePayload with:
+ *   - nextSteps sorted by type (read_first → add_missing_field → use_exact_format)
+ *   - read_first label adjusted to familiar form when patterns[category] >= 3
+ *
+ * All other fields (missing, interpretation, reason) are returned unchanged.
+ *
+ * This is a pure function: deterministic, no side effects.
+ */
+export declare function applyGuidanceOrdering(guidance: GuidancePayload, patterns: ObservedIntentPatterns): GuidancePayload;
+//# sourceMappingURL=guidance-order.d.ts.map

package/dist/src/interaction/guidance-order.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"guidance-order.d.ts","sourceRoot":"","sources":["../../../src/interaction/guidance-order.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA6BG;AAEH,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,YAAY,CAAC;AACzD,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,8CAA8C,CAAC;AAIpF;;;;;;GAMG;AACH,eAAO,MAAM,qBAAqB,IAAI,CAAC;AA8BvC;;;;;;;;;;GAUG;AACH,wBAAgB,qBAAqB,CACnC,QAAQ,EAAE,eAAe,EACzB,QAAQ,EAAE,sBAAsB,GAC/B,eAAe,CAkBjB"}