{"_id":"@animocabrands/minds-client-lib","_rev":"12-681705613912d278a2e379ce29dabe5e","name":"@animocabrands/minds-client-lib","dist-tags":{"beta":"0.1.1","latest":"0.1.7"},"versions":{"0.1.0":{"name":"@animocabrands/minds-client-lib","version":"0.1.0","license":"UNLICENSED","_id":"@animocabrands/minds-client-lib@0.1.0","maintainers":[{"name":"daniel_animoca","email":"daniell@animocabrands.com"},{"name":"michaelg92","email":"michaelg@animocabrands.com"},{"name":"ab1-npmjs","email":"npmjs@animocabrands.com"},{"name":"andysob","email":"andys@animocabrands.com"}],"dist":{"shasum":"54d7609d199d7ba1cbf5681657fe4c5649db2cd7","tarball":"https://registry.npmjs.org/@animocabrands/minds-client-lib/-/minds-client-lib-0.1.0.tgz","fileCount":4,"integrity":"sha512-qfYspH7zFtnqqHav0CT8a0f8XxzMb85xXPvmXehic3Zh3HYpHIGHOGuMsv4/0oZIGrYIB5/b1GgrB+gOjOT5Iw==","signatures":[{"sig":"MEUCIH09Kcqdf0S3VIgS00DcWv/mFDJjUPf+Foi9ZU/c6ccYAiEAiMQCcauGZ1E677ko6zIF3yEj6SgaEQAXcu6s86EZo4A=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":52451},"type":"module","_from":"file:animocabrands-minds-client-lib-0.1.0.tgz","engines":{"node":">=22"},"exports":{".":{"types":"./dist/index.d.ts","import":"./dist/index.js"}},"scripts":{"lint":"eslint src tests","test":"vitest run","build":"tsup","typecheck":"tsc --noEmit","test:coverage":"vitest run --coverage","generate-types":"openapi-typescript ../../spec/openapi.build.json -o src/types.gen.ts"},"_npmUser":{"name":"daniel_animoca","email":"daniell@animocabrands.com"},"_resolved":"/tmp/08c9d68f4c81994c62ccbbdb6b27ff0a/animocabrands-minds-client-lib-0.1.0.tgz","_integrity":"sha512-qfYspH7zFtnqqHav0CT8a0f8XxzMb85xXPvmXehic3Zh3HYpHIGHOGuMsv4/0oZIGrYIB5/b1GgrB+gOjOT5Iw==","_npmVersion":"11.12.1","description":"TypeScript client for Minds by Animoca Brands Builder API","directories":{},"_nodeVersion":"24.15.0","_hasShrinkwrap":false,"devDependencies":{"tsup":"^8.3.5","vitest":"^2.1.8","@types/node":"^22.10.2","openapi-typescript":"^7.6.1","@vitest/coverage-v8":"2.1.9"},"_npmOperationalInternal":{"tmp":"tmp/minds-client-lib_0.1.0_1780998508417_0.8154584316647469","host":"s3://npm-registry-packages-npm-production"}},"0.1.1":{"name":"@animocabrands/minds-client-lib","version":"0.1.1","license":"UNLICENSED","_id":"@animocabrands/minds-client-lib@0.1.1","maintainers":[{"name":"daniel_animoca","email":"daniell@animocabrands.com"},{"name":"michaelg92","email":"michaelg@animocabrands.com"},{"name":"ab1-npmjs","email":"npmjs@animocabrands.com"},{"name":"jackyyab1","email":"jackyy@animocabrands.com"},{"name":"andysob","email":"andys@animocabrands.com"}],"dist":{"shasum":"fe38888a6d2c692c0e7f8b6bed6ea1ef30c84ebf","tarball":"https://registry.npmjs.org/@animocabrands/minds-client-lib/-/minds-client-lib-0.1.1.tgz","fileCount":5,"integrity":"sha512-0RZzTrOZIzosCktCQA9TaPcXyWaCltk8nSNUxGm6RgYzlWRdSzrXhRiZoEmeEN1GolrtbnlEL1n43k4olKePkQ==","signatures":[{"sig":"MEUCIQC1HOycQTHBbNjtf2gpoyzpzLDQIZSHokft7deeqa3B3QIgYt5Z+V3j82Y/8S/oimji2bwUOZIkZ16g8oLYz1EQyGY=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":71931},"type":"module","_from":"file:animocabrands-minds-client-lib-0.1.1.tgz","engines":{"node":">=22"},"exports":{".":{"types":"./dist/index.d.ts","import":"./dist/index.js"}},"scripts":{"lint":"eslint src tests","test":"vitest run","build":"tsup","typecheck":"tsc --noEmit","test:coverage":"vitest run --coverage","generate-types":"openapi-typescript ../../spec/openapi.build.json -o src/types.gen.ts"},"_npmUser":{"name":"daniel_animoca","email":"daniell@animocabrands.com"},"_resolved":"/tmp/0a2343956a3053eb679844bbefd13e92/animocabrands-minds-client-lib-0.1.1.tgz","_integrity":"sha512-0RZzTrOZIzosCktCQA9TaPcXyWaCltk8nSNUxGm6RgYzlWRdSzrXhRiZoEmeEN1GolrtbnlEL1n43k4olKePkQ==","_npmVersion":"11.12.1","description":"TypeScript client for Minds by Animoca Brands Builder API","directories":{},"_nodeVersion":"24.15.0","_hasShrinkwrap":false,"readmeFilename":"README.md","devDependencies":{"tsup":"^8.3.5","vitest":"^2.1.8","@types/node":"^22.10.2","openapi-typescript":"^7.6.1","@vitest/coverage-v8":"2.1.9"},"_npmOperationalInternal":{"tmp":"tmp/minds-client-lib_0.1.1_1782408219939_0.581479746719753","host":"s3://npm-registry-packages-npm-production"}},"0.1.2":{"name":"@animocabrands/minds-client-lib","version":"0.1.2","license":"UNLICENSED","_id":"@animocabrands/minds-client-lib@0.1.2","maintainers":[{"name":"daniel_animoca","email":"daniell@animocabrands.com"},{"name":"michaelg92","email":"michaelg@animocabrands.com"},{"name":"ab1-npmjs","email":"npmjs@animocabrands.com"},{"name":"jackyyab1","email":"jackyy@animocabrands.com"},{"name":"andysob","email":"andys@animocabrands.com"}],"dist":{"shasum":"fefb0035139620b482db595b1c0b9e127fc31efb","tarball":"https://registry.npmjs.org/@animocabrands/minds-client-lib/-/minds-client-lib-0.1.2.tgz","fileCount":5,"integrity":"sha512-2yBbkDzq1Z+xJzLzEIIyYy3oE6VopGiBLsyJW541BtqHUdoNbirQKFh8Mp+TVdU0F4fxu//RICFBjDGflziBZQ==","signatures":[{"sig":"MEUCIDhPvkhAUPxQQRS3U1B2cIACR5mZZKepuGMsxG4ifMq7AiEA1cXGxr2GusSeoMplG4ELjI3QqFoVe8s33KGYgABBtSw=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":98375},"type":"module","_from":"file:animocabrands-minds-client-lib-0.1.2.tgz","engines":{"node":">=22"},"exports":{".":{"types":"./dist/index.d.ts","import":"./dist/index.js"}},"scripts":{"lint":"eslint src tests","test":"vitest run","build":"tsup","typecheck":"tsc --noEmit","test:coverage":"vitest run --coverage","generate-types":"openapi-typescript ../../spec/openapi.build.json -o src/types.gen.ts"},"_npmUser":{"name":"daniel_animoca","email":"daniell@animocabrands.com"},"_resolved":"/tmp/1eb25ebc2ad36edfcea497fffd4ca452/animocabrands-minds-client-lib-0.1.2.tgz","_integrity":"sha512-2yBbkDzq1Z+xJzLzEIIyYy3oE6VopGiBLsyJW541BtqHUdoNbirQKFh8Mp+TVdU0F4fxu//RICFBjDGflziBZQ==","_npmVersion":"11.12.1","description":"TypeScript client for Minds by Animoca Brands Builder API","directories":{},"_nodeVersion":"24.15.0","_hasShrinkwrap":false,"devDependencies":{"tsup":"^8.3.5","vitest":"^2.1.8","@types/node":"^22.10.2","openapi-typescript":"^7.6.1","@vitest/coverage-v8":"2.1.9"},"_npmOperationalInternal":{"tmp":"tmp/minds-client-lib_0.1.2_1782809956868_0.964464934828063","host":"s3://npm-registry-packages-npm-production"}},"0.1.3":{"name":"@animocabrands/minds-client-lib","version":"0.1.3","license":"UNLICENSED","_id":"@animocabrands/minds-client-lib@0.1.3","maintainers":[{"name":"daniel_animoca","email":"daniell@animocabrands.com"},{"name":"michaelg92","email":"michaelg@animocabrands.com"},{"name":"ab1-npmjs","email":"npmjs@animocabrands.com"},{"name":"jackyyab1","email":"jackyy@animocabrands.com"},{"name":"andysob","email":"andys@animocabrands.com"}],"dist":{"shasum":"e34cc15194b66e39df924ff7cf1f5d9b95759d55","tarball":"https://registry.npmjs.org/@animocabrands/minds-client-lib/-/minds-client-lib-0.1.3.tgz","fileCount":5,"integrity":"sha512-tPWdcg67C0/OKBhDsFkeU3RDHFzK+hrXKCk3hIMYcZQz+q08NfT/8GPj9UpDsA8ag675AaZjH5NIYNmYSyViqQ==","signatures":[{"sig":"MEUCIA16EzWDZ2YeKono8u/P2flNthyDes7SEVBFZdKZ9mhrAiEA/ETDKTXTYEgYcMqfgWj+5GAk1NOAyTDskMK3h9fAs/0=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":107011},"type":"module","_from":"file:animocabrands-minds-client-lib-0.1.3.tgz","engines":{"node":">=22"},"exports":{".":{"types":"./dist/index.d.ts","import":"./dist/index.js"}},"scripts":{"lint":"eslint src tests","test":"vitest run","build":"tsup","typecheck":"tsc --noEmit","test:coverage":"vitest run --coverage","generate-types":"openapi-typescript ../../spec/openapi.build.json -o src/types.gen.ts"},"_npmUser":{"name":"daniel_animoca","email":"daniell@animocabrands.com"},"_resolved":"/tmp/2f972a41dbecd21a672d5edef022343c/animocabrands-minds-client-lib-0.1.3.tgz","_integrity":"sha512-tPWdcg67C0/OKBhDsFkeU3RDHFzK+hrXKCk3hIMYcZQz+q08NfT/8GPj9UpDsA8ag675AaZjH5NIYNmYSyViqQ==","_npmVersion":"11.12.1","description":"TypeScript client for Minds by Animoca Brands Builder API","directories":{},"_nodeVersion":"24.15.0","_hasShrinkwrap":false,"devDependencies":{"tsup":"^8.3.5","vitest":"^2.1.8","@types/node":"^22.10.2","openapi-typescript":"^7.6.1","@vitest/coverage-v8":"2.1.9"},"_npmOperationalInternal":{"tmp":"tmp/minds-client-lib_0.1.3_1784625322211_0.4120341372163774","host":"s3://npm-registry-packages-npm-production"}},"0.1.4":{"name":"@animocabrands/minds-client-lib","version":"0.1.4","license":"UNLICENSED","_id":"@animocabrands/minds-client-lib@0.1.4","maintainers":[{"name":"daniel_animoca","email":"daniell@animocabrands.com"},{"name":"michaelg92","email":"michaelg@animocabrands.com"},{"name":"ab1-npmjs","email":"npmjs@animocabrands.com"},{"name":"jackyyab1","email":"jackyy@animocabrands.com"},{"name":"andysob","email":"andys@animocabrands.com"}],"dist":{"shasum":"2bfdcf787132e3485a676f8768e0e3e652858fd9","tarball":"https://registry.npmjs.org/@animocabrands/minds-client-lib/-/minds-client-lib-0.1.4.tgz","fileCount":5,"integrity":"sha512-JVtA2R/yXQIhnHw/MsTJSZKCzeWyBarcssEmdFYtLiEQCb8tkWDkZqYSKCH4SvfxK4GiNJ7TYrUl7kejZx7szg==","signatures":[{"sig":"MEUCIQCBpy2xGqF4rZMuITL+JHsTrlKoCWNBrUpTtHLLXEVkOgIgUcALkhP7sVj65a7ssJt7MqSvc0addmJ/v5bnNMzs4Oo=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":117443},"type":"module","_from":"file:animocabrands-minds-client-lib-0.1.4.tgz","engines":{"node":">=22"},"exports":{".":{"types":"./dist/index.d.ts","import":"./dist/index.js"}},"scripts":{"lint":"eslint src tests","test":"vitest run","build":"tsup","typecheck":"tsc --noEmit","test:coverage":"vitest run --coverage","generate-types":"openapi-typescript ../../spec/openapi.build.json -o src/types.gen.ts"},"_npmUser":{"name":"daniel_animoca","email":"daniell@animocabrands.com"},"_resolved":"/tmp/5e1036ef48eb9886734203aabc31a8cc/animocabrands-minds-client-lib-0.1.4.tgz","_integrity":"sha512-JVtA2R/yXQIhnHw/MsTJSZKCzeWyBarcssEmdFYtLiEQCb8tkWDkZqYSKCH4SvfxK4GiNJ7TYrUl7kejZx7szg==","_npmVersion":"11.12.1","description":"TypeScript client for Minds by Animoca Brands Builder API","directories":{},"_nodeVersion":"24.15.0","_hasShrinkwrap":false,"devDependencies":{"tsup":"^8.3.5","vitest":"^2.1.8","@types/node":"^22.10.2","openapi-typescript":"^7.6.1","@vitest/coverage-v8":"2.1.9"},"_npmOperationalInternal":{"tmp":"tmp/minds-client-lib_0.1.4_1787651016518_0.10538183981833327","host":"s3://npm-registry-packages-npm-production"}},"0.1.5":{"name":"@animocabrands/minds-client-lib","version":"0.1.5","license":"UNLICENSED","_id":"@animocabrands/minds-client-lib@0.1.5","maintainers":[{"name":"daniel_animoca","email":"daniell@animocabrands.com"},{"name":"julianat","email":"julianat@animocabrands.com"},{"name":"michaelg92","email":"michaelg@animocabrands.com"},{"name":"ab1-npmjs","email":"npmjs@animocabrands.com"},{"name":"jackyyab1","email":"jackyy@animocabrands.com"},{"name":"andysob","email":"andys@animocabrands.com"}],"dist":{"shasum":"9d1ac20ad6fa0c2497895676ff0c80aee0f55340","tarball":"https://registry.npmjs.org/@animocabrands/minds-client-lib/-/minds-client-lib-0.1.5.tgz","fileCount":5,"integrity":"sha512-T4pR9xSMD5peefCKjDRqL8/UPT2kVba9+Tirfu1tiEhyXFArxVnJcPV2WFwAmnNR0juOdNqnrR8X9/Dx32lyjQ==","signatures":[{"sig":"MEQCIHM672wyB3E1o2tydIS0Q/fxnw3luBqm0IPqPbcu0nnHAiBmXArVrorS6iys4G4/A9zQw/f9iYpumabLzzVNJ0+fvA==","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"},{"sig":"MEYCIQCeEeuDfi9YD8knjZLY3KiRf0CASHoqsFgdBxvX1HruWgIhAIooBuaqDkwOhNfnAmU9LojqmNeTuEdnAH3IvZnSqfQE","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":130059},"type":"module","engines":{"node":">=22"},"exports":{".":{"types":"./dist/index.d.ts","import":"./dist/index.js"}},"gitHead":"50927e2e1130361e72262dd98e1d1e73b17a9d61","scripts":{"lint":"eslint src tests","test":"vitest run","build":"tsup","typecheck":"tsc --noEmit","test:coverage":"vitest run --coverage","generate-types":"openapi-typescript ../../spec/openapi.build.json -o src/types.gen.ts"},"_npmUser":{"name":"julianat","email":"julianat@animocabrands.com"},"_npmVersion":"11.12.1","description":"TypeScript client for Minds by Animoca Brands Builder API","directories":{},"_nodeVersion":"24.15.0","_hasShrinkwrap":false,"devDependencies":{"tsup":"^8.3.5","vitest":"^2.1.8","@types/node":"^22.10.2","openapi-typescript":"^7.6.1","@vitest/coverage-v8":"2.1.9"},"_npmOperationalInternal":{"tmp":"tmp/minds-client-lib_0.1.5_1789528835239_0.913271930265505","host":"s3://npm-registry-packages-npm-production"}},"0.1.6":{"name":"@animocabrands/minds-client-lib","version":"0.1.6","license":"UNLICENSED","_id":"@animocabrands/minds-client-lib@0.1.6","maintainers":[{"name":"daniel_animoca","email":"daniell@animocabrands.com"},{"name":"julianat","email":"julianat@animocabrands.com"},{"name":"michaelg92","email":"michaelg@animocabrands.com"},{"name":"ab1-npmjs","email":"npmjs@animocabrands.com"},{"name":"jackyyab1","email":"jackyy@animocabrands.com"},{"name":"andysob","email":"andys@animocabrands.com"}],"dist":{"shasum":"8ad67f86628527640c8d91b9dc44250290d1627d","tarball":"https://registry.npmjs.org/@animocabrands/minds-client-lib/-/minds-client-lib-0.1.6.tgz","fileCount":5,"integrity":"sha512-NXC2N68a/TeczNG542MK3WfAaSk+cRU8m5sStcJBXzI8+2+0x85iyBQSBG6TLnQ9zgvPimeml89oB3cAQYk+Mw==","signatures":[{"sig":"MEUCIEVvl7xGkFaPHpqpg9lHBDPk/vzC4EaZJCN6iWD8g+nPAiEAuFYqeHqxrlVCC6qqybhIKHWAPZV8Ix/XIkbDdmgO2u4=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"},{"sig":"MEYCIQDK9TkEu43VQpXCIjogJRUAMHcrYlpC7e0fAToDY4jxswIhAMS0Fi9OLupGdbe8mvzLVl0L48EInBjtgWme3gzdaMn3","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":130544},"type":"module","engines":{"node":">=22"},"exports":{".":{"types":"./dist/index.d.ts","import":"./dist/index.js"}},"gitHead":"6c8da44848a11942ade021eff00cdcea21a29d04","scripts":{"lint":"eslint src tests","test":"vitest run","build":"tsup","typecheck":"tsc --noEmit","test:coverage":"vitest run --coverage","generate-types":"openapi-typescript ../../spec/openapi.build.json -o src/types.gen.ts"},"_npmUser":{"name":"julianat","email":"julianat@animocabrands.com"},"deprecated":"this package has been deprecated","_npmVersion":"11.12.1","description":"TypeScript client for Minds by Animoca Brands Builder API","directories":{},"_nodeVersion":"24.15.0","_hasShrinkwrap":false,"devDependencies":{"tsup":"^8.3.5","vitest":"^2.1.8","@types/node":"^22.10.2","openapi-typescript":"^7.6.1","@vitest/coverage-v8":"2.1.9"},"_npmOperationalInternal":{"tmp":"tmp/minds-client-lib_0.1.6_1790147633594_0.33680341863644014","host":"s3://npm-registry-packages-npm-production"}},"0.1.7":{"_id":"@animocabrands/minds-client-lib@0.1.7","dist":{"shasum":"af73f6905d2683ff5ac4bd7449e94a347732dfc2","tarball":"https://registry.npmjs.org/@animocabrands/minds-client-lib/-/minds-client-lib-0.1.7.tgz","fileCount":5,"integrity":"sha512-ryinJ2kcY/A+o0KNHuBo/sI5FpWu8xVc39XJXa//VMttyoC27CDS5GUcN29INE+rUoT0xNHp9d1acoHn9+y0bA==","signatures":[{"sig":"MEYCIQDEWF8woh8zzlB2Sc01WryUK9tacJnsY41uoTsjQarumAIhAPynAO/xVIE2uJNPsgD+KIfry7rg/6hpXCTQyCZQEvZq","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"},{"keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U","sig":"MEQCIGN7eOWahLvf5vvGfjqC1Cxr9gyjn481bqboCKQQPC2xAiBQ2SpdRGQpYkG/Hl2qyl/MCB6EnMlMhssR8XvpU9mnDQ=="}],"unpackedSize":130520},"name":"@animocabrands/minds-client-lib","type":"module","engines":{"node":">=22"},"exports":{".":{"types":"./dist/index.d.ts","import":"./dist/index.js"}},"gitHead":"6c8da44848a11942ade021eff00cdcea21a29d04","license":"UNLICENSED","scripts":{"lint":"eslint src tests","test":"vitest run","build":"tsup","typecheck":"tsc --noEmit","test:coverage":"vitest run --coverage","generate-types":"openapi-typescript ../../spec/openapi.build.json -o src/types.gen.ts"},"version":"0.1.7","_npmUser":{"name":"julianat","email":"julianat@animocabrands.com"},"_npmVersion":"11.12.1","description":"TypeScript client for Minds by Animoca Brands Builder API","directories":{},"maintainers":[{"name":"daniel_animoca","email":"daniell@animocabrands.com"},{"name":"julianat","email":"julianat@animocabrands.com"},{"name":"michaelg92","email":"michaelg@animocabrands.com"},{"name":"ab1-npmjs","email":"npmjs@animocabrands.com"},{"name":"jackyyab1","email":"jackyy@animocabrands.com"},{"name":"andysob","email":"andys@animocabrands.com"}],"_nodeVersion":"24.15.0","_hasShrinkwrap":false,"devDependencies":{"tsup":"^8.3.5","vitest":"^2.1.8","@types/node":"^22.10.2","openapi-typescript":"^7.6.1","@vitest/coverage-v8":"2.1.9"},"_npmOperationalInternal":{"host":"s3://npm-registry-packages-npm-production","tmp":"tmp/minds-client-lib_0.1.7_1790155215741_0.9003436261122657"}}},"time":{"created":"2026-06-09T09:48:28.251Z","modified":"2026-09-23T09:20:17.511Z","0.1.0":"2026-06-09T09:48:28.570Z","0.1.1":"2026-06-25T17:23:40.073Z","0.1.2":"2026-06-30T08:59:17.011Z","0.1.3":"2026-07-21T09:15:22.353Z","0.1.4":"2026-08-25T09:43:36.658Z","0.1.5":"2026-09-16T03:20:35.329Z","0.1.6":"2026-09-23T07:13:53.683Z","0.1.7":"2026-09-23T09:20:15.825Z"},"license":"UNLICENSED","description":"TypeScript client for Minds by Animoca Brands Builder API","maintainers":[{"name":"daniel_animoca","email":"daniell@animocabrands.com"},{"name":"julianat","email":"julianat@animocabrands.com"},{"name":"michaelg92","email":"michaelg@animocabrands.com"},{"name":"ab1-npmjs","email":"npmjs@animocabrands.com"},{"name":"jackyyab1","email":"jackyy@animocabrands.com"},{"name":"andysob","email":"andys@animocabrands.com"}],"readme":"# @animocabrands/minds-client-lib\n\nTypeScript client library for the **Hello Minds Builder API** ([api.build](https://api.build.hellominds.ai)) — messaging, account automation, and builder operations for programmatic agents and apps.\n\n**Get started:** [Minds Client Library guide](https://build.hellominds.ai/docs/get-started/client-library) on build.hellominds.ai\n\n**Requirements:** Node.js ≥ 22 (ESM) for Node apps. Connect also uses this\nlibrary in the browser.\n\n## Install\n\n```bash\nnpm install @animocabrands/minds-client-lib\n```\n\n## Authentication\n\nAccount and messaging routes need an **OAuth access token** or a **Builder API key**. When both are set, the access token wins (`Authorization: Bearer`). Otherwise the client sends `X-Api-Key`. Call `setAccessToken(null)` (or a blank string) to clear the token and fall back to the key. Pass `getAccessToken` to supply a fresh Bearer before each authed HTTP/SSE request (wins over a static `accessToken` for that request).\n\nCreate a Builder API key at [build.hellominds.ai/console](https://build.hellominds.ai/console). The library does **not** load `.env` — your app or the `minds` CLI handles that.\n\nOAuth apps can use this client in either place:\n\n- **Browser** — [`@animocabrands/minds-connect`](../connect) passes `getAccessToken` so each request refreshes via the session store (`oauth.client`).\n- **Backend** — after Connect login, send the access token as `Authorization: Bearer` on your API and pass it into `createMindsClient({ accessToken })`.\n\n**Bazaar catalog** (`client.bazaar.*`) is public — no credential required. Omit both for catalog-only use, or pass a token/key when you want auth headers sent on bazaar requests (e.g. future protected metadata).\n\n```ts\nimport { BUILDER_API_KEY_ENV, createMindsClient } from \"@animocabrands/minds-client-lib\";\n\nconst builderApiKey = process.env[BUILDER_API_KEY_ENV];\nif (!builderApiKey) throw new Error(`${BUILDER_API_KEY_ENV} is not set`);\n\nconst client = createMindsClient({ builderApiKey });\n// or: createMindsClient({ accessToken }); then client.setAccessToken(nextToken)\n```\n\n| Constant                 | Value                   |\n| ------------------------ | ----------------------- |\n| `BUILDER_API_KEY_ENV`    | `MINDS_BUILDER_API_KEY` |\n| `BUILDER_API_KEY_HEADER` | `X-Api-Key`             |\n\nThe api.build host is fixed in the library — builders cannot configure a base URL.\n\n## Quick start — messaging\n\n```ts\nimport { createMindsClient } from \"@animocabrands/minds-client-lib\";\n\nconst client = createMindsClient({ builderApiKey: process.env.MINDS_BUILDER_API_KEY! });\n\n// List Minds on your account (mindId + name)\nconst minds = await client.listMinds();\n\n// Ensure a conversation, then send\nawait client.ensureConversation(\"main\", minds[0]!.mindId);\nawait client.sendMessage({ alias: \"main\", messageText: \"Hello\" });\n\n// Wait for a Mind reply (SSE + history poll)\nconst outcome = await client.waitForReply({\n  alias: \"main\",\n  timeoutMs: 120_000,\n});\nif (!outcome.timedOut) {\n  console.log(outcome.reply.messageText);\n}\n```\n\n## API reference\n\nAll methods require an access token or Builder API key unless noted. Errors throw `MindsApiError` with `status`, `code`, and `message`.\n\n### Account & Minds\n\n| Method                   | Description                                                                                                                               |\n| ------------------------ | ----------------------------------------------------------------------------------------------------------------------------------------- |\n| `listMinds(opts?)`       | List Minds on the builder account. `humanId` defaults from the access token `sub` or the key JWT (`parseHumanIdFromAccessToken` / `parseHumanIdFromBuilderApiKey`). |\n| `getMind(mindId)`        | Full Mind details (`walletAddress`, `chain`, `email`, …).                                                                                |\n| `checkMindName(name)`    | Public name availability (`{ isAvailable }`). Key optional.                                                                               |\n| `awakenMind({ name, id })` | Create a Mind. `id` is a string slug (`POST /v1/minds/awaken`), not a closed enum — see [API reference](https://build.hellominds.ai/docs/api). |\n\nThe package does **not** export an archetype catalog. See [the API reference](https://build.hellominds.ai/docs/api). The example is a sales Mind named J-Belfort. Sell me this pen.\n\n```ts\nconst check = await client.checkMindName(\"J-Belfort\");\nif (!check.isAvailable) throw new Error(\"name taken\");\n\nconst mind = await client.awakenMind({ name: \"J-Belfort\", id: \"sales\" });\nawait client.ensureConversation(\"main\", mind.mindId);\n```\n\n### Messaging\n\n| Method                               | Description                                                                                                               |\n| ------------------------------------ | ------------------------------------------------------------------------------------------------------------------------- |\n| `createConversation(body)`           | Create conversation `{ alias, mindId }`.                                                                                  |\n| `ensureConversation(alias, mindId)`  | Create or return existing (handles 409).                                                                                  |\n| `listConversations()`                | List all conversations.                                                                                                   |\n| `getConversation(alias)`             | Get one conversation.                                                                                                     |\n| `sendMessage(body)`                  | Send `{ alias, messageText, attachments? }`.                                                                              |\n| `getHistory(alias, opts?)`           | Newest-first transcript. `cursor` (deprecated `after`) is sent as wire `before`. Rows use `senderType` (0 Mind, 1 human). |\n| `getLatestHistoryFingerprint(alias)` | Convenience for reply detection.                                                                                          |\n| `getMindIdForAlias(alias)`           | Resolve mindId from conversation or Mind history rows.                                                                    |\n\n### Events (SSE)\n\n| Method                                                                             | Description                                                                          |\n| ---------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------ |\n| `subscribeEvents({ alias?, onEvent, onError?, signal? })`                          | Callback-based SSE subscription.                                                     |\n| `eventsIterator({ alias?, signal? })`                                              | Async generator over SSE events.                                                     |\n| `waitForReply({ alias, timeoutMs, afterFingerprint?, sentMessageText?, signal? })` | Wait for a Mind reply; returns `{ reply, timedOut: false }` or `{ timedOut: true }`. |\n\nUse `isReplyEvent(event, context)` to detect Mind replies in custom SSE handling.\n\n### Cognition balance & usage\n\n| Method                                   | Description                                                             |\n| ---------------------------------------- | ----------------------------------------------------------------------- |\n| `getCognitionUsage(mindId, opts?)`       | Spend over time. `interval`: `1m`, `5m`, `15m`, `1h`, `1d`, `1w`, `1M`. |\n| `getCognitionUsageByTool(mindId, opts?)` | Breakdown by tool. `interval`: `hour`, `day`, `week`, `month` only.     |\n| `getCognitionBalance(mindId)`            | Cognition balance available for the Mind (`{ mindId, cognition }`).     |\n\n### Mind status\n\n| Method                                    | Description                           |\n| ----------------------------------------- | ------------------------------------- |\n| `updateMindStatus(mindId, { isEnabled, isListed? })` | Enable/disable a Mind (optional `isListed`). Returns `{ msg, result }` — not a Mind; call `getMind` if you need the updated record. |\n\n### Equipped skills & apps\n\nDiscover catalog IDs via `client.bazaar`, then equip on a Mind. Body is always `{ ids: string[] }` (UUIDs).\n\n| Method                           | Description                                 |\n| -------------------------------- | ------------------------------------------- |\n| `listEquippedSkills(mindId)`     | Skills currently equipped on the Mind.      |\n| `equipSkills(mindId, { ids })`   | Equip skills. Returns `{ results: [...] }`. |\n| `unequipSkills(mindId, { ids })` | Unequip skills.                             |\n| `listEquippedApps(mindId)`       | Apps currently equipped on the Mind.        |\n| `equipApps(mindId, { ids })`     | Equip apps.                                 |\n| `unequipApps(mindId, { ids })`   | Unequip apps.                               |\n\n### Circles\n\n| Method                                            | Description                                                                      |\n| ------------------------------------------------- | -------------------------------------------------------------------------------- |\n| `getCircle(mindId)`                               | Member array (`CircleMember[]`) — steward, humans, and other Minds.              |\n| `addCircleMembers(mindId, { emails, isActive? })` | Add by email (humans or Minds). Returns `CircleMutationResult`. |\n| `removeCircleMembers(mindId, { emails })`         | Remove by email.                                                                 |\n| `listCirclesForAccount(opts?)`                    | `listMinds()` + parallel `getCircle()` per Mind.                                 |\n\nHuman emails can be any address. Mind emails end in `@hellominds.ai`. Confirm with `getCircle()`.\n\n### Bazaar (public catalog)\n\nNo Builder API key required. Access via `client.bazaar` on any `MindsClient` (including `createMindsClient({})`).\n\n| Method                              | Description                                         |\n| ----------------------------------- | --------------------------------------------------- |\n| `bazaar.listSkills(opts?)`          | Search/list skills (`search`, `page`, `pageSize`).  |\n| `bazaar.getSkill(skillId)`          | Skill detail.                                       |\n| `bazaar.listApps(opts?)`            | Search/list apps (`search`, `tier`, pagination).    |\n| `bazaar.getApp(appId)`              | App detail (includes `tools[]`).                    |\n| `bazaar.collectSearchResults(opts)` | Auto-paginate, sort, filter, slice (CLI uses this). |\n\n```ts\nconst client = createMindsClient();\nconst apps = await client.bazaar.listApps({ search: \"notion\", tier: \"verified\" });\n```\n\n## Types\n\nExported types include `BuilderMind`, `CheckMindNameResult`, `AwakenMindResult`, `BazaarSkill`, `BazaarApp`, `EquippedSkill`, `EquippedApp`, `EquipIdsBody`, `Conversation`, `MessageRecord`, `MessagingEvent`, `CognitionBalance`, `CognitionUsageResponse`, `CognitionUsageByToolResponse`, `CircleMember`, `CircleMutationResult`, `AccountCircle`, and option/body types for each method.\n\n`MessageRecord` / SSE events expose **`senderType`** (0 = Mind, 1 = human).\n\n## CLI alternative\n\nPrefer a shell workflow? Use [@animocabrands/minds-cli](https://www.npmjs.com/package/@animocabrands/minds-cli) — same api.build surface with JSON stdout, exit codes, and `--help` examples on every command.\n\n```bash\nnpx @animocabrands/minds-cli@latest doctor\nnpx @animocabrands/minds-cli@latest list\n```\n\n## License\n\nUNLICENSED — private alpha tooling.\n","readmeFilename":"README.md"}