Skip to content

AgentPay SDK v0.5.0

Latest

Choose a tag to compare

@github-actions github-actions released this 08 Jun 08:29
aa30cc6

Release date: 2026-06-07
Current version: v0.5.0

These notes cover what is new in AgentPay SDK v0.5.0.

Release summary

AgentPay SDK v0.5.0 adds a Fiat payment path through Stripe Link. Users can now bind a Link account during install or later with agentpay link onboard, approve each agent purchase in Link, and let the agent receive one-time card credentials only after that approval. The existing Crypto wallet path remains available through agentpay admin setup.

What's new in v0.5.0

Fiat payment setup with Link

  • added agentpay link onboard to bind the user's Link account using the bundled Stripe Link CLI
  • added agentpay link status --json to check whether the local Link auth state is reusable
  • added agentpay link payment-methods --json to list saved Link payment methods after onboarding
  • added agentpay link card to create a Link spend request, request user approval in Link, poll for approval, and write one-time card credentials to a private local file

Installer payment choice

  • added an install-time payment setup choice: Fiat with Link, Crypto with the local wallet, or later
  • added AGENTPAY_SETUP_PAYMENT_METHOD=fiat, crypto, or none for non-interactive installers
  • preserved AGENTPAY_SETUP_RUN_ADMIN_SETUP=yes as a legacy alias for the Crypto wallet setup path
  • kept skills-only installs separate from payment setup so third-party agents can install adapters without configuring a wallet or Link account immediately

Third-party agent integration

  • added the @worldlibertyfinancial/agentpay-sdk/link subpath export for programmatic Link integration
  • exposed helper functions for onboarding, status checks, payment-method listing, Link CLI passthrough, and approved card creation
  • bundled @stripe/link-cli so third-party agents do not need a separate Link CLI installation
  • added agentpay link install --json to show the available CLI, SDK, and MCP entrypoints for integrators

Skill and documentation updates

  • updated the AgentPay skill pack and adapters for Codex, Claude, Gemini, Cline, Copilot, Cursor, and OpenAI-style skill manifests
  • documented the Fiat Link flow separately from the Crypto wallet flow
  • documented the developer tarball distribution path for third-party agents using @worldlibertyfinancial/agentpay-sdk/link
  • added explicit secure-handling guidance: never paste Link tokens, card numbers, CVCs, or full card credential files into chat or logs
  • documented the distribution boundary for package consumers: ship a built package or installer bundle so @worldlibertyfinancial/agentpay-sdk/link resolves to dist/link.cjs

Compatibility and operational notes

  • Link Fiat payments require user approval in Link before card credentials are retrieved.
  • Full card credentials are written to a local file and should be handled as secrets.
  • The Crypto wallet path is unchanged and remains available through agentpay admin setup.
  • Source installs must run npm run build before consumers import @worldlibertyfinancial/agentpay-sdk/link.

Documentation

For command usage and operator workflows, see:

  • README.md
  • agentpay --help
  • agentpay link --help
  • agentpay link onboard --help
  • agentpay link card --help