import asyncio
from getpatter import Patter, Twilio, ElevenLabsConvAI

phone = Patter(carrier=Twilio(), phone_number="+15550001234")    # TWILIO_* from env

agent = phone.agent(
    engine=ElevenLabsConvAI(agent_id="agent_abc123"),            # ELEVENLABS_API_KEY from env
    system_prompt="You are a warm and friendly concierge.",      # used as override
)

asyncio.run(phone.serve(agent))

// npx tsx example.ts
import { Patter, Twilio, ElevenLabsConvAI } from "getpatter";

const phone = new Patter({ carrier: new Twilio(), phoneNumber: "+15550001234" });

const agent = phone.agent({
  engine: new ElevenLabsConvAI({ agentId: "agent_abc123" }),
  systemPrompt: "You are a warm and friendly concierge.",
});

await phone.serve({ agent });

from getpatter.providers.elevenlabs_convai import ElevenLabsConvAIAdapter

# Twilio-native μ-law @ 8 kHz — skips every transcoding hop.
adapter = ElevenLabsConvAIAdapter.for_twilio(
    api_key="...",
    agent_id="agent_abc123",
    voice_id="EXAVITQu4vr4xnSDxMaL",
    model_id="eleven_flash_v2_5",
    language="it",
    first_message="Ciao!",
)

# Telnyx — same μ-law optimisation when streaming_bidirectional_codec=PCMU.
adapter = ElevenLabsConvAIAdapter.for_telnyx(api_key="...", agent_id="agent_abc123")

# Or the bare constructor (defaults to PCM16 16 kHz — best for non-telephony).
adapter = ElevenLabsConvAIAdapter(api_key="...", agent_id="agent_abc123")

import { ElevenLabsConvAIAdapter } from "getpatter";

const adapter = ElevenLabsConvAIAdapter.forTwilio("API_KEY", "agent_abc123", {
  voiceId: "EXAVITQu4vr4xnSDxMaL",
  modelId: "eleven_flash_v2_5",
  language: "it",
  firstMessage: "Ciao!",
});

const adapterTelnyx = ElevenLabsConvAIAdapter.forTelnyx("API_KEY", "agent_abc123");

// Bare constructor — defaults to PCM16 16 kHz.
const adapterBare = new ElevenLabsConvAIAdapter({
  apiKey: "API_KEY",
  agentId: "agent_abc123",
});