@opencontextprotocol/agent 0.1.0

package/dist/src/agent.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"agent.js","sourceRoot":"","sources":["../../src/agent.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,YAAY,EAAE,MAAM,cAAc,CAAC;AAC5C,OAAO,EAAE,kBAAkB,EAAuB,MAAM,uBAAuB,CAAC;AAChF,OAAO,EAAE,aAAa,EAAe,MAAM,kBAAkB,CAAC;AAC9D,OAAO,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AAC5C,OAAO,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAE1C,MAAM,kBAAkB,GAAG,UAAU,CAAC;AACtC,MAAM,0BAA0B,GAAG,CAAC,CAAC;AACrC,MAAM,uBAAuB,GAAG,KAAK,CAAC;AACtC,MAAM,iBAAiB,GAAG,OAAO,CAAC;AAClC,MAAM,sBAAsB,GAAG,UAAU,CAAC;AAE1C;;;;;;;;GAQG;AACH,MAAM,OAAO,QAAQ;IASjB;;;;;;;;;OASG;IACH,YACI,YAAoB,kBAAkB,EACtC,IAAa,EACb,SAAkB,EAClB,SAAkB,EAClB,WAAoB,EACpB,cAAuB,IAAI;QAE3B,IAAI,CAAC,OAAO,GAAG,IAAI,YAAY,CAAC;YAC5B,UAAU,EAAE,SAAS;YACrB,IAAI;YACJ,SAAS;YACT,YAAY,EAAE,SAAS;SAC1B,CAAC,CAAC;QACH,IAAI,CAAC,SAAS,GAAG,IAAI,kBAAkB,EAAE,CAAC;QAC1C,IAAI,CAAC,QAAQ,GAAG,IAAI,WAAW,CAAC,WAAW,CAAC,CAAC;QAC7C,IAAI,CAAC,SAAS,GAAG,IAAI,GAAG,EAAE,CAAC;QAC3B,IAAI,CAAC,UAAU,GAAG,IAAI,GAAG,EAAE,CAAC;QAC5B,IAAI,CAAC,UAAU,GAAG,IAAI,aAAa,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;QAClD,IAAI,CAAC,OAAO,GAAG,WAAW,CAAC,CAAC,CAAC,IAAI,UAAU,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC;IACzD,CAAC;IAED;;;;;;;;;;;;;;;;OAgBG;IACH,KAAK,CAAC,WAAW,CAAC,IAAY,EAAE,OAAgB,EAAE,OAAgB,EAAE,OAAgC;QAChG,+CAA+C;QAC/C,IAAI,GAAG,IAAI,CAAC,iBAAiB,CAAC,IAAI,CAAC,CAAC;QAEpC,qBAAqB;QACrB,MAAM,YAAY,GAAG,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;QAC9C,IAAI,YAAY,EAAE,CAAC;YACf,OAAO,YAAY,CAAC;QACxB,CAAC;QAED,oDAAoD;QACpD,IAAI,IAAI,CAAC,OAAO,EAAE,CAAC;YACf,MAAM,UAAU,GAAG,MAAM,IAAI,CAAC,OAAO,CAAC,YAAY,CAAC,IAAI,EAAE,0BAA0B,CAAC,CAAC;YACrF,IAAI,UAAU,EAAE,CAAC;gBACb,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,IAAI,EAAE,UAAU,CAAC,CAAC;gBACrC,IAAI,CAAC,OAAO,CAAC,UAAU,CAAC,IAAI,EAAE,iBAAiB,CAAC,CAAC;gBACjD,OAAO,UAAU,CAAC;YACtB,CAAC;QACL,CAAC;QAED,qDAAqD;QACrD,IAAI,OAAmB,CAAC;QACxB,IAAI,MAAc,CAAC;QAEnB,IAAI,OAAO,EAAE,CAAC;YACV,+CAA+C;YAC/C,OAAO,GAAG,MAAM,IAAI,CAAC,SAAS,CAAC,WAAW,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC;YAC7D,MAAM,GAAG,OAAO,CAAC;QACrB,CAAC;aAAM,CAAC;YACJ,iCAAiC;YACjC,OAAO,GAAG,MAAM,IAAI,CAAC,QAAQ,CAAC,UAAU,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC;YACxD,MAAM,GAAG,GAAG,sBAAsB,IAAI,IAAI,EAAE,CAAC;QACjD,CAAC;QAED,wCAAwC;QACxC,OAAO,CAAC,IAAI,GAAG,IAAI,CAAC;QACpB,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC;QAElC,4CAA4C;QAC5C,IAAI,OAAO,EAAE,CAAC;YACV,MAAM,EAAE,QAAQ,EAAE,GAAG,MAAM,MAAM,CAAC,kBAAkB,CAAC,CAAC;YACtD,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,IAAI,EAAE,QAAQ,CAAC,OAAO,CAAC,QAAQ,EAAE,IAAI,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC,CAAC;QACjF,CAAC;QAED,mCAAmC;QACnC,IAAI,IAAI,CAAC,OAAO,EAAE,CAAC;YACf,MAAM,IAAI,CAAC,OAAO,CAAC,QAAQ,CAAC,IAAI,EAAE,OAAO,EAAE,EAAE,MAAM,EAAE,CAAC,CAAC;QAC3D,CAAC;QAED,6BAA6B;QAC7B,IAAI,CAAC,OAAO,CAAC,UAAU,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC;QAEtC,uBAAuB;QACvB,IAAI,CAAC,OAAO,CAAC,cAAc,CACvB,gBAAgB,EAChB,MAAM,EACN,cAAc,OAAO,CAAC,KAAK,CAAC,MAAM,QAAQ,EAC1C;YACI,QAAQ,EAAE,IAAI;YACd,SAAS,EAAE,OAAO,CAAC,KAAK;YACxB,UAAU,EAAE,OAAO,CAAC,KAAK,CAAC,MAAM;YAChC,QAAQ,EAAE,OAAO,CAAC,QAAQ;YAC1B,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,UAAU;SAC3C,CACJ,CAAC;QAEF,OAAO,OAAO,CAAC;IACnB,CAAC;IAED;;;;;OAKG;IACH,SAAS,CAAC,OAAgB;QACtB,IAAI,OAAO,EAAE,CAAC;YACV,OAAO,GAAG,IAAI,CAAC,iBAAiB,CAAC,OAAO,CAAC,CAAC;YAC1C,MAAM,OAAO,GAAG,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC;YAC5C,IAAI,CAAC,OAAO,EAAE,CAAC;gBACX,MAAM,IAAI,KAAK,CAAC,gBAAgB,OAAO,EAAE,CAAC,CAAC;YAC/C,CAAC;YACD,OAAO,OAAO,CAAC,KAAK,CAAC;QACzB,CAAC;QAED,6BAA6B;QAC7B,MAAM,QAAQ,GAAc,EAAE,CAAC;QAC/B,KAAK,MAAM,OAAO,IAAI,IAAI,CAAC,SAAS,CAAC,MAAM,EAAE,EAAE,CAAC;YAC5C,QAAQ,CAAC,IAAI,CAAC,GAAG,OAAO,CAAC,KAAK,CAAC,CAAC;QACpC,CAAC;QAED,OAAO,QAAQ,CAAC;IACpB,CAAC;IAED;;;;;;OAMG;IACH,OAAO,CAAC,QAAgB,EAAE,OAAgB;QACtC,MAAM,KAAK,GAAG,IAAI,CAAC,SAAS,CAAC,OAAO,CAAC,CAAC;QAEtC,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;YACvB,IAAI,IAAI,CAAC,IAAI,KAAK,QAAQ,EAAE,CAAC;gBACzB,OAAO,IAAI,CAAC;YAChB,CAAC;QACL,CAAC;QAED,OAAO,SAAS,CAAC;IACrB,CAAC;IAED;;;;;;OAMG;IACH,WAAW,CAAC,KAAa,EAAE,OAAgB;QACvC,IAAI,OAAO,EAAE,CAAC;YACV,OAAO,GAAG,IAAI,CAAC,iBAAiB,CAAC,OAAO,CAAC,CAAC;YAC1C,MAAM,OAAO,GAAG,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC;YAC5C,IAAI,CAAC,OAAO,EAAE,CAAC;gBACX,OAAO,EAAE,CAAC;YACd,CAAC;YACD,OAAO,IAAI,CAAC,SAAS,CAAC,WAAW,CAAC,OAAO,EAAE,KAAK,CAAC,CAAC;QACtD,CAAC;QAED,yBAAyB;QACzB,MAAM,OAAO,GAAc,EAAE,CAAC;QAC9B,KAAK,MAAM,OAAO,IAAI,IAAI,CAAC,SAAS,CAAC,MAAM,EAAE,EAAE,CAAC;YAC5C,OAAO,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC,SAAS,CAAC,WAAW,CAAC,OAAO,EAAE,KAAK,CAAC,CAAC,CAAC;QAChE,CAAC;QAED,OAAO,OAAO,CAAC;IACnB,CAAC;IAED;;;;;;;;OAQG;IACH,KAAK,CAAC,QAAQ,CACV,QAAgB,EAChB,aAAkC,EAAE,EACpC,OAAgB,EAChB,OAAgC;QAEhC,gBAAgB;QAChB,MAAM,IAAI,GAAG,IAAI,CAAC,OAAO,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC;QAC7C,IAAI,CAAC,IAAI,EAAE,CAAC;YACR,MAAM,cAAc,GAAG,IAAI,CAAC,SAAS,CAAC,OAAO,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC;YAChE,MAAM,IAAI,KAAK,CAAC,SAAS,QAAQ,iCAAiC,cAAc,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;QACnG,CAAC;QAED,kCAAkC;QAClC,IAAI,OAA+B,CAAC;QACpC,KAAK,MAAM,IAAI,IAAI,IAAI,CAAC,SAAS,CAAC,MAAM,EAAE,EAAE,CAAC;YACzC,IAAI,IAAI,CAAC,KAAK,CAAC,QAAQ,CAAC,IAAI,CAAC,EAAE,CAAC;gBAC5B,OAAO,GAAG,IAAI,CAAC;gBACf,MAAM;YACV,CAAC;QACL,CAAC;QAED,IAAI,CAAC,OAAO,EAAE,CAAC;YACX,MAAM,IAAI,KAAK,CAAC,qCAAqC,QAAQ,GAAG,CAAC,CAAC;QACtE,CAAC;QAED,sBAAsB;QACtB,MAAM,gBAAgB,GAAG,IAAI,CAAC,mBAAmB,CAAC,IAAI,EAAE,UAAU,CAAC,CAAC;QACpE,IAAI,gBAAgB,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YAC9B,MAAM,IAAI,KAAK,CAAC,gCAAgC,gBAAgB,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;QACnF,CAAC;QAED,4FAA4F;QAC5F,IAAI,MAAqB,CAAC;QAC1B,IAAI,OAAO,EAAE,CAAC;YACV,qDAAqD;YACrD,MAAM,EAAE,QAAQ,EAAE,GAAG,MAAM,MAAM,CAAC,kBAAkB,CAAC,CAAC;YACtD,MAAM,GAAG,QAAQ,CAAC,OAAO,CAAC,QAAQ,EAAE,IAAI,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC;QAC/D,CAAC;aAAM,IAAI,OAAO,CAAC,IAAI,IAAI,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,OAAO,CAAC,IAAI,CAAC,EAAE,CAAC;YAC3D,qCAAqC;YACrC,MAAM,GAAG,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,OAAO,CAAC,IAAI,CAAE,CAAC;QAChD,CAAC;aAAM,CAAC;YACJ,+BAA+B;YAC/B,MAAM,GAAG,IAAI,CAAC,UAAU,CAAC;QAC7B,CAAC;QAED,gBAAgB;QAChB,MAAM,CAAC,GAAG,EAAE,aAAa,CAAC,GAAG,IAAI,CAAC,aAAa,CAAC,OAAO,EAAE,IAAI,EAAE,UAAU,CAAC,CAAC;QAE3E,oBAAoB;QACpB,IAAI,CAAC,OAAO,CAAC,cAAc,CACvB,aAAa,QAAQ,EAAE,EACvB,GAAG,EACH,WAAW,EACX;YACI,SAAS,EAAE,QAAQ;YACnB,UAAU;YACV,MAAM,EAAE,IAAI,CAAC,MAAM;SACtB,CACJ,CAAC;QAEF,gDAAgD;QAChD,IAAI,CAAC;YACD,MAAM,QAAQ,GAAG,MAAM,MAAM,CAAC,OAAO,CAAC,IAAI,CAAC,MAAM,EAAE,GAAG,EAAE,aAAa,CAAC,CAAC;YAEvE,iBAAiB;YACjB,IAAI,CAAC,OAAO,CAAC,cAAc,CACvB,iBAAiB,QAAQ,EAAE,EAC3B,GAAG,EACH,GAAG,QAAQ,CAAC,MAAM,IAAI,QAAQ,CAAC,UAAU,EAAE,EAC3C;gBACI,WAAW,EAAE,QAAQ,CAAC,MAAM;gBAC5B,OAAO,EAAE,QAAQ,CAAC,EAAE;gBACpB,aAAa,EAAE,QAAQ,CAAC,IAAI,CAAC,MAAM;aACtC,CACJ,CAAC;YAEF,OAAO,QAAQ,CAAC;QAEpB,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACb,gBAAgB;YAChB,IAAI,CAAC,OAAO,CAAC,cAAc,CACvB,cAAc,QAAQ,EAAE,EACxB,GAAG,EACH,UAAU,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,EAAE,EAClE;gBACI,UAAU,EAAE,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,WAAW,CAAC,IAAI,CAAC,CAAC,CAAC,SAAS;gBACvE,aAAa,EAAE,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC;aACxE,CACJ,CAAC;YACF,MAAM,KAAK,CAAC;QAChB,CAAC;IACL,CAAC;IAED;;OAEG;IACK,mBAAmB,CAAC,IAAa,EAAE,UAA+B;QACtE,MAAM,MAAM,GAAa,EAAE,CAAC;QAE5B,4BAA4B;QAC5B,KAAK,MAAM,CAAC,SAAS,EAAE,SAAS,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,IAAI,CAAC,UAAU,CAAC,EAAE,CAAC;YACnE,IAAI,SAAS,CAAC,QAAQ,IAAI,CAAC,CAAC,SAAS,IAAI,UAAU,CAAC,EAAE,CAAC;gBACnD,MAAM,CAAC,IAAI,CAAC,+BAA+B,SAAS,EAAE,CAAC,CAAC;YAC5D,CAAC;QACL,CAAC;QAED,2CAA2C;QAC3C,KAAK,MAAM,CAAC,SAAS,EAAE,KAAK,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,UAAU,CAAC,EAAE,CAAC;YAC1D,IAAI,SAAS,IAAI,IAAI,CAAC,UAAU,EAAE,CAAC;gBAC/B,MAAM,SAAS,GAAG,IAAI,CAAC,UAAU,CAAC,SAAS,CAAC,CAAC;gBAC7C,MAAM,YAAY,GAAG,SAAS,CAAC,IAAI,IAAI,QAAQ,CAAC;gBAEhD,sBAAsB;gBACtB,IAAI,YAAY,KAAK,SAAS,IAAI,CAAC,MAAM,CAAC,SAAS,CAAC,KAAK,CAAC,EAAE,CAAC;oBACzD,MAAM,CAAC,IAAI,CAAC,cAAc,SAAS,4BAA4B,OAAO,KAAK,EAAE,CAAC,CAAC;gBACnF,CAAC;qBAAM,IAAI,YAAY,KAAK,SAAS,IAAI,OAAO,KAAK,KAAK,SAAS,EAAE,CAAC;oBAClE,MAAM,CAAC,IAAI,CAAC,cAAc,SAAS,4BAA4B,OAAO,KAAK,EAAE,CAAC,CAAC;gBACnF,CAAC;qBAAM,IAAI,YAAY,KAAK,OAAO,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC;oBAC3D,MAAM,CAAC,IAAI,CAAC,cAAc,SAAS,0BAA0B,OAAO,KAAK,EAAE,CAAC,CAAC;gBACjF,CAAC;YACL,CAAC;QACL,CAAC;QAED,OAAO,MAAM,CAAC;IAClB,CAAC;IAED;;OAEG;IACK,aAAa,CACjB,OAAmB,EACnB,IAAa,EACb,UAA+B;QAE/B,+BAA+B;QAC/B,IAAI,GAAG,GAAG,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAC,KAAK,EAAE,EAAE,CAAC,GAAG,IAAI,CAAC,IAAI,CAAC;QAE1D,kCAAkC;QAClC,MAAM,UAAU,GAAwB,EAAE,CAAC;QAC3C,MAAM,WAAW,GAAwB,EAAE,CAAC;QAC5C,MAAM,UAAU,GAAwB,EAAE,CAAC;QAC3C,MAAM,YAAY,GAAwB,EAAE,CAAC;QAE7C,KAAK,MAAM,CAAC,SAAS,EAAE,KAAK,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,UAAU,CAAC,EAAE,CAAC;YAC1D,IAAI,SAAS,IAAI,IAAI,CAAC,UAAU,EAAE,CAAC;gBAC/B,MAAM,QAAQ,GAAG,IAAI,CAAC,UAAU,CAAC,SAAS,CAAC,CAAC,QAAQ,IAAI,OAAO,CAAC;gBAEhE,IAAI,QAAQ,KAAK,MAAM,EAAE,CAAC;oBACtB,UAAU,CAAC,SAAS,CAAC,GAAG,KAAK,CAAC;gBAClC,CAAC;qBAAM,IAAI,QAAQ,KAAK,OAAO,EAAE,CAAC;oBAC9B,WAAW,CAAC,SAAS,CAAC,GAAG,KAAK,CAAC;gBACnC,CAAC;qBAAM,IAAI,QAAQ,KAAK,MAAM,EAAE,CAAC;oBAC7B,UAAU,CAAC,SAAS,CAAC,GAAG,KAAK,CAAC;gBAClC,CAAC;qBAAM,IAAI,QAAQ,KAAK,QAAQ,EAAE,CAAC;oBAC/B,YAAY,CAAC,SAAS,CAAC,GAAG,KAAK,CAAC;gBACpC,CAAC;YACL,CAAC;QACL,CAAC;QAED,0BAA0B;QAC1B,KAAK,MAAM,CAAC,SAAS,EAAE,KAAK,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,UAAU,CAAC,EAAE,CAAC;YAC1D,GAAG,GAAG,GAAG,CAAC,OAAO,CAAC,IAAI,SAAS,GAAG,EAAE,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC;QACvD,CAAC;QAED,2BAA2B;QAC3B,MAAM,aAAa,GAAQ,EAAE,CAAC;QAE9B,IAAI,MAAM,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YACtC,aAAa,CAAC,MAAM,GAAG,WAAW,CAAC;QACvC,CAAC;QAED,IAAI,MAAM,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YACrC,aAAa,CAAC,IAAI,GAAG,UAAU,CAAC;QACpC,CAAC;QAED,IAAI,MAAM,CAAC,IAAI,CAAC,YAAY,CAAC,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YACvC,aAAa,CAAC,OAAO,GAAG,YAAY,CAAC;QACzC,CAAC;QAED,cAAc;QACd,aAAa,CAAC,OAAO,GAAG,KAAK,CAAC;QAE9B,OAAO,CAAC,GAAG,EAAE,aAAa,CAAC,CAAC;IAChC,CAAC;IAED;;OAEG;IACH,oBAAoB,CAAC,QAAgB,EAAE,OAAgB;QACnD,MAAM,IAAI,GAAG,IAAI,CAAC,OAAO,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC;QAC7C,IAAI,CAAC,IAAI,EAAE,CAAC;YACR,OAAO,SAAS,QAAQ,aAAa,CAAC;QAC1C,CAAC;QAED,OAAO,IAAI,CAAC,SAAS,CAAC,yBAAyB,CAAC,IAAI,CAAC,CAAC;IAC1D,CAAC;IAED;;OAEG;IACH,UAAU,CAAC,IAAY,EAAE,OAAgB;QACrC,IAAI,CAAC,OAAO,CAAC,UAAU,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC;IAC3C,CAAC;IAED;;OAEG;IACK,iBAAiB,CAAC,IAAY;QAClC,OAAO,IAAI,CAAC,WAAW,EAAE,CAAC,IAAI,EAAE,CAAC;IACrC,CAAC;CACJ"}

package/dist/src/context.d.ts

@@ -0,0 +1,108 @@
+/**
+ * AgentContext - Core context management for OCP agents.
+ *
+ * Handles creating, updating, and maintaining agent context throughout
+ * multi-step workflows.
+ */
+/**
+ * OCP Context Object - matches the official OCP specification schema
+ */
+export interface OCPContextDict {
+    context_id: string;
+    agent_type: string;
+    user: string | null;
+    workspace: string | null;
+    current_file: string | null;
+    session: Record<string, any>;
+    history: Array<Record<string, any>>;
+    current_goal: string | null;
+    context_summary: string | null;
+    error_context: string | null;
+    recent_changes: string[];
+    api_specs: Record<string, string>;
+    created_at: string;
+    last_updated: string;
+}
+/**
+ * Core agent context that flows through OCP-enabled API calls.
+ *
+ * This represents the agent's understanding of the current conversation,
+ * workspace state, and goals.
+ */
+export declare class AgentContext {
+    context_id: string;
+    agent_type: string;
+    user: string | null;
+    workspace: string | null;
+    current_file: string | null;
+    session: Record<string, any>;
+    history: Array<Record<string, any>>;
+    current_goal: string | null;
+    context_summary: string | null;
+    error_context: string | null;
+    recent_changes: string[];
+    api_specs: Record<string, string>;
+    created_at: Date;
+    last_updated: Date;
+    constructor(params?: {
+        context_id?: string;
+        agent_type?: string;
+        user?: string | null;
+        workspace?: string | null;
+        current_file?: string | null;
+        session?: Record<string, any>;
+        history?: Array<Record<string, any>>;
+        current_goal?: string | null;
+        context_summary?: string | null;
+        error_context?: string | null;
+        recent_changes?: string[];
+        api_specs?: Record<string, string>;
+        created_at?: Date;
+        last_updated?: Date;
+    });
+    /**
+     * Update the agent's current goal and context summary
+     */
+    updateGoal(goal: string, summary?: string): void;
+    /**
+     * Add an interaction to the conversation history
+     */
+    addInteraction(action: string, apiEndpoint?: string | null, result?: string | null, metadata?: Record<string, any>): void;
+    /**
+     * Set error context for debugging scenarios
+     */
+    setErrorContext(error: string, filePath?: string): void;
+    /**
+     * Add a recent change to track modifications
+     */
+    addRecentChange(change: string): void;
+    /**
+     * Add an API specification for enhanced responses
+     */
+    addApiSpec(apiName: string, openapiUrl: string): void;
+    /**
+     * Convert context to dictionary for serialization
+     */
+    toDict(): OCPContextDict;
+    /**
+     * Create AgentContext from dictionary
+     */
+    static fromDict(data: Record<string, any>): AgentContext;
+    /**
+     * Get a summary of the conversation for API context
+     */
+    getConversationSummary(): string;
+    /**
+     * Create a copy of this context for forked workflows
+     */
+    clone(): AgentContext;
+    /**
+     * Convenience method to convert context to OCP headers
+     */
+    toHeaders(compress?: boolean): Record<string, string>;
+    /**
+     * Convenience method to update context from HTTP response headers
+     */
+    updateFromHeaders(headers: Record<string, string> | Headers | any): boolean;
+}
+//# sourceMappingURL=context.d.ts.map

package/dist/src/context.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"context.d.ts","sourceRoot":"","sources":["../../src/context.ts"],"names":[],"mappings":"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"}

package/dist/src/context.js

@@ -0,0 +1,196 @@
+/**
+ * AgentContext - Core context management for OCP agents.
+ *
+ * Handles creating, updating, and maintaining agent context throughout
+ * multi-step workflows.
+ */
+import { randomBytes } from 'crypto';
+import { createOCPHeaders, parseContext } from './headers.js';
+/**
+ * Core agent context that flows through OCP-enabled API calls.
+ *
+ * This represents the agent's understanding of the current conversation,
+ * workspace state, and goals.
+ */
+export class AgentContext {
+    constructor(params = {}) {
+        this.context_id = params.context_id || `ocp-${randomBytes(4).toString('hex')}`;
+        this.agent_type = params.agent_type !== undefined ? params.agent_type : 'generic_agent';
+        this.user = params.user ?? null;
+        this.workspace = params.workspace ?? null;
+        this.current_file = params.current_file ?? null;
+        this.history = params.history || [];
+        this.current_goal = params.current_goal ?? null;
+        this.context_summary = params.context_summary ?? null;
+        this.error_context = params.error_context ?? null;
+        this.recent_changes = params.recent_changes || [];
+        this.api_specs = params.api_specs || {};
+        this.created_at = params.created_at || new Date();
+        this.last_updated = params.last_updated || new Date();
+        // Initialize session
+        this.session = params.session || {
+            start_time: this.created_at.toISOString(),
+            interaction_count: 0,
+            agent_type: this.agent_type,
+        };
+    }
+    /**
+     * Update the agent's current goal and context summary
+     */
+    updateGoal(goal, summary) {
+        this.current_goal = goal;
+        if (summary) {
+            this.context_summary = summary;
+        }
+        this.last_updated = new Date();
+        this.session.interaction_count = (this.session.interaction_count || 0) + 1;
+    }
+    /**
+     * Add an interaction to the conversation history
+     */
+    addInteraction(action, apiEndpoint, result, metadata) {
+        const interaction = {
+            timestamp: new Date().toISOString(),
+            action,
+            api_endpoint: apiEndpoint ?? null,
+            result: result ?? null,
+            metadata: metadata || {},
+        };
+        this.history.push(interaction);
+        this.last_updated = new Date();
+    }
+    /**
+     * Set error context for debugging scenarios
+     */
+    setErrorContext(error, filePath) {
+        this.error_context = error;
+        if (filePath) {
+            this.current_file = filePath;
+        }
+        this.last_updated = new Date();
+    }
+    /**
+     * Add a recent change to track modifications
+     */
+    addRecentChange(change) {
+        this.recent_changes.push(change);
+        // Keep only last 10 changes
+        if (this.recent_changes.length > 10) {
+            this.recent_changes = this.recent_changes.slice(-10);
+        }
+        this.last_updated = new Date();
+    }
+    /**
+     * Add an API specification for enhanced responses
+     */
+    addApiSpec(apiName, openapiUrl) {
+        this.api_specs[apiName] = openapiUrl;
+        this.last_updated = new Date();
+    }
+    /**
+     * Convert context to dictionary for serialization
+     */
+    toDict() {
+        return {
+            context_id: this.context_id,
+            agent_type: this.agent_type,
+            user: this.user,
+            workspace: this.workspace,
+            current_file: this.current_file,
+            session: this.session,
+            history: this.history,
+            current_goal: this.current_goal,
+            context_summary: this.context_summary,
+            error_context: this.error_context,
+            recent_changes: this.recent_changes,
+            api_specs: this.api_specs,
+            created_at: this.created_at.toISOString(),
+            last_updated: this.last_updated.toISOString(),
+        };
+    }
+    /**
+     * Create AgentContext from dictionary
+     */
+    static fromDict(data) {
+        // Convert ISO strings back to Date objects
+        const created_at = data.created_at
+            ? new Date(data.created_at.replace('Z', '+00:00'))
+            : undefined;
+        const last_updated = data.last_updated
+            ? new Date(data.last_updated.replace('Z', '+00:00'))
+            : undefined;
+        return new AgentContext({
+            ...data,
+            created_at,
+            last_updated,
+        });
+    }
+    /**
+     * Get a summary of the conversation for API context
+     */
+    getConversationSummary() {
+        const summaryParts = [];
+        if (this.current_goal) {
+            summaryParts.push(`Goal: ${this.current_goal}`);
+        }
+        if (this.error_context) {
+            summaryParts.push(`Error: ${this.error_context}`);
+        }
+        if (this.current_file) {
+            summaryParts.push(`Working on: ${this.current_file}`);
+        }
+        if (this.recent_changes.length > 0) {
+            summaryParts.push(`Recent changes: ${this.recent_changes.slice(-3).join(', ')}`);
+        }
+        if (this.history.length > 0) {
+            const recentActions = this.history.slice(-3).map(h => h.action);
+            summaryParts.push(`Recent actions: ${recentActions.join(', ')}`);
+        }
+        return summaryParts.length > 0 ? summaryParts.join(' | ') : 'New conversation';
+    }
+    /**
+     * Create a copy of this context for forked workflows
+     */
+    clone() {
+        const data = this.toDict();
+        data.context_id = `ocp-${randomBytes(4).toString('hex')}`; // New ID for clone
+        return AgentContext.fromDict(data);
+    }
+    /**
+     * Convenience method to convert context to OCP headers
+     */
+    toHeaders(compress = true) {
+        return createOCPHeaders(this, undefined, compress);
+    }
+    /**
+     * Convenience method to update context from HTTP response headers
+     */
+    updateFromHeaders(headers) {
+        // Try parseContext which handles multiple header types
+        const newContext = parseContext(headers);
+        if (newContext) {
+            // Update current context with relevant fields from response
+            // Keep our identity but update session and goal info
+            if (newContext.current_goal && newContext.current_goal !== this.current_goal) {
+                this.current_goal = newContext.current_goal;
+            }
+            if (newContext.context_summary) {
+                this.context_summary = newContext.context_summary;
+            }
+            if (newContext.history && newContext.history.length > 0) {
+                // Merge histories, avoiding duplicates
+                const existingIds = new Set(this.history.map(h => h.interaction_id).filter(id => id !== undefined));
+                for (const interaction of newContext.history) {
+                    if (!existingIds.has(interaction.interaction_id)) {
+                        this.history.push(interaction);
+                    }
+                }
+            }
+            // Update timestamp
+            this.last_updated = new Date();
+            return true;
+        }
+        return false;
+    }
+}
+//# sourceMappingURL=context.js.map

package/dist/src/context.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"context.js","sourceRoot":"","sources":["../../src/context.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,WAAW,EAAE,MAAM,QAAQ,CAAC;AACrC,OAAO,EAAE,gBAAgB,EAAE,YAAY,EAAE,MAAM,cAAc,CAAC;AAsB9D;;;;;GAKG;AACH,MAAM,OAAO,YAAY;IA6BvB,YAAY,SAeR,EAAE;QACJ,IAAI,CAAC,UAAU,GAAG,MAAM,CAAC,UAAU,IAAI,OAAO,WAAW,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,KAAK,CAAC,EAAE,CAAC;QAC/E,IAAI,CAAC,UAAU,GAAG,MAAM,CAAC,UAAU,KAAK,SAAS,CAAC,CAAC,CAAC,MAAM,CAAC,UAAU,CAAC,CAAC,CAAC,eAAe,CAAC;QACxF,IAAI,CAAC,IAAI,GAAG,MAAM,CAAC,IAAI,IAAI,IAAI,CAAC;QAChC,IAAI,CAAC,SAAS,GAAG,MAAM,CAAC,SAAS,IAAI,IAAI,CAAC;QAC1C,IAAI,CAAC,YAAY,GAAG,MAAM,CAAC,YAAY,IAAI,IAAI,CAAC;QAChD,IAAI,CAAC,OAAO,GAAG,MAAM,CAAC,OAAO,IAAI,EAAE,CAAC;QACpC,IAAI,CAAC,YAAY,GAAG,MAAM,CAAC,YAAY,IAAI,IAAI,CAAC;QAChD,IAAI,CAAC,eAAe,GAAG,MAAM,CAAC,eAAe,IAAI,IAAI,CAAC;QACtD,IAAI,CAAC,aAAa,GAAG,MAAM,CAAC,aAAa,IAAI,IAAI,CAAC;QAClD,IAAI,CAAC,cAAc,GAAG,MAAM,CAAC,cAAc,IAAI,EAAE,CAAC;QAClD,IAAI,CAAC,SAAS,GAAG,MAAM,CAAC,SAAS,IAAI,EAAE,CAAC;QACxC,IAAI,CAAC,UAAU,GAAG,MAAM,CAAC,UAAU,IAAI,IAAI,IAAI,EAAE,CAAC;QAClD,IAAI,CAAC,YAAY,GAAG,MAAM,CAAC,YAAY,IAAI,IAAI,IAAI,EAAE,CAAC;QAEtD,qBAAqB;QACrB,IAAI,CAAC,OAAO,GAAG,MAAM,CAAC,OAAO,IAAI;YAC/B,UAAU,EAAE,IAAI,CAAC,UAAU,CAAC,WAAW,EAAE;YACzC,iBAAiB,EAAE,CAAC;YACpB,UAAU,EAAE,IAAI,CAAC,UAAU;SAC5B,CAAC;IACJ,CAAC;IAED;;OAEG;IACH,UAAU,CAAC,IAAY,EAAE,OAAgB;QACvC,IAAI,CAAC,YAAY,GAAG,IAAI,CAAC;QACzB,IAAI,OAAO,EAAE,CAAC;YACZ,IAAI,CAAC,eAAe,GAAG,OAAO,CAAC;QACjC,CAAC;QACD,IAAI,CAAC,YAAY,GAAG,IAAI,IAAI,EAAE,CAAC;QAC/B,IAAI,CAAC,OAAO,CAAC,iBAAiB,GAAG,CAAC,IAAI,CAAC,OAAO,CAAC,iBAAiB,IAAI,CAAC,CAAC,GAAG,CAAC,CAAC;IAC7E,CAAC;IAED;;OAEG;IACH,cAAc,CACZ,MAAc,EACd,WAA2B,EAC3B,MAAsB,EACtB,QAA8B;QAE9B,MAAM,WAAW,GAAG;YAClB,SAAS,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;YACnC,MAAM;YACN,YAAY,EAAE,WAAW,IAAI,IAAI;YACjC,MAAM,EAAE,MAAM,IAAI,IAAI;YACtB,QAAQ,EAAE,QAAQ,IAAI,EAAE;SACzB,CAAC;QACF,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC;QAC/B,IAAI,CAAC,YAAY,GAAG,IAAI,IAAI,EAAE,CAAC;IACjC,CAAC;IAED;;OAEG;IACH,eAAe,CAAC,KAAa,EAAE,QAAiB;QAC9C,IAAI,CAAC,aAAa,GAAG,KAAK,CAAC;QAC3B,IAAI,QAAQ,EAAE,CAAC;YACb,IAAI,CAAC,YAAY,GAAG,QAAQ,CAAC;QAC/B,CAAC;QACD,IAAI,CAAC,YAAY,GAAG,IAAI,IAAI,EAAE,CAAC;IACjC,CAAC;IAED;;OAEG;IACH,eAAe,CAAC,MAAc;QAC5B,IAAI,CAAC,cAAc,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;QACjC,4BAA4B;QAC5B,IAAI,IAAI,CAAC,cAAc,CAAC,MAAM,GAAG,EAAE,EAAE,CAAC;YACpC,IAAI,CAAC,cAAc,GAAG,IAAI,CAAC,cAAc,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC;QACvD,CAAC;QACD,IAAI,CAAC,YAAY,GAAG,IAAI,IAAI,EAAE,CAAC;IACjC,CAAC;IAED;;OAEG;IACH,UAAU,CAAC,OAAe,EAAE,UAAkB;QAC5C,IAAI,CAAC,SAAS,CAAC,OAAO,CAAC,GAAG,UAAU,CAAC;QACrC,IAAI,CAAC,YAAY,GAAG,IAAI,IAAI,EAAE,CAAC;IACjC,CAAC;IAED;;OAEG;IACH,MAAM;QACJ,OAAO;YACL,UAAU,EAAE,IAAI,CAAC,UAAU;YAC3B,UAAU,EAAE,IAAI,CAAC,UAAU;YAC3B,IAAI,EAAE,IAAI,CAAC,IAAI;YACf,SAAS,EAAE,IAAI,CAAC,SAAS;YACzB,YAAY,EAAE,IAAI,CAAC,YAAY;YAC/B,OAAO,EAAE,IAAI,CAAC,OAAO;YACrB,OAAO,EAAE,IAAI,CAAC,OAAO;YACrB,YAAY,EAAE,IAAI,CAAC,YAAY;YAC/B,eAAe,EAAE,IAAI,CAAC,eAAe;YACrC,aAAa,EAAE,IAAI,CAAC,aAAa;YACjC,cAAc,EAAE,IAAI,CAAC,cAAc;YACnC,SAAS,EAAE,IAAI,CAAC,SAAS;YACzB,UAAU,EAAE,IAAI,CAAC,UAAU,CAAC,WAAW,EAAE;YACzC,YAAY,EAAE,IAAI,CAAC,YAAY,CAAC,WAAW,EAAE;SAC9C,CAAC;IACJ,CAAC;IAED;;OAEG;IACH,MAAM,CAAC,QAAQ,CAAC,IAAyB;QACvC,2CAA2C;QAC3C,MAAM,UAAU,GAAG,IAAI,CAAC,UAAU;YAChC,CAAC,CAAC,IAAI,IAAI,CAAC,IAAI,CAAC,UAAU,CAAC,OAAO,CAAC,GAAG,EAAE,QAAQ,CAAC,CAAC;YAClD,CAAC,CAAC,SAAS,CAAC;QACd,MAAM,YAAY,GAAG,IAAI,CAAC,YAAY;YACpC,CAAC,CAAC,IAAI,IAAI,CAAC,IAAI,CAAC,YAAY,CAAC,OAAO,CAAC,GAAG,EAAE,QAAQ,CAAC,CAAC;YACpD,CAAC,CAAC,SAAS,CAAC;QAEd,OAAO,IAAI,YAAY,CAAC;YACtB,GAAG,IAAI;YACP,UAAU;YACV,YAAY;SACb,CAAC,CAAC;IACL,CAAC;IAED;;OAEG;IACH,sBAAsB;QACpB,MAAM,YAAY,GAAa,EAAE,CAAC;QAElC,IAAI,IAAI,CAAC,YAAY,EAAE,CAAC;YACtB,YAAY,CAAC,IAAI,CAAC,SAAS,IAAI,CAAC,YAAY,EAAE,CAAC,CAAC;QAClD,CAAC;QAED,IAAI,IAAI,CAAC,aAAa,EAAE,CAAC;YACvB,YAAY,CAAC,IAAI,CAAC,UAAU,IAAI,CAAC,aAAa,EAAE,CAAC,CAAC;QACpD,CAAC;QAED,IAAI,IAAI,CAAC,YAAY,EAAE,CAAC;YACtB,YAAY,CAAC,IAAI,CAAC,eAAe,IAAI,CAAC,YAAY,EAAE,CAAC,CAAC;QACxD,CAAC;QAED,IAAI,IAAI,CAAC,cAAc,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YACnC,YAAY,CAAC,IAAI,CAAC,mBAAmB,IAAI,CAAC,cAAc,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;QACnF,CAAC;QAED,IAAI,IAAI,CAAC,OAAO,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YAC5B,MAAM,aAAa,GAAG,IAAI,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC;YAChE,YAAY,CAAC,IAAI,CAAC,mBAAmB,aAAa,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;QACnE,CAAC;QAED,OAAO,YAAY,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,YAAY,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,kBAAkB,CAAC;IACjF,CAAC;IAED;;OAEG;IACH,KAAK;QACH,MAAM,IAAI,GAAG,IAAI,CAAC,MAAM,EAAE,CAAC;QAC3B,IAAI,CAAC,UAAU,GAAG,OAAO,WAAW,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC,mBAAmB;QAC9E,OAAO,YAAY,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC;IACrC,CAAC;IAED;;OAEG;IACH,SAAS,CAAC,WAAoB,IAAI;QAChC,OAAO,gBAAgB,CAAC,IAAI,EAAE,SAAS,EAAE,QAAQ,CAAC,CAAC;IACrD,CAAC;IAED;;OAEG;IACH,iBAAiB,CAAC,OAA+C;QAC/D,uDAAuD;QACvD,MAAM,UAAU,GAAG,YAAY,CAAC,OAAO,CAAC,CAAC;QAEzC,IAAI,UAAU,EAAE,CAAC;YACf,4DAA4D;YAC5D,qDAAqD;YACrD,IAAI,UAAU,CAAC,YAAY,IAAI,UAAU,CAAC,YAAY,KAAK,IAAI,CAAC,YAAY,EAAE,CAAC;gBAC7E,IAAI,CAAC,YAAY,GAAG,UAAU,CAAC,YAAY,CAAC;YAC9C,CAAC;YACD,IAAI,UAAU,CAAC,eAAe,EAAE,CAAC;gBAC/B,IAAI,CAAC,eAAe,GAAG,UAAU,CAAC,eAAe,CAAC;YACpD,CAAC;YACD,IAAI,UAAU,CAAC,OAAO,IAAI,UAAU,CAAC,OAAO,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;gBACxD,uCAAuC;gBACvC,MAAM,WAAW,GAAG,IAAI,GAAG,CACzB,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,cAAc,CAAC,CAAC,MAAM,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,KAAK,SAAS,CAAC,CACvE,CAAC;gBACF,KAAK,MAAM,WAAW,IAAI,UAAU,CAAC,OAAO,EAAE,CAAC;oBAC7C,IAAI,CAAC,WAAW,CAAC,GAAG,CAAC,WAAW,CAAC,cAAc,CAAC,EAAE,CAAC;wBACjD,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC;oBACjC,CAAC;gBACH,CAAC;YACH,CAAC;YACD,mBAAmB;YACnB,IAAI,CAAC,YAAY,GAAG,IAAI,IAAI,EAAE,CAAC;YAC/B,OAAO,IAAI,CAAC;QACd,CAAC;QACD,OAAO,KAAK,CAAC;IACf,CAAC;CACF"}

package/dist/src/errors.d.ts

@@ -0,0 +1,40 @@
+/**
+ * OCP Error Hierarchy
+ *
+ * Consistent error handling for the Open Context Protocol library.
+ * Provides specific exception types for different failure scenarios.
+ */
+/**
+ * Base exception for all OCP-related errors
+ */
+export declare class OCPError extends Error {
+    constructor(message: string);
+}
+/**
+ * Registry service is unreachable or returned an error
+ */
+export declare class RegistryUnavailable extends OCPError {
+    registryUrl: string;
+    constructor(registryUrl: string, message?: string);
+}
+/**
+ * API not found in the registry
+ */
+export declare class APINotFound extends OCPError {
+    apiName: string;
+    suggestions: string[];
+    constructor(apiName: string, suggestions?: string[]);
+}
+/**
+ * OpenAPI schema discovery and parsing errors
+ */
+export declare class SchemaDiscoveryError extends OCPError {
+    constructor(message: string);
+}
+/**
+ * Context or parameter validation errors
+ */
+export declare class ValidationError extends OCPError {
+    constructor(message: string);
+}
+//# sourceMappingURL=errors.d.ts.map

package/dist/src/errors.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../../src/errors.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH;;GAEG;AACH,qBAAa,QAAS,SAAQ,KAAK;gBACrB,OAAO,EAAE,MAAM;CAI5B;AAED;;GAEG;AACH,qBAAa,mBAAoB,SAAQ,QAAQ;IACxC,WAAW,EAAE,MAAM,CAAC;gBAGzB,WAAW,EAAE,MAAM,EACnB,OAAO,CAAC,EAAE,MAAM;CASnB;AAED;;GAEG;AACH,qBAAa,WAAY,SAAQ,QAAQ;IAI9B,OAAO,EAAE,MAAM;IAHjB,WAAW,EAAE,MAAM,EAAE,CAAC;gBAGpB,OAAO,EAAE,MAAM,EACtB,WAAW,CAAC,EAAE,MAAM,EAAE;CAWzB;AAED;;GAEG;AACH,qBAAa,oBAAqB,SAAQ,QAAQ;gBACpC,OAAO,EAAE,MAAM;CAI5B;AAED;;GAEG;AACH,qBAAa,eAAgB,SAAQ,QAAQ;gBAC/B,OAAO,EAAE,MAAM;CAI5B"}

package/dist/src/errors.js

@@ -0,0 +1,63 @@
+/**
+ * OCP Error Hierarchy
+ *
+ * Consistent error handling for the Open Context Protocol library.
+ * Provides specific exception types for different failure scenarios.
+ */
+/**
+ * Base exception for all OCP-related errors
+ */
+export class OCPError extends Error {
+    constructor(message) {
+        super(message);
+        this.name = 'OCPError';
+    }
+}
+/**
+ * Registry service is unreachable or returned an error
+ */
+export class RegistryUnavailable extends OCPError {
+    constructor(registryUrl, message) {
+        const fullMessage = message
+            ? `Registry unavailable at ${registryUrl}: ${message}`
+            : `Registry unavailable at ${registryUrl}. Use spec_url for direct discovery.`;
+        super(fullMessage);
+        this.name = 'RegistryUnavailable';
+        this.registryUrl = registryUrl;
+    }
+}
+/**
+ * API not found in the registry
+ */
+export class APINotFound extends OCPError {
+    constructor(apiName, suggestions) {
+        const suggestionList = suggestions || [];
+        let message = `API '${apiName}' not found in registry`;
+        if (suggestionList.length > 0) {
+            message += `. Did you mean: ${suggestionList.slice(0, 3).join(', ')}?`;
+        }
+        super(message);
+        this.apiName = apiName;
+        this.name = 'APINotFound';
+        this.suggestions = suggestionList;
+    }
+}
+/**
+ * OpenAPI schema discovery and parsing errors
+ */
+export class SchemaDiscoveryError extends OCPError {
+    constructor(message) {
+        super(message);
+        this.name = 'SchemaDiscoveryError';
+    }
+}
+/**
+ * Context or parameter validation errors
+ */
+export class ValidationError extends OCPError {
+    constructor(message) {
+        super(message);
+        this.name = 'ValidationError';
+    }
+}
+//# sourceMappingURL=errors.js.map

package/dist/src/errors.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.js","sourceRoot":"","sources":["../../src/errors.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH;;GAEG;AACH,MAAM,OAAO,QAAS,SAAQ,KAAK;IACjC,YAAY,OAAe;QACzB,KAAK,CAAC,OAAO,CAAC,CAAC;QACf,IAAI,CAAC,IAAI,GAAG,UAAU,CAAC;IACzB,CAAC;CACF;AAED;;GAEG;AACH,MAAM,OAAO,mBAAoB,SAAQ,QAAQ;IAG/C,YACE,WAAmB,EACnB,OAAgB;QAEhB,MAAM,WAAW,GAAG,OAAO;YACzB,CAAC,CAAC,2BAA2B,WAAW,KAAK,OAAO,EAAE;YACtD,CAAC,CAAC,2BAA2B,WAAW,sCAAsC,CAAC;QACjF,KAAK,CAAC,WAAW,CAAC,CAAC;QACnB,IAAI,CAAC,IAAI,GAAG,qBAAqB,CAAC;QAClC,IAAI,CAAC,WAAW,GAAG,WAAW,CAAC;IACjC,CAAC;CACF;AAED;;GAEG;AACH,MAAM,OAAO,WAAY,SAAQ,QAAQ;IAGvC,YACS,OAAe,EACtB,WAAsB;QAEtB,MAAM,cAAc,GAAG,WAAW,IAAI,EAAE,CAAC;QACzC,IAAI,OAAO,GAAG,QAAQ,OAAO,yBAAyB,CAAC;QACvD,IAAI,cAAc,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YAC9B,OAAO,IAAI,mBAAmB,cAAc,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC;QACzE,CAAC;QACD,KAAK,CAAC,OAAO,CAAC,CAAC;QARR,YAAO,GAAP,OAAO,CAAQ;QAStB,IAAI,CAAC,IAAI,GAAG,aAAa,CAAC;QAC1B,IAAI,CAAC,WAAW,GAAG,cAAc,CAAC;IACpC,CAAC;CACF;AAED;;GAEG;AACH,MAAM,OAAO,oBAAqB,SAAQ,QAAQ;IAChD,YAAY,OAAe;QACzB,KAAK,CAAC,OAAO,CAAC,CAAC;QACf,IAAI,CAAC,IAAI,GAAG,sBAAsB,CAAC;IACrC,CAAC;CACF;AAED;;GAEG;AACH,MAAM,OAAO,eAAgB,SAAQ,QAAQ;IAC3C,YAAY,OAAe;QACzB,KAAK,CAAC,OAAO,CAAC,CAAC;QACf,IAAI,CAAC,IAAI,GAAG,iBAAiB,CAAC;IAChC,CAAC;CACF"}

package/dist/src/headers.d.ts

@@ -0,0 +1,63 @@
+/**
+ * OCP Headers - HTTP header management for Open Context Protocol.
+ *
+ * Handles encoding/decoding agent context into HTTP headers and validation.
+ */
+import { AgentContext } from './context.js';
+export declare const OCP_CONTEXT_ID = "OCP-Context-ID";
+export declare const OCP_SESSION = "OCP-Session";
+export declare const OCP_CURRENT_GOAL = "OCP-Current-Goal";
+export declare const OCP_AGENT_TYPE = "OCP-Agent-Type";
+export declare const OCP_USER = "OCP-User";
+export declare const OCP_WORKSPACE = "OCP-Workspace";
+export declare const OCP_VERSION = "OCP-Version";
+export declare const OCP_SPEC_VERSION = "1.0";
+/**
+ * Manages OCP HTTP headers for agent context transmission.
+ *
+ * Handles encoding agent context into HTTP headers and decoding
+ * received headers back into context objects.
+ */
+export declare class OCPHeaders {
+    /**
+     * Encode AgentContext into OCP HTTP headers
+     */
+    static encodeContext(context: AgentContext, compress?: boolean): Record<string, string>;
+    /**
+     * Decode OCP headers back into an AgentContext object
+     */
+    static decodeContext(headers: Record<string, string>): AgentContext | null;
+    /**
+     * Validate that headers contain valid OCP context
+     */
+    static validateHeaders(headers: Record<string, string>): boolean;
+    /**
+     * Get a human-readable summary of the OCP context from headers
+     */
+    static getContextSummary(headers: Record<string, string>): string;
+    /**
+     * Merge OCP headers with existing HTTP headers
+     */
+    static mergeHeaders(baseHeaders: Record<string, string>, ocpHeaders: Record<string, string>): Record<string, string>;
+    /**
+     * Remove OCP headers from a headers dictionary
+     */
+    static stripOCPHeaders(headers: Record<string, string>): Record<string, string>;
+}
+/**
+ * Convenience function to create OCP headers from context
+ */
+export declare function createOCPHeaders(context: AgentContext, baseHeaders?: Record<string, string>, compress?: boolean): Record<string, string>;
+/**
+ * Extract OCP context from an HTTP response object
+ */
+export declare function extractContextFromResponse(response: any): AgentContext | null;
+/**
+ * Convenience function to parse OCP context from HTTP headers
+ */
+export declare function parseContext(headers: any): AgentContext | null;
+/**
+ * Convenience function to add OCP headers to HTTP response objects
+ */
+export declare function addContextHeaders(response: any, context: AgentContext, compress?: boolean): void;
+//# sourceMappingURL=headers.d.ts.map

package/dist/src/headers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"headers.d.ts","sourceRoot":"","sources":["../../src/headers.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAGH,OAAO,EAAE,YAAY,EAAE,MAAM,cAAc,CAAC;AAG5C,eAAO,MAAM,cAAc,mBAAmB,CAAC;AAC/C,eAAO,MAAM,WAAW,gBAAgB,CAAC;AACzC,eAAO,MAAM,gBAAgB,qBAAqB,CAAC;AACnD,eAAO,MAAM,cAAc,mBAAmB,CAAC;AAC/C,eAAO,MAAM,QAAQ,aAAa,CAAC;AACnC,eAAO,MAAM,aAAa,kBAAkB,CAAC;AAC7C,eAAO,MAAM,WAAW,gBAAgB,CAAC;AAGzC,eAAO,MAAM,gBAAgB,QAAQ,CAAC;AAEtC;;;;;GAKG;AACH,qBAAa,UAAU;IACrB;;OAEG;IACH,MAAM,CAAC,aAAa,CAAC,OAAO,EAAE,YAAY,EAAE,QAAQ,GAAE,OAAc,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC;IAsC7F;;OAEG;IACH,MAAM,CAAC,aAAa,CAAC,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,YAAY,GAAG,IAAI;IAoC1E;;OAEG;IACH,MAAM,CAAC,eAAe,CAAC,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,OAAO;IAiBhE;;OAEG;IACH,MAAM,CAAC,iBAAiB,CAAC,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,MAAM;IAejE;;OAEG;IACH,MAAM,CAAC,YAAY,CACjB,WAAW,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,EACnC,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GACjC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC;IAIzB;;OAEG;IACH,MAAM,CAAC,eAAe,CAAC,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC;CAmBhF;AAED;;GAEG;AACH,wBAAgB,gBAAgB,CAC9B,OAAO,EAAE,YAAY,EACrB,WAAW,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,EACpC,QAAQ,GAAE,OAAc,GACvB,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAQxB;AAED;;GAEG;AACH,wBAAgB,0BAA0B,CAAC,QAAQ,EAAE,GAAG,GAAG,YAAY,GAAG,IAAI,CAoB7E;AAED;;GAEG;AACH,wBAAgB,YAAY,CAAC,OAAO,EAAE,GAAG,GAAG,YAAY,GAAG,IAAI,CAkB9D;AAED;;GAEG;AACH,wBAAgB,iBAAiB,CAC/B,QAAQ,EAAE,GAAG,EACb,OAAO,EAAE,YAAY,EACrB,QAAQ,GAAE,OAAc,GACvB,IAAI,CAuBN"}