Handoffs

const billing = await Agent.create({
  apiKey, model,
  name: "billing-agent",
  systemPrompt: "You handle billing questions.",
});

const router = await Agent.create({
  apiKey, model,
  name: "router",
  systemPrompt: "Triage. Transfer to billing-agent if the user mentions invoice or charge.",
  handoffs: [billing], // synthesized tool: transfer_to_billing-agent
});

await (await router.send("I was charged twice this month")).wait();
// Router calls transfer_to_billing-agent → billing handles the rest.

import { Handoff } from "@theokit/sdk";
import { z } from "zod";

const handoff = Handoff.create(billing, {
  toolName: "escalate_to_billing",
  inputType: z.object({ reason: z.string() }),
  onHandoff: async (input) => console.log("[handoff]", input.reason),
  inputFilter: (history) => history.slice(-5), // only last 5 messages
});