# Working on this project

This is a WAI project made from the `android-app` template: the WAI native sink's Kotlin API, the
one an Android app's player session calls, replaying a recorded playback session
(`sample-session.json`) through the sink on the host and verifying its bundle
(`replay/src/main/kotlin/Replay.kt`).

- **Build.** The sink is the `wai-sink-android` project of the WAI repository: build its host
  library once (`scripts/build-native.sh host` there, with JDK 17 and Rust), set
  `WAI_SINK_ANDROID` to that project's directory, then `gradle :replay:build` (Gradle 8.13, as the
  SDK pins it).
- **Run.** `gradle :replay:run`.
- **Test.** `gradle :replay:run` prints how many playlists and objects went through the sink and
  exits 0 when the bundle verifies, non-zero otherwise. Run it after every change.
- **Conform.** In an app, a `WaiPlayerSession(context, url, config, WaiViewAttention(view))` makes
  the same calls on the path of the player's requests; the SDK's README covers the AAR. Never
  bypass the sink's checks to make a stream play.
- `wai.json` is the project file; its `$schema` names the schema editors validate it with. Keep
  `name` a lowercase DNS label.
- Never put a key, a token or any other secret in this repository.
- WAI's tools for a coding agent: `wai mcp` (`wai setup-agent` registers it).