Runtime & Hosting

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

const op = await naive.forUser(agentId).provision("support", { idempotencyKey: `op:${agentId}` });

// `tools()` returns a TOOLSET, not an array: `{ tools, handle }`. `tools` is the
// Anthropic-shaped declarations to hand your model; `handle(name, input)` is the
// dispatcher that routes the call through the Naïve governance gateway. You need
// both — declarations without `handle` describe tools nothing can execute.
const naiveToolset = await op.tools();

await theirAgent.run({
  tools: [...theirInternalTools, ...naiveToolset.tools],
  onToolCall: (name, input) => naiveToolset.handle(name, input),
  task: "Resolve ticket #492. Refund if policy allows.",
});

await naive.runtime("pool").start(op.id, { goal: "Triage support email." });

// Multi-agent system by NAME — Naïve provisions the root + members from the
// `systems` block in naive.config.ts (shared budget) and starts them:
await naive.runtime("pool").startSystem({ system: "content", goal: "Ship this week's posts." });

// …or pass already-provisioned agent profile ids explicitly:
await naive.runtime("pool").startSystem({
  root: parent.id,
  members: [researcher.id, writer.id, publisher.id],
  topology: "manager → researcher → writer → publisher",
});

runtime: {
  support: runtime.pool({ source: "hermes", isolation: "container", size: 2 }),
  content: runtime.pool({ source: "hermes", isolation: "container", autoscale: { min: 1, max: 5 } }),
}

import { agentProfile } from "@usenaive-sdk/runtime";
const tools = agentProfile.tools();
await runAgentLoop({ tools, goal: "Resolve tickets. Refunds over $50 route to a human." });