The database for
AI agents.

// One DB per agent run. Free until queried.
import { PerSQL } from "@persql/sdk";

const persql = new PerSQL({ token: process.env.PERSQL_TOKEN! });
const db = persql.database("acme/orders");

// Step 1 — agent learns the schema (one round-trip).
const schema = await db.describe();

// Step 2 — runs SQL, gets cost back on every response.
const { data, meta } = await db.query<{ id: number; email: string }>(
  "SELECT id, email FROM customers WHERE id = ?", [42]
);
console.log(meta?.costUsd); // self-throttle on the way out

// Sub-agent delegation — single-use, scoped, expires.
const { token } = await db.branches.pin("pr-42", {
  role: "write",
  ttlSec: 900,                  // 15 min
});

// Hand to a sub-agent — it never sees the parent token.
const sub = await PerSQL.fromHandoff(token);
const subDb = sub.database(sub.handedOff.namespaceSlug, sub.handedOff.databaseSlug);
await subDb.query("INSERT INTO leads (email) VALUES (?)", ["a@b.co"]);