Nonhumans Primitives: Ten Tools Every Agent Gets Instantly

import { Nonhumans } from "@nonhumans/sdk";

const nh = new Nonhumans({ apiKey: process.env.NONHUMANS_API_KEY });
const agent = await nh.agents.get("alice");

// Email — send a message and list the inbox
await agent.email.send({
  to: "vendor@example.com",
  subject: "Invoice received",
  body: "Thank you, we will process your invoice within 48 hours.",
});
const messages = await agent.email.list({ limit: 5 });

// Phone — send an SMS
await agent.phone.sms.send({
  to: "+1-555-9876",
  body: "Your order has shipped.",
});

// Wallet — check balance and send funds
const balance = await agent.wallet.balance();
console.log(`$${balance.fiat_usd} available`);
await agent.wallet.send({
  to: "vendor@example.com",
  amount: 49.99,
  currency: "usd",
});

// Compute — run a background job
await agent.compute.run({
  script: "scripts/nightly_report.ts",
  schedule: "0 2 * * *", // every day at 2 AM
});

// Models — call the LLM router
const reply = await agent.models.chat({
  messages: [{ role: "user", content: "Summarise this week's invoices." }],
});

// Memory — store and search
await agent.memory.store("last_report_date", new Date().toISOString());
const similar = await agent.memory.search("Q1 revenue figures");

// Vault — read and write secrets at runtime
await agent.vault.set("STRIPE_API_KEY", "sk_live_...");
const stripeKey = await agent.vault.get("STRIPE_API_KEY");

// Web — get the agent's public endpoint
console.log(agent.web.endpoint); // "https://alice.nonhumans.ai/api"