0833173ed6
Some checks failed
wai-app and Create / wai-app · does this change touch it (push) Successful in 17s
joule-moq-web browser client / joule-moq-web · does this change touch it (push) Successful in 16s
joule-moq-room room service / joule-moq-room · does this change touch it (push) Successful in 36s
joule-moq-remote host agent / joule-moq-remote · does this change touch it (push) Successful in 39s
wai-audit collector and player integration / does this change touch it (push) Successful in 21s
WAI operation catalogue / does this change touch it (push) Successful in 21s
wai-ledger service / does this change touch it (push) Successful in 19s
wai-fleet service / does this change touch it (push) Successful in 20s
wai-quantum studio and desktop / does this change touch it (push) Successful in 21s
wai-quantum for JavaScript / does this change touch it (push) Successful in 22s
wai-sink-swift native sink package / does this change touch it (push) Successful in 21s
wai-sink-android native sink library / does this change touch it (push) Successful in 20s
WAI Studio / does this change touch it (push) Successful in 24s
repository checks / lockfiles, advisories, tests in CI, workflow hygiene, spec and section references, public text (push) Has been cancelled
WAI operation catalogue / the catalogue and every door · linux (push) Has been cancelled
wai-sink-android native sink library / the JNI layer and the platform-free half on the host JVM · linux-arm64 (push) Has been cancelled
wai-sink-android native sink library / every ABI, the AAR, and the instrumented tests in a headless emulator · macos (push) Has been cancelled
joule-code conformance gate / joule-moq-relay, its own energy on a counter (macos) (push) Successful in 43s
joule-moq-remote host agent / joule-moq-remote, every target (macos) (push) Successful in 1m11s
wai-fleet service / service · macos (push) Successful in 1m2s
wai-audit collector and player integration / collector, player integration and the browser end to end · macos (push) Successful in 1m28s
wai-ledger service / service · macos (push) Successful in 1m34s
wai-app and Create / wai-app · Create, browser end-to-end (macos) (push) Successful in 6m8s
wai-quantum studio and desktop / desktop app · macos (push) Successful in 4m12s
WAI Studio / Studio in Chromium and Firefox · macos (push) Successful in 9m11s
wai-sink-swift native sink package / libwai slices, desktop tests, simulator tests · macos (push) Successful in 11m10s
joule-moq-web browser client / joule-moq-web · browser end-to-end (macos) (push) Successful in 15m15s
wai release binaries build on Windows / the seven release binaries · windows (push) Successful in 16m54s
wai-quantum studio and desktop / desktop app · windows (push) Successful in 10m27s
WAI breaking changes and the conformance runner / WAI breaking · does this change touch WAI (push) Successful in 11s
wai-app and Create / wai-app · tests, clippy, the line language's verifier (linux) (push) Successful in 49s
wai-audit collector and player integration / collector · linux (push) Successful in 1m33s
WAI Studio / the catalogue's actions, the unit tests and the core · linux (push) Successful in 57s
wai-ledger service / service · linux (push) Successful in 1m53s
wai-quantum for JavaScript / javascript · linux (push) Has been cancelled
WAI Studio / Studio in WebKit · linux (push) Has been cancelled
wai-quantum studio and desktop / desktop app · linux (push) Has been cancelled
wai-quantum studio and desktop / studio · browser (push) Has been cancelled
wai-fleet service / service · linux (push) Successful in 4m1s
joule-code conformance gate / Build + round-trip C1-C4 vectors (push) Successful in 5m4s
WAI breaking changes and the conformance runner / WAI breaking · wire, record and API against main · linux (push) Successful in 2m46s
WAI breaking changes and the conformance runner / WAI breaking and conform · their tests, and the independent verifiers through wai conform · linux (push) Successful in 7m20s
joule-moq-remote host agent / joule-moq-remote, every target (linux-arm64) (push) Has been cancelled
joule-moq-room room service / joule-moq-room, every target (push) Has been cancelled
joule-code conformance gate / joule-moq-relay, every target (push) Has been cancelled
joule-code conformance gate / joule-moq-ingest, every target (push) Has been cancelled
One release, four kinds of artefact, from wai-release.yml on a wai-v* tag: - C: each Linux job attaches libwai-<version>-<triple>.tar.gz for x86_64- and aarch64-unknown-linux-gnu (wai/quickstart/build-libwai.sh): lib/libwai.a, the feature native_sink, built for the glibc target without crt-static; the committed include/wai.h; lib/pkgconfig/wai.pc, relocatable, its Libs naming rustc's native-static-libs. Static, so a program carries it and looks for nothing at run time. Before the attach: the header the build regenerates is the committed one, the library defines exactly the envelope's and the native sink's functions, and a C program compiles, links and runs against the archive through pkg-config (wai/quickstart/test/c-library.sh). - Swift: Package.swift names WaiFFI by URL and checksum once a release has written them, and build/WaiFFI.xcframework while it is built there. The swift job attaches the zipped framework and wai-sink-swift-<version>.zip, the package naming it by download URL and SwiftPM checksum; scripts/check-release-package.sh resolves, builds and runs an application against it (before the attach through a mirror of the URL, after from the URL) and requires a wrong checksum to be refused. wai-sink-swift.yml runs the first on every change. - Kotlin: maven-publish as science.transaction.wai:wai-sink:<version>, manifest package science.transaction.wai.sink (the Kotlin classes keep wai.sink). The android job checks the publication (scripts/check-publication.sh), attaches the AAR and publishes it to the forge's Maven registry; wai-sink-android.yml writes and checks it on every change. - OCI: Containerfiles and check-image.sh for the relay and the room service (deploy/ beside each crate). The images job, on a runner labelled oci, builds and checks both and pushes them to the forge's container registry (wai/quickstart/release-images.sh, oci-push.py); an image that fails its check is not pushed. The forge's job token reads the organisation's packages and cannot write them, so the Maven publication and the images read the repository secret WAI_PACKAGES_TOKEN (scope write:package). Every upload goes to the forge over the private network. The release body names the new files. Co-Authored-By: Claude Opus 5.5 <[email protected]>
1.9 KiB
1.9 KiB
libwai, WAI's C library
WAI's C interface for Linux, as a static library:
| path | what |
|---|---|
include/wai.h |
the header, generated from the C interface of wai/wai-rs and committed there |
lib/libwai.a |
the library, built from wai/wai-rs with the feature native_sink |
lib/pkgconfig/wai.pc |
the pkg-config file: the flags to compile against the header and link the library |
Link
export PKG_CONFIG_PATH=/path/to/this/directory/lib/pkgconfig
cc your-program.c $(pkg-config --cflags --libs wai) -o your-program
wai.pc finds its own directory, so this directory can be unpacked anywhere. The library is
static: the program carries it, and nothing of libwai is looked for when the program runs. It is
built for this archive's glibc target without a static C runtime, so the program uses the C
library it is linked against. pkg-config --libs wai names the system libraries libwai needs
beside -lwai.
What it holds
The envelope and the native sink: wai_envelope_pack, wai_envelope_unpack,
wai_envelope_detect_version, wai_envelope_pack_multi, wai_envelope_unpack_multi,
wai_envelope_select, wai_int_payload_declared, wai_buffer_free, wai_last_error, every
wai_sink_* function (extensions/native-sink.md §9) and wai_audit_verify_bundle. It is the
interface the Swift package's WaiFFI.xcframework and the Android library carry, and it needs no
library but the C runtime.
wai.h also declares the codec wrappers (wai_image_*, wai_audio_*, wai_text_*,
wai_video_*) and the neural decoders (wai_neural_*). They need codec and model libraries, and
they are not in this library: a program that calls one of them does not link.
A call that can fail returns a status, 0 for success, and wai_last_error() says why it failed;
a buffer a call writes is freed with wai_buffer_free. The header's comments state each
function's contract.