SDK Overview

import { Naive } from "@usenaive-sdk/server";
const naive = new Naive({ apiKey: process.env.NAIVE_SECRET_KEY! });

// Provision a governed agent profile per tenant, then pull its tools / revoke it.
const op = await naive.forUser(tenant.id).provision("sdr", { idempotencyKey: `op:${tenant.id}` });
const tools = await op.tools();
// await op.revoke();

import { createClient } from "@usenaive-sdk/server";
import config from "./naive.config.js";

const naive = createClient<typeof config>({ apiKey: process.env.NAIVE_SECRET_KEY! });

naive.cards;                          // every legacy sub-client is still here
naive.teams.support;                  // typed team names — a typo is a compile error
naive.brain;                          // the company's DEFAULT brain
naive.brains;                         // the collection it belongs to — list, create, connect
naive.legacy;                         // the frozen orchestration surface, born deprecated

await naive.cards.create({ name: "Ops", spending_limit_cents: 25000, provider: "managed_virtual" });
await naive.vault.put("instantly.api_key", "key_xyz");

const client = naive.forUser(alice.id);
await client.cards.create({ name: "Ops", spending_limit_cents: 25000, provider: "managed_virtual" });
await client.vault.put("instantly.api_key", "key_xyz");

const staging = await naive.projects.create({ name: "Staging" });
const project = naive.forProject(staging.id);

await project.accountKits.list();
const child = await project.childProjects.create({ external_id: "acme" });
await project.forChild(child.id).cards.create({ name: "Ops", spending_limit_cents: 25_000, provider: "managed_virtual" });

await naive.organization.get();   // /v1/organization, falling back to /v1/company

const op = await naive.forUser(tenant.id).provision("sdr", {
  idempotencyKey: `op:${tenant.id}`,          // retried webhook → same agent profile
  overrides: { identity: { legalName: tenant.company } },
});

op.status;                 // "provisioning" | "active" | "needs_action" | ...
const tools = await op.tools();   // governed toolset for your agent / LangGraph / your harness
await op.refresh();        // re-fetch status (provisioning is async)
await op.revoke();         // absolute: freeze card, halt sends, rotate, tear down