{"_id":"@agorio/sdk","_rev":"13-1b6e8b9f26c8350b552ca08ffd579b3d","name":"@agorio/sdk","dist-tags":{"latest":"0.9.0"},"versions":{"0.1.0":{"name":"@agorio/sdk","version":"0.1.0","keywords":["ucp","shopping-agent","ai-agent","agentic-commerce","gemini","universal-commerce-protocol"],"author":{"name":"UCPtools"},"license":"MIT","_id":"@agorio/sdk@0.1.0","maintainers":[{"name":"nolpak14","email":"piotr.kaplon@outlook.com"}],"homepage":"https://github.com/Nolpak14/agorio#readme","bugs":{"url":"https://github.com/Nolpak14/agorio/issues"},"dist":{"shasum":"679f6223a7af9713e84e1acf0524e23e6fd09ceb","tarball":"https://registry.npmjs.org/@agorio/sdk/-/sdk-0.1.0.tgz","fileCount":39,"integrity":"sha512-EcfAB3ia8J9wmwS0GXNFslorw8dnSwmcah8xmXzs/jhWAK+UUde4kLgCQfN58dVRkwsLt0HSnkDhe6fG/YFHow==","signatures":[{"sig":"MEQCIEa8i2zagx9eG2sjenY1NpFMIAygtE14+U7vrk1nOG7TAiAGZuwPmNbm+NW6NCQCcrQG3lSaZZRcxv1oBYL6n/e7Mg==","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":146853},"main":"dist/index.js","type":"module","types":"dist/index.d.ts","engines":{"node":">=20.0.0"},"exports":{".":{"types":"./dist/index.d.ts","import":"./dist/index.js"},"./mock":{"types":"./dist/mock/mock-merchant.d.ts","import":"./dist/mock/mock-merchant.js"}},"gitHead":"c686b26e92e51664c8804a83c063ea60b960eb98","scripts":{"test":"vitest","build":"tsc","typecheck":"tsc --noEmit --pretty"},"_npmUser":{"name":"nolpak14","email":"piotr.kaplon@outlook.com"},"repository":{"url":"git+https://github.com/Nolpak14/agorio.git","type":"git","directory":"packages/agent-sdk"},"_npmVersion":"11.6.2","description":"The open-source toolkit for building AI commerce agents using UCP and ACP protocols","directories":{},"_nodeVersion":"24.11.1","dependencies":{"@google/generative-ai":"^0.24.0"},"_hasShrinkwrap":false,"devDependencies":{"vitest":"^4.0.17","express":"^4.21.0","typescript":"^5.6.3","@types/node":"^22.9.0","@types/express":"^5.0.0"},"peerDependencies":{"express":"^4.21.0"},"peerDependenciesMeta":{"express":{"optional":true}},"_npmOperationalInternal":{"tmp":"tmp/sdk_0.1.0_1771485469537_0.3443296356914547","host":"s3://npm-registry-packages-npm-production"}},"0.2.0":{"name":"@agorio/sdk","version":"0.2.0","keywords":["ucp","acp","shopping-agent","ai-agent","agentic-commerce","gemini","claude","openai","universal-commerce-protocol","agentic-commerce-protocol"],"author":{"name":"UCPtools"},"license":"MIT","_id":"@agorio/sdk@0.2.0","maintainers":[{"name":"nolpak14","email":"piotr.kaplon@outlook.com"}],"homepage":"https://github.com/Nolpak14/agorio#readme","bugs":{"url":"https://github.com/Nolpak14/agorio/issues"},"dist":{"shasum":"38890eb933fc884cf8d865b6cde4b91b12f10439","tarball":"https://registry.npmjs.org/@agorio/sdk/-/sdk-0.2.0.tgz","fileCount":73,"integrity":"sha512-d1A7lDsd4LM+K81t0HQ9NaIzNZij2SwFbowwnySXWsQuOu+DPBO5KL6MFpNPWG+qR87ezajnThfAr0G9566P3Q==","signatures":[{"sig":"MEYCIQDntS79CBjJWsRx1IEHku5TZHyowCSsem/OrD/L/D6+SwIhAIFu9iW7VRTTVBwiCKZ5StVC+gw9Av0BMm9XH8h9HIfz","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":570199},"main":"dist/index.js","type":"module","types":"dist/index.d.ts","engines":{"node":">=20.0.0"},"exports":{".":{"types":"./dist/index.d.ts","import":"./dist/index.js"},"./mock":{"types":"./dist/mock/mock-merchant.d.ts","import":"./dist/mock/mock-merchant.js"}},"gitHead":"01c9b437587bc0ab465dd1a97383b9cafad8bdf3","scripts":{"test":"vitest","build":"tsc","typecheck":"tsc --noEmit --pretty"},"_npmUser":{"name":"nolpak14","email":"piotr.kaplon@outlook.com"},"repository":{"url":"git+https://github.com/Nolpak14/agorio.git","type":"git","directory":"packages/agent-sdk"},"_npmVersion":"11.6.2","description":"The open-source toolkit for building AI commerce agents using UCP and ACP protocols","directories":{},"_nodeVersion":"24.11.1","dependencies":{"openai":"^6.22.0","@anthropic-ai/sdk":"^0.77.0","@google/generative-ai":"^0.24.0"},"_hasShrinkwrap":false,"devDependencies":{"vitest":"^4.0.17","express":"^4.21.0","typescript":"^5.6.3","@types/node":"^22.9.0","@types/express":"^5.0.0"},"peerDependencies":{"express":"^4.21.0"},"peerDependenciesMeta":{"express":{"optional":true}},"_npmOperationalInternal":{"tmp":"tmp/sdk_0.2.0_1771515017095_0.8446837382769719","host":"s3://npm-registry-packages-npm-production"}},"0.2.1":{"name":"@agorio/sdk","version":"0.2.1","keywords":["ucp","acp","shopping-agent","ai-agent","agentic-commerce","gemini","claude","openai","universal-commerce-protocol","agentic-commerce-protocol"],"author":{"name":"UCPtools"},"license":"MIT","_id":"@agorio/sdk@0.2.1","maintainers":[{"name":"nolpak14","email":"piotr.kaplon@outlook.com"}],"homepage":"https://github.com/Nolpak14/agorio#readme","bugs":{"url":"https://github.com/Nolpak14/agorio/issues"},"dist":{"shasum":"bf97cf227fca98b9f574bb653da7e1cc03f43521","tarball":"https://registry.npmjs.org/@agorio/sdk/-/sdk-0.2.1.tgz","fileCount":47,"integrity":"sha512-voYfV7ByWmJSzPu4uY6RmpZrFJNOkrnWzYzwunnxG0jilZD9ip30tyIDZInz4uZlutCde4MnROLHN+5HdBAJTg==","signatures":[{"sig":"MEYCIQCRk/8E6Y2/69TzhDoWY27CmupP7xTo8K+NyFcRH4Q+BAIhAI9ELCHp9lMtT0O8Q5HTiYNuFydiWfvYy4VDEMU2ShJf","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":173910},"main":"dist/index.js","type":"module","types":"dist/index.d.ts","engines":{"node":">=20.0.0"},"exports":{".":{"types":"./dist/index.d.ts","import":"./dist/index.js"},"./mock":{"types":"./dist/mock/mock-merchant.d.ts","import":"./dist/mock/mock-merchant.js"}},"gitHead":"ad58afd674bf2fa2ef6259bafdf7c6509b45b8c4","scripts":{"test":"vitest","build":"tsc","typecheck":"tsc --noEmit --pretty"},"_npmUser":{"name":"nolpak14","email":"piotr.kaplon@outlook.com"},"repository":{"url":"git+https://github.com/Nolpak14/agorio.git","type":"git","directory":"packages/agent-sdk"},"_npmVersion":"11.6.2","description":"The open-source toolkit for building AI commerce agents using UCP and ACP protocols","directories":{},"_nodeVersion":"24.11.1","dependencies":{"openai":"^6.22.0","@anthropic-ai/sdk":"^0.77.0","@google/generative-ai":"^0.24.0"},"_hasShrinkwrap":false,"devDependencies":{"vitest":"^4.0.17","express":"^4.21.0","typescript":"^5.6.3","@types/node":"^22.9.0","@types/express":"^5.0.0"},"peerDependencies":{"express":"^4.21.0"},"peerDependenciesMeta":{"express":{"optional":true}},"_npmOperationalInternal":{"tmp":"tmp/sdk_0.2.1_1771515406256_0.2565686448619007","host":"s3://npm-registry-packages-npm-production"}},"0.3.0":{"name":"@agorio/sdk","version":"0.3.0","keywords":["ucp","acp","shopping-agent","ai-agent","agentic-commerce","gemini","claude","openai","universal-commerce-protocol","agentic-commerce-protocol"],"author":{"name":"UCPtools"},"license":"MIT","_id":"@agorio/sdk@0.3.0","maintainers":[{"name":"nolpak14","email":"piotr.kaplon@outlook.com"}],"homepage":"https://github.com/Nolpak14/agorio#readme","bugs":{"url":"https://github.com/Nolpak14/agorio/issues"},"dist":{"shasum":"0a5bf87acefe528a77ad4abf9c139e7dc369e620","tarball":"https://registry.npmjs.org/@agorio/sdk/-/sdk-0.3.0.tgz","fileCount":58,"integrity":"sha512-HZDoZyrSZtFq5jqTys7S21mCFISr4IYXG1bh36y52TwA9jhXgfX3+vC9hZULWG//2PruXMZVpjlJ39+V9imJUg==","signatures":[{"sig":"MEYCIQDql5h4Lalw9EilMrx0AyLvWxYnggH1q+/a9QfJ7hVGBQIhAJs8WZtfK94wxswwb/I/zSH69iVk+Ixs3PTx2XxC8OpF","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":256089},"main":"dist/index.js","type":"module","types":"dist/index.d.ts","engines":{"node":">=20.0.0"},"exports":{".":{"types":"./dist/index.d.ts","import":"./dist/index.js"},"./mock":{"types":"./dist/mock/mock-merchant.d.ts","import":"./dist/mock/mock-merchant.js"}},"gitHead":"fb910c1423ad597b53bbf0da3be80b731c6edcfd","scripts":{"test":"vitest","build":"tsc","typecheck":"tsc --noEmit --pretty"},"_npmUser":{"name":"nolpak14","email":"piotr.kaplon@outlook.com"},"repository":{"url":"git+https://github.com/Nolpak14/agorio.git","type":"git","directory":"packages/agent-sdk"},"_npmVersion":"11.6.2","description":"The open-source toolkit for building AI commerce agents using UCP and ACP protocols","directories":{},"_nodeVersion":"24.11.1","dependencies":{"openai":"^6.22.0","@anthropic-ai/sdk":"^0.77.0","@google/generative-ai":"^0.24.0"},"_hasShrinkwrap":false,"devDependencies":{"vitest":"^4.0.17","express":"^4.21.0","typescript":"^5.6.3","@types/node":"^22.9.0","@types/express":"^5.0.0"},"peerDependencies":{"express":"^4.21.0"},"peerDependenciesMeta":{"express":{"optional":true}},"_npmOperationalInternal":{"tmp":"tmp/sdk_0.3.0_1771526889451_0.4545160168617639","host":"s3://npm-registry-packages-npm-production"}},"0.3.1":{"name":"@agorio/sdk","version":"0.3.1","keywords":["ucp","acp","mcp","shopping-agent","ai-agent","agentic-commerce","gemini","claude","openai","ollama","cli","plugin","observability","universal-commerce-protocol","agentic-commerce-protocol"],"author":{"name":"UCPtools"},"license":"MIT","_id":"@agorio/sdk@0.3.1","maintainers":[{"name":"nolpak14","email":"piotr.kaplon@outlook.com"}],"homepage":"https://github.com/Nolpak14/agorio#readme","bugs":{"url":"https://github.com/Nolpak14/agorio/issues"},"bin":{"agorio":"dist/cli/index.js"},"dist":{"shasum":"0d168089b8e00062226b591fbc54a20381d090ca","tarball":"https://registry.npmjs.org/@agorio/sdk/-/sdk-0.3.1.tgz","fileCount":90,"integrity":"sha512-CABrvtytbF/oW9D2ZnqBPSiCJVTydhvkmbMD+8mlkWtVuB9/mbdEkqYYIjXPlYAE5K6ux1ugXW/rw03UaE9VsA==","signatures":[{"sig":"MEQCIHUBkEcsoi6ds7FAszop+VDASc5G4J0UEca72YYSQrCrAiBqdnQstjHA10P/3msV6rj1UObpknbmYFKzOf+bifrI5g==","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":383499},"main":"dist/index.js","type":"module","types":"dist/index.d.ts","engines":{"node":">=20.0.0"},"exports":{".":{"types":"./dist/index.d.ts","import":"./dist/index.js"},"./mock":{"types":"./dist/mock/mock-merchant.d.ts","import":"./dist/mock/mock-merchant.js"}},"gitHead":"4996a76da53b20bf43336512599dc55ff328c7c9","scripts":{"test":"vitest","build":"tsc","typecheck":"tsc --noEmit --pretty"},"_npmUser":{"name":"nolpak14","email":"piotr.kaplon@outlook.com"},"repository":{"url":"git+https://github.com/Nolpak14/agorio.git","type":"git","directory":"packages/agent-sdk"},"_npmVersion":"11.6.2","description":"The open-source toolkit for building AI commerce agents using UCP and ACP protocols","directories":{},"_nodeVersion":"24.11.1","dependencies":{"openai":"^6.22.0","@anthropic-ai/sdk":"^0.77.0","@google/generative-ai":"^0.24.0"},"_hasShrinkwrap":false,"devDependencies":{"vitest":"^4.0.17","express":"^4.21.0","typescript":"^5.6.3","@types/node":"^22.9.0","@types/express":"^5.0.0"},"peerDependencies":{"express":"^4.21.0"},"peerDependenciesMeta":{"express":{"optional":true}},"_npmOperationalInternal":{"tmp":"tmp/sdk_0.3.1_1771578793238_0.47427843646017287","host":"s3://npm-registry-packages-npm-production"}},"0.4.0":{"name":"@agorio/sdk","version":"0.4.0","keywords":["ucp","acp","mcp","shopping-agent","ai-agent","agentic-commerce","gemini","claude","openai","ollama","cli","plugin","observability","universal-commerce-protocol","agentic-commerce-protocol"],"author":{"name":"UCPtools"},"license":"MIT","_id":"@agorio/sdk@0.4.0","maintainers":[{"name":"nolpak14","email":"piotr.kaplon@outlook.com"}],"homepage":"https://github.com/Nolpak14/agorio#readme","bugs":{"url":"https://github.com/Nolpak14/agorio/issues"},"bin":{"agorio":"dist/cli/index.js"},"dist":{"shasum":"afff2e0b5be524462176702fb19804cac3949935","tarball":"https://registry.npmjs.org/@agorio/sdk/-/sdk-0.4.0.tgz","fileCount":97,"integrity":"sha512-IDYezjEZ5rdBeXP/R1g9WCynGCluGwjtSOn8OnJP+A0xaCQxI20DojcvmcIYOhzetUVnThL412BBpdbRZh/2CA==","signatures":[{"sig":"MEQCICMx4BQBEWWFKRn23aCoWQS5Nuw07HvsiY7+u3F253RlAiBR6fHnBLbkTUG7ubXODHtzuCwe83aboixtJUdMbLIbJQ==","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":484996},"main":"dist/index.js","type":"module","types":"dist/index.d.ts","engines":{"node":">=20.0.0"},"exports":{".":{"types":"./dist/index.d.ts","import":"./dist/index.js"},"./mock":{"types":"./dist/mock/mock-merchant.d.ts","import":"./dist/mock/mock-merchant.js"}},"gitHead":"abe5febfdef49017b64702b00c6774c401447103","scripts":{"test":"vitest","build":"tsc","typecheck":"tsc --noEmit --pretty"},"_npmUser":{"name":"nolpak14","email":"piotr.kaplon@outlook.com"},"repository":{"url":"git+https://github.com/Nolpak14/agorio.git","type":"git","directory":"packages/agent-sdk"},"_npmVersion":"10.8.2","description":"The open-source toolkit for building AI commerce agents using UCP and ACP protocols","directories":{},"_nodeVersion":"20.20.2","dependencies":{"openai":"^6.22.0","@anthropic-ai/sdk":"^0.77.0","@google/generative-ai":"^0.24.0"},"_hasShrinkwrap":false,"devDependencies":{"vitest":"^4.0.17","express":"^4.21.0","typescript":"^5.6.3","@types/node":"^22.9.0","@types/express":"^5.0.0"},"peerDependencies":{"express":"^4.21.0"},"peerDependenciesMeta":{"express":{"optional":true}},"_npmOperationalInternal":{"tmp":"tmp/sdk_0.4.0_1777532315965_0.6500130774676438","host":"s3://npm-registry-packages-npm-production"}},"0.4.1":{"name":"@agorio/sdk","version":"0.4.1","keywords":["ucp","acp","mcp","shopping-agent","ai-agent","agentic-commerce","gemini","claude","openai","ollama","cli","plugin","observability","universal-commerce-protocol","agentic-commerce-protocol"],"author":{"name":"UCPtools"},"license":"MIT","_id":"@agorio/sdk@0.4.1","maintainers":[{"name":"nolpak14","email":"piotr.kaplon@outlook.com"}],"homepage":"https://github.com/Nolpak14/agorio#readme","bugs":{"url":"https://github.com/Nolpak14/agorio/issues"},"bin":{"agorio":"dist/cli/index.js"},"dist":{"shasum":"47d2282a5544487ac6824cb8a3b744b0b29a4ff3","tarball":"https://registry.npmjs.org/@agorio/sdk/-/sdk-0.4.1.tgz","fileCount":97,"integrity":"sha512-wpGjX7Cne4DZll6TT3AkkUU0ZBmqujJOnLIWN2zzf0xFlmBLpPVQY2CBnNNoOboYtGYjyuC8IBBoToBumvRogA==","signatures":[{"sig":"MEYCIQDC3nd3cf/3zeR5NNJaw0IOM+zBPUp6S5lUIbUzbFXhHQIhAPV2vOVF3pFwFQGOc2czJioLT2uqm2Gxe8EkFr5emb+z","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":486112},"main":"dist/index.js","type":"module","types":"dist/index.d.ts","engines":{"node":">=20.0.0"},"exports":{".":{"types":"./dist/index.d.ts","import":"./dist/index.js"},"./mock":{"types":"./dist/mock/mock-merchant.d.ts","import":"./dist/mock/mock-merchant.js"}},"gitHead":"abe5febfdef49017b64702b00c6774c401447103","scripts":{"test":"vitest","build":"tsc","typecheck":"tsc --noEmit --pretty"},"_npmUser":{"name":"nolpak14","email":"piotr.kaplon@outlook.com"},"repository":{"url":"git+https://github.com/Nolpak14/agorio.git","type":"git","directory":"packages/agent-sdk"},"_npmVersion":"10.8.2","description":"The open-source toolkit for building AI commerce agents using UCP, ACP, and MCP protocols","directories":{},"_nodeVersion":"20.20.2","dependencies":{"openai":"^6.22.0","@anthropic-ai/sdk":"^0.77.0","@google/generative-ai":"^0.24.0"},"_hasShrinkwrap":false,"devDependencies":{"vitest":"^4.0.17","express":"^4.21.0","typescript":"^5.6.3","@types/node":"^22.9.0","@types/express":"^5.0.0"},"peerDependencies":{"express":"^4.21.0"},"peerDependenciesMeta":{"express":{"optional":true}},"_npmOperationalInternal":{"tmp":"tmp/sdk_0.4.1_1777533018411_0.652567302079702","host":"s3://npm-registry-packages-npm-production"}},"0.4.2":{"name":"@agorio/sdk","version":"0.4.2","keywords":["ucp","acp","mcp","shopping-agent","ai-agent","agentic-commerce","gemini","claude","openai","ollama","cli","plugin","observability","universal-commerce-protocol","agentic-commerce-protocol"],"author":{"name":"UCPtools"},"license":"MIT","_id":"@agorio/sdk@0.4.2","maintainers":[{"name":"nolpak14","email":"piotr.kaplon@outlook.com"}],"homepage":"https://github.com/Nolpak14/agorio#readme","bugs":{"url":"https://github.com/Nolpak14/agorio/issues"},"bin":{"agorio":"dist/cli/index.js"},"dist":{"shasum":"894d9a589c0aceb5bc6d3caffb232e339658b6da","tarball":"https://registry.npmjs.org/@agorio/sdk/-/sdk-0.4.2.tgz","fileCount":96,"integrity":"sha512-mf5lw/XIja9PxlEtNwlMQiuIaBau98anzHH5qCl7Kqv3Gc9IDyilN9xup9GFWE3e9Nc+LxJEKiq/dxmvze97rg==","signatures":[{"sig":"MEQCIFLda96emVe9Dxd2z0/53akO5jvDQtkkqP4PZEAT39B1AiBVAAOdVpxccD6o1LhNr5PLw7sK+oTB8kWej4o2cnQ64A==","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"attestations":{"url":"https://registry.npmjs.org/-/npm/v1/attestations/@agorio%2fsdk@0.4.2","provenance":{"predicateType":"https://slsa.dev/provenance/v1"}},"unpackedSize":484451},"main":"dist/index.js","type":"module","types":"dist/index.d.ts","engines":{"node":">=20.0.0"},"exports":{".":{"types":"./dist/index.d.ts","import":"./dist/index.js"},"./mock":{"types":"./dist/mock/mock-merchant.d.ts","import":"./dist/mock/mock-merchant.js"}},"gitHead":"f82fcb68bb394524b5899854e9f2adb1a58e307a","scripts":{"test":"vitest","build":"tsc","typecheck":"tsc --noEmit --pretty"},"_npmUser":{"name":"nolpak14","email":"piotr.kaplon@outlook.com"},"repository":{"url":"git+https://github.com/Nolpak14/agorio.git","type":"git","directory":"packages/agent-sdk"},"_npmVersion":"10.8.2","description":"The open-source toolkit for building AI commerce agents using UCP, ACP, and MCP protocols","directories":{},"_nodeVersion":"20.20.2","dependencies":{"openai":"^6.22.0","@anthropic-ai/sdk":"^0.77.0","@google/generative-ai":"^0.24.0"},"_hasShrinkwrap":false,"devDependencies":{"vitest":"^4.0.17","express":"^4.21.0","typescript":"^5.6.3","@types/node":"^22.9.0","@types/express":"^5.0.0"},"peerDependencies":{"express":"^4.21.0"},"peerDependenciesMeta":{"express":{"optional":true}},"_npmOperationalInternal":{"tmp":"tmp/sdk_0.4.2_1777537826463_0.10121741771696535","host":"s3://npm-registry-packages-npm-production"}},"0.5.0":{"name":"@agorio/sdk","version":"0.5.0","keywords":["ucp","acp","mcp","shopping-agent","ai-agent","agentic-commerce","gemini","claude","openai","ollama","cli","plugin","observability","universal-commerce-protocol","agentic-commerce-protocol"],"author":{"name":"UCPtools"},"license":"MIT","_id":"@agorio/sdk@0.5.0","maintainers":[{"name":"nolpak14","email":"piotr.kaplon@outlook.com"}],"homepage":"https://github.com/Nolpak14/agorio#readme","bugs":{"url":"https://github.com/Nolpak14/agorio/issues"},"bin":{"agorio":"dist/cli/index.js"},"dist":{"shasum":"281fe5b4ea1ba619ae22a5a1ec1ad54f5f904d05","tarball":"https://registry.npmjs.org/@agorio/sdk/-/sdk-0.5.0.tgz","fileCount":109,"integrity":"sha512-FtASRjciXtGR8/+Zr5PHbNBfLXDGOreJ4YQPIXex92vP0YVxgrJdgXcheIkA3j+0MHfkc2Loca8+MkTfD41dYw==","signatures":[{"sig":"MEUCIQCtiM5KeNo0AB3Ib8a+yfTyVJmg6wgGwf+tZlu9o+gZSwIgYDxR6WplTv2g/0LBaC8a2zOfRZePRF3WIv9cY+X2MZ0=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":560075},"main":"dist/index.js","type":"module","types":"dist/index.d.ts","engines":{"node":">=20.0.0"},"exports":{".":{"types":"./dist/index.d.ts","import":"./dist/index.js"},"./mock":{"types":"./dist/mock/mock-merchant.d.ts","import":"./dist/mock/mock-merchant.js"}},"gitHead":"771ffbcd1f4e7410b429a29409d87d94c694c3ec","scripts":{"test":"vitest","build":"tsc","typecheck":"tsc --noEmit --pretty"},"_npmUser":{"name":"nolpak14","email":"piotr.kaplon@outlook.com"},"repository":{"url":"git+https://github.com/Nolpak14/agorio.git","type":"git","directory":"packages/agent-sdk"},"_npmVersion":"10.8.2","description":"The open-source toolkit for building AI commerce agents using UCP, ACP, and MCP protocols","directories":{},"_nodeVersion":"20.20.2","dependencies":{"openai":"^6.22.0","@anthropic-ai/sdk":"^0.77.0","@google/generative-ai":"^0.24.0"},"_hasShrinkwrap":false,"devDependencies":{"vitest":"^4.0.17","express":"^4.21.0","typescript":"^5.6.3","@types/node":"^22.9.0","@types/express":"^5.0.0"},"peerDependencies":{"express":"^4.21.0"},"peerDependenciesMeta":{"express":{"optional":true}},"_npmOperationalInternal":{"tmp":"tmp/sdk_0.5.0_1778869367467_0.42856714251067674","host":"s3://npm-registry-packages-npm-production"}},"0.6.0":{"name":"@agorio/sdk","version":"0.6.0","keywords":["ucp","acp","mcp","shopping-agent","ai-agent","agentic-commerce","gemini","claude","openai","ollama","cli","plugin","observability","universal-commerce-protocol","agentic-commerce-protocol"],"author":{"name":"UCPtools"},"license":"MIT","_id":"@agorio/sdk@0.6.0","maintainers":[{"name":"nolpak14","email":"piotr.kaplon@outlook.com"}],"homepage":"https://github.com/Nolpak14/agorio#readme","bugs":{"url":"https://github.com/Nolpak14/agorio/issues"},"bin":{"agorio":"dist/cli/index.js"},"dist":{"shasum":"a82fb54a1b9d718ece5b75c025e69c0c96405a41","tarball":"https://registry.npmjs.org/@agorio/sdk/-/sdk-0.6.0.tgz","fileCount":117,"integrity":"sha512-jpuYbcDfqL95utIRiAGbIm1yG/u+5oYGO2RUoxgcxs7LBQnCDhKv9UjE+SJUhJMiShwse3V0RWbyJUd8P5mPxA==","signatures":[{"sig":"MEUCIQDnrIPHxCtcTVQziaGHGfgGZXQw41QIFuIBs31reqM3zgIgL4DITWPSNelJnRT1ERxg21HIP5A8X/aMRp5tNW1eix8=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"attestations":{"url":"https://registry.npmjs.org/-/npm/v1/attestations/@agorio%2fsdk@0.6.0","provenance":{"predicateType":"https://slsa.dev/provenance/v1"}},"unpackedSize":582300},"main":"dist/index.js","type":"module","types":"dist/index.d.ts","engines":{"node":">=20.0.0"},"exports":{".":{"types":"./dist/index.d.ts","import":"./dist/index.js"},"./mock":{"types":"./dist/mock/mock-merchant.d.ts","import":"./dist/mock/mock-merchant.js"},"./cloud":{"types":"./dist/cloud/index.d.ts","import":"./dist/cloud/index.js"}},"gitHead":"ffe47db05d9c3e27791eb53f9bd41fdbe9543c73","scripts":{"test":"vitest","build":"tsc","typecheck":"tsc --noEmit --pretty"},"_npmUser":{"name":"nolpak14","email":"piotr.kaplon@outlook.com"},"repository":{"url":"git+https://github.com/Nolpak14/agorio.git","type":"git","directory":"packages/agent-sdk"},"_npmVersion":"10.8.2","description":"The open-source toolkit for building AI commerce agents using UCP, ACP, and MCP protocols","directories":{},"_nodeVersion":"20.20.2","dependencies":{"openai":"^6.22.0","@anthropic-ai/sdk":"^0.77.0","@google/generative-ai":"^0.24.0"},"_hasShrinkwrap":false,"devDependencies":{"vitest":"^4.0.17","express":"^4.21.0","typescript":"^5.6.3","@types/node":"^22.9.0","@types/express":"^5.0.0"},"peerDependencies":{"express":"^4.21.0"},"peerDependenciesMeta":{"express":{"optional":true}},"_npmOperationalInternal":{"tmp":"tmp/sdk_0.6.0_1778913433189_0.9796255430091612","host":"s3://npm-registry-packages-npm-production"}},"0.7.0":{"name":"@agorio/sdk","version":"0.7.0","keywords":["ucp","acp","mcp","shopping-agent","ai-agent","agentic-commerce","gemini","claude","openai","ollama","cli","plugin","observability","universal-commerce-protocol","agentic-commerce-protocol"],"author":{"name":"UCPtools"},"license":"MIT","_id":"@agorio/sdk@0.7.0","maintainers":[{"name":"nolpak14","email":"piotr.kaplon@outlook.com"}],"homepage":"https://github.com/Nolpak14/agorio#readme","bugs":{"url":"https://github.com/Nolpak14/agorio/issues"},"bin":{"agorio":"dist/cli/index.js"},"dist":{"shasum":"f06e8fd29b06c2b672876c4ed1472d33c9c5103a","tarball":"https://registry.npmjs.org/@agorio/sdk/-/sdk-0.7.0.tgz","fileCount":154,"integrity":"sha512-Zil1ohAjEx8CzzbqwE0MexWMs1YNl/r+/EKxQlWQ65uWBkbF5NRcrtj1CoVFDYanBxGzvwdcgAQawHvcpy5S+Q==","signatures":[{"sig":"MEUCID/d4dkMdOyFK9fVQQe6K9Hxz7uVIGewDOUKZQXkrXzJAiEApKYb2SA4UdF1ZiCXH5kTU4W0PpKDF3nxrpKJxbp239E=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"attestations":{"url":"https://registry.npmjs.org/-/npm/v1/attestations/@agorio%2fsdk@0.7.0","provenance":{"predicateType":"https://slsa.dev/provenance/v1"}},"unpackedSize":687736},"main":"dist/index.js","type":"module","types":"dist/index.d.ts","engines":{"node":">=20.0.0"},"exports":{".":{"types":"./dist/index.d.ts","import":"./dist/index.js"},"./mock":{"types":"./dist/mock/mock-merchant.d.ts","import":"./dist/mock/mock-merchant.js"},"./cloud":{"types":"./dist/cloud/index.d.ts","import":"./dist/cloud/index.js"}},"gitHead":"b78ce11bca70a788820a61371803cda145ace05c","scripts":{"test":"vitest","build":"tsc","typecheck":"tsc --noEmit --pretty"},"_npmUser":{"name":"nolpak14","email":"piotr.kaplon@outlook.com"},"repository":{"url":"git+https://github.com/Nolpak14/agorio.git","type":"git","directory":"packages/agent-sdk"},"_npmVersion":"10.8.2","description":"The open-source toolkit for building AI commerce agents using UCP, ACP, and MCP protocols","directories":{},"_nodeVersion":"20.20.2","dependencies":{"openai":"^6.22.0","@anthropic-ai/sdk":"^0.77.0","@google/generative-ai":"^0.24.0"},"_hasShrinkwrap":false,"devDependencies":{"vitest":"^4.0.17","express":"^4.21.0","typescript":"^5.6.3","@types/node":"^22.9.0","@types/express":"^5.0.0"},"peerDependencies":{"express":"^4.21.0"},"peerDependenciesMeta":{"express":{"optional":true}},"_npmOperationalInternal":{"tmp":"tmp/sdk_0.7.0_1778936763680_0.12687342710827898","host":"s3://npm-registry-packages-npm-production"}},"0.8.0":{"name":"@agorio/sdk","version":"0.8.0","keywords":["ucp","acp","mcp","shopping-agent","ai-agent","agentic-commerce","gemini","claude","openai","ollama","cli","plugin","observability","universal-commerce-protocol","agentic-commerce-protocol"],"author":{"name":"UCPtools"},"license":"MIT","_id":"@agorio/sdk@0.8.0","maintainers":[{"name":"nolpak14","email":"piotr.kaplon@outlook.com"}],"homepage":"https://github.com/Nolpak14/agorio#readme","bugs":{"url":"https://github.com/Nolpak14/agorio/issues"},"bin":{"agorio":"dist/cli/index.js"},"dist":{"shasum":"3c7840ebcdcf54b9f864a7ef66ecdd0cde861b07","tarball":"https://registry.npmjs.org/@agorio/sdk/-/sdk-0.8.0.tgz","fileCount":162,"integrity":"sha512-d3spRh/kkhc/raYI/5adXcKOH0Obmjx7R1eKqTpeprMCfW97gj3cuzugSkgZuB57WryZlea2GFs3GqvKlmeVCg==","signatures":[{"sig":"MEUCIGVRwwNuqkrbV8Ed1qFDXxEBf15WmmL7yNkIlfb+UgRuAiEA8UvBevswZlVd/zIIHWxNJ/UoBRgwAjX8woQH1kTuKHA=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"attestations":{"url":"https://registry.npmjs.org/-/npm/v1/attestations/@agorio%2fsdk@0.8.0","provenance":{"predicateType":"https://slsa.dev/provenance/v1"}},"unpackedSize":742308},"main":"dist/index.js","type":"module","types":"dist/index.d.ts","engines":{"node":">=20.0.0"},"exports":{".":{"types":"./dist/index.d.ts","import":"./dist/index.js"},"./mock":{"types":"./dist/mock/mock-merchant.d.ts","import":"./dist/mock/mock-merchant.js"},"./cloud":{"types":"./dist/cloud/index.d.ts","import":"./dist/cloud/index.js"}},"gitHead":"0db13dd4b09bcbf1428ca2bdd47202d61d09e018","scripts":{"test":"vitest","build":"tsc","typecheck":"tsc --noEmit --pretty"},"_npmUser":{"name":"nolpak14","email":"piotr.kaplon@outlook.com"},"repository":{"url":"git+https://github.com/Nolpak14/agorio.git","type":"git","directory":"packages/agent-sdk"},"_npmVersion":"10.8.2","description":"The open-source toolkit for building AI commerce agents using UCP, ACP, and MCP protocols","directories":{},"_nodeVersion":"20.20.2","dependencies":{"openai":"^6.22.0","@anthropic-ai/sdk":"^0.77.0","@google/generative-ai":"^0.24.0"},"_hasShrinkwrap":false,"devDependencies":{"vitest":"^4.0.17","express":"^4.21.0","typescript":"^5.6.3","@types/node":"^22.9.0","@types/express":"^5.0.0"},"peerDependencies":{"express":"^4.21.0"},"peerDependenciesMeta":{"express":{"optional":true}},"_npmOperationalInternal":{"tmp":"tmp/sdk_0.8.0_1779037642484_0.377514901134258","host":"s3://npm-registry-packages-npm-production"}},"0.9.0":{"name":"@agorio/sdk","version":"0.9.0","description":"The open-source toolkit for building AI commerce agents using UCP, ACP, and MCP protocols","type":"module","main":"dist/index.js","types":"dist/index.d.ts","bin":{"agorio":"dist/cli/index.js"},"exports":{".":{"types":"./dist/index.d.ts","import":"./dist/index.js"},"./mock":{"types":"./dist/mock/mock-merchant.d.ts","import":"./dist/mock/mock-merchant.js"},"./cloud":{"types":"./dist/cloud/index.d.ts","import":"./dist/cloud/index.js"}},"scripts":{"build":"tsc","test":"vitest","typecheck":"tsc --noEmit --pretty"},"keywords":["ucp","acp","mcp","shopping-agent","ai-agent","agentic-commerce","gemini","claude","openai","ollama","cli","plugin","observability","universal-commerce-protocol","agentic-commerce-protocol"],"license":"MIT","author":{"name":"UCPtools"},"repository":{"type":"git","url":"git+https://github.com/Nolpak14/agorio.git","directory":"packages/agent-sdk"},"engines":{"node":">=20.0.0"},"dependencies":{"@anthropic-ai/sdk":"^0.77.0","@google/generative-ai":"^0.24.0","openai":"^6.22.0"},"devDependencies":{"@types/express":"^5.0.0","@types/node":"^22.9.0","express":"^4.21.0","typescript":"^5.6.3","vitest":"^4.0.17"},"peerDependencies":{"express":"^4.21.0"},"peerDependenciesMeta":{"express":{"optional":true}},"_id":"@agorio/sdk@0.9.0","gitHead":"67629afd147c48cb22aed2932a81e5f7b7f9b886","bugs":{"url":"https://github.com/Nolpak14/agorio/issues"},"homepage":"https://github.com/Nolpak14/agorio#readme","_nodeVersion":"20.20.2","_npmVersion":"10.8.2","dist":{"integrity":"sha512-eadNVHVBrubF+wqDM/bYw3byn5uS74gyUI3w1mMW/MnBjRTzvfdUbth1hG5yDOA/Feye3H7VieVirj2jag5W6g==","shasum":"f297ad2e1fb0d5fb3b04563da83efa752776c124","tarball":"https://registry.npmjs.org/@agorio/sdk/-/sdk-0.9.0.tgz","fileCount":162,"unpackedSize":767605,"attestations":{"url":"https://registry.npmjs.org/-/npm/v1/attestations/@agorio%2fsdk@0.9.0","provenance":{"predicateType":"https://slsa.dev/provenance/v1"}},"signatures":[{"keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U","sig":"MEQCICkDZUSsBJ0G9fYqDFEnZ2GPuuAVpjP/evONPkw1jylXAiBpxmZWOrj/css5XSZXNsbsw3LH3dfaTI5pMIpHW3g+ew=="}]},"_npmUser":{"name":"nolpak14","email":"piotr.kaplon@outlook.com"},"directories":{},"maintainers":[{"name":"nolpak14","email":"piotr.kaplon@outlook.com"}],"_npmOperationalInternal":{"host":"s3://npm-registry-packages-npm-production","tmp":"tmp/sdk_0.9.0_1779085012657_0.9511588575074172"},"_hasShrinkwrap":false}},"time":{"created":"2026-02-19T07:17:49.457Z","modified":"2026-05-18T06:16:53.139Z","0.1.0":"2026-02-19T07:17:49.679Z","0.2.0":"2026-02-19T15:30:17.382Z","0.2.1":"2026-02-19T15:36:46.422Z","0.3.0":"2026-02-19T18:48:09.616Z","0.3.1":"2026-02-20T09:13:13.476Z","0.4.0":"2026-04-30T06:58:36.100Z","0.4.1":"2026-04-30T07:10:18.575Z","0.4.2":"2026-04-30T08:30:26.611Z","0.5.0":"2026-05-15T18:22:47.611Z","0.6.0":"2026-05-16T06:37:13.405Z","0.7.0":"2026-05-16T13:06:03.903Z","0.8.0":"2026-05-17T17:07:22.672Z","0.9.0":"2026-05-18T06:16:52.831Z"},"bugs":{"url":"https://github.com/Nolpak14/agorio/issues"},"author":{"name":"UCPtools"},"license":"MIT","homepage":"https://github.com/Nolpak14/agorio#readme","keywords":["ucp","acp","mcp","shopping-agent","ai-agent","agentic-commerce","gemini","claude","openai","ollama","cli","plugin","observability","universal-commerce-protocol","agentic-commerce-protocol"],"repository":{"type":"git","url":"git+https://github.com/Nolpak14/agorio.git","directory":"packages/agent-sdk"},"description":"The open-source toolkit for building AI commerce agents using UCP, ACP, and MCP protocols","maintainers":[{"name":"nolpak14","email":"piotr.kaplon@outlook.com"}],"readme":"<p align=\"center\">\n  <strong>agorio</strong>\n</p>\n\n<p align=\"center\">\n  The open-source toolkit for building AI commerce agents.\n</p>\n\n<p align=\"center\">\n  <a href=\"https://www.npmjs.com/package/@agorio/sdk\"><img src=\"https://img.shields.io/npm/v/@agorio/sdk.svg\" alt=\"npm version\"></a>\n  <a href=\"https://github.com/agorio/agorio/actions\"><img src=\"https://github.com/agorio/agorio/actions/workflows/ci.yml/badge.svg\" alt=\"CI\"></a>\n  <a href=\"https://github.com/agorio/agorio/blob/main/LICENSE\"><img src=\"https://img.shields.io/badge/license-MIT-blue.svg\" alt=\"License: MIT\"></a>\n  <a href=\"https://agorio.dev\"><img src=\"https://img.shields.io/badge/docs-agorio.dev-black\" alt=\"Docs\"></a>\n</p>\n\n---\n\nAgorio gives you everything you need to build AI agents that can discover merchants, browse products, and complete real purchases -- using the [UCP](https://github.com/Universal-Commerce-Protocol/ucp) (Google/Shopify) and [ACP](https://github.com/agentic-commerce-protocol/agentic-commerce-protocol) (OpenAI/Stripe) open commerce protocols. It works with any LLM. Ship a shopping agent in 20 lines of code.\n\n```typescript\nimport { ShoppingAgent, GeminiAdapter, MockMerchant } from '@agorio/sdk';\n\n// Start a mock merchant for testing\nconst merchant = new MockMerchant();\nawait merchant.start();\n\n// Create an agent powered by Gemini\nconst agent = new ShoppingAgent({\n  llm: new GeminiAdapter({ apiKey: process.env.GEMINI_API_KEY }),\n  verbose: true,\n});\n\n// Tell the agent what to buy\nconst result = await agent.run(\n  `Go to ${merchant.domain} and buy me wireless headphones`\n);\n\nconsole.log(result.answer);           // \"I found ProSound Wireless Headphones...\"\nconsole.log(result.checkout?.orderId); // \"ord_1708300000_abc123\"\n\nawait merchant.stop();\n```\n\nThat is a fully working agent that discovers a merchant via UCP, searches the catalog, adds items to a cart, goes through checkout with shipping and payment, and returns an order confirmation. The entire purchase flow, automated by an LLM.\n\n---\n\n## New in v0.8 — Compliance & Hardening\n\nEU AI Act enforcement begins **2 August 2026**. v0.8 ships the artifacts and primitives enterprise buyers want — without dropping any v0.7 capability. ([v0.8 plan](./docs/v0.8-plan.md) · [security posture](./docs/security.md) · [compliance posture](./docs/compliance.md))\n\n- 🛒 **BigCommerce adapter** — third real-merchant proof point with feature parity to Shopify + WooCommerce.\n- 🔐 **Agent identity attestation** — HMAC-signed `X-Agorio-Attestation` header on outgoing requests. Merchants verify with a shared secret. `AgentAttestation.wrapFetch()` is a one-liner.\n- 📑 **EU AI Act compliance export** — `GET /api/compliance/export?from=…&to=…&format=csv` emits Annex IV-aligned records direct from Cloud.\n- 📜 **Audit log** — every state-changing dashboard action lands in a tenant-scoped append-only table. Visible at `cloud.agorio.dev/audit-log`.\n- ✅ **AP2 GA** — `experimental_ap2` deprecated in favor of `ap2`. New `verifyMandateShape()` helper for receivers.\n- 🛡️ **`docs/security.md` + `docs/compliance.md`** — OWASP top-10 posture, dependency advisories, vuln disclosure, GDPR / PCI / SOC 2 / ISO 27001 stances.\n\n---\n\n## New in v0.7 — B2B Procurement\n\nBuild procurement agents that comparison-shop merchants, pause for human approval above your threshold, attach a PO# to every cart, and stream the full audit trail to [Agorio Cloud](https://cloud.agorio.dev) — composed as a single `AgentChain` of sub-agents. ([Full demo](./examples/procurement) · [Landing](https://agorio.dev/procurement) · [v0.7 plan](./docs/v0.7-plan.md))\n\n```typescript\nimport { AgentChain, ShoppingAgent, ClaudeAdapter, agorioCloud } from '@agorio/sdk';\nimport { createProcurementPlugin } from '@agorio/plugin-procurement';\nimport { createApprovalWorkflowPlugin } from '@agorio/plugin-approval-workflow';\n\nconst cloud = agorioCloud({ apiKey: process.env.AGORIO_API_KEY! });\n\nconst plugins = () => [\n  createApprovalWorkflowPlugin({ requireApprovalAbove: 1_000 }),\n  createProcurementPlugin({\n    vendors: VENDORS,\n    expenseCategories: ['office-supplies', 'it-equipment', 'furniture'],\n    requirePoOnCheckout: true,\n  }),\n];\n\nconst chain = new AgentChain()\n  .add({ name: 'find-best-price', description: '...', build: (ctx) =>\n    new ShoppingAgent({ llm, tracer: ctx.tracer, onLog: ctx.onLog, plugins: plugins() }) })\n  .add({ name: 'request-approval', description: '...', build: (ctx) =>\n    new ShoppingAgent({ llm, tracer: ctx.tracer, onLog: ctx.onLog, plugins: plugins() }) })\n  .add({ name: 'checkout-and-track', description: '...', build: (ctx) =>\n    new ShoppingAgent({ llm, tracer: ctx.tracer, onLog: ctx.onLog, plugins: plugins() }) });\n\nawait chain.run('Order 100 ergonomic chairs', { tracer: cloud.tracer, onLog: cloud.onLog });\n```\n\nv0.7 ships:\n\n- **`AgentChain` + sub-agent primitive** — compose specialized agents (find-price → checkout → track) with first-class Cloud span hierarchy\n- **`SessionStorage` interface** + `MemorySessionStorage`, `FileSessionStorage` in-tree, and a separate `@agorio/session-redis` package for production\n- **`@agorio/plugin-procurement`** — sixth governance plugin (PO# tracking, vendor lookup, expense categorization)\n- **HTTP retry + rate-limit primitives** (`createHttpClient`, `withRetry`, `TokenBucket`, `withRateLimit`) — drop into any adapter's `fetch:` option\n\n---\n\n## Why Agorio\n\nThe agentic commerce wave is here. Google AI Mode has 75M+ daily active users shopping through AI. Shopify is making 4.8M merchants discoverable via MCP. Stripe is enabling 1.5M merchants to accept agent payments with one line of code. Visa and Mastercard are enabling all US cardholders for agent transactions by holiday 2026.\n\nTwo open protocols are emerging as the standard:\n\n- **UCP** (Universal Commerce Protocol) -- backed by Google, Shopify, Etsy, Wayfair, Target, Walmart, Visa, Mastercard. [2,350 GitHub stars](https://github.com/Universal-Commerce-Protocol/ucp).\n- **ACP** (Agent Commerce Protocol) -- backed by OpenAI, Stripe, PayPal, Shopify. [1,200 GitHub stars](https://github.com/agentic-commerce-protocol/agentic-commerce-protocol).\n\nBut there is no developer toolkit for building on top of them. LangChain and CrewAI are generic agent frameworks. Apify is focused on web scraping. Nobody provides commerce-specific tools, protocol clients, or test infrastructure.\n\nAgorio fills that gap.\n\n| Capability | Building from Scratch | With Agorio |\n|---|---|---|\n| UCP merchant discovery | Parse `/.well-known/ucp` yourself, handle both capability formats, normalize services | `client.discover(\"shop.example.com\")` |\n| Product search and browsing | Build REST client, handle pagination, parse responses | Built-in agent tool, automatic |\n| Cart and checkout flow | Manage sessions, shipping, payment state machine | 17 tools handle the full flow |\n| LLM integration | Write provider-specific function calling code | Swap adapters: `GeminiAdapter`, `ClaudeAdapter`, `OpenAIAdapter` |\n| Testing against merchants | Stand up your own mock server, write fixtures | `new MockMerchant()` -- full UCP-compliant server with 10 products |\n| Chaos testing | Nothing built in | `{ latencyMs: 500, errorRate: 0.1 }` |\n| Agent orchestration loop | Implement plan-act-observe from scratch | `agent.run(\"buy me headphones\")` |\n\n---\n\n## What is Included\n\n### Agent SDK (`@agorio/sdk`)\n\nThe core library. Everything below ships in a single package.\n\n**ShoppingAgent** -- An LLM-driven agent that completes shopping tasks end-to-end. Uses a plan-act-observe loop with 17 built-in tools. Manages cart state, checkout sessions, and order history. Configurable iteration limits and step callbacks for observability.\n\n**UcpClient** -- Discovers merchants via `/.well-known/ucp`, normalizes both array and object capability formats, resolves REST/MCP/A2A transports, and makes authenticated API calls with timeout handling.\n\n**AcpClient** -- Manages ACP checkout sessions (create, get, update, complete, cancel) with Bearer token authentication, API versioning, and request tracing. Works with any ACP-compliant merchant.\n\n**McpClient** -- JSON-RPC 2.0 client for MCP (Model Context Protocol) transport. Automatic transport detection: when a merchant declares MCP transport, the SDK uses it; otherwise falls back to REST. No configuration needed.\n\n**LLM Adapters** -- Provider-agnostic interface. Ships with Gemini, Claude, OpenAI, and Ollama adapters, all with full function calling and streaming support. Ollama enables fully local/offline agents.\n\n**Plugin System** -- Extend the agent with custom tools beyond the built-in 17. Register plugins with name, description, JSON Schema parameters, and an async handler. Name collision detection prevents conflicts with built-in tools.\n\n**Observability** -- Structured logging via `onLog` callback, OpenTelemetry-compatible tracing via opt-in `tracer` interface (no hard dependency), and automatic usage metrics (token counts, tool call latency, total wall-clock time) on every `AgentResult`.\n\n**CLI Tool (`npx agorio`)** -- Developer CLI for common tasks:\n- `agorio mock` — start UCP, ACP, or MCP mock merchants\n- `agorio discover <domain>` — discover merchant protocol and capabilities\n- `agorio init [dir]` — scaffold a new agent project\n\n**MockMerchant** -- A complete UCP-compliant Express server for testing. Serves a UCP profile at `/.well-known/ucp`, OpenAPI schema, product CRUD, search with filtering, full checkout flow with session management, and order tracking. Configurable latency and error rate for chaos testing.\n\n**MockAcpMerchant** -- An ACP-compliant Express server for testing. Serves product catalog endpoints and all 5 ACP checkout session endpoints with Bearer auth, checkout state machine, and payment simulation.\n\n**MockMcpMerchant** -- An MCP-only merchant server for testing JSON-RPC transport. Serves UCP profile with MCP transport binding and implements all shopping methods via JSON-RPC 2.0.\n\n### 17 Built-in Shopping Tools (+ Plugins)\n\nThese are the function calling tools available to the agent during its reasoning loop. Each maps to a UCP/ACP operation:\n\n| Tool | Description |\n|---|---|\n| `discover_merchant` | Fetch and parse a merchant's UCP profile by domain |\n| `list_capabilities` | List what the merchant supports (checkout, orders, fulfillment, discounts) |\n| `browse_products` | Paginated product catalog with category filtering |\n| `search_products` | Keyword search across product names and descriptions |\n| `get_product` | Detailed product info including variants and pricing |\n| `add_to_cart` | Add products to cart with quantity and variant selection |\n| `view_cart` | View current cart contents and subtotal |\n| `remove_from_cart` | Remove items from cart |\n| `initiate_checkout` | Start checkout session, get shipping options |\n| `submit_shipping` | Submit shipping address |\n| `submit_payment` | Complete payment and receive order confirmation |\n| `get_order_status` | Check status of an existing order |\n| `switch_merchant` | Switch between multiple merchants (isolated cart/checkout per store) |\n| `get_product_reviews` | Read customer reviews for a product |\n| `apply_discount_code` | Apply a coupon or discount code at checkout |\n| `compare_prices` | Compare prices for the same product across multiple stores |\n| `subscribe_order_updates` | Subscribe to webhook notifications for order status changes |\n\nNeed more? Add custom tools via the [plugin system](#plugin-system).\n\n---\n\n## Quick Start\n\n### Prerequisites\n\n- Node.js 20 or later\n- An API key from any supported provider:\n  - [Gemini](https://aistudio.google.com/apikey) (free tier available)\n  - [OpenAI](https://platform.openai.com/api-keys)\n  - [Anthropic](https://console.anthropic.com/)\n  - Or use [Ollama](https://ollama.com/) for fully local/offline agents (no API key needed)\n\n### Install\n\n```bash\nnpm install @agorio/sdk\n```\n\n### Scaffold a new project (optional)\n\n```bash\nnpx agorio init my-agent\ncd my-agent\nnpm install\n```\n\n### Run your first agent\n\n```typescript\nimport { ShoppingAgent, GeminiAdapter, MockMerchant } from '@agorio/sdk';\n// Or use any adapter:\n// import { ClaudeAdapter } from '@agorio/sdk';\n// import { OpenAIAdapter } from '@agorio/sdk';\n// import { OllamaAdapter } from '@agorio/sdk';  // local, no API key\n\n// 1. Start a mock merchant (UCP-compliant test server)\nconst merchant = new MockMerchant({ name: 'TechShop' });\nawait merchant.start();\n\n// 2. Create an agent with your LLM of choice\nconst agent = new ShoppingAgent({\n  llm: new GeminiAdapter({\n    apiKey: process.env.GEMINI_API_KEY,\n    model: 'gemini-2.0-flash',   // default\n    temperature: 0.7,\n  }),\n  // Or swap in Claude/OpenAI/Ollama with zero code changes:\n  // llm: new ClaudeAdapter({ apiKey: process.env.ANTHROPIC_API_KEY }),\n  // llm: new OpenAIAdapter({ apiKey: process.env.OPENAI_API_KEY }),\n  // llm: new OllamaAdapter({ model: 'llama3.1' }),  // fully local\n  verbose: true,  // logs each think/tool/result step\n  maxIterations: 20,\n  onStep: (step) => {\n    // Optional: observe every agent step in real time\n    if (step.type === 'tool_call') {\n      console.log(`Calling ${step.toolName}...`);\n    }\n  },\n});\n\n// 3. Give it a task\nconst result = await agent.run(\n  `Go to ${merchant.domain} and buy me a mechanical keyboard with brown switches.\n   Ship to: Jane Doe, 123 Main St, San Francisco, CA 94102, US`\n);\n\n// 4. Inspect the result\nconsole.log(result.success);            // true\nconsole.log(result.answer);             // Natural language summary\nconsole.log(result.checkout?.orderId);   // \"ord_...\"\nconsole.log(result.checkout?.total);     // { amount: \"95.98\", currency: \"USD\" }\nconsole.log(result.iterations);          // Number of agent loop iterations\nconsole.log(result.steps.length);        // Full step trace for debugging\n\nawait merchant.stop();\n```\n\n### Use the UCP client directly\n\nIf you want lower-level control without the agent loop:\n\n```typescript\nimport { UcpClient } from '@agorio/sdk';\n\nconst client = new UcpClient({ timeoutMs: 10000 });\n\n// Discover a merchant\nconst discovery = await client.discover('shop.example.com');\nconsole.log(discovery.version);           // \"2026-01-11\"\nconsole.log(discovery.capabilities);      // [{ name: \"dev.ucp.shopping.checkout\", ... }]\nconsole.log(discovery.services);          // [{ name: \"dev.ucp.shopping\", transports: { rest, mcp, a2a } }]\nconsole.log(discovery.paymentHandlers);   // [{ id: \"stripe\", name: \"Stripe\" }]\n\n// Check capabilities\nclient.hasCapability('dev.ucp.shopping.checkout');  // true\n\n// Call merchant APIs\nconst products = await client.callApi('/products');\nconst product = await client.callApi('/products/prod_123');\nconst order = await client.callApi('/checkout', {\n  method: 'POST',\n  body: { items: [{ productId: 'prod_123', quantity: 1 }] },\n});\n```\n\n### Configure the mock merchant\n\n```typescript\nimport { MockMerchant } from '@agorio/sdk/mock';\n\nconst merchant = new MockMerchant({\n  port: 3456,             // Fixed port (default: random)\n  name: 'Chaos Shop',\n  latencyMs: 200,         // Simulate 200ms network latency\n  errorRate: 0.05,        // 5% of requests fail with 500\n  products: [             // Custom product catalog\n    {\n      id: 'custom_1',\n      name: 'Custom Widget',\n      description: 'A test product',\n      price: { amount: '9.99', currency: 'USD' },\n      category: 'Widgets',\n      inStock: true,\n    },\n  ],\n});\n```\n\n### Use the CLI\n\n```bash\n# Start a mock merchant for quick testing\nnpx agorio mock                    # UCP merchant on port 3456\nnpx agorio mock --acp --port 4000  # ACP merchant on port 4000\nnpx agorio mock --mcp              # MCP merchant (JSON-RPC transport)\n\n# Discover a merchant's capabilities\nnpx agorio discover localhost:3456\n\n# Scaffold a new project\nnpx agorio init my-agent\n```\n\n### Connect to a real store\n\nAgorio ships merchant adapters for real e-commerce platforms. Pass one (or more) to `ShoppingAgent` and the agent auto-routes all product/checkout calls through it.\n\n**Shopify** (Storefront API + UCP auto-detection for `*.myshopify.com`):\n\n```typescript\nimport { ShoppingAgent, ShopifyAdapter, ClaudeAdapter } from '@agorio/sdk';\n\nconst adapter = new ShopifyAdapter({\n  store: 'my-store',                          // your-store.myshopify.com\n  storefrontAccessToken: process.env.SHOPIFY_STOREFRONT_TOKEN!,\n  // preferUcp: true (default) — uses /.well-known/ucp when available\n});\n\nconst agent = new ShoppingAgent({\n  llm: new ClaudeAdapter({ apiKey: process.env.ANTHROPIC_API_KEY! }),\n  adapters: [adapter],\n});\n\nawait agent.run('Search for running shoes under $100 and add the best one to cart');\n```\n\n**WooCommerce** (REST API v3 — any WordPress site with WooCommerce):\n\n```typescript\nimport { ShoppingAgent, WooCommerceAdapter, ClaudeAdapter } from '@agorio/sdk';\n\n// Read-only (browsing/search, no auth required on public stores)\nconst adapter = new WooCommerceAdapter({ url: 'https://my-store.com' });\n\n// Write operations (checkout, orders) require consumer credentials\nconst adapterWithAuth = new WooCommerceAdapter({\n  url: 'https://my-store.com',\n  consumerKey: process.env.WC_CONSUMER_KEY!,\n  consumerSecret: process.env.WC_CONSUMER_SECRET!,\n});\n\nconst agent = new ShoppingAgent({\n  llm: new ClaudeAdapter({ apiKey: process.env.ANTHROPIC_API_KEY! }),\n  adapters: [adapterWithAuth],\n});\n\nawait agent.run('Find the cheapest t-shirt and create an order for 2');\n```\n\nYou can also probe a domain automatically — `isWooCommerceStore` hits `/wp-json/wc/v3/products` and returns `true` if the store exposes the WooCommerce REST API:\n\n```typescript\nimport { isWooCommerceStore } from '@agorio/sdk';\nconst isWc = await isWooCommerceStore('some-shop.com'); // true | false\n```\n\n| Adapter | Platform | Auth | Auto-detected |\n|---|---|---|---|\n| `ShopifyAdapter` | Shopify | Storefront token | `*.myshopify.com` via UCP |\n| `WooCommerceAdapter` | WooCommerce (WordPress) | Consumer key/secret (writes only) | `/wp-json/wc/v3` probe |\n\n### Add custom tools with plugins\n\nSee the [Plugin Development Guide](docs/plugin-development.md) for a full walk-through including enterprise lifecycle hooks, a wishlist plugin example, tests, and publishing instructions.\n\n\n```typescript\nconst agent = new ShoppingAgent({\n  llm: new GeminiAdapter({ apiKey: process.env.GEMINI_API_KEY }),\n  plugins: [\n    {\n      name: 'check_price_history',\n      description: 'Check historical prices for a product',\n      parameters: {\n        type: 'object',\n        properties: {\n          productId: { type: 'string', description: 'Product ID to check' },\n        },\n        required: ['productId'],\n      },\n      handler: async ({ productId }) => {\n        // Your custom logic here\n        return { prices: [{ date: '2026-01-01', price: '$89.99' }] };\n      },\n    },\n  ],\n});\n```\n\n### Add observability\n\n```typescript\nconst agent = new ShoppingAgent({\n  llm: adapter,\n  onLog: (event) => {\n    // Structured log events: level, message, data, timestamp\n    console.log(`[${event.level}] ${event.message}`);\n  },\n  tracer: myOpenTelemetryTracer, // optional, OTel-compatible\n});\n\nconst result = await agent.run('Buy headphones from shop.example.com');\nconsole.log(result.usage?.totalTokens);     // Total tokens consumed\nconsole.log(result.usage?.llmCalls);         // Number of LLM roundtrips\nconsole.log(result.usage?.toolCallLatency);  // Per-tool latency in ms\nconsole.log(result.usage?.totalLatencyMs);   // Wall-clock time\n```\n\n---\n\n## Architecture\n\n```\n@agorio/sdk\n  |\n  |-- agent/\n  |     ShoppingAgent          # LLM-driven plan-act-observe loop\n  |                            # Manages cart, checkout, orders, plugins\n  |\n  |-- client/\n  |     UcpClient              # UCP discovery + REST/MCP auto-transport\n  |     AcpClient              # ACP checkout session client\n  |     McpClient              # JSON-RPC 2.0 client for MCP transport\n  |\n  |-- llm/\n  |     LlmAdapter (interface) # Provider-agnostic LLM contract\n  |     GeminiAdapter          # Google Gemini with function calling\n  |     ClaudeAdapter          # Anthropic Claude with function calling\n  |     OpenAIAdapter          # OpenAI GPT with function calling\n  |     OllamaAdapter          # Ollama for local/offline agents\n  |     tools.ts               # 17 shopping tool definitions (JSON Schema)\n  |\n  |-- cli/\n  |     agorio mock            # Start mock merchants (UCP/ACP/MCP)\n  |     agorio discover        # Discover merchant capabilities\n  |     agorio init            # Scaffold new agent project\n  |\n  |-- mock/\n  |     MockMerchant           # Full UCP-compliant Express test server\n  |     MockAcpMerchant        # Full ACP-compliant Express test server\n  |     MockMcpMerchant        # MCP-only Express test server (JSON-RPC)\n  |     fixtures.ts            # 10-product catalog + UCP profile builder\n  |\n  |-- types/\n        UcpProfile, UcpService, UcpCapability, McpClientOptions\n        AcpCheckoutSession, AcpClient, AcpLineItem\n        LlmAdapter, ChatMessage, ToolCall, LlmStreamChunk\n        AgentOptions, AgentResult, AgentStep, AgentStreamEvent\n        AgentPlugin, AgentLogEvent, AgentTracer, AgentUsageSummary\n        CartItem, CheckoutResult, MockProduct\n```\n\nThe `LlmAdapter` interface is the key abstraction:\n\n```typescript\ninterface LlmAdapter {\n  chat(messages: ChatMessage[], tools?: ToolDefinition[]): Promise<LlmResponse>;\n  chatStream?(messages: ChatMessage[], tools?: ToolDefinition[]): AsyncIterable<LlmStreamChunk>;\n  readonly modelName: string;\n}\n```\n\nAny LLM that supports function calling can implement this interface. The `ShoppingAgent` does not know or care which model is behind it. The optional `chatStream` method enables real-time streaming via `agent.runStream()`.\n\n---\n\n## Supported LLMs\n\n| Provider | Adapter | Status | Function Calling |\n|---|---|---|---|\n| Google Gemini | `GeminiAdapter` | Available | Native |\n| Anthropic Claude | `ClaudeAdapter` | Available | Native |\n| OpenAI / ChatGPT | `OpenAIAdapter` | Available | Native |\n| Ollama (local) | `OllamaAdapter` | Available | Via tool use |\n| Any provider | Implement `LlmAdapter` | Build your own | Any |\n\nTo build your own adapter, implement the `LlmAdapter` interface and pass it to `ShoppingAgent`. See the [Gemini adapter source](src/llm/gemini.ts) for a reference implementation.\n\n---\n\n## Send traces to Agorio Cloud\n\nAgorio Cloud is the hosted observability dashboard at [cloud.agorio.dev](https://cloud.agorio.dev). Pro subscribers get a per-run trace explorer with the tool-call timeline, LLM token counts, structured logs, and the final answer for every agent run. Setup is a single helper that spreads into `AgentOptions`:\n\n```typescript\nimport { ShoppingAgent, agorioCloud, ClaudeAdapter } from '@agorio/sdk';\n\nconst cloud = agorioCloud({ apiKey: process.env.AGORIO_API_KEY! });\n\nconst agent = new ShoppingAgent({\n  llm: new ClaudeAdapter({ apiKey: process.env.ANTHROPIC_API_KEY! }),\n  ...cloud, // contributes tracer, onLog, onStep, onComplete\n});\n\nawait agent.run('find me running shoes under $100');\n// Trace appears at cloud.agorio.dev/traces within seconds.\n```\n\nGet an API key at [cloud.agorio.dev/api-keys](https://cloud.agorio.dev/api-keys) after subscribing. Network failures never break your agent — `agorioCloud()` swallows errors and only emits `console.warn` on bad/revoked keys or unreachable endpoints. See [docs/cloud-setup.md](docs/cloud-setup.md) for the full guide.\n\n---\n\n## Testing\n\nAgorio uses [Vitest](https://vitest.dev/) and ships with **306 tests across 18 test files** covering the UCP client, ACP client, MCP transport, AP2 client, mock merchants, agent orchestration, plugins, enterprise plugin middleware, observability, streaming, CLI, webhooks, multi-merchant, Shopify adapter, WooCommerce adapter, Agorio Cloud helper, and all four LLM adapters.\n\n```bash\n# Run all tests\nnpm test\n\n# Run with coverage\nnpm test -- --coverage\n\n# Run a specific test file\nnpm test -- tests/ucp-client.test.ts\n```\n\nThe mock merchant makes it easy to write integration tests for your own agents:\n\n```typescript\nimport { describe, it, expect, beforeAll, afterAll } from 'vitest';\nimport { MockMerchant, UcpClient } from '@agorio/sdk';\n\ndescribe('my agent', () => {\n  let merchant: MockMerchant;\n  let client: UcpClient;\n\n  beforeAll(async () => {\n    merchant = new MockMerchant();\n    await merchant.start();\n    client = new UcpClient();\n    await client.discover(merchant.domain);\n  });\n\n  afterAll(async () => {\n    await merchant.stop();\n  });\n\n  it('discovers the merchant', () => {\n    expect(client.hasCapability('dev.ucp.shopping.checkout')).toBe(true);\n  });\n\n  it('searches products', async () => {\n    const result = await client.callApi('/products/search?q=headphones');\n    expect(result).toHaveProperty('products');\n  });\n});\n```\n\n---\n\n## Roadmap\n\nSee [docs/ROADMAP.md](docs/ROADMAP.md) for the full plan with rationale and market context.\n\n### Shipped\n\n- **v0.2** — Multi-LLM (Claude, OpenAI), streaming, ACP client, dual-protocol agent, landing page. 113 tests.\n- **v0.3** — MCP transport, plugin system, observability, CLI, Ollama adapter, reference agents. 191 tests.\n- **v0.4** — Multi-merchant, Shopify adapter, webhooks, browser playground, 17 tools. 233 tests.\n- **v0.4.2 (May 2026)** — Enterprise plugin system (5 governance plugins), Stripe billing, Neon Postgres, customer dashboard, Resend email, `agorio plugin` CLI. 252 tests.\n- **v0.5 (May 2026)** — Open Core release: 5 plugins relicensed MIT and published as `@agorio/plugin-*`, WooCommerce adapter, Shopify UCP migration support, experimental AP2 client. 301 tests.\n- **v0.6 (May 2026)** — Agorio Cloud MVP: `agorioCloud({ apiKey })` helper, hosted trace explorer at `cloud.agorio.dev`, API key management on Cloud, cross-subdomain auth, brand-native terminal-frame auth UI. 306 tests.\n\n### Next (v0.6.1) — Cloud feature completion, ~3 weeks\n\n- [ ] Hosted approval-workflow webhook receiver + click-to-approve UI\n- [ ] Hosted, license-key-gated mock UCP/ACP/MCP merchants for CI pipelines\n- [ ] Fleet view / org-level rollup\n- [ ] Stale-run sweeper\n\n### Then (v0.7) — B2B Procurement Vertical, Q3/Q4 2026\n\n- [ ] Procurement reference agent with approval thresholds + full audit trail\n- [ ] Agent composition primitives (chain specialized sub-agents)\n- [ ] Persistent sessions, rate limiting, retry\n\n### v0.8 — Compliance & Hardening, Q4 2026\n\n- [ ] EU AI Act compliance export module\n- [ ] Security audit, BotID integration, BigCommerce adapter\n\n### v1.0 — Production GA, H1 2027\n\nStability + semver guarantees, full protocol coverage, enterprise SSO, comprehensive docs site.\n\n---\n\n## Agorio Pro\n\nThe SDK is free and MIT-licensed forever. **Agorio Pro** ($149/yr or $19/mo per team) is the upcoming hosted Cloud offering — observability dashboard, hosted approval webhooks, CI mock merchants, EU AI Act-ready audit exports.\n\nThe 5 governance plugins (spending controls, approval workflow, audit trail, agent identity, policy engine) will be relicensed MIT and published to npm in v0.5 — Pro will be about the hosted *service*, not the code.\n\nSee [agorio.dev/pricing](https://agorio.dev/pricing) and [docs/monetization.md](docs/monetization.md).\n\n---\n\n## Plugin CLI\n\nManage `@agorio/plugin-*` packages directly from the SDK CLI:\n\n```bash\nnpx agorio plugin list                          # List installed @agorio plugins\nnpx agorio plugin install spending-controls     # Install a plugin from npm\nnpx agorio plugin info spending-controls        # Show metadata for an installed plugin\n```\n\n---\n\n## Project Structure\n\n```\nagorio/\n  src/\n    index.ts                    # Public API exports\n    types/index.ts              # All TypeScript types\n    client/\n      ucp-client.ts             # UCP discovery + REST/MCP auto-transport\n      acp-client.ts             # ACP checkout session client\n      mcp-client.ts             # JSON-RPC 2.0 client for MCP transport\n    llm/\n      gemini.ts                 # Google Gemini adapter (+ streaming)\n      claude.ts                 # Anthropic Claude adapter (+ streaming)\n      openai.ts                 # OpenAI GPT adapter (+ streaming)\n      ollama.ts                 # Ollama adapter for local models\n      tools.ts                  # 17 shopping tool definitions\n    agent/shopping-agent.ts     # Agent orchestrator (plugins, observability)\n    cli/\n      index.ts                  # CLI entry point (npx agorio)\n      commands/mock.ts          # agorio mock command\n      commands/discover.ts      # agorio discover command\n      commands/init.ts          # agorio init command\n    mock/\n      mock-merchant.ts          # UCP-compliant test server\n      mock-acp-merchant.ts      # ACP-compliant test server\n      mock-mcp-merchant.ts      # MCP-only test server (JSON-RPC)\n      fixtures.ts               # Product catalog + profile builder\n  tests/\n    ucp-client.test.ts          # 13 tests\n    mcp-client.test.ts          # 22 tests\n    mock-merchant.test.ts       # 17 tests\n    shopping-agent.test.ts      # 7 tests\n    plugin-system.test.ts       # 9 tests\n    observability.test.ts       # 13 tests\n    claude-adapter.test.ts      # 18 tests\n    openai-adapter.test.ts      # 18 tests\n    ollama-adapter.test.ts      # 21 tests\n    streaming.test.ts           # 12 tests\n    acp-client.test.ts          # 20 tests\n    acp-agent.test.ts           # 8 tests\n    cli.test.ts                 # 13 tests\n    multi-merchant.test.ts      # 12 tests\n    shopify-adapter.test.ts     # 15 tests\n    shopify-ucp-migration.test.ts # 10 tests\n    woocommerce-adapter.test.ts # 21 tests\n    ap2-client.test.ts          # 21 tests\n    webhook.test.ts             # 15 tests\n  package.json\n  tsconfig.json\n  vitest.config.ts\n```\n\n---\n\n## Contributing\n\nWe welcome contributions. See [CONTRIBUTING.md](CONTRIBUTING.md) for setup instructions, coding standards, and the PR process.\n\nAreas where contributions are especially valuable:\n\n- **LLM adapters** -- Mistral, Cohere, or any other provider (implement `LlmAdapter`)\n- **Plugins** -- custom tools for wishlists, reviews, returns, price alerts\n- **Reference agents** -- example agents that demonstrate real use cases\n- **Documentation** -- tutorials, guides, examples\n- **Bug reports** -- especially around edge cases in UCP/MCP profile parsing\n\n---\n\n## Ecosystem Context\n\nAgorio builds on two open commerce protocols that are being adopted at scale:\n\n**UCP** (Universal Commerce Protocol) is backed by Google, Shopify, Etsy, Wayfair, Target, Walmart, Visa, Mastercard, Stripe, and PayPal. It defines how AI agents discover merchants and their capabilities via `/.well-known/ucp` profiles. SDKs exist in JavaScript, Python, Java, .NET, Go, PHP, and Dart.\n\n**ACP** (Agent Commerce Protocol) is backed by OpenAI, Stripe, PayPal, and Shopify. It focuses on the payment and transaction layer for agent commerce.\n\nThe merchant infrastructure is growing rapidly:\n- 4.8M Shopify merchants are discoverable via Catalog MCP\n- 1.5M Stripe merchants can enable ACP with one line of code\n- 35M PayPal merchants are coming online via Agent Ready\n- Visa and Mastercard are enabling all US cardholders by late 2026\n\nAgorio is an independent, community-driven project. It is not affiliated with Google, Shopify, OpenAI, or Stripe. UCP and ACP are open standards maintained by their respective organizations.\n\n---\n\n## License\n\n[MIT](LICENSE) -- use it however you want.\n\n---\n\n<p align=\"center\">\n  <a href=\"https://agorio.dev\">Website</a> &middot;\n  <a href=\"https://github.com/agorio/agorio/issues\">Issues</a> &middot;\n  <a href=\"https://github.com/agorio/agorio/discussions\">Discussions</a>\n</p>\n","readmeFilename":"README.md"}