[u9g]

lk agent simulate audio can now run a scenarios file against a phone number instead of an agent:

lk agent simulate audio --scenarios scenarios.yaml --to-phone-number +14154176004 --from-phone-number +14128420792
lk agent simulate audio --scenarios scenarios.yaml --to-phone-number +14154176004 --from-phone-number +15105550199 --trunk ST_xxx

Each simulation calls --to-phone-number over SIP, and whoever answers is the agent under test. This tests a production telephony agent through its real number and SIP path, with no simulation code in the agent. Nothing is spawned locally, so, as with --agent-name, --scenarios is required.

Flag	Meaning
--to-phone-number	Number to call. Requires --from-phone-number.
--trunk	Outbound SIP trunk to call through. Without it, the call goes out from a LiveKit phone number. Requires --to-phone-number.
--from-phone-number	Caller number: a LiveKit phone number the project owns, or a number on --trunk. Always required, so every simulation call has a caller ID that belongs to whoever runs it.

The flags map one-to-one onto the new SimulationRun.Create.Request fields (sip_call_to, sip_trunk_id, sip_number), which match CreateSIPParticipantRequest. The flag names match lk sip participant create (--trunk, --from-phone-number, --to-phone-number; after #1083).

Depends on livekit/protocol#1858 (the request fields) and livekit/agents-private#549 (the simulation service that places the call). Release after #549 is deployed: an older server ignores the new fields and would dispatch an agent with an empty name instead of calling the number.

Commits

1. chore: bump protocol for the simulation run's SIP fields
2. feat(simulate): run audio simulations against a phone number with --to-phone-number
3. fix(simulate): reject --from-phone-number without --to-phone-number
4. refactor(simulate): name the SIP trunk flag --trunk

[u9g]

lk agent simulate audio --to-phone-number against staging, running this PR with livekit/agents-private#549: the same booking scenario calls an agent's real phone number twice, first from a LiveKit phone number (--from-phone-number), then through a Twilio Elastic SIP Trunk (--from-trunk). Both pass.

simulate-phone-number.mp4