Delphi v0.9.16-patch1
Delphi v0.9.16-patch1 improves media advertisement, speech processing and RTP observability. TelPro media advertisement is clearer for LB/NAT hosts, Azure STT turn races are quieter under load, and RTPEngine final-stat spans expose per-endpoint counters.
0.9.16-patch1Recorded SDK recommendation0.1.4Recorded SDK range>=0.1.3 <0.2.0Highlights
- Hangup header delivery — empty header values are kept and RFC-invalid header names are sanitized before BYE.
- TelPro media advertisement — bind vs SDP advertise addresses are separated for LB/NAT and HA floating-media hosts (
EXTERNAL_IP/TELPRO_MEDIA_IP). - STT/TTS turn hygiene — duplicate Azure STT
turn.endafter rotate is idempotent; TTS synthesis is tagged by reason for turn accounting.
Voice, SIP, and WebRTC
TelPro hosts derive the media address advertised in SDP from TELPRO_MEDIA_IP, then EXTERNAL_IP, then PUBLIC_IP. On LB/NAT hosts, RTPEngine binds privately and advertises the external address; direct-public hosts continue to bind and advertise the local public IP. Answer and late ACK-with-SDP paths set explicit RTPEngine direction pairs for outbound, inbound, and internal trunks.
TelAPI and SDK
The TelPhi SDK contract did not change in this patch. Keep 0.1.4 recommended; 0.1.3 remains supported for clients that do not need text chat or handoff APIs.
Observability and Operations
log-to-span now parses RTPEngine final-stat blocks into per-endpoint counters (packets/bytes in and out), with optional CIDR rtpEndpointRules to label remote roles (for example Asterisk vs carrier).
Operators
This patch has no database migrations. Redeploy the updated TelAPI, TelPhi, TelPro (with RTPEngine), Scaler, log-to-span, and TelWeb images/config before validating production traffic.
On LB/NAT TelPro hosts, set EXTERNAL_IP to the routable SIP/media address. For HA floating media, set TELPRO_MEDIA_IP when the advertised media IP differs from the SIP external address. Leave EXTERNAL_IP unset on direct-public hosts. See TelPro operations.
Upgrade checklist
- Deploy TelAPI, TelPhi, TelPro/RTPEngine, Scaler, log-to-span, and TelWeb on
v0.9.16-patch1(novoiceai-db-migratestep required for this patch alone). - Confirm TelPro
EXTERNAL_IP/TELPRO_MEDIA_IPfor each LB/NAT or HA media host, then place a test call and verify SDP media addresses. - Optionally configure
rtpEndpointRulesCIDRs in the TelPro log-to-span RTPEngine config so endpoint roles classify correctly in observability.
SDK compatibility
| Component | Version |
|---|---|
| Platform | v0.9.16-patch1 |
| Recommended TelPhi SDK | v0.1.4 |
| Supported SDK range | >=0.1.3 <0.2.0 |
No published SDK package update is required for this patch.