Switched from CLAUDE.md to AGENTS.md - updated the content

AGENTS.md

@@ -0,0 +1,90 @@
+# AGENTS.md
+
+This file provides guidance to AI coding agents (e.g. Claude Code) when working with code in this repository. `CLAUDE.md` includes it via `@AGENTS.md`.
+
+## Project Overview
+
+LiveKit Unity SDK — a C# wrapper around LiveKit's Rust SDK using FFI (Foreign Function Interface) for real-time audio/video communication. Unity package name: `io.livekit.livekit-sdk`.
+
+## Build & Development Commands
+
+### Run Unity tests and builds locally
+```bash
+Scripts~/run_unity.sh test [-f FILTER] [-m EditMode|PlayMode|both] [-n N]
+Scripts~/run_unity.sh build <platform>
+```
+- `UNITY_PATH` overrides the Unity binary (auto-detect picks the *oldest* editor installed via Unity Hub, which may not match the project — e.g. `Samples~/Meet` targets Unity 6)
+- `PROJECT_PATH` overrides the Unity project (default: `Samples~/Meet`)
+- Test results go to `Logs~/` by default
+
+### Build FFI locally from Rust source
+```bash
+# Requires the client-sdk-rust~ submodule and Rust toolchain
+Scripts~/build_ffi_locally.sh <platform> [build_type]
+# Platforms: macos, android, ios
+# Build types: debug (default), release
+```
+- **macOS**: requires `aarch64-apple-darwin` target
+- **Android**: requires `cargo-ndk` and Android NDK
+- **iOS**: builds static lib (`liblivekit_ffi.a`)
+- After macOS builds, Unity must be restarted to load the new dylib
+
+### Other scripts in `Scripts~/`
+- `download_libs.py` — downloads the prebuilt FFI binaries for all platforms; the release tag is pinned in `version.ini`
+- `generate_proto.sh` — regenerates `Runtime/Scripts/Proto/` from the protobuf definitions in `client-sdk-rust~/livekit-ffi/protocol` (requires `protoc`)
+- `build_docs.sh`, `prepare_release.py`, `unity_test_results_utils.py` — docs generation, release preparation, CI test-result parsing
+
+### Run tests
+Tests require a local LiveKit server running:
+```bash
+# Install and run LiveKit server
+curl -sSL https://get.livekit.io | bash
+livekit-server --dev &
+```
+Tests run via Unity Test Framework (game-ci/unity-test-runner in CI; CI starts the server via livekit/dev-server-action). Tested against Unity 6000.0.49f1 and 2023.2.20f1. Tests are in `Tests/EditMode/` and `Tests/PlayMode/`.
+
+## Architecture
+
+### FFI Bridge Pattern
+The SDK wraps a Rust native library (`liblivekit_ffi`) via P/Invoke. The communication flow:
+
+1. **C# public API** (`Runtime/Scripts/`, feature folders) — `Room`, `Participant`, `Track`, audio/video sources, data streams, RPC
+2. **FFI layer** (`Runtime/Scripts/Internal/`) — serializes requests via Protocol Buffers, sends through P/Invoke to Rust
+3. **Native library** (`Runtime/Plugins/ffi-*/liblivekit_ffi.*`) — Rust implementation per platform/arch
+
+`Runtime/Scripts/` is organized into feature folders:
+- `Core/` — `Room`, `Participant`, `Track`, `TrackPublication`, `Rpc`, `E2EE`
+- `Audio/` — audio sources (`RtcAudioSource`, `MicrophoneSource`, …), `AudioStream`, `AudioResampler`
+- `Video/` — video sources (`CameraVideoSource`, `ScreenVideoSource`, …), `VideoStream`, YUV conversion
+- `DataStreams/` — byte/text data streams and data tracks
+- `TokenSource/` — token generation/fetching helpers and MonoBehaviour component
+- `UniTask/` — optional UniTask integration (own asmdef: `livekit.unity.Runtime.UniTask.asmdef`)
+- `Internal/`, `Proto/` — FFI plumbing and generated protobuf code
+
+Key internal files:
+- `Internal/FFI/FFIClient.cs` — singleton managing request/response lifecycle with Rust via protobuf
+- `Internal/FFI/Requests/FFIBridge.cs` — request factory
+- `Internal/FFI/NativeMethods.cs` — P/Invoke declarations (`DllImport`)
+- `Internal/Threading/YieldInstruction.cs` — custom awaitables for async FFI operations (coroutine-based)
+
+### Proto/Generated Code
+`Runtime/Scripts/Proto/` contains auto-generated C# from protobuf definitions in the Rust SDK. Do not edit these files manually; regenerate with `Scripts~/generate_proto.sh`.
+
+### Native Plugins
+10 platform/arch combinations in `Runtime/Plugins/ffi-{platform}-{arch}/`. These are large binary files tracked with Git LFS. The `.meta` files configure Unity platform targeting.
+
+### Samples
+- `Samples~/Common` — shared components used by the other samples
+- `Samples~/Basic` — minimal connection example, also used as the CI build target
+- `Samples~/Meet` — more complete multi-participant example (LiveKit Meet-like), default project for `run_unity.sh`
+- `Samples~/Agents` — connect to an agent and display the transcript
+
+### Rust Submodule
+`client-sdk-rust~/` is a git submodule pointing to the shared Rust SDK. The `~` suffix tells Unity to ignore the directory.
+
+## Key Conventions
+
+- Minimum Unity version: 2022.3
+- Unsafe code is enabled via `Runtime/csc.rsp` and `Tests/csc.rsp`
+- Assembly definitions: `livekit.unity.Runtime.asmdef`, `livekit.unity.Editor.asmdef`, `livekit.unity.Runtime.UniTask.asmdef`, plus test asmdefs
+- Dependencies: `Google.Protobuf.dll` and `System.Runtime.CompilerServices.Unsafe.dll` shipped as managed plugins

CLAUDE.md

@@ -1,65 +1 @@
-# CLAUDE.md
-
-This file provides guidance to Claude Code (claude.ai/code) when working with code in this repository.
-
-## Project Overview
-
-LiveKit Unity SDK — a C# wrapper around LiveKit's Rust SDK using FFI (Foreign Function Interface) for real-time audio/video communication. Status: Developer Preview. Unity package name: `io.livekit.livekit-sdk`.
-
-## Build & Development Commands
-
-### Build FFI locally from Rust source
-```bash
-# Requires the client-sdk-rust~ submodule and Rust toolchain
-Scripts~/build_ffi_locally.sh <platform> [build_type]
-# Platforms: macos, android, ios
-# Build types: debug (default), release
-```
-- **macOS**: requires `aarch64-apple-darwin` target
-- **Android**: requires `cargo-ndk` and Android NDK
-- **iOS**: builds static lib (`liblivekit_ffi.a`)
-- After macOS builds, Unity must be restarted to load the new dylib
-
-### Run tests
-Tests require a local LiveKit server running:
-```bash
-# Install and run LiveKit server
-curl -sSL https://get.livekit.io | bash
-livekit-server --dev &
-```
-Tests run via Unity Test Framework (game-ci/unity-test-runner in CI). Tested against Unity 6000.0.49f1 and 2023.2.20f1. Tests are in `Tests/EditMode/` and `Tests/PlayMode/`.
-
-## Architecture
-
-### FFI Bridge Pattern
-The SDK wraps a Rust native library (`liblivekit_ffi`) via P/Invoke. The communication flow:
-
-1. **C# public API** (`Runtime/Scripts/*.cs`) — `Room`, `Participant`, `Track`, audio/video sources, data streams, RPC
-2. **FFI layer** (`Runtime/Scripts/Internal/`) — serializes requests via Protocol Buffers, sends through P/Invoke to Rust
-3. **Native library** (`Runtime/Plugins/ffi-*/liblivekit_ffi.*`) — Rust implementation per platform/arch
-
-Key internal files:
-- `FFIClient.cs` — singleton managing request/response lifecycle with Rust via protobuf
-- `FFIBridge.cs` — request factory
-- `NativeMethods.cs` — P/Invoke declarations (`DllImport`)
-- `YieldInstruction.cs` — custom awaitables for async FFI operations (coroutine-based)
-
-### Proto/Generated Code
-`Runtime/Scripts/Proto/` contains auto-generated C# from protobuf definitions in the Rust SDK. Do not edit these files manually.
-
-### Native Plugins
-10 platform/arch combinations in `Runtime/Plugins/ffi-{platform}-{arch}/`. These are large binary files tracked with Git LFS. The `.meta` files configure Unity platform targeting.
-
-### Samples
-- `Samples~/Basic` — minimal connection example, also used as the CI build target
-- `Samples~/Meet` — more complete multi-participant example
-
-### Rust Submodule
-`client-sdk-rust~/` is a git submodule pointing to the shared Rust SDK. The `~` suffix tells Unity to ignore the directory.
-
-## Key Conventions
-
-- Minimum Unity version: 2021.3
-- Unsafe code is enabled via `csc.rsp`
-- Assembly definitions: `livekit.unity.Runtime.asmdef`, `livekit.unity.Editor.asmdef`, plus test asmdefs
-- Dependencies: `Google.Protobuf.dll` and `System.Runtime.CompilerServices.Unsafe.dll` shipped as managed plugins
+@AGENTS.md