defineAgent

import { defineAgent } from "@zavudev/functions"

defineAgent({
  senderId: process.env.SENDER_ID!,
  name: "Bella",
  provider: "zavu",
  model: "openai/gpt-4o-mini",
  prompt: "You are Bella, host of Bella Pizzeria…",
  channels: ["whatsapp"],
})

defineAgent({
  senderId: process.env.SENDER_ID!,
  name: "Fermi",
  provider: "zavu",
  model: "openai/gpt-4o-mini",     // text model
  channels: ["voice", "whatsapp"],
  voice: {
    enabled: true,
    model: "openai/gpt-4o",        // co-located voice model (optional; derived from `model` if omitted)
    greeting: "Hi, I'm Fermi. How can I help?",
    language: "en",                // BCP-47; auto-detected if omitted
    interruptible: true,           // caller can barge in
    maxCallDurationMinutes: 10,
  },
  prompt: `…`,
})

defineAgent({
  senderId: process.env.SENDER_ID!,
  name: "Ada",
  provider: "zavu",
  model: "openai/gpt-4o-mini",
  prompt: "Answer from the store policies. If they do not cover it, say so.",

  knowledgeBase: {
    name: "Store policies",
    documents: [
      {
        title: "Returns",
        content: `# Returns

Unopened items: 30 days, full refund.
Opened items: 14 days, only if faulty.
Not returnable: gift cards, final sale.`,
      },
      {
        title: "Shipping",
        content: `# Shipping

Free over $50, 3 to 5 business days.
Express is $12, next business day if ordered before 2pm.
US and Canada only. No PO boxes.`,
      },
    ],
  },
})

Knowledge synced:
  + Returns
  ~ Shipping (re-embedded)
  - Old holiday hours

npx zavudev agents test --sender "$SENDER_ID" --message "can I return an opened item?"

npx zavudev agents knowledge-bases create --sender "$SENDER_ID" --name "Manuals"
npx zavudev agents knowledge-bases documents add --sender "$SENDER_ID" --kb "$KB_ID" \
  --title "Manual" --content-file ./manual.md

import { defineAgent, defineTool, defineFlow } from "@zavudev/functions"

defineAgent({
  name: "Support",
  provider: "zavu",
  model: "openai/gpt-4o-mini",
  prompt: "Answer support questions. Be brief.",
})

defineTool({
  name: "create_ticket",
  description: "Open a support ticket.",
  parameters: {
    type: "object",
    properties: { email: { type: "string" }, issue: { type: "string" } },
    required: ["email", "issue"],
  },
  handler: async ({ email, issue }) => ({ id: "TCK-1", email, issue }),
})

defineFlow({
  name: "Repair intake",
  trigger: { type: "keyword", keywords: ["broken", "repair"] },
  steps: [
    {
      id: "ask_issue",
      type: "collect",
      config: { variable: "issue", prompt: "What is wrong with it?" },
      nextStepId: "ask_email",
    },
    {
      id: "ask_email",
      type: "collect",
      config: { variable: "email", prompt: "What is your email?", validation: { type: "email" } },
      nextStepId: "open",
    },
    {
      id: "open",
      type: "tool",
      config: {
        toolName: "create_ticket",
        params: { email: "{{email}}", issue: "{{issue}}" },
      },
      nextStepId: "done",
    },
    { id: "done", type: "message", config: { text: "Logged. We will email {{email}}." } },
  ],
})

npx zavudev agents flows update <flowId> --sender "$SENDER_ID" --data '{"enabled":true}'

defineAgent({
  ...,
  provider: "zavu",
  model: "openai/gpt-4o-mini",   // provider/model id, the gateway picks the right backend
})

defineAgent({
  ...,
  provider: "openai",
  model: "gpt-4o-mini",
  apiKey: process.env.OPENAI_API_KEY!,   // set via `npx zavudev fn secrets set`
})

prompt: `You are Bella, host of Bella Pizzeria.

Your job:
- Help guests view the menu and book reservations.
- ONLY use the tools provided — never invent prices or availability.
- Confirm every reservation by reading back the time and code before closing.

Tone:
- Friendly, brief (WhatsApp messages should fit one screen).
- Match the language the customer writes in.

Edge cases:
- If asked something outside your scope (delivery, jobs, complaints), say:
  "Para eso te paso con un humano." and stop responding.
`

defineAgent({
  ...,
  channels: ["whatsapp"],         // only WhatsApp, ignore SMS to the same sender
  messageTypes: ["text"],         // ignore images, audio, etc
})

// index.ts
import { formatOrder } from "./lib/orders"

defineTool({
  name: "order_status",
  handler: async ({ id }) => formatOrder(await lookup(id)),
})

// lib/orders.ts
export function formatOrder(order: Order) {
  return `${order.id} — ${order.status}`
}

my-agent/
├── index.ts          ← entrypoint, deployed
├── lib/orders.ts     ← imported, deployed
├── lib/orders.test.ts  ← nothing imports it, stays local
└── package.json      ← dependencies, not uploaded as a file

npx zavudev fn git link acme/my-agent --branch main

defineAgent({ senderId: process.env.SENDER_A!, name: "Sales",   ...  })
defineAgent({ senderId: process.env.SENDER_B!, name: "Support", ...  })

defineTool({
  name: "lookup_order",
  agent: "Support",                // explicit binding
  description: "...",
  parameters: { ... },
  handler: async (args) => { ... },
})

defineAgent({
  ...,
  enabled: false,
})