Skip to content

Sipral 1.2.1

Choose a tag to compare

@samybalasa samybalasa released this 19 Oct 06:47
· 174 commits to main since this release
5e364ed

A fix for subscriptions on Asterisk's chan_sip, one for messages read off TCP and TLS, every dependency and build tool at its newest release, and the lab's flows run against FreePBX, a VitalPBX tenant and a ViciBox.
At C ABI 1.2, unchanged: an application built on 1.0, 1.1 or 1.2.0 works unchanged.

Fixed

  • A NOTIFY that reuses the branch of the one before it is answered as its own request. Asterisk's chan_sip (VICIdial, older FreePBX) sends a subscription's NOTIFYs under one Via branch, and the stack took the second for a retransmission of the first and answered it with the first's 200 OK. chan_sip refused that answer and kept resending, so a message-waiting count, or anything else a subscription reports, never changed after its first NOTIFY. Every request but INVITE is now also matched on its CSeq number, which a retransmission repeats (docs/03-core-signalling.md). Found on a ViciBox, where message waiting now passes.
  • Where a TCP or TLS read ends no longer changes what the stack reads. The search for the blank line that ends a message's header fields stepped back three bytes to catch a blank line split between two reads, and after one message had been taken from a read, those three bytes were the end of that message. Its blank line, joined to a line feed at the start of what followed, could pass for the next message's, so a malformed head that arrived in the same read as the message before it was refused at once, where the same bytes in separate reads were held until their head ended. The search no longer steps back past the message it is looking for. Found by the framer fuzz target, whose input is now one of its seeds.
  • The voice-agent demo starts on the sipral wheel from PyPI. It asked for Opus first, and the sipral package is built without Opus, so the stack refused the codec order and the demo never answered; it now offers Opus only where the build has it. The demo runs from a checkout over pip install sipral websockets, with no native build.
  • The gate builds sipral-aec-webrtc with the abseil-cpp it names. On a machine where another package had installed abseil (Homebrew's Node.js 26 brings one), meson linked that copy rather than building the version its wrap pins, and the crate's licence list no longer matched what it was built from. scripts/check.sh now builds the crate with an empty pkg-config path, so meson always builds abseil-cpp from its own wrap.

Added

  • The lab's flows run against a FreePBX. scripts/lab.sh freepbx-live runs the lab's flows against the Asterisk under a FreePBX 16, on accounts and numbers interop/live/freepbx/install.sh adds beside FreePBX's own extensions, in the files FreePBX keeps for additions. On 16 October 2026 all thirteen passed on a FreePBX 17 (Asterisk 22, Debian 12), and all but DTLS-SRTP on a FreePBX 16 whose OpenSSL 1.0.2 predates the extended master secret, without which the stack does not key SRTP (docs/11-testing.md). The VitalPBX step also runs interop/live/pbx_features.py on four extensions of one tenant: both transfers, a SIP INFO digit and a MESSAGE passed there; message waiting did not, since that PBX sends it unsolicited.
  • The lab's flows run against the Asterisk inside a ViciBox. scripts/lab.sh vicidial-live first runs register, call, hold, both transfers, digits by RFC 4733 and SIP INFO, SDES, DTLS-SRTP, MESSAGE, G.729 (decoded there), message waiting on a message VoiceMail() records, and the compact form against VICIdial's own Asterisk 18 with chan_sip, on accounts and numbers interop/live/vicibox/install.sh puts on the box apart from the dialer's; all passed on 15 October 2026, message waiting once the fix above was in (docs/11-testing.md).
  • The lab runs MESSAGE through Kamailio and OpenSIPS and on FusionPBX, message waiting through both proxies and on FusionPBX, and digits both ways against baresip. Each proxy sends a MESSAGE to a user registered at it to that user's binding and anything else, with a SUBSCRIBE, to FreeSWITCH, which echoes 9006 from its chatplan and reports a message left on 9007 to the mailbox's subscription; FusionPBX echoes 9006 the same way. baresip has no dialplan, so interop/baresip/dtmf_echo.py sends back each digit it hears, by RFC 4733 and by SIP INFO. FusionPBX answers message-summary from its own MWI script, which it ships switched off and which stops at its first event as shipped (its configuration replaces Lua's debug library); the lab switches it on with debug.traceback kept (interop/fusionpbx/setup.sh).
  • The lab runs digits by SIP INFO, SDES and G.729 against FreeSWITCH and FusionPBX, and RFC 4733 digits through OpenSIPS. FreeSWITCH, behind Kamailio and behind OpenSIPS, and FusionPBX answer the numbers Asterisk answers for them (interop/freeswitch/lab.xml, interop/fusionpbx/lab_dialplan.xml), with the digit by INFO on 9013 since FreeSWITCH chooses the method per extension, and G.729 among the codecs their profiles accept. G.729 comes back as this end wrote it, as through Asterisk, and FreeSWITCH answers annexb=yes, so the call runs with Annex B on (docs/11-testing.md).

Changed

  • The .NET tests, samples and lab agents run on .NET 10. .NET 8 leaves Microsoft's support on 10 November 2026, so what this repository runs itself moves to net10.0 (net10.0-windows for the WPF sample) and the lab's containers to the .NET 10 SDK. The Sipral package itself stays on net8.0, the oldest runtime it supports, so an application on .NET 8, 9 or 10 takes it unchanged. The tests run on xunit v3, in its mtp-off variant: without the Microsoft Testing Platform and the telemetry client that platform brings in.
  • Dependencies and build tools at their newest releases. Rust 1.99.1 is the pinned toolchain, and the Docker images the packages and the lab build in name rust:1.99.1-trixie exactly, which the gate holds them to (the minimum supported Rust stays 1.95); sha2 0.11.1, zeroize 1.9.1 and the compatible releases beneath them; koffi 3.3.3 in the Node.js package; React Native 0.88.0, React 19.3.1 and Babel 8.0.7 for the React Native package's build and tests, whose react-native peer range is unchanged; Kotlin 2.4.21 for the JVM and Android builds and Gradle 9.8.1 for Android; the lab on Swift 6.4, Temurin 25, .NET 10 and a fresh Debian trixie image; fuzzing on the nightly of 17 October. Four stay where they are, each for a reason: rsa on 0.10.0-rc.19, since 0.10 has no release yet; getrandom on 0.2, which ring brings in; the React Native package's Android build on Gradle 9.4.1 and the Android Gradle Plugin 9.2.1, what React Native 0.88 itself builds with; and the Android command-line tools on 22.0.

Packages: PyPI sipral and sipral-opus, NuGet Sipral, Sipral.Opus and Sipral.Maui, Maven Central org.sipral (sipral, sipral-opus, sipral-jvm, sipral-jvm-opus), npm sipral and sipral-react-native, pub.dev sipral, crates.io sipral, and the Swift package from this repository with the XCFramework attached below.