LuaVoice

import { defineVoice, User, Data } from 'lua-cli';

export default defineVoice({
  name: 'support-line',
  description: 'Inbound support line',
  llm: 'openai/gpt-5.2-chat-latest',
  stt: 'deepgram/nova-3',
  tts: { model: 'cartesia/sonic-3', voice: '9626c31c-bec5-4cca-baa8-f8ba9e84c8bc' },
  greeting: 'Thanks for calling Acme support. How can I help?',
  sttLanguage: 'en',
  turnDetection: 'vad',
  excludeTools: ['sendPayment', 'sendListItems'],
  async onEnter(ctx) {
    if (ctx.caller?.phoneNumber) {
      const user = await User.get({ phone: ctx.caller.phoneNumber });
      ctx.session.userdata = { returning: user !== null };
    }
  },
  async onUserTurnCompleted(turnCtx, message) {
    const docs = await Data.search('kb', message.content, 3);
    for (const doc of docs) turnCtx.addMessage({ role: 'system', content: String(doc.data.text) });
  },
  async onExit(ctx) {
    await Data.create('call-log', { sessionId: ctx.sessionId, seconds: ctx.duration ?? 0 });
  },
});

import { defineVoice } from 'lua-cli';
// Plugin class forms come from the lua-cli/voice subpath; this is the one
// allowed import besides 'lua-cli' and 'zod' (voice pages only).
import { deepgram, elevenlabs } from 'lua-cli/voice';

export default defineVoice({
  name: 'support-line-plugin',
  llm: 'openai/gpt-5.2-chat-latest',
  stt: new deepgram.STT({ model: 'nova-3', smartFormat: true }),
  tts: new elevenlabs.TTS({ voiceId: 'pwMBn0SsmN1220Aorv15', model: 'eleven_flash_v2_5' }),
});

import { defineVoice } from 'lua-cli';
import { openai } from 'lua-cli/voice';

// @ts-expect-error stt and tts are typed as required in 3.33.0; the compiler accepts their omission for a realtime llm
export default defineVoice({
  name: 'realtime-line',
  llm: new openai.realtime.RealtimeModel({ model: 'gpt-realtime-mini', voice: 'alloy' }),
});

import { LuaVoiceTool, ToolFlag } from 'lua-cli';
import { z } from 'zod';

export const endCall = new LuaVoiceTool({
  name: 'end_call',
  description: 'Hang up once the caller confirms they are done',
  inputSchema: z.object({}),
  flags: [ToolFlag.DISALLOW_INTERRUPTION],
  async execute(_input, ctx) {
    await ctx?.voice?.endCall?.({ announce: 'Thanks for calling. Goodbye.' });
    return { ended: true };
  },
});

export const toBilling = new LuaVoiceTool({
  name: 'transfer_to_billing',
  description: 'Hand the call to the billing voice',
  inputSchema: z.object({ reason: z.string() }),
  async execute(input, ctx) {
    await ctx?.voice?.handoff?.('billing-line', { context: { reason: input.reason } });
    return { handedOff: true };
  },
});

import { LuaAgent } from 'lua-cli';
import supportLine from './voices/SupportLine';

export default new LuaAgent({
  name: 'support-agent',
  persona: {
    base: 'You are the Acme support agent.',
    voice: 'Keep answers to two sentences. Spell out numbers.',
    text: 'Use short paragraphs and lists.',
  },
  voices: [supportLine],
});

import { runVoice, expectCalledTool, expectContainsMessage } from 'lua-cli/voice/test';
import supportLine from './SupportLine';

export async function firstTurn(): Promise<void> {
  const session = await runVoice(supportLine, {
    llm: [{ input: 'Where is order 123456?', toolCalls: [{ name: 'lookup_order', args: { orderId: '123456' } }] }],
    mockTools: { lookup_order: () => ({ status: 'shipped' }) },
    caller: { phoneNumber: '+15551234567' },
    channel: 'phone',
  });
  const result = await session.run('Where is order 123456?');
  expectCalledTool(result, 'lookup_order', { orderId: '123456' });
  expectContainsMessage(result, /shipped/);
  await session.close();
}