Changelog

What shipped

New methods on createMindsClient({ builderApiKey }):

• getMind(mindId) — GET /v1/minds/{mindId} for full Mind detail (walletAddress, chain, …)
• getCognitionUsage, getCognitionUsageByTool — per-Mind cognition spend
• getCognitionBalance — per-Mind cognition balance
• updateMindStatus — enable or disable a Mind
• getCircle, addCircleMembers, removeCircleMembers, listCirclesForAccount — human collaborator circle management

client.bazaar namespace (public catalog — no API key required):

• listSkills, getSkill, listApps, getApp, collectSearchResults
• createMindsClient({}) is valid for Bazaar-only use; auth methods throw missing_builder_api_key at call time if no key was provided

Auth and types:

• Authenticated routes send X-Api-Key only — X-Access-Key is deprecated (not sent by the client library)
• BuilderMind and CognitionBalance exported for TypeScript consumers

Notes

• getCognitionUsage and getCognitionUsageByTool take different interval enums — 1m/5m/15m/1h/1d/1w/1M vs hour/day/week/month.
• Circles accept human collaborator emails only; mind-to-mind circle membership is not supported via this API.
• getCircle returns a CircleMember[] array; addCircleMembers and removeCircleMembers return a { items, summary } mutation envelope.
• Bazaar: skills use skillId; apps use appId and appName (not name). Equip HTTP APIs are not on api.build yet.

Get started in the client library guide .

What shipped

New and updated public routes:

• GET /v1/minds/{mindId} — full Mind detail (email, wallet addresses, chains, species, isEnabled, …)
• GET /v1/minds/{mindId}/cognition/usage — cognition usage over time
• GET /v1/minds/{mindId}/cognition/usage-by-tool — per-tool cognition usage
• GET /v1/minds/{mindId}/credits — per-Mind cognition balance
• PATCH /v1/minds/{mindId} — enable or disable a Mind (isEnabled only)
• GET / POST / DELETE /v1/circles/{mindId} — list, add, or remove human collaborators on a Mind's circle
• GET /v1/bazaar/skills, GET /v1/bazaar/skills/{skillId}, GET /v1/bazaar/apps, GET /v1/bazaar/apps/{appId} — public Bazaar catalog (no API key)

Authenticated routes use a Builder API key. X-Api-Key is the canonical header in the API reference and in client-lib ≥0.1.2. X-Access-Key is deprecated.

Notes

• cognition/usage and cognition/usage-by-tool take different interval enums — 1m/5m/15m/1h/1d/1w/1M vs hour/day/week/month. See the param descriptions in the API reference .
• GET /v1/circles/{mindId} returns a CircleMember[] array; POST and DELETE return a { items, summary } mutation envelope.
• Circles accept human collaborator emails only; mind-to-mind circle membership is not supported via this API.
• Bazaar routes are public — wrapped in client-lib as client.bazaar.* and CLI minds bazaar. Equip APIs are not on api.build yet.

The API reference documents the public contract — Builder API key auth on protected routes, Bazaar routes public, with examples aligned to the live API.

What shipped

• Global install: npm install -g @animocabrands/minds-cli
• One-off runs: npx @animocabrands/minds-cli@latest (no minds prefix on the package name)
• Agent-friendly JSON stdout, stable exit codes, and --help examples on every command
• minds list, minds chat create, minds send --wait, and minds events over your Builder API key
• minds doctor for key, connectivity, and version checks

Get started in the Minds CLI guide .

What shipped

• Install: npm install @animocabrands/minds-client-lib
• createMindsClient({ builderApiKey }) for Node — list Minds, conversations, messaging, history, and SSE events
• waitForReply for send-and-wait flows in application code
• isReplyEvent and history helpers when you filter replies yourself

Get started in the client library guide .