agentfootprint 1.0.0

package/dist/esm/adapters/browser/BrowserOpenAIAdapter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"BrowserOpenAIAdapter.js","sourceRoot":"","sources":["../../../../src/adapters/browser/BrowserOpenAIAdapter.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;GAsBG;AAaH,OAAO,EAAE,QAAQ,EAAE,kBAAkB,EAAE,MAAM,oBAAoB,CAAC;AAmElE,gEAAgE;AAEhE,MAAM,cAAc,GAAG,4CAA4C,CAAC;AAapE,MAAM,OAAO,oBAAoB;IACd,MAAM,CAAS;IACf,KAAK,CAAS;IACd,gBAAgB,CAAU;IAC1B,OAAO,CAAS;IAEjC,YAAY,OAAoC;QAC9C,IAAI,CAAC,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;QAC7B,IAAI,CAAC,KAAK,GAAG,OAAO,CAAC,KAAK,CAAC;QAC3B,IAAI,CAAC,gBAAgB,GAAG,OAAO,CAAC,SAAS,CAAC;QAC1C,IAAI,CAAC,OAAO,GAAG,OAAO,CAAC,OAAO,IAAI,cAAc,CAAC;IACnD,CAAC;IAED,KAAK,CAAC,IAAI,CAAC,QAAmB,EAAE,OAAwB;QACtD,MAAM,IAAI,GAAG,IAAI,CAAC,SAAS,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC;QAE/C,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,QAAQ,CAAC,IAAI,EAAE,OAAO,EAAE,MAAM,CAAC,CAAC;QAC5D,MAAM,IAAI,GAAG,CAAC,MAAM,QAAQ,CAAC,IAAI,EAAE,CAAyB,CAAC;QAC7D,OAAO,eAAe,CAAC,IAAI,CAAC,CAAC;IAC/B,CAAC;IAED,KAAK,CAAC,CAAC,UAAU,CAAC,QAAmB,EAAE,OAAwB;QAC7D,MAAM,IAAI,GAAG,IAAI,CAAC,SAAS,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC;QAC/C,IAAI,CAAC,MAAM,GAAG,IAAI,CAAC;QACnB,IAAI,CAAC,cAAc,GAAG,EAAE,aAAa,EAAE,IAAI,EAAE,CAAC;QAE9C,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,QAAQ,CAAC,IAAI,EAAE,OAAO,EAAE,MAAM,CAAC,CAAC;QAC5D,MAAM,MAAM,GAAG,QAAQ,CAAC,IAAI,EAAE,SAAS,EAAE,CAAC;QAC1C,IAAI,CAAC,MAAM;YAAE,MAAM,IAAI,QAAQ,CAAC,EAAE,OAAO,EAAE,gCAAgC,EAAE,IAAI,EAAE,SAAS,EAAE,QAAQ,EAAE,gBAAgB,EAAE,CAAC,CAAC;QAE5H,MAAM,OAAO,GAAG,IAAI,WAAW,EAAE,CAAC;QAClC,IAAI,MAAM,GAAG,EAAE,CAAC;QAChB,MAAM,mBAAmB,GAA4D,IAAI,GAAG,EAAE,CAAC;QAE/F,IAAI,CAAC;YACH,OAAO,IAAI,EAAE,CAAC;gBACZ,MAAM,EAAE,IAAI,EAAE,KAAK,EAAE,GAAG,MAAM,MAAM,CAAC,IAAI,EAAE,CAAC;gBAC5C,IAAI,IAAI;oBAAE,MAAM;gBAEhB,MAAM,IAAI,OAAO,CAAC,MAAM,CAAC,KAAK,EAAE,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC;gBAClD,MAAM,KAAK,GAAG,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;gBACjC,MAAM,GAAG,KAAK,CAAC,GAAG,EAAE,IAAI,EAAE,CAAC;gBAE3B,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;oBACzB,IAAI,CAAC,IAAI,CAAC,UAAU,CAAC,QAAQ,CAAC;wBAAE,SAAS;oBACzC,MAAM,IAAI,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC;oBAClC,IAAI,IAAI,KAAK,QAAQ;wBAAE,SAAS;oBAEhC,IAAI,KAkBH,CAAC;oBACF,IAAI,CAAC;wBACH,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;oBAC3B,CAAC;oBAAC,MAAM,CAAC;wBACP,SAAS;oBACX,CAAC;oBAED,MAAM,MAAM,GAAG,KAAK,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC,CAAC;oBAElC,aAAa;oBACb,IAAI,MAAM,EAAE,KAAK,EAAE,OAAO,EAAE,CAAC;wBAC3B,MAAM,EAAE,IAAI,EAAE,OAAO,EAAE,OAAO,EAAE,MAAM,CAAC,KAAK,CAAC,OAAO,EAAE,CAAC;oBACzD,CAAC;oBAED,mBAAmB;oBACnB,IAAI,MAAM,EAAE,KAAK,EAAE,UAAU,EAAE,CAAC;wBAC9B,KAAK,MAAM,EAAE,IAAI,MAAM,CAAC,KAAK,CAAC,UAAU,EAAE,CAAC;4BACzC,IAAI,CAAC,mBAAmB,CAAC,GAAG,CAAC,EAAE,CAAC,KAAK,CAAC,EAAE,CAAC;gCACvC,mBAAmB,CAAC,GAAG,CAAC,EAAE,CAAC,KAAK,EAAE,EAAE,EAAE,EAAE,EAAE,CAAC,EAAE,IAAI,EAAE,EAAE,IAAI,EAAE,EAAE,EAAE,IAAI,EAAE,EAAE,EAAE,CAAC,CAAC;4BAC7E,CAAC;4BACD,MAAM,GAAG,GAAG,mBAAmB,CAAC,GAAG,CAAC,EAAE,CAAC,KAAK,CAAE,CAAC;4BAC/C,IAAI,EAAE,CAAC,EAAE;gCAAE,GAAG,CAAC,EAAE,GAAG,EAAE,CAAC,EAAE,CAAC;4BAC1B,IAAI,EAAE,CAAC,QAAQ,EAAE,IAAI;gCAAE,GAAG,CAAC,IAAI,GAAG,EAAE,CAAC,QAAQ,CAAC,IAAI,CAAC;4BACnD,IAAI,EAAE,CAAC,QAAQ,EAAE,SAAS;gCAAE,GAAG,CAAC,IAAI,IAAI,EAAE,CAAC,QAAQ,CAAC,SAAS,CAAC;wBAChE,CAAC;oBACH,CAAC;oBAED,0CAA0C;oBAC1C,IAAI,KAAK,CAAC,KAAK,EAAE,CAAC;wBAChB,MAAM;4BACJ,IAAI,EAAE,OAAO;4BACb,KAAK,EAAE;gCACL,WAAW,EAAE,KAAK,CAAC,KAAK,CAAC,aAAa;gCACtC,YAAY,EAAE,KAAK,CAAC,KAAK,CAAC,iBAAiB;gCAC3C,WAAW,EAAE,KAAK,CAAC,KAAK,CAAC,YAAY;6BACtC;yBACF,CAAC;oBACJ,CAAC;oBAED,wCAAwC;oBACxC,IAAI,MAAM,EAAE,aAAa,KAAK,YAAY,EAAE,CAAC;wBAC3C,KAAK,MAAM,CAAC,EAAE,EAAE,CAAC,IAAI,mBAAmB,EAAE,CAAC;4BACzC,IAAI,IAAI,GAA4B,EAAE,CAAC;4BACvC,IAAI,CAAC;gCACH,IAAI,GAAG,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC,IAAI,CAAC,CAAC;4BAC7B,CAAC;4BAAC,MAAM,CAAC;gCACP,IAAI,GAAG,EAAE,IAAI,EAAE,EAAE,CAAC,IAAI,EAAE,CAAC;4BAC3B,CAAC;4BACD,MAAM;gCACJ,IAAI,EAAE,WAAW;gCACjB,QAAQ,EAAE,EAAE,EAAE,EAAE,EAAE,CAAC,EAAE,EAAE,IAAI,EAAE,EAAE,CAAC,IAAI,EAAE,SAAS,EAAE,IAAI,EAAE;6BACxD,CAAC;wBACJ,CAAC;oBACH,CAAC;gBACH,CAAC;YACH,CAAC;QACH,CAAC;gBAAS,CAAC;YACT,MAAM,CAAC,WAAW,EAAE,CAAC;QACvB,CAAC;QAED,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,CAAC;IACzB,CAAC;IAEO,SAAS,CAAC,QAAmB,EAAE,OAAwB;QAC7D,MAAM,cAAc,GAAG,eAAe,CAAC,QAAQ,CAAC,CAAC;QACjD,MAAM,KAAK,GAAG,OAAO,EAAE,KAAK,EAAE,GAAG,CAAC,WAAW,CAAC,CAAC;QAE/C,OAAO;YACL,KAAK,EAAE,IAAI,CAAC,KAAK;YACjB,QAAQ,EAAE,cAAc;YACxB,GAAG,CAAC,KAAK,IAAI,KAAK,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;YAC/C,GAAG,CAAC,OAAO,EAAE,SAAS,IAAI,IAAI,CAAC,gBAAgB;gBAC7C,CAAC,CAAC,EAAE,UAAU,EAAE,OAAO,EAAE,SAAS,IAAI,IAAI,CAAC,gBAAgB,EAAE;gBAC7D,CAAC,CAAC,EAAE,CAAC;YACP,GAAG,CAAC,OAAO,EAAE,WAAW,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,WAAW,EAAE,OAAO,CAAC,WAAW,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;YACnF,GAAG,CAAC,OAAO,EAAE,IAAI,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,OAAO,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;SACjD,CAAC;IACJ,CAAC;IAEO,KAAK,CAAC,QAAQ,CAAC,IAAuB,EAAE,MAAoB;QAClE,IAAI,QAAkB,CAAC;QACvB,IAAI,CAAC;YACH,QAAQ,GAAG,MAAM,KAAK,CAAC,IAAI,CAAC,OAAO,EAAE;gBACnC,MAAM,EAAE,MAAM;gBACd,OAAO,EAAE;oBACP,cAAc,EAAE,kBAAkB;oBAClC,eAAe,EAAE,UAAU,IAAI,CAAC,MAAM,EAAE;iBACzC;gBACD,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC;gBAC1B,MAAM;aACP,CAAC,CAAC;QACL,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,MAAM,KAAK,GAAG,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,KAAK,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC;YAClE,IAAI,KAAK,CAAC,IAAI,KAAK,YAAY,EAAE,CAAC;gBAChC,MAAM,IAAI,QAAQ,CAAC,EAAE,OAAO,EAAE,iBAAiB,EAAE,IAAI,EAAE,SAAS,EAAE,QAAQ,EAAE,gBAAgB,EAAE,KAAK,EAAE,KAAK,EAAE,CAAC,CAAC;YAChH,CAAC;YACD,MAAM,IAAI,QAAQ,CAAC,EAAE,OAAO,EAAE,KAAK,CAAC,OAAO,EAAE,IAAI,EAAE,SAAS,EAAE,QAAQ,EAAE,gBAAgB,EAAE,KAAK,EAAE,KAAK,EAAE,CAAC,CAAC;QAC5G,CAAC;QAED,IAAI,CAAC,QAAQ,CAAC,EAAE,EAAE,CAAC;YACjB,IAAI,YAAY,GAAG,qBAAqB,QAAQ,CAAC,MAAM,EAAE,CAAC;YAC1D,IAAI,CAAC;gBACH,MAAM,SAAS,GAAG,MAAM,QAAQ,CAAC,IAAI,EAAsC,CAAC;gBAC5E,IAAI,SAAS,CAAC,KAAK,EAAE,OAAO,EAAE,CAAC;oBAC7B,YAAY,GAAG,SAAS,CAAC,KAAK,CAAC,OAAO,CAAC;gBACzC,CAAC;YACH,CAAC;YAAC,MAAM,CAAC;gBACP,qBAAqB;YACvB,CAAC;YACD,MAAM,IAAI,QAAQ,CAAC;gBACjB,OAAO,EAAE,YAAY;gBACrB,IAAI,EAAE,kBAAkB,CAAC,QAAQ,CAAC,MAAM,CAAC;gBACzC,QAAQ,EAAE,gBAAgB;gBAC1B,UAAU,EAAE,QAAQ,CAAC,MAAM;aAC5B,CAAC,CAAC;QACL,CAAC;QAED,OAAO,QAAQ,CAAC;IAClB,CAAC;CACF;AAED,gEAAgE;AAEhE,SAAS,cAAc,CAAC,OAAuB;IAC7C,IAAI,OAAO,OAAO,KAAK,QAAQ;QAAE,OAAO,OAAO,CAAC;IAEhD,MAAM,KAAK,GAAwB,EAAE,CAAC;IACtC,KAAK,MAAM,KAAK,IAAI,OAAO,EAAE,CAAC;QAC5B,QAAQ,KAAK,CAAC,IAAI,EAAE,CAAC;YACnB,KAAK,MAAM;gBACT,KAAK,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,KAAK,CAAC,IAAI,EAAE,CAAC,CAAC;gBAC/C,MAAM;YACR,KAAK,OAAO;gBACV,IAAI,KAAK,CAAC,MAAM,CAAC,IAAI,KAAK,KAAK,EAAE,CAAC;oBAChC,KAAK,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,WAAW,EAAE,SAAS,EAAE,EAAE,GAAG,EAAE,KAAK,CAAC,MAAM,CAAC,GAAG,EAAE,EAAE,CAAC,CAAC;gBAC1E,CAAC;qBAAM,IAAI,KAAK,CAAC,MAAM,CAAC,IAAI,KAAK,QAAQ,EAAE,CAAC;oBAC1C,KAAK,CAAC,IAAI,CAAC;wBACT,IAAI,EAAE,WAAW;wBACjB,SAAS,EAAE,EAAE,GAAG,EAAE,QAAQ,KAAK,CAAC,MAAM,CAAC,SAAS,WAAW,KAAK,CAAC,MAAM,CAAC,IAAI,EAAE,EAAE;qBACjF,CAAC,CAAC;gBACL,CAAC;gBACD,MAAM;QACV,CAAC;IACH,CAAC;IAED,OAAO,KAAK,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,CAAC;AACzC,CAAC;AAED,SAAS,eAAe,CAAC,QAAmB;IAC1C,OAAO,QAAQ,CAAC,GAAG,CAAC,CAAC,GAAG,EAAiB,EAAE;QACzC,QAAQ,GAAG,CAAC,IAAI,EAAE,CAAC;YACjB,KAAK,QAAQ;gBACX,OAAO;oBACL,IAAI,EAAE,QAAQ;oBACd,OAAO,EAAE,OAAO,GAAG,CAAC,OAAO,KAAK,QAAQ,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,OAAO,CAAC;iBAC7E,CAAC;YAEJ,KAAK,MAAM;gBACT,OAAO;oBACL,IAAI,EAAE,MAAM;oBACZ,OAAO,EAAE,cAAc,CAAC,GAAG,CAAC,OAAO,CAAC;iBACrC,CAAC;YAEJ,KAAK,WAAW,CAAC,CAAC,CAAC;gBACjB,MAAM,SAAS,GAAiC,GAAG,CAAC,SAAS,EAAE,GAAG,CAAC,CAAC,EAAE,EAAE,EAAE,CAAC,CAAC;oBAC1E,EAAE,EAAE,EAAE,CAAC,EAAE;oBACT,IAAI,EAAE,UAAmB;oBACzB,QAAQ,EAAE;wBACR,IAAI,EAAE,EAAE,CAAC,IAAI;wBACb,SAAS,EAAE,IAAI,CAAC,SAAS,CAAC,EAAE,CAAC,SAAS,CAAC;qBACxC;iBACF,CAAC,CAAC,CAAC;gBAEJ,OAAO;oBACL,IAAI,EAAE,WAAW;oBACjB,OAAO,EAAE,OAAO,GAAG,CAAC,OAAO,KAAK,QAAQ,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,IAAI;oBAC7D,GAAG,CAAC,SAAS,IAAI,SAAS,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,EAAE,UAAU,EAAE,SAAS,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;iBACxE,CAAC;YACJ,CAAC;YAED,KAAK,MAAM;gBACT,OAAO;oBACL,IAAI,EAAE,MAAM;oBACZ,OAAO,EAAE,OAAO,GAAG,CAAC,OAAO,KAAK,QAAQ,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,OAAO,CAAC;oBAC5E,YAAY,EAAE,GAAG,CAAC,UAAU;iBAC7B,CAAC;QACN,CAAC;IACH,CAAC,CAAC,CAAC;AACL,CAAC;AAED,SAAS,WAAW,CAAC,IAAwB;IAC3C,OAAO;QACL,IAAI,EAAE,UAAU;QAChB,QAAQ,EAAE;YACR,IAAI,EAAE,IAAI,CAAC,IAAI;YACf,WAAW,EAAE,IAAI,CAAC,WAAW;YAC7B,UAAU,EAAE,IAAI,CAAC,WAAW;SAC7B;KACF,CAAC;AACJ,CAAC;AAED,SAAS,eAAe,CAAC,QAA8B;IACrD,MAAM,MAAM,GAAG,QAAQ,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC;IACnC,IAAI,CAAC,MAAM,EAAE,CAAC;QACZ,OAAO,EAAE,OAAO,EAAE,EAAE,EAAE,YAAY,EAAE,OAAO,EAAE,CAAC;IAChD,CAAC;IAED,MAAM,SAAS,GAA2B,MAAM,CAAC,OAAO,CAAC,UAAU,EAAE,GAAG,CAAC,CAAC,EAAE,EAAE,EAAE;QAC9E,IAAI,IAAI,GAA4B,EAAE,CAAC;QACvC,IAAI,CAAC;YACH,IAAI,GAAG,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC,QAAQ,CAAC,SAAS,CAAC,CAAC;QAC3C,CAAC;QAAC,MAAM,CAAC;YACP,IAAI,GAAG,EAAE,IAAI,EAAE,EAAE,CAAC,QAAQ,CAAC,SAAS,EAAE,CAAC;QACzC,CAAC;QAED,OAAO;YACL,EAAE,EAAE,EAAE,CAAC,EAAE;YACT,IAAI,EAAE,EAAE,CAAC,QAAQ,CAAC,IAAI;YACtB,SAAS,EAAE,IAAI;SAChB,CAAC;IACJ,CAAC,CAAC,CAAC;IAEH,MAAM,YAAY,GAChB,MAAM,CAAC,aAAa,KAAK,YAAY;QACnC,CAAC,CAAC,YAAY;QACd,CAAC,CAAC,MAAM,CAAC,aAAa,KAAK,QAAQ;YACnC,CAAC,CAAC,QAAQ;YACV,CAAC,CAAC,MAAM,CAAC,aAAa,KAAK,gBAAgB;gBAC3C,CAAC,CAAC,OAAO;gBACT,CAAC,CAAC,MAAM,CAAC;IAEb,MAAM,KAAK,GAA2B,QAAQ,CAAC,KAAK;QAClD,CAAC,CAAC;YACE,WAAW,EAAE,QAAQ,CAAC,KAAK,CAAC,aAAa;YACzC,YAAY,EAAE,QAAQ,CAAC,KAAK,CAAC,iBAAiB;YAC9C,WAAW,EAAE,QAAQ,CAAC,KAAK,CAAC,YAAY;SACzC;QACH,CAAC,CAAC,SAAS,CAAC;IAEd,OAAO;QACL,OAAO,EAAE,MAAM,CAAC,OAAO,CAAC,OAAO,IAAI,EAAE;QACrC,SAAS,EAAE,SAAS,IAAI,SAAS,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,SAAS;QACpE,KAAK;QACL,KAAK,EAAE,QAAQ,CAAC,KAAK;QACrB,YAAY,EAAE,YAA2C;KAC1D,CAAC;AACJ,CAAC"}

package/dist/esm/adapters/browser/index.js

@@ -0,0 +1,3 @@
+export { BrowserAnthropicAdapter } from './BrowserAnthropicAdapter';
+export { BrowserOpenAIAdapter } from './BrowserOpenAIAdapter';
+//# sourceMappingURL=index.js.map

package/dist/esm/adapters/browser/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/adapters/browser/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,uBAAuB,EAAE,MAAM,2BAA2B,CAAC;AAEpE,OAAO,EAAE,oBAAoB,EAAE,MAAM,wBAAwB,CAAC"}

package/dist/esm/adapters/createAdapterSubflow.js

@@ -0,0 +1,42 @@
+/**
+ * Creates a 3-stage adapter subflow (FormatRequest → ExecuteCall → MapResponse).
+ *
+ * This is the key architectural insight: the adapter is a FlowChart subflow.
+ * Swapping mock for real only changes the ExecuteCall stage.
+ * The rest of the agent flowchart runs identically.
+ */
+import { flowChart } from 'footprintjs';
+import { normalizeAdapterResponse } from '../stages/helpers';
+/**
+ * Build a 3-stage subflow for LLM calls.
+ *
+ * Stage 1 (FormatRequest): Read messages + tools from scope → write adapter request
+ * Stage 2 (ExecuteCall): Call provider.chat() → write raw response
+ * Stage 3 (MapResponse): Normalize to AdapterResult → write result
+ */
+export function createAdapterSubflow(config) {
+    const adapterId = config.id ?? 'llm-adapter';
+    const formatRequest = (scope) => {
+        const messages = scope.messages;
+        const tools = scope.toolDescriptions ?? [];
+        if (!messages || messages.length === 0) {
+            throw new Error('AdapterSubflow: no messages in scope');
+        }
+        scope.adapterRequest = { messages, tools };
+    };
+    const executeCall = async (scope) => {
+        const request = scope.adapterRequest;
+        const options = request.tools.length > 0 ? { tools: request.tools } : undefined;
+        const response = await config.provider.chat(request.messages, options);
+        scope.adapterRawResponse = response;
+    };
+    const mapResponse = (scope) => {
+        const response = scope.adapterRawResponse;
+        scope.adapterResult = normalizeAdapterResponse(response);
+    };
+    return flowChart('FormatRequest', formatRequest, `${adapterId}-format`)
+        .addFunction('ExecuteCall', executeCall, `${adapterId}-call`)
+        .addFunction('MapResponse', mapResponse, `${adapterId}-map`)
+        .build();
+}
+//# sourceMappingURL=createAdapterSubflow.js.map

package/dist/esm/adapters/createAdapterSubflow.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"createAdapterSubflow.js","sourceRoot":"","sources":["../../../src/adapters/createAdapterSubflow.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AAIxC,OAAO,EAAE,wBAAwB,EAAE,MAAM,mBAAmB,CAAC;AAkB7D;;;;;;GAMG;AACH,MAAM,UAAU,oBAAoB,CAAC,MAA4B;IAC/D,MAAM,SAAS,GAAG,MAAM,CAAC,EAAE,IAAI,aAAa,CAAC;IAE7C,MAAM,aAAa,GAAG,CAAC,KAAsC,EAAE,EAAE;QAC/D,MAAM,QAAQ,GAAG,KAAK,CAAC,QAAQ,CAAC;QAChC,MAAM,KAAK,GAAG,KAAK,CAAC,gBAAgB,IAAI,EAAE,CAAC;QAE3C,IAAI,CAAC,QAAQ,IAAI,QAAQ,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YACvC,MAAM,IAAI,KAAK,CAAC,sCAAsC,CAAC,CAAC;QAC1D,CAAC;QAED,KAAK,CAAC,cAAc,GAAG,EAAE,QAAQ,EAAE,KAAK,EAAE,CAAC;IAC7C,CAAC,CAAC;IAEF,MAAM,WAAW,GAAG,KAAK,EAAE,KAAsC,EAAE,EAAE;QACnE,MAAM,OAAO,GAAG,KAAK,CAAC,cAAc,CAAC;QAErC,MAAM,OAAO,GAAG,OAAO,CAAC,KAAK,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,OAAO,CAAC,KAAK,EAAE,CAAC,CAAC,CAAC,SAAS,CAAC;QAChF,MAAM,QAAQ,GAAG,MAAM,MAAM,CAAC,QAAQ,CAAC,IAAI,CAAC,OAAO,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC;QAEvE,KAAK,CAAC,kBAAkB,GAAG,QAAQ,CAAC;IACtC,CAAC,CAAC;IAEF,MAAM,WAAW,GAAG,CAAC,KAAsC,EAAE,EAAE;QAC7D,MAAM,QAAQ,GAAG,KAAK,CAAC,kBAAkB,CAAC;QAC1C,KAAK,CAAC,aAAa,GAAG,wBAAwB,CAAC,QAAQ,CAAC,CAAC;IAC3D,CAAC,CAAC;IAEF,OAAO,SAAS,CAAsB,eAAe,EAAE,aAAa,EAAE,GAAG,SAAS,SAAS,CAAC;SACzF,WAAW,CAAC,aAAa,EAAE,WAAW,EAAE,GAAG,SAAS,OAAO,CAAC;SAC5D,WAAW,CAAC,aAAa,EAAE,WAAW,EAAE,GAAG,SAAS,MAAM,CAAC;SAC3D,KAAK,EAAE,CAAC;AACb,CAAC"}

package/dist/esm/adapters/createProvider.js

@@ -0,0 +1,101 @@
+/**
+ * createProvider — bridges ModelConfig → LLMProvider.
+ *
+ * Resolves a ModelConfig (from anthropic(), openai(), ollama(), bedrock())
+ * into the appropriate adapter instance.
+ *
+ * Usage:
+ *   import { createProvider, anthropic } from 'agentfootprint';
+ *
+ *   // Config-based (simple DX):
+ *   const provider = createProvider(anthropic('claude-sonnet-4-20250514'));
+ *
+ *   // With options:
+ *   const provider = createProvider(openai('gpt-4o', { apiKey: 'sk-...' }));
+ *
+ *   // Ollama (auto-configured):
+ *   const provider = createProvider(ollama('llama3'));
+ *
+ *   // Bedrock with region:
+ *   const provider = createProvider(bedrock('anthropic.claude-sonnet-4-20250514-v1:0', { region: 'us-east-1' }));
+ */
+import { AnthropicAdapter } from './anthropic/AnthropicAdapter';
+import { OpenAIAdapter } from './openai/OpenAIAdapter';
+import { BedrockAdapter } from './bedrock/BedrockAdapter';
+import { MockAdapter } from './mock/MockAdapter';
+/**
+ * Check if the value is already an LLMProvider (has a `.chat` method).
+ * Used for auto-detection in Agent.create(), LLMCall.create(), etc.
+ */
+export function isLLMProvider(value) {
+    return typeof value === 'object' && value !== null && typeof value.chat === 'function';
+}
+/**
+ * Resolve a provider-or-config to an LLMProvider.
+ *
+ * Accepts either an LLMProvider directly or a ModelConfig (from anthropic(), openai(), etc.).
+ * This enables:
+ *   Agent.create({ provider: anthropic('claude-sonnet-4-20250514') })
+ * without wrapping in createProvider().
+ */
+export function resolveProvider(providerOrConfig) {
+    if (isLLMProvider(providerOrConfig))
+        return providerOrConfig;
+    return createProvider(providerOrConfig);
+}
+/**
+ * Create an LLMProvider from a ModelConfig.
+ *
+ * Maps provider factories (anthropic(), openai(), ollama(), bedrock())
+ * to their real adapter implementations.
+ */
+export function createProvider(config) {
+    switch (config.provider) {
+        case 'anthropic':
+            return new AnthropicAdapter({
+                model: config.modelId,
+                apiKey: config.apiKey,
+                maxTokens: config.options?.maxTokens,
+                _client: config._client,
+            });
+        case 'openai':
+            return new OpenAIAdapter({
+                model: config.modelId,
+                apiKey: config.apiKey,
+                baseURL: config.baseUrl,
+                maxTokens: config.options?.maxTokens,
+                _client: config._client,
+            });
+        case 'ollama':
+            try {
+                return new OpenAIAdapter({
+                    model: config.modelId,
+                    baseURL: config.baseUrl ?? 'http://localhost:11434/v1',
+                    maxTokens: config.options?.maxTokens,
+                    _client: config._client,
+                });
+            }
+            catch (err) {
+                // OpenAIAdapter throws its own clear message if 'openai' package is missing.
+                // Re-wrap to mention Ollama specifically so the user knows which adapter failed.
+                if (err instanceof Error && err.message.includes('openai')) {
+                    throw new Error('Ollama adapter requires the "openai" package (OpenAI-compatible API).\n' +
+                        'Install it: npm install openai');
+                }
+                throw err;
+            }
+        case 'bedrock':
+            return new BedrockAdapter({
+                model: config.modelId,
+                region: config.region,
+                maxTokens: config.options?.maxTokens,
+                _client: config._client,
+            });
+        case 'mock':
+            return new MockAdapter([]);
+        default:
+            throw new Error(`Unknown provider "${config.provider}". ` +
+                'Supported: anthropic, openai, ollama, bedrock, mock.');
+    }
+}
+//# sourceMappingURL=createProvider.js.map

package/dist/esm/adapters/createProvider.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"createProvider.js","sourceRoot":"","sources":["../../../src/adapters/createProvider.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;GAoBG;AAIH,OAAO,EAAE,gBAAgB,EAAE,MAAM,8BAA8B,CAAC;AAChE,OAAO,EAAE,aAAa,EAAE,MAAM,wBAAwB,CAAC;AACvD,OAAO,EAAE,cAAc,EAAE,MAAM,0BAA0B,CAAC;AAC1D,OAAO,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AAEjD;;;GAGG;AACH,MAAM,UAAU,aAAa,CAAC,KAAc;IAC1C,OAAO,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,KAAK,IAAI,IAAI,OAAQ,KAAqB,CAAC,IAAI,KAAK,UAAU,CAAC;AAC1G,CAAC;AAED;;;;;;;GAOG;AACH,MAAM,UAAU,eAAe,CAAC,gBAA2C;IACzE,IAAI,aAAa,CAAC,gBAAgB,CAAC;QAAE,OAAO,gBAAgB,CAAC;IAC7D,OAAO,cAAc,CAAC,gBAAuD,CAAC,CAAC;AACjF,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,cAAc,CAC5B,MAA2C;IAE3C,QAAQ,MAAM,CAAC,QAAQ,EAAE,CAAC;QACxB,KAAK,WAAW;YACd,OAAO,IAAI,gBAAgB,CAAC;gBAC1B,KAAK,EAAE,MAAM,CAAC,OAAO;gBACrB,MAAM,EAAE,MAAM,CAAC,MAAM;gBACrB,SAAS,EAAE,MAAM,CAAC,OAAO,EAAE,SAAS;gBACpC,OAAO,EAAE,MAAM,CAAC,OAAO;aACxB,CAAC,CAAC;QAEL,KAAK,QAAQ;YACX,OAAO,IAAI,aAAa,CAAC;gBACvB,KAAK,EAAE,MAAM,CAAC,OAAO;gBACrB,MAAM,EAAE,MAAM,CAAC,MAAM;gBACrB,OAAO,EAAE,MAAM,CAAC,OAAO;gBACvB,SAAS,EAAE,MAAM,CAAC,OAAO,EAAE,SAAS;gBACpC,OAAO,EAAE,MAAM,CAAC,OAAO;aACxB,CAAC,CAAC;QAEL,KAAK,QAAQ;YACX,IAAI,CAAC;gBACH,OAAO,IAAI,aAAa,CAAC;oBACvB,KAAK,EAAE,MAAM,CAAC,OAAO;oBACrB,OAAO,EAAE,MAAM,CAAC,OAAO,IAAI,2BAA2B;oBACtD,SAAS,EAAE,MAAM,CAAC,OAAO,EAAE,SAAS;oBACpC,OAAO,EAAE,MAAM,CAAC,OAAO;iBACxB,CAAC,CAAC;YACL,CAAC;YAAC,OAAO,GAAG,EAAE,CAAC;gBACb,6EAA6E;gBAC7E,iFAAiF;gBACjF,IAAI,GAAG,YAAY,KAAK,IAAI,GAAG,CAAC,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAC,EAAE,CAAC;oBAC3D,MAAM,IAAI,KAAK,CACb,yEAAyE;wBACzE,gCAAgC,CACjC,CAAC;gBACJ,CAAC;gBACD,MAAM,GAAG,CAAC;YACZ,CAAC;QAEH,KAAK,SAAS;YACZ,OAAO,IAAI,cAAc,CAAC;gBACxB,KAAK,EAAE,MAAM,CAAC,OAAO;gBACrB,MAAM,EAAE,MAAM,CAAC,MAAM;gBACrB,SAAS,EAAE,MAAM,CAAC,OAAO,EAAE,SAAS;gBACpC,OAAO,EAAE,MAAM,CAAC,OAAO;aACxB,CAAC,CAAC;QAEL,KAAK,MAAM;YACT,OAAO,IAAI,WAAW,CAAC,EAAE,CAAC,CAAC;QAE7B;YACE,MAAM,IAAI,KAAK,CACb,qBAAqB,MAAM,CAAC,QAAQ,KAAK;gBACvC,sDAAsD,CACzD,CAAC;IACN,CAAC;AACH,CAAC"}

package/dist/esm/adapters/fallbackProvider.js

@@ -0,0 +1,90 @@
+/**
+ * fallbackProvider — LLMProvider that tries providers in order until one succeeds.
+ *
+ * Wraps multiple LLMProviders into a single LLMProvider. On each chat() call,
+ * tries providers in order. If one fails (rate limit, timeout, network error),
+ * falls through to the next.
+ *
+ * Narrative integration: the response includes `model` from whichever provider
+ * succeeded — recorders capture this via onLLMCall.model, so the narrative
+ * reflects which provider actually answered. The onFallback callback fires
+ * during traversal (not post-processing) for immediate observability.
+ *
+ * Usage:
+ *   // Try Anthropic, fall back to OpenAI, then local Ollama
+ *   const provider = fallbackProvider([
+ *     new AnthropicAdapter({ model: 'claude-sonnet-4-20250514' }),
+ *     new OpenAIAdapter({ model: 'gpt-4o' }),
+ *     new OpenAIAdapter({ model: 'llama3', baseURL: 'http://localhost:11434/v1' }),
+ *   ]);
+ *
+ *   const agent = Agent.create({ provider }).system('...').build();
+ *
+ *   // With observability
+ *   const provider = fallbackProvider(
+ *     [anthropicAdapter, openaiAdapter],
+ *     {
+ *       onFallback: (fromIndex, toIndex, error) =>
+ *         console.warn(`Provider ${fromIndex} failed, trying ${toIndex}:`, error),
+ *       shouldFallback: (error) => {
+ *         // Only fall back on rate limits and network errors, not auth errors
+ *         if (error instanceof LLMError) return error.statusCode === 429 || error.statusCode >= 500;
+ *         return true;
+ *       },
+ *     },
+ *   );
+ */
+export function fallbackProvider(providers, options) {
+    if (providers.length === 0) {
+        throw new Error('[fallbackProvider] At least one provider is required.');
+    }
+    const { onFallback, shouldFallback = () => true } = options ?? {};
+    return {
+        chat: async (messages, callOptions) => {
+            let lastError;
+            for (let i = 0; i < providers.length; i++) {
+                try {
+                    return await providers[i].chat(messages, callOptions);
+                }
+                catch (error) {
+                    lastError = error;
+                    // Last provider — no more fallbacks
+                    if (i === providers.length - 1)
+                        break;
+                    // Check if we should fall back
+                    if (!shouldFallback(error))
+                        break;
+                    // Notify observer during traversal (not post-processing)
+                    onFallback?.(i, i + 1, error);
+                }
+            }
+            // All providers failed — throw the last error
+            throw lastError;
+        },
+        // Stream falls back the same way
+        chatStream: providers.some((p) => p.chatStream)
+            ? async function* (messages, callOptions) {
+                let lastError;
+                for (let i = 0; i < providers.length; i++) {
+                    const provider = providers[i];
+                    if (!provider.chatStream)
+                        continue;
+                    try {
+                        yield* provider.chatStream(messages, callOptions);
+                        return; // Success — stop trying
+                    }
+                    catch (error) {
+                        lastError = error;
+                        if (i === providers.length - 1)
+                            break;
+                        if (!shouldFallback(error))
+                            break;
+                        onFallback?.(i, i + 1, error);
+                    }
+                }
+                throw lastError;
+            }
+            : undefined,
+    };
+}
+//# sourceMappingURL=fallbackProvider.js.map

package/dist/esm/adapters/fallbackProvider.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"fallbackProvider.js","sourceRoot":"","sources":["../../../src/adapters/fallbackProvider.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAmCG;AAYH,MAAM,UAAU,gBAAgB,CAC9B,SAAiC,EACjC,OAAiC;IAEjC,IAAI,SAAS,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QAC3B,MAAM,IAAI,KAAK,CAAC,uDAAuD,CAAC,CAAC;IAC3E,CAAC;IAED,MAAM,EAAE,UAAU,EAAE,cAAc,GAAG,GAAG,EAAE,CAAC,IAAI,EAAE,GAAG,OAAO,IAAI,EAAE,CAAC;IAElE,OAAO;QACL,IAAI,EAAE,KAAK,EAAE,QAAmB,EAAE,WAA4B,EAAwB,EAAE;YACtF,IAAI,SAAkB,CAAC;YAEvB,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,SAAS,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;gBAC1C,IAAI,CAAC;oBACH,OAAO,MAAM,SAAS,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,QAAQ,EAAE,WAAW,CAAC,CAAC;gBACxD,CAAC;gBAAC,OAAO,KAAK,EAAE,CAAC;oBACf,SAAS,GAAG,KAAK,CAAC;oBAElB,oCAAoC;oBACpC,IAAI,CAAC,KAAK,SAAS,CAAC,MAAM,GAAG,CAAC;wBAAE,MAAM;oBAEtC,+BAA+B;oBAC/B,IAAI,CAAC,cAAc,CAAC,KAAK,CAAC;wBAAE,MAAM;oBAElC,yDAAyD;oBACzD,UAAU,EAAE,CAAC,CAAC,EAAE,CAAC,GAAG,CAAC,EAAE,KAAK,CAAC,CAAC;gBAChC,CAAC;YACH,CAAC;YAED,8CAA8C;YAC9C,MAAM,SAAS,CAAC;QAClB,CAAC;QAED,iCAAiC;QACjC,UAAU,EAAE,SAAS,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,UAAU,CAAC;YAC7C,CAAC,CAAC,KAAK,SAAS,CAAC,EAAE,QAAmB,EAAE,WAA4B;gBAChE,IAAI,SAAkB,CAAC;gBAEvB,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,SAAS,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;oBAC1C,MAAM,QAAQ,GAAG,SAAS,CAAC,CAAC,CAAC,CAAC;oBAC9B,IAAI,CAAC,QAAQ,CAAC,UAAU;wBAAE,SAAS;oBAEnC,IAAI,CAAC;wBACH,KAAK,CAAC,CAAC,QAAQ,CAAC,UAAU,CAAC,QAAQ,EAAE,WAAW,CAAC,CAAC;wBAClD,OAAO,CAAC,wBAAwB;oBAClC,CAAC;oBAAC,OAAO,KAAK,EAAE,CAAC;wBACf,SAAS,GAAG,KAAK,CAAC;wBAClB,IAAI,CAAC,KAAK,SAAS,CAAC,MAAM,GAAG,CAAC;4BAAE,MAAM;wBACtC,IAAI,CAAC,cAAc,CAAC,KAAK,CAAC;4BAAE,MAAM;wBAClC,UAAU,EAAE,CAAC,CAAC,EAAE,CAAC,GAAG,CAAC,EAAE,KAAK,CAAC,CAAC;oBAChC,CAAC;gBACH,CAAC;gBAED,MAAM,SAAS,CAAC;YAClB,CAAC;YACH,CAAC,CAAC,SAAS;KACd,CAAC;AACJ,CAAC"}

package/dist/esm/adapters/index.js

@@ -0,0 +1,23 @@
+export { InMemoryStore } from './memory/inMemory';
+export { redisStore, dynamoStore, postgresStore } from './memory/stores';
+// ── Mock Adapters ────────────────────────────────────────────
+export { MockAdapter, mock } from './mock/MockAdapter';
+export { MockRetriever, mockRetriever } from './mock/MockRetriever';
+// ── Adapter Subflow ─────────────────────────────────────────
+export { createAdapterSubflow } from './createAdapterSubflow';
+// ── Protocol Adapters ───────────────────────────────────────
+export { mcpToolProvider } from './mcp/mcpToolProvider';
+export { a2aRunner } from './a2a/a2aRunner';
+// ── LLM Provider Adapters ───────────────────────────────────
+export { AnthropicAdapter } from './anthropic/AnthropicAdapter';
+export { OpenAIAdapter } from './openai/OpenAIAdapter';
+export { BedrockAdapter } from './bedrock/BedrockAdapter';
+// ── Browser LLM Adapters (fetch-based, zero deps) ──────────
+export { BrowserAnthropicAdapter } from './browser/BrowserAnthropicAdapter';
+export { BrowserOpenAIAdapter } from './browser/BrowserOpenAIAdapter';
+// ── Provider Composition ───────────────────────────────────
+export { fallbackProvider } from './fallbackProvider';
+export { resilientProvider } from './resilientProvider';
+// ── Provider Bridge ─────────────────────────────────────────
+export { createProvider, resolveProvider, isLLMProvider } from './createProvider';
+//# sourceMappingURL=index.js.map

package/dist/esm/adapters/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/adapters/index.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAC;AAClD,OAAO,EAAE,UAAU,EAAE,WAAW,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAGzE,gEAAgE;AAChE,OAAO,EAAE,WAAW,EAAE,IAAI,EAAE,MAAM,oBAAoB,CAAC;AAEvD,OAAO,EAAE,aAAa,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AAGpE,+DAA+D;AAC/D,OAAO,EAAE,oBAAoB,EAAE,MAAM,wBAAwB,CAAC;AAG9D,+DAA+D;AAC/D,OAAO,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AAOxD,OAAO,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAG5C,+DAA+D;AAC/D,OAAO,EAAE,gBAAgB,EAAE,MAAM,8BAA8B,CAAC;AAEhE,OAAO,EAAE,aAAa,EAAE,MAAM,wBAAwB,CAAC;AAEvD,OAAO,EAAE,cAAc,EAAE,MAAM,0BAA0B,CAAC;AAG1D,8DAA8D;AAC9D,OAAO,EAAE,uBAAuB,EAAE,MAAM,mCAAmC,CAAC;AAE5E,OAAO,EAAE,oBAAoB,EAAE,MAAM,gCAAgC,CAAC;AAGtE,8DAA8D;AAC9D,OAAO,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAC;AAEtD,OAAO,EAAE,iBAAiB,EAAE,MAAM,qBAAqB,CAAC;AAGxD,+DAA+D;AAC/D,OAAO,EAAE,cAAc,EAAE,eAAe,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAC"}

package/dist/esm/adapters/mcp/mcpToolProvider.js

@@ -0,0 +1,40 @@
+/**
+ * mcpToolProvider — wraps an MCP server as a ToolProvider.
+ *
+ * MCP (Model Context Protocol) exposes tools from external servers.
+ * This adapter bridges MCP's tool interface to agentfootprint's ToolProvider,
+ * enabling agents to use MCP tools without knowing the protocol.
+ *
+ * The adapter accepts an MCPClient interface (transport-agnostic).
+ * Users provide their own MCP client implementation — this adapter
+ * only handles the ToolProvider mapping.
+ *
+ * Usage:
+ *   const tools = mcpToolProvider({ client: myMcpClient });
+ *   const agent = Agent.create({ provider }).build();
+ *   // Agent can now call MCP tools
+ */
+export function mcpToolProvider(options) {
+    const { client, prefix = '' } = options;
+    return {
+        resolve: async () => {
+            const tools = await client.listTools();
+            const value = tools.map((t) => ({
+                name: prefix + t.name,
+                description: t.description ?? '',
+                inputSchema: t.inputSchema ?? {},
+            }));
+            return { value, chosen: 'mcp', rationale: `${value.length} tools from MCP server` };
+        },
+        execute: async (call, _signal) => {
+            // Strip prefix to get original tool name
+            const toolName = prefix ? call.name.slice(prefix.length) : call.name;
+            const result = await client.callTool(toolName, call.arguments);
+            return {
+                content: result.content,
+                error: result.isError,
+            };
+        },
+    };
+}
+//# sourceMappingURL=mcpToolProvider.js.map

package/dist/esm/adapters/mcp/mcpToolProvider.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"mcpToolProvider.js","sourceRoot":"","sources":["../../../../src/adapters/mcp/mcpToolProvider.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAmCH,MAAM,UAAU,eAAe,CAAC,OAA+B;IAC7D,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,EAAE,EAAE,GAAG,OAAO,CAAC;IAExC,OAAO;QACL,OAAO,EAAE,KAAK,IAAI,EAAE;YAClB,MAAM,KAAK,GAAG,MAAM,MAAM,CAAC,SAAS,EAAE,CAAC;YACvC,MAAM,KAAK,GAAG,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;gBAC9B,IAAI,EAAE,MAAM,GAAG,CAAC,CAAC,IAAI;gBACrB,WAAW,EAAE,CAAC,CAAC,WAAW,IAAI,EAAE;gBAChC,WAAW,EAAE,CAAC,CAAC,WAAW,IAAI,EAAE;aACjC,CAAC,CAAC,CAAC;YACJ,OAAO,EAAE,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,SAAS,EAAE,GAAG,KAAK,CAAC,MAAM,wBAAwB,EAAE,CAAC;QACtF,CAAC;QAED,OAAO,EAAE,KAAK,EAAE,IAAc,EAAE,OAAqB,EAAgC,EAAE;YACrF,yCAAyC;YACzC,MAAM,QAAQ,GAAG,MAAM,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC;YACrE,MAAM,MAAM,GAAG,MAAM,MAAM,CAAC,QAAQ,CAAC,QAAQ,EAAE,IAAI,CAAC,SAAS,CAAC,CAAC;YAC/D,OAAO;gBACL,OAAO,EAAE,MAAM,CAAC,OAAO;gBACvB,KAAK,EAAE,MAAM,CAAC,OAAO;aACtB,CAAC;QACJ,CAAC;KACF,CAAC;AACJ,CAAC"}

package/dist/esm/adapters/memory/inMemory.js

@@ -0,0 +1,34 @@
+/**
+ * InMemoryStore — ConversationStore implementation backed by a plain Map.
+ *
+ * For testing and development only. Data does not survive process restarts.
+ * Use a real backend (Redis, Postgres, DynamoDB) in production.
+ */
+export class InMemoryStore {
+    conversations = new Map();
+    load(conversationId) {
+        const stored = this.conversations.get(conversationId);
+        return stored ? [...stored] : [];
+    }
+    save(conversationId, messages) {
+        // Shallow copy — prevent external mutation of stored array
+        this.conversations.set(conversationId, [...messages]);
+    }
+    /** Return all conversation IDs currently in store. */
+    ids() {
+        return Array.from(this.conversations.keys());
+    }
+    /** Return number of messages stored for a conversation. */
+    size(conversationId) {
+        return this.conversations.get(conversationId)?.length ?? 0;
+    }
+    /** Clear a specific conversation. */
+    delete(conversationId) {
+        this.conversations.delete(conversationId);
+    }
+    /** Clear all stored conversations. */
+    clear() {
+        this.conversations.clear();
+    }
+}
+//# sourceMappingURL=inMemory.js.map

package/dist/esm/adapters/memory/inMemory.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"inMemory.js","sourceRoot":"","sources":["../../../../src/adapters/memory/inMemory.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAKH,MAAM,OAAO,aAAa;IACP,aAAa,GAAG,IAAI,GAAG,EAAqB,CAAC;IAE9D,IAAI,CAAC,cAAsB;QACzB,MAAM,MAAM,GAAG,IAAI,CAAC,aAAa,CAAC,GAAG,CAAC,cAAc,CAAC,CAAC;QACtD,OAAO,MAAM,CAAC,CAAC,CAAC,CAAC,GAAG,MAAM,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;IACnC,CAAC;IAED,IAAI,CAAC,cAAsB,EAAE,QAAmB;QAC9C,2DAA2D;QAC3D,IAAI,CAAC,aAAa,CAAC,GAAG,CAAC,cAAc,EAAE,CAAC,GAAG,QAAQ,CAAC,CAAC,CAAC;IACxD,CAAC;IAED,sDAAsD;IACtD,GAAG;QACD,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,aAAa,CAAC,IAAI,EAAE,CAAC,CAAC;IAC/C,CAAC;IAED,2DAA2D;IAC3D,IAAI,CAAC,cAAsB;QACzB,OAAO,IAAI,CAAC,aAAa,CAAC,GAAG,CAAC,cAAc,CAAC,EAAE,MAAM,IAAI,CAAC,CAAC;IAC7D,CAAC;IAED,qCAAqC;IACrC,MAAM,CAAC,cAAsB;QAC3B,IAAI,CAAC,aAAa,CAAC,MAAM,CAAC,cAAc,CAAC,CAAC;IAC5C,CAAC;IAED,sCAAsC;IACtC,KAAK;QACH,IAAI,CAAC,aAAa,CAAC,KAAK,EAAE,CAAC;IAC7B,CAAC;CACF"}

package/dist/esm/adapters/memory/index.js

@@ -0,0 +1,2 @@
+export { InMemoryStore } from './inMemory';
+//# sourceMappingURL=index.js.map

package/dist/esm/adapters/memory/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/adapters/memory/index.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC"}

package/dist/esm/adapters/memory/stores.js

@@ -0,0 +1,131 @@
+/**
+ * Memory store adapter factories — consumer brings their own client.
+ *
+ * Zero new dependencies. Each factory wraps the consumer's client instance
+ * into a ConversationStore that implements load() + save().
+ *
+ * @example Redis
+ * ```typescript
+ * import Redis from 'ioredis';
+ * import { redisStore } from 'agentfootprint';
+ *
+ * const store = redisStore(new Redis(), { ttlSeconds: 3600 });
+ * agent.memory({ store, conversationId: 'session-123' });
+ * ```
+ *
+ * @example DynamoDB
+ * ```typescript
+ * import { DynamoDBClient } from '@aws-sdk/client-dynamodb';
+ * import { dynamoStore } from 'agentfootprint';
+ *
+ * const store = dynamoStore(new DynamoDBClient({}), { tableName: 'conversations' });
+ * agent.memory({ store, conversationId: 'session-123' });
+ * ```
+ */
+/**
+ * Create a ConversationStore backed by Redis.
+ * Consumer provides their own Redis client (ioredis, redis, etc.).
+ */
+export function redisStore(client, options) {
+    const prefix = options?.prefix ?? 'agentfp:conv:';
+    const ttl = options?.ttlSeconds;
+    const hasTtl = ttl !== undefined && ttl !== null;
+    return {
+        async load(conversationId) {
+            const data = await client.get(`${prefix}${conversationId}`);
+            if (!data)
+                return null;
+            try {
+                return JSON.parse(data);
+            }
+            catch {
+                return null;
+            }
+        },
+        async save(conversationId, messages) {
+            const key = `${prefix}${conversationId}`;
+            const value = JSON.stringify(messages);
+            try {
+                if (hasTtl) {
+                    // ioredis: set(key, value, 'EX', ttl) — node-redis v4: set(key, value, { EX: ttl })
+                    // Try options object first (node-redis v4), fall back to variadic (ioredis)
+                    try {
+                        await client.set(key, value, { EX: ttl });
+                    }
+                    catch {
+                        await client.set(key, value, 'EX', ttl);
+                    }
+                }
+                else {
+                    await client.set(key, value);
+                }
+            }
+            catch { /* fire-and-forget — ConversationStore contract */ }
+        },
+    };
+}
+/**
+ * Create a ConversationStore backed by DynamoDB.
+ * Consumer provides a thin wrapper around their DynamoDB client.
+ */
+export function dynamoStore(client, options) {
+    const { tableName, partitionKey = 'id' } = options;
+    return {
+        async load(conversationId) {
+            try {
+                const item = await client.get(tableName, { [partitionKey]: conversationId });
+                if (!item)
+                    return null;
+                const data = item.messages;
+                if (typeof data === 'string')
+                    return JSON.parse(data);
+                if (Array.isArray(data))
+                    return data;
+                return null;
+            }
+            catch {
+                return null;
+            }
+        },
+        async save(conversationId, messages) {
+            try {
+                await client.put(tableName, {
+                    [partitionKey]: conversationId,
+                    messages: JSON.stringify(messages),
+                    updatedAt: Date.now(),
+                });
+            }
+            catch { /* fire-and-forget — ConversationStore contract */ }
+        },
+    };
+}
+/**
+ * Create a ConversationStore backed by PostgreSQL.
+ * Consumer provides their own pg client/pool.
+ *
+ * Expects table: CREATE TABLE conversations (id TEXT PRIMARY KEY, messages JSONB, updated_at TIMESTAMPTZ DEFAULT NOW());
+ */
+const SAFE_TABLE_NAME = /^[a-zA-Z_][a-zA-Z0-9_]{0,63}$/;
+export function postgresStore(client, options) {
+    const table = options?.tableName ?? 'conversations';
+    if (!SAFE_TABLE_NAME.test(table)) {
+        throw new Error(`Invalid table name "${table}". Use alphanumeric + underscore only.`);
+    }
+    return {
+        async load(conversationId) {
+            const result = await client.query(`SELECT messages FROM ${table} WHERE id = $1`, [conversationId]);
+            if (result.rows.length === 0)
+                return null;
+            const row = result.rows[0];
+            return row.messages;
+        },
+        async save(conversationId, messages) {
+            try {
+                await client.query(`INSERT INTO ${table} (id, messages, updated_at) VALUES ($1, $2, NOW())
+           ON CONFLICT (id) DO UPDATE SET messages = $2, updated_at = NOW()`, [conversationId, JSON.stringify(messages)]);
+            }
+            catch { /* fire-and-forget — ConversationStore contract */ }
+        },
+    };
+}
+//# sourceMappingURL=stores.js.map

package/dist/esm/adapters/memory/stores.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"stores.js","sourceRoot":"","sources":["../../../../src/adapters/memory/stores.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AAuBH;;;GAGG;AACH,MAAM,UAAU,UAAU,CAAC,MAAiB,EAAE,OAA2B;IACvE,MAAM,MAAM,GAAG,OAAO,EAAE,MAAM,IAAI,eAAe,CAAC;IAClD,MAAM,GAAG,GAAG,OAAO,EAAE,UAAU,CAAC;IAChC,MAAM,MAAM,GAAG,GAAG,KAAK,SAAS,IAAI,GAAG,KAAK,IAAI,CAAC;IAEjD,OAAO;QACL,KAAK,CAAC,IAAI,CAAC,cAAsB;YAC/B,MAAM,IAAI,GAAG,MAAM,MAAM,CAAC,GAAG,CAAC,GAAG,MAAM,GAAG,cAAc,EAAE,CAAC,CAAC;YAC5D,IAAI,CAAC,IAAI;gBAAE,OAAO,IAAI,CAAC;YACvB,IAAI,CAAC;gBACH,OAAO,IAAI,CAAC,KAAK,CAAC,IAAI,CAAc,CAAC;YACvC,CAAC;YAAC,MAAM,CAAC;gBACP,OAAO,IAAI,CAAC;YACd,CAAC;QACH,CAAC;QAED,KAAK,CAAC,IAAI,CAAC,cAAsB,EAAE,QAAmB;YACpD,MAAM,GAAG,GAAG,GAAG,MAAM,GAAG,cAAc,EAAE,CAAC;YACzC,MAAM,KAAK,GAAG,IAAI,CAAC,SAAS,CAAC,QAAQ,CAAC,CAAC;YACvC,IAAI,CAAC;gBACH,IAAI,MAAM,EAAE,CAAC;oBACX,oFAAoF;oBACpF,4EAA4E;oBAC5E,IAAI,CAAC;wBACH,MAAM,MAAM,CAAC,GAAG,CAAC,GAAG,EAAE,KAAK,EAAE,EAAE,EAAE,EAAE,GAAG,EAAuB,CAAC,CAAC;oBACjE,CAAC;oBAAC,MAAM,CAAC;wBACP,MAAM,MAAM,CAAC,GAAG,CAAC,GAAG,EAAE,KAAK,EAAE,IAAI,EAAE,GAAI,CAAC,CAAC;oBAC3C,CAAC;gBACH,CAAC;qBAAM,CAAC;oBACN,MAAM,MAAM,CAAC,GAAG,CAAC,GAAG,EAAE,KAAK,CAAC,CAAC;gBAC/B,CAAC;YACH,CAAC;YAAC,MAAM,CAAC,CAAC,kDAAkD,CAAC,CAAC;QAChE,CAAC;KACF,CAAC;AACJ,CAAC;AAqCD;;;GAGG;AACH,MAAM,UAAU,WAAW,CAAC,MAAkB,EAAE,OAA2B;IACzE,MAAM,EAAE,SAAS,EAAE,YAAY,GAAG,IAAI,EAAE,GAAG,OAAO,CAAC;IAEnD,OAAO;QACL,KAAK,CAAC,IAAI,CAAC,cAAsB;YAC/B,IAAI,CAAC;gBACH,MAAM,IAAI,GAAG,MAAM,MAAM,CAAC,GAAG,CAAC,SAAS,EAAE,EAAE,CAAC,YAAY,CAAC,EAAE,cAAc,EAAE,CAAC,CAAC;gBAC7E,IAAI,CAAC,IAAI;oBAAE,OAAO,IAAI,CAAC;gBACvB,MAAM,IAAI,GAAG,IAAI,CAAC,QAAQ,CAAC;gBAC3B,IAAI,OAAO,IAAI,KAAK,QAAQ;oBAAE,OAAO,IAAI,CAAC,KAAK,CAAC,IAAI,CAAc,CAAC;gBACnE,IAAI,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC;oBAAE,OAAO,IAAiB,CAAC;gBAClD,OAAO,IAAI,CAAC;YACd,CAAC;YAAC,MAAM,CAAC;gBACP,OAAO,IAAI,CAAC;YACd,CAAC;QACH,CAAC;QAED,KAAK,CAAC,IAAI,CAAC,cAAsB,EAAE,QAAmB;YACpD,IAAI,CAAC;gBACH,MAAM,MAAM,CAAC,GAAG,CAAC,SAAS,EAAE;oBAC1B,CAAC,YAAY,CAAC,EAAE,cAAc;oBAC9B,QAAQ,EAAE,IAAI,CAAC,SAAS,CAAC,QAAQ,CAAC;oBAClC,SAAS,EAAE,IAAI,CAAC,GAAG,EAAE;iBACtB,CAAC,CAAC;YACL,CAAC;YAAC,MAAM,CAAC,CAAC,kDAAkD,CAAC,CAAC;QAChE,CAAC;KACF,CAAC;AACJ,CAAC;AAcD;;;;;GAKG;AACH,MAAM,eAAe,GAAG,+BAA+B,CAAC;AAExD,MAAM,UAAU,aAAa,CAAC,MAAoB,EAAE,OAA8B;IAChF,MAAM,KAAK,GAAG,OAAO,EAAE,SAAS,IAAI,eAAe,CAAC;IACpD,IAAI,CAAC,eAAe,CAAC,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC;QACjC,MAAM,IAAI,KAAK,CAAC,uBAAuB,KAAK,wCAAwC,CAAC,CAAC;IACxF,CAAC;IAED,OAAO;QACL,KAAK,CAAC,IAAI,CAAC,cAAsB;YAC/B,MAAM,MAAM,GAAG,MAAM,MAAM,CAAC,KAAK,CAC/B,wBAAwB,KAAK,gBAAgB,EAC7C,CAAC,cAAc,CAAC,CACjB,CAAC;YACF,IAAI,MAAM,CAAC,IAAI,CAAC,MAAM,KAAK,CAAC;gBAAE,OAAO,IAAI,CAAC;YAC1C,MAAM,GAAG,GAAG,MAAM,CAAC,IAAI,CAAC,CAAC,CAA4B,CAAC;YACtD,OAAO,GAAG,CAAC,QAAQ,CAAC;QACtB,CAAC;QAED,KAAK,CAAC,IAAI,CAAC,cAAsB,EAAE,QAAmB;YACpD,IAAI,CAAC;gBACH,MAAM,MAAM,CAAC,KAAK,CAChB,eAAe,KAAK;4EAC8C,EAClE,CAAC,cAAc,EAAE,IAAI,CAAC,SAAS,CAAC,QAAQ,CAAC,CAAC,CAC3C,CAAC;YACJ,CAAC;YAAC,MAAM,CAAC,CAAC,kDAAkD,CAAC,CAAC;QAChE,CAAC;KACF,CAAC;AACJ,CAAC"}

package/dist/esm/adapters/memory/types.js

@@ -0,0 +1,13 @@
+/**
+ * Memory adapter types — ConversationStore interface for persistent conversation history.
+ *
+ * ConversationStore is the persistence adapter: it defines WHERE messages are stored.
+ * Implement this interface to plug in Redis, Postgres, DynamoDB, localStorage,
+ * or any other backend. The library ships with InMemoryStore for testing.
+ *
+ * This is the memory equivalent of LLMProvider — same adapter-swap story:
+ *   - Swap mock ↔ real adapter without changing agent logic
+ *   - Swap InMemoryStore ↔ RedisStore without touching flowchart stages
+ */
+export {};
+//# sourceMappingURL=types.js.map

package/dist/esm/adapters/memory/types.js.map

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

package/dist/esm/adapters/mock/MockAdapter.js

@@ -0,0 +1,61 @@
+/**
+ * MockAdapter — scripted LLM responses for $0 testing.
+ *
+ * Same flowchart, swap the adapter, zero code changes.
+ * Tests exercise the exact same control flow as production.
+ *
+ * Usage:
+ *   import { mock } from 'agentfootprint';
+ *   const model = mock([
+ *     { content: 'Let me search.', toolCalls: [{ id: '1', name: 'search', arguments: { q: 'test' } }] },
+ *     { content: 'The answer is 42.' },
+ *   ]);
+ */
+export class MockAdapter {
+    responses;
+    callIndex = 0;
+    calls = [];
+    constructor(responses) {
+        this.responses = [...responses];
+    }
+    async chat(messages, options) {
+        this.calls.push({ messages: [...messages], options });
+        if (this.callIndex >= this.responses.length) {
+            throw new Error(`MockAdapter: no more responses. Expected ${this.responses.length} calls, got ${this.callIndex + 1}. ` + 'Add more responses to your mock() configuration.');
+        }
+        const response = this.responses[this.callIndex++];
+        return {
+            content: response.content,
+            toolCalls: response.toolCalls,
+            usage: response.usage ?? { inputTokens: 10, outputTokens: 20 },
+            model: response.model ?? 'mock',
+            finishReason: response.toolCalls?.length ? 'tool_calls' : 'stop',
+        };
+    }
+    /** How many times chat() was called. */
+    getCallCount() {
+        return this.calls.length;
+    }
+    /** Get the messages sent in a specific call (0-indexed). */
+    getCall(index) {
+        return this.calls[index];
+    }
+    /** Get all calls for assertion. */
+    getAllCalls() {
+        return this.calls;
+    }
+    /** Reset call history (keep responses). */
+    reset() {
+        this.callIndex = 0;
+        this.calls.length = 0;
+    }
+}
+/**
+ * Factory function for creating a mock model.
+ *
+ *   const model = mock([{ content: 'Hello!' }]);
+ */
+export function mock(responses) {
+    return new MockAdapter(responses);
+}
+//# sourceMappingURL=MockAdapter.js.map

package/dist/esm/adapters/mock/MockAdapter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"MockAdapter.js","sourceRoot":"","sources":["../../../../src/adapters/mock/MockAdapter.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAWH,MAAM,OAAO,WAAW;IACd,SAAS,CAAiB;IAC1B,SAAS,GAAG,CAAC,CAAC;IACL,KAAK,GAA6D,EAAE,CAAC;IAEtF,YAAY,SAAyB;QACnC,IAAI,CAAC,SAAS,GAAG,CAAC,GAAG,SAAS,CAAC,CAAC;IAClC,CAAC;IAED,KAAK,CAAC,IAAI,CAAC,QAAmB,EAAE,OAAwB;QACtD,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,EAAE,QAAQ,EAAE,CAAC,GAAG,QAAQ,CAAC,EAAE,OAAO,EAAE,CAAC,CAAC;QAEtD,IAAI,IAAI,CAAC,SAAS,IAAI,IAAI,CAAC,SAAS,CAAC,MAAM,EAAE,CAAC;YAC5C,MAAM,IAAI,KAAK,CACb,4CAA4C,IAAI,CAAC,SAAS,CAAC,MAAM,eAC/D,IAAI,CAAC,SAAS,GAAG,CACnB,IAAI,GAAG,kDAAkD,CAC1D,CAAC;QACJ,CAAC;QAED,MAAM,QAAQ,GAAG,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,SAAS,EAAE,CAAC,CAAC;QAElD,OAAO;YACL,OAAO,EAAE,QAAQ,CAAC,OAAO;YACzB,SAAS,EAAE,QAAQ,CAAC,SAAS;YAC7B,KAAK,EAAE,QAAQ,CAAC,KAAK,IAAI,EAAE,WAAW,EAAE,EAAE,EAAE,YAAY,EAAE,EAAE,EAAE;YAC9D,KAAK,EAAE,QAAQ,CAAC,KAAK,IAAI,MAAM;YAC/B,YAAY,EAAE,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC,CAAC,CAAC,YAAY,CAAC,CAAC,CAAC,MAAM;SACjE,CAAC;IACJ,CAAC;IAED,wCAAwC;IACxC,YAAY;QACV,OAAO,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC;IAC3B,CAAC;IAED,4DAA4D;IAC5D,OAAO,CAAC,KAAa;QACnB,OAAO,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;IAC3B,CAAC;IAED,mCAAmC;IACnC,WAAW;QACT,OAAO,IAAI,CAAC,KAAK,CAAC;IACpB,CAAC;IAED,2CAA2C;IAC3C,KAAK;QACH,IAAI,CAAC,SAAS,GAAG,CAAC,CAAC;QACnB,IAAI,CAAC,KAAK,CAAC,MAAM,GAAG,CAAC,CAAC;IACxB,CAAC;CACF;AAED;;;;GAIG;AACH,MAAM,UAAU,IAAI,CAAC,SAAyB;IAC5C,OAAO,IAAI,WAAW,CAAC,SAAS,CAAC,CAAC;AACpC,CAAC"}