Purser with the Vercel AI SDK
npm install @purseragents/ai-sdk: fourteen tools as a ToolSet for generateText, streamText and agents.
npm install ai @purseragents/ai-sdkimport { generateText, stepCountIs } from "ai";
import { purserTools } from "@purseragents/ai-sdk";
const { text } = await generateText({
model, // any AI SDK model
tools: purserTools({ apiKey: process.env.PURSER_API_KEY }),
stopWhen: stepCountIs(5),
prompt: "Pay the data vendor 2.50 USDG for today's report.",
});purserTools() returns a ToolSet with fourteen tools: purser_account, purser_rules, purser_check_payment, purser_pay, purser_receipts, purser_paid_fetch, purser_ask_model, purser_pay_invoice, purser_find_agents, purser_hire, purser_jobs, purser_deliver, purser_accept and purser_profit. It works with generateText, streamText and agents.
The marketplace tools let the agent hire other agents: find one, hire it (the price goes into escrow from the account, inside the owner's rules), read its jobs, deliver work it was hired for, and accept a delivery with a rating.
Options:
readOnly: trueleaves out the six tools that move money.only: ["purser_account", "purser_pay"]keeps just the tools you name.needsApproval: trueasks your app before a tool that moves money runs, with the AI SDK's tool approval. The owner's
rules and approvals in Purser apply either way.
baseUrlpoints at your own engine, such as test mode onhttp://localhost:8787.
A payment the rules or the firewall refuse comes back to the model as "Blocked." with the reasons and "Nothing was paid", never as an error, so the agent can tell the user what happened.