await phone.serve({
  agent,
  recording: true,
  onCallEnd: async (data) => {
    console.log("Recording available in your Twilio console");
  },
});

await phone.serve({ agent, localRecording: true });

// Or pass a directory string to choose where the WAVs go:
await phone.serve({ agent, localRecording: "/var/recordings" });

await phone.serve({
  agent,
  localRecording: true,
  onCallEnd: async (data) => {
    if (data.recording_path) {
      console.log(`Recording saved: ${data.recording_path}`);
    }
  },
});

await phone.call({
  to: "+15559876543",
  agent,
  machineDetection: true,
  voicemailMessage: "Hi, this is Acme Corp calling about your appointment tomorrow. Please call us back at 555-000-1234.",
});

User presses "1" → Agent receives: [DTMF: 1]
User presses "#" → Agent receives: [DTMF: #]

const agent = phone.agent({
  systemPrompt: `You are an IVR system. When the user presses:
- 1: Transfer to sales
- 2: Transfer to support
- 0: Transfer to operator
Respond to [DTMF: N] inputs accordingly.`,
});

const agent = phone.agent({
  systemPrompt: `You are a front desk assistant. If the caller wants to speak to a human, transfer them to +15559876543.`,
});

const agent = phone.agent({
  systemPrompt: "...",
  bargeInThresholdMs: 0, // Disable barge-in (exact interruption)
});

import { DeepgramSTT, AnthropicLLM, ElevenLabsTTS } from "getpatter";

const agent = phone.agent({
  stt: new DeepgramSTT(),
  llm: new AnthropicLLM(),
  tts: new ElevenLabsTTS({ voiceId: "rachel" }),
  systemPrompt: "You are a helpful assistant.",
  echoCancellation: true,
});

import { NlmsEchoCanceller } from "getpatter/audio/aec";

// 8 kHz callers benefit from a longer filter window
const aec = new NlmsEchoCanceller({ sampleRate: 8000, filterTaps: 1024 });

const agent = phone.agent({
  stt: deepgram(),
  llm: anthropic(),
  tts: elevenlabs({ voiceId: "rachel" }),
  systemPrompt: "You are a helpful assistant.",
  highPassHz: 100,   // strip DC / mains hum / rumble below 100 Hz
  agc: true,         // normalise caller level toward the target RMS
});

const agent = phone.agent({
  // ...
  agc: {
    targetRmsDbfs: -18,    // desired output level
    maxGainDb: 30,         // never amplify the noise floor by more than this
    speechFloorDbfs: -45,  // frames below this are treated as non-speech
    attackMs: 10,          // fast gain reduction when the talker gets loud
    releaseMs: 200,        // slow gain increase when the talker gets quiet
    limiterCeiling: 0.99,  // peak ceiling as a fraction of full scale
  },
});

const agent = phone.agent({
  stt: new DeepgramSTT(),
  llm: new AnthropicLLM(),
  tts: new ElevenLabsTTS({ voiceId: "rachel" }),
  systemPrompt: "You are a helpful assistant.",
  aggressiveFirstFlush: true,
});

const agent = phone.agent({
  systemPrompt: "...",  // shipped to the LLM verbatim
  disablePhonePreamble: true,
});

const agent = phone.agent({
  systemPrompt: "You are a support agent for {company}. The caller is {caller_name} with account {account_id}.",
  variables: {
    company: "Acme Corp",
    caller_name: "Default",
    account_id: "unknown",
  },
});

await phone.call({
  to: "+15559876543",
  agent,
  variables: {
    caller_name: "Jane Smith",
    account_id: "ACC-12345",
  },
});

{
  role: string;       // "user" or "assistant"
  text: string;       // Transcript text
  timestamp: number;  // Unix timestamp (ms)
}

const agent = phone.agent({
  systemPrompt: "You are a helpful assistant.",
  firstMessage: "Hi, this is an AI assistant from Acme Corp. How can I help you today?",
});

// Twilio
await phone.call({
  to: "+15559876543",
  agent,
});

// With AMD and voicemail
await phone.call({
  to: "+15559876543",
  agent,
  machineDetection: true,
  voicemailMessage: "Please call us back.",
});