Skip to content

armgit / cua

Public Imported from GitHub
0

Scale computer-use 2.0 with open-source drivers, cross-OS sandboxes, and benchmarks for training, evaluation, and data generation.

chore: tidy the repo root (56 entries to 38) (#5464)

Francesco Bonaccic66cc353e30e
diff --git a/.agents/skills/poll-github-work/SKILL.md b/.agents/skills/poll-github-work/SKILL.md
index 54d06bc614..42e7b14518 100644
--- a/.agents/skills/poll-github-work/SKILL.md
+++ b/.agents/skills/poll-github-work/SKILL.md
@@ -6,7 +6,7 @@ description: Poll and rank open GitHub issues, RFCs, and pull requests for maint
# Poll GitHub Work
Use GitHub as the durable record and
-[`MAINTAINERS.md`](../../../MAINTAINERS.md) as the ranking policy. Operate in
+[`MAINTAINERS.md`](../../../docs/contributing/MAINTAINERS.md) as the ranking policy. Operate in
**recommend** mode until the maintainer explicitly selects an item; only then
enter **execute** mode.
diff --git a/.cursorignore b/.cursorignore
deleted file mode 100644
index d7148b8e9a..0000000000
--- a/.cursorignore
+++ /dev/null
@@ -1,229 +0,0 @@
-# Byte-compiled / optimized / DLL files
-__pycache__/
-*.py[cod]
-*$py.class
-
-# C extensions
-*.so
-
-# Distribution / packaging
-.Python
-build/
-!libs/lume/scripts/build/
-develop-eggs/
-dist/
-downloads/
-eggs/
-.eggs/
-lib/
-lib64/
-parts/
-sdist/
-var/
-wheels/
-share/python-wheels/
-*.egg-info/
-.installed.cfg
-*.egg
-MANIFEST
-
-# PyInstaller
-# Usually these files are written by a python script from a template
-# before PyInstaller builds the exe, so as to inject date/other infos into it.
-*.manifest
-*.spec
-
-# Installer logs
-pip-log.txt
-pip-delete-this-directory.txt
-
-# Unit test / coverage reports
-htmlcov/
-.tox/
-.nox/
-.coverage
-.coverage.*
-.cache
-nosetests.xml
-coverage.xml
-*.cover
-*.py,cover
-.hypothesis/
-.pytest_cache/
-cover/
-
-# Translations
-*.mo
-*.pot
-
-# Django stuff:
-*.log
-local_settings.py
-db.sqlite3
-db.sqlite3-journal
-
-# Flask stuff:
-instance/
-.webassets-cache
-
-# Scrapy stuff:
-.scrapy
-
-# Sphinx documentation
-docs/_build/
-
-# PyBuilder
-.pybuilder/
-target/
-
-# Jupyter Notebook
-.ipynb_checkpoints
-
-# IPython
-profile_default/
-ipython_config.py
-
-.pdm.toml
-.pdm-python
-.pdm-build/
-
-# PEP 582; used by e.g. github.com/David-OConnor/pyflow and github.com/pdm-project/pdm
-__pypackages__/
-
-# Celery stuff
-celerybeat-schedule
-celerybeat.pid
-
-# SageMath parsed files
-*.sage.py
-
-# Environments
-.env
-.venv
-env/
-venv/
-ENV/
-env.bak/
-venv.bak/
-
-# Spyder project settings
-.spyderproject
-.spyproject
-
-# Rope project settings
-.ropeproject
-
-# mkdocs documentation
-/site
-
-# mypy
-.mypy_cache/
-.dmypy.json
-dmypy.json
-
-# Scripts
-server/scripts/
-
-# Pyre type checker
-.pyre/
-
-# pytype static type analyzer
-.pytype/
-
-# Cython debug symbols
-cython_debug/
-
-# Ruff stuff:
-.ruff_cache/
-
-# PyPI configuration file
-.pypirc
-
-# Conda
-.conda/
-
-# Local environment
-.env.local
-
-# macOS DS_Store
-.DS_Store
-
-weights/
-weights/icon_detect/
-weights/icon_detect/model.pt
-weights/icon_detect/model.pt.zip
-weights/icon_detect/model.pt.zip.part*
-
-libs/python/omniparser/weights/icon_detect/model.pt
-
-/screenshots/
-
-/experiments/
-
-/logs/
-
-# Xcode
-#
-# gitignore contributors: remember to update Global/Xcode.gitignore, Objective-C.gitignore & Swift.gitignore
-
-## User settings
-xcuserdata/
-
-## Obj-C/Swift specific
-*.hmap
-
-## App packaging
-*.ipa
-*.dSYM.zip
-*.dSYM
-
-## Playgrounds
-timeline.xctimeline
-playground.xcworkspace
-
-# Swift Package Manager
-#
-# Add this line if you want to avoid checking in source code from Swift Package Manager dependencies.
-# Packages/
-# Package.pins
-# Package.resolved
-# *.xcodeproj
-#
-# Xcode automatically generates this directory with a .xcworkspacedata file and xcuserdata
-# hence it is not needed unless you have added a package configuration file to your project
-.swiftpm/
-.build/
-
-# CocoaPods
-#
-# We recommend against adding the Pods directory to your .gitignore. However
-# you should judge for yourself, the pros and cons are mentioned at:
-# https://guides.cocoapods.org/using/using-cocoapods.html#should-i-check-the-pods-directory-into-source-control
-#
-# Pods/
-#
-# Add this line if you want to avoid checking in source code from the Xcode workspace
-# *.xcworkspace
-
-# Carthage
-#
-# Add this line if you want to avoid checking in source code from Carthage dependencies.
-# Carthage/Checkouts
-Carthage/Build/
-
-# fastlane
-#
-# It is recommended to not store the screenshots in the git repo.
-# Instead, use fastlane to re-generate the screenshots whenever they are needed.
-# For more information about the recommended setup visit:
-# https://docs.fastlane.tools/best-practices/source-control/#source-control
-fastlane/report.xml
-fastlane/Preview.html
-fastlane/screenshots/**/*.png
-fastlane/test_output
-
-# Ignore folder
-ignore
-
-# .release
-.release/
diff --git a/.github/CODEOWNERS b/.github/CODEOWNERS
index fa0a215ba4..c7d2f13d0e 100644
--- a/.github/CODEOWNERS
+++ b/.github/CODEOWNERS
@@ -8,7 +8,7 @@
/libs/lume/ @f-trycua
/libs/python/ @ddupont808
/libs/cua-bench/ @ddupont808
-/benchmarks/cua-driver-bench/ @f-trycua @injaneity
+/libs/cua-driver-bench/ @f-trycua @injaneity
# Cua Driver documentation and driver-only release/CI automation.
/docs/content/docs/cua-driver/reference/ @f-trycua @injaneity
diff --git a/CONTRIBUTING.md b/.github/CONTRIBUTING.md
similarity index 92%
rename from CONTRIBUTING.md
rename to .github/CONTRIBUTING.md
index 9b07e07b88..4cc96fb012 100644
--- a/CONTRIBUTING.md
+++ b/.github/CONTRIBUTING.md
@@ -5,7 +5,7 @@ CLI (a Rust core with Python, TypeScript, Swift, and Kotlin bindings), the
in-sandbox cua-spacesd, the Cua Spaces app, the cua-driver desktop driver,
Python and TypeScript packages, Swift virtualization tools, container images,
and public documentation. Start with the component that owns the behavior you
-want to change; [`Development.md`](Development.md) maps them.
+want to change; [`Development.md`](../docs/contributing/Development.md) maps them.
## Choose Where Work Starts
@@ -13,7 +13,7 @@ want to change; [`Development.md`](Development.md) maps them.
| ---------------------------------------------------------------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------- |
| Report reproducible incorrect behavior | The **Bug report** issue form |
| Describe a user problem or product improvement | The **Feature request** issue form |
-| Change a public contract, compatibility policy, permission boundary, or cross-component architecture | The **Request for comments** issue form and [`rfcs/README.md`](rfcs/README.md) |
+| Change a public contract, compatibility policy, permission boundary, or cross-component architecture | The **Request for comments** issue form and [`rfcs/README.md`](../docs/rfcs/README.md) |
| Report a suspected vulnerability | [GitHub private vulnerability reporting](https://github.com/trycua/cua/security/advisories/new), following [`SECURITY.md`](SECURITY.md) |
| Ask for contributor help | The [Cua Discord community](https://discord.com/invite/mVnXXpdE85) |
@@ -38,10 +38,10 @@ reply confirming the scope, or maintainer review of the linked draft pull
request. Small, self-contained fixes may go directly to a focused pull request
when the problem and evidence are clear; until reviewed, that work is an
unselected contribution. Work that needs an RFC waits for the recorded decision
-in [`rfcs/README.md`](rfcs/README.md) before implementation begins.
+in [`rfcs/README.md`](../docs/rfcs/README.md) before implementation begins.
Maintainers and coding agents choosing what to work on next should use the
-read-only polling ladder in [`MAINTAINERS.md`](MAINTAINERS.md).
+read-only polling ladder in [`MAINTAINERS.md`](../docs/contributing/MAINTAINERS.md).
Once implementation starts, keep the issue or RFC as the problem and decision
record and the pull request as the current execution record. Link them in both
@@ -68,25 +68,25 @@ In the **Feature request** issue form, describe the user problem and the
expected behavior before prescribing an implementation. Mention affected
platforms and existing workarounds when known.
-Use the [RFC process](rfcs/README.md) before implementation when a proposal
+Use the [RFC process](../docs/rfcs/README.md) before implementation when a proposal
changes a public SDK, CLI, MCP, protocol, compatibility, permission, or
cross-component architectural contract. Start with the **Request for comments**
GitHub issue form. Longer proposals and diagrams remain in this repository under
-`rfcs/` and link back to the discussion issue.
+`docs/rfcs/` and link back to the discussion issue.
## Submit Code
-1. Read [`Development.md`](Development.md) and the guide next to the component.
+1. Read [`Development.md`](../docs/contributing/Development.md) and the guide next to the component.
2. Keep changes scoped to the component that owns the behavior.
3. Add or update tests that observe the public effect of the change.
-4. Run the applicable commands in [`TESTING.md`](TESTING.md).
+4. Run the applicable commands in [`TESTING.md`](../docs/contributing/TESTING.md).
5. Run the formatters and linters owned by the changed component.
6. Open a focused pull request that explains behavior, validation, and known gaps.
### Contributor License Agreement
Before a pull request can be merged, its author must accept the
-[Contributor License Agreement](CLA.md) once. The **CI: CLA** check comments on
+[Contributor License Agreement](../legal/CLA.md) once. The **CI: CLA** check comments on
your first pull request with instructions; reply with the sentence it gives you
to sign. The agreement applies to your later contributions, and you keep
ownership of your work. Maintainers and automation accounts are exempt.
@@ -134,7 +134,7 @@ through this workflow. The legacy
`pypi/sandbox` bump workflow and `release:pypi/sandbox` auto-release label no
longer manage this package. Sandbox Apps and the other Python and npm packages
also release through Release Please now; see
-[`.github/releases/README.md`](.github/releases/README.md).
+[`.github/releases/README.md`](releases/README.md).
## Preserve Contributor Authorship
@@ -183,7 +183,7 @@ exact structured refusal, or record the behavior as an explicit gap.
## Documentation
Public documentation lives under `docs/content/docs` and follows Diataxis. See
-[`docs/README.md`](docs/README.md) before adding a page. Contributor-only plans,
+[`docs/README.md`](../docs/README.md) before adding a page. Contributor-only plans,
journals, and implementation notes belong next to their component.
Documentation changes should pass generator drift, hygiene, internal links,
diff --git a/.github/ISSUE_TEMPLATE/config.yml b/.github/ISSUE_TEMPLATE/config.yml
index e9db742518..5c4e184e09 100644
--- a/.github/ISSUE_TEMPLATE/config.yml
+++ b/.github/ISSUE_TEMPLATE/config.yml
@@ -7,5 +7,5 @@ contact_links:
url: https://discord.com/invite/mVnXXpdE85
about: Ask questions and get help from the Cua community.
- name: RFC guidance
- url: https://github.com/trycua/cua/blob/main/rfcs/README.md
+ url: https://github.com/trycua/cua/blob/main/docs/rfcs/README.md
about: Check whether a public contract or architecture change needs an RFC.
diff --git a/.github/ISSUE_TEMPLATE/rfc.yml b/.github/ISSUE_TEMPLATE/rfc.yml
index 4fd4251fdb..7019da0487 100644
--- a/.github/ISSUE_TEMPLATE/rfc.yml
+++ b/.github/ISSUE_TEMPLATE/rfc.yml
@@ -15,8 +15,8 @@ body:
or sensitive screenshots in a public issue.
The issue is the discussion and decision record. If the proposal needs a longer
- specification or diagrams, add a linked `rfcs/<issue>-<short-name>.md` pull request
- using the repository's `rfcs/0000-template.md`.
+ specification or diagrams, add a linked `docs/rfcs/<issue>-<short-name>.md` pull request
+ using the repository's `docs/rfcs/0000-template.md`.
- type: dropdown
id: area
diff --git a/SECURITY.md b/.github/SECURITY.md
similarity index 96%
rename from SECURITY.md
rename to .github/SECURITY.md
index e7eeaf46e0..aba6eb1cc1 100644
--- a/SECURITY.md
+++ b/.github/SECURITY.md
@@ -29,7 +29,7 @@ These are targets, not contractual guarantees:
Cua is a monorepo of independently released components (CLI, SDK, Cua
Driver, Cua Spaces apps, the relay, the Keyvault, teleport, and others; see
-[`Development.md`](Development.md)). We support and patch the **current
+[`Development.md`](../docs/contributing/Development.md)). We support and patch the **current
released version of each component**, plus the version actually deployed
for anything we host ourselves (`relay.cua.ai`, `auth.cua.ai`, and other
`*.cua.ai` services): those always run our latest fix once it ships,
@@ -83,7 +83,7 @@ reporter attribution remains private until disclosure is permitted.
To propose or debate a security boundary (a permission model, trust boundary,
or public contract) that does not disclose an exploitable defect, use the
-**Request for comments** issue form and [`rfcs/README.md`](rfcs/README.md).
+**Request for comments** issue form and [`rfcs/README.md`](../docs/rfcs/README.md).
Use private reporting for a specific exploitable defect in shipped code or
configuration. When design and vulnerability details are entangled, report
privately first; maintainers can open or unblock the public RFC after remediation
diff --git a/.github/releases/README.md b/.github/releases/README.md
index 51632a5111..1217f2e2a3 100644
--- a/.github/releases/README.md
+++ b/.github/releases/README.md
@@ -192,5 +192,5 @@ Store the preference as a validated one-line `release-channel` file in the
component's existing product home. A missing file means stable; invalid or
unreadable state fails closed with a repair command. Product-home overrides must
relocate the file so installer and updater tests remain isolated. Cua Driver and
-Lume are the reference implementations; [RFC 3101](../../rfcs/3101-persistent-release-channel-selection.md)
+Lume are the reference implementations; [RFC 3101](../../docs/rfcs/3101-persistent-release-channel-selection.md)
records the full rationale and acceptance matrix.
diff --git a/.github/scripts/tests/test_cua_driver_release_wiring.py b/.github/scripts/tests/test_cua_driver_release_wiring.py
index d834ba0dec..74c5de649a 100644
--- a/.github/scripts/tests/test_cua_driver_release_wiring.py
+++ b/.github/scripts/tests/test_cua_driver_release_wiring.py
@@ -358,9 +358,9 @@ fi
actually matters: the contract exists in the canonical document, and an
agent reading AGENTS.md is pointed at it.
"""
- contributing = self.read("CONTRIBUTING.md")
+ contributing = self.read(".github/CONTRIBUTING.md")
for token in ("fix(cua-driver):", "feat(lume):", "no-release", "squash"):
- self.assertIn(token, contributing, "CONTRIBUTING.md")
+ self.assertIn(token, contributing, ".github/CONTRIBUTING.md")
# Either AGENTS.md carries the contract itself or it links to the file
# that does -- both satisfy "an agent can find the rules from here".
diff --git a/.github/scripts/tests/test_documented_cargo_targets.py b/.github/scripts/tests/test_documented_cargo_targets.py
index 45683c04da..37f251a9ac 100644
--- a/.github/scripts/tests/test_documented_cargo_targets.py
+++ b/.github/scripts/tests/test_documented_cargo_targets.py
@@ -9,7 +9,7 @@ import pytest
ROOT = Path(__file__).resolve().parents[3]
[email protected]("document", ["TESTING.md", "libs/cua-driver/rust/README.md"])
[email protected]("document", ["docs/contributing/TESTING.md", "libs/cua-driver/rust/README.md"])
def test_documented_integration_targets_exist(document):
metadata = json.loads(subprocess.check_output(
["cargo", "metadata", "--no-deps", "--format-version", "1", "--locked"],
diff --git a/.github/workflows/ci-check-docs-links.yml b/.github/workflows/ci-check-docs-links.yml
index 5a4061509a..b8b207319c 100644
--- a/.github/workflows/ci-check-docs-links.yml
+++ b/.github/workflows/ci-check-docs-links.yml
@@ -23,9 +23,9 @@ on:
- "tests/e2e/cua-sdk/docs/**"
- "scripts/docs-generators/cli-specs/**"
# Tutorial excerpts must match their #region in these sources.
- - "samples/openkoalabot-example-ts/**"
- - "samples/openkoalabot-example-tauri/**"
- - "samples/openkoalabot-example-swift/**"
+ - "examples/openkoalabot-example-ts/**"
+ - "examples/openkoalabot-example-tauri/**"
+ - "examples/openkoalabot-example-swift/**"
- "libs/cua/crates/cua-image/schema/**"
- "**/*.md"
- ".github/workflows/ci-check-docs-links.yml"
diff --git a/.github/workflows/ci-cua-driver-bench.yml b/.github/workflows/ci-cua-driver-bench.yml
index 57aea3fd12..f02d86e1e1 100644
--- a/.github/workflows/ci-cua-driver-bench.yml
+++ b/.github/workflows/ci-cua-driver-bench.yml
@@ -3,12 +3,12 @@ name: "CI: Cua Driver Bench"
on:
pull_request:
paths:
- - "benchmarks/cua-driver-bench/**"
+ - "libs/cua-driver-bench/**"
- ".github/workflows/ci-cua-driver-bench.yml"
push:
branches: [main]
paths:
- - "benchmarks/cua-driver-bench/**"
+ - "libs/cua-driver-bench/**"
- ".github/workflows/ci-cua-driver-bench.yml"
workflow_dispatch:
@@ -33,11 +33,11 @@ jobs:
uses: astral-sh/setup-uv@d0cc045d04ccac9d8b7881df0226f9e82c39688e # v6
- name: Build BenchLab and BenchSentinel
- working-directory: benchmarks/cua-driver-bench/automated-eval/macos_bench
+ working-directory: libs/cua-driver-bench/automated-eval/macos_bench
run: swift/build.sh "$RUNNER_TEMP/bench-build"
- name: Run harness, checker and sentinel tests
- working-directory: benchmarks/cua-driver-bench/automated-eval/macos_bench
+ working-directory: libs/cua-driver-bench/automated-eval/macos_bench
env:
CDB_BENCH_WORK: ${{ runner.temp }}/cdb-bench-work
run: >-
@@ -61,7 +61,7 @@ jobs:
node-version: "22"
- name: Evaluator, reset and manifest tests
- working-directory: benchmarks/cua-driver-bench/taskpack/tasks/shared
+ working-directory: libs/cua-driver-bench/taskpack/tasks/shared
run: |
set -euo pipefail
for task in */; do
@@ -72,7 +72,7 @@ jobs:
done
- name: App store tests
- working-directory: benchmarks/cua-driver-bench/taskpack/tasks/shared
+ working-directory: libs/cua-driver-bench/taskpack/tasks/shared
run: |
set -euo pipefail
for dir in */apps/* */fixture/archive-site; do
@@ -83,7 +83,7 @@ jobs:
done
- name: Pinned tree digests match the task pack
- working-directory: benchmarks/cua-driver-bench/automated-eval/macos_bench
+ working-directory: libs/cua-driver-bench/automated-eval/macos_bench
env:
CDB_BENCH_WORK: ${{ runner.temp }}/cdb-bench-work
run: >-
@@ -103,5 +103,5 @@ jobs:
- name: Check Python files
run: |
- uvx ruff==0.14.10 check --no-fix benchmarks/cua-driver-bench
- uvx ruff==0.14.10 format --check benchmarks/cua-driver-bench
+ uvx ruff==0.14.10 check --no-fix libs/cua-driver-bench
+ uvx ruff==0.14.10 format --check libs/cua-driver-bench
diff --git a/.github/workflows/ci-infinite-canvas-swift.yml b/.github/workflows/ci-infinite-canvas-swift.yml
index 5329382a04..f582c20c50 100644
--- a/.github/workflows/ci-infinite-canvas-swift.yml
+++ b/.github/workflows/ci-infinite-canvas-swift.yml
@@ -1,6 +1,6 @@
name: "CI: infinite-canvas (Swift)"
-# samples/infinite-canvas-swift builds on the Swift packages (libs/cua/swift,
+# examples/infinite-canvas-swift builds on the Swift packages (libs/cua/swift,
# libs/spaces-sdk-swift, and libs/spaces-app-swift for CuaSpacesStreaming) and
# the cua SDK dylib, so an SDK change can break it
# without touching the sample. The tests are hermetic: the canvas model, the
@@ -11,7 +11,7 @@ name: "CI: infinite-canvas (Swift)"
on:
pull_request:
paths:
- - "samples/infinite-canvas-swift/**"
+ - "examples/infinite-canvas-swift/**"
- "libs/cua/**"
- "libs/spaces-sdk-swift/**"
- "libs/spaces-app-swift/**"
@@ -55,11 +55,11 @@ jobs:
(cd libs/cua && cargo build --locked --release -p cua-sdk)
node libs/cua/scripts/stage-uniffi-library.mjs --only=swift
- name: Cursor theme is the driver's
- run: samples/infinite-canvas-swift/scripts/sync-cursor-assets.sh --check
+ run: examples/infinite-canvas-swift/scripts/sync-cursor-assets.sh --check
- name: Test the sample
- run: samples/infinite-canvas-swift/scripts/test.sh
+ run: examples/infinite-canvas-swift/scripts/test.sh
- name: Benchmark (headless hot paths)
- working-directory: samples/infinite-canvas-swift
+ working-directory: examples/infinite-canvas-swift
run: |
swift build -c release --product canvas-bench
.build/release/canvas-bench --tiles 8 --seconds 5 --json canvas-bench.json
@@ -67,5 +67,5 @@ jobs:
if: always()
with:
name: infinite-canvas-bench
- path: samples/infinite-canvas-swift/canvas-bench.json
+ path: examples/infinite-canvas-swift/canvas-bench.json
if-no-files-found: ignore
diff --git a/.github/workflows/ci-openkoalabot-example-samples.yml b/.github/workflows/ci-openkoalabot-example-samples.yml
index 61de8d1192..1ad9c967ab 100644
--- a/.github/workflows/ci-openkoalabot-example-samples.yml
+++ b/.github/workflows/ci-openkoalabot-example-samples.yml
@@ -10,8 +10,8 @@ name: "CI: openkoalabot-example (TypeScript and Swift)"
on:
pull_request:
paths:
- - "samples/openkoalabot-example-ts/**"
- - "samples/openkoalabot-example-swift/**"
+ - "examples/openkoalabot-example-ts/**"
+ - "examples/openkoalabot-example-swift/**"
- "libs/cua/**"
- "libs/spaces-sdk-swift/**"
- "libs/spaces-app-swift/**"
@@ -77,7 +77,7 @@ jobs:
command -v wasm-bindgen >/dev/null || cargo install --locked wasm-bindgen-cli --version 0.2.126
npm run build:browser
- name: Test the sample
- working-directory: samples/openkoalabot-example-ts
+ working-directory: examples/openkoalabot-example-ts
run: |
npm ci
npm test
@@ -105,4 +105,4 @@ jobs:
(cd libs/cua && cargo build --locked --release -p cua-sdk)
node libs/cua/scripts/stage-uniffi-library.mjs --only=swift
- name: Test the sample
- run: samples/openkoalabot-example-swift/scripts/test.sh
+ run: examples/openkoalabot-example-swift/scripts/test.sh
diff --git a/.github/workflows/ci-openkoalabot-example-tauri.yml b/.github/workflows/ci-openkoalabot-example-tauri.yml
index 0376e11652..5ea260e4f8 100644
--- a/.github/workflows/ci-openkoalabot-example-tauri.yml
+++ b/.github/workflows/ci-openkoalabot-example-tauri.yml
@@ -10,7 +10,7 @@ name: "CI: openkoalabot-example (Tauri)"
on:
pull_request:
paths:
- - "samples/openkoalabot-example-tauri/**"
+ - "examples/openkoalabot-example-tauri/**"
- "libs/cua/**"
- "libs/cua-spacesd/**"
- ".github/workflows/ci-openkoalabot-example-tauri.yml"
@@ -25,7 +25,7 @@ concurrency:
defaults:
run:
- working-directory: samples/openkoalabot-example-tauri
+ working-directory: examples/openkoalabot-example-tauri
env:
CARGO_NET_RETRY: "10"
@@ -55,9 +55,9 @@ jobs:
with:
node-version: 22
cache: pnpm
- cache-dependency-path: samples/openkoalabot-example-tauri/pnpm-lock.yaml
+ cache-dependency-path: examples/openkoalabot-example-tauri/pnpm-lock.yaml
- name: Install Rust (toolchain from rust-toolchain.toml)
- working-directory: samples/openkoalabot-example-tauri/src-tauri
+ working-directory: examples/openkoalabot-example-tauri/src-tauri
run: rustup show active-toolchain || rustup toolchain install
- name: Install protoc
uses: ./.github/actions/setup-protoc
@@ -75,14 +75,14 @@ jobs:
path: |
~/.cargo/registry
~/.cargo/git
- samples/openkoalabot-example-tauri/src-tauri/target
- key: openkoalabot-example-tauri-${{ hashFiles('samples/openkoalabot-example-tauri/src-tauri/Cargo.lock') }}
+ examples/openkoalabot-example-tauri/src-tauri/target
+ key: openkoalabot-example-tauri-${{ hashFiles('examples/openkoalabot-example-tauri/src-tauri/Cargo.lock') }}
restore-keys: openkoalabot-example-tauri-
- name: cargo check (core + Tauri shell)
- working-directory: samples/openkoalabot-example-tauri/src-tauri
+ working-directory: examples/openkoalabot-example-tauri/src-tauri
run: cargo check --locked --workspace --all-targets
- name: Core tests (hermetic)
- working-directory: samples/openkoalabot-example-tauri/src-tauri
+ working-directory: examples/openkoalabot-example-tauri/src-tauri
run: cargo test --locked -p openkoalabot-example-core -- --test-threads=4
# The UI links @trycua/cua from the repo (link:../../libs/cua/typescript);
# its subpath exports (teleport, spaces/presence, ...) resolve to the
diff --git a/.github/workflows/ci-spdx-headers.yml b/.github/workflows/ci-spdx-headers.yml
index 98f637e23f..8e46d27d2c 100644
--- a/.github/workflows/ci-spdx-headers.yml
+++ b/.github/workflows/ci-spdx-headers.yml
@@ -2,7 +2,7 @@ name: "CI: SPDX Headers"
# Two checks. The `fsl` job (enforcing) verifies that every source file in an
# FSL-1.1-MIT package carries `SPDX-License-Identifier: FSL-1.1-MIT` (see
-# LICENSING.md). The `check` job verifies that every cua-driver source file
+# legal/LICENSING.md). The `check` job verifies that every cua-driver source file
# carries an SPDX-License-Identifier header; it is warn-only
# (continue-on-error: true) while we stamp the existing tree in a separate
# sweep PR, and will be flipped to enforcing once the tree is clean. See
@@ -23,8 +23,7 @@ on:
- "libs/python/cua-sandbox-apps/**"
- "libs/cua-bench/**"
- "libs/cua-bench-rl/**"
- - "examples/streaming/**"
- - "samples/**"
+ - "examples/**"
- "tests/e2e/**"
- "scripts/spdx-headers.py"
- ".github/workflows/ci-spdx-headers.yml"
diff --git a/.github/workflows/ci-test-scripts.yml b/.github/workflows/ci-test-scripts.yml
index 8b6bff7ca0..91069923c6 100644
--- a/.github/workflows/ci-test-scripts.yml
+++ b/.github/workflows/ci-test-scripts.yml
@@ -6,7 +6,7 @@ on:
- ".github/scripts/**"
- ".github/workflows/**"
- ".github/actions/**"
- - "TESTING.md"
+ - "docs/contributing/TESTING.md"
- "libs/cua-driver/rust/README.md"
- "libs/cua-driver/rust/**/Cargo.toml"
- "libs/cua-driver/rust/crates/*/tests/**"
@@ -65,7 +65,7 @@ on:
- ".github/release-notes/**"
- ".github/release-state/**"
- "AGENTS.md"
- - "CONTRIBUTING.md"
+ - ".github/CONTRIBUTING.md"
- "docs/content/docs/reference/cua-driver/**"
- "libs/cua-driver/examples/agent-sdks/**"
- "libs/cua-driver/rust/Cargo.lock"
diff --git a/.github/workflows/cla.yml b/.github/workflows/cla.yml
index b33d4c9cb6..c1b413eb48 100644
--- a/.github/workflows/cla.yml
+++ b/.github/workflows/cla.yml
@@ -1,6 +1,6 @@
name: "CI: CLA"
-# Asks each pull request author to accept CLA.md once. Signatures are stored as
+# Asks each pull request author to accept legal/CLA.md once. Signatures are stored as
# JSON on the `cla-signatures` branch of this repository, not on main.
# pull_request_target is used so the check can comment on fork pull requests;
# the job never checks out or runs pull request code.
@@ -37,7 +37,7 @@ jobs:
GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
with:
path-to-signatures: "signatures/version1/cla.json"
- path-to-document: "https://github.com/${{ github.repository }}/blob/main/CLA.md"
+ path-to-document: "https://github.com/${{ github.repository }}/blob/main/legal/CLA.md"
branch: "cla-signatures"
# The action locks every merged PR by default. A locked release PR
# (labelled `autorelease: pending`) makes release-please die when it
diff --git a/.github/workflows/license-check.yml b/.github/workflows/license-check.yml
index c4344c67a6..7fb7533911 100644
--- a/.github/workflows/license-check.yml
+++ b/.github/workflows/license-check.yml
@@ -50,7 +50,7 @@ jobs:
- name: Check licence direction
id: check
# --include-dev: an FSL-1.1-MIT package must not be even a dev
- # dependency of an MIT one (LICENSING.md).
+ # dependency of an MIT one (legal/LICENSING.md).
run: python3 scripts/check-license-direction.py --include-dev
- name: Flag violations
diff --git a/.gitignore b/.gitignore
index 4eb4509a78..a8ac7eaf39 100644
--- a/.gitignore
+++ b/.gitignore
@@ -224,7 +224,7 @@ docs/scripts/check-mdx-links.py
.re-windows/
# Cua Driver Bench: raw run output stays out of git
-benchmarks/cua-driver-bench/**/runs/
-benchmarks/cua-driver-bench/**/results/
+libs/cua-driver-bench/**/runs/
+libs/cua-driver-bench/**/results/
# The bench task pack keeps its tasks in tasks/shared/ (the "shared" rule above would hide them)
-!benchmarks/cua-driver-bench/taskpack/tasks/shared/
+!libs/cua-driver-bench/taskpack/tasks/shared/
diff --git a/.lycheeignore b/.lycheeignore
index 07228a6cdf..54cd0cf08f 100644
--- a/.lycheeignore
+++ b/.lycheeignore
@@ -10,12 +10,18 @@ https://openai.com/*
https://github.com/user-attachments/assets/*
# Self-referential install.sh URL: resolves once this PR merges to main
https://raw.githubusercontent.com/trycua/cua/main/libs/cua-driver/scripts/install.sh
+# Moved by the repo-root tidy-up: these resolve once it merges to main
+# (remove these four lines after the merge)
+https://github.com/trycua/cua/tree/main/examples/python/osworld-image
+https://github.com/trycua/cua/blob/main/docs/rfcs/4268-jev-use-native-candidates\.md
+https://github.com/trycua/cua/blob/main/legal/LICENSING\.md
+https://github.com/trycua/cua/blob/main/\.github/SECURITY\.md
# Paths added in cua-staging (samples, examples, Spaces): resolve once promoted to trycua/cua main
-https://github.com/trycua/cua/tree/main/samples/openkoalabots
+https://github.com/trycua/cua/tree/main/examples/openkoalabots
https://github.com/trycua/cua/tree/main/libs/spaces-sdk-swift
-https://github.com/trycua/cua/tree/main/samples/infinite-canvas-swift
-https://github.com/trycua/cua/tree/main/samples/openkoalabot-example-
-https://github.com/trycua/cua/tree/main/samples/cua-bots-
+https://github.com/trycua/cua/tree/main/examples/infinite-canvas-swift
+https://github.com/trycua/cua/tree/main/examples/openkoalabot-example-
+https://github.com/trycua/cua/tree/main/examples/cua-bots-
https://github.com/trycua/cua/(tree|blob)/main/examples/agents-in-sandboxes
https://github.com/trycua/cua/tree/main/examples/streaming/
https://github.com/trycua/cua/tree/main/libs/cua/bench/streaming
diff --git a/AGENTS.md b/AGENTS.md
index e04ae23ac8..694b448c6d 100644
--- a/AGENTS.md
+++ b/AGENTS.md
@@ -2,7 +2,7 @@
## Contributor authorship
-Follow [Preserve Contributor Authorship](CONTRIBUTING.md#preserve-contributor-authorship).
+Follow [Preserve Contributor Authorship](.github/CONTRIBUTING.md#preserve-contributor-authorship).
- A `Salvaged from #<pr>` source pull request must differ from the landing pull request.
- When adapting a contribution directly in its existing pull request, keep the
@@ -17,10 +17,10 @@ Do not reimplement submitted work solely to remove its authorship history.
## Issue and pull request workflow
Follow the contribution and selection contract in
-[`CONTRIBUTING.md`](CONTRIBUTING.md#choose-where-work-starts),
-[`MAINTAINERS.md`](MAINTAINERS.md#select-and-start-work), the
-GitHub issue forms, [`rfcs/README.md`](rfcs/README.md), and
-[`SECURITY.md`](SECURITY.md). Keep those files canonical instead of duplicating
+[`CONTRIBUTING.md`](.github/CONTRIBUTING.md#choose-where-work-starts),
+[`MAINTAINERS.md`](docs/contributing/MAINTAINERS.md#select-and-start-work), the
+GitHub issue forms, [`rfcs/README.md`](docs/rfcs/README.md), and
+[`SECURITY.md`](.github/SECURITY.md). Keep those files canonical instead of duplicating
their field lists, polling ladder, or RFC lifecycle here.
Coding agents act as workers within that contract, not as a planning authority.
@@ -37,19 +37,19 @@ understand, reproduce, or continue the work.
- avoid noisy periodic status comments; keep progress in the linked pull request
description; and
- route suspected vulnerabilities through the private process in
- [`SECURITY.md`](SECURITY.md), never a public issue, RFC, pull request, log, or
+ [`SECURITY.md`](.github/SECURITY.md), never a public issue, RFC, pull request, log, or
screenshot.
### Polling for work
When asked what to work on, follow
-[`MAINTAINERS.md`](MAINTAINERS.md#pull-model) and the
+[`MAINTAINERS.md`](docs/contributing/MAINTAINERS.md#pull-model) and the
[polling skill](.agents/skills/poll-github-work/SKILL.md).
## Repository layout
-[`Development.md`](Development.md) maps components to paths and toolchains;
-[`TESTING.md`](TESTING.md) maps them to test commands and CI workflows. Rules
+[`Development.md`](docs/contributing/Development.md) maps components to paths and toolchains;
+[`TESTING.md`](docs/contributing/TESTING.md) maps them to test commands and CI workflows. Rules
that are easy to miss:
- `libs/cua` (cua SDK, `cua` CLI, `cua daemon`) is the only client library.
@@ -130,8 +130,8 @@ These rules come from the #4094 test audit.
## Pull request titles and component releases
-Follow the [release-title rules](CONTRIBUTING.md#agent-assisted-contributions)
-and [Sandbox release rules](CONTRIBUTING.md#sandbox-releases).
+Follow the [release-title rules](.github/CONTRIBUTING.md#agent-assisted-contributions)
+and [Sandbox release rules](.github/CONTRIBUTING.md#sandbox-releases).
Do not use `no-release` to hide a user-visible change.
Before declaring a pull request ready or merging it, inspect its final changed
diff --git a/README.md b/README.md
index 89045581a4..26f32d502d 100644
--- a/README.md
+++ b/README.md
@@ -242,7 +242,7 @@ Cua no longer maintains these. They will not receive updates or fixes, and exist
- [Blog](https://cua.ai/blog): tutorials, updates, and research
- [Discord](https://discord.com/invite/mVnXXpdE85): community support and discussions
- [GitHub Issues](https://github.com/trycua/cua/issues): bug reports and feature requests
-- [Security](SECURITY.md): private vulnerability reporting
+- [Security](.github/SECURITY.md): private vulnerability reporting
## Citation
@@ -262,15 +262,15 @@ For reproducibility, include the Cua release or commit used in your experiments.
## Contributing
-We welcome contributions. See our [Contributing Guidelines](CONTRIBUTING.md) for details.
+We welcome contributions. See our [Contributing Guidelines](.github/CONTRIBUTING.md) for details.
## Licensing
Everything outside Cua Spaces and Cua Driver Bench is MIT-licensed ([LICENSE](LICENSE.md)): the cua SDK and its Python, TypeScript, Swift and Kotlin packages, the `cua` command and `cua daemon`, Cua Driver, Lume and the rest of this repository unless a directory says otherwise.
Cua Spaces is source-available under [FSL-1.1-MIT](https://fsl.software): the Spaces apps, cua-spacesd, the Cua Keyvault, teleport, Cua Volume (`cua-volume`) and the streaming client, codecs and viewers. The streaming wire protocol stays MIT. It is free to use, self-host and build on, with no competing hosted service, and each release becomes MIT two years after it ships.
-Cua Driver Bench (`benchmarks/cua-driver-bench`) is under the same [FSL-1.1-MIT](benchmarks/cua-driver-bench/LICENSE); versions published before 11 Oct 2026 (#4973, #4978) were MIT.
-The MIT parts never depend on the FSL parts. Some subdirectories carry their own licence; [LICENSING.md](LICENSING.md) lists each one and how the two fit together.
-Offering Spaces, or Cua Driver Bench, as a hosted or managed service? See [COMMERCIAL.md](COMMERCIAL.md). For use of our names and logo, see [TRADEMARKS.md](TRADEMARKS.md).
+Cua Driver Bench (`libs/cua-driver-bench`) is under the same [FSL-1.1-MIT](libs/cua-driver-bench/LICENSE); versions published before 11 Oct 2026 (#4973, #4978) were MIT.
+The MIT parts never depend on the FSL parts. Some subdirectories carry their own licence; [LICENSING.md](legal/LICENSING.md) lists each one and how the two fit together.
+Offering Spaces, or Cua Driver Bench, as a hosted or managed service? See [COMMERCIAL.md](legal/COMMERCIAL.md). For use of our names and logo, see [TRADEMARKS.md](legal/TRADEMARKS.md).
Third-party components have their own licenses:
diff --git a/apps/cua-spaces-macos/README.md b/apps/cua-spaces-macos/README.md
index 0ca20d853f..6f48411f21 100644
--- a/apps/cua-spaces-macos/README.md
+++ b/apps/cua-spaces-macos/README.md
@@ -422,4 +422,4 @@ first party to the Keyvault and cannot be notarized.
## License
-Source-available under FSL-1.1-MIT ([LICENSE](LICENSE)). Offering it as a hosted or managed service needs a commercial licence: see [COMMERCIAL.md](../../COMMERCIAL.md).
+Source-available under FSL-1.1-MIT ([LICENSE](LICENSE)). Offering it as a hosted or managed service needs a commercial licence: see [COMMERCIAL.md](../../legal/COMMERCIAL.md).
diff --git a/apps/cua-spaces-web/src/components/settings/notices-dialog.tsx b/apps/cua-spaces-web/src/components/settings/notices-dialog.tsx
index c5ec18d8b1..7715e7d82a 100644
--- a/apps/cua-spaces-web/src/components/settings/notices-dialog.tsx
+++ b/apps/cua-spaces-web/src/components/settings/notices-dialog.tsx
@@ -19,7 +19,7 @@ export function NoticesDialog({ open, onOpenChange }: { open: boolean; onOpenCha
const [text, setText] = useState<string | null>(null);
useEffect(() => {
if (!open || text !== null) return;
- void import("../../../../../THIRD_PARTY_NOTICES.md?raw").then(
+ void import("../../../../../legal/THIRD_PARTY_NOTICES.md?raw").then(
(m) => setText(m.default.replace(/<!--[\s\S]*?-->\n?/g, "")),
() => setText("The third-party notices are missing from this build (THIRD_PARTY_NOTICES.md)."),
);
diff --git a/apps/cua-spaces/README.md b/apps/cua-spaces/README.md
index 7de2cc10e5..82dc31d80b 100644
--- a/apps/cua-spaces/README.md
+++ b/apps/cua-spaces/README.md
@@ -254,4 +254,4 @@ only the intent is recorded.
## License
-Source-available under FSL-1.1-MIT ([LICENSE](LICENSE)). Offering it as a hosted or managed service needs a commercial licence: see [COMMERCIAL.md](../../COMMERCIAL.md).
+Source-available under FSL-1.1-MIT ([LICENSE](LICENSE)). Offering it as a hosted or managed service needs a commercial licence: see [COMMERCIAL.md](../../legal/COMMERCIAL.md).
diff --git a/blog/gpu-passthrough-macos-vms.md b/blog/gpu-passthrough-macos-vms.md
index 19ef85776e..89fc31cc90 100644
--- a/blog/gpu-passthrough-macos-vms.md
+++ b/blog/gpu-passthrough-macos-vms.md
@@ -82,7 +82,7 @@ Values below are medians of the ten samples emitted for each benchmark row:
Prompt processing nearly reached the host result. Generation reached 72.06% of host speed, leaving a measurable VM gap. The gain depends on the host GPU, guest version, application, and workload shape.
-The [TinyLlama raw results and environment record](https://github.com/trycua/cua/tree/main/evidence/lume-metal-capability-shim/2026-08-09-m1-ultra) include the exact image digest, model and binary hashes, commands, JSON output, stderr, and checksums. These release-candidate results certify the reduced shim used in this post.
+The [TinyLlama raw results and environment record](https://github.com/trycua/cua/tree/main/libs/lume/metal-capability-shim/evidence/2026-08-09-m1-ultra) include the exact image digest, model and binary hashes, commands, JSON output, stderr, and checksums. These release-candidate results certify the reduced shim used in this post.
### A current 12B model
@@ -95,7 +95,7 @@ The host, VM, shim, benchmark shape, and ten-sample method stayed the same. We d
| Prompt processing, 512 tokens | 517.88 tok/s | 71.66 tok/s | **515.76 tok/s** | **7.20×** | **99.59%** |
| Token generation, 128 tokens | 52.38 tok/s | 3.41 tok/s | **49.67 tok/s** | **14.54×** | **94.82%** |
-The [Gemma 4 evidence](https://github.com/trycua/cua/tree/main/evidence/lume-metal-capability-shim/2026-08-10-m1-ultra-gemma4) pins Google's model revision and SHA-256 alongside the final raw samples. We discarded and reran a preliminary stock series after detecting another host compute workload. The retained stock, unlocked, and bare-metal files come from the same uncontended window and show tight sample ranges.
+The [Gemma 4 evidence](https://github.com/trycua/cua/tree/main/libs/lume/metal-capability-shim/evidence/2026-08-10-m1-ultra-gemma4) pins Google's model revision and SHA-256 alongside the final raw samples. We discarded and reran a preliminary stock series after detecting another host compute workload. The retained stock, unlocked, and bare-metal files come from the same uncontended window and show tight sample ranges.
### A 30B text model in a 64 GiB guest
@@ -108,7 +108,7 @@ Muse Glimmer let us test the same capability path with a larger model. We used M
These values are medians of three llama-bench samples. The built-in same-process warmup ran before each row and is excluded from the samples. All four processes exited successfully. Before and after every arm, the guest reported 98% free memory, zero swap, and zero compressor use. Stock stderr reported Apple family 5 with the newer SIMD-group and bfloat paths disabled; unlocked stderr reported Apple family 9 with those paths enabled.
-The host was shared with another VM that showed intermittent CPU activity, so the [Muse Glimmer evidence](https://github.com/trycua/cua/tree/main/evidence/lume-metal-capability-shim/2026-08-11-m1-ultra-muse-glimmer-64g) preserves that boundary. The pp512 samples were tight, and the stock tg128 median agreed within 5.6% of an earlier independent run. The public evidence includes the official model revision and SHA-256, llama.cpp and shim hashes, path-sanitized raw JSON, capability logs, exact arguments, telemetry summaries, and checksums.
+The host was shared with another VM that showed intermittent CPU activity, so the [Muse Glimmer evidence](https://github.com/trycua/cua/tree/main/libs/lume/metal-capability-shim/evidence/2026-08-11-m1-ultra-muse-glimmer-64g) preserves that boundary. The pp512 samples were tight, and the stock tg128 median agreed within 5.6% of an earlier independent run. The public evidence includes the official model revision and SHA-256, llama.cpp and shim hashes, path-sanitized raw JSON, capability logs, exact arguments, telemetry summaries, and checksums.
This result applies to the text-only GGUF through llama.cpp. It should not be read as Ollama throughput or as a result for Muse Glimmer's multimodal and speculative-decoding components.
diff --git a/changelog/2026-03-14.md b/docs/changelog/2026-03-14.md
similarity index 100%
rename from changelog/2026-03-14.md
rename to docs/changelog/2026-03-14.md
diff --git a/changelog/2026-05-18.md b/docs/changelog/2026-05-18.md
similarity index 100%
rename from changelog/2026-05-18.md
rename to docs/changelog/2026-05-18.md
diff --git a/docs/content/docs/cua-bench/guides/adapter-benchmarks.mdx b/docs/content/docs/cua-bench/guides/adapter-benchmarks.mdx
index b36f820220..9bcc08eb09 100644
--- a/docs/content/docs/cua-bench/guides/adapter-benchmarks.mdx
+++ b/docs/content/docs/cua-bench/guides/adapter-benchmarks.mdx
@@ -72,7 +72,7 @@ guest's server. `CUA_BENCH_OSWORLD_SPLIT` picks the list (`test_all`,
To keep the upstream disk as is and add only a `cua-driver mcp` service
(Streamable HTTP on `3000/mcp`), use the recipe in
-[`samples/python/osworld-image`](https://github.com/trycua/cua/tree/main/samples/python/osworld-image).
+[`examples/python/osworld-image`](https://github.com/trycua/cua/tree/main/examples/python/osworld-image).
It edits an overlay with `virt-customize` (no guest network, `base.qcow2`
untouched) and packages `disk.img` as a containerDisk. This disk has no
cua-spacesd; the SDK's OSWorld adapter (`agent_type="osworld"`) talks to the
@@ -83,7 +83,7 @@ docker build -t osworld-guestfs:local osworld-image/guestfs
docker run --rm --device /dev/kvm -v "$PWD:/work" osworld-guestfs:local \
bash /work/osworld-image/build-osworld-cua.sh # -> disk.img
export OSWORLD_IMAGE="<registry>/<repo>@sha256:<digest>" # after pushing the containerDisk
-uv run samples/python/3_osworld_local.py # boots it under QEMU
+uv run examples/python/3_osworld_local.py # boots it under QEMU
```
- Wrap OSWorld setup and evaluation in timeouts: its controller has none.
diff --git a/docs/content/docs/cua-driver/guides/visual-regions.mdx b/docs/content/docs/cua-driver/guides/visual-regions.mdx
index e3b3311e2e..a20aa6591e 100644
--- a/docs/content/docs/cua-driver/guides/visual-regions.mdx
+++ b/docs/content/docs/cua-driver/guides/visual-regions.mdx
@@ -182,4 +182,4 @@ or `--harness winui3` (build with `-Targets winui3`) on Windows and `--harness g
X11 Linux session. `--harness canvas` needs the perception extension and proves
the visual fallback. Tasks live in `python/native_tasks.py` and
`typescript/native_tasks.ts`; the design is recorded in
-[RFC 4268](https://github.com/trycua/cua/blob/main/rfcs/4268-jev-use-native-candidates.md).
+[RFC 4268](https://github.com/trycua/cua/blob/main/docs/rfcs/4268-jev-use-native-candidates.md).
diff --git a/docs/content/docs/index.mdx b/docs/content/docs/index.mdx
index f20cbcea46..6e596a64df 100644
--- a/docs/content/docs/index.mdx
+++ b/docs/content/docs/index.mdx
@@ -15,7 +15,7 @@ landing:
alt: 'The Cua Bots launch film: koala-faced bots, then "Self-host your bots" and real Cua Bots screens'
links:
- title: Source on GitHub
- href: https://github.com/trycua/cua/tree/main/samples/cua-bots-macos
+ href: https://github.com/trycua/cua/tree/main/examples/cua-bots-macos
- title: 'Background computer-use with **Cua Driver**'
description: 'Your agent builds and tests a Windows app in the background while you keep working.'
href: /cua-driver/guides/recipes
diff --git a/docs/content/docs/spaces/examples/cua-bots.mdx b/docs/content/docs/spaces/examples/cua-bots.mdx
index 5ca8dd983e..02ab1afeca 100644
--- a/docs/content/docs/spaces/examples/cua-bots.mdx
+++ b/docs/content/docs/spaces/examples/cua-bots.mdx
@@ -77,13 +77,13 @@ From a clone of [trycua/cua](https://github.com/trycua/cua). The sample builds t
```bash skip="no-runner"
(cd libs/cua && cargo build --locked --release -p cua-spaces-ffi)
libs/spaces-app-swift/scripts/stage-library.sh
-cd samples/cua-bots-macos
+cd examples/cua-bots-macos
swift build && .build/debug/CuaBots
```
-Give the app a model key for the agents you pick (`ANTHROPIC_API_KEY`, `OPENAI_API_KEY`). The iPhone app is in `samples/cua-bots-ios`; its README covers the Xcode build and pairing.
+Give the app a model key for the agents you pick (`ANTHROPIC_API_KEY`, `OPENAI_API_KEY`). The iPhone app is in `examples/cua-bots-ios`; its README covers the Xcode build and pairing.
-The app registers the Cua Spaces extensions at launch (`cuaSpacesRegister()`), so the runtime it embeds has persistent agents, the Keyvault and teleport. Because it links those Cua Spaces pieces, both samples are source-available under the FSL-1.1-MIT, like Cua Spaces; see [LICENSING.md](https://github.com/trycua/cua/blob/main/LICENSING.md). For examples in TypeScript and Rust (Tauri), see [Use Spaces from code](/spaces/guides/create-a-space-with-the-sdk#examples-in-other-languages).
+The app registers the Cua Spaces extensions at launch (`cuaSpacesRegister()`), so the runtime it embeds has persistent agents, the Keyvault and teleport. Because it links those Cua Spaces pieces, both samples are source-available under the FSL-1.1-MIT, like Cua Spaces; see [LICENSING.md](https://github.com/trycua/cua/blob/main/legal/LICENSING.md). For examples in TypeScript and Rust (Tauri), see [Use Spaces from code](/spaces/guides/create-a-space-with-the-sdk#examples-in-other-languages).
## Limits
diff --git a/docs/content/docs/spaces/examples/infinite-canvas.mdx b/docs/content/docs/spaces/examples/infinite-canvas.mdx
index ce9b89bcd4..d61f1ec2ab 100644
--- a/docs/content/docs/spaces/examples/infinite-canvas.mdx
+++ b/docs/content/docs/spaces/examples/infinite-canvas.mdx
@@ -32,7 +32,7 @@ From a clone of [trycua/cua](https://github.com/trycua/cua), on macOS 26:
```bash skip="no-runner"
(cd libs/cua && cargo build --release -p cua-sdk && node scripts/stage-uniffi-library.mjs --only=swift)
-cd samples/infinite-canvas-swift
+cd examples/infinite-canvas-swift
swift build -c release
.build/release/infinite-canvas --spaces spaces.json --show
```
@@ -65,7 +65,7 @@ swift build -c release --product canvas-bench && .build/release/canvas-bench --t
## Source
-[samples/infinite-canvas-swift](https://github.com/trycua/cua/tree/main/samples/infinite-canvas-swift): SwiftUI and AppKit on `Cua`, `CuaSpaces`, `CuaSpacesStreaming` and `CuaSpacesTeleport`.
+[examples/infinite-canvas-swift](https://github.com/trycua/cua/tree/main/examples/infinite-canvas-swift): SwiftUI and AppKit on `Cua`, `CuaSpaces`, `CuaSpacesStreaming` and `CuaSpacesTeleport`.
## How each part works
diff --git a/docs/content/docs/spaces/guides/connect-your-agent.mdx b/docs/content/docs/spaces/guides/connect-your-agent.mdx
index a9701211d7..070fd42413 100644
--- a/docs/content/docs/spaces/guides/connect-your-agent.mdx
+++ b/docs/content/docs/spaces/guides/connect-your-agent.mdx
@@ -158,12 +158,12 @@ and the Swift tab is from [Cua Bots](/spaces/examples/cua-bots).
<Tabs items={['TypeScript', 'Rust', 'Swift']}>
<Tab value="TypeScript">
- ```ts test="excerpt" id="ts-agent-start" source="samples/openkoalabot-example-ts/src/core/app.ts#ts-agent-start"
+ ```ts test="excerpt" id="ts-agent-start" source="examples/openkoalabot-example-ts/src/core/app.ts#ts-agent-start"
const report = await space.agentStart(bot.agent, prompt, false, options)
const t = new BotThread(bot, report.runId, space)
```
- ```ts test="excerpt" id="ts-agent-message" source="samples/openkoalabot-example-ts/src/core/app.ts#ts-agent-message"
+ ```ts test="excerpt" id="ts-agent-message" source="examples/openkoalabot-example-ts/src/core/app.ts#ts-agent-message"
const r = await this.space.agentMessage(this.runId, message, false)
if (!r.ok) {
this.fold.note(this.turns.length, `Refused: ${r.reason}`)
@@ -172,7 +172,7 @@ and the Swift tab is from [Cua Bots](/spaces/examples/cua-bots).
```
</Tab>
<Tab value="Rust">
- ```rust test="excerpt" id="rs-agent" source="samples/openkoalabot-example-tauri/src-tauri/core/src/thread.rs#rs-agent"
+ ```rust test="excerpt" id="rs-agent" source="examples/openkoalabot-example-tauri/src-tauri/core/src/thread.rs#rs-agent"
let r = self
.agents
.start(&self.agent, text, self.options.clone())
@@ -180,7 +180,7 @@ and the Swift tab is from [Cua Bots](/spaces/examples/cua-bots).
.map_err(agents_err)?;
```
- ```rust test="excerpt" id="rs-agent-message" source="samples/openkoalabot-example-tauri/src-tauri/core/src/thread.rs#rs-agent-message"
+ ```rust test="excerpt" id="rs-agent-message" source="examples/openkoalabot-example-tauri/src-tauri/core/src/thread.rs#rs-agent-message"
let r = self
.agents
.send(run, text, vec![])
@@ -192,7 +192,7 @@ and the Swift tab is from [Cua Bots](/spaces/examples/cua-bots).
```
</Tab>
<Tab value="Swift">
- ```swift test="excerpt" id="sw-agent-start" source="samples/cua-bots-macos/Sources/CuaBotsCua/CuaEngine.swift#sw-agent-start"
+ ```swift test="excerpt" id="sw-agent-start" source="examples/cua-bots-macos/Sources/CuaBotsCua/CuaEngine.swift#sw-agent-start"
let options = SpaceAgentOptions(
envFromHost: endpoint?.keyVariables ?? Self.defaultKeyVariables(bot.harness),
repo: nil, branch: nil, cwd: home, model: endpoint?.model, baseUrl: endpoint?.baseURL,
@@ -201,7 +201,7 @@ and the Swift tab is from [Cua Bots](/spaces/examples/cua-bots).
options: options)
```
- ```swift test="excerpt" id="sw-agent-message" source="samples/cua-bots-macos/Sources/CuaBotsCua/CuaEngine.swift#sw-agent-message"
+ ```swift test="excerpt" id="sw-agent-message" source="examples/cua-bots-macos/Sources/CuaBotsCua/CuaEngine.swift#sw-agent-message"
let report = try await space(bot).agentMessage(runId: run, text: text, force: false)
if !report.ok { throw EngineError.refused(report.reason) }
```
diff --git a/docs/content/docs/spaces/guides/create-a-space-with-the-sdk.mdx b/docs/content/docs/spaces/guides/create-a-space-with-the-sdk.mdx
index 0f486a21d2..a7c73a62e8 100644
--- a/docs/content/docs/spaces/guides/create-a-space-with-the-sdk.mdx
+++ b/docs/content/docs/spaces/guides/create-a-space-with-the-sdk.mdx
@@ -157,11 +157,11 @@ cua spaces delete local:space-1a2b3c
| Language | Sample | Built on |
|---|---|---|
-| TypeScript | [`samples/openkoalabot-example-ts`](https://github.com/trycua/cua/tree/main/samples/openkoalabot-example-ts) | A Node server and web UI on `@trycua/cua` |
-| Rust (Tauri) | [`samples/openkoalabot-example-tauri`](https://github.com/trycua/cua/tree/main/samples/openkoalabot-example-tauri) | A Tauri 2 app on the `cua-spaces` crate |
-| Swift | [`samples/openkoalabot-example-swift`](https://github.com/trycua/cua/tree/main/samples/openkoalabot-example-swift) | A SwiftUI app on `Cua` and `CuaSpaces` |
+| TypeScript | [`examples/openkoalabot-example-ts`](https://github.com/trycua/cua/tree/main/examples/openkoalabot-example-ts) | A Node server and web UI on `@trycua/cua` |
+| Rust (Tauri) | [`examples/openkoalabot-example-tauri`](https://github.com/trycua/cua/tree/main/examples/openkoalabot-example-tauri) | A Tauri 2 app on the `cua-spaces` crate |
+| Swift | [`examples/openkoalabot-example-swift`](https://github.com/trycua/cua/tree/main/examples/openkoalabot-example-swift) | A SwiftUI app on `Cua` and `CuaSpaces` |
-All three pass one headless test, [`samples/openkoalabot-example-scenario`](https://github.com/trycua/cua/tree/main/samples/openkoalabot-example-scenario).
+All three pass one headless test, [`examples/openkoalabot-example-scenario`](https://github.com/trycua/cua/tree/main/examples/openkoalabot-example-scenario).
### Run one
@@ -172,14 +172,14 @@ From a clone of [trycua/cua](https://github.com/trycua/cua). The samples build t
```bash skip="no-runner"
(cd libs/cua && cargo build --release -p cua-sdk)
(cd libs/cua/typescript && npm ci && npm run stage:uniffi && npm run build && npm run build:browser)
- cd samples/openkoalabot-example-ts
+ cd examples/openkoalabot-example-ts
npm ci && npm run build && npm run build:web
npm run serve # open the URL it prints
```
</Tab>
<Tab value="Rust + Tauri">
```bash skip="no-runner"
- cd samples/openkoalabot-example-tauri
+ cd examples/openkoalabot-example-tauri
pnpm install --frozen-lockfile
pnpm tauri build --debug --no-bundle
src-tauri/target/debug/openkoalabot-example-tauri
@@ -188,7 +188,7 @@ From a clone of [trycua/cua](https://github.com/trycua/cua). The samples build t
<Tab value="Swift">
```bash skip="no-runner"
(cd libs/cua && cargo build --release -p cua-sdk && node scripts/stage-uniffi-library.mjs --only=swift)
- cd samples/openkoalabot-example-swift
+ cd examples/openkoalabot-example-swift
swift build && .build/debug/OpenKoalaBotExample
```
</Tab>
diff --git a/docs/content/docs/spaces/guides/cua-volume.mdx b/docs/content/docs/spaces/guides/cua-volume.mdx
index eae144d81c..8d0017900c 100644
--- a/docs/content/docs/spaces/guides/cua-volume.mdx
+++ b/docs/content/docs/spaces/guides/cua-volume.mdx
@@ -224,7 +224,7 @@ From [the examples in other languages](/spaces/guides/create-a-space-with-the-sd
<Tabs items={['TypeScript', 'Rust', 'Swift']}>
<Tab value="TypeScript">
- ```ts test="excerpt" id="ts-send-file" source="samples/openkoalabot-example-ts/src/core/app.ts#ts-send-file"
+ ```ts test="excerpt" id="ts-send-file" source="examples/openkoalabot-example-ts/src/core/app.ts#ts-send-file"
const report = await this.space.sendFile(localPath, {
targetDirectory: subdir,
respectIgnoreFiles: true,
@@ -234,7 +234,7 @@ From [the examples in other languages](/spaces/guides/create-a-space-with-the-sd
```
</Tab>
<Tab value="Rust">
- ```rust test="excerpt" id="rs-send-file" source="samples/openkoalabot-example-tauri/src-tauri/core/src/files.rs#rs-send-file"
+ ```rust test="excerpt" id="rs-send-file" source="examples/openkoalabot-example-tauri/src-tauri/core/src/files.rs#rs-send-file"
let report: SendFileReport = space
.send_file(
path,
@@ -247,7 +247,7 @@ From [the examples in other languages](/spaces/guides/create-a-space-with-the-sd
```
</Tab>
<Tab value="Swift">
- ```swift test="excerpt" id="sw-send-file" source="samples/openkoalabot-example-swift/Sources/OpenKoalaBotExample/Scenario/ScenarioRunner.swift#sw-send-file"
+ ```swift test="excerpt" id="sw-send-file" source="examples/openkoalabot-example-swift/Sources/OpenKoalaBotExample/Scenario/ScenarioRunner.swift#sw-send-file"
let report = try await handle().sendFile(
localPath: file.path,
options: SpaceSendFileOptions(targetDirectory: step["subdir"] as? String,
diff --git a/docs/content/docs/spaces/guides/relay-security.mdx b/docs/content/docs/spaces/guides/relay-security.mdx
index a9540c83f8..8a5aedcd76 100644
--- a/docs/content/docs/spaces/guides/relay-security.mdx
+++ b/docs/content/docs/spaces/guides/relay-security.mdx
@@ -209,7 +209,7 @@ relay, over HTTPS to the same relay address as the rest of Cua.
## Reporting a concern
-See [`SECURITY.md`](https://github.com/trycua/cua/blob/main/SECURITY.md) for
+See [`SECURITY.md`](https://github.com/trycua/cua/blob/main/.github/SECURITY.md) for
how to report a vulnerability privately, our response targets, and our safe
harbor for good-faith security research.
diff --git a/docs/content/docs/spaces/guides/stream-a-desktop.mdx b/docs/content/docs/spaces/guides/stream-a-desktop.mdx
index 0171816952..c39362db16 100644
--- a/docs/content/docs/spaces/guides/stream-a-desktop.mdx
+++ b/docs/content/docs/spaces/guides/stream-a-desktop.mdx
@@ -36,21 +36,21 @@ The same calls in TypeScript, Rust and Swift, from
<Tabs items={['TypeScript', 'Rust', 'Swift']}>
<Tab value="TypeScript">
- ```ts test="excerpt" id="ts-stream" source="samples/openkoalabot-example-ts/src/core/runtime.ts#ts-stream"
+ ```ts test="excerpt" id="ts-stream" source="examples/openkoalabot-example-ts/src/core/runtime.ts#ts-stream"
const ticket = await space.openStream(
SpaceStreamOptions.create({ maxFps: opts.maxFps, maxDimension: opts.maxDimension }),
)
const session = await space.attachStream(ticket, counter, undefined)
```
- ```ts test="excerpt" id="ts-ticket" source="samples/openkoalabot-example-ts/src/core/runtime.ts#ts-ticket"
+ ```ts test="excerpt" id="ts-ticket" source="examples/openkoalabot-example-ts/src/core/runtime.ts#ts-ticket"
const ticket = await space.openStream(
SpaceStreamOptions.create({ maxFps: opts.maxFps, maxDimension: opts.maxDimension, codecs: ["h264"] }),
)
```
</Tab>
<Tab value="Rust">
- ```rust test="excerpt" id="rs-stream" source="samples/openkoalabot-example-tauri/src-tauri/core/src/stream.rs#rs-stream"
+ ```rust test="excerpt" id="rs-stream" source="examples/openkoalabot-example-tauri/src-tauri/core/src/stream.rs#rs-stream"
pub async fn open_ticket(space: &Space, max_fps: u32, max_dimension: u32) -> Result<StreamTicket> {
Ok(space
.open_stream(
@@ -66,7 +66,7 @@ The same calls in TypeScript, Rust and Swift, from
```
</Tab>
<Tab value="Swift">
- ```swift test="excerpt" id="sw-stream" source="samples/openkoalabot-example-swift/Sources/OpenKoalaBotExample/Scenario/ScenarioRunner.swift#sw-stream"
+ ```swift test="excerpt" id="sw-stream" source="examples/openkoalabot-example-swift/Sources/OpenKoalaBotExample/Scenario/ScenarioRunner.swift#sw-stream"
let provider = SpaceStreamProvider(space: space)
provider.maxFPS = UInt32(step["maxFps"] as? Int ?? 5)
let counter = FrameCounter()
@@ -110,14 +110,14 @@ The wire format is in
The operator and each agent join a Space with an identity and move a shared
cursor on its desktop.
-```ts test="excerpt" id="ts-presence" source="samples/openkoalabot-example-ts/src/server/app.ts#ts-presence"
+```ts test="excerpt" id="ts-presence" source="examples/openkoalabot-example-ts/src/server/app.ts#ts-presence"
const session = await space.joinPresence(
{ id: `openkoalabots-${randomBytes(4).toString("hex")}`, displayName: b.displayName || "Operator", color: "", agent: false },
10_000n,
)
```
-```ts test="excerpt" id="ts-cursor" source="samples/openkoalabot-example-ts/src/server/app.ts#ts-cursor"
+```ts test="excerpt" id="ts-cursor" source="examples/openkoalabot-example-ts/src/server/app.ts#ts-cursor"
await s.presence.session.updateCursor({ displayId: "", windowId: undefined, x: b.x ?? 0, y: b.y ?? 0, visible: true, pressed: false, shape: "arrow", shapeSource: "unspecified", atMs: 0, receivedMs: 0 })
```
diff --git a/docs/content/docs/spaces/guides/teleport-an-app.mdx b/docs/content/docs/spaces/guides/teleport-an-app.mdx
index f3171b0d43..2ea33eed25 100644
--- a/docs/content/docs/spaces/guides/teleport-an-app.mdx
+++ b/docs/content/docs/spaces/guides/teleport-an-app.mdx
@@ -197,7 +197,7 @@ runs teleport; an SDK runtime without Cua Spaces raises
```
</Tab>
<Tab value="Rust">
- ```rust test="excerpt" id="rs-teleport" source="samples/openkoalabot-example-tauri/src-tauri/core/src/teleport.rs#rs-teleport"
+ ```rust test="excerpt" id="rs-teleport" source="examples/openkoalabot-example-tauri/src-tauri/core/src/teleport.rs#rs-teleport"
let v = core
.spaces()
.call_extension(
@@ -216,7 +216,7 @@ runs teleport; an SDK runtime without Cua Spaces raises
```
</Tab>
<Tab value="Swift">
- ```swift test="excerpt" id="sw-teleport" source="samples/cua-bots-macos/Sources/CuaBotsCua/Keyvault.swift#sw-teleport"
+ ```swift test="excerpt" id="sw-teleport" source="examples/cua-bots-macos/Sources/CuaBotsCua/Keyvault.swift#sw-teleport"
let receipt = try await space.teleport(app: item.providerId, scope: nil,
approver: SelectItems(label: item.label))
```
diff --git a/Development.md b/docs/contributing/Development.md
similarity index 78%
rename from Development.md
rename to docs/contributing/Development.md
index 0c860d4eb5..f95db14cef 100644
--- a/Development.md
+++ b/docs/contributing/Development.md
@@ -8,23 +8,23 @@ next to the code you plan to change.
| Area | Main paths | Toolchain | Start here |
| ---------------------------- | ------------------------------------------------------------------------------------ | ----------------------------------- | ---------------------------------------------------------------------------------------------------------------------------- |
-| cua SDK and `cua` CLI | `libs/cua` (Rust crates, `proto/`, `python/`, `typescript/`, `swift/`, `kotlin/`) | Rust, protoc, buf; Node, uv, Swift | [`libs/cua/README.md`](libs/cua/README.md) |
-| cua-spacesd | `libs/cua-spacesd` | Rust, protoc; Docker for Linux lanes | [`libs/cua-spacesd/README.md`](libs/cua-spacesd/README.md) |
-| Cua Spaces app | `apps/cua-spaces` | Node.js, pnpm, Rust, Tauri 2 | [`apps/cua-spaces/README.md`](apps/cua-spaces/README.md) |
-| cua-driver | `libs/cua-driver/rust`, `libs/cua-driver/python` | Rust, platform SDKs, Nix on Linux | [`libs/cua-driver/README.md`](libs/cua-driver/README.md), [`libs/cua-driver/rust/README.md`](libs/cua-driver/rust/README.md) |
+| cua SDK and `cua` CLI | `libs/cua` (Rust crates, `proto/`, `python/`, `typescript/`, `swift/`, `kotlin/`) | Rust, protoc, buf; Node, uv, Swift | [`libs/cua/README.md`](../../libs/cua/README.md) |
+| cua-spacesd | `libs/cua-spacesd` | Rust, protoc; Docker for Linux lanes | [`libs/cua-spacesd/README.md`](../../libs/cua-spacesd/README.md) |
+| Cua Spaces app | `apps/cua-spaces` | Node.js, pnpm, Rust, Tauri 2 | [`apps/cua-spaces/README.md`](../../apps/cua-spaces/README.md) |
+| cua-driver | `libs/cua-driver/rust`, `libs/cua-driver/python` | Rust, platform SDKs, Nix on Linux | [`libs/cua-driver/README.md`](../../libs/cua-driver/README.md), [`libs/cua-driver/rust/README.md`](../../libs/cua-driver/rust/README.md) |
| Python SDKs and services | `libs/python` (incl. `cua-sandbox`), `libs/cua-bench` | Python 3.12, uv | Package `pyproject.toml` and README |
-| TypeScript SDKs | `libs/typescript` | Node.js, pnpm | [`libs/typescript/README.md`](libs/typescript/README.md) and its `package.json` scripts |
-| CuaBot (deprecated) | `libs/cuabot` | Node.js, pnpm | [`libs/cuabot/README.md`](libs/cuabot/README.md) |
-| Lume | `libs/lume` | Swift, Xcode command-line tools | [`libs/lume/Development.md`](libs/lume/Development.md) |
-| Sandbox and container images | `libs/images`, `libs/kasm`, `libs/lumier`, `libs/qemu-docker`, `libs/xfce`, `libs/xfce-cua` | Docker plus the component toolchain | [`libs/images/README.md`](libs/images/README.md) or the README in the component |
+| TypeScript SDKs | `libs/typescript` | Node.js, pnpm | [`libs/typescript/README.md`](../../libs/typescript/README.md) and its `package.json` scripts |
+| CuaBot (deprecated) | `libs/cuabot` | Node.js, pnpm | [`libs/cuabot/README.md`](../../libs/cuabot/README.md) |
+| Lume | `libs/lume` | Swift, Xcode command-line tools | [`libs/lume/Development.md`](../../libs/lume/Development.md) |
+| Sandbox and container images | `libs/images`, `libs/kasm`, `libs/lumier`, `libs/qemu-docker`, `libs/xfce`, `libs/xfce-cua` | Docker plus the component toolchain | [`libs/images/README.md`](../../libs/images/README.md) or the README in the component |
| Cross-language E2E | `tests/e2e/cua-sdk`, `tests/e2e/local-runtimes` | Rust, uv, Node.js, Go, Docker | [`TESTING.md`](TESTING.md#cua-sdk-and-cli) |
-| Public documentation | `docs/content/docs` | Node.js, pnpm, Fumadocs | [`docs/README.md`](docs/README.md) |
-| Samples and examples | `samples`, `examples` | Depends on the sample | README next to the sample |
+| Public documentation | `docs/content/docs` | Node.js, pnpm, Fumadocs | [`docs/README.md`](../README.md) |
+| Examples | `examples` | Depends on the example | README next to the example |
The repository changes quickly. Directory listings in this root guide are an
orientation aid, not a package registry. Release targets come from
-[`.github/releases/components.json`](.github/releases/components.json) and
-[`.github/workflows/release-bump-version.yml`](.github/workflows/release-bump-version.yml),
+[`.github/releases/components.json`](../../.github/releases/components.json) and
+[`.github/workflows/release-bump-version.yml`](../../.github/workflows/release-bump-version.yml),
and test ownership comes from CI plus the component guides.
Two boundaries to keep in mind:
@@ -56,7 +56,7 @@ Install only the toolchains required by your component:
| Images | Docker or the image-specific builder documented by the component |
The root uv workspace contains only the members declared in
-[`pyproject.toml`](pyproject.toml). Other directories under `libs/python` are
+[`pyproject.toml`](../../pyproject.toml). Other directories under `libs/python` are
independent packages; use their own `pyproject.toml` and CI workflow.
The root Node package installs repository-wide Prettier only. Run `pnpm
@@ -110,9 +110,9 @@ cua-driver has three distinct validation layers:
The Rust harnesses are the source of truth for desktop behavior. Python tests
do not duplicate that matrix. Start with:
-- [`libs/cua-driver/rust/README.md`](libs/cua-driver/rust/README.md) for the Cargo workspace.
-- [`libs/cua-driver/rust/crates/cua-driver-e2e/tests/README.md`](libs/cua-driver/rust/crates/cua-driver-e2e/tests/README.md) for desktop E2E test ownership.
-- [`scripts/ci/README.md`](scripts/ci/README.md) for canonical OS runners.
+- [`libs/cua-driver/rust/README.md`](../../libs/cua-driver/rust/README.md) for the Cargo workspace.
+- [`libs/cua-driver/rust/crates/cua-driver-e2e/tests/README.md`](../../libs/cua-driver/rust/crates/cua-driver-e2e/tests/README.md) for desktop E2E test ownership.
+- [`scripts/ci/README.md`](../../scripts/ci/README.md) for canonical OS runners.
- [Platform support](https://cua.ai/docs/cua-driver/concepts/platform-support) for current capability boundaries.
- [How Cua Driver is validated](https://cua.ai/docs/cua-driver/concepts/how-cua-driver-is-validated) for the public evidence model.
- [Platform roadmap](https://cua.ai/docs/cua-driver/concepts/platform-roadmap) for remaining work and platform boundaries.
@@ -132,7 +132,7 @@ Public docs use Fumadocs and follow Diataxis:
- concepts explain constraints and design;
- reference pages state commands, contracts, support, and limits.
-Run documentation commands from `docs`; see [`docs/README.md`](docs/README.md).
+Run documentation commands from `docs`; see [`docs/README.md`](../README.md).
Contributor-only implementation notes should remain next to their component
instead of entering the public docs navigation.
@@ -140,9 +140,9 @@ instead of entering the public docs navigation.
Release Please manages Cua Driver, Cua Perception, Lume, Cua Spaces, the cua
SDK, cua-spacesd, cua-sandbox and the Python and npm packages; the table in
-[`.github/releases/README.md`](.github/releases/README.md) lists each one's
+[`.github/releases/README.md`](../../.github/releases/README.md) lists each one's
path, tag and publishing workflow. Their pull request titles decide the
-release; see [`CONTRIBUTING.md`](CONTRIBUTING.md#agent-assisted-contributions).
+release; see [`CONTRIBUTING.md`](../../.github/CONTRIBUTING.md#agent-assisted-contributions).
The Docker images are still released through the
[Legacy packages: Bump Version](https://github.com/trycua/cua/actions/workflows/release-bump-version.yml)
diff --git a/MAINTAINERS.md b/docs/contributing/MAINTAINERS.md
similarity index 98%
rename from MAINTAINERS.md
rename to docs/contributing/MAINTAINERS.md
index 0e596a55a5..40d687a244 100644
--- a/MAINTAINERS.md
+++ b/docs/contributing/MAINTAINERS.md
@@ -2,7 +2,7 @@
This guide defines how maintainers and coding agents turn the repository's
issue and pull request backlog into a small, reviewable set of work. It extends
-the contribution contract in [`CONTRIBUTING.md`](CONTRIBUTING.md); it does not
+the contribution contract in [`CONTRIBUTING.md`](../../.github/CONTRIBUTING.md); it does not
replace issues, RFCs, pull requests, or maintainer judgment with a second queue.
## Pull Model
diff --git a/TESTING.md b/docs/contributing/TESTING.md
similarity index 92%
rename from TESTING.md
rename to docs/contributing/TESTING.md
index 2e4f753ac5..3620f8256a 100644
--- a/TESTING.md
+++ b/docs/contributing/TESTING.md
@@ -52,7 +52,7 @@ CUA_TELEMETRY_ENABLED=false uv run --frozen pytest tests --timeout=120 \
```
The package matrix and exact commands live in
-[`.github/workflows/ci-test-python.yml`](.github/workflows/ci-test-python.yml).
+[`.github/workflows/ci-test-python.yml`](../../.github/workflows/ci-test-python.yml).
## cua SDK and CLI
@@ -71,7 +71,7 @@ any opt-in live gates.
Per-language smoke tests (Python, Node, Swift, Kotlin, browser) are in each
package README under `libs/cua/{python,typescript,swift,kotlin}` and in
-[`.github/workflows/ci-cua-sdk.yml`](.github/workflows/ci-cua-sdk.yml).
+[`.github/workflows/ci-cua-sdk.yml`](../../.github/workflows/ci-cua-sdk.yml).
The cross-language E2E suite runs each guide scenario in Python, TypeScript,
and Rust, per lane (`hermetic`, `container`, `qemu`, `lume`, `cua-sandbox`,
@@ -95,7 +95,7 @@ scripts/ci/relay-e2e.sh # driver with no published ports behind cua-rel
Point the conformance suite at any running driver with
`CUA_ENV_TEST_TARGET=http://host:3211 CUA_ENV_TEST_TOKEN=... cargo test -p cua-spacesd-server --test conformance`.
-See [`crates/cua-spacesd-server/README.md`](libs/cua-spacesd/crates/cua-spacesd-server/README.md#tests).
+See [`crates/cua-spacesd-server/README.md`](../../libs/cua-spacesd/crates/cua-spacesd-server/README.md#tests).
## TypeScript
@@ -122,7 +122,7 @@ cargo test -p cua-driver --test protocol_schema_test --locked
Linux source and package checks run through Nix. Windows and Linux compile gates
are split into OS-specific workflows. See
-[`libs/cua-driver/rust/README.md`](libs/cua-driver/rust/README.md) for workspace
+[`libs/cua-driver/rust/README.md`](../../libs/cua-driver/rust/README.md) for workspace
commands.
Unit and protocol tests do not prove that desktop input reached a real
@@ -156,8 +156,8 @@ undeclared outcomes, and incomplete required evidence.
See:
-- [`libs/cua-driver/docs/test-harnesses-guide.md`](libs/cua-driver/docs/test-harnesses-guide.md)
-- [`libs/cua-driver/docs/test-matrix.md`](libs/cua-driver/docs/test-matrix.md)
+- [`libs/cua-driver/docs/test-harnesses-guide.md`](../../libs/cua-driver/docs/test-harnesses-guide.md)
+- [`libs/cua-driver/docs/test-matrix.md`](../../libs/cua-driver/docs/test-matrix.md)
- [Platform support and validation](https://cua.ai/docs/cua-driver/concepts/platform-support)
## Lume
@@ -169,7 +169,7 @@ swift test
```
VM-dependent and unattended-setup checks have additional prerequisites in
-[`libs/lume/Development.md`](libs/lume/Development.md).
+[`libs/lume/Development.md`](../../libs/lume/Development.md).
## Public Documentation
@@ -190,7 +190,7 @@ config lanes); the runnable blocks run with
`python3 tests/e2e/cua-sdk/run.py --lanes docs --langs py --strict`. Generated
reference changes also run the owning generator's check (`pnpm docs:check:<name>`,
listed by `pnpm docs:list`); `pnpm docs:check` is the explicit full audit. See
-[`docs/README.md`](docs/README.md) for details.
+[`docs/README.md`](../README.md) for details.
## Before Opening a Pull Request
diff --git a/rfcs/0000-template.md b/docs/rfcs/0000-template.md
similarity index 100%
rename from rfcs/0000-template.md
rename to docs/rfcs/0000-template.md
diff --git a/rfcs/2447-cua-driver-native-core-and-mcp-adapter.md b/docs/rfcs/2447-cua-driver-native-core-and-mcp-adapter.md
similarity index 100%
rename from rfcs/2447-cua-driver-native-core-and-mcp-adapter.md
rename to docs/rfcs/2447-cua-driver-native-core-and-mcp-adapter.md
diff --git a/rfcs/2447/architecture-overview.png b/docs/rfcs/2447/architecture-overview.png
similarity index 100%
rename from rfcs/2447/architecture-overview.png
rename to docs/rfcs/2447/architecture-overview.png
diff --git a/rfcs/2447/lifecycle-modes.png b/docs/rfcs/2447/lifecycle-modes.png
similarity index 100%
rename from rfcs/2447/lifecycle-modes.png
rename to docs/rfcs/2447/lifecycle-modes.png
diff --git a/rfcs/2512-cua-driver-environment-convergence.md b/docs/rfcs/2512-cua-driver-environment-convergence.md
similarity index 100%
rename from rfcs/2512-cua-driver-environment-convergence.md
rename to docs/rfcs/2512-cua-driver-environment-convergence.md
diff --git a/rfcs/2512-mcp-envelope-carrier.md b/docs/rfcs/2512-mcp-envelope-carrier.md
similarity index 100%
rename from rfcs/2512-mcp-envelope-carrier.md
rename to docs/rfcs/2512-mcp-envelope-carrier.md
diff --git a/rfcs/2512-python-fleet-first-slice.md b/docs/rfcs/2512-python-fleet-first-slice.md
similarity index 100%
rename from rfcs/2512-python-fleet-first-slice.md
rename to docs/rfcs/2512-python-fleet-first-slice.md
diff --git a/rfcs/2512-shared-driver-mcp-client.md b/docs/rfcs/2512-shared-driver-mcp-client.md
similarity index 100%
rename from rfcs/2512-shared-driver-mcp-client.md
rename to docs/rfcs/2512-shared-driver-mcp-client.md
diff --git a/rfcs/2549-cua-driver-sdk-owned-runtime.md b/docs/rfcs/2549-cua-driver-sdk-owned-runtime.md
similarity index 99%
rename from rfcs/2549-cua-driver-sdk-owned-runtime.md
rename to docs/rfcs/2549-cua-driver-sdk-owned-runtime.md
index 8139d60133..f8d4d260fd 100644
--- a/rfcs/2549-cua-driver-sdk-owned-runtime.md
+++ b/docs/rfcs/2549-cua-driver-sdk-owned-runtime.md
@@ -217,12 +217,12 @@ behavior while session authorization is introduced.
### The typed SDK already owns a native runtime
-[`CuaDriver::create`](../libs/cua-driver/rust/crates/cua-driver-sdk/src/lib.rs)
+[`CuaDriver::create`](../../libs/cua-driver/rust/crates/cua-driver-sdk/src/lib.rs)
constructs `NativeAbiDriver` in the importing process. It launches no driver
executable and opens no daemon socket.
The same SDK retains
-[`CuaDriver::connect`](../libs/cua-driver/rust/crates/cua-driver-sdk/src/lib.rs)
+[`CuaDriver::connect`](../../libs/cua-driver/rust/crates/cua-driver-sdk/src/lib.rs)
as a compatibility client for the installed daemon. Both paths expose the same
typed methods.
@@ -257,7 +257,7 @@ host application's macOS responsibility chain when it needs an external MCP
endpoint or process separation.
The preferred application path in
-[the embedding guide](../libs/cua-driver/rust/Skills/cua-driver/EMBEDDING.md)
+[the embedding guide](../../libs/cua-driver/rust/Skills/cua-driver/EMBEDDING.md)
is already direct SDK creation.
### Some state remains process-global
diff --git a/rfcs/3007-cua-driver-lifecycle-sessions.md b/docs/rfcs/3007-cua-driver-lifecycle-sessions.md
similarity index 99%
rename from rfcs/3007-cua-driver-lifecycle-sessions.md
rename to docs/rfcs/3007-cua-driver-lifecycle-sessions.md
index 797f801cfe..f242e7e4cb 100644
--- a/rfcs/3007-cua-driver-lifecycle-sessions.md
+++ b/docs/rfcs/3007-cua-driver-lifecycle-sessions.md
@@ -141,11 +141,11 @@ The public session contract currently exposes four tools:
The contract describes escalation as permanent and tells callers to end the
session and start a new ID to recover window scope. The implementation is in
-[`session_tools.rs`](../libs/cua-driver/rust/crates/cua-driver-core/src/session_tools.rs),
+[`session_tools.rs`](../../libs/cua-driver/rust/crates/cua-driver-core/src/session_tools.rs),
with public definitions in
-[`session.rs`](../libs/cua-driver/rust/crates/cua-driver-contract/src/session.rs)
+[`session.rs`](../../libs/cua-driver/rust/crates/cua-driver-contract/src/session.rs)
and capture gating in
-[`capture_scope.rs`](../libs/cua-driver/rust/crates/cua-driver-core/src/capture_scope.rs).
+[`capture_scope.rs`](../../libs/cua-driver/rust/crates/cua-driver-core/src/capture_scope.rs).
RFC 2549 already establishes runtime generations, trusted host leases,
authenticated action connections, and the rule that a public session ID cannot
diff --git a/rfcs/3096-immutable-nightly-release-channels.md b/docs/rfcs/3096-immutable-nightly-release-channels.md
similarity index 99%
rename from rfcs/3096-immutable-nightly-release-channels.md
rename to docs/rfcs/3096-immutable-nightly-release-channels.md
index 10def65f06..4ada34bb04 100644
--- a/rfcs/3096-immutable-nightly-release-channels.md
+++ b/docs/rfcs/3096-immutable-nightly-release-channels.md
@@ -82,7 +82,7 @@ published-version pointers.
## Current state
Release Please owns independent Cua Driver and Lume stable versions in
-[`release-please-config.json`](../release-please-config.json). Cua Driver's
+[`release-please-config.json`](../../release-please-config.json). Cua Driver's
cross-platform workflow builds candidates on a stable tag and publishes from
that same tag run after its automatic desktop E2E gate passes. Lume signs,
notarizes, and publishes after a stable tag.
diff --git a/rfcs/3101-persistent-release-channel-selection.md b/docs/rfcs/3101-persistent-release-channel-selection.md
similarity index 100%
rename from rfcs/3101-persistent-release-channel-selection.md
rename to docs/rfcs/3101-persistent-release-channel-selection.md
diff --git a/rfcs/3197-local-modern-mcp-and-skills.md b/docs/rfcs/3197-local-modern-mcp-and-skills.md
similarity index 96%
rename from rfcs/3197-local-modern-mcp-and-skills.md
rename to docs/rfcs/3197-local-modern-mcp-and-skills.md
index 28ea0f7c5e..0029b539dc 100644
--- a/rfcs/3197-local-modern-mcp-and-skills.md
+++ b/docs/rfcs/3197-local-modern-mcp-and-skills.md
@@ -60,12 +60,12 @@ activation, and permission decisions.
## Current state
-The shared [dispatcher](../libs/cua-driver/rust/crates/cua-driver-core/src/server.rs)
-and [stdio adapter](../libs/cua-driver/rust/crates/cua-driver/src/proxy.rs) own MCP
+The shared [dispatcher](../../libs/cua-driver/rust/crates/cua-driver-core/src/server.rs)
+and [stdio adapter](../../libs/cua-driver/rust/crates/cua-driver/src/proxy.rs) own MCP
translation. The SDK and daemon own execution. The
-[HTTP adapter](../libs/cua-driver/rust/crates/cua-driver/src/mcp_http.rs) binds
+[HTTP adapter](../../libs/cua-driver/rust/crates/cua-driver/src/mcp_http.rs) binds
session ownership to each TCP connection. The eight-file
-[canonical skill](../libs/cua-driver/rust/Skills/cua-driver/SKILL.md) is already
+[canonical skill](../../libs/cua-driver/rust/Skills/cua-driver/SKILL.md) is already
versioned with Driver releases.
## Proposal
diff --git a/rfcs/3550-hyprland-isolated-input.md b/docs/rfcs/3550-hyprland-isolated-input.md
similarity index 99%
rename from rfcs/3550-hyprland-isolated-input.md
rename to docs/rfcs/3550-hyprland-isolated-input.md
index aa9766482b..0bd5499c20 100644
--- a/rfcs/3550-hyprland-isolated-input.md
+++ b/docs/rfcs/3550-hyprland-isolated-input.md
@@ -201,7 +201,7 @@ target resolution, Linux adapter, optional plugin, selected application.
| Hyprland plugin | Live target identity and geometry, two independently owned lanes, technical target lifetime and conflict checks, bounded dispatch, and synthetic-state cleanup. |
| Application fixture/harness | Independent evidence of target effects and absence of foreground side effects. |
-The [shared permission stack](../libs/cua-driver/rust/crates/cua-driver-core/src/session_authorization.rs)
+The [shared permission stack](../../libs/cua-driver/rust/crates/cua-driver-core/src/session_authorization.rs)
remains binding. Standard and unrestricted desktop
input without a manifest require no protected per-window grant. Unrestricted
retains its explicit launch acknowledgement. Bounded requires an approved
@@ -393,7 +393,7 @@ Keep three facts separate: receipt by the transport, dispatch by the
compositor, and application effect established through independent readback.
An emitted-event count is dispatch evidence, not accepted-input evidence.
-Map into the existing [action-result contract](../libs/cua-driver/docs/action-result-contract.md).
+Map into the existing [action-result contract](../../libs/cua-driver/docs/action-result-contract.md).
Use the shared `synthetic_events` route where applicable; do not add a
Hyprland-specific value to the public closed route enum. Dispatch alone is
`unverifiable`, not `confirmed`; partial operations retain acknowledged counts.
@@ -566,8 +566,8 @@ physical Omarchy gate; label Fleet evidence accurately until then.
## Test and acceptance plan
Use the canonical commands in
-[the test-harnesses guide](../libs/cua-driver/docs/test-harnesses-guide.md) and
-[CI guidance](../scripts/ci/README.md). A Hyprland lane must extend the shared
+[the test-harnesses guide](../../libs/cua-driver/docs/test-harnesses-guide.md) and
+[CI guidance](../../scripts/ci/README.md). A Hyprland lane must extend the shared
typed catalog, not replace it with an unrelated scripted demo. Do not assume
an unmerged PR's runner is present on main.
@@ -591,7 +591,7 @@ cleanup. Retain focused proof of the supported operations and two-lane behavior
being promoted. An uninstrumented smoke without plugin transport attribution
cannot prove continuous isolation, and an all-refusal canonical result cannot
replace positive delivery evidence. The
-[production proof guide](../libs/cua-driver/hyprland-plugin/docs/production-proof.md)
+[production proof guide](../../libs/cua-driver/hyprland-plugin/docs/production-proof.md)
documents the bounded plans and their limits.
Three whole repetitions of the long Python Calc/Inkscape plan, including 34
diff --git a/rfcs/3682-typed-native-window-sdk.md b/docs/rfcs/3682-typed-native-window-sdk.md
similarity index 100%
rename from rfcs/3682-typed-native-window-sdk.md
rename to docs/rfcs/3682-typed-native-window-sdk.md
diff --git a/rfcs/3931-cua-perception-and-jev-use.md b/docs/rfcs/3931-cua-perception-and-jev-use.md
similarity index 100%
rename from rfcs/3931-cua-perception-and-jev-use.md
rename to docs/rfcs/3931-cua-perception-and-jev-use.md
diff --git a/rfcs/4268-jev-use-native-candidates.md b/docs/rfcs/4268-jev-use-native-candidates.md
similarity index 98%
rename from rfcs/4268-jev-use-native-candidates.md
rename to docs/rfcs/4268-jev-use-native-candidates.md
index 94ac4be451..e513a0cfcd 100644
--- a/rfcs/4268-jev-use-native-candidates.md
+++ b/docs/rfcs/4268-jev-use-native-candidates.md
@@ -125,10 +125,10 @@ and capture-bound clicks) describe the same moment.
### jev-use structure
The runnable reference lives in
-[`libs/cua-driver/examples/jev-use/`](../libs/cua-driver/examples/jev-use/).
-[`python/core.py`](../libs/cua-driver/examples/jev-use/python/core.py) and its
+[`libs/cua-driver/examples/jev-use/`](../../libs/cua-driver/examples/jev-use/).
+[`python/core.py`](../../libs/cua-driver/examples/jev-use/python/core.py) and its
TypeScript mirror
-[`typescript/core.ts`](../libs/cua-driver/examples/jev-use/typescript/core.ts)
+[`typescript/core.ts`](../../libs/cua-driver/examples/jev-use/typescript/core.ts)
define:
- `Candidate`: `id`, `description`, `tool` (`None` for reserved candidates),
@@ -151,8 +151,8 @@ define:
- `classify`: maps the fixture server's `submitted` value to `verified`,
`refuted`, `budget_exhausted`, or `unknown`.
-[`python/run.py`](../libs/cua-driver/examples/jev-use/python/run.py) and
-[`typescript/run.ts`](../libs/cua-driver/examples/jev-use/typescript/run.ts)
+[`python/run.py`](../../libs/cua-driver/examples/jev-use/python/run.py) and
+[`typescript/run.ts`](../../libs/cua-driver/examples/jev-use/typescript/run.ts)
call these Driver tools over MCP:
| Tool | Use today |
@@ -174,18 +174,18 @@ explicitly.
### Chooser contract
-[`python/choose_action.py`](../libs/cua-driver/examples/jev-use/python/choose_action.py)
+[`python/choose_action.py`](../../libs/cua-driver/examples/jev-use/python/choose_action.py)
validates `cua.jev_choice_request_v1` strictly. The root must have exactly
`schema`, `goal`, `capture_id`, `regions`, `history`, and `candidates`. Each
candidate must have exactly `id` and `description`. IDs match
`[A-Za-z0-9][A-Za-z0-9._:-]{0,63}`, the set holds 2 to 32 candidates, and
`reobserve` and `abstain` are required. It answers with `cua.jev_choice_v1`.
-[`python/decision_models.py`](../libs/cua-driver/examples/jev-use/python/decision_models.py)
+[`python/decision_models.py`](../../libs/cua-driver/examples/jev-use/python/decision_models.py)
answers the same request with `cua.decision_choice_v1` (`kind`, `capture_id`,
`selected_id`, `model`, `confidence`, `probabilities`, `reason`). The S1
adapter supports at most 26 options, including the two reserved IDs, and
returns `reason: "option_limit"` instead of truncating
-([`decision-models.md`](../libs/cua-driver/examples/jev-use/decision-models.md)).
+([`decision-models.md`](../../libs/cua-driver/examples/jev-use/decision-models.md)).
Because v1 validators reject unknown keys, adding `source` to a v1 candidate
would break every existing v1 validator. The contract change must therefore be
@@ -195,7 +195,7 @@ a new request version, not an in-place field addition.
`get_window_state` returns a structured `elements` array. The contract type is
`WindowElement` in
-[`cua-driver-contract/src/windows.rs`](../libs/cua-driver/rust/crates/cua-driver-contract/src/windows.rs):
+[`cua-driver-contract/src/windows.rs`](../../libs/cua-driver/rust/crates/cua-driver-contract/src/windows.rs):
| Field | Type | Notes |
| ------------------- | -------------- | -------------------------------------------------------------------------------- |
@@ -226,8 +226,8 @@ Element tokens are validated by Driver. A new snapshot for the same
`(pid, window_id)` invalidates every token from the previous snapshot, and a
stale token returns the explicit error `element_token is stale; call
get_window_state again to refresh`
-([`cua-driver-core/src/element_token.rs`](../libs/cua-driver/rust/crates/cua-driver-core/src/element_token.rs),
-[`snapshot_invariants.rs`](../libs/cua-driver/rust/crates/cua-driver-core/tests/snapshot_invariants.rs)).
+([`cua-driver-core/src/element_token.rs`](../../libs/cua-driver/rust/crates/cua-driver-core/src/element_token.rs),
+[`snapshot_invariants.rs`](../../libs/cua-driver/rust/crates/cua-driver-core/tests/snapshot_invariants.rs)).
`click`, `type_text`, and `set_value` accept `element_token` on all three
platforms, and `click` accepts `delivery_mode`.
@@ -251,7 +251,7 @@ automation ID, then help text. Linux uses name, then description, and never
value; it marks a value control without a name as `unlabelled`.
Driver does have a private, partial normalizer, `normalized_role` in
-[`cua-driver-core/src/expectation.rs`](../libs/cua-driver/rust/crates/cua-driver-core/src/expectation.rs).
+[`cua-driver-core/src/expectation.rs`](../../libs/cua-driver/rust/crates/cua-driver-core/src/expectation.rs).
It keeps ASCII alphanumerics, lowercases, strips an `ax` prefix, and maps
`pushbutton` to `button` and `pagetab`/`tabitem` to `tab`. `verify_state`
uses it only to match `ElementSelector.role`. It unifies `AXCheckBox`,
diff --git a/rfcs/README.md b/docs/rfcs/README.md
similarity index 97%
rename from rfcs/README.md
rename to docs/rfcs/README.md
index aec9f997e5..a8a1573369 100644
--- a/rfcs/README.md
+++ b/docs/rfcs/README.md
@@ -32,7 +32,7 @@ which process holds a capability, what a permission prompt must state, which
data must not be collected or exposed, and how authorization appears in a
public contract. A vulnerability report describes a specific exploitable defect
in shipped Cua code or configuration. Design the boundary in public; report the
-defect privately through [`SECURITY.md`](../SECURITY.md).
+defect privately through [`SECURITY.md`](../../.github/SECURITY.md).
If a hardening proposal cannot be described without disclosing an exploitable
defect, report it privately first. Maintainers can open or unblock the public
@@ -41,7 +41,7 @@ RFC after remediation is coordinated.
## Repository structure
```text
-rfcs/
+docs/rfcs/
├── 0000-template.md
├── <issue>-<short-name>.md
└── <issue>/
@@ -50,7 +50,7 @@ rfcs/
```
The GitHub discussion issue number is the RFC identifier. For example, issue
-`#2447` owns `rfcs/2447-short-name.md` and the optional `rfcs/2447/` sidecar
+`#2447` owns `docs/rfcs/2447-short-name.md` and the optional `docs/rfcs/2447/` sidecar
directory. Relative asset links keep the proposal portable and reviewable on
GitHub.
diff --git a/examples/README.md b/examples/README.md
new file mode 100644
index 0000000000..1b844c95d3
--- /dev/null
+++ b/examples/README.md
@@ -0,0 +1,24 @@
+# Examples
+
+| Example | What it is |
+|---|---|
+| [`cua-bots-macos`](cua-bots-macos) | Cua Bots for macOS: persistent bots, each with a koala face, its own Space, a memory in the Cua Volume layout, routines, approvals, custom rules and saved sign-ins. SwiftUI on the Cua Swift SDK and the Cua Spaces app export. The featured example; source-available (FSL-1.1-MIT) |
+| [`cua-bots-ios`](cua-bots-ios) | Cua Bots for iPhone: a remote client for the Mac's bots; chat, watch and take over their computers, answer approvals, get notifications. Source-available (FSL-1.1-MIT) |
+| [`openkoalabot-example-swift`](openkoalabot-example-swift) | OpenKoalaBots, a chat app for agent coworkers on Cua Spaces: a SwiftUI app on the `Cua` package via the Swift overlay [`libs/spaces-sdk-swift`](../libs/spaces-sdk-swift) and `CuaSpacesStreaming` ([`libs/spaces-app-swift`](../libs/spaces-app-swift)). The first of the three; its 209-test suite and `RUBRIC.md` are the behaviour spec. Source-available (FSL-1.1-MIT) |
+| [`openkoalabot-example-tauri`](openkoalabot-example-tauri) | The same app as a Rust core on the `cua-spaces` crate, with a Tauri 2 + React shell |
+| [`openkoalabot-example-ts`](openkoalabot-example-ts) | The same app in TypeScript on `@trycua/cua`: a Node agent loop, a local server, and a web UI that streams through `@trycua/cua/browser` (gRPC-Web + the ticketed `/media` socket) and WebCodecs |
+| [`openkoalabot-example-scenario`](openkoalabot-example-scenario) | The shared, language-neutral scenario all three run headlessly: add or claim a Space, stream, run an agent thread (fake CLI), send a file, teleport a generated profile, run presence with two clients, release |
+| [`infinite-canvas-swift`](infinite-canvas-swift) | infinite-canvas: every window of every Space on one zoomable canvas, with agent and coworker cursors and agent threads. SwiftUI and AppKit on the Cua Swift packages. Source-available (FSL-1.1-MIT) |
+| [`driver`](driver) | cua-driver samples |
+| [`python`](python) | Python samples |
+| [`agents-in-sandboxes`](agents-in-sandboxes) | Run a coding-agent harness in a sandbox image over a task file, then collect verified results into a JSON report |
+| [`streaming`](streaming) | The same streaming scenario against a cua-spacesd in Python, Rust, Swift, Kotlin and TypeScript (Node and browser); see [`SCENARIO.md`](streaming/SCENARIO.md) |
+
+Run all three OpenKoalaBots examples against the same Space kinds:
+
+```sh
+examples/openkoalabot-example-scenario/run.sh --impl all --lane fixture # hermetic
+examples/openkoalabot-example-scenario/run.sh --impl all --lane docker # linux under gVisor, one container at a time
+```
+
+Each implementation's README has its build, test and run commands.
diff --git a/samples/cua-bots-ios/App/CuaBotsPhoneApp.swift b/examples/cua-bots-ios/App/CuaBotsPhoneApp.swift
similarity index 100%
rename from samples/cua-bots-ios/App/CuaBotsPhoneApp.swift
rename to examples/cua-bots-ios/App/CuaBotsPhoneApp.swift
diff --git a/benchmarks/cua-driver-bench/LICENSE b/examples/cua-bots-ios/LICENSE
similarity index 100%
rename from benchmarks/cua-driver-bench/LICENSE
rename to examples/cua-bots-ios/LICENSE
diff --git a/samples/cua-bots-ios/Package.swift b/examples/cua-bots-ios/Package.swift
similarity index 100%
rename from samples/cua-bots-ios/Package.swift
rename to examples/cua-bots-ios/Package.swift
diff --git a/examples/cua-bots-ios/README.md b/examples/cua-bots-ios/README.md
new file mode 100644
index 0000000000..ca5192f958
--- /dev/null
+++ b/examples/cua-bots-ios/README.md
@@ -0,0 +1,68 @@
+# Cua Bots (iPhone)
+
+The iPhone companion to [`../cua-bots-macos`](../cua-bots-macos): chat with
+your bots, watch and take over their computers, answer approvals, and get
+their notifications. It is a remote client: bots are created and run by the
+Mac app, and the phone reaches each bot's own Space.
+
+It builds on the macOS sample's package, which links Cua Spaces pieces, so it
+is source-available under the [FSL-1.1-MIT](LICENSE) too. See
+[LICENSING.md](../../legal/LICENSING.md).
+
+![Approving a purchase from the phone](../../docs/public/img/cua-bots/cua-bots-phone-approval.png)
+
+## How it connects
+
+The phone talks to the bot's Space through that Space's spacesd, with the Cua
+Swift SDK:
+
+| Need | Call |
+|---|---|
+| Reach the bot's computer | `Relay(relayUrl:accountToken:).connect(machineId:)` over the relay, or `Cua.spacesd(url:token:)` directly |
+| Find the bots in it | `SpacesdClient.sh` lists `~/bots/*/` |
+| Read the bot's state | `SpacesdClient.download(path:)` of `~/bots/<name>/.cua-bots/state.json`, which the Mac app writes |
+| Send a message, approve, pause, resume | `SpacesdClient.upload(path:data:options:)` into `~/bots/<name>/.cua-bots/outbox/`; the Mac applies it through the same calls its buttons make |
+| Stream its computer | `SpacesdClient.openMediaDecoded(options:frames:)` (BGRA frames, from `CuaSpacesFFI`) |
+| Take over | `SpacesdClient.click(x:y:)` and `typeText(text:)`: on the phone the computer opens in your control |
+| Notifications | new entries in the snapshot become local notifications |
+
+On the Mac, a bot's profile menu has **Pair iPhone**, which gives a
+`cuabots://direct?...` link for that bot's Space. On the same Mac (the iOS
+Simulator) the loopback address works.
+
+## Build
+
+The package (`CuaBotsRemote`, `CuaBotsPhone`) builds and tests on macOS:
+
+```sh
+(cd ../../libs/cua && cargo build --locked --release -p cua-sdk && node scripts/stage-uniffi-library.mjs --only=swift)
+swift build && scripts/test.sh
+```
+
+The iPhone app target is `App/` with an XcodeGen spec (`project.yml`). It needs
+Xcode 16 and the cua SDK XCFramework with iOS slices:
+
+```sh
+(cd ../../libs/cua/swift && scripts/build-xcframework.sh --ios)
+CUA_SWIFT_XCFRAMEWORK=build/CuaSDKFFI.xcframework xcodegen generate
+xcodebuild -scheme CuaBots -destination 'platform=iOS Simulator,name=iPhone 16' build
+```
+
+Without Xcode, `CuaBotsPhonePreview` shows the same screens in a phone-sized
+Mac window against a real bot (`CUA_BOTS_PREVIEW_SPACE=local:bot-ada`).
+
+## Gaps
+
+- **Reaching a bot from anywhere.** The relay publishes machines registered
+ with `cua host setup`; the SDK has no call to register a bot's own Space as
+ a relay machine, so a phone off the Mac's network can't reach it yet.
+- **State through the Space.** The snapshot and outbox live in the bot's
+ Space because the Cua Volume isn't reachable from a phone yet. With a cloud
+ Volume they move to `agents/<name>/`.
+- **Push.** Notifications arrive while the app is open; background push needs
+ a notification service.
+- **Keyvault.** Saved sign-ins are approved on the Mac (a Cua-signed app with
+ Touch ID); the phone offers take over instead.
+- **iOS SDK builds.** The cua SDK's iOS XCFramework slices are not exercised in
+ CI, and `spaces-sdk-swift` (the Mac's streaming views) is macOS only, so the
+ phone draws frames itself.
diff --git a/samples/cua-bots-ios/Sources/CuaBotsPhone/PhoneViews.swift b/examples/cua-bots-ios/Sources/CuaBotsPhone/PhoneViews.swift
similarity index 100%
rename from samples/cua-bots-ios/Sources/CuaBotsPhone/PhoneViews.swift
rename to examples/cua-bots-ios/Sources/CuaBotsPhone/PhoneViews.swift
diff --git a/samples/cua-bots-ios/Sources/CuaBotsPhonePreview/main.swift b/examples/cua-bots-ios/Sources/CuaBotsPhonePreview/main.swift
similarity index 100%
rename from samples/cua-bots-ios/Sources/CuaBotsPhonePreview/main.swift
rename to examples/cua-bots-ios/Sources/CuaBotsPhonePreview/main.swift
diff --git a/samples/cua-bots-ios/Sources/CuaBotsRemote/RemoteClient.swift b/examples/cua-bots-ios/Sources/CuaBotsRemote/RemoteClient.swift
similarity index 100%
rename from samples/cua-bots-ios/Sources/CuaBotsRemote/RemoteClient.swift
rename to examples/cua-bots-ios/Sources/CuaBotsRemote/RemoteClient.swift
diff --git a/samples/cua-bots-ios/Tests/CuaBotsRemoteTests/RemoteTests.swift b/examples/cua-bots-ios/Tests/CuaBotsRemoteTests/RemoteTests.swift
similarity index 100%
rename from samples/cua-bots-ios/Tests/CuaBotsRemoteTests/RemoteTests.swift
rename to examples/cua-bots-ios/Tests/CuaBotsRemoteTests/RemoteTests.swift
diff --git a/samples/cua-bots-ios/project.yml b/examples/cua-bots-ios/project.yml
similarity index 100%
rename from samples/cua-bots-ios/project.yml
rename to examples/cua-bots-ios/project.yml
diff --git a/samples/cua-bots-ios/scripts/test.sh b/examples/cua-bots-ios/scripts/test.sh
similarity index 100%
rename from samples/cua-bots-ios/scripts/test.sh
rename to examples/cua-bots-ios/scripts/test.sh
diff --git a/samples/cua-bots-ios/LICENSE b/examples/cua-bots-macos/LICENSE
similarity index 100%
rename from samples/cua-bots-ios/LICENSE
rename to examples/cua-bots-macos/LICENSE
diff --git a/samples/cua-bots-macos/Package.swift b/examples/cua-bots-macos/Package.swift
similarity index 100%
rename from samples/cua-bots-macos/Package.swift
rename to examples/cua-bots-macos/Package.swift
diff --git a/examples/cua-bots-macos/README.md b/examples/cua-bots-macos/README.md
new file mode 100644
index 0000000000..26cc6cab62
--- /dev/null
+++ b/examples/cua-bots-macos/README.md
@@ -0,0 +1,110 @@
+# Cua Bots (macOS)
+
+Persistent bots on Cua: each bot has a name, a koala face you design, its own
+computer (a Space), a memory that outlives that computer (Cua Volume), work it
+does on its own (routines), and rules for when it must ask you first. A
+SwiftUI app on the Cua Swift SDK (`Cua`, `CuaSpaces`) and the Cua Spaces
+Swift packages (`CuaSpacesFFI`, for saved sign-ins through the Cua Keyvault,
+and `CuaSpacesStreaming`, for the live view of a bot's computer). Its
+iPhone companion is [`../cua-bots-ios`](../cua-bots-ios).
+
+The sample links Cua Spaces pieces, so it is source-available under the
+[Functional Source License, Version 1.1, MIT Future License](LICENSE)
+(FSL-1.1-MIT), like Cua Spaces itself. See [LICENSING.md](../../legal/LICENSING.md).
+
+![Ada finished some research while you were away](../../docs/public/img/cua-bots/cua-bots-mac-research-ready.png)
+
+## Quick start
+
+```sh
+git clone https://github.com/trycua/cua && cd cua
+(cd libs/cua && cargo build --locked --release -p cua-spaces-ffi)
+libs/spaces-app-swift/scripts/stage-library.sh
+cd examples/cua-bots-macos
+swift build && .build/debug/CuaBots
+```
+
+`stage-library.sh` stages the Cua Spaces app export, which carries the MIT
+cua SDK too, where the Swift packages link it.
+
+A bot's agent needs a model key in the app's environment
+(`ANTHROPIC_API_KEY` for Claude Code, `OPENAI_API_KEY` for Codex; Hermes and
+OpenClaw take either). `CUA_BOTS_MODEL_URL`, `CUA_BOTS_MODEL` and
+`CUA_BOTS_MODEL_KEY_VARS` point every bot at another endpoint.
+`CUA_BOTS_OWNER` and `CUA_BOTS_DEVICE_NAME` set the name the bots use for you
+and the name shown for this Mac (default: your account and computer names).
+`CUA_BOTS_APPEARANCE=light` or `dark` pins the app's appearance (light is the
+design target; unset follows the system). Local Spaces
+need Docker (or Colima).
+
+## What maps to what
+
+| In the app | Cua underneath |
+|---|---|
+| New bot: name, look, where it runs, which agent | `Spaces.create` (`on: local` or `cloud`, `reuse`), one Space per bot named `bot-<name>`; `Space.agentStart` with the harness (`hermes`, `openclaw`, `openai-codex`, `claude-code`) |
+| The koala face and its expressions | `KoalaAvatar` (this sample), drawn from geometry derived from the Cua koala mark |
+| "Ada's computer", live, with picture in picture | `LiveStreamSession` and `StreamPiPController` (`CuaSpacesStreaming`) on the bot's Space |
+| Ada has control · Take over | the stream turns interactive and `agentInterrupt` pauses the turn |
+| Ada's face as her pointer | `SpacesdClient.cursorPosition()` |
+| Memory, outputs, inbox | Cua Volume layout `agents/<name>/` (`memory/MEMORY.md`, `outputs/`, `inbox/`), copied into the Space before a turn and back after it |
+| Works on its own | scheduled tasks on the SDK's routine clock (`RoutineStore`) |
+| Approvals and custom rules | `rules.yaml` and the instructions file in the bot's Volume home; the bot asks with `[[ask: ...]]`, the app answers in the conversation |
+| Log me into this site | `[[login: site]]`; a saved sign-in from the Cua Keyvault (`KeyvaultClient` from `CuaSpacesFFI`, `Space.teleport`), or take over and type it yourself |
+| Access to this Mac: Allow, Revoke | `Host.startSharing` / `Host.stopSharing` (`cua host`) |
+| Pause, Resume, Reset | interrupt the run and disarm routines (optionally `Sandbox.suspend`); reset stops the run, deletes the Space and the Volume home |
+| The iPhone app | the bot's snapshot and an outbox in its Space, read and written through spacesd (`RemoteBridge`) |
+
+## How a bot talks to the app
+
+The app writes the bot's standing instructions (`CLAUDE.md`, `SOUL.md` or
+`AGENTS.md`) into its home. They teach a few markers the app turns into UI and
+hides from the text:
+
+```text
+[[status: Checking inbox]] status under its name
+[[step: Read the docs]] [[step-done: ...]] Activity
+[[ask: Buy the desk | details]] an approval card
+[[handoff: Change the bank password]] you do it yourself
+[[login: github.com]] the sign-in card
+[[output: outputs/summary.md]] Outputs
+[[notify: Your research is ready | one line]] a notification
+[[schedule: daily 09:00 | title | what to do]] a routine
+[[done: Research standing desks]] a result card
+```
+
+The rules are instructions, not enforcement: the harness runs with its
+permissions auto-approved inside the bot's own Space. See the gaps below.
+
+## Tests and screenshots
+
+```sh
+scripts/test.sh # unit tests (swift-testing)
+scripts/capture.sh <out-dir> [<scratch-home>] [--phone]
+```
+
+`capture.sh` runs the app in a throwaway `HOME` with the file credential
+store, against a real local Space, with the scripted mock provider
+(`cua-mock-llm`, `scripts/demo-model.json`) behind the real harness. It
+photographs each surface with `screencapture -l` and deletes the Spaces it
+made. With `--phone` it also photographs the iPhone screens (in the macOS
+preview host) against the same bot.
+
+## Gaps
+
+What the sample does with today's primitives, and what needs core work:
+
+- Rules are guidance: agent runs auto-approve their own permissions. Enforced
+ approvals need the runner to route permission requests to the app.
+- The Volume is a folder in the app's data (`LocalVolume`) with the Cua
+ Volume layout and secret refusal. The SDK's `Spaces.volumeRead`,
+ `volumeWrite` and `volumeLs` reach the daemon's Cua Volume; the app doesn't
+ sync through them yet.
+- The routine clock runs in the app, so routines fire while it's open.
+- The app runs each bot with `Space.agentStart` and copies its home in and
+ out itself. The SDK's persistent agents (`Spaces.persistentAgentCreate`,
+ `persistentAgentSend`, `agentPause`, `agentResume`, `routineAdd`,
+ `notifications`) keep the home in the Cua Volume, with saves, routines and
+ notifications run by `cua daemon`; the app doesn't use them yet.
+- Host access is per account, not per bot.
+- Saved sign-ins need the Cua daemon's Keyvault and a Cua-signed app to
+ approve; this sample's build shows the request and falls back to take over.
diff --git a/samples/cua-bots-macos/Sources/CuaBotsCore/Avatar/BotAvatar.swift b/examples/cua-bots-macos/Sources/CuaBotsCore/Avatar/BotAvatar.swift
similarity index 100%
rename from samples/cua-bots-macos/Sources/CuaBotsCore/Avatar/BotAvatar.swift
rename to examples/cua-bots-macos/Sources/CuaBotsCore/Avatar/BotAvatar.swift
diff --git a/samples/cua-bots-macos/Sources/CuaBotsCore/Avatar/KoalaGeometry.swift b/examples/cua-bots-macos/Sources/CuaBotsCore/Avatar/KoalaGeometry.swift
similarity index 100%
rename from samples/cua-bots-macos/Sources/CuaBotsCore/Avatar/KoalaGeometry.swift
rename to examples/cua-bots-macos/Sources/CuaBotsCore/Avatar/KoalaGeometry.swift
diff --git a/samples/cua-bots-macos/Sources/CuaBotsCore/Avatar/SVGPath.swift b/examples/cua-bots-macos/Sources/CuaBotsCore/Avatar/SVGPath.swift
similarity index 100%
rename from samples/cua-bots-macos/Sources/CuaBotsCore/Avatar/SVGPath.swift
rename to examples/cua-bots-macos/Sources/CuaBotsCore/Avatar/SVGPath.swift
diff --git a/samples/cua-bots-macos/Sources/CuaBotsCore/Engine/BotEngine.swift b/examples/cua-bots-macos/Sources/CuaBotsCore/Engine/BotEngine.swift
similarity index 100%
rename from samples/cua-bots-macos/Sources/CuaBotsCore/Engine/BotEngine.swift
rename to examples/cua-bots-macos/Sources/CuaBotsCore/Engine/BotEngine.swift
diff --git a/samples/cua-bots-macos/Sources/CuaBotsCore/Model/Activity.swift b/examples/cua-bots-macos/Sources/CuaBotsCore/Model/Activity.swift
similarity index 100%
rename from samples/cua-bots-macos/Sources/CuaBotsCore/Model/Activity.swift
rename to examples/cua-bots-macos/Sources/CuaBotsCore/Model/Activity.swift
diff --git a/samples/cua-bots-macos/Sources/CuaBotsCore/Model/Bot.swift b/examples/cua-bots-macos/Sources/CuaBotsCore/Model/Bot.swift
similarity index 100%
rename from samples/cua-bots-macos/Sources/CuaBotsCore/Model/Bot.swift
rename to examples/cua-bots-macos/Sources/CuaBotsCore/Model/Bot.swift
diff --git a/samples/cua-bots-macos/Sources/CuaBotsCore/Model/Directives.swift b/examples/cua-bots-macos/Sources/CuaBotsCore/Model/Directives.swift
similarity index 100%
rename from samples/cua-bots-macos/Sources/CuaBotsCore/Model/Directives.swift
rename to examples/cua-bots-macos/Sources/CuaBotsCore/Model/Directives.swift
diff --git a/samples/cua-bots-macos/Sources/CuaBotsCore/Model/Rules.swift b/examples/cua-bots-macos/Sources/CuaBotsCore/Model/Rules.swift
similarity index 100%
rename from samples/cua-bots-macos/Sources/CuaBotsCore/Model/Rules.swift
rename to examples/cua-bots-macos/Sources/CuaBotsCore/Model/Rules.swift
diff --git a/samples/cua-bots-macos/Sources/CuaBotsCore/Store/BotStore.swift b/examples/cua-bots-macos/Sources/CuaBotsCore/Store/BotStore.swift
similarity index 100%
rename from samples/cua-bots-macos/Sources/CuaBotsCore/Store/BotStore.swift
rename to examples/cua-bots-macos/Sources/CuaBotsCore/Store/BotStore.swift
diff --git a/samples/cua-bots-macos/Sources/CuaBotsCore/Store/Remote.swift b/examples/cua-bots-macos/Sources/CuaBotsCore/Store/Remote.swift
similarity index 100%
rename from samples/cua-bots-macos/Sources/CuaBotsCore/Store/Remote.swift
rename to examples/cua-bots-macos/Sources/CuaBotsCore/Store/Remote.swift
diff --git a/samples/cua-bots-macos/Sources/CuaBotsCore/Volume/Volume.swift b/examples/cua-bots-macos/Sources/CuaBotsCore/Volume/Volume.swift
similarity index 100%
rename from samples/cua-bots-macos/Sources/CuaBotsCore/Volume/Volume.swift
rename to examples/cua-bots-macos/Sources/CuaBotsCore/Volume/Volume.swift
diff --git a/samples/cua-bots-macos/Sources/CuaBotsCua/CuaEngine.swift b/examples/cua-bots-macos/Sources/CuaBotsCua/CuaEngine.swift
similarity index 100%
rename from samples/cua-bots-macos/Sources/CuaBotsCua/CuaEngine.swift
rename to examples/cua-bots-macos/Sources/CuaBotsCua/CuaEngine.swift
diff --git a/samples/cua-bots-macos/Sources/CuaBotsCua/Keyvault.swift b/examples/cua-bots-macos/Sources/CuaBotsCua/Keyvault.swift
similarity index 100%
rename from samples/cua-bots-macos/Sources/CuaBotsCua/Keyvault.swift
rename to examples/cua-bots-macos/Sources/CuaBotsCua/Keyvault.swift
diff --git a/samples/cua-bots-macos/Sources/CuaBotsCua/RemoteBridge.swift b/examples/cua-bots-macos/Sources/CuaBotsCua/RemoteBridge.swift
similarity index 100%
rename from samples/cua-bots-macos/Sources/CuaBotsCua/RemoteBridge.swift
rename to examples/cua-bots-macos/Sources/CuaBotsCua/RemoteBridge.swift
diff --git a/samples/cua-bots-macos/Sources/CuaBotsCua/RoutineClock.swift b/examples/cua-bots-macos/Sources/CuaBotsCua/RoutineClock.swift
similarity index 100%
rename from samples/cua-bots-macos/Sources/CuaBotsCua/RoutineClock.swift
rename to examples/cua-bots-macos/Sources/CuaBotsCua/RoutineClock.swift
diff --git a/samples/cua-bots-macos/Sources/CuaBotsMac/AppModel.swift b/examples/cua-bots-macos/Sources/CuaBotsMac/AppModel.swift
similarity index 100%
rename from samples/cua-bots-macos/Sources/CuaBotsMac/AppModel.swift
rename to examples/cua-bots-macos/Sources/CuaBotsMac/AppModel.swift
diff --git a/samples/cua-bots-macos/Sources/CuaBotsMac/CaptureTour.swift b/examples/cua-bots-macos/Sources/CuaBotsMac/CaptureTour.swift
similarity index 100%
rename from samples/cua-bots-macos/Sources/CuaBotsMac/CaptureTour.swift
rename to examples/cua-bots-macos/Sources/CuaBotsMac/CaptureTour.swift
diff --git a/samples/cua-bots-macos/Sources/CuaBotsMac/ChatView.swift b/examples/cua-bots-macos/Sources/CuaBotsMac/ChatView.swift
similarity index 100%
rename from samples/cua-bots-macos/Sources/CuaBotsMac/ChatView.swift
rename to examples/cua-bots-macos/Sources/CuaBotsMac/ChatView.swift
diff --git a/samples/cua-bots-macos/Sources/CuaBotsMac/ComputerPane.swift b/examples/cua-bots-macos/Sources/CuaBotsMac/ComputerPane.swift
similarity index 100%
rename from samples/cua-bots-macos/Sources/CuaBotsMac/ComputerPane.swift
rename to examples/cua-bots-macos/Sources/CuaBotsMac/ComputerPane.swift
diff --git a/samples/cua-bots-macos/Sources/CuaBotsMac/CuaBotsApp.swift b/examples/cua-bots-macos/Sources/CuaBotsMac/CuaBotsApp.swift
similarity index 100%
rename from samples/cua-bots-macos/Sources/CuaBotsMac/CuaBotsApp.swift
rename to examples/cua-bots-macos/Sources/CuaBotsMac/CuaBotsApp.swift
diff --git a/samples/cua-bots-macos/Sources/CuaBotsMac/NewBotView.swift b/examples/cua-bots-macos/Sources/CuaBotsMac/NewBotView.swift
similarity index 100%
rename from samples/cua-bots-macos/Sources/CuaBotsMac/NewBotView.swift
rename to examples/cua-bots-macos/Sources/CuaBotsMac/NewBotView.swift
diff --git a/samples/cua-bots-macos/Sources/CuaBotsMac/ProfilePanel.swift b/examples/cua-bots-macos/Sources/CuaBotsMac/ProfilePanel.swift
similarity index 100%
rename from samples/cua-bots-macos/Sources/CuaBotsMac/ProfilePanel.swift
rename to examples/cua-bots-macos/Sources/CuaBotsMac/ProfilePanel.swift
diff --git a/samples/cua-bots-macos/Sources/CuaBotsMac/RootView.swift b/examples/cua-bots-macos/Sources/CuaBotsMac/RootView.swift
similarity index 100%
rename from samples/cua-bots-macos/Sources/CuaBotsMac/RootView.swift
rename to examples/cua-bots-macos/Sources/CuaBotsMac/RootView.swift
diff --git a/samples/cua-bots-macos/Sources/CuaBotsMac/Sheets.swift b/examples/cua-bots-macos/Sources/CuaBotsMac/Sheets.swift
similarity index 100%
rename from samples/cua-bots-macos/Sources/CuaBotsMac/Sheets.swift
rename to examples/cua-bots-macos/Sources/CuaBotsMac/Sheets.swift
diff --git a/samples/cua-bots-macos/Sources/CuaBotsMac/WorkViews.swift b/examples/cua-bots-macos/Sources/CuaBotsMac/WorkViews.swift
similarity index 100%
rename from samples/cua-bots-macos/Sources/CuaBotsMac/WorkViews.swift
rename to examples/cua-bots-macos/Sources/CuaBotsMac/WorkViews.swift
diff --git a/samples/cua-bots-macos/Sources/CuaBotsUI/Components.swift b/examples/cua-bots-macos/Sources/CuaBotsUI/Components.swift
similarity index 100%
rename from samples/cua-bots-macos/Sources/CuaBotsUI/Components.swift
rename to examples/cua-bots-macos/Sources/CuaBotsUI/Components.swift
diff --git a/samples/cua-bots-macos/Tests/CuaBotsCoreTests/CoreTests.swift b/examples/cua-bots-macos/Tests/CuaBotsCoreTests/CoreTests.swift
similarity index 100%
rename from samples/cua-bots-macos/Tests/CuaBotsCoreTests/CoreTests.swift
rename to examples/cua-bots-macos/Tests/CuaBotsCoreTests/CoreTests.swift
diff --git a/samples/cua-bots-macos/scripts/capture.sh b/examples/cua-bots-macos/scripts/capture.sh
similarity index 100%
rename from samples/cua-bots-macos/scripts/capture.sh
rename to examples/cua-bots-macos/scripts/capture.sh
diff --git a/samples/cua-bots-macos/scripts/demo-model.json b/examples/cua-bots-macos/scripts/demo-model.json
similarity index 100%
rename from samples/cua-bots-macos/scripts/demo-model.json
rename to examples/cua-bots-macos/scripts/demo-model.json
diff --git a/samples/cua-bots-macos/scripts/gen-koala-geometry.py b/examples/cua-bots-macos/scripts/gen-koala-geometry.py
similarity index 100%
rename from samples/cua-bots-macos/scripts/gen-koala-geometry.py
rename to examples/cua-bots-macos/scripts/gen-koala-geometry.py
diff --git a/samples/cua-bots-macos/scripts/test.sh b/examples/cua-bots-macos/scripts/test.sh
similarity index 100%
rename from samples/cua-bots-macos/scripts/test.sh
rename to examples/cua-bots-macos/scripts/test.sh
diff --git a/samples/driver/jukebox/Cargo.lock b/examples/driver/jukebox/Cargo.lock
similarity index 100%
rename from samples/driver/jukebox/Cargo.lock
rename to examples/driver/jukebox/Cargo.lock
diff --git a/samples/driver/jukebox/Cargo.toml b/examples/driver/jukebox/Cargo.toml
similarity index 100%
rename from samples/driver/jukebox/Cargo.toml
rename to examples/driver/jukebox/Cargo.toml
diff --git a/samples/driver/jukebox/README.md b/examples/driver/jukebox/README.md
similarity index 100%
rename from samples/driver/jukebox/README.md
rename to examples/driver/jukebox/README.md
diff --git a/samples/driver/jukebox/app/Cargo.toml b/examples/driver/jukebox/app/Cargo.toml
similarity index 100%
rename from samples/driver/jukebox/app/Cargo.toml
rename to examples/driver/jukebox/app/Cargo.toml
diff --git a/samples/driver/jukebox/app/src/main.rs b/examples/driver/jukebox/app/src/main.rs
similarity index 100%
rename from samples/driver/jukebox/app/src/main.rs
rename to examples/driver/jukebox/app/src/main.rs
diff --git a/samples/driver/jukebox/orchestrator/Cargo.toml b/examples/driver/jukebox/orchestrator/Cargo.toml
similarity index 100%
rename from samples/driver/jukebox/orchestrator/Cargo.toml
rename to examples/driver/jukebox/orchestrator/Cargo.toml
diff --git a/samples/driver/jukebox/orchestrator/src/main.rs b/examples/driver/jukebox/orchestrator/src/main.rs
similarity index 100%
rename from samples/driver/jukebox/orchestrator/src/main.rs
rename to examples/driver/jukebox/orchestrator/src/main.rs
diff --git a/samples/driver/multi-cursor/.gitignore b/examples/driver/multi-cursor/.gitignore
similarity index 100%
rename from samples/driver/multi-cursor/.gitignore
rename to examples/driver/multi-cursor/.gitignore
diff --git a/samples/driver/multi-cursor/Cargo.lock b/examples/driver/multi-cursor/Cargo.lock
similarity index 100%
rename from samples/driver/multi-cursor/Cargo.lock
rename to examples/driver/multi-cursor/Cargo.lock
diff --git a/samples/driver/multi-cursor/Cargo.toml b/examples/driver/multi-cursor/Cargo.toml
similarity index 100%
rename from samples/driver/multi-cursor/Cargo.toml
rename to examples/driver/multi-cursor/Cargo.toml
diff --git a/samples/driver/multi-cursor/README.md b/examples/driver/multi-cursor/README.md
similarity index 100%
rename from samples/driver/multi-cursor/README.md
rename to examples/driver/multi-cursor/README.md
diff --git a/samples/driver/multi-cursor/dotnet/winforms/Program.cs b/examples/driver/multi-cursor/dotnet/winforms/Program.cs
similarity index 100%
rename from samples/driver/multi-cursor/dotnet/winforms/Program.cs
rename to examples/driver/multi-cursor/dotnet/winforms/Program.cs
diff --git a/samples/driver/multi-cursor/dotnet/winforms/winforms.csproj b/examples/driver/multi-cursor/dotnet/winforms/winforms.csproj
similarity index 100%
rename from samples/driver/multi-cursor/dotnet/winforms/winforms.csproj
rename to examples/driver/multi-cursor/dotnet/winforms/winforms.csproj
diff --git a/samples/driver/multi-cursor/dotnet/wpf/Program.cs b/examples/driver/multi-cursor/dotnet/wpf/Program.cs
similarity index 100%
rename from samples/driver/multi-cursor/dotnet/wpf/Program.cs
rename to examples/driver/multi-cursor/dotnet/wpf/Program.cs
diff --git a/samples/driver/multi-cursor/dotnet/wpf/wpf.csproj b/examples/driver/multi-cursor/dotnet/wpf/wpf.csproj
similarity index 100%
rename from samples/driver/multi-cursor/dotnet/wpf/wpf.csproj
rename to examples/driver/multi-cursor/dotnet/wpf/wpf.csproj
diff --git a/samples/driver/multi-cursor/electron/index.html b/examples/driver/multi-cursor/electron/index.html
similarity index 100%
rename from samples/driver/multi-cursor/electron/index.html
rename to examples/driver/multi-cursor/electron/index.html
diff --git a/samples/driver/multi-cursor/electron/main.js b/examples/driver/multi-cursor/electron/main.js
similarity index 100%
rename from samples/driver/multi-cursor/electron/main.js
rename to examples/driver/multi-cursor/electron/main.js
diff --git a/samples/driver/multi-cursor/electron/package.json b/examples/driver/multi-cursor/electron/package.json
similarity index 100%
rename from samples/driver/multi-cursor/electron/package.json
rename to examples/driver/multi-cursor/electron/package.json
diff --git a/samples/driver/multi-cursor/legacy-app/Cargo.toml b/examples/driver/multi-cursor/legacy-app/Cargo.toml
similarity index 100%
rename from samples/driver/multi-cursor/legacy-app/Cargo.toml
rename to examples/driver/multi-cursor/legacy-app/Cargo.toml
diff --git a/samples/driver/multi-cursor/legacy-app/src/main.rs b/examples/driver/multi-cursor/legacy-app/src/main.rs
similarity index 100%
rename from samples/driver/multi-cursor/legacy-app/src/main.rs
rename to examples/driver/multi-cursor/legacy-app/src/main.rs
diff --git a/samples/driver/multi-cursor/orchestrator/Cargo.toml b/examples/driver/multi-cursor/orchestrator/Cargo.toml
similarity index 100%
rename from samples/driver/multi-cursor/orchestrator/Cargo.toml
rename to examples/driver/multi-cursor/orchestrator/Cargo.toml
diff --git a/samples/driver/multi-cursor/orchestrator/src/main.rs b/examples/driver/multi-cursor/orchestrator/src/main.rs
similarity index 100%
rename from samples/driver/multi-cursor/orchestrator/src/main.rs
rename to examples/driver/multi-cursor/orchestrator/src/main.rs
diff --git a/samples/infinite-canvas-swift/.gitignore b/examples/infinite-canvas-swift/.gitignore
similarity index 100%
rename from samples/infinite-canvas-swift/.gitignore
rename to examples/infinite-canvas-swift/.gitignore
diff --git a/samples/cua-bots-macos/LICENSE b/examples/infinite-canvas-swift/LICENSE
similarity index 100%
rename from samples/cua-bots-macos/LICENSE
rename to examples/infinite-canvas-swift/LICENSE
diff --git a/samples/infinite-canvas-swift/Package.swift b/examples/infinite-canvas-swift/Package.swift
similarity index 100%
rename from samples/infinite-canvas-swift/Package.swift
rename to examples/infinite-canvas-swift/Package.swift
diff --git a/examples/infinite-canvas-swift/README.md b/examples/infinite-canvas-swift/README.md
new file mode 100644
index 0000000000..cf22db5f1b
--- /dev/null
+++ b/examples/infinite-canvas-swift/README.md
@@ -0,0 +1,152 @@
+# infinite-canvas (Swift)
+
+Every window of every Space on one zoomable canvas. A global hotkey opens it;
+each window is a live tile you can move, resize, zoom into and use. Agent and
+coworker cursors show up over the windows they act in, and agent threads are
+canvas windows of their own. Inspired by Zsolt Kacso's
+[infinite canvas for Omarchy](https://x.com/kaolti/status/2103257208616104111).
+
+SwiftUI and AppKit on the Cua Swift packages (`Cua`, `CuaSpaces`,
+`CuaSpacesStreaming`), macOS 26 (Liquid Glass).
+
+The sample links Cua Spaces pieces (`CuaSpacesStreaming`, in
+[`libs/spaces-app-swift`](../../libs/spaces-app-swift)), so it is
+source-available under the
+[Functional Source License, Version 1.1, MIT Future License](LICENSE)
+(FSL-1.1-MIT), like Cua Spaces itself. See [LICENSING.md](../../legal/LICENSING.md).
+
+## Run
+
+```sh
+(cd ../../libs/cua && cargo build --release -p cua-sdk && node scripts/stage-uniffi-library.mjs --only=swift)
+swift build -c release
+.build/release/infinite-canvas --spaces spaces.json --show
+```
+
+`spaces.json`:
+
+```json
+{
+ "spaces": [
+ {"label": "macOS", "os": "macos", "url": "http://192.168.64.2:3211", "token": "…", "maxWindows": 4,
+ "apps": ["Calculator", "TextEdit"]},
+ {"label": "Linux", "os": "linux", "url": "127.0.0.1:3211", "token": "…", "maxWindows": 4,
+ "agent": {"harness": "claude-code", "env": {"ANTHROPIC_API_KEY": "…"}}}
+ ],
+ "threads": ["Linux"]
+}
+```
+
+Every Space is an existing machine running cua-spacesd, added to a throwaway
+registry (`--registry DIR`, default a temp directory; `~/.cua` is never read
+or written). The canvas never creates or deletes a Space.
+
+| Flag | |
+|---|---|
+| `--hotkey option+space` | the global hotkey (Carbon, no Accessibility permission) |
+| `--show` | open at launch |
+| `--windowed 1600x1000` | a normal window instead of the full-screen overlay |
+| `--chromeless` | with `--windowed`: borderless, for window-only recordings |
+| `--control SOCKET` | a local control socket for scripted runs (0600) |
+| `--synthetic N` | N local H.264 test-pattern tiles (benchmark and tests only) |
+| `--perf-hud` | tiles decoding and frames requested, in the status pill |
+
+Keys: the hotkey hides, Return zooms into the selected tile, ⌘0 fits all,
+Esc steps back (search, then focus, then the overlay), typing searches window
+titles and Tab moves between matches. Click a tile to give it input; drag it
+by its title or while unfocused; resize from its bottom-right corner.
+
+## Architecture
+
+| Target | What it is |
+|---|---|
+| `CanvasModel` | Pure value types, no AppKit or SDK: `Camera` (zoom about a point, fitting, van Wijk smooth flights), `CanvasLayout` (tiles, z order, aspect-locked resize, justified-row arrangement), `LODPolicy`/`LODState` (tiers with hysteresis and a downgrade hold), `OverlayState` (hotkey toggling, debounce, reversal), `PresenceDirectory` (members, thread bindings, styles from the SDK's presence colors), `CursorGlide` (critically damped spring), `HumanPath` (a person's pointer path and typing cadence), `HoverInfo`, `StreamErrorMessage`, `FrameStats` |
+| `CanvasStreaming` | One tile's pipeline: `SpaceMediaSource` (a cua SDK `SpaceStreamSession` on one window), `TileDecoder` (VideoToolbox, hardware required, NV12 IOSurfaces, enqueued straight into an `AVSampleBufferDisplayLayer`), `TileStream` (level of detail applied as the media socket's `set_stream_preferences`, keyframe requests, ping latency, fps), `SyntheticMediaSource` (a local H.264 test pattern), `ProcessMetrics` |
+| `InfiniteCanvasApp` | The overlay window and hotkey, `CanvasScrollView` (the world is a huge layer-backed `NSScrollView` document; tiles are subviews at fixed world positions), tile views, the agent cursor (Cua Driver's `cua.default.lottie`, read and drawn natively), agent threads over ACP (`SpacesdClient.agents()`), presence (`SpacePresence` + the SDK's `PresenceRoster`), app icons fetched from each Space, the HUD, the control socket and the perf sweep |
+| `CanvasBench` | `canvas-bench`: the model's hot paths and the decode pipeline, headless |
+
+Performance design:
+
+- Pan and zoom are the scroll view's own, on the compositor: a gesture changes
+ one clip-view bounds. No tile moves, no layout runs, no SwiftUI view
+ updates per frame. The HUD reads a camera copy refreshed at most 20 times a
+ second.
+- Frames never touch the main thread or SwiftUI: SDK delivery thread, then
+ VideoToolbox, then the display layer's renderer.
+- Level of detail per tile from its drawn size: paused (off screen: 1 fps at
+ 160 px from the Space, not decoded), thumbnail (4 fps, 360 px), low (12,
+ 720), medium (30, 1280), full (60, 2560, or when focused). Upgrades are
+ immediate and ask for a keyframe; downgrades wait 450 ms and need an 18%
+ margin. While the overlay is hidden everything is paused.
+- A thread window (SwiftUI) is swapped for a bitmap of itself while the zoom
+ changes and restored 200 ms after.
+- `os_signpost` intervals under `ai.cua.infinite-canvas`: `decode`, `tick`,
+ `sweep`, and `tier` events.
+
+## Performance
+
+Measured on an M5 Max, 120 Hz ProMotion display, release build, a 1440x810 pt
+window. The sweep is the control socket's `perf` command: 20 or 30 s of
+pan (Lissajous) and log-scale zoom (overview to 140%) driven once per display
+frame, which crosses every level-of-detail transition. Frame times are the
+display link's intervals.
+
+| Run | fps | late (>12.5 ms) | worst frame | main thread | process CPU | GPU (mean / max) | memory |
+|---|---|---|---|---|---|---|---|
+| 8 live tiles (4 macOS, 4 Linux), 20 s | 119.9 | 1 | 20.8 ms | 10% | 12% | 26% / 42% | 229 MB |
+| 10 live tiles (+2 Omarchy), 30 s | 119.3 | 5 | 166 ms | 17% | 23% | 1% / 38% | 234 MB |
+| 8 live tiles before the thread-window freeze | 117.5 | 19 | 170 ms | 50% | 54% | 28% / 44% | 239 MB |
+| 8 synthetic 60 fps tiles (debug build), 10 s | 119.7 | 2 | 23.8 ms | 13% | 64% (incl. encoding) | 25% / 35% | 270 MB |
+
+All tiles decoded in hardware in every run. Decode latency per frame (submit
+to output), live tiles: p50 0.6 to 1.2 ms, p95 1.4 to 2.6 ms. GPU is
+whole-machine utilization (IOAccelerator), so it includes the rest of the
+Mac. The 166 ms frame is the first freeze of the thread window (one bitmap
+render); CPU and memory are this process.
+
+`canvas-bench --tiles 8 --seconds 10` (release):
+
+| | |
+|---|---|
+| level of detail for 100 tiles | 1.1 µs per frame |
+| one camera flight sample | 19 ns |
+| arranging 60 tiles | 15 µs |
+| 8 tiles at full (60 fps asked) | 475 decoded fps, p50 0.59 ms, p95 0.76 ms, hardware, 149 MB |
+| 8 tiles at mixed tiers | 150 decoded fps, 47 MB |
+
+Instruments is not available on this machine (Command Line Tools only, no
+Xcode), so the numbers come from the app's own counters and signposts.
+
+## Presence
+
+- An agent's cursor points along its direction of travel (the driver
+ overlay's convention: heading = travel + π, resting at π/4), low-passed so
+ it does not jitter and eased back upright at rest; it pivots on the tip.
+ People's pointers stay upright.
+- An agent's cursor is the Cua Driver default theme, tinted with the color
+ the Space's presence service assigned it. Its thread window's avatar uses
+ the same color (before the agent joins, the SDK's stable `presence_color`
+ for the thread). Message bubbles are neutral.
+- Before the agent acts, its cursor waits as a glyph in the thread window's
+ title; it glides out to the first window it acts in and home when the turn
+ ends.
+- A harness that opens two MCP sessions gets two driver cursors; while one
+ thread's turn runs in a Space, the second is drawn as the first.
+- People are a plain pointer in their color. `{"cmd": "coworker"}` on the
+ control socket joins a second, human participant whose pointer follows
+ `HumanPath` and whose click and typing are real `interactive_input`.
+
+## Tests
+
+```sh
+scripts/test.sh # 59 tests
+scripts/sync-cursor-assets.sh --check
+```
+
+Hermetic: the model, the tile pipeline on the local test pattern
+(VideoToolbox encode and decode), presence and dock logic, icon lookup and
+fallback, stream errors, and a UI smoke test in an offscreen window (frames
+present in hardware, a flight ends focused, level of detail pauses off-screen
+tiles, search selects, the hotkey presents and dismisses). Nothing connects
+to a Space. `snapshots/` holds images the suite writes (the stream error and
+the stats card).
diff --git a/samples/infinite-canvas-swift/Sources/CanvasBench/main.swift b/examples/infinite-canvas-swift/Sources/CanvasBench/main.swift
similarity index 100%
rename from samples/infinite-canvas-swift/Sources/CanvasBench/main.swift
rename to examples/infinite-canvas-swift/Sources/CanvasBench/main.swift
diff --git a/samples/infinite-canvas-swift/Sources/CanvasModel/Camera.swift b/examples/infinite-canvas-swift/Sources/CanvasModel/Camera.swift
similarity index 100%
rename from samples/infinite-canvas-swift/Sources/CanvasModel/Camera.swift
rename to examples/infinite-canvas-swift/Sources/CanvasModel/Camera.swift
diff --git a/samples/infinite-canvas-swift/Sources/CanvasModel/FrameStats.swift b/examples/infinite-canvas-swift/Sources/CanvasModel/FrameStats.swift
similarity index 100%
rename from samples/infinite-canvas-swift/Sources/CanvasModel/FrameStats.swift
rename to examples/infinite-canvas-swift/Sources/CanvasModel/FrameStats.swift
diff --git a/samples/infinite-canvas-swift/Sources/CanvasModel/HoverInfo.swift b/examples/infinite-canvas-swift/Sources/CanvasModel/HoverInfo.swift
similarity index 100%
rename from samples/infinite-canvas-swift/Sources/CanvasModel/HoverInfo.swift
rename to examples/infinite-canvas-swift/Sources/CanvasModel/HoverInfo.swift
diff --git a/samples/infinite-canvas-swift/Sources/CanvasModel/LevelOfDetail.swift b/examples/infinite-canvas-swift/Sources/CanvasModel/LevelOfDetail.swift
similarity index 100%
rename from samples/infinite-canvas-swift/Sources/CanvasModel/LevelOfDetail.swift
rename to examples/infinite-canvas-swift/Sources/CanvasModel/LevelOfDetail.swift
diff --git a/samples/infinite-canvas-swift/Sources/CanvasModel/Overlay.swift b/examples/infinite-canvas-swift/Sources/CanvasModel/Overlay.swift
similarity index 100%
rename from samples/infinite-canvas-swift/Sources/CanvasModel/Overlay.swift
rename to examples/infinite-canvas-swift/Sources/CanvasModel/Overlay.swift
diff --git a/samples/infinite-canvas-swift/Sources/CanvasModel/Presence.swift b/examples/infinite-canvas-swift/Sources/CanvasModel/Presence.swift
similarity index 100%
rename from samples/infinite-canvas-swift/Sources/CanvasModel/Presence.swift
rename to examples/infinite-canvas-swift/Sources/CanvasModel/Presence.swift
diff --git a/samples/infinite-canvas-swift/Sources/CanvasModel/StreamErrors.swift b/examples/infinite-canvas-swift/Sources/CanvasModel/StreamErrors.swift
similarity index 100%
rename from samples/infinite-canvas-swift/Sources/CanvasModel/StreamErrors.swift
rename to examples/infinite-canvas-swift/Sources/CanvasModel/StreamErrors.swift
diff --git a/samples/infinite-canvas-swift/Sources/CanvasModel/Tiles.swift b/examples/infinite-canvas-swift/Sources/CanvasModel/Tiles.swift
similarity index 100%
rename from samples/infinite-canvas-swift/Sources/CanvasModel/Tiles.swift
rename to examples/infinite-canvas-swift/Sources/CanvasModel/Tiles.swift
diff --git a/samples/infinite-canvas-swift/Sources/CanvasStreaming/ProcessMetrics.swift b/examples/infinite-canvas-swift/Sources/CanvasStreaming/ProcessMetrics.swift
similarity index 100%
rename from samples/infinite-canvas-swift/Sources/CanvasStreaming/ProcessMetrics.swift
rename to examples/infinite-canvas-swift/Sources/CanvasStreaming/ProcessMetrics.swift
diff --git a/samples/infinite-canvas-swift/Sources/CanvasStreaming/SyntheticMediaSource.swift b/examples/infinite-canvas-swift/Sources/CanvasStreaming/SyntheticMediaSource.swift
similarity index 100%
rename from samples/infinite-canvas-swift/Sources/CanvasStreaming/SyntheticMediaSource.swift
rename to examples/infinite-canvas-swift/Sources/CanvasStreaming/SyntheticMediaSource.swift
diff --git a/samples/infinite-canvas-swift/Sources/CanvasStreaming/TileDecoder.swift b/examples/infinite-canvas-swift/Sources/CanvasStreaming/TileDecoder.swift
similarity index 100%
rename from samples/infinite-canvas-swift/Sources/CanvasStreaming/TileDecoder.swift
rename to examples/infinite-canvas-swift/Sources/CanvasStreaming/TileDecoder.swift
diff --git a/samples/infinite-canvas-swift/Sources/CanvasStreaming/TileStream.swift b/examples/infinite-canvas-swift/Sources/CanvasStreaming/TileStream.swift
similarity index 100%
rename from samples/infinite-canvas-swift/Sources/CanvasStreaming/TileStream.swift
rename to examples/infinite-canvas-swift/Sources/CanvasStreaming/TileStream.swift
diff --git a/samples/infinite-canvas-swift/Sources/InfiniteCanvasApp/Agents/AgentThread.swift b/examples/infinite-canvas-swift/Sources/InfiniteCanvasApp/Agents/AgentThread.swift
similarity index 100%
rename from samples/infinite-canvas-swift/Sources/InfiniteCanvasApp/Agents/AgentThread.swift
rename to examples/infinite-canvas-swift/Sources/InfiniteCanvasApp/Agents/AgentThread.swift
diff --git a/samples/infinite-canvas-swift/Sources/InfiniteCanvasApp/Agents/ThreadView.swift b/examples/infinite-canvas-swift/Sources/InfiniteCanvasApp/Agents/ThreadView.swift
similarity index 100%
rename from samples/infinite-canvas-swift/Sources/InfiniteCanvasApp/Agents/ThreadView.swift
rename to examples/infinite-canvas-swift/Sources/InfiniteCanvasApp/Agents/ThreadView.swift
diff --git a/samples/infinite-canvas-swift/Sources/InfiniteCanvasApp/App/CanvasApp.swift b/examples/infinite-canvas-swift/Sources/InfiniteCanvasApp/App/CanvasApp.swift
similarity index 100%
rename from samples/infinite-canvas-swift/Sources/InfiniteCanvasApp/App/CanvasApp.swift
rename to examples/infinite-canvas-swift/Sources/InfiniteCanvasApp/App/CanvasApp.swift
diff --git a/samples/infinite-canvas-swift/Sources/InfiniteCanvasApp/App/ControlServer.swift b/examples/infinite-canvas-swift/Sources/InfiniteCanvasApp/App/ControlServer.swift
similarity index 100%
rename from samples/infinite-canvas-swift/Sources/InfiniteCanvasApp/App/ControlServer.swift
rename to examples/infinite-canvas-swift/Sources/InfiniteCanvasApp/App/ControlServer.swift
diff --git a/samples/infinite-canvas-swift/Sources/InfiniteCanvasApp/App/Options.swift b/examples/infinite-canvas-swift/Sources/InfiniteCanvasApp/App/Options.swift
similarity index 100%
rename from samples/infinite-canvas-swift/Sources/InfiniteCanvasApp/App/Options.swift
rename to examples/infinite-canvas-swift/Sources/InfiniteCanvasApp/App/Options.swift
diff --git a/samples/infinite-canvas-swift/Sources/InfiniteCanvasApp/App/PerfRun.swift b/examples/infinite-canvas-swift/Sources/InfiniteCanvasApp/App/PerfRun.swift
similarity index 100%
rename from samples/infinite-canvas-swift/Sources/InfiniteCanvasApp/App/PerfRun.swift
rename to examples/infinite-canvas-swift/Sources/InfiniteCanvasApp/App/PerfRun.swift
diff --git a/samples/infinite-canvas-swift/Sources/InfiniteCanvasApp/App/main.swift b/examples/infinite-canvas-swift/Sources/InfiniteCanvasApp/App/main.swift
similarity index 100%
rename from samples/infinite-canvas-swift/Sources/InfiniteCanvasApp/App/main.swift
rename to examples/infinite-canvas-swift/Sources/InfiniteCanvasApp/App/main.swift
diff --git a/samples/infinite-canvas-swift/Sources/InfiniteCanvasApp/Canvas/CanvasController.swift b/examples/infinite-canvas-swift/Sources/InfiniteCanvasApp/Canvas/CanvasController.swift
similarity index 100%
rename from samples/infinite-canvas-swift/Sources/InfiniteCanvasApp/Canvas/CanvasController.swift
rename to examples/infinite-canvas-swift/Sources/InfiniteCanvasApp/Canvas/CanvasController.swift
diff --git a/samples/infinite-canvas-swift/Sources/InfiniteCanvasApp/Canvas/CanvasScrollView.swift b/examples/infinite-canvas-swift/Sources/InfiniteCanvasApp/Canvas/CanvasScrollView.swift
similarity index 100%
rename from samples/infinite-canvas-swift/Sources/InfiniteCanvasApp/Canvas/CanvasScrollView.swift
rename to examples/infinite-canvas-swift/Sources/InfiniteCanvasApp/Canvas/CanvasScrollView.swift
diff --git a/samples/infinite-canvas-swift/Sources/InfiniteCanvasApp/Canvas/HUD.swift b/examples/infinite-canvas-swift/Sources/InfiniteCanvasApp/Canvas/HUD.swift
similarity index 100%
rename from samples/infinite-canvas-swift/Sources/InfiniteCanvasApp/Canvas/HUD.swift
rename to examples/infinite-canvas-swift/Sources/InfiniteCanvasApp/Canvas/HUD.swift
diff --git a/samples/infinite-canvas-swift/Sources/InfiniteCanvasApp/Canvas/HoverCard.swift b/examples/infinite-canvas-swift/Sources/InfiniteCanvasApp/Canvas/HoverCard.swift
similarity index 100%
rename from samples/infinite-canvas-swift/Sources/InfiniteCanvasApp/Canvas/HoverCard.swift
rename to examples/infinite-canvas-swift/Sources/InfiniteCanvasApp/Canvas/HoverCard.swift
diff --git a/samples/infinite-canvas-swift/Sources/InfiniteCanvasApp/Canvas/Palette.swift b/examples/infinite-canvas-swift/Sources/InfiniteCanvasApp/Canvas/Palette.swift
similarity index 100%
rename from samples/infinite-canvas-swift/Sources/InfiniteCanvasApp/Canvas/Palette.swift
rename to examples/infinite-canvas-swift/Sources/InfiniteCanvasApp/Canvas/Palette.swift
diff --git a/samples/infinite-canvas-swift/Sources/InfiniteCanvasApp/Canvas/TileViews.swift b/examples/infinite-canvas-swift/Sources/InfiniteCanvasApp/Canvas/TileViews.swift
similarity index 100%
rename from samples/infinite-canvas-swift/Sources/InfiniteCanvasApp/Canvas/TileViews.swift
rename to examples/infinite-canvas-swift/Sources/InfiniteCanvasApp/Canvas/TileViews.swift
diff --git a/samples/infinite-canvas-swift/Sources/InfiniteCanvasApp/Cursor/AgentCursorLayer.swift b/examples/infinite-canvas-swift/Sources/InfiniteCanvasApp/Cursor/AgentCursorLayer.swift
similarity index 100%
rename from samples/infinite-canvas-swift/Sources/InfiniteCanvasApp/Cursor/AgentCursorLayer.swift
rename to examples/infinite-canvas-swift/Sources/InfiniteCanvasApp/Cursor/AgentCursorLayer.swift
diff --git a/samples/infinite-canvas-swift/Sources/InfiniteCanvasApp/Cursor/DotLottie.swift b/examples/infinite-canvas-swift/Sources/InfiniteCanvasApp/Cursor/DotLottie.swift
similarity index 100%
rename from samples/infinite-canvas-swift/Sources/InfiniteCanvasApp/Cursor/DotLottie.swift
rename to examples/infinite-canvas-swift/Sources/InfiniteCanvasApp/Cursor/DotLottie.swift
diff --git a/samples/infinite-canvas-swift/Sources/InfiniteCanvasApp/Resources/cua.default.lottie b/examples/infinite-canvas-swift/Sources/InfiniteCanvasApp/Resources/cua.default.lottie
similarity index 100%
rename from samples/infinite-canvas-swift/Sources/InfiniteCanvasApp/Resources/cua.default.lottie
rename to examples/infinite-canvas-swift/Sources/InfiniteCanvasApp/Resources/cua.default.lottie
diff --git a/samples/infinite-canvas-swift/Sources/InfiniteCanvasApp/Spaces/AppIcons.swift b/examples/infinite-canvas-swift/Sources/InfiniteCanvasApp/Spaces/AppIcons.swift
similarity index 100%
rename from samples/infinite-canvas-swift/Sources/InfiniteCanvasApp/Spaces/AppIcons.swift
rename to examples/infinite-canvas-swift/Sources/InfiniteCanvasApp/Spaces/AppIcons.swift
diff --git a/samples/infinite-canvas-swift/Sources/InfiniteCanvasApp/Spaces/Coworker.swift b/examples/infinite-canvas-swift/Sources/InfiniteCanvasApp/Spaces/Coworker.swift
similarity index 100%
rename from samples/infinite-canvas-swift/Sources/InfiniteCanvasApp/Spaces/Coworker.swift
rename to examples/infinite-canvas-swift/Sources/InfiniteCanvasApp/Spaces/Coworker.swift
diff --git a/samples/infinite-canvas-swift/Sources/InfiniteCanvasApp/Spaces/SpacesHub.swift b/examples/infinite-canvas-swift/Sources/InfiniteCanvasApp/Spaces/SpacesHub.swift
similarity index 100%
rename from samples/infinite-canvas-swift/Sources/InfiniteCanvasApp/Spaces/SpacesHub.swift
rename to examples/infinite-canvas-swift/Sources/InfiniteCanvasApp/Spaces/SpacesHub.swift
diff --git a/samples/infinite-canvas-swift/Sources/InfiniteCanvasApp/Window/OverlayWindow.swift b/examples/infinite-canvas-swift/Sources/InfiniteCanvasApp/Window/OverlayWindow.swift
similarity index 100%
rename from samples/infinite-canvas-swift/Sources/InfiniteCanvasApp/Window/OverlayWindow.swift
rename to examples/infinite-canvas-swift/Sources/InfiniteCanvasApp/Window/OverlayWindow.swift
diff --git a/samples/infinite-canvas-swift/Tests/InfiniteCanvasTests/AppTests.swift b/examples/infinite-canvas-swift/Tests/InfiniteCanvasTests/AppTests.swift
similarity index 100%
rename from samples/infinite-canvas-swift/Tests/InfiniteCanvasTests/AppTests.swift
rename to examples/infinite-canvas-swift/Tests/InfiniteCanvasTests/AppTests.swift
diff --git a/samples/infinite-canvas-swift/Tests/InfiniteCanvasTests/ModelTests.swift b/examples/infinite-canvas-swift/Tests/InfiniteCanvasTests/ModelTests.swift
similarity index 100%
rename from samples/infinite-canvas-swift/Tests/InfiniteCanvasTests/ModelTests.swift
rename to examples/infinite-canvas-swift/Tests/InfiniteCanvasTests/ModelTests.swift
diff --git a/samples/infinite-canvas-swift/scripts/sync-cursor-assets.sh b/examples/infinite-canvas-swift/scripts/sync-cursor-assets.sh
similarity index 100%
rename from samples/infinite-canvas-swift/scripts/sync-cursor-assets.sh
rename to examples/infinite-canvas-swift/scripts/sync-cursor-assets.sh
diff --git a/samples/infinite-canvas-swift/scripts/test.sh b/examples/infinite-canvas-swift/scripts/test.sh
similarity index 100%
rename from samples/infinite-canvas-swift/scripts/test.sh
rename to examples/infinite-canvas-swift/scripts/test.sh
diff --git a/samples/infinite-canvas-swift/snapshots/stats-card.png b/examples/infinite-canvas-swift/snapshots/stats-card.png
similarity index 100%
rename from samples/infinite-canvas-swift/snapshots/stats-card.png
rename to examples/infinite-canvas-swift/snapshots/stats-card.png
diff --git a/samples/infinite-canvas-swift/snapshots/tile-error.png b/examples/infinite-canvas-swift/snapshots/tile-error.png
similarity index 100%
rename from samples/infinite-canvas-swift/snapshots/tile-error.png
rename to examples/infinite-canvas-swift/snapshots/tile-error.png
diff --git a/samples/openkoalabot-example-scenario/.gitignore b/examples/openkoalabot-example-scenario/.gitignore
similarity index 100%
rename from samples/openkoalabot-example-scenario/.gitignore
rename to examples/openkoalabot-example-scenario/.gitignore
diff --git a/examples/openkoalabot-example-scenario/README.md b/examples/openkoalabot-example-scenario/README.md
new file mode 100644
index 0000000000..50572abc63
--- /dev/null
+++ b/examples/openkoalabot-example-scenario/README.md
@@ -0,0 +1,72 @@
+# openkoalabots scenario
+
+One language-neutral scenario, `scenario.json`, that every openkoalabots
+implementation runs headlessly. The three implementations share it:
+[`openkoalabot-example-swift`](../openkoalabot-example-swift), [`openkoalabot-example-tauri`](../openkoalabot-example-tauri)
+and [`openkoalabot-example-ts`](../openkoalabot-example-ts). Each one runs the spec through its
+own app core, so a passing run shows that the app's code works against a
+real Space. The spec only fixes what must be true. Each language decides how
+its runner gets there.
+
+| Step | Operation | What must be true |
+|---|---|---|
+| `space` | add (`fixture`, `docker`) or create (`cloud`) a Space | the Space is registered in a **temp** registry after a capabilities handshake |
+| `stream` | desktop stream session | at least 1 frame arrives, the first frame is a keyframe, and a keyframe request produces another. Skipped when the Space lacks `desktop_stream` |
+| `agent` | agent thread with a **fake** `claude` CLI | turn 1 (`agent_start`) and turn 2 (`agent_message`, which resumes with `--continue`) both reach `idle`, and each output tail contains the expected line |
+| `file` | `send_file` of a generated 1 MiB file | the bytes come from the spec's xorshift64 generator, the local sha256 equals `sha256`, and the guest's own `sha256sum` agrees |
+| `teleport` | teleport `firefox` with an explicit approval callback | the profile is **generated** from `fixtures/firefox-profile.json` in a temp teleport home, and the run's marker is found in the guest |
+| `presence` | two independent SDK runtimes join | the operator sees Koala join, then sees its cursor move to (0.25, 0.75), then sees it leave; the SDK's presence roster, folded from those events, shows Koala's cursor and then drops Koala. The operator holds Koala's stable color, so the server assigns Koala another; the app's avatar color for Koala must equal that cursor color. Skipped without `presence` |
+| `routine` | the app's routine store and live runner | a routine not yet due does not fire; the real scheduler fires it once, as a real agent turn whose prompt starts `[routine] <title>:` and whose output has the scripted reply; another tick fires nothing; a reloaded store has the run id. Skipped without a model endpoint |
+| `group` | the app's group store and live messenger, two Bots | groups of 1 and 7 are refused; one message reaches both Bots, framed with the other's name; each Bot's reply is attributed to it once. Skipped without a model endpoint |
+| `delete` | delete the Space | always runs. A Space added by address is only removed from the registry; a created cloud Space is deleted |
+
+No step calls a real model or uses real credentials: agent turns run the real harness against `cua-mock-llm`, whose `mock:` directive in the prompt scripts the reply. No step reads `~/.cua`,
+`~/.claude`, `~/.codex`, a real browser profile or the keychain. No step
+opens a window.
+
+## Runner contract
+
+```
+<runner> --spec scenario.json --lane fixture|docker|cloud --out result.json
+```
+
+| Variable | Meaning |
+|---|---|
+| `OPENKOALABOTS_SCENARIO_URL`, `OPENKOALABOTS_SCENARIO_TOKEN` | the spacesd to add (`fixture`, `docker`) |
+| `OPENKOALABOTS_SCENARIO_IMPORT_ROOT` | `{importRoot}` in `teleport.verifyCommand`: the literal `$HOME` in a real guest, or the fixture's teleport import directory |
+| `OPENKOALABOTS_SCENARIO_MODEL_URL` | the model endpoint as the Space reaches it (`cua-mock-llm`); the runner forwards `ANTHROPIC_API_KEY` from its own environment. Unset: `routine` and `group` skip |
+| `OPENKOALABOTS_CLOUD_IMAGE` | `cloud` lane: the linux (spacesd) image to create in Cua Cloud. Credentials come from the usual environment (`cua auth login`) |
+
+The result is `{impl, lane, ok, totalMs, steps: [{id, status, ms, detail}]}`,
+where `status` is `pass`, `fail` or `skip`. A run is `ok` when no step failed.
+
+| Implementation | Runner |
+|---|---|
+| swift | `examples/openkoalabot-example-swift/.build/debug/OpenKoalaBotExample scenario …` |
+| tauri | `examples/openkoalabot-example-tauri/src-tauri/target/debug/openkoalabot-example-scenario …` |
+| ts | `node examples/openkoalabot-example-ts/dist/scenario/cli.js …` |
+
+## Lanes
+
+```sh
+# Hermetic: an in-process spacesd server core (libs/cua cua-test-fixtures), confined to a temp HOME and PATH.
+examples/openkoalabot-example-scenario/run.sh --impl all --lane fixture
+
+# A local linux image container under gVisor, --memory=4g, one at a time.
+examples/openkoalabot-example-scenario/run.sh --impl all --lane docker \
+ [--image cua-e2e-local/linux:docker-local-arm64] [--runtime runsc]
+
+# Cua Cloud (gated): needs a linux (spacesd) image the cloud can pull.
+OPENKOALABOTS_CLOUD_IMAGE=ghcr.io/trycua/linux:24.04 \
+ examples/openkoalabot-example-scenario/run.sh --impl all --lane cloud
+```
+
+`run.sh` writes `results/<impl>-<lane>.json` and prints an
+implementation × step matrix. Build the runners first; each implementation's
+README has the command.
+
+The `docker` lane also starts `cua-mock-llm` (`--memory=256m`, removed with the Space) and sets the model variables, so `routine` and `group` run real agent turns; the first turn installs the harness in the Space (about 30 s). Point `--mock-llm` at a Linux build of `cua-mock-llm` (`cargo zigbuild --release -p cua-mock-llm --target aarch64-unknown-linux-musl` in libs/cua).
+
+The `fixture` lane has no desktop, so `stream` reports `skip`, and no model, so `routine` and `group` skip. The spacesd
+server core runs on the host with a temp `HOME`, and `presence` and
+`teleport` run against it for real.
diff --git a/samples/openkoalabot-example-scenario/fixtures/fake-claude.sh b/examples/openkoalabot-example-scenario/fixtures/fake-claude.sh
similarity index 100%
rename from samples/openkoalabot-example-scenario/fixtures/fake-claude.sh
rename to examples/openkoalabot-example-scenario/fixtures/fake-claude.sh
diff --git a/samples/openkoalabot-example-scenario/fixtures/firefox-profile.json b/examples/openkoalabot-example-scenario/fixtures/firefox-profile.json
similarity index 100%
rename from samples/openkoalabot-example-scenario/fixtures/firefox-profile.json
rename to examples/openkoalabot-example-scenario/fixtures/firefox-profile.json
diff --git a/samples/openkoalabot-example-scenario/run.sh b/examples/openkoalabot-example-scenario/run.sh
similarity index 100%
rename from samples/openkoalabot-example-scenario/run.sh
rename to examples/openkoalabot-example-scenario/run.sh
diff --git a/samples/openkoalabot-example-scenario/scenario.json b/examples/openkoalabot-example-scenario/scenario.json
similarity index 100%
rename from samples/openkoalabot-example-scenario/scenario.json
rename to examples/openkoalabot-example-scenario/scenario.json
diff --git a/samples/openkoalabot-example-swift/.gitignore b/examples/openkoalabot-example-swift/.gitignore
similarity index 100%
rename from samples/openkoalabot-example-swift/.gitignore
rename to examples/openkoalabot-example-swift/.gitignore
diff --git a/samples/openkoalabot-example-swift/FRICTION.md b/examples/openkoalabot-example-swift/FRICTION.md
similarity index 100%
rename from samples/openkoalabot-example-swift/FRICTION.md
rename to examples/openkoalabot-example-swift/FRICTION.md
diff --git a/samples/infinite-canvas-swift/LICENSE b/examples/openkoalabot-example-swift/LICENSE
similarity index 100%
rename from samples/infinite-canvas-swift/LICENSE
rename to examples/openkoalabot-example-swift/LICENSE
diff --git a/samples/openkoalabot-example-swift/Package.swift b/examples/openkoalabot-example-swift/Package.swift
similarity index 100%
rename from samples/openkoalabot-example-swift/Package.swift
rename to examples/openkoalabot-example-swift/Package.swift
diff --git a/examples/openkoalabot-example-swift/README.md b/examples/openkoalabot-example-swift/README.md
new file mode 100644
index 0000000000..d41a3be68d
--- /dev/null
+++ b/examples/openkoalabot-example-swift/README.md
@@ -0,0 +1,336 @@
+# OpenKoalaBots (Swift)
+
+The Swift sample of OpenKoalaBots (package `OpenKoalaBotExample`, macOS 14,
+SwiftPM). The app is called OpenKoalaBots.
+
+The sample links Cua Spaces pieces (`CuaSpacesStreaming`, in
+[`libs/spaces-app-swift`](../../libs/spaces-app-swift)), so it is
+source-available under the
+[Functional Source License, Version 1.1, MIT Future License](LICENSE)
+(FSL-1.1-MIT), like Cua Spaces itself. See [LICENSING.md](../../legal/LICENSING.md).
+
+## Quick start
+
+```sh
+git clone https://github.com/trycua/cua && cd cua/examples/openkoalabot-example-swift
+(cd ../../libs/cua && cargo build --release -p cua-sdk && node scripts/stage-uniffi-library.mjs --only=swift)
+swift build && .build/debug/OpenKoalaBotExample
+```
+
+**Local workspace override.** `Package.swift` depends on
+`../../libs/spaces-sdk-swift`, `../../libs/spaces-app-swift` and
+`../../libs/cua/swift` by path, and the `Cua` package links the cua SDK dylib
+staged into `libs/cua/swift/lib` by the second command. That is how the sample
+is developed inside this repository. A copy taken on its own
+(`npx degit trycua/cua/examples/openkoalabot-example-swift`) needs those three
+packages next to it at the same relative paths, or the three
+`.package(path:)` lines pointed at your checkout of them.
+
+## About
+
+A modern desktop chat app for agent coworkers, built on Cua Spaces, used to derive the Spaces SDK by
+building a real app against the raw primitives. This is one of three
+implementations with the same behaviour. The other two are
+[`openkoalabot-example-tauri`](../openkoalabot-example-tauri) (Rust) and
+[`openkoalabot-example-ts`](../openkoalabot-example-ts) (TypeScript). All three run the shared
+headless scenario in [`openkoalabot-example-scenario`](../openkoalabot-example-scenario).
+
+- `RUBRIC.md`: what each rendered surface is checked against, and what is
+ ungradeable by design.
+- `FRICTION.md`: every place the old Spaces MCP forced an awkward shape on the
+ client, with the code that absorbed it. This was the design input for the SDK.
+
+## The SDK exists now, and this app consumes it
+
+The 46 entries in `FRICTION.md` were turned into
+[`libs/spaces-sdk-swift`](../../libs/spaces-sdk-swift) and
+[`libs/spaces-app-swift`](../../libs/spaces-app-swift). The hand-rolled MCP
+binding that used to be `Sources/OpenKoalaBotExample/Spaces/MCPSpacesClient.swift` now
+lives in the first as `CuaSpaces`, and the whole of
+`Sources/OpenKoalaBotExample/Streaming/` in the second as `CuaSpacesStreaming`
+(source-available, FSL-1.1-MIT). What is left in this sample is the app: its own view
+models, its roster and transcript stores, and `Spaces/SDKSpacesClient.swift`,
+which is the thin mapping from the SDK into this app's vocabulary.
+
+The SDK's README carries the entry-by-entry mapping, including the entries it
+deliberately does **not** absorb because they are app, platform or server
+problems rather than API ones.
+
+## Layers and status
+
+| Layer | Status |
+|---|---|
+| Spaces client (`Sources/OpenKoalaBotExample/Spaces/`, on `CuaSpaces`): sandboxes, agent threads, windows, files | **live**, e2e-tested against a real Space |
+| Screen export (`export <dir>`) | live; renders from `Model/Fixtures.swift` |
+| Live data layer (`Sources/OpenKoalaBotExample/Model/`): one Space, a roster of Bots, live transcripts | **live**, e2e-tested against a real Space |
+| Roster / transcript views | rendered from an injected `BotDataSource`: `FixtureDataSource` for export, `BotStore` at runtime |
+| Picture-in-picture: the desktop (the button on the stream) or one window (the pane's window list), each in a floating panel (`StreamPiPSet`) | **live**, `live-pip` and `PiPLiveTests` against a real Space |
+| One drop zone (`SpaceDropZone`): files dropped or picked with "Send file…" upload into the Space | live |
+
+App teleport (moving a host app or window into a Space) ships with Cua
+Spaces (source-available) and is not part of this sample.
+
+`presentScreen` is deliberately inert: the Spaces tools that display a Space
+(`show_space_pip`, `open_space_viewer`, `stream_space_window`) draw onto the
+*operator's* Mac. An in-app stream reads frames from the Space's media plane
+(`SpaceStreamProvider`) and belongs to the streaming layer. `capabilities.liveScreenPixels` reports `false` so nothing
+mistakes the placeholder for live pixels.
+
+## The runtime underneath
+
+`SDKSpacesClient` is built on the
+Swift overlay [`libs/spaces-sdk-swift`](../../libs/spaces-sdk-swift). The
+overlay sits on the generated `Cua` package, so every tool is the Rust
+`cua-spaces` implementation, reached in one of two ways:
+
+| `OPENKOALABOTS_SPACES` | Backend |
+|---|---|
+| unset | a running `cua daemon` if its discovery file exists, otherwise embedded (`Spaces.local()`) |
+| `daemon` | `SpacesConnection.daemon()`: `cua daemon`, shared by every process on the machine |
+| `embedded` | `SpacesConnection.embedded()`: the runtime in this process. `OPENKOALABOTS_SPACES_HOME` moves its registry off `~/.cua` |
+
+The app streams through `SpaceStreamProvider`: a Space is its own stream
+source.
+
+## The app window
+
+One opaque window (no materials, light and dark): a sidebar with the Bots,
+routines and group chats, a centred conversation column, and the Agent
+Computer pane on the right when it is open. An empty conversation is a centred
+prompt; typing into it creates a Bot and sends the message. The koala artwork
+is drawn from `examples/openkoalabots-assets` geometry in `Design/KoalaArt.swift`,
+including the Dock icon.
+
+### New Space
+
+`New Space` (sidebar, `Shift-Cmd-N`) opens a four-step wizard: System (OS,
+image, Cua Cloud or This machine, and an optional Engine), Resources, Options,
+Summary. "Where it runs" starts from your default location (`cua config set
+default.on cloud|local`, `CUA_DEFAULT_ON`). The Engine chooser offers only what
+the image runs there: gVisor or runc for a local container, QEMU or Lume for a
+local VM, gVisor or KubeVirt in Cua Cloud, and Automatic by default. `Create`
+makes one call on the generated cua SDK, `Spaces.create(options:)` with `on`,
+`kind`, `runtime`, the image as is, and CPUs and memory for a local Space
+(`Spaces/SDKSpaceCreation.swift`). A Cua Cloud Space is metered.
+
+The image dropdown lists the published entries of
+`libs/images/sandbox-images.json`, generated into
+`Spaces/SandboxImages.generated.swift`:
+
+```sh
+node scripts/gen-images.mjs # regenerate
+node scripts/gen-images.mjs --check # exit 1 on drift
+```
+
+### Screenshots
+
+`OPENKOALABOTS_DESIGN_CAPTURE=<stage>` puts the window in one state with fixture
+Bots and transcripts, offline, for a screenshot taken from outside the app.
+Stages: `signin`, `empty`, `thread`, `computer`, `wizard`, `wizard-local`,
+`wizard-resources`, `wizard-options`, `wizard-summary`.
+`OPENKOALABOTS_APPEARANCE=light|dark` pins the appearance, and
+`OPENKOALABOTS_DATA_DIR` moves the roster and routines files off
+`~/Library/Application Support/OpenKoalaBots` (set it for any throwaway run).
+
+## Running
+
+Stage the cua SDK library first. The Swift package links the host dylib from
+`libs/cua/swift/lib`:
+
+```sh
+(cd ../../libs/cua && cargo build --release -p cua-sdk && node scripts/stage-uniffi-library.mjs --only=swift)
+swift build
+.build/debug/OpenKoalaBotExample export ./renders # every screen to PNG (no windows)
+.build/debug/OpenKoalaBotExample spaces-probe embedded # the Spaces contract tools, from the linked SDK
+OPENKOALABOTS_TEST_SPACE=space://direct/127.0.0.1:3211 .build/debug/OpenKoalaBotExample # the app, attached to a registered Space
+```
+
+The last command opens the app's window. Run it yourself; the test suite and
+the scenario never do.
+
+## The shared scenario
+
+```sh
+../openkoalabot-example-scenario/run.sh --impl swift --lane fixture # hermetic
+../openkoalabot-example-scenario/run.sh --impl swift --lane docker # a linux container (runsc, 4 GiB)
+```
+
+`OpenKoalaBotExample scenario --spec … --lane … --out …` runs the spec through this
+app's own code, headlessly: `SDKSpacesClient` for the Space and the agent
+thread, `SpaceStreamProvider` for frames, and the SDK handle for files,
+teleport and presence (`Sources/OpenKoalaBotExample/Scenario/ScenarioRunner.swift`).
+Session teleport ships with Cua Spaces (source-available). The runner's
+embedded runtime refuses it with `HostCapabilityMissing`, so that step skips.
+
+## Picture-in-picture
+
+```sh
+.build/debug/OpenKoalaBotExample live-pip 127.0.0.1:3211 "$TOKEN" /tmp/pip "terminal"
+```
+
+Adds the spacesd to a temp registry, pops out the desktop and the first
+window whose title matches, and prints both sessions' frame counts sampled
+twice. `OPENKOALABOTS_PIP_CAPTURE=<dir>` runs the same tour in the app.
+
+## Tests
+
+```sh
+scripts/test.sh # `swift test`, plus the swift-testing paths the Command Line Tools need
+```
+
+The suites run on swift-testing. XCTest ships only with Xcode. The assertion
+lines keep XCTest's names through `Tests/OpenKoalaBotExampleTests/XCTAssertCompat.swift`.
+Offline, 212 tests pass and the 22 live ones skip. Against a local
+linux container (gVisor, `OPENKOALABOTS_TEST_SPACE_URL`), 212 pass
+and one skips: the Terminal-window test, which only runs on a macOS Space.
+
+The e2e suite drives `SDKSpacesClient`, and through it the SDK, against a
+**live Space** through the cua SDK's Spaces runtime. Nothing is mocked.
+
+### `OPENKOALABOTS_TEST_SPACE_URL`: a spacesd
+
+```sh
+OPENKOALABOTS_TEST_SPACE_URL=http://127.0.0.1:32768 OPENKOALABOTS_TEST_SPACE_TOKEN=… scripts/test.sh
+```
+
+The machine is added to a **temp** registry in an embedded runtime and pinned
+for the run. Install the scenario's fake agent CLI in the guest first
+(`examples/openkoalabot-example-scenario/fixtures/fake-claude.sh` as `~/.local/bin/claude`),
+so the agent tests make no model calls. Otherwise the harness installs the
+real CLI. `~/.cua` is never touched. A local linux container
+works for this. The few assertions that are about a macOS Space, such as
+opening a Terminal window, skip on Linux and say why.
+
+### `OPENKOALABOTS_TEST_SPACE`: the warm-Space override
+
+Point the suite at a Space that is already up, instead of creating one:
+
+```sh
+OPENKOALABOTS_TEST_SPACE=local:cua-space-e3c1b54907 scripts/test.sh
+```
+
+With the variable set, `ensureSpace()` returns exactly that Space: no
+`create_space`, no `delete_space`, and no call that displays
+the Space on the operator's desktop. Every artefact a test creates (an uploaded
+file, an agent run, a window it opened) is named with a fresh UUID and removed
+in teardown whether the test passes or fails, so the suite is safe to run
+against a Space you demo from.
+
+With it **unset the live tests skip** rather than run. That is deliberate: the
+ordinary `ensureSpace()` path calls `create_space` with `reuse: true` in your
+default location, which creates a **new sandbox** (metered in Cua Cloud) when it
+finds none to reuse (see `FRICTION.md` #5). Costing a reviewer a sandbox for
+typing `swift test` is not acceptable, so the suite never takes that path.
+
+Per-test cleanup, which used to be XCTest's async `tearDown`, and the
+end-of-suite sweeper, which used to be `XCTestObservation`, are now the
+`.liveSpace` trait (`Tests/OpenKoalaBotExampleTests/LiveSpace.swift`).
+
+### What is covered
+
+| Primitive | Tool | Test |
+|---|---|---|
+| Space inventory | `list_spaces` | `testListSpacesDecodesTheRealInventory`, `testWarmSpaceIsRunning` |
+| Attach to a Space | override (never `create_space`) | `testEnsureSpaceAttachesToWarmSpaceWithoutCreating` |
+| Start a Bot | `agent_start` | `testBotLifecycleStartMessageStatusStop` |
+| Steer a Bot | `agent_message` | `testBotLifecycleStartMessageStatusStop`, `testMessageToARunningBotIsRefusedNotQueued` |
+| Poll a Bot | `agent_status` | `testBotLifecycleStartMessageStatusStop`, `testStatusOfUnknownRunIsUnknownNotDone` |
+| Stop a Bot | `agent_stop` | `testBotLifecycleStartMessageStatusStop` |
+| Bot roster | `agent_list` | `testBotLifecycleStartMessageStatusStop` |
+| Live window view | `list_space_windows` | `testWindowsReturnsLiveWindowsWithUsableIdentifiers`, `testWindowsReflectsAWindowOpenedAndClosedByTheTest` |
+| Attachment in | `upload` | `testUploadDeliversFileContentsIntoTheSpace`, `testUploadOfMissingHostFileThrows` |
+| Attachment out | `download` | `testDownloadBringsAFileBackOutOfTheSpace`, `testDownloadOfMissingPathThrows` |
+
+### What is **not** covered, and why
+
+- **`create_space` / `delete_space`.** Implemented and typed, but untested
+ here: exercising them means creating and deleting a sandbox, which this suite
+ is forbidden to do against the Space it runs on. The shared scenario's
+ `cloud` lane covers them.
+- **`ensureSpace()`'s create branch.** Same reason: it can create a sandbox.
+ The override branch is tested; the `create_space` branch is not.
+- **`presentScreen` / tier 2 and 3 pixels.** Not implemented in this layer.
+ `testPresentScreenIsInertAndCapabilitiesSaySo` asserts it stays inert. That
+ is proof the build does not open a window on the operator's Mac, **not**
+ coverage of a streaming operation.
+
+### Screen → Spaces operation → test
+
+Screens whose behaviour is backed by a Spaces operation:
+
+| Screen | Operation | Test |
+|---|---|---|
+| `mobile-02-thread-card`, `mobile-03-thread-links` | agent thread: `agent_start` → `agent_status` → `agent_message` | `testBotLifecycleStartMessageStatusStop` |
+| `mobile-01-roster` (populated) | `agent_list` | `testBotLifecycleStartMessageStatusStop` |
+| `mobile-05-takeover`, `mobile-07-pinned-preview`, `mobile-09-takeover-controlled` | live window view (`list_space_windows`); the *pixels* are `stream_space_window` | window list: `testWindowsReturnsLiveWindowsWithUsableIdentifiers`. Streaming and take/hand-back: **not implemented** |
+| `mobile-08-attachments` | `upload` (and `download` on the way back) | `testUploadDeliversFileContentsIntoTheSpace`, `testDownloadBringsAFileBackOutOfTheSpace` |
+| `mobile-06-approval` | approval gate before a Bot uses a saved login | **no Spaces operation exists for this.** The Spaces tool contract has no approval primitive: `agent_start` runs auto-approved because the Space *is* the sandbox. The screen is deliberately uncovered rather than faked (RUBRIC.md) |
+| `desktop-01-dark`, `desktop-02-light`, `desktop-03-no-panel` | the desktop shell hosts the same thread and window operations as above | same tests; the shell itself is fixture-rendered |
+
+UI-only screens, with no Spaces interaction and **no test**, correctly:
+
+- `mobile-04-signin`: sign-in, entirely local.
+- `mobile-10-empty-roster`: the zero-Bot empty state; by definition no run to list.
+
+### The live data layer
+
+`Model/BotStore.swift` is the app's data layer: it attaches to **one** Space and
+starts **one long-lived agent thread per Bot** inside it (never a Space per
+Bot; `Spaces/SpacesClient.swift` argues out why), keeps a live roster from
+`agent_list` joined to local Bot identity, and derives each Bot's transcript
+from real `agent_status` output.
+
+| Live behaviour | Operation | Test |
+|---|---|---|
+| Attach to the one shared Space, create nothing | override (never `create_space`) | `testConnectAttachesToTheWarmSpaceAndCreatesNothing`, `testEveryBotRunsInTheOneSharedSpace` |
+| Real agent output becomes a transcript | `agent_start` → `agent_status` | `testLiveThreadCarriesRealAgentOutputRosterStateAndAttachments` |
+| Per-turn attribution of output | `agent_message` + tail offsets | `testLiveThread…`, `testOutputIsAttributedToTheTurnThatCausedIt` |
+| Live roster with per-Bot state and `accepts_message` | `agent_list` | `testLiveThread…`, `testRosterJoinsRunsBackToLocalBotIdentity`, `testUnmarkedRunsStillAppearInTheRoster` |
+| A refusal is shown, not swallowed | `agent_message` | `testMidTurnRefusalIsShownToTheUser`, `testRefusalSurfacesInOutcomeNoticesAndTranscript` |
+| Attachments in, files out | `upload` / `download` | `testLiveThread…`, `testAttachmentIsEchoedIntoTheTranscript` |
+| One poll loop for the whole roster | `agent_status` | `testPollLoopRefreshesTheRosterFromOneTask` |
+| A failed probe degrades to `unknown`, never to health | `agent_status` | `testFailedStatusProbeDegradesToUnknown` |
+
+The views read through `BotDataSource`, which has two implementations:
+`FixtureDataSource` (what `export` renders, so the regression renders
+`RUBRIC.md` describes do not move; the PNGs were byte-identical before and
+after this layer landed) and `BotStore` (live). `BotStatusChip` and the composer's refusal
+line surface `accepts_message` in the UI, so a user can see that a Bot will
+refuse a message before typing one.
+
+### Routines, group chats, and the transcript affordances
+
+`Sources/OpenKoalaBotExample/Routines/` and `Sources/OpenKoalaBotExample/Groups/` are
+self-contained views the app shell mounts:
+
+| Feature | Mount point | Backing |
+|---|---|---|
+| Routines | `RoutinesPanel(botID:botName:store:dark:scale:)`: desktop right panel under the Agent Computer preview; mobile thread overflow | `RoutineStore` (JSON on disk) + `BotStoreRoutineRunner` → real `agent_start` / `agent_message` |
+| Group chat | `GroupChatScreen(chatID:store:bots:)`, opened from `NewGroupSheet` | `GroupChatStore` + `BotStoreGroupMessenger` → one agent thread per member in the one shared Space |
+
+A routine is a saved prompt plus a clock. `RoutineStore.tick(now:)` is the whole
+scheduler and takes the instant to evaluate, so the policy is testable without
+sleeping; `startScheduler(every:)` is a thin loop over it. Firing an unhired Bot
+**hires it** (a real `agent_start`), and firing a Bot that is mid-turn is
+*refused*, never an interruption. Routines persist to
+`~/Library/Application Support/OpenKoalaBots/routines.json` and survive a restart,
+firing history included, so a relaunch does not re-fire the past.
+
+| Live behaviour | Operation | Test |
+|---|---|---|
+| A due routine starts a real run in the Space | `agent_start` → `agent_list` → `agent_stop` | `RoutinesLiveTests.testADueRoutineStartsARealAgentRunInTheSpace` |
+| The background loop fires without being ticked | same | `testTheBackgroundSchedulerLoopFiresWithoutBeingTicked` |
+| A group fans out to one real thread per member | `agent_start` / `agent_message` per member | `testAGroupChatFansOutToRealAgentThreads` |
+
+A group chat holds **2-6 Bots plus one human**, enforced in `GroupChat`'s
+initialiser rather than in a view, so an out-of-bounds group cannot be built by
+going round the UI. Hitting either limit produces a named error, a banner, and a
+line in the group transcript saying what the limit is.
+
+Everything in `Design/BotAvatar.swift`'s motion section and the affordance
+section of `Mobile/Transcript.swift` (typing indicator, reaction bar, link card,
+approval card) is outside the export renders `RUBRIC.md` describes. The
+approval card **enforces nothing**: there is no approval primitive in the
+Spaces tool contract (`FRICTION.md` §43), `agent_start` runs auto-approved, and
+`ApprovalCard.enforcementIsImplemented` is `false` so no caller can mistake the
+card for a control.
diff --git a/samples/openkoalabot-example-swift/RUBRIC.md b/examples/openkoalabot-example-swift/RUBRIC.md
similarity index 100%
rename from samples/openkoalabot-example-swift/RUBRIC.md
rename to examples/openkoalabot-example-swift/RUBRIC.md
diff --git a/samples/openkoalabot-example-swift/Sources/OpenKoalaBotExample/AgentComputer/AgentScreenSource.swift b/examples/openkoalabot-example-swift/Sources/OpenKoalaBotExample/AgentComputer/AgentScreenSource.swift
similarity index 100%
rename from samples/openkoalabot-example-swift/Sources/OpenKoalaBotExample/AgentComputer/AgentScreenSource.swift
rename to examples/openkoalabot-example-swift/Sources/OpenKoalaBotExample/AgentComputer/AgentScreenSource.swift
diff --git a/samples/openkoalabot-example-swift/Sources/OpenKoalaBotExample/AgentComputer/FileDragAndDrop.swift b/examples/openkoalabot-example-swift/Sources/OpenKoalaBotExample/AgentComputer/FileDragAndDrop.swift
similarity index 100%
rename from samples/openkoalabot-example-swift/Sources/OpenKoalaBotExample/AgentComputer/FileDragAndDrop.swift
rename to examples/openkoalabot-example-swift/Sources/OpenKoalaBotExample/AgentComputer/FileDragAndDrop.swift
diff --git a/samples/openkoalabot-example-swift/Sources/OpenKoalaBotExample/AgentComputer/FixtureRemoteScreen.swift b/examples/openkoalabot-example-swift/Sources/OpenKoalaBotExample/AgentComputer/FixtureRemoteScreen.swift
similarity index 100%
rename from samples/openkoalabot-example-swift/Sources/OpenKoalaBotExample/AgentComputer/FixtureRemoteScreen.swift
rename to examples/openkoalabot-example-swift/Sources/OpenKoalaBotExample/AgentComputer/FixtureRemoteScreen.swift
diff --git a/samples/openkoalabot-example-swift/Sources/OpenKoalaBotExample/AgentComputer/LiveTierHarness.swift b/examples/openkoalabot-example-swift/Sources/OpenKoalaBotExample/AgentComputer/LiveTierHarness.swift
similarity index 100%
rename from samples/openkoalabot-example-swift/Sources/OpenKoalaBotExample/AgentComputer/LiveTierHarness.swift
rename to examples/openkoalabot-example-swift/Sources/OpenKoalaBotExample/AgentComputer/LiveTierHarness.swift
diff --git a/samples/openkoalabot-example-swift/Sources/OpenKoalaBotExample/AgentComputer/PresenceCursors.swift b/examples/openkoalabot-example-swift/Sources/OpenKoalaBotExample/AgentComputer/PresenceCursors.swift
similarity index 100%
rename from samples/openkoalabot-example-swift/Sources/OpenKoalaBotExample/AgentComputer/PresenceCursors.swift
rename to examples/openkoalabot-example-swift/Sources/OpenKoalaBotExample/AgentComputer/PresenceCursors.swift
diff --git a/samples/openkoalabot-example-swift/Sources/OpenKoalaBotExample/AgentComputer/SpaceWindowList.swift b/examples/openkoalabot-example-swift/Sources/OpenKoalaBotExample/AgentComputer/SpaceWindowList.swift
similarity index 100%
rename from samples/openkoalabot-example-swift/Sources/OpenKoalaBotExample/AgentComputer/SpaceWindowList.swift
rename to examples/openkoalabot-example-swift/Sources/OpenKoalaBotExample/AgentComputer/SpaceWindowList.swift
diff --git a/samples/openkoalabot-example-swift/Sources/OpenKoalaBotExample/AgentComputer/WindowDragAndDrop.swift b/examples/openkoalabot-example-swift/Sources/OpenKoalaBotExample/AgentComputer/WindowDragAndDrop.swift
similarity index 100%
rename from samples/openkoalabot-example-swift/Sources/OpenKoalaBotExample/AgentComputer/WindowDragAndDrop.swift
rename to examples/openkoalabot-example-swift/Sources/OpenKoalaBotExample/AgentComputer/WindowDragAndDrop.swift
diff --git a/samples/openkoalabot-example-swift/Sources/OpenKoalaBotExample/AgentComputer/WindowIcons.swift b/examples/openkoalabot-example-swift/Sources/OpenKoalaBotExample/AgentComputer/WindowIcons.swift
similarity index 100%
rename from samples/openkoalabot-example-swift/Sources/OpenKoalaBotExample/AgentComputer/WindowIcons.swift
rename to examples/openkoalabot-example-swift/Sources/OpenKoalaBotExample/AgentComputer/WindowIcons.swift
diff --git a/samples/openkoalabot-example-swift/Sources/OpenKoalaBotExample/App/AppModel.swift b/examples/openkoalabot-example-swift/Sources/OpenKoalaBotExample/App/AppModel.swift
similarity index 100%
rename from samples/openkoalabot-example-swift/Sources/OpenKoalaBotExample/App/AppModel.swift
rename to examples/openkoalabot-example-swift/Sources/OpenKoalaBotExample/App/AppModel.swift
diff --git a/samples/openkoalabot-example-swift/Sources/OpenKoalaBotExample/App/MainThreadProbe.swift b/examples/openkoalabot-example-swift/Sources/OpenKoalaBotExample/App/MainThreadProbe.swift
similarity index 100%
rename from samples/openkoalabot-example-swift/Sources/OpenKoalaBotExample/App/MainThreadProbe.swift
rename to examples/openkoalabot-example-swift/Sources/OpenKoalaBotExample/App/MainThreadProbe.swift
diff --git a/samples/openkoalabot-example-swift/Sources/OpenKoalaBotExample/App/OpenKoalaBotsApp.swift b/examples/openkoalabot-example-swift/Sources/OpenKoalaBotExample/App/OpenKoalaBotsApp.swift
similarity index 100%
rename from samples/openkoalabot-example-swift/Sources/OpenKoalaBotExample/App/OpenKoalaBotsApp.swift
rename to examples/openkoalabot-example-swift/Sources/OpenKoalaBotExample/App/OpenKoalaBotsApp.swift
diff --git a/samples/openkoalabot-example-swift/Sources/OpenKoalaBotExample/App/RootView.swift b/examples/openkoalabot-example-swift/Sources/OpenKoalaBotExample/App/RootView.swift
similarity index 100%
rename from samples/openkoalabot-example-swift/Sources/OpenKoalaBotExample/App/RootView.swift
rename to examples/openkoalabot-example-swift/Sources/OpenKoalaBotExample/App/RootView.swift
diff --git a/samples/openkoalabot-example-swift/Sources/OpenKoalaBotExample/App/UICapture.swift b/examples/openkoalabot-example-swift/Sources/OpenKoalaBotExample/App/UICapture.swift
similarity index 100%
rename from samples/openkoalabot-example-swift/Sources/OpenKoalaBotExample/App/UICapture.swift
rename to examples/openkoalabot-example-swift/Sources/OpenKoalaBotExample/App/UICapture.swift
diff --git a/samples/openkoalabot-example-swift/Sources/OpenKoalaBotExample/Design/BotAvatar.swift b/examples/openkoalabot-example-swift/Sources/OpenKoalaBotExample/Design/BotAvatar.swift
similarity index 100%
rename from samples/openkoalabot-example-swift/Sources/OpenKoalaBotExample/Design/BotAvatar.swift
rename to examples/openkoalabot-example-swift/Sources/OpenKoalaBotExample/Design/BotAvatar.swift
diff --git a/samples/openkoalabot-example-swift/Sources/OpenKoalaBotExample/Design/BotPresenceColor.swift b/examples/openkoalabot-example-swift/Sources/OpenKoalaBotExample/Design/BotPresenceColor.swift
similarity index 100%
rename from samples/openkoalabot-example-swift/Sources/OpenKoalaBotExample/Design/BotPresenceColor.swift
rename to examples/openkoalabot-example-swift/Sources/OpenKoalaBotExample/Design/BotPresenceColor.swift
diff --git a/samples/openkoalabot-example-swift/Sources/OpenKoalaBotExample/Design/KoalaArt.swift b/examples/openkoalabot-example-swift/Sources/OpenKoalaBotExample/Design/KoalaArt.swift
similarity index 99%
rename from samples/openkoalabot-example-swift/Sources/OpenKoalaBotExample/Design/KoalaArt.swift
rename to examples/openkoalabot-example-swift/Sources/OpenKoalaBotExample/Design/KoalaArt.swift
index 592d6eb709..7ef7ae6c7d 100644
--- a/samples/openkoalabot-example-swift/Sources/OpenKoalaBotExample/Design/KoalaArt.swift
+++ b/examples/openkoalabot-example-swift/Sources/OpenKoalaBotExample/Design/KoalaArt.swift
@@ -8,7 +8,7 @@ import SwiftUI
/// The OpenKoalaBots koala, drawn with SwiftUI shapes.
///
-/// Same geometry and colours as `samples/openkoalabots-assets/*.svg`: every
+/// Same geometry and colours as `examples/openkoalabots-assets/*.svg`: every
/// primitive below is one element of the SVG, in the SVG's own user units,
/// scaled into whatever frame the view is given. Edit the SVG and this file
/// together.
diff --git a/samples/openkoalabot-example-swift/Sources/OpenKoalaBotExample/Design/Markdown.swift b/examples/openkoalabot-example-swift/Sources/OpenKoalaBotExample/Design/Markdown.swift
similarity index 100%
rename from samples/openkoalabot-example-swift/Sources/OpenKoalaBotExample/Design/Markdown.swift
rename to examples/openkoalabot-example-swift/Sources/OpenKoalaBotExample/Design/Markdown.swift
diff --git a/samples/openkoalabot-example-swift/Sources/OpenKoalaBotExample/Design/MotionCatalog.swift b/examples/openkoalabot-example-swift/Sources/OpenKoalaBotExample/Design/MotionCatalog.swift
similarity index 100%
rename from samples/openkoalabot-example-swift/Sources/OpenKoalaBotExample/Design/MotionCatalog.swift
rename to examples/openkoalabot-example-swift/Sources/OpenKoalaBotExample/Design/MotionCatalog.swift
diff --git a/samples/openkoalabot-example-swift/Sources/OpenKoalaBotExample/Design/Palette.swift b/examples/openkoalabot-example-swift/Sources/OpenKoalaBotExample/Design/Palette.swift
similarity index 100%
rename from samples/openkoalabot-example-swift/Sources/OpenKoalaBotExample/Design/Palette.swift
rename to examples/openkoalabot-example-swift/Sources/OpenKoalaBotExample/Design/Palette.swift
diff --git a/samples/openkoalabot-example-swift/Sources/OpenKoalaBotExample/Design/Persona.swift b/examples/openkoalabot-example-swift/Sources/OpenKoalaBotExample/Design/Persona.swift
similarity index 100%
rename from samples/openkoalabot-example-swift/Sources/OpenKoalaBotExample/Design/Persona.swift
rename to examples/openkoalabot-example-swift/Sources/OpenKoalaBotExample/Design/Persona.swift
diff --git a/samples/openkoalabot-example-swift/Sources/OpenKoalaBotExample/Design/SharedComponents.swift b/examples/openkoalabot-example-swift/Sources/OpenKoalaBotExample/Design/SharedComponents.swift
similarity index 100%
rename from samples/openkoalabot-example-swift/Sources/OpenKoalaBotExample/Design/SharedComponents.swift
rename to examples/openkoalabot-example-swift/Sources/OpenKoalaBotExample/Design/SharedComponents.swift
diff --git a/samples/openkoalabot-example-swift/Sources/OpenKoalaBotExample/Design/Tokens.swift b/examples/openkoalabot-example-swift/Sources/OpenKoalaBotExample/Design/Tokens.swift
similarity index 100%
rename from samples/openkoalabot-example-swift/Sources/OpenKoalaBotExample/Design/Tokens.swift
rename to examples/openkoalabot-example-swift/Sources/OpenKoalaBotExample/Design/Tokens.swift
diff --git a/samples/openkoalabot-example-swift/Sources/OpenKoalaBotExample/Desktop/DesktopShell.swift b/examples/openkoalabot-example-swift/Sources/OpenKoalaBotExample/Desktop/DesktopShell.swift
similarity index 100%
rename from samples/openkoalabot-example-swift/Sources/OpenKoalaBotExample/Desktop/DesktopShell.swift
rename to examples/openkoalabot-example-swift/Sources/OpenKoalaBotExample/Desktop/DesktopShell.swift
diff --git a/samples/openkoalabot-example-swift/Sources/OpenKoalaBotExample/Desktop/KoalaShell.swift b/examples/openkoalabot-example-swift/Sources/OpenKoalaBotExample/Desktop/KoalaShell.swift
similarity index 100%
rename from samples/openkoalabot-example-swift/Sources/OpenKoalaBotExample/Desktop/KoalaShell.swift
rename to examples/openkoalabot-example-swift/Sources/OpenKoalaBotExample/Desktop/KoalaShell.swift
diff --git a/samples/openkoalabot-example-swift/Sources/OpenKoalaBotExample/Desktop/ShellChrome.swift b/examples/openkoalabot-example-swift/Sources/OpenKoalaBotExample/Desktop/ShellChrome.swift
similarity index 100%
rename from samples/openkoalabot-example-swift/Sources/OpenKoalaBotExample/Desktop/ShellChrome.swift
rename to examples/openkoalabot-example-swift/Sources/OpenKoalaBotExample/Desktop/ShellChrome.swift
diff --git a/samples/openkoalabot-example-swift/Sources/OpenKoalaBotExample/Desktop/ShellState.swift b/examples/openkoalabot-example-swift/Sources/OpenKoalaBotExample/Desktop/ShellState.swift
similarity index 100%
rename from samples/openkoalabot-example-swift/Sources/OpenKoalaBotExample/Desktop/ShellState.swift
rename to examples/openkoalabot-example-swift/Sources/OpenKoalaBotExample/Desktop/ShellState.swift
diff --git a/samples/openkoalabot-example-swift/Sources/OpenKoalaBotExample/Desktop/SignInView.swift b/examples/openkoalabot-example-swift/Sources/OpenKoalaBotExample/Desktop/SignInView.swift
similarity index 100%
rename from samples/openkoalabot-example-swift/Sources/OpenKoalaBotExample/Desktop/SignInView.swift
rename to examples/openkoalabot-example-swift/Sources/OpenKoalaBotExample/Desktop/SignInView.swift
diff --git a/samples/openkoalabot-example-swift/Sources/OpenKoalaBotExample/Desktop/SpaceDrop.swift b/examples/openkoalabot-example-swift/Sources/OpenKoalaBotExample/Desktop/SpaceDrop.swift
similarity index 100%
rename from samples/openkoalabot-example-swift/Sources/OpenKoalaBotExample/Desktop/SpaceDrop.swift
rename to examples/openkoalabot-example-swift/Sources/OpenKoalaBotExample/Desktop/SpaceDrop.swift
diff --git a/samples/openkoalabot-example-swift/Sources/OpenKoalaBotExample/Desktop/SpaceWizard.swift b/examples/openkoalabot-example-swift/Sources/OpenKoalaBotExample/Desktop/SpaceWizard.swift
similarity index 100%
rename from samples/openkoalabot-example-swift/Sources/OpenKoalaBotExample/Desktop/SpaceWizard.swift
rename to examples/openkoalabot-example-swift/Sources/OpenKoalaBotExample/Desktop/SpaceWizard.swift
diff --git a/samples/openkoalabot-example-swift/Sources/OpenKoalaBotExample/Desktop/Transcript.swift b/examples/openkoalabot-example-swift/Sources/OpenKoalaBotExample/Desktop/Transcript.swift
similarity index 100%
rename from samples/openkoalabot-example-swift/Sources/OpenKoalaBotExample/Desktop/Transcript.swift
rename to examples/openkoalabot-example-swift/Sources/OpenKoalaBotExample/Desktop/Transcript.swift
diff --git a/samples/openkoalabot-example-swift/Sources/OpenKoalaBotExample/Export/CLI.swift b/examples/openkoalabot-example-swift/Sources/OpenKoalaBotExample/Export/CLI.swift
similarity index 99%
rename from samples/openkoalabot-example-swift/Sources/OpenKoalaBotExample/Export/CLI.swift
rename to examples/openkoalabot-example-swift/Sources/OpenKoalaBotExample/Export/CLI.swift
index 79f05207f0..a810850dd7 100644
--- a/samples/openkoalabot-example-swift/Sources/OpenKoalaBotExample/Export/CLI.swift
+++ b/examples/openkoalabot-example-swift/Sources/OpenKoalaBotExample/Export/CLI.swift
@@ -531,7 +531,7 @@ if args.count >= 3, args[1] == "live-shell" {
}
if args.count >= 2, args[1] == "scenario" {
- // The shared headless scenario (samples/openkoalabot-example-scenario). No windows.
+ // The shared headless scenario (examples/openkoalabot-example-scenario). No windows.
exit(ScenarioRunner.main(Array(args.dropFirst(2))))
}
diff --git a/samples/openkoalabot-example-swift/Sources/OpenKoalaBotExample/Groups/GroupChatStore.swift b/examples/openkoalabot-example-swift/Sources/OpenKoalaBotExample/Groups/GroupChatStore.swift
similarity index 100%
rename from samples/openkoalabot-example-swift/Sources/OpenKoalaBotExample/Groups/GroupChatStore.swift
rename to examples/openkoalabot-example-swift/Sources/OpenKoalaBotExample/Groups/GroupChatStore.swift
diff --git a/samples/openkoalabot-example-swift/Sources/OpenKoalaBotExample/Groups/GroupChatView.swift b/examples/openkoalabot-example-swift/Sources/OpenKoalaBotExample/Groups/GroupChatView.swift
similarity index 100%
rename from samples/openkoalabot-example-swift/Sources/OpenKoalaBotExample/Groups/GroupChatView.swift
rename to examples/openkoalabot-example-swift/Sources/OpenKoalaBotExample/Groups/GroupChatView.swift
diff --git a/samples/openkoalabot-example-swift/Sources/OpenKoalaBotExample/Model/Account.swift b/examples/openkoalabot-example-swift/Sources/OpenKoalaBotExample/Model/Account.swift
similarity index 100%
rename from samples/openkoalabot-example-swift/Sources/OpenKoalaBotExample/Model/Account.swift
rename to examples/openkoalabot-example-swift/Sources/OpenKoalaBotExample/Model/Account.swift
diff --git a/samples/openkoalabot-example-swift/Sources/OpenKoalaBotExample/Model/AgentOutput.swift b/examples/openkoalabot-example-swift/Sources/OpenKoalaBotExample/Model/AgentOutput.swift
similarity index 100%
rename from samples/openkoalabot-example-swift/Sources/OpenKoalaBotExample/Model/AgentOutput.swift
rename to examples/openkoalabot-example-swift/Sources/OpenKoalaBotExample/Model/AgentOutput.swift
diff --git a/samples/openkoalabot-example-swift/Sources/OpenKoalaBotExample/Model/AppDataDirectory.swift b/examples/openkoalabot-example-swift/Sources/OpenKoalaBotExample/Model/AppDataDirectory.swift
similarity index 100%
rename from samples/openkoalabot-example-swift/Sources/OpenKoalaBotExample/Model/AppDataDirectory.swift
rename to examples/openkoalabot-example-swift/Sources/OpenKoalaBotExample/Model/AppDataDirectory.swift
diff --git a/samples/openkoalabot-example-swift/Sources/OpenKoalaBotExample/Model/BotData.swift b/examples/openkoalabot-example-swift/Sources/OpenKoalaBotExample/Model/BotData.swift
similarity index 100%
rename from samples/openkoalabot-example-swift/Sources/OpenKoalaBotExample/Model/BotData.swift
rename to examples/openkoalabot-example-swift/Sources/OpenKoalaBotExample/Model/BotData.swift
diff --git a/samples/openkoalabot-example-swift/Sources/OpenKoalaBotExample/Model/BotStore.swift b/examples/openkoalabot-example-swift/Sources/OpenKoalaBotExample/Model/BotStore.swift
similarity index 100%
rename from samples/openkoalabot-example-swift/Sources/OpenKoalaBotExample/Model/BotStore.swift
rename to examples/openkoalabot-example-swift/Sources/OpenKoalaBotExample/Model/BotStore.swift
diff --git a/samples/openkoalabot-example-swift/Sources/OpenKoalaBotExample/Model/Fixtures.swift b/examples/openkoalabot-example-swift/Sources/OpenKoalaBotExample/Model/Fixtures.swift
similarity index 100%
rename from samples/openkoalabot-example-swift/Sources/OpenKoalaBotExample/Model/Fixtures.swift
rename to examples/openkoalabot-example-swift/Sources/OpenKoalaBotExample/Model/Fixtures.swift
diff --git a/samples/openkoalabot-example-swift/Sources/OpenKoalaBotExample/Model/Model.swift b/examples/openkoalabot-example-swift/Sources/OpenKoalaBotExample/Model/Model.swift
similarity index 100%
rename from samples/openkoalabot-example-swift/Sources/OpenKoalaBotExample/Model/Model.swift
rename to examples/openkoalabot-example-swift/Sources/OpenKoalaBotExample/Model/Model.swift
diff --git a/samples/openkoalabot-example-swift/Sources/OpenKoalaBotExample/Routines/RoutineStore.swift b/examples/openkoalabot-example-swift/Sources/OpenKoalaBotExample/Routines/RoutineStore.swift
similarity index 100%
rename from samples/openkoalabot-example-swift/Sources/OpenKoalaBotExample/Routines/RoutineStore.swift
rename to examples/openkoalabot-example-swift/Sources/OpenKoalaBotExample/Routines/RoutineStore.swift
diff --git a/samples/openkoalabot-example-swift/Sources/OpenKoalaBotExample/Routines/RoutinesView.swift b/examples/openkoalabot-example-swift/Sources/OpenKoalaBotExample/Routines/RoutinesView.swift
similarity index 100%
rename from samples/openkoalabot-example-swift/Sources/OpenKoalaBotExample/Routines/RoutinesView.swift
rename to examples/openkoalabot-example-swift/Sources/OpenKoalaBotExample/Routines/RoutinesView.swift
diff --git a/samples/openkoalabot-example-swift/Sources/OpenKoalaBotExample/Scenario/ScenarioRunner.swift b/examples/openkoalabot-example-swift/Sources/OpenKoalaBotExample/Scenario/ScenarioRunner.swift
similarity index 99%
rename from samples/openkoalabot-example-swift/Sources/OpenKoalaBotExample/Scenario/ScenarioRunner.swift
rename to examples/openkoalabot-example-swift/Sources/OpenKoalaBotExample/Scenario/ScenarioRunner.swift
index 3a0a9ea115..a50d2f6225 100644
--- a/samples/openkoalabot-example-swift/Sources/OpenKoalaBotExample/Scenario/ScenarioRunner.swift
+++ b/examples/openkoalabot-example-swift/Sources/OpenKoalaBotExample/Scenario/ScenarioRunner.swift
@@ -7,7 +7,7 @@ import CuaSpaces
import CuaSpacesStreaming
import Foundation
-/// The shared openkoalabots scenario (`samples/openkoalabot-example-scenario/scenario.json`),
+/// The shared openkoalabots scenario (`examples/openkoalabot-example-scenario/scenario.json`),
/// run headlessly through this app's own Spaces code: `SDKSpacesClient` for the
/// Space and the agent thread, `SpaceStreamProvider` (what `LiveStreamSession`
/// streams from) for frames, and the SDK's Space handle for files, teleport
diff --git a/samples/openkoalabot-example-swift/Sources/OpenKoalaBotExample/Spaces/SDKSpaceCreation.swift b/examples/openkoalabot-example-swift/Sources/OpenKoalaBotExample/Spaces/SDKSpaceCreation.swift
similarity index 100%
rename from samples/openkoalabot-example-swift/Sources/OpenKoalaBotExample/Spaces/SDKSpaceCreation.swift
rename to examples/openkoalabot-example-swift/Sources/OpenKoalaBotExample/Spaces/SDKSpaceCreation.swift
diff --git a/samples/openkoalabot-example-swift/Sources/OpenKoalaBotExample/Spaces/SDKSpacesClient.swift b/examples/openkoalabot-example-swift/Sources/OpenKoalaBotExample/Spaces/SDKSpacesClient.swift
similarity index 100%
rename from samples/openkoalabot-example-swift/Sources/OpenKoalaBotExample/Spaces/SDKSpacesClient.swift
rename to examples/openkoalabot-example-swift/Sources/OpenKoalaBotExample/Spaces/SDKSpacesClient.swift
diff --git a/samples/openkoalabot-example-swift/Sources/OpenKoalaBotExample/Spaces/SandboxImages.generated.swift b/examples/openkoalabot-example-swift/Sources/OpenKoalaBotExample/Spaces/SandboxImages.generated.swift
similarity index 100%
rename from samples/openkoalabot-example-swift/Sources/OpenKoalaBotExample/Spaces/SandboxImages.generated.swift
rename to examples/openkoalabot-example-swift/Sources/OpenKoalaBotExample/Spaces/SandboxImages.generated.swift
diff --git a/samples/openkoalabot-example-swift/Sources/OpenKoalaBotExample/Spaces/SpaceCreation.swift b/examples/openkoalabot-example-swift/Sources/OpenKoalaBotExample/Spaces/SpaceCreation.swift
similarity index 100%
rename from samples/openkoalabot-example-swift/Sources/OpenKoalaBotExample/Spaces/SpaceCreation.swift
rename to examples/openkoalabot-example-swift/Sources/OpenKoalaBotExample/Spaces/SpaceCreation.swift
diff --git a/samples/openkoalabot-example-swift/Sources/OpenKoalaBotExample/Spaces/SpacesClient.swift b/examples/openkoalabot-example-swift/Sources/OpenKoalaBotExample/Spaces/SpacesClient.swift
similarity index 100%
rename from samples/openkoalabot-example-swift/Sources/OpenKoalaBotExample/Spaces/SpacesClient.swift
rename to examples/openkoalabot-example-swift/Sources/OpenKoalaBotExample/Spaces/SpacesClient.swift
diff --git a/samples/openkoalabot-example-swift/Tests/OpenKoalaBotExampleTests/AffordanceTests.swift b/examples/openkoalabot-example-swift/Tests/OpenKoalaBotExampleTests/AffordanceTests.swift
similarity index 100%
rename from samples/openkoalabot-example-swift/Tests/OpenKoalaBotExampleTests/AffordanceTests.swift
rename to examples/openkoalabot-example-swift/Tests/OpenKoalaBotExampleTests/AffordanceTests.swift
diff --git a/samples/openkoalabot-example-swift/Tests/OpenKoalaBotExampleTests/AppShellTests.swift b/examples/openkoalabot-example-swift/Tests/OpenKoalaBotExampleTests/AppShellTests.swift
similarity index 100%
rename from samples/openkoalabot-example-swift/Tests/OpenKoalaBotExampleTests/AppShellTests.swift
rename to examples/openkoalabot-example-swift/Tests/OpenKoalaBotExampleTests/AppShellTests.swift
diff --git a/samples/openkoalabot-example-swift/Tests/OpenKoalaBotExampleTests/BotColorTests.swift b/examples/openkoalabot-example-swift/Tests/OpenKoalaBotExampleTests/BotColorTests.swift
similarity index 100%
rename from samples/openkoalabot-example-swift/Tests/OpenKoalaBotExampleTests/BotColorTests.swift
rename to examples/openkoalabot-example-swift/Tests/OpenKoalaBotExampleTests/BotColorTests.swift
diff --git a/samples/openkoalabot-example-swift/Tests/OpenKoalaBotExampleTests/BotStoreLiveTests.swift b/examples/openkoalabot-example-swift/Tests/OpenKoalaBotExampleTests/BotStoreLiveTests.swift
similarity index 100%
rename from samples/openkoalabot-example-swift/Tests/OpenKoalaBotExampleTests/BotStoreLiveTests.swift
rename to examples/openkoalabot-example-swift/Tests/OpenKoalaBotExampleTests/BotStoreLiveTests.swift
diff --git a/samples/openkoalabot-example-swift/Tests/OpenKoalaBotExampleTests/BotStoreTests.swift b/examples/openkoalabot-example-swift/Tests/OpenKoalaBotExampleTests/BotStoreTests.swift
similarity index 100%
rename from samples/openkoalabot-example-swift/Tests/OpenKoalaBotExampleTests/BotStoreTests.swift
rename to examples/openkoalabot-example-swift/Tests/OpenKoalaBotExampleTests/BotStoreTests.swift
diff --git a/samples/openkoalabot-example-swift/Tests/OpenKoalaBotExampleTests/CuaShellTests.swift b/examples/openkoalabot-example-swift/Tests/OpenKoalaBotExampleTests/CuaShellTests.swift
similarity index 100%
rename from samples/openkoalabot-example-swift/Tests/OpenKoalaBotExampleTests/CuaShellTests.swift
rename to examples/openkoalabot-example-swift/Tests/OpenKoalaBotExampleTests/CuaShellTests.swift
diff --git a/samples/openkoalabot-example-swift/Tests/OpenKoalaBotExampleTests/DropAndStreamTests.swift b/examples/openkoalabot-example-swift/Tests/OpenKoalaBotExampleTests/DropAndStreamTests.swift
similarity index 100%
rename from samples/openkoalabot-example-swift/Tests/OpenKoalaBotExampleTests/DropAndStreamTests.swift
rename to examples/openkoalabot-example-swift/Tests/OpenKoalaBotExampleTests/DropAndStreamTests.swift
diff --git a/samples/openkoalabot-example-swift/Tests/OpenKoalaBotExampleTests/GroupChatTests.swift b/examples/openkoalabot-example-swift/Tests/OpenKoalaBotExampleTests/GroupChatTests.swift
similarity index 100%
rename from samples/openkoalabot-example-swift/Tests/OpenKoalaBotExampleTests/GroupChatTests.swift
rename to examples/openkoalabot-example-swift/Tests/OpenKoalaBotExampleTests/GroupChatTests.swift
diff --git a/samples/openkoalabot-example-swift/Tests/OpenKoalaBotExampleTests/LiveSpace.swift b/examples/openkoalabot-example-swift/Tests/OpenKoalaBotExampleTests/LiveSpace.swift
similarity index 100%
rename from samples/openkoalabot-example-swift/Tests/OpenKoalaBotExampleTests/LiveSpace.swift
rename to examples/openkoalabot-example-swift/Tests/OpenKoalaBotExampleTests/LiveSpace.swift
diff --git a/samples/openkoalabot-example-swift/Tests/OpenKoalaBotExampleTests/MarkdownTests.swift b/examples/openkoalabot-example-swift/Tests/OpenKoalaBotExampleTests/MarkdownTests.swift
similarity index 100%
rename from samples/openkoalabot-example-swift/Tests/OpenKoalaBotExampleTests/MarkdownTests.swift
rename to examples/openkoalabot-example-swift/Tests/OpenKoalaBotExampleTests/MarkdownTests.swift
diff --git a/samples/openkoalabot-example-swift/Tests/OpenKoalaBotExampleTests/PendingSendTests.swift b/examples/openkoalabot-example-swift/Tests/OpenKoalaBotExampleTests/PendingSendTests.swift
similarity index 100%
rename from samples/openkoalabot-example-swift/Tests/OpenKoalaBotExampleTests/PendingSendTests.swift
rename to examples/openkoalabot-example-swift/Tests/OpenKoalaBotExampleTests/PendingSendTests.swift
diff --git a/samples/openkoalabot-example-swift/Tests/OpenKoalaBotExampleTests/PiPLiveTests.swift b/examples/openkoalabot-example-swift/Tests/OpenKoalaBotExampleTests/PiPLiveTests.swift
similarity index 100%
rename from samples/openkoalabot-example-swift/Tests/OpenKoalaBotExampleTests/PiPLiveTests.swift
rename to examples/openkoalabot-example-swift/Tests/OpenKoalaBotExampleTests/PiPLiveTests.swift
diff --git a/samples/openkoalabot-example-swift/Tests/OpenKoalaBotExampleTests/PresenceLiveTests.swift b/examples/openkoalabot-example-swift/Tests/OpenKoalaBotExampleTests/PresenceLiveTests.swift
similarity index 100%
rename from samples/openkoalabot-example-swift/Tests/OpenKoalaBotExampleTests/PresenceLiveTests.swift
rename to examples/openkoalabot-example-swift/Tests/OpenKoalaBotExampleTests/PresenceLiveTests.swift
diff --git a/samples/openkoalabot-example-swift/Tests/OpenKoalaBotExampleTests/RoutineTests.swift b/examples/openkoalabot-example-swift/Tests/OpenKoalaBotExampleTests/RoutineTests.swift
similarity index 100%
rename from samples/openkoalabot-example-swift/Tests/OpenKoalaBotExampleTests/RoutineTests.swift
rename to examples/openkoalabot-example-swift/Tests/OpenKoalaBotExampleTests/RoutineTests.swift
diff --git a/samples/openkoalabot-example-swift/Tests/OpenKoalaBotExampleTests/RoutinesLiveTests.swift b/examples/openkoalabot-example-swift/Tests/OpenKoalaBotExampleTests/RoutinesLiveTests.swift
similarity index 100%
rename from samples/openkoalabot-example-swift/Tests/OpenKoalaBotExampleTests/RoutinesLiveTests.swift
rename to examples/openkoalabot-example-swift/Tests/OpenKoalaBotExampleTests/RoutinesLiveTests.swift
diff --git a/samples/openkoalabot-example-swift/Tests/OpenKoalaBotExampleTests/ScenarioTests.swift b/examples/openkoalabot-example-swift/Tests/OpenKoalaBotExampleTests/ScenarioTests.swift
similarity index 100%
rename from samples/openkoalabot-example-swift/Tests/OpenKoalaBotExampleTests/ScenarioTests.swift
rename to examples/openkoalabot-example-swift/Tests/OpenKoalaBotExampleTests/ScenarioTests.swift
diff --git a/samples/openkoalabot-example-swift/Tests/OpenKoalaBotExampleTests/SpaceCreationTests.swift b/examples/openkoalabot-example-swift/Tests/OpenKoalaBotExampleTests/SpaceCreationTests.swift
similarity index 100%
rename from samples/openkoalabot-example-swift/Tests/OpenKoalaBotExampleTests/SpaceCreationTests.swift
rename to examples/openkoalabot-example-swift/Tests/OpenKoalaBotExampleTests/SpaceCreationTests.swift
diff --git a/samples/openkoalabot-example-swift/Tests/OpenKoalaBotExampleTests/SpaceDropTests.swift b/examples/openkoalabot-example-swift/Tests/OpenKoalaBotExampleTests/SpaceDropTests.swift
similarity index 100%
rename from samples/openkoalabot-example-swift/Tests/OpenKoalaBotExampleTests/SpaceDropTests.swift
rename to examples/openkoalabot-example-swift/Tests/OpenKoalaBotExampleTests/SpaceDropTests.swift
diff --git a/samples/openkoalabot-example-swift/Tests/OpenKoalaBotExampleTests/SpaceHygiene.swift b/examples/openkoalabot-example-swift/Tests/OpenKoalaBotExampleTests/SpaceHygiene.swift
similarity index 100%
rename from samples/openkoalabot-example-swift/Tests/OpenKoalaBotExampleTests/SpaceHygiene.swift
rename to examples/openkoalabot-example-swift/Tests/OpenKoalaBotExampleTests/SpaceHygiene.swift
diff --git a/samples/openkoalabot-example-swift/Tests/OpenKoalaBotExampleTests/SpacesE2ETests.swift b/examples/openkoalabot-example-swift/Tests/OpenKoalaBotExampleTests/SpacesE2ETests.swift
similarity index 100%
rename from samples/openkoalabot-example-swift/Tests/OpenKoalaBotExampleTests/SpacesE2ETests.swift
rename to examples/openkoalabot-example-swift/Tests/OpenKoalaBotExampleTests/SpacesE2ETests.swift
diff --git a/samples/openkoalabot-example-swift/Tests/OpenKoalaBotExampleTests/WindowIconsTests.swift b/examples/openkoalabot-example-swift/Tests/OpenKoalaBotExampleTests/WindowIconsTests.swift
similarity index 100%
rename from samples/openkoalabot-example-swift/Tests/OpenKoalaBotExampleTests/WindowIconsTests.swift
rename to examples/openkoalabot-example-swift/Tests/OpenKoalaBotExampleTests/WindowIconsTests.swift
diff --git a/samples/openkoalabot-example-swift/Tests/OpenKoalaBotExampleTests/XCTAssertCompat.swift b/examples/openkoalabot-example-swift/Tests/OpenKoalaBotExampleTests/XCTAssertCompat.swift
similarity index 100%
rename from samples/openkoalabot-example-swift/Tests/OpenKoalaBotExampleTests/XCTAssertCompat.swift
rename to examples/openkoalabot-example-swift/Tests/OpenKoalaBotExampleTests/XCTAssertCompat.swift
diff --git a/samples/openkoalabot-example-swift/scripts/gen-images.mjs b/examples/openkoalabot-example-swift/scripts/gen-images.mjs
similarity index 100%
rename from samples/openkoalabot-example-swift/scripts/gen-images.mjs
rename to examples/openkoalabot-example-swift/scripts/gen-images.mjs
diff --git a/samples/openkoalabot-example-swift/scripts/test.sh b/examples/openkoalabot-example-swift/scripts/test.sh
similarity index 100%
rename from samples/openkoalabot-example-swift/scripts/test.sh
rename to examples/openkoalabot-example-swift/scripts/test.sh
diff --git a/samples/openkoalabot-example-tauri/.gitignore b/examples/openkoalabot-example-tauri/.gitignore
similarity index 100%
rename from samples/openkoalabot-example-tauri/.gitignore
rename to examples/openkoalabot-example-tauri/.gitignore
diff --git a/samples/openkoalabot-example-swift/LICENSE b/examples/openkoalabot-example-tauri/LICENSE
similarity index 100%
rename from samples/openkoalabot-example-swift/LICENSE
rename to examples/openkoalabot-example-tauri/LICENSE
diff --git a/examples/openkoalabot-example-tauri/README.md b/examples/openkoalabot-example-tauri/README.md
new file mode 100644
index 0000000000..cb2f6ecee0
--- /dev/null
+++ b/examples/openkoalabot-example-tauri/README.md
@@ -0,0 +1,145 @@
+# OpenKoalaBots (Rust + Tauri)
+
+A desktop app where you hire named Bots, give each one its own computer (a
+Space), and watch it work beside the thread. Built on the cua SDK's Rust
+crates with a Tauri 2 shell and a React UI.
+
+```sh
+npx degit trycua/cua/examples/openkoalabot-example-tauri my-app
+cd my-app && pnpm install
+pnpm tauri dev
+```
+
+> The cua crates and the image list are not published yet, so a degit copy
+> does not build on its own today. Until they are, develop inside the cua
+> repo (below).
+
+## Developing inside the cua repo
+
+This example depends on the cua SDK by path, as a local workspace override:
+
+| Dependency | Where it comes from today |
+|---|---|
+| `cua-spaces`, `cua-sandbox-core`, `cua-daemon` | `../../../libs/cua/crates/*` (path dependencies in `src-tauri/Cargo.toml`) |
+| The sandbox image list | `../../libs/images/sandbox-images.json`, imported by the UI (`ui/src/images.ts`) and compiled into the core (`src-tauri/core/src/plan.rs`) |
+
+None of these are on crates.io or npm yet. Once they are, the path
+dependencies become version dependencies and the degit quick start above
+works as is.
+
+```sh
+cd examples/openkoalabot-example-tauri
+pnpm install --frozen-lockfile
+pnpm tauri dev # Vite on :1430 plus the Rust shell
+```
+
+## What is in it
+
+| Path | What |
+|---|---|
+| `src-tauri/core` (`openkoalabot-example-core`) | The app logic, headless, on `cua-spaces`: add, create and delete a Space, the desktop and per-window streams (media tickets), the window list, one agent thread per Bot, SHA-256 verified file drops, approval-gated session teleport (it ships with Cua Spaces; see below), presence, and the New Space plan (`plan.rs`). Also the `openkoalabot-example-scenario` runner. |
+| `src-tauri/app` (`openkoalabot-example-tauri`) | The Tauri shell. Every command is a one-liner over the core. Local Spaces run on the SDK's own runtime (`cua_daemon::local::VmmLocal`: containers, QEMU, Lume). |
+| `ui/` | The webview (Vite + React): the Bots roster, one thread per Bot with step, status, approval and file cards, the docked composer, the Computer panel (live desktop over media wire v2, decoded with WebCodecs, picture in picture, window list, drop zone), the New Space wizard and the teleport approval sheet. |
+| `ui/src/assets` | The koala artwork (copied from `examples/openkoalabots-assets`). |
+
+The UI follows the system's light or dark mode.
+
+## Spaces
+
+**New Space** opens a four-step wizard (System, Resources, Options,
+Summary). The image dropdown lists the `published` entries of the shared
+image list, and each entry names the engine it runs on in each location, so
+the wizard never offers a combination the image cannot run. Create makes one
+SDK call, `Spaces::create(SpaceCreate { on, image, kind, runtime, name, .. })`:
+
+| Where | `on` | `kind` / `runtime` |
+|---|---|---|
+| This machine | `local` | container / `auto` (gVisor when available), vm / `qemu`, vm / `lume`; plus `cpus`, `memory_mb` |
+| Cua Cloud | `cloud` | Ended: a cloud plan fails with "Cua Cloud has ended; use a local sandbox or your own machine". Create the Space on This machine instead. |
+
+**Add by address** (in the wizard footer or the empty state) registers a
+machine that already runs cua-spacesd, for example a local container:
+
+```sh
+TOKEN=$(openssl rand -hex 16)
+docker run -d --name cua-e2e-openkoalabots --runtime=runsc --memory=4g -e CUA_ENV_TOKEN=$TOKEN \
+ -p 127.0.0.1:3211:3211 cua-e2e-local/linux:docker-local-arm64
+# then add 127.0.0.1:3211 with $TOKEN
+```
+
+**Delete…** is a separate control that always asks first: a Space the app
+created (in Cua Cloud or on this machine) is deleted with its sandbox; a Space
+added by address is only removed from the list.
+
+## Teleport
+
+Teleport ships with Cua Spaces (source-available), not with the MIT SDK
+this sample uses.
+
+- **Session teleport** (the approval sheet) calls the Spaces tools
+ `teleport_manifest` and `teleport_app` (`openkoalabot_example_core::teleport`).
+ The app runs the Spaces runtime in process with no teleport extension, so
+ the runtime refuses with `HostCapabilityMissing` and the sheet shows
+ "Session teleport ships with Cua Spaces (source-available)."
+- **App teleport** (the app picker, dropped app bundles and window drags) is
+ not part of this sample. The drop zone's **Teleport an app…** button and a
+ dropped app bundle show "App teleport ships with Cua Spaces
+ (source-available)." and send nothing.
+
+The Computer panel has one drop zone, the SDK's `<cua-drop-zone>`. Dropped
+files upload (SHA-256 verified); **Send file…** picks files to upload.
+
+## Picture in picture
+
+The PiP button on the stream pops the desktop out; each row of the window
+list pops out that one window. Each is a small always-on-top window
+(`open_pip`) with its own media session, closed with it. Labels and routes
+come from `@trycua/cua/spaces/pip` (`pipWindowLabel`, `encodePipRoute`).
+
+## Host safety
+
+The app keeps its Spaces registry and local sandbox state in its own data
+directory (never `~/.cua`). Tests and the scenario use temp registries.
+
+`OPENKOALABOTS_WALKTHROUGH=<file.json>` runs a scripted demo through the same
+commands a person uses (add Spaces, hire Bots, send messages, open a sheet);
+see the `Walkthrough` type in `ui/src/api.ts`.
+
+## Tests
+
+```sh
+pnpm test # vitest: 57 tests (image dropdown, wizard, thread cards, Space section, media wire, PiP, drop zone, error messages)
+cd src-tauri
+cargo test -p openkoalabot-example-core -- --test-threads=4 # 34 unit + 8 hermetic + 4 plan
+cargo build -p openkoalabot-example-tauri --features custom-protocol # the shell, serving ui/dist (run `pnpm build` first)
+OKB_WEBVIEW_ISOLATION=1 cargo test -p openkoalabot-example-tauri --features custom-protocol --test webview_isolation # macOS: a temp-HOME run writes nothing under the real ~/Library
+```
+
+Webview data stays in the app's data directory (`$HOME/Library/Application Support/ai.cua.openkoalabot.example` on macOS): a data directory under it on Windows and Linux, a non-persistent store on macOS. The page's saved state (Bots, selection, threads) is `ui-state.json` there, not web storage.
+
+The hermetic tests run against the SDK's in-process mock cua-spacesd
+(`cua_spacesd_client::testing`) on loopback: processes are simulated and
+files live in memory, so nothing runs on or writes to the host. The mock has
+no file transfers, so there a drop is checked to fail loudly; the docker lane
+of the scenario covers real drops. Teleport is checked to refuse with the
+Cua Spaces message. `tests/plan.rs`
+checks that a wizard plan reaches the SDK as the right call (a recording fake
+`LocalRuntime`, no container or VM is started).
+
+## Scenario
+
+```sh
+cd src-tauri && cargo build -p openkoalabot-example-core --bins
+../../openkoalabot-example-scenario/run.sh --impl tauri --lane fixture # no docker
+../../openkoalabot-example-scenario/run.sh --impl tauri --lane docker # linux, runsc, 4 GiB
+```
+
+The same behaviour ships in [`openkoalabot-example-swift`](../openkoalabot-example-swift)
+and [`openkoalabot-example-ts`](../openkoalabot-example-ts); all three pass the shared
+scenario in [`openkoalabot-example-scenario`](../openkoalabot-example-scenario).
+
+## License
+
+Source-available under [FSL-1.1-MIT](LICENSE): its live stream uses the
+streaming client that ships with Cua Spaces (`cua-spaces-ext`). Each release
+becomes MIT two years after it ships.
diff --git a/samples/openkoalabot-example-tauri/package.json b/examples/openkoalabot-example-tauri/package.json
similarity index 100%
rename from samples/openkoalabot-example-tauri/package.json
rename to examples/openkoalabot-example-tauri/package.json
diff --git a/samples/openkoalabot-example-tauri/pnpm-lock.yaml b/examples/openkoalabot-example-tauri/pnpm-lock.yaml
similarity index 100%
rename from samples/openkoalabot-example-tauri/pnpm-lock.yaml
rename to examples/openkoalabot-example-tauri/pnpm-lock.yaml
diff --git a/samples/openkoalabot-example-tauri/src-tauri/.cargo/config.toml b/examples/openkoalabot-example-tauri/src-tauri/.cargo/config.toml
similarity index 100%
rename from samples/openkoalabot-example-tauri/src-tauri/.cargo/config.toml
rename to examples/openkoalabot-example-tauri/src-tauri/.cargo/config.toml
diff --git a/samples/openkoalabot-example-tauri/src-tauri/Cargo.lock b/examples/openkoalabot-example-tauri/src-tauri/Cargo.lock
similarity index 100%
rename from samples/openkoalabot-example-tauri/src-tauri/Cargo.lock
rename to examples/openkoalabot-example-tauri/src-tauri/Cargo.lock
diff --git a/samples/openkoalabot-example-tauri/src-tauri/Cargo.toml b/examples/openkoalabot-example-tauri/src-tauri/Cargo.toml
similarity index 95%
rename from samples/openkoalabot-example-tauri/src-tauri/Cargo.toml
rename to examples/openkoalabot-example-tauri/src-tauri/Cargo.toml
index a5c70c5e5d..15859a531a 100644
--- a/samples/openkoalabot-example-tauri/src-tauri/Cargo.toml
+++ b/examples/openkoalabot-example-tauri/src-tauri/Cargo.toml
@@ -2,7 +2,7 @@
#
# - `core/` (`openkoalabot-example-core`): the app logic, headless. Depends on the
# Spaces runtime (`cua-spaces`, libs/cua) directly. Also builds the
-# `openkoalabot-example-scenario` runner for samples/openkoalabot-example-scenario.
+# `openkoalabot-example-scenario` runner for examples/openkoalabot-example-scenario.
# - `app/` (`openkoalabot-example-tauri`): the Tauri 2 shell; every command is a
# one-liner over `openkoalabot-example-core`.
[workspace]
diff --git a/samples/openkoalabot-example-tauri/src-tauri/app/Cargo.toml b/examples/openkoalabot-example-tauri/src-tauri/app/Cargo.toml
similarity index 100%
rename from samples/openkoalabot-example-tauri/src-tauri/app/Cargo.toml
rename to examples/openkoalabot-example-tauri/src-tauri/app/Cargo.toml
diff --git a/samples/openkoalabot-example-tauri/src-tauri/app/build.rs b/examples/openkoalabot-example-tauri/src-tauri/app/build.rs
similarity index 100%
rename from samples/openkoalabot-example-tauri/src-tauri/app/build.rs
rename to examples/openkoalabot-example-tauri/src-tauri/app/build.rs
diff --git a/samples/openkoalabot-example-tauri/src-tauri/app/capabilities/default.json b/examples/openkoalabot-example-tauri/src-tauri/app/capabilities/default.json
similarity index 100%
rename from samples/openkoalabot-example-tauri/src-tauri/app/capabilities/default.json
rename to examples/openkoalabot-example-tauri/src-tauri/app/capabilities/default.json
diff --git a/samples/openkoalabot-example-tauri/src-tauri/app/icons/128x128.png b/examples/openkoalabot-example-tauri/src-tauri/app/icons/128x128.png
similarity index 100%
rename from samples/openkoalabot-example-tauri/src-tauri/app/icons/128x128.png
rename to examples/openkoalabot-example-tauri/src-tauri/app/icons/128x128.png
diff --git a/samples/openkoalabot-example-tauri/src-tauri/app/icons/[email protected] b/examples/openkoalabot-example-tauri/src-tauri/app/icons/[email protected]
similarity index 100%
rename from samples/openkoalabot-example-tauri/src-tauri/app/icons/[email protected]
rename to examples/openkoalabot-example-tauri/src-tauri/app/icons/[email protected]
diff --git a/samples/openkoalabot-example-tauri/src-tauri/app/icons/32x32.png b/examples/openkoalabot-example-tauri/src-tauri/app/icons/32x32.png
similarity index 100%
rename from samples/openkoalabot-example-tauri/src-tauri/app/icons/32x32.png
rename to examples/openkoalabot-example-tauri/src-tauri/app/icons/32x32.png
diff --git a/samples/openkoalabot-example-tauri/src-tauri/app/icons/icon.icns b/examples/openkoalabot-example-tauri/src-tauri/app/icons/icon.icns
similarity index 100%
rename from samples/openkoalabot-example-tauri/src-tauri/app/icons/icon.icns
rename to examples/openkoalabot-example-tauri/src-tauri/app/icons/icon.icns
diff --git a/samples/openkoalabot-example-tauri/src-tauri/app/icons/icon.ico b/examples/openkoalabot-example-tauri/src-tauri/app/icons/icon.ico
similarity index 100%
rename from samples/openkoalabot-example-tauri/src-tauri/app/icons/icon.ico
rename to examples/openkoalabot-example-tauri/src-tauri/app/icons/icon.ico
diff --git a/samples/openkoalabot-example-tauri/src-tauri/app/icons/icon.png b/examples/openkoalabot-example-tauri/src-tauri/app/icons/icon.png
similarity index 100%
rename from samples/openkoalabot-example-tauri/src-tauri/app/icons/icon.png
rename to examples/openkoalabot-example-tauri/src-tauri/app/icons/icon.png
diff --git a/samples/openkoalabot-example-tauri/src-tauri/app/src/lib.rs b/examples/openkoalabot-example-tauri/src-tauri/app/src/lib.rs
similarity index 100%
rename from samples/openkoalabot-example-tauri/src-tauri/app/src/lib.rs
rename to examples/openkoalabot-example-tauri/src-tauri/app/src/lib.rs
diff --git a/samples/openkoalabot-example-tauri/src-tauri/app/src/main.rs b/examples/openkoalabot-example-tauri/src-tauri/app/src/main.rs
similarity index 100%
rename from samples/openkoalabot-example-tauri/src-tauri/app/src/main.rs
rename to examples/openkoalabot-example-tauri/src-tauri/app/src/main.rs
diff --git a/samples/openkoalabot-example-tauri/src-tauri/app/tauri.conf.json b/examples/openkoalabot-example-tauri/src-tauri/app/tauri.conf.json
similarity index 100%
rename from samples/openkoalabot-example-tauri/src-tauri/app/tauri.conf.json
rename to examples/openkoalabot-example-tauri/src-tauri/app/tauri.conf.json
diff --git a/samples/openkoalabot-example-tauri/src-tauri/app/tests/webview_isolation.rs b/examples/openkoalabot-example-tauri/src-tauri/app/tests/webview_isolation.rs
similarity index 100%
rename from samples/openkoalabot-example-tauri/src-tauri/app/tests/webview_isolation.rs
rename to examples/openkoalabot-example-tauri/src-tauri/app/tests/webview_isolation.rs
diff --git a/samples/openkoalabot-example-tauri/src-tauri/core/Cargo.toml b/examples/openkoalabot-example-tauri/src-tauri/core/Cargo.toml
similarity index 93%
rename from samples/openkoalabot-example-tauri/src-tauri/core/Cargo.toml
rename to examples/openkoalabot-example-tauri/src-tauri/core/Cargo.toml
index ae72dcc023..b77343654b 100644
--- a/samples/openkoalabot-example-tauri/src-tauri/core/Cargo.toml
+++ b/examples/openkoalabot-example-tauri/src-tauri/core/Cargo.toml
@@ -8,7 +8,7 @@ license.workspace = true
publish.workspace = true
[[bin]]
-# Runs samples/openkoalabot-example-scenario/scenario.json headlessly.
+# Runs examples/openkoalabot-example-scenario/scenario.json headlessly.
name = "openkoalabot-example-scenario"
path = "src/bin/openkoalabot-example-scenario.rs"
diff --git a/samples/openkoalabot-example-tauri/src-tauri/core/src/bin/openkoalabot-example-scenario.rs b/examples/openkoalabot-example-tauri/src-tauri/core/src/bin/openkoalabot-example-scenario.rs
similarity index 100%
rename from samples/openkoalabot-example-tauri/src-tauri/core/src/bin/openkoalabot-example-scenario.rs
rename to examples/openkoalabot-example-tauri/src-tauri/core/src/bin/openkoalabot-example-scenario.rs
diff --git a/samples/openkoalabot-example-tauri/src-tauri/core/src/bots.rs b/examples/openkoalabot-example-tauri/src-tauri/core/src/bots.rs
similarity index 100%
rename from samples/openkoalabot-example-tauri/src-tauri/core/src/bots.rs
rename to examples/openkoalabot-example-tauri/src-tauri/core/src/bots.rs
diff --git a/samples/openkoalabot-example-tauri/src-tauri/core/src/error.rs b/examples/openkoalabot-example-tauri/src-tauri/core/src/error.rs
similarity index 100%
rename from samples/openkoalabot-example-tauri/src-tauri/core/src/error.rs
rename to examples/openkoalabot-example-tauri/src-tauri/core/src/error.rs
diff --git a/samples/openkoalabot-example-tauri/src-tauri/core/src/files.rs b/examples/openkoalabot-example-tauri/src-tauri/core/src/files.rs
similarity index 97%
rename from samples/openkoalabot-example-tauri/src-tauri/core/src/files.rs
rename to examples/openkoalabot-example-tauri/src-tauri/core/src/files.rs
index 0bc127c035..aa4e281897 100644
--- a/samples/openkoalabot-example-tauri/src-tauri/core/src/files.rs
+++ b/examples/openkoalabot-example-tauri/src-tauri/core/src/files.rs
@@ -99,7 +99,7 @@ mod tests {
#[test]
fn the_fixture_bytes_match_the_scenario_hash() {
- // samples/openkoalabot-example-scenario/scenario.json `file.sha256`.
+ // examples/openkoalabot-example-scenario/scenario.json `file.sha256`.
let b = xorshift_bytes(1 << 20, 0x9E37_79B9_7F4A_7C15);
assert_eq!(
hex::encode(Sha256::digest(&b)),
diff --git a/samples/openkoalabot-example-tauri/src-tauri/core/src/lib.rs b/examples/openkoalabot-example-tauri/src-tauri/core/src/lib.rs
similarity index 99%
rename from samples/openkoalabot-example-tauri/src-tauri/core/src/lib.rs
rename to examples/openkoalabot-example-tauri/src-tauri/core/src/lib.rs
index 418ebcd8bc..9c661db4c3 100644
--- a/samples/openkoalabot-example-tauri/src-tauri/core/src/lib.rs
+++ b/examples/openkoalabot-example-tauri/src-tauri/core/src/lib.rs
@@ -5,7 +5,7 @@
//! crate behind the cua SDK), headless so the Tauri shell, its tests and the
//! scenario runner share one implementation.
//!
-//! The flows mirror the Swift app (`samples/openkoalabot-example-swift`):
+//! The flows mirror the Swift app (`examples/openkoalabot-example-swift`):
//!
//! | Flow | Module |
//! |---|---|
diff --git a/samples/openkoalabot-example-tauri/src-tauri/core/src/plan.rs b/examples/openkoalabot-example-tauri/src-tauri/core/src/plan.rs
similarity index 100%
rename from samples/openkoalabot-example-tauri/src-tauri/core/src/plan.rs
rename to examples/openkoalabot-example-tauri/src-tauri/core/src/plan.rs
diff --git a/samples/openkoalabot-example-tauri/src-tauri/core/src/presence.rs b/examples/openkoalabot-example-tauri/src-tauri/core/src/presence.rs
similarity index 100%
rename from samples/openkoalabot-example-tauri/src-tauri/core/src/presence.rs
rename to examples/openkoalabot-example-tauri/src-tauri/core/src/presence.rs
diff --git a/samples/openkoalabot-example-tauri/src-tauri/core/src/scenario.rs b/examples/openkoalabot-example-tauri/src-tauri/core/src/scenario.rs
similarity index 99%
rename from samples/openkoalabot-example-tauri/src-tauri/core/src/scenario.rs
rename to examples/openkoalabot-example-tauri/src-tauri/core/src/scenario.rs
index bae79c87aa..54af8cd8fb 100644
--- a/samples/openkoalabot-example-tauri/src-tauri/core/src/scenario.rs
+++ b/examples/openkoalabot-example-tauri/src-tauri/core/src/scenario.rs
@@ -1,7 +1,7 @@
// SPDX-License-Identifier: FSL-1.1-MIT
// Copyright (c) 2026 Cua AI, Inc.
-//! The shared openkoalabots scenario (`samples/openkoalabot-example-scenario/scenario.json`),
+//! The shared openkoalabots scenario (`examples/openkoalabot-example-scenario/scenario.json`),
//! executed through this implementation's own core: the same modules the
//! Tauri shell calls. Headless: nothing here opens a window or draws on the
//! operator's desktop.
diff --git a/samples/openkoalabot-example-tauri/src-tauri/core/src/stream.rs b/examples/openkoalabot-example-tauri/src-tauri/core/src/stream.rs
similarity index 100%
rename from samples/openkoalabot-example-tauri/src-tauri/core/src/stream.rs
rename to examples/openkoalabot-example-tauri/src-tauri/core/src/stream.rs
diff --git a/samples/openkoalabot-example-tauri/src-tauri/core/src/teleport.rs b/examples/openkoalabot-example-tauri/src-tauri/core/src/teleport.rs
similarity index 100%
rename from samples/openkoalabot-example-tauri/src-tauri/core/src/teleport.rs
rename to examples/openkoalabot-example-tauri/src-tauri/core/src/teleport.rs
diff --git a/samples/openkoalabot-example-tauri/src-tauri/core/src/thread.rs b/examples/openkoalabot-example-tauri/src-tauri/core/src/thread.rs
similarity index 100%
rename from samples/openkoalabot-example-tauri/src-tauri/core/src/thread.rs
rename to examples/openkoalabot-example-tauri/src-tauri/core/src/thread.rs
diff --git a/samples/openkoalabot-example-tauri/src-tauri/core/src/ui_state.rs b/examples/openkoalabot-example-tauri/src-tauri/core/src/ui_state.rs
similarity index 100%
rename from samples/openkoalabot-example-tauri/src-tauri/core/src/ui_state.rs
rename to examples/openkoalabot-example-tauri/src-tauri/core/src/ui_state.rs
diff --git a/samples/openkoalabot-example-tauri/src-tauri/core/tests/hermetic.rs b/examples/openkoalabot-example-tauri/src-tauri/core/tests/hermetic.rs
similarity index 99%
rename from samples/openkoalabot-example-tauri/src-tauri/core/tests/hermetic.rs
rename to examples/openkoalabot-example-tauri/src-tauri/core/tests/hermetic.rs
index d15c79cf2d..97d15191a7 100644
--- a/samples/openkoalabot-example-tauri/src-tauri/core/tests/hermetic.rs
+++ b/examples/openkoalabot-example-tauri/src-tauri/core/tests/hermetic.rs
@@ -8,7 +8,7 @@
//!
//! The mock has no file transfers (`TeleportService.ReceiveFiles`), so a
//! drop is checked to fail loudly here; the bytes-and-SHA-256 path is covered
-//! by the docker lane of the shared scenario (`samples/openkoalabot-example-scenario`).
+//! by the docker lane of the shared scenario (`examples/openkoalabot-example-scenario`).
use cua_spacesd_client::testing::{MockAuth, MockServer};
use openkoalabot_example_core::presence::Presence;
diff --git a/samples/openkoalabot-example-tauri/src-tauri/core/tests/plan.rs b/examples/openkoalabot-example-tauri/src-tauri/core/tests/plan.rs
similarity index 100%
rename from samples/openkoalabot-example-tauri/src-tauri/core/tests/plan.rs
rename to examples/openkoalabot-example-tauri/src-tauri/core/tests/plan.rs
diff --git a/samples/openkoalabot-example-tauri/src-tauri/rust-toolchain.toml b/examples/openkoalabot-example-tauri/src-tauri/rust-toolchain.toml
similarity index 100%
rename from samples/openkoalabot-example-tauri/src-tauri/rust-toolchain.toml
rename to examples/openkoalabot-example-tauri/src-tauri/rust-toolchain.toml
diff --git a/samples/openkoalabot-example-tauri/tsconfig.json b/examples/openkoalabot-example-tauri/tsconfig.json
similarity index 100%
rename from samples/openkoalabot-example-tauri/tsconfig.json
rename to examples/openkoalabot-example-tauri/tsconfig.json
diff --git a/samples/openkoalabot-example-tauri/ui/index.html b/examples/openkoalabot-example-tauri/ui/index.html
similarity index 100%
rename from samples/openkoalabot-example-tauri/ui/index.html
rename to examples/openkoalabot-example-tauri/ui/index.html
diff --git a/samples/openkoalabot-example-tauri/ui/src/Activity.test.tsx b/examples/openkoalabot-example-tauri/ui/src/Activity.test.tsx
similarity index 100%
rename from samples/openkoalabot-example-tauri/ui/src/Activity.test.tsx
rename to examples/openkoalabot-example-tauri/ui/src/Activity.test.tsx
diff --git a/samples/openkoalabot-example-tauri/ui/src/Activity.tsx b/examples/openkoalabot-example-tauri/ui/src/Activity.tsx
similarity index 100%
rename from samples/openkoalabot-example-tauri/ui/src/Activity.tsx
rename to examples/openkoalabot-example-tauri/ui/src/Activity.tsx
diff --git a/samples/openkoalabot-example-tauri/ui/src/App.tsx b/examples/openkoalabot-example-tauri/ui/src/App.tsx
similarity index 100%
rename from samples/openkoalabot-example-tauri/ui/src/App.tsx
rename to examples/openkoalabot-example-tauri/ui/src/App.tsx
diff --git a/samples/openkoalabot-example-tauri/ui/src/Coworkers.test.tsx b/examples/openkoalabot-example-tauri/ui/src/Coworkers.test.tsx
similarity index 100%
rename from samples/openkoalabot-example-tauri/ui/src/Coworkers.test.tsx
rename to examples/openkoalabot-example-tauri/ui/src/Coworkers.test.tsx
diff --git a/samples/openkoalabot-example-tauri/ui/src/Coworkers.tsx b/examples/openkoalabot-example-tauri/ui/src/Coworkers.tsx
similarity index 100%
rename from samples/openkoalabot-example-tauri/ui/src/Coworkers.tsx
rename to examples/openkoalabot-example-tauri/ui/src/Coworkers.tsx
diff --git a/samples/openkoalabot-example-tauri/ui/src/DropZone.tsx b/examples/openkoalabot-example-tauri/ui/src/DropZone.tsx
similarity index 100%
rename from samples/openkoalabot-example-tauri/ui/src/DropZone.tsx
rename to examples/openkoalabot-example-tauri/ui/src/DropZone.tsx
diff --git a/samples/openkoalabot-example-tauri/ui/src/Pip.test.tsx b/examples/openkoalabot-example-tauri/ui/src/Pip.test.tsx
similarity index 100%
rename from samples/openkoalabot-example-tauri/ui/src/Pip.test.tsx
rename to examples/openkoalabot-example-tauri/ui/src/Pip.test.tsx
diff --git a/samples/openkoalabot-example-tauri/ui/src/Pip.tsx b/examples/openkoalabot-example-tauri/ui/src/Pip.tsx
similarity index 100%
rename from samples/openkoalabot-example-tauri/ui/src/Pip.tsx
rename to examples/openkoalabot-example-tauri/ui/src/Pip.tsx
diff --git a/samples/openkoalabot-example-tauri/ui/src/SpaceSection.test.tsx b/examples/openkoalabot-example-tauri/ui/src/SpaceSection.test.tsx
similarity index 100%
rename from samples/openkoalabot-example-tauri/ui/src/SpaceSection.test.tsx
rename to examples/openkoalabot-example-tauri/ui/src/SpaceSection.test.tsx
diff --git a/samples/openkoalabot-example-tauri/ui/src/SpaceSection.tsx b/examples/openkoalabot-example-tauri/ui/src/SpaceSection.tsx
similarity index 100%
rename from samples/openkoalabot-example-tauri/ui/src/SpaceSection.tsx
rename to examples/openkoalabot-example-tauri/ui/src/SpaceSection.tsx
diff --git a/samples/openkoalabot-example-tauri/ui/src/Wizard.tsx b/examples/openkoalabot-example-tauri/ui/src/Wizard.tsx
similarity index 100%
rename from samples/openkoalabot-example-tauri/ui/src/Wizard.tsx
rename to examples/openkoalabot-example-tauri/ui/src/Wizard.tsx
diff --git a/samples/openkoalabot-example-tauri/ui/src/api.ts b/examples/openkoalabot-example-tauri/ui/src/api.ts
similarity index 100%
rename from samples/openkoalabot-example-tauri/ui/src/api.ts
rename to examples/openkoalabot-example-tauri/ui/src/api.ts
diff --git a/samples/openkoalabot-example-tauri/ui/src/assets/koala-mark.svg b/examples/openkoalabot-example-tauri/ui/src/assets/koala-mark.svg
similarity index 100%
rename from samples/openkoalabot-example-tauri/ui/src/assets/koala-mark.svg
rename to examples/openkoalabot-example-tauri/ui/src/assets/koala-mark.svg
diff --git a/samples/openkoalabot-example-tauri/ui/src/assets/koala-peek.svg b/examples/openkoalabot-example-tauri/ui/src/assets/koala-peek.svg
similarity index 100%
rename from samples/openkoalabot-example-tauri/ui/src/assets/koala-peek.svg
rename to examples/openkoalabot-example-tauri/ui/src/assets/koala-peek.svg
diff --git a/samples/openkoalabot-example-tauri/ui/src/assets/koala-sleep.svg b/examples/openkoalabot-example-tauri/ui/src/assets/koala-sleep.svg
similarity index 100%
rename from samples/openkoalabot-example-tauri/ui/src/assets/koala-sleep.svg
rename to examples/openkoalabot-example-tauri/ui/src/assets/koala-sleep.svg
diff --git a/samples/openkoalabot-example-tauri/ui/src/blocks.test.ts b/examples/openkoalabot-example-tauri/ui/src/blocks.test.ts
similarity index 100%
rename from samples/openkoalabot-example-tauri/ui/src/blocks.test.ts
rename to examples/openkoalabot-example-tauri/ui/src/blocks.test.ts
diff --git a/samples/openkoalabot-example-tauri/ui/src/blocks.ts b/examples/openkoalabot-example-tauri/ui/src/blocks.ts
similarity index 100%
rename from samples/openkoalabot-example-tauri/ui/src/blocks.ts
rename to examples/openkoalabot-example-tauri/ui/src/blocks.ts
diff --git a/samples/openkoalabot-example-tauri/ui/src/icons.tsx b/examples/openkoalabot-example-tauri/ui/src/icons.tsx
similarity index 100%
rename from samples/openkoalabot-example-tauri/ui/src/icons.tsx
rename to examples/openkoalabot-example-tauri/ui/src/icons.tsx
diff --git a/samples/openkoalabot-example-tauri/ui/src/images.test.tsx b/examples/openkoalabot-example-tauri/ui/src/images.test.tsx
similarity index 100%
rename from samples/openkoalabot-example-tauri/ui/src/images.test.tsx
rename to examples/openkoalabot-example-tauri/ui/src/images.test.tsx
diff --git a/samples/openkoalabot-example-tauri/ui/src/images.ts b/examples/openkoalabot-example-tauri/ui/src/images.ts
similarity index 100%
rename from samples/openkoalabot-example-tauri/ui/src/images.ts
rename to examples/openkoalabot-example-tauri/ui/src/images.ts
diff --git a/samples/openkoalabot-example-tauri/ui/src/logic.test.ts b/examples/openkoalabot-example-tauri/ui/src/logic.test.ts
similarity index 100%
rename from samples/openkoalabot-example-tauri/ui/src/logic.test.ts
rename to examples/openkoalabot-example-tauri/ui/src/logic.test.ts
diff --git a/samples/openkoalabot-example-tauri/ui/src/logic.ts b/examples/openkoalabot-example-tauri/ui/src/logic.ts
similarity index 100%
rename from samples/openkoalabot-example-tauri/ui/src/logic.ts
rename to examples/openkoalabot-example-tauri/ui/src/logic.ts
diff --git a/samples/openkoalabot-example-tauri/ui/src/main.tsx b/examples/openkoalabot-example-tauri/ui/src/main.tsx
similarity index 100%
rename from samples/openkoalabot-example-tauri/ui/src/main.tsx
rename to examples/openkoalabot-example-tauri/ui/src/main.tsx
diff --git a/samples/openkoalabot-example-tauri/ui/src/rcdp.test.ts b/examples/openkoalabot-example-tauri/ui/src/rcdp.test.ts
similarity index 100%
rename from samples/openkoalabot-example-tauri/ui/src/rcdp.test.ts
rename to examples/openkoalabot-example-tauri/ui/src/rcdp.test.ts
diff --git a/samples/openkoalabot-example-tauri/ui/src/rcdp.ts b/examples/openkoalabot-example-tauri/ui/src/rcdp.ts
similarity index 100%
rename from samples/openkoalabot-example-tauri/ui/src/rcdp.ts
rename to examples/openkoalabot-example-tauri/ui/src/rcdp.ts
diff --git a/samples/openkoalabot-example-tauri/ui/src/spaceWizard.test.ts b/examples/openkoalabot-example-tauri/ui/src/spaceWizard.test.ts
similarity index 100%
rename from samples/openkoalabot-example-tauri/ui/src/spaceWizard.test.ts
rename to examples/openkoalabot-example-tauri/ui/src/spaceWizard.test.ts
diff --git a/samples/openkoalabot-example-tauri/ui/src/spaceWizard.ts b/examples/openkoalabot-example-tauri/ui/src/spaceWizard.ts
similarity index 100%
rename from samples/openkoalabot-example-tauri/ui/src/spaceWizard.ts
rename to examples/openkoalabot-example-tauri/ui/src/spaceWizard.ts
diff --git a/samples/openkoalabot-example-tauri/ui/src/styles.css b/examples/openkoalabot-example-tauri/ui/src/styles.css
similarity index 100%
rename from samples/openkoalabot-example-tauri/ui/src/styles.css
rename to examples/openkoalabot-example-tauri/ui/src/styles.css
diff --git a/samples/openkoalabot-example-tauri/vite.config.ts b/examples/openkoalabot-example-tauri/vite.config.ts
similarity index 100%
rename from samples/openkoalabot-example-tauri/vite.config.ts
rename to examples/openkoalabot-example-tauri/vite.config.ts
diff --git a/samples/openkoalabot-example-ts/.gitignore b/examples/openkoalabot-example-ts/.gitignore
similarity index 100%
rename from samples/openkoalabot-example-ts/.gitignore
rename to examples/openkoalabot-example-ts/.gitignore
diff --git a/examples/openkoalabot-example-ts/README.md b/examples/openkoalabot-example-ts/README.md
new file mode 100644
index 0000000000..311b87e924
--- /dev/null
+++ b/examples/openkoalabot-example-ts/README.md
@@ -0,0 +1,146 @@
+# OpenKoalaBots (TypeScript)
+
+A web app where you hire named Bots, give each one its own computer (a
+Space), and watch it work beside the thread. A small Node server on
+[`@trycua/cua`](../../libs/cua/typescript) runs the agents; the page is plain
+TypeScript built with Vite.
+
+```sh
+npx degit trycua/cua/examples/openkoalabot-example-ts my-app
+cd my-app && npm install
+npm run build && npm run build:web && npm run serve
+```
+
+> `@trycua/cua` is not published on npm yet, so a degit copy does not
+> install on its own today. Until it is, develop inside the cua repo (below).
+
+## Developing inside the cua repo
+
+The SDK dependency is a local workspace override:
+
+| Dependency | Where it comes from today |
+|---|---|
+| `@trycua/cua` | `file:../../libs/cua/typescript` in `package.json` (native Node library plus the wasm browser build) |
+| The sandbox image list | `../../libs/images/sandbox-images.json`, imported by the page (`web/main.ts`) and read by the server (`src/core/plan.ts`) |
+
+Once `@trycua/cua` is on npm, the `file:` dependency becomes a version and
+the quick start above works as is.
+
+```sh
+# 1. The SDK: native library for Node, and the wasm browser build
+cd libs/cua && cargo build --release -p cua-sdk
+cd typescript && npm ci && node ../scripts/stage-uniffi-library.mjs --only=node && npm run build && npm run build:browser
+
+# 2. This example
+cd ../../../examples/openkoalabot-example-ts
+npm ci
+npm run build && npm run build:web
+
+# 3. The server; open the URL it prints (it carries #token=…)
+npm run serve # embedded runtime, state in ~/.openkoalabot-example-ts
+npm run serve -- --home /tmp/okb # or any directory
+npm run serve -- --daemon # or a running `cua daemon`
+npm run serve -- --teleport-home /path/to/generated-home # teleport from a directory, not the real host
+```
+
+## Teleport
+
+Session teleport (`POST /api/teleport/manifest`, then `POST /api/teleport`
+with the items you approved) uses the SDK's `space.teleportManifest` and
+`space.teleport`. These are tool calls: they work when the server uses the
+Cua Spaces daemon (`--daemon`). The embedded runtime refuses them with
+`HostCapabilityMissing`, and the server answers 501 with the SDK's message
+that teleport ships with Cua Spaces.
+
+App teleport ("Teleport an app…": the app list, the move plan and run, and
+window drags) ships with Cua Spaces (source-available), not with the MIT
+SDK. The Computer panel's drop zone, the SDK's `<cua-drop-zone>`, still
+shows **Send file…** and **Teleport an app…**: files upload (SHA-256
+verified), while **Teleport an app…** and an app bundle dropped from Finder
+or the Dock show "App teleport ships with Cua Spaces (source-available)."
+The `/api/teleport/apps`, `icon`, `plan`, `run` and `window-drags` routes
+answer 501 with the same message.
+
+## Routines and group chats
+
+A routine is a saved prompt plus a schedule (every N minutes, daily at, weekly on) that gives one Bot another turn; a group chat sends one message to two to six Bots and shows each reply under its Bot. Both are the SDK's `RoutineStore` and `GroupChatStore` (`@trycua/cua/spaces/routines`, `/groups`) over this app's `BotStore` (`src/core/coworkers.ts`). Routines live in `<home>/routines.json` and fire while the server runs; a Bot mid-turn refuses its slot. `--model-url URL [--model NAME] [--key-var VAR]` points every Bot at a custom model endpoint.
+
+## Picture in picture
+
+The PiP button on the stream pops the desktop out; each row of the window
+list pops out that one window (its own media session, closed with the PiP).
+Both use `PictureInPicture` from `@trycua/cua/spaces/pip`: the Document
+Picture-in-Picture API when the browser has it, video picture-in-picture
+otherwise. Browsers allow one PiP at a time, so a new one replaces the last.
+
+For UI work, `npm run dev:web` serves the page through Vite with `/api` and
+`/events` proxied to the server on port 4780 (`OPENKOALABOTS_SERVER`
+overrides); open `http://127.0.0.1:5173/#token=<the printed token>`.
+
+## What is in it
+
+| Part | Where | What |
+|---|---|---|
+| App model | `src/core/app.ts` | One Space, one long-lived agent thread per Bot, a roster from one `agentList` per tick, per-turn transcripts folded from the run's structured events by the SDK's `AgentTranscript`, refusal (never a queue) while a Bot is mid-turn, verified attachments, session teleport behind an approval callback |
+| New Space | `src/core/plan.ts` | The wizard's plan to one SDK call (below) |
+| Wire | `src/core/wire.ts`, `src/core/webmedia.ts` | Media wire v2 framing (`libs/cua/proto/MEDIA.md`), control messages, Annex B keyframes, `OpenMedia` over the wasm gRPC-Web client |
+| Server | `src/server/` | Loopback HTTP + WebSocket, random bearer, one poll loop, stream **tickets** (the spacesd token never reaches the page), session teleport only for a manifest the page showed, app teleport routes that say it ships with Cua Spaces |
+| Page pieces | `src/ui/` | DOM-only building blocks shared by the page and the tests: the image dropdown and wizard, thread cards, the Space section, friendly errors |
+| Page | `web/` | Sidebar (New Bot, search, roster, Space picker), the thread with the Bot's messages as prose, its activity (install, tools, thinking, turn ends) as muted collapsible groups, approval and file cards and a docked composer, the Computer panel (live desktop decoded by WebCodecs, picture in picture, window list with each app's icon from the Space, drop zone), light and dark |
+| Scenario runner | `src/scenario/` | Runs `../openkoalabot-example-scenario/scenario.json` headlessly |
+
+## Spaces
+
+**New Space** opens a four-step wizard (System, Resources, Options,
+Summary). The image dropdown lists the `published` entries of the shared
+image list, and each entry names the engine it runs on in each location, so
+the wizard never offers a combination the image cannot run. Create posts the
+plan to `POST /api/spaces/create`, which makes one SDK call,
+`spaces.create({ on, image, kind, runtime, name, wait: true, ... })`:
+
+| Where | `on` | `kind` / `runtime` |
+|---|---|---|
+| This machine | `local` | container / `auto` (gVisor when available), vm / `qemu`, vm / `lume`; plus `cpus`, `memoryMb`. The SDK runs it itself |
+| Cua Cloud | `cloud` | Ended: a create fails with "Cua Cloud has ended". Create the Space on this machine instead |
+
+**Add by address** (wizard footer or empty state) registers a machine that
+already runs cua-spacesd. **Delete…** is a separate control that always asks
+first: a created Space is deleted with its sandbox, one added by address is
+only removed from the list.
+
+## Tests
+
+```sh
+npm test # build + node --test test/*.test.mjs
+npm run typecheck # server and page
+```
+
+| File | Covers |
+|---|---|
+| `ui.test.mjs` | under happy-dom: the dropdown equals the published list, the wizard (disabled targets, one plan), Delete needs confirmation, thread cards, friendly errors |
+| `computer.test.mjs` | under happy-dom: the window list (one line per window, a PiP button each) and the one drop zone |
+| `plan.test.mjs` | plan to `spaces.create` options (location, kind, engine), refusals, defaults |
+| `server.test.mjs` | loopback + bearer, the whole API against a fake Space, `spaces/create`, window list and per-window stream tickets, the event socket |
+| `app.test.mjs` | thread lifecycle, refusal, degraded probes, the one-call roster, verified attachments, teleport consent |
+| `teleport.test.mjs` | the app teleport routes answer that it ships with Cua Spaces; the embedded runtime's session teleport refusal (`HostCapabilityMissing`) reaches the page as that message |
+| `wire.test.mjs`, `webmedia.test.mjs` | framing, codec string, `OpenMedia`, ticket subprotocol |
+| `spec.test.mjs` | the shared scenario parses |
+| `web-client.test.mjs`, `fixture-lane.test.mjs` | the stream path and the whole scenario against `cua-test-fixtures` |
+
+The last two need `cua-test-fixtures` (`libs/cua/scripts/build-test-fixtures.sh`,
+or point `CUA_TEST_FIXTURES` at a build) and skip without it.
+
+## The scenario
+
+```sh
+npm run build
+../openkoalabot-example-scenario/run.sh --impl ts --lane fixture # loopback spacesd core
+../openkoalabot-example-scenario/run.sh --impl ts --lane docker # a linux container (gVisor, 4 GiB)
+```
+
+The runner embeds the MIT runtime, so the `teleport` step skips with the
+SDK's reason (teleport ships with Cua Spaces).
+
+The same behaviour ships in [`openkoalabot-example-swift`](../openkoalabot-example-swift)
+and [`openkoalabot-example-tauri`](../openkoalabot-example-tauri); all three pass the
+shared scenario in [`openkoalabot-example-scenario`](../openkoalabot-example-scenario).
diff --git a/samples/openkoalabot-example-ts/package-lock.json b/examples/openkoalabot-example-ts/package-lock.json
similarity index 100%
rename from samples/openkoalabot-example-ts/package-lock.json
rename to examples/openkoalabot-example-ts/package-lock.json
diff --git a/samples/openkoalabot-example-ts/package.json b/examples/openkoalabot-example-ts/package.json
similarity index 100%
rename from samples/openkoalabot-example-ts/package.json
rename to examples/openkoalabot-example-ts/package.json
diff --git a/samples/openkoalabot-example-ts/src/core/app.ts b/examples/openkoalabot-example-ts/src/core/app.ts
similarity index 100%
rename from samples/openkoalabot-example-ts/src/core/app.ts
rename to examples/openkoalabot-example-ts/src/core/app.ts
diff --git a/samples/openkoalabot-example-ts/src/core/coworkers.ts b/examples/openkoalabot-example-ts/src/core/coworkers.ts
similarity index 100%
rename from samples/openkoalabot-example-ts/src/core/coworkers.ts
rename to examples/openkoalabot-example-ts/src/core/coworkers.ts
diff --git a/samples/openkoalabot-example-ts/src/core/plan.ts b/examples/openkoalabot-example-ts/src/core/plan.ts
similarity index 100%
rename from samples/openkoalabot-example-ts/src/core/plan.ts
rename to examples/openkoalabot-example-ts/src/core/plan.ts
diff --git a/samples/openkoalabot-example-ts/src/core/runtime.ts b/examples/openkoalabot-example-ts/src/core/runtime.ts
similarity index 100%
rename from samples/openkoalabot-example-ts/src/core/runtime.ts
rename to examples/openkoalabot-example-ts/src/core/runtime.ts
diff --git a/samples/openkoalabot-example-ts/src/core/spec.ts b/examples/openkoalabot-example-ts/src/core/spec.ts
similarity index 98%
rename from samples/openkoalabot-example-ts/src/core/spec.ts
rename to examples/openkoalabot-example-ts/src/core/spec.ts
index d92bbaff0d..35b3c77e00 100644
--- a/samples/openkoalabot-example-ts/src/core/spec.ts
+++ b/examples/openkoalabot-example-ts/src/core/spec.ts
@@ -1,5 +1,5 @@
/**
- * The shared scenario (samples/openkoalabot-example-scenario/scenario.json): types,
+ * The shared scenario (examples/openkoalabot-example-scenario/scenario.json): types,
* validation, placeholder substitution and the deterministic fixtures every
* implementation generates the same way.
*/
diff --git a/samples/openkoalabot-example-ts/src/core/teleport.ts b/examples/openkoalabot-example-ts/src/core/teleport.ts
similarity index 100%
rename from samples/openkoalabot-example-ts/src/core/teleport.ts
rename to examples/openkoalabot-example-ts/src/core/teleport.ts
diff --git a/samples/openkoalabot-example-ts/src/core/webmedia.ts b/examples/openkoalabot-example-ts/src/core/webmedia.ts
similarity index 100%
rename from samples/openkoalabot-example-ts/src/core/webmedia.ts
rename to examples/openkoalabot-example-ts/src/core/webmedia.ts
diff --git a/samples/openkoalabot-example-ts/src/core/wire.ts b/examples/openkoalabot-example-ts/src/core/wire.ts
similarity index 100%
rename from samples/openkoalabot-example-ts/src/core/wire.ts
rename to examples/openkoalabot-example-ts/src/core/wire.ts
diff --git a/samples/openkoalabot-example-ts/src/scenario/cli.ts b/examples/openkoalabot-example-ts/src/scenario/cli.ts
similarity index 95%
rename from samples/openkoalabot-example-ts/src/scenario/cli.ts
rename to examples/openkoalabot-example-ts/src/scenario/cli.ts
index 48a45fb1d6..592d8cab1b 100644
--- a/samples/openkoalabot-example-ts/src/scenario/cli.ts
+++ b/examples/openkoalabot-example-ts/src/scenario/cli.ts
@@ -1,6 +1,6 @@
#!/usr/bin/env node
/**
- * openkoalabot-example-ts scenario runner (samples/openkoalabot-example-scenario):
+ * openkoalabot-example-ts scenario runner (examples/openkoalabot-example-scenario):
*
* node dist/scenario/cli.js --spec <scenario.json> --lane fixture|docker|cloud --out <result.json>
*
diff --git a/samples/openkoalabot-example-ts/src/scenario/runner.ts b/examples/openkoalabot-example-ts/src/scenario/runner.ts
similarity index 99%
rename from samples/openkoalabot-example-ts/src/scenario/runner.ts
rename to examples/openkoalabot-example-ts/src/scenario/runner.ts
index d70bf5677d..cedc3bcbf7 100644
--- a/samples/openkoalabot-example-ts/src/scenario/runner.ts
+++ b/examples/openkoalabot-example-ts/src/scenario/runner.ts
@@ -1,5 +1,5 @@
/**
- * Executes samples/openkoalabot-example-scenario/scenario.json headlessly through the
+ * Executes examples/openkoalabot-example-scenario/scenario.json headlessly through the
* app model (`BotStore`, `BotThread`) and the SDK. No window is opened; every
* home the SDK sees is a temp directory; the teleported profile is generated;
* the agent CLI is the fixture fake.
diff --git a/samples/openkoalabot-example-ts/src/server/app.ts b/examples/openkoalabot-example-ts/src/server/app.ts
similarity index 100%
rename from samples/openkoalabot-example-ts/src/server/app.ts
rename to examples/openkoalabot-example-ts/src/server/app.ts
diff --git a/samples/openkoalabot-example-ts/src/server/main.ts b/examples/openkoalabot-example-ts/src/server/main.ts
similarity index 100%
rename from samples/openkoalabot-example-ts/src/server/main.ts
rename to examples/openkoalabot-example-ts/src/server/main.ts
diff --git a/samples/openkoalabot-example-ts/src/ui/activity.ts b/examples/openkoalabot-example-ts/src/ui/activity.ts
similarity index 100%
rename from samples/openkoalabot-example-ts/src/ui/activity.ts
rename to examples/openkoalabot-example-ts/src/ui/activity.ts
diff --git a/samples/openkoalabot-example-ts/src/ui/blocks.ts b/examples/openkoalabot-example-ts/src/ui/blocks.ts
similarity index 100%
rename from samples/openkoalabot-example-ts/src/ui/blocks.ts
rename to examples/openkoalabot-example-ts/src/ui/blocks.ts
diff --git a/samples/openkoalabot-example-ts/src/ui/computer.ts b/examples/openkoalabot-example-ts/src/ui/computer.ts
similarity index 100%
rename from samples/openkoalabot-example-ts/src/ui/computer.ts
rename to examples/openkoalabot-example-ts/src/ui/computer.ts
diff --git a/samples/openkoalabot-example-ts/src/ui/coworkers.ts b/examples/openkoalabot-example-ts/src/ui/coworkers.ts
similarity index 100%
rename from samples/openkoalabot-example-ts/src/ui/coworkers.ts
rename to examples/openkoalabot-example-ts/src/ui/coworkers.ts
diff --git a/samples/openkoalabot-example-ts/src/ui/dom.ts b/examples/openkoalabot-example-ts/src/ui/dom.ts
similarity index 100%
rename from samples/openkoalabot-example-ts/src/ui/dom.ts
rename to examples/openkoalabot-example-ts/src/ui/dom.ts
diff --git a/samples/openkoalabot-example-ts/src/ui/errors.ts b/examples/openkoalabot-example-ts/src/ui/errors.ts
similarity index 100%
rename from samples/openkoalabot-example-ts/src/ui/errors.ts
rename to examples/openkoalabot-example-ts/src/ui/errors.ts
diff --git a/samples/openkoalabot-example-ts/src/ui/images.ts b/examples/openkoalabot-example-ts/src/ui/images.ts
similarity index 100%
rename from samples/openkoalabot-example-ts/src/ui/images.ts
rename to examples/openkoalabot-example-ts/src/ui/images.ts
diff --git a/samples/openkoalabot-example-ts/src/ui/spaceSection.ts b/examples/openkoalabot-example-ts/src/ui/spaceSection.ts
similarity index 100%
rename from samples/openkoalabot-example-ts/src/ui/spaceSection.ts
rename to examples/openkoalabot-example-ts/src/ui/spaceSection.ts
diff --git a/samples/openkoalabot-example-ts/src/ui/wizard.ts b/examples/openkoalabot-example-ts/src/ui/wizard.ts
similarity index 100%
rename from samples/openkoalabot-example-ts/src/ui/wizard.ts
rename to examples/openkoalabot-example-ts/src/ui/wizard.ts
diff --git a/samples/openkoalabot-example-ts/src/ui/wizardView.ts b/examples/openkoalabot-example-ts/src/ui/wizardView.ts
similarity index 100%
rename from samples/openkoalabot-example-ts/src/ui/wizardView.ts
rename to examples/openkoalabot-example-ts/src/ui/wizardView.ts
diff --git a/samples/openkoalabot-example-ts/test/app.test.mjs b/examples/openkoalabot-example-ts/test/app.test.mjs
similarity index 100%
rename from samples/openkoalabot-example-ts/test/app.test.mjs
rename to examples/openkoalabot-example-ts/test/app.test.mjs
diff --git a/samples/openkoalabot-example-ts/test/computer.test.mjs b/examples/openkoalabot-example-ts/test/computer.test.mjs
similarity index 100%
rename from samples/openkoalabot-example-ts/test/computer.test.mjs
rename to examples/openkoalabot-example-ts/test/computer.test.mjs
diff --git a/samples/openkoalabot-example-ts/test/coworkers.test.mjs b/examples/openkoalabot-example-ts/test/coworkers.test.mjs
similarity index 100%
rename from samples/openkoalabot-example-ts/test/coworkers.test.mjs
rename to examples/openkoalabot-example-ts/test/coworkers.test.mjs
diff --git a/samples/openkoalabot-example-ts/test/fake.mjs b/examples/openkoalabot-example-ts/test/fake.mjs
similarity index 100%
rename from samples/openkoalabot-example-ts/test/fake.mjs
rename to examples/openkoalabot-example-ts/test/fake.mjs
diff --git a/samples/openkoalabot-example-ts/test/fixture-lane.test.mjs b/examples/openkoalabot-example-ts/test/fixture-lane.test.mjs
similarity index 100%
rename from samples/openkoalabot-example-ts/test/fixture-lane.test.mjs
rename to examples/openkoalabot-example-ts/test/fixture-lane.test.mjs
diff --git a/samples/openkoalabot-example-ts/test/plan.test.mjs b/examples/openkoalabot-example-ts/test/plan.test.mjs
similarity index 100%
rename from samples/openkoalabot-example-ts/test/plan.test.mjs
rename to examples/openkoalabot-example-ts/test/plan.test.mjs
diff --git a/samples/openkoalabot-example-ts/test/server.test.mjs b/examples/openkoalabot-example-ts/test/server.test.mjs
similarity index 100%
rename from samples/openkoalabot-example-ts/test/server.test.mjs
rename to examples/openkoalabot-example-ts/test/server.test.mjs
diff --git a/samples/openkoalabot-example-ts/test/spec.test.mjs b/examples/openkoalabot-example-ts/test/spec.test.mjs
similarity index 100%
rename from samples/openkoalabot-example-ts/test/spec.test.mjs
rename to examples/openkoalabot-example-ts/test/spec.test.mjs
diff --git a/samples/openkoalabot-example-ts/test/teleport.test.mjs b/examples/openkoalabot-example-ts/test/teleport.test.mjs
similarity index 100%
rename from samples/openkoalabot-example-ts/test/teleport.test.mjs
rename to examples/openkoalabot-example-ts/test/teleport.test.mjs
diff --git a/samples/openkoalabot-example-ts/test/ui.test.mjs b/examples/openkoalabot-example-ts/test/ui.test.mjs
similarity index 100%
rename from samples/openkoalabot-example-ts/test/ui.test.mjs
rename to examples/openkoalabot-example-ts/test/ui.test.mjs
diff --git a/samples/openkoalabot-example-ts/test/web-client.test.mjs b/examples/openkoalabot-example-ts/test/web-client.test.mjs
similarity index 100%
rename from samples/openkoalabot-example-ts/test/web-client.test.mjs
rename to examples/openkoalabot-example-ts/test/web-client.test.mjs
diff --git a/samples/openkoalabot-example-ts/test/webmedia.test.mjs b/examples/openkoalabot-example-ts/test/webmedia.test.mjs
similarity index 100%
rename from samples/openkoalabot-example-ts/test/webmedia.test.mjs
rename to examples/openkoalabot-example-ts/test/webmedia.test.mjs
diff --git a/samples/openkoalabot-example-ts/test/wire.test.mjs b/examples/openkoalabot-example-ts/test/wire.test.mjs
similarity index 100%
rename from samples/openkoalabot-example-ts/test/wire.test.mjs
rename to examples/openkoalabot-example-ts/test/wire.test.mjs
diff --git a/samples/openkoalabot-example-ts/tsconfig.json b/examples/openkoalabot-example-ts/tsconfig.json
similarity index 100%
rename from samples/openkoalabot-example-ts/tsconfig.json
rename to examples/openkoalabot-example-ts/tsconfig.json
diff --git a/samples/openkoalabot-example-ts/web/assets/koala-mark.svg b/examples/openkoalabot-example-ts/web/assets/koala-mark.svg
similarity index 100%
rename from samples/openkoalabot-example-ts/web/assets/koala-mark.svg
rename to examples/openkoalabot-example-ts/web/assets/koala-mark.svg
diff --git a/samples/openkoalabot-example-ts/web/assets/koala-peek.svg b/examples/openkoalabot-example-ts/web/assets/koala-peek.svg
similarity index 100%
rename from samples/openkoalabot-example-ts/web/assets/koala-peek.svg
rename to examples/openkoalabot-example-ts/web/assets/koala-peek.svg
diff --git a/samples/openkoalabot-example-ts/web/assets/koala-sleep.svg b/examples/openkoalabot-example-ts/web/assets/koala-sleep.svg
similarity index 100%
rename from samples/openkoalabot-example-ts/web/assets/koala-sleep.svg
rename to examples/openkoalabot-example-ts/web/assets/koala-sleep.svg
diff --git a/samples/openkoalabot-example-ts/web/index.html b/examples/openkoalabot-example-ts/web/index.html
similarity index 100%
rename from samples/openkoalabot-example-ts/web/index.html
rename to examples/openkoalabot-example-ts/web/index.html
diff --git a/samples/openkoalabot-example-ts/web/main.ts b/examples/openkoalabot-example-ts/web/main.ts
similarity index 100%
rename from samples/openkoalabot-example-ts/web/main.ts
rename to examples/openkoalabot-example-ts/web/main.ts
diff --git a/samples/openkoalabot-example-ts/web/style.css b/examples/openkoalabot-example-ts/web/style.css
similarity index 100%
rename from samples/openkoalabot-example-ts/web/style.css
rename to examples/openkoalabot-example-ts/web/style.css
diff --git a/samples/openkoalabot-example-ts/web/tsconfig.json b/examples/openkoalabot-example-ts/web/tsconfig.json
similarity index 100%
rename from samples/openkoalabot-example-ts/web/tsconfig.json
rename to examples/openkoalabot-example-ts/web/tsconfig.json
diff --git a/samples/openkoalabot-example-ts/web/vite.config.ts b/examples/openkoalabot-example-ts/web/vite.config.ts
similarity index 100%
rename from samples/openkoalabot-example-ts/web/vite.config.ts
rename to examples/openkoalabot-example-ts/web/vite.config.ts
diff --git a/examples/openkoalabots-assets/README.md b/examples/openkoalabots-assets/README.md
new file mode 100644
index 0000000000..09b56e37c1
--- /dev/null
+++ b/examples/openkoalabots-assets/README.md
@@ -0,0 +1,14 @@
+# OpenKoalaBots artwork
+
+Original koala artwork for the three OpenKoalaBots samples. Made for this
+repository; no third-party marks.
+
+| File | Use |
+|---|---|
+| `app-icon.svg` | App icon (Tauri icons are rendered from it) |
+| `koala-mark.svg` | The mark: sidebar header, avatars, the empty chat |
+| `koala-peek.svg` | Empty states (no Space yet) |
+| `koala-sleep.svg` | Idle states (a Bot with nothing to do) |
+
+The shapes are circles, ellipses and a few paths, so the Swift sample draws
+the same koala with SwiftUI shapes (`Design/KoalaArt.swift`).
diff --git a/samples/openkoalabots-assets/app-icon.svg b/examples/openkoalabots-assets/app-icon.svg
similarity index 100%
rename from samples/openkoalabots-assets/app-icon.svg
rename to examples/openkoalabots-assets/app-icon.svg
diff --git a/samples/openkoalabots-assets/koala-mark.svg b/examples/openkoalabots-assets/koala-mark.svg
similarity index 100%
rename from samples/openkoalabots-assets/koala-mark.svg
rename to examples/openkoalabots-assets/koala-mark.svg
diff --git a/samples/openkoalabots-assets/koala-peek.svg b/examples/openkoalabots-assets/koala-peek.svg
similarity index 100%
rename from samples/openkoalabots-assets/koala-peek.svg
rename to examples/openkoalabots-assets/koala-peek.svg
diff --git a/samples/openkoalabots-assets/koala-sleep.svg b/examples/openkoalabots-assets/koala-sleep.svg
similarity index 100%
rename from samples/openkoalabots-assets/koala-sleep.svg
rename to examples/openkoalabots-assets/koala-sleep.svg
diff --git a/samples/python/2_ephemeral_fdroid.py b/examples/python/2_ephemeral_fdroid.py
similarity index 97%
rename from samples/python/2_ephemeral_fdroid.py
rename to examples/python/2_ephemeral_fdroid.py
index 7a239489be..4156ecc061 100644
--- a/samples/python/2_ephemeral_fdroid.py
+++ b/examples/python/2_ephemeral_fdroid.py
@@ -4,7 +4,7 @@ Spins up a local Android VM, installs F-Droid, takes a screenshot.
Sandbox is automatically destroyed on exit.
Usage:
- python samples/python/2_ephemeral_fdroid.py
+ python examples/python/2_ephemeral_fdroid.py
"""
import asyncio
diff --git a/samples/python/3_osworld_local.py b/examples/python/3_osworld_local.py
similarity index 98%
rename from samples/python/3_osworld_local.py
rename to examples/python/3_osworld_local.py
index 34a683679a..e670143248 100644
--- a/samples/python/3_osworld_local.py
+++ b/examples/python/3_osworld_local.py
@@ -8,7 +8,7 @@ Boots an OSWorld disk, screenshots it through the OSWorld control server, then
drives it over the cua-driver MCP endpoint baked into the image.
Usage:
- OSWORLD_QCOW2=/path/to/overlay.qcow2 uv run samples/python/3_osworld_local.py
+ OSWORLD_QCOW2=/path/to/overlay.qcow2 uv run examples/python/3_osworld_local.py
See docs/content/docs/cua-bench/guides/benchmarks.mdx (OSWorld-Verified).
"""
diff --git a/samples/python/osworld-image/99-cua-dhcp.yaml b/examples/python/osworld-image/99-cua-dhcp.yaml
similarity index 100%
rename from samples/python/osworld-image/99-cua-dhcp.yaml
rename to examples/python/osworld-image/99-cua-dhcp.yaml
diff --git a/samples/python/osworld-image/99-cua-uinput.rules b/examples/python/osworld-image/99-cua-uinput.rules
similarity index 100%
rename from samples/python/osworld-image/99-cua-uinput.rules
rename to examples/python/osworld-image/99-cua-uinput.rules
diff --git a/samples/python/osworld-image/Dockerfile b/examples/python/osworld-image/Dockerfile
similarity index 100%
rename from samples/python/osworld-image/Dockerfile
rename to examples/python/osworld-image/Dockerfile
diff --git a/samples/python/osworld-image/build-osworld-cua.sh b/examples/python/osworld-image/build-osworld-cua.sh
similarity index 100%
rename from samples/python/osworld-image/build-osworld-cua.sh
rename to examples/python/osworld-image/build-osworld-cua.sh
diff --git a/samples/python/osworld-image/cua-driver-mcp.service b/examples/python/osworld-image/cua-driver-mcp.service
similarity index 100%
rename from samples/python/osworld-image/cua-driver-mcp.service
rename to examples/python/osworld-image/cua-driver-mcp.service
diff --git a/samples/python/osworld-image/guestfs/Dockerfile b/examples/python/osworld-image/guestfs/Dockerfile
similarity index 100%
rename from samples/python/osworld-image/guestfs/Dockerfile
rename to examples/python/osworld-image/guestfs/Dockerfile
diff --git a/samples/python/osworld-image/start-cua-mcp.sh b/examples/python/osworld-image/start-cua-mcp.sh
similarity index 100%
rename from samples/python/osworld-image/start-cua-mcp.sh
rename to examples/python/osworld-image/start-cua-mcp.sh
diff --git a/samples/python/osworld-image/uinput.conf b/examples/python/osworld-image/uinput.conf
similarity index 100%
rename from samples/python/osworld-image/uinput.conf
rename to examples/python/osworld-image/uinput.conf
diff --git a/CLA.md b/legal/CLA.md
similarity index 100%
rename from CLA.md
rename to legal/CLA.md
diff --git a/COMMERCIAL.md b/legal/COMMERCIAL.md
similarity index 51%
rename from COMMERCIAL.md
rename to legal/COMMERCIAL.md
index 40ee3eeb58..1199e2673e 100644
--- a/COMMERCIAL.md
+++ b/legal/COMMERCIAL.md
@@ -8,4 +8,4 @@ Each release converts to MIT two years after it's published.
## Cua Driver Bench
-Cua Driver Bench ([`benchmarks/cua-driver-bench/`](benchmarks/cua-driver-bench)) is also under FSL-1.1-MIT. You can run it, modify it and use it at work, including to evaluate a commercial product. If you want to offer it, or a substantially similar benchmark, to others as a commercial product or service (for example hosted evaluation or a paid benchmark), you need a commercial licence. Contact us at [email protected].
+Cua Driver Bench ([`libs/cua-driver-bench/`](../libs/cua-driver-bench)) is also under FSL-1.1-MIT. You can run it, modify it and use it at work, including to evaluate a commercial product. If you want to offer it, or a substantially similar benchmark, to others as a commercial product or service (for example hosted evaluation or a paid benchmark), you need a commercial licence. Contact us at [email protected].
diff --git a/LICENSING.md b/legal/LICENSING.md
similarity index 59%
rename from LICENSING.md
rename to legal/LICENSING.md
index 63c3d3a738..bae8455c8d 100644
--- a/LICENSING.md
+++ b/legal/LICENSING.md
@@ -2,7 +2,7 @@
## How licensing works here
-The root [`LICENSE.md`](LICENSE.md) is the MIT License, and it covers everything
+The root [`LICENSE.md`](../LICENSE.md) is the MIT License, and it covers everything
in this repository unless a subdirectory has its own LICENSE file. A
subdirectory with its own LICENSE file is licensed under that file instead. Each
package also states its licence in its metadata: `license` in `Cargo.toml` or
@@ -14,7 +14,7 @@ its language packages, the `cua` command, `cua daemon`, Cua Driver and Lume.
Cua Spaces is source-available under the
[Functional Source License, Version 1.1, MIT Future License](https://fsl.software)
(FSL-1.1-MIT); the table below marks each FSL directory. Cua Driver Bench
-(`benchmarks/cua-driver-bench`) is FSL-1.1-MIT too.
+(`libs/cua-driver-bench`) is FSL-1.1-MIT too.
## LICENSE files in this repository
@@ -25,49 +25,49 @@ notices declare.
| Path | SPDX licence | Scope |
| -------------------------------------------------------------------------------------------------------------------------------------------------------------- | -------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
-| [`LICENSE.md`](LICENSE.md) | MIT | Repository default |
-| [`apps/cua-spaces/LICENSE`](apps/cua-spaces/LICENSE) | FSL-1.1-MIT | Cua Spaces desktop app (Tauri) |
-| [`apps/cua-spaces-macos/LICENSE`](apps/cua-spaces-macos/LICENSE) | FSL-1.1-MIT | Cua Spaces macOS app (SwiftUI) |
-| [`apps/cua-spaces-web/LICENSE`](apps/cua-spaces-web/LICENSE) | FSL-1.1-MIT | Cua Spaces web UI (shared by the desktop apps) |
-| [`apps/cua-spaces-desktop/LICENSE`](apps/cua-spaces-desktop/LICENSE) | FSL-1.1-MIT | Cua Spaces desktop app (Electron) |
-| [`libs/cua-spacesd/LICENSE`](libs/cua-spacesd/LICENSE) | FSL-1.1-MIT | cua-spacesd and cua-relay |
-| [`libs/cua/crates/cua-spaces-app-core/LICENSE`](libs/cua/crates/cua-spaces-app-core/LICENSE) | FSL-1.1-MIT | Spaces app core (the apps' view models) |
-| [`libs/cua/crates/cua-keyvault/LICENSE`](libs/cua/crates/cua-keyvault/LICENSE) | FSL-1.1-MIT | Cua Keyvault |
-| [`libs/cua/crates/cua-teleport/LICENSE`](libs/cua/crates/cua-teleport/LICENSE) | FSL-1.1-MIT | Teleport providers and the app-teleport UX |
-| [`libs/cua/crates/cua-teleport-bundle/LICENSE`](libs/cua/crates/cua-teleport-bundle/LICENSE) | FSL-1.1-MIT | Teleport bundle format |
-| [`libs/cua/crates/cua-machine-seal/LICENSE`](libs/cua/crates/cua-machine-seal/LICENSE) | FSL-1.1-MIT | End-to-end sealing of secrets to a Space (machine key, pinning) |
-| [`libs/cua/crates/cua-volume/LICENSE`](libs/cua/crates/cua-volume/LICENSE) | FSL-1.1-MIT | Cua Volume (`cua-volume`) |
-| [`libs/cua/crates/cua-spaces-ext/LICENSE`](libs/cua/crates/cua-spaces-ext/LICENSE) | FSL-1.1-MIT | Cua Spaces extensions: teleport, the Cua Volume (`cua-volume`) tools, persistent agents, the streaming client behind `StreamSession`, and the daemon extension (Keyvault broker, site login, volume backends) |
-| [`libs/cua/crates/cua-spaces-ffi/LICENSE`](libs/cua/crates/cua-spaces-ffi/LICENSE) | FSL-1.1-MIT | The Spaces app export: the SDK plus the app core, teleport, the Keyvault client and decoded media (BGRA frames, PCM audio), for the SwiftUI app |
-| [`libs/cua/crates/cua-spaces-cli/LICENSE`](libs/cua/crates/cua-spaces-cli/LICENSE) | FSL-1.1-MIT | The Cua Spaces build of `cua` (`cua-spaces-cli`), including `cua viewer` and the decoding `cua sb stream-probe` |
-| [`libs/cua/crates/cua-media-protocol/LICENSE`](libs/cua/crates/cua-media-protocol/LICENSE) | FSL-1.1-MIT | Streaming | `cua-spaces`: `stream::StreamClient` / `StreamConnection` behind `StreamSession` (input crosses as JSON; without a registered client it fails with `host_capability_missing`); `cua-sdk`: `MediaSession` (encoded frames); `cua-cli`: `CliExtension::viewer` and `open_media_decoded`; `cua-proto` (`StreamService`) | `cua-spaces-ext::stream::MediaStreams` (the RCDP client over `cua-media-client`, `cua-media-protocol`, `cua-media-transport`); `cua-spaces-ffi::media_decode` (decoded BGRA and PCM); `cua-spaces-cli` (`cua viewer`, the decoding stream probe); `CuaSpacesStreaming` |
+| [`LICENSE.md`](../LICENSE.md) | MIT | Repository default |
+| [`apps/cua-spaces/LICENSE`](../apps/cua-spaces/LICENSE) | FSL-1.1-MIT | Cua Spaces desktop app (Tauri) |
+| [`apps/cua-spaces-macos/LICENSE`](../apps/cua-spaces-macos/LICENSE) | FSL-1.1-MIT | Cua Spaces macOS app (SwiftUI) |
+| [`apps/cua-spaces-web/LICENSE`](../apps/cua-spaces-web/LICENSE) | FSL-1.1-MIT | Cua Spaces web UI (shared by the desktop apps) |
+| [`apps/cua-spaces-desktop/LICENSE`](../apps/cua-spaces-desktop/LICENSE) | FSL-1.1-MIT | Cua Spaces desktop app (Electron) |
+| [`libs/cua-spacesd/LICENSE`](../libs/cua-spacesd/LICENSE) | FSL-1.1-MIT | cua-spacesd and cua-relay |
+| [`libs/cua/crates/cua-spaces-app-core/LICENSE`](../libs/cua/crates/cua-spaces-app-core/LICENSE) | FSL-1.1-MIT | Spaces app core (the apps' view models) |
+| [`libs/cua/crates/cua-keyvault/LICENSE`](../libs/cua/crates/cua-keyvault/LICENSE) | FSL-1.1-MIT | Cua Keyvault |
+| [`libs/cua/crates/cua-teleport/LICENSE`](../libs/cua/crates/cua-teleport/LICENSE) | FSL-1.1-MIT | Teleport providers and the app-teleport UX |
+| [`libs/cua/crates/cua-teleport-bundle/LICENSE`](../libs/cua/crates/cua-teleport-bundle/LICENSE) | FSL-1.1-MIT | Teleport bundle format |
+| [`libs/cua/crates/cua-machine-seal/LICENSE`](../libs/cua/crates/cua-machine-seal/LICENSE) | FSL-1.1-MIT | End-to-end sealing of secrets to a Space (machine key, pinning) |
+| [`libs/cua/crates/cua-volume/LICENSE`](../libs/cua/crates/cua-volume/LICENSE) | FSL-1.1-MIT | Cua Volume (`cua-volume`) |
+| [`libs/cua/crates/cua-spaces-ext/LICENSE`](../libs/cua/crates/cua-spaces-ext/LICENSE) | FSL-1.1-MIT | Cua Spaces extensions: teleport, the Cua Volume (`cua-volume`) tools, persistent agents, the streaming client behind `StreamSession`, and the daemon extension (Keyvault broker, site login, volume backends) |
+| [`libs/cua/crates/cua-spaces-ffi/LICENSE`](../libs/cua/crates/cua-spaces-ffi/LICENSE) | FSL-1.1-MIT | The Spaces app export: the SDK plus the app core, teleport, the Keyvault client and decoded media (BGRA frames, PCM audio), for the SwiftUI app |
+| [`libs/cua/crates/cua-spaces-cli/LICENSE`](../libs/cua/crates/cua-spaces-cli/LICENSE) | FSL-1.1-MIT | The Cua Spaces build of `cua` (`cua-spaces-cli`), including `cua viewer` and the decoding `cua sb stream-probe` |
+| [`libs/cua/crates/cua-media-protocol/LICENSE`](../libs/cua/crates/cua-media-protocol/LICENSE) | FSL-1.1-MIT | Streaming | `cua-spaces`: `stream::StreamClient` / `StreamConnection` behind `StreamSession` (input crosses as JSON; without a registered client it fails with `host_capability_missing`); `cua-sdk`: `MediaSession` (encoded frames); `cua-cli`: `CliExtension::viewer` and `open_media_decoded`; `cua-proto` (`StreamService`) | `cua-spaces-ext::stream::MediaStreams` (the RCDP client over `cua-media-client`, `cua-media-protocol`, `cua-media-transport`); `cua-spaces-ffi::media_decode` (decoded BGRA and PCM); `cua-spaces-cli` (`cua viewer`, the decoding stream probe); `CuaSpacesStreaming` |
| Presence cursors | `cua-spaces`: `presence::PresenceDatagrams` (without it cursors ride the Join stream and `UpdateCursor`) | `cua-spaces-ext::presence_datagrams::QuicPresence` (the `cua-presence/1` QUIC datagram channel) |
-| [`libs/cua/crates/cua-media-transport/LICENSE`](libs/cua/crates/cua-media-transport/LICENSE) | FSL-1.1-MIT | Streaming transport: RCDP framing and pinned QUIC |
-| [`libs/cua/crates/cua-media-client/LICENSE`](libs/cua/crates/cua-media-client/LICENSE) | FSL-1.1-MIT | Streaming client: the RCDP client state machine and decoding |
-| [`libs/cua/crates/cua-media-codec/LICENSE`](libs/cua/crates/cua-media-codec/LICENSE) | FSL-1.1-MIT | Streaming codecs: encoders, decoders, encoder probing and selection, audio capture and Opus |
-| [`libs/cua/crates/cua-viewer/LICENSE`](libs/cua/crates/cua-viewer/LICENSE) | FSL-1.1-MIT | Native proxy-window viewer for app shares |
-| [`libs/cua/crates/cua-spacesd-html5/LICENSE`](libs/cua/crates/cua-spacesd-html5/LICENSE) | FSL-1.1-MIT | HTML5 viewer (WebCodecs) and its standalone server |
-| [`libs/cua/crates/cua-logging/LICENSE`](libs/cua/crates/cua-logging/LICENSE) | FSL-1.1-MIT | Diagnostics for the streaming binaries |
-| [`libs/spaces-app-swift/LICENSE`](libs/spaces-app-swift/LICENSE) | FSL-1.1-MIT | Swift binding of the Spaces app export, the teleport picker and the streaming client (`CuaSpacesFFI`, `CuaSpacesTeleport`, `CuaSpacesStreaming`) |
-| [`libs/spaces-notch-swift/LICENSE`](libs/spaces-notch-swift/LICENSE) | FSL-1.1-MIT | The notch views shared by the SwiftUI app and the Electron app's macOS notch helper (`CuaSpacesNotchUI`, `CuaSpacesNotchHelper`, "Cua Spaces Notch.app") |
-| [`samples/cua-bots-macos/LICENSE`](samples/cua-bots-macos/LICENSE) | FSL-1.1-MIT | Cua Bots for macOS sample (links the Spaces app export for the Keyvault client) |
-| [`samples/cua-bots-ios/LICENSE`](samples/cua-bots-ios/LICENSE) | FSL-1.1-MIT | Cua Bots for iPhone sample (builds on the macOS sample's package) |
-| [`samples/infinite-canvas-swift/LICENSE`](samples/infinite-canvas-swift/LICENSE) | FSL-1.1-MIT | Infinite Canvas sample (uses the streaming client) |
-| [`samples/openkoalabot-example-swift/LICENSE`](samples/openkoalabot-example-swift/LICENSE) | FSL-1.1-MIT | OpenKoalaBots Swift sample (uses the streaming client) |
-| [`samples/openkoalabot-example-tauri/LICENSE`](samples/openkoalabot-example-tauri/LICENSE) | FSL-1.1-MIT | OpenKoalaBots Tauri sample (uses the streaming client) |
-| [`benchmarks/cua-driver-bench/LICENSE`](benchmarks/cua-driver-bench/LICENSE) | FSL-1.1-MIT | Cua Driver Bench: harness, task set, method and results (MIT up to #4978; the digest-pinned task files have no per-file headers) |
-| [`libs/cua-bench/LICENSE`](libs/cua-bench/LICENSE) | MIT | Package |
-| [`libs/cua-bench-rl/LICENSE`](libs/cua-bench-rl/LICENSE) | MIT | Package |
-| [`libs/cua-bench-s1/python/LICENSE`](libs/cua-bench-s1/python/LICENSE) | MIT | Package |
-| [`libs/cua-s1/python/LICENSE`](libs/cua-s1/python/LICENSE) | MIT | Package |
-| [`libs/kasm/LICENSE`](libs/kasm/LICENSE) | MIT | Package; includes portions copyright Kasm Technologies Inc. |
-| [`libs/lume/metal-capability-shim/LICENSE`](libs/lume/metal-capability-shim/LICENSE) | MIT | Package |
-| [`libs/python/cua-sandbox/LICENSE`](libs/python/cua-sandbox/LICENSE) | MIT | Package; `THIRD_PARTY_NOTICES.md` beside it lists derived code |
-| [`libs/python/som/LICENSE`](libs/python/som/LICENSE) | AGPL-3.0-or-later | Package; `-or-later` per `pyproject.toml` |
-| [`libs/typescript/core/LICENSE`](libs/typescript/core/LICENSE) | MIT | Package |
-| [`libs/cua-driver/rust/crates/cua-perception/tests/quality-corpus/LICENSE`](libs/cua-driver/rust/crates/cua-perception/tests/quality-corpus/LICENSE) | MIT | Test corpus; Cua-authored synthetic data (see its `PROVENANCE.md`) |
-| [`libs/cua-driver/rust/crates/cua-perception/models/licenses/AGPL-3.0-only.txt`](libs/cua-driver/rust/crates/cua-perception/models/licenses/AGPL-3.0-only.txt) | AGPL-3.0-only | Third-party model licence text; see [`THIRD_PARTY_NOTICES.md`](libs/cua-driver/rust/crates/cua-perception/models/THIRD_PARTY_NOTICES.md) |
-| [`libs/cua-driver/rust/crates/cua-perception/models/licenses/Apache-2.0.txt`](libs/cua-driver/rust/crates/cua-perception/models/licenses/Apache-2.0.txt) | Apache-2.0 | Third-party model licence text; see [`THIRD_PARTY_NOTICES.md`](libs/cua-driver/rust/crates/cua-perception/models/THIRD_PARTY_NOTICES.md) |
+| [`libs/cua/crates/cua-media-transport/LICENSE`](../libs/cua/crates/cua-media-transport/LICENSE) | FSL-1.1-MIT | Streaming transport: RCDP framing and pinned QUIC |
+| [`libs/cua/crates/cua-media-client/LICENSE`](../libs/cua/crates/cua-media-client/LICENSE) | FSL-1.1-MIT | Streaming client: the RCDP client state machine and decoding |
+| [`libs/cua/crates/cua-media-codec/LICENSE`](../libs/cua/crates/cua-media-codec/LICENSE) | FSL-1.1-MIT | Streaming codecs: encoders, decoders, encoder probing and selection, audio capture and Opus |
+| [`libs/cua/crates/cua-viewer/LICENSE`](../libs/cua/crates/cua-viewer/LICENSE) | FSL-1.1-MIT | Native proxy-window viewer for app shares |
+| [`libs/cua/crates/cua-spacesd-html5/LICENSE`](../libs/cua/crates/cua-spacesd-html5/LICENSE) | FSL-1.1-MIT | HTML5 viewer (WebCodecs) and its standalone server |
+| [`libs/cua/crates/cua-logging/LICENSE`](../libs/cua/crates/cua-logging/LICENSE) | FSL-1.1-MIT | Diagnostics for the streaming binaries |
+| [`libs/spaces-app-swift/LICENSE`](../libs/spaces-app-swift/LICENSE) | FSL-1.1-MIT | Swift binding of the Spaces app export, the teleport picker and the streaming client (`CuaSpacesFFI`, `CuaSpacesTeleport`, `CuaSpacesStreaming`) |
+| [`libs/spaces-notch-swift/LICENSE`](../libs/spaces-notch-swift/LICENSE) | FSL-1.1-MIT | The notch views shared by the SwiftUI app and the Electron app's macOS notch helper (`CuaSpacesNotchUI`, `CuaSpacesNotchHelper`, "Cua Spaces Notch.app") |
+| [`examples/cua-bots-macos/LICENSE`](../examples/cua-bots-macos/LICENSE) | FSL-1.1-MIT | Cua Bots for macOS sample (links the Spaces app export for the Keyvault client) |
+| [`examples/cua-bots-ios/LICENSE`](../examples/cua-bots-ios/LICENSE) | FSL-1.1-MIT | Cua Bots for iPhone sample (builds on the macOS sample's package) |
+| [`examples/infinite-canvas-swift/LICENSE`](../examples/infinite-canvas-swift/LICENSE) | FSL-1.1-MIT | Infinite Canvas sample (uses the streaming client) |
+| [`examples/openkoalabot-example-swift/LICENSE`](../examples/openkoalabot-example-swift/LICENSE) | FSL-1.1-MIT | OpenKoalaBots Swift sample (uses the streaming client) |
+| [`examples/openkoalabot-example-tauri/LICENSE`](../examples/openkoalabot-example-tauri/LICENSE) | FSL-1.1-MIT | OpenKoalaBots Tauri sample (uses the streaming client) |
+| [`libs/cua-driver-bench/LICENSE`](../libs/cua-driver-bench/LICENSE) | FSL-1.1-MIT | Cua Driver Bench: harness, task set, method and results (MIT up to #4978; the digest-pinned task files have no per-file headers) |
+| [`libs/cua-bench/LICENSE`](../libs/cua-bench/LICENSE) | MIT | Package |
+| [`libs/cua-bench-rl/LICENSE`](../libs/cua-bench-rl/LICENSE) | MIT | Package |
+| [`libs/cua-bench-s1/python/LICENSE`](../libs/cua-bench-s1/python/LICENSE) | MIT | Package |
+| [`libs/cua-s1/python/LICENSE`](../libs/cua-s1/python/LICENSE) | MIT | Package |
+| [`libs/kasm/LICENSE`](../libs/kasm/LICENSE) | MIT | Package; includes portions copyright Kasm Technologies Inc. |
+| [`libs/lume/metal-capability-shim/LICENSE`](../libs/lume/metal-capability-shim/LICENSE) | MIT | Package |
+| [`libs/python/cua-sandbox/LICENSE`](../libs/python/cua-sandbox/LICENSE) | MIT | Package; `THIRD_PARTY_NOTICES.md` beside it lists derived code |
+| [`libs/python/som/LICENSE`](../libs/python/som/LICENSE) | AGPL-3.0-or-later | Package; `-or-later` per `pyproject.toml` |
+| [`libs/typescript/core/LICENSE`](../libs/typescript/core/LICENSE) | MIT | Package |
+| [`libs/cua-driver/rust/crates/cua-perception/tests/quality-corpus/LICENSE`](../libs/cua-driver/rust/crates/cua-perception/tests/quality-corpus/LICENSE) | MIT | Test corpus; Cua-authored synthetic data (see its `PROVENANCE.md`) |
+| [`libs/cua-driver/rust/crates/cua-perception/models/licenses/AGPL-3.0-only.txt`](../libs/cua-driver/rust/crates/cua-perception/models/licenses/AGPL-3.0-only.txt) | AGPL-3.0-only | Third-party model licence text; see [`THIRD_PARTY_NOTICES.md`](../libs/cua-driver/rust/crates/cua-perception/models/THIRD_PARTY_NOTICES.md) |
+| [`libs/cua-driver/rust/crates/cua-perception/models/licenses/Apache-2.0.txt`](../libs/cua-driver/rust/crates/cua-perception/models/licenses/Apache-2.0.txt) | Apache-2.0 | Third-party model licence text; see [`THIRD_PARTY_NOTICES.md`](../libs/cua-driver/rust/crates/cua-perception/models/THIRD_PARTY_NOTICES.md) |
Packages without a LICENSE file of their own fall under the root MIT License.
When you add a LICENSE file to a subdirectory, add a row here and set the same
@@ -88,7 +88,7 @@ client and its codecs and viewers (`cua-media-client`, `cua-media-codec`,
`CuaSpacesStreaming`), and the glue that plugs them into the MIT runtime
(`cua-spaces-ext`, `cua-spaces-ffi`, `cua-spaces-cli`,
`libs/spaces-app-swift`). The samples that link those pieces are FSL too:
-Cua Bots (`samples/cua-bots-macos`, `samples/cua-bots-ios`), Infinite Canvas
+Cua Bots (`examples/cua-bots-macos`, `examples/cua-bots-ios`), Infinite Canvas
and the OpenKoalaBots Swift and Tauri samples.
The streaming protocol (`cua-media-protocol`) and transport
@@ -160,7 +160,7 @@ That file also lists the apps' npm dependencies and their licences; regenerate
it with `node scripts/licenses/notices.mjs`, which fails on a licence outside
the allow-list. Both app bundles ship the file in their resources and link to
it from the About panel; see
-[`scripts/licenses/README.md`](scripts/licenses/README.md).
+[`scripts/licenses/README.md`](../scripts/licenses/README.md).
No T3 branding is used: the apps carry only Cua names and logos.
diff --git a/THIRD_PARTY_NOTICES.md b/legal/THIRD_PARTY_NOTICES.md
similarity index 100%
rename from THIRD_PARTY_NOTICES.md
rename to legal/THIRD_PARTY_NOTICES.md
diff --git a/TRADEMARKS.md b/legal/TRADEMARKS.md
similarity index 100%
rename from TRADEMARKS.md
rename to legal/TRADEMARKS.md
diff --git a/samples/openkoalabot-example-tauri/LICENSE b/libs/cua-driver-bench/LICENSE
similarity index 100%
rename from samples/openkoalabot-example-tauri/LICENSE
rename to libs/cua-driver-bench/LICENSE
diff --git a/benchmarks/cua-driver-bench/METHOD.md b/libs/cua-driver-bench/METHOD.md
similarity index 100%
rename from benchmarks/cua-driver-bench/METHOD.md
rename to libs/cua-driver-bench/METHOD.md
diff --git a/benchmarks/cua-driver-bench/README.md b/libs/cua-driver-bench/README.md
similarity index 98%
rename from benchmarks/cua-driver-bench/README.md
rename to libs/cua-driver-bench/README.md
index 4db682c5bd..b27528f028 100644
--- a/benchmarks/cua-driver-bench/README.md
+++ b/libs/cua-driver-bench/README.md
@@ -119,7 +119,7 @@ public setups.
## Reproduce
You need an Apple silicon Mac that is not your daily machine, or better, a
-macOS VM on one. The registered runs used one [Lume](../../libs/lume) macOS VM.
+macOS VM on one. The registered runs used one [Lume](../lume) macOS VM.
### 1. Prepare the macOS VM
@@ -139,8 +139,8 @@ Keep the desktop clear: windows that cover BenchLab break real-input clicks.
```bash
export CDB_BENCH_WORK=~/bench-work
mkdir -p "$CDB_BENCH_WORK/src"
-cp -R benchmarks/cua-driver-bench/automated-eval/macos_bench "$CDB_BENCH_WORK/src/"
-cp -R benchmarks/cua-driver-bench/taskpack "$CDB_BENCH_WORK/taskpack"
+cp -R libs/cua-driver-bench/automated-eval/macos_bench "$CDB_BENCH_WORK/src/"
+cp -R libs/cua-driver-bench/taskpack "$CDB_BENCH_WORK/taskpack"
cd "$CDB_BENCH_WORK/src/macos_bench"
swift/build.sh "$CDB_BENCH_WORK/build" # BenchLab.app and BenchSentinel.app, ad-hoc signed
```
@@ -266,7 +266,7 @@ You may use, copy, modify and run the benchmark for any purpose, including
commercial ones such as evaluating your own product, except a Competing Use:
offering it, or something substantially similar, to others as a commercial
product or service. For that you need a commercial licence from Cua; see
-[COMMERCIAL.md](../../COMMERCIAL.md). Each release becomes available under MIT
+[COMMERCIAL.md](../../legal/COMMERCIAL.md). Each release becomes available under MIT
two years after it is published.
Versions published before this change, at commits `bf94fd5c7` (#4973) and
diff --git a/benchmarks/cua-driver-bench/automated-eval/macos_bench/README.md b/libs/cua-driver-bench/automated-eval/macos_bench/README.md
similarity index 100%
rename from benchmarks/cua-driver-bench/automated-eval/macos_bench/README.md
rename to libs/cua-driver-bench/automated-eval/macos_bench/README.md
diff --git a/benchmarks/cua-driver-bench/automated-eval/macos_bench/RUNNER.md b/libs/cua-driver-bench/automated-eval/macos_bench/RUNNER.md
similarity index 100%
rename from benchmarks/cua-driver-bench/automated-eval/macos_bench/RUNNER.md
rename to libs/cua-driver-bench/automated-eval/macos_bench/RUNNER.md
diff --git a/benchmarks/cua-driver-bench/automated-eval/macos_bench/TASKS.md b/libs/cua-driver-bench/automated-eval/macos_bench/TASKS.md
similarity index 100%
rename from benchmarks/cua-driver-bench/automated-eval/macos_bench/TASKS.md
rename to libs/cua-driver-bench/automated-eval/macos_bench/TASKS.md
diff --git a/benchmarks/cua-driver-bench/automated-eval/macos_bench/analyze.py b/libs/cua-driver-bench/automated-eval/macos_bench/analyze.py
similarity index 100%
rename from benchmarks/cua-driver-bench/automated-eval/macos_bench/analyze.py
rename to libs/cua-driver-bench/automated-eval/macos_bench/analyze.py
diff --git a/benchmarks/cua-driver-bench/automated-eval/macos_bench/analyze_bench.py b/libs/cua-driver-bench/automated-eval/macos_bench/analyze_bench.py
similarity index 100%
rename from benchmarks/cua-driver-bench/automated-eval/macos_bench/analyze_bench.py
rename to libs/cua-driver-bench/automated-eval/macos_bench/analyze_bench.py
diff --git a/benchmarks/cua-driver-bench/automated-eval/macos_bench/arms.py b/libs/cua-driver-bench/automated-eval/macos_bench/arms.py
similarity index 100%
rename from benchmarks/cua-driver-bench/automated-eval/macos_bench/arms.py
rename to libs/cua-driver-bench/automated-eval/macos_bench/arms.py
diff --git a/benchmarks/cua-driver-bench/automated-eval/macos_bench/bench_core.py b/libs/cua-driver-bench/automated-eval/macos_bench/bench_core.py
similarity index 100%
rename from benchmarks/cua-driver-bench/automated-eval/macos_bench/bench_core.py
rename to libs/cua-driver-bench/automated-eval/macos_bench/bench_core.py
diff --git a/benchmarks/cua-driver-bench/automated-eval/macos_bench/bench_v2.py b/libs/cua-driver-bench/automated-eval/macos_bench/bench_v2.py
similarity index 100%
rename from benchmarks/cua-driver-bench/automated-eval/macos_bench/bench_v2.py
rename to libs/cua-driver-bench/automated-eval/macos_bench/bench_v2.py
diff --git a/benchmarks/cua-driver-bench/automated-eval/macos_bench/cdb_adapter.py b/libs/cua-driver-bench/automated-eval/macos_bench/cdb_adapter.py
similarity index 100%
rename from benchmarks/cua-driver-bench/automated-eval/macos_bench/cdb_adapter.py
rename to libs/cua-driver-bench/automated-eval/macos_bench/cdb_adapter.py
diff --git a/benchmarks/cua-driver-bench/automated-eval/macos_bench/claude_arms.py b/libs/cua-driver-bench/automated-eval/macos_bench/claude_arms.py
similarity index 100%
rename from benchmarks/cua-driver-bench/automated-eval/macos_bench/claude_arms.py
rename to libs/cua-driver-bench/automated-eval/macos_bench/claude_arms.py
diff --git a/benchmarks/cua-driver-bench/automated-eval/macos_bench/claude_driver.py b/libs/cua-driver-bench/automated-eval/macos_bench/claude_driver.py
similarity index 100%
rename from benchmarks/cua-driver-bench/automated-eval/macos_bench/claude_driver.py
rename to libs/cua-driver-bench/automated-eval/macos_bench/claude_driver.py
diff --git a/benchmarks/cua-driver-bench/automated-eval/macos_bench/claude_events.py b/libs/cua-driver-bench/automated-eval/macos_bench/claude_events.py
similarity index 100%
rename from benchmarks/cua-driver-bench/automated-eval/macos_bench/claude_events.py
rename to libs/cua-driver-bench/automated-eval/macos_bench/claude_events.py
diff --git a/benchmarks/cua-driver-bench/automated-eval/macos_bench/codex_events.py b/libs/cua-driver-bench/automated-eval/macos_bench/codex_events.py
similarity index 100%
rename from benchmarks/cua-driver-bench/automated-eval/macos_bench/codex_events.py
rename to libs/cua-driver-bench/automated-eval/macos_bench/codex_events.py
diff --git a/benchmarks/cua-driver-bench/automated-eval/macos_bench/codex_native.py b/libs/cua-driver-bench/automated-eval/macos_bench/codex_native.py
similarity index 100%
rename from benchmarks/cua-driver-bench/automated-eval/macos_bench/codex_native.py
rename to libs/cua-driver-bench/automated-eval/macos_bench/codex_native.py
diff --git a/benchmarks/cua-driver-bench/automated-eval/macos_bench/launch/launch.env.example b/libs/cua-driver-bench/automated-eval/macos_bench/launch/launch.env.example
similarity index 100%
rename from benchmarks/cua-driver-bench/automated-eval/macos_bench/launch/launch.env.example
rename to libs/cua-driver-bench/automated-eval/macos_bench/launch/launch.env.example
diff --git a/benchmarks/cua-driver-bench/automated-eval/macos_bench/launch/launch_bench.command b/libs/cua-driver-bench/automated-eval/macos_bench/launch/launch_bench.command
similarity index 100%
rename from benchmarks/cua-driver-bench/automated-eval/macos_bench/launch/launch_bench.command
rename to libs/cua-driver-bench/automated-eval/macos_bench/launch/launch_bench.command
diff --git a/benchmarks/cua-driver-bench/automated-eval/macos_bench/launch/watch_bench.py b/libs/cua-driver-bench/automated-eval/macos_bench/launch/watch_bench.py
similarity index 100%
rename from benchmarks/cua-driver-bench/automated-eval/macos_bench/launch/watch_bench.py
rename to libs/cua-driver-bench/automated-eval/macos_bench/launch/watch_bench.py
diff --git a/benchmarks/cua-driver-bench/automated-eval/macos_bench/mcp_preflight.py b/libs/cua-driver-bench/automated-eval/macos_bench/mcp_preflight.py
similarity index 100%
rename from benchmarks/cua-driver-bench/automated-eval/macos_bench/mcp_preflight.py
rename to libs/cua-driver-bench/automated-eval/macos_bench/mcp_preflight.py
diff --git a/benchmarks/cua-driver-bench/automated-eval/macos_bench/pins.json b/libs/cua-driver-bench/automated-eval/macos_bench/pins.json
similarity index 98%
rename from benchmarks/cua-driver-bench/automated-eval/macos_bench/pins.json
rename to libs/cua-driver-bench/automated-eval/macos_bench/pins.json
index ad05a78601..b55888de2e 100644
--- a/benchmarks/cua-driver-bench/automated-eval/macos_bench/pins.json
+++ b/libs/cua-driver-bench/automated-eval/macos_bench/pins.json
@@ -18,7 +18,7 @@
"codex_computer_use_service_version": "26.929.1001365",
"environment": "Lume macOS VM on a Mac Studio host (M3 Ultra), cloned from the cached cua-base image; 6 CPU, 12 GB, 1920x1080; one VM for both arms",
"cdb_pack": {
- "repo": "trycua/cua, benchmarks/cua-driver-bench/taskpack (public copy)",
+ "repo": "trycua/cua, libs/cua-driver-bench/taskpack (public copy)",
"source": "Copied from Cua's private benchmark repository at revision 16a1937a79ff2ee2e48f5b5d9bb5e6f944119b5a; see taskpack/README.md. shared/cdb-s02 also carries the Amendment 19 checker fix (one Schedule row per session). The licence metadata (package.json/package-lock.json `license`, PROVENANCE.md) was changed from MIT to FSL-1.1-MIT on 11 Oct 2026; `mit_release_tree_sha256` holds the digests of the MIT copy published in #4973/#4978.",
"revision": "16a1937a79ff2ee2e48f5b5d9bb5e6f944119b5a",
"tree_sha256": {
diff --git a/benchmarks/cua-driver-bench/automated-eval/macos_bench/post_hoc.py b/libs/cua-driver-bench/automated-eval/macos_bench/post_hoc.py
similarity index 100%
rename from benchmarks/cua-driver-bench/automated-eval/macos_bench/post_hoc.py
rename to libs/cua-driver-bench/automated-eval/macos_bench/post_hoc.py
diff --git a/benchmarks/cua-driver-bench/automated-eval/macos_bench/probes/CDB-G02/PROVENANCE.md b/libs/cua-driver-bench/automated-eval/macos_bench/probes/CDB-G02/PROVENANCE.md
similarity index 100%
rename from benchmarks/cua-driver-bench/automated-eval/macos_bench/probes/CDB-G02/PROVENANCE.md
rename to libs/cua-driver-bench/automated-eval/macos_bench/probes/CDB-G02/PROVENANCE.md
diff --git a/benchmarks/cua-driver-bench/automated-eval/macos_bench/probes/CDB-G02/task.json b/libs/cua-driver-bench/automated-eval/macos_bench/probes/CDB-G02/task.json
similarity index 100%
rename from benchmarks/cua-driver-bench/automated-eval/macos_bench/probes/CDB-G02/task.json
rename to libs/cua-driver-bench/automated-eval/macos_bench/probes/CDB-G02/task.json
diff --git a/benchmarks/cua-driver-bench/automated-eval/macos_bench/probes/CDB-G03/PROVENANCE.md b/libs/cua-driver-bench/automated-eval/macos_bench/probes/CDB-G03/PROVENANCE.md
similarity index 100%
rename from benchmarks/cua-driver-bench/automated-eval/macos_bench/probes/CDB-G03/PROVENANCE.md
rename to libs/cua-driver-bench/automated-eval/macos_bench/probes/CDB-G03/PROVENANCE.md
diff --git a/benchmarks/cua-driver-bench/automated-eval/macos_bench/probes/CDB-G03/task.json b/libs/cua-driver-bench/automated-eval/macos_bench/probes/CDB-G03/task.json
similarity index 100%
rename from benchmarks/cua-driver-bench/automated-eval/macos_bench/probes/CDB-G03/task.json
rename to libs/cua-driver-bench/automated-eval/macos_bench/probes/CDB-G03/task.json
diff --git a/benchmarks/cua-driver-bench/automated-eval/macos_bench/probes/CDB-G04/PROVENANCE.md b/libs/cua-driver-bench/automated-eval/macos_bench/probes/CDB-G04/PROVENANCE.md
similarity index 100%
rename from benchmarks/cua-driver-bench/automated-eval/macos_bench/probes/CDB-G04/PROVENANCE.md
rename to libs/cua-driver-bench/automated-eval/macos_bench/probes/CDB-G04/PROVENANCE.md
diff --git a/benchmarks/cua-driver-bench/automated-eval/macos_bench/probes/CDB-G04/task.json b/libs/cua-driver-bench/automated-eval/macos_bench/probes/CDB-G04/task.json
similarity index 100%
rename from benchmarks/cua-driver-bench/automated-eval/macos_bench/probes/CDB-G04/task.json
rename to libs/cua-driver-bench/automated-eval/macos_bench/probes/CDB-G04/task.json
diff --git a/benchmarks/cua-driver-bench/automated-eval/macos_bench/probes/CDB-S02/PROVENANCE.md b/libs/cua-driver-bench/automated-eval/macos_bench/probes/CDB-S02/PROVENANCE.md
similarity index 100%
rename from benchmarks/cua-driver-bench/automated-eval/macos_bench/probes/CDB-S02/PROVENANCE.md
rename to libs/cua-driver-bench/automated-eval/macos_bench/probes/CDB-S02/PROVENANCE.md
diff --git a/benchmarks/cua-driver-bench/automated-eval/macos_bench/probes/CDB-S02/task.json b/libs/cua-driver-bench/automated-eval/macos_bench/probes/CDB-S02/task.json
similarity index 100%
rename from benchmarks/cua-driver-bench/automated-eval/macos_bench/probes/CDB-S02/task.json
rename to libs/cua-driver-bench/automated-eval/macos_bench/probes/CDB-S02/task.json
diff --git a/benchmarks/cua-driver-bench/automated-eval/macos_bench/probes/CDB-S03/PROVENANCE.md b/libs/cua-driver-bench/automated-eval/macos_bench/probes/CDB-S03/PROVENANCE.md
similarity index 100%
rename from benchmarks/cua-driver-bench/automated-eval/macos_bench/probes/CDB-S03/PROVENANCE.md
rename to libs/cua-driver-bench/automated-eval/macos_bench/probes/CDB-S03/PROVENANCE.md
diff --git a/benchmarks/cua-driver-bench/automated-eval/macos_bench/probes/CDB-S03/task.json b/libs/cua-driver-bench/automated-eval/macos_bench/probes/CDB-S03/task.json
similarity index 100%
rename from benchmarks/cua-driver-bench/automated-eval/macos_bench/probes/CDB-S03/task.json
rename to libs/cua-driver-bench/automated-eval/macos_bench/probes/CDB-S03/task.json
diff --git a/benchmarks/cua-driver-bench/automated-eval/macos_bench/probes/CDB-S04/PROVENANCE.md b/libs/cua-driver-bench/automated-eval/macos_bench/probes/CDB-S04/PROVENANCE.md
similarity index 100%
rename from benchmarks/cua-driver-bench/automated-eval/macos_bench/probes/CDB-S04/PROVENANCE.md
rename to libs/cua-driver-bench/automated-eval/macos_bench/probes/CDB-S04/PROVENANCE.md
diff --git a/benchmarks/cua-driver-bench/automated-eval/macos_bench/probes/CDB-S04/task.json b/libs/cua-driver-bench/automated-eval/macos_bench/probes/CDB-S04/task.json
similarity index 100%
rename from benchmarks/cua-driver-bench/automated-eval/macos_bench/probes/CDB-S04/task.json
rename to libs/cua-driver-bench/automated-eval/macos_bench/probes/CDB-S04/task.json
diff --git a/benchmarks/cua-driver-bench/automated-eval/macos_bench/probes/IR-01/PROVENANCE.md b/libs/cua-driver-bench/automated-eval/macos_bench/probes/IR-01/PROVENANCE.md
similarity index 100%
rename from benchmarks/cua-driver-bench/automated-eval/macos_bench/probes/IR-01/PROVENANCE.md
rename to libs/cua-driver-bench/automated-eval/macos_bench/probes/IR-01/PROVENANCE.md
diff --git a/benchmarks/cua-driver-bench/automated-eval/macos_bench/probes/IR-01/brief.md b/libs/cua-driver-bench/automated-eval/macos_bench/probes/IR-01/brief.md
similarity index 100%
rename from benchmarks/cua-driver-bench/automated-eval/macos_bench/probes/IR-01/brief.md
rename to libs/cua-driver-bench/automated-eval/macos_bench/probes/IR-01/brief.md
diff --git a/benchmarks/cua-driver-bench/automated-eval/macos_bench/probes/IR-01/evaluate.py b/libs/cua-driver-bench/automated-eval/macos_bench/probes/IR-01/evaluate.py
similarity index 100%
rename from benchmarks/cua-driver-bench/automated-eval/macos_bench/probes/IR-01/evaluate.py
rename to libs/cua-driver-bench/automated-eval/macos_bench/probes/IR-01/evaluate.py
diff --git a/benchmarks/cua-driver-bench/automated-eval/macos_bench/probes/IR-01/render_brief.py b/libs/cua-driver-bench/automated-eval/macos_bench/probes/IR-01/render_brief.py
similarity index 100%
rename from benchmarks/cua-driver-bench/automated-eval/macos_bench/probes/IR-01/render_brief.py
rename to libs/cua-driver-bench/automated-eval/macos_bench/probes/IR-01/render_brief.py
diff --git a/benchmarks/cua-driver-bench/automated-eval/macos_bench/probes/IR-01/task.json b/libs/cua-driver-bench/automated-eval/macos_bench/probes/IR-01/task.json
similarity index 100%
rename from benchmarks/cua-driver-bench/automated-eval/macos_bench/probes/IR-01/task.json
rename to libs/cua-driver-bench/automated-eval/macos_bench/probes/IR-01/task.json
diff --git a/benchmarks/cua-driver-bench/automated-eval/macos_bench/probes/IR-02/PROVENANCE.md b/libs/cua-driver-bench/automated-eval/macos_bench/probes/IR-02/PROVENANCE.md
similarity index 100%
rename from benchmarks/cua-driver-bench/automated-eval/macos_bench/probes/IR-02/PROVENANCE.md
rename to libs/cua-driver-bench/automated-eval/macos_bench/probes/IR-02/PROVENANCE.md
diff --git a/benchmarks/cua-driver-bench/automated-eval/macos_bench/probes/IR-02/brief.md b/libs/cua-driver-bench/automated-eval/macos_bench/probes/IR-02/brief.md
similarity index 100%
rename from benchmarks/cua-driver-bench/automated-eval/macos_bench/probes/IR-02/brief.md
rename to libs/cua-driver-bench/automated-eval/macos_bench/probes/IR-02/brief.md
diff --git a/benchmarks/cua-driver-bench/automated-eval/macos_bench/probes/IR-02/evaluate.py b/libs/cua-driver-bench/automated-eval/macos_bench/probes/IR-02/evaluate.py
similarity index 100%
rename from benchmarks/cua-driver-bench/automated-eval/macos_bench/probes/IR-02/evaluate.py
rename to libs/cua-driver-bench/automated-eval/macos_bench/probes/IR-02/evaluate.py
diff --git a/benchmarks/cua-driver-bench/automated-eval/macos_bench/probes/IR-02/render_brief.py b/libs/cua-driver-bench/automated-eval/macos_bench/probes/IR-02/render_brief.py
similarity index 100%
rename from benchmarks/cua-driver-bench/automated-eval/macos_bench/probes/IR-02/render_brief.py
rename to libs/cua-driver-bench/automated-eval/macos_bench/probes/IR-02/render_brief.py
diff --git a/benchmarks/cua-driver-bench/automated-eval/macos_bench/probes/IR-02/task.json b/libs/cua-driver-bench/automated-eval/macos_bench/probes/IR-02/task.json
similarity index 100%
rename from benchmarks/cua-driver-bench/automated-eval/macos_bench/probes/IR-02/task.json
rename to libs/cua-driver-bench/automated-eval/macos_bench/probes/IR-02/task.json
diff --git a/benchmarks/cua-driver-bench/automated-eval/macos_bench/probes/IR-03/PROVENANCE.md b/libs/cua-driver-bench/automated-eval/macos_bench/probes/IR-03/PROVENANCE.md
similarity index 100%
rename from benchmarks/cua-driver-bench/automated-eval/macos_bench/probes/IR-03/PROVENANCE.md
rename to libs/cua-driver-bench/automated-eval/macos_bench/probes/IR-03/PROVENANCE.md
diff --git a/benchmarks/cua-driver-bench/automated-eval/macos_bench/probes/IR-03/brief.md b/libs/cua-driver-bench/automated-eval/macos_bench/probes/IR-03/brief.md
similarity index 100%
rename from benchmarks/cua-driver-bench/automated-eval/macos_bench/probes/IR-03/brief.md
rename to libs/cua-driver-bench/automated-eval/macos_bench/probes/IR-03/brief.md
diff --git a/benchmarks/cua-driver-bench/automated-eval/macos_bench/probes/IR-03/evaluate.py b/libs/cua-driver-bench/automated-eval/macos_bench/probes/IR-03/evaluate.py
similarity index 100%
rename from benchmarks/cua-driver-bench/automated-eval/macos_bench/probes/IR-03/evaluate.py
rename to libs/cua-driver-bench/automated-eval/macos_bench/probes/IR-03/evaluate.py
diff --git a/benchmarks/cua-driver-bench/automated-eval/macos_bench/probes/IR-03/render_brief.py b/libs/cua-driver-bench/automated-eval/macos_bench/probes/IR-03/render_brief.py
similarity index 100%
rename from benchmarks/cua-driver-bench/automated-eval/macos_bench/probes/IR-03/render_brief.py
rename to libs/cua-driver-bench/automated-eval/macos_bench/probes/IR-03/render_brief.py
diff --git a/benchmarks/cua-driver-bench/automated-eval/macos_bench/probes/IR-03/task.json b/libs/cua-driver-bench/automated-eval/macos_bench/probes/IR-03/task.json
similarity index 100%
rename from benchmarks/cua-driver-bench/automated-eval/macos_bench/probes/IR-03/task.json
rename to libs/cua-driver-bench/automated-eval/macos_bench/probes/IR-03/task.json
diff --git a/benchmarks/cua-driver-bench/automated-eval/macos_bench/probes/IR-04/PROVENANCE.md b/libs/cua-driver-bench/automated-eval/macos_bench/probes/IR-04/PROVENANCE.md
similarity index 100%
rename from benchmarks/cua-driver-bench/automated-eval/macos_bench/probes/IR-04/PROVENANCE.md
rename to libs/cua-driver-bench/automated-eval/macos_bench/probes/IR-04/PROVENANCE.md
diff --git a/benchmarks/cua-driver-bench/automated-eval/macos_bench/probes/IR-04/brief.md b/libs/cua-driver-bench/automated-eval/macos_bench/probes/IR-04/brief.md
similarity index 100%
rename from benchmarks/cua-driver-bench/automated-eval/macos_bench/probes/IR-04/brief.md
rename to libs/cua-driver-bench/automated-eval/macos_bench/probes/IR-04/brief.md
diff --git a/benchmarks/cua-driver-bench/automated-eval/macos_bench/probes/IR-04/evaluate.py b/libs/cua-driver-bench/automated-eval/macos_bench/probes/IR-04/evaluate.py
similarity index 100%
rename from benchmarks/cua-driver-bench/automated-eval/macos_bench/probes/IR-04/evaluate.py
rename to libs/cua-driver-bench/automated-eval/macos_bench/probes/IR-04/evaluate.py
diff --git a/benchmarks/cua-driver-bench/automated-eval/macos_bench/probes/IR-04/render_brief.py b/libs/cua-driver-bench/automated-eval/macos_bench/probes/IR-04/render_brief.py
similarity index 100%
rename from benchmarks/cua-driver-bench/automated-eval/macos_bench/probes/IR-04/render_brief.py
rename to libs/cua-driver-bench/automated-eval/macos_bench/probes/IR-04/render_brief.py
diff --git a/benchmarks/cua-driver-bench/automated-eval/macos_bench/probes/IR-04/task.json b/libs/cua-driver-bench/automated-eval/macos_bench/probes/IR-04/task.json
similarity index 100%
rename from benchmarks/cua-driver-bench/automated-eval/macos_bench/probes/IR-04/task.json
rename to libs/cua-driver-bench/automated-eval/macos_bench/probes/IR-04/task.json
diff --git a/benchmarks/cua-driver-bench/automated-eval/macos_bench/probes/MB-09/PROVENANCE.md b/libs/cua-driver-bench/automated-eval/macos_bench/probes/MB-09/PROVENANCE.md
similarity index 100%
rename from benchmarks/cua-driver-bench/automated-eval/macos_bench/probes/MB-09/PROVENANCE.md
rename to libs/cua-driver-bench/automated-eval/macos_bench/probes/MB-09/PROVENANCE.md
diff --git a/benchmarks/cua-driver-bench/automated-eval/macos_bench/probes/MB-09/brief.md b/libs/cua-driver-bench/automated-eval/macos_bench/probes/MB-09/brief.md
similarity index 100%
rename from benchmarks/cua-driver-bench/automated-eval/macos_bench/probes/MB-09/brief.md
rename to libs/cua-driver-bench/automated-eval/macos_bench/probes/MB-09/brief.md
diff --git a/benchmarks/cua-driver-bench/automated-eval/macos_bench/probes/MB-09/evaluate.py b/libs/cua-driver-bench/automated-eval/macos_bench/probes/MB-09/evaluate.py
similarity index 100%
rename from benchmarks/cua-driver-bench/automated-eval/macos_bench/probes/MB-09/evaluate.py
rename to libs/cua-driver-bench/automated-eval/macos_bench/probes/MB-09/evaluate.py
diff --git a/benchmarks/cua-driver-bench/automated-eval/macos_bench/probes/MB-09/render_brief.py b/libs/cua-driver-bench/automated-eval/macos_bench/probes/MB-09/render_brief.py
similarity index 100%
rename from benchmarks/cua-driver-bench/automated-eval/macos_bench/probes/MB-09/render_brief.py
rename to libs/cua-driver-bench/automated-eval/macos_bench/probes/MB-09/render_brief.py
diff --git a/benchmarks/cua-driver-bench/automated-eval/macos_bench/probes/MB-09/task.json b/libs/cua-driver-bench/automated-eval/macos_bench/probes/MB-09/task.json
similarity index 100%
rename from benchmarks/cua-driver-bench/automated-eval/macos_bench/probes/MB-09/task.json
rename to libs/cua-driver-bench/automated-eval/macos_bench/probes/MB-09/task.json
diff --git a/benchmarks/cua-driver-bench/automated-eval/macos_bench/probes/MB-10/PROVENANCE.md b/libs/cua-driver-bench/automated-eval/macos_bench/probes/MB-10/PROVENANCE.md
similarity index 100%
rename from benchmarks/cua-driver-bench/automated-eval/macos_bench/probes/MB-10/PROVENANCE.md
rename to libs/cua-driver-bench/automated-eval/macos_bench/probes/MB-10/PROVENANCE.md
diff --git a/benchmarks/cua-driver-bench/automated-eval/macos_bench/probes/MB-10/brief.md b/libs/cua-driver-bench/automated-eval/macos_bench/probes/MB-10/brief.md
similarity index 100%
rename from benchmarks/cua-driver-bench/automated-eval/macos_bench/probes/MB-10/brief.md
rename to libs/cua-driver-bench/automated-eval/macos_bench/probes/MB-10/brief.md
diff --git a/benchmarks/cua-driver-bench/automated-eval/macos_bench/probes/MB-10/evaluate.py b/libs/cua-driver-bench/automated-eval/macos_bench/probes/MB-10/evaluate.py
similarity index 100%
rename from benchmarks/cua-driver-bench/automated-eval/macos_bench/probes/MB-10/evaluate.py
rename to libs/cua-driver-bench/automated-eval/macos_bench/probes/MB-10/evaluate.py
diff --git a/benchmarks/cua-driver-bench/automated-eval/macos_bench/probes/MB-10/render_brief.py b/libs/cua-driver-bench/automated-eval/macos_bench/probes/MB-10/render_brief.py
similarity index 100%
rename from benchmarks/cua-driver-bench/automated-eval/macos_bench/probes/MB-10/render_brief.py
rename to libs/cua-driver-bench/automated-eval/macos_bench/probes/MB-10/render_brief.py
diff --git a/benchmarks/cua-driver-bench/automated-eval/macos_bench/probes/MB-10/task.json b/libs/cua-driver-bench/automated-eval/macos_bench/probes/MB-10/task.json
similarity index 100%
rename from benchmarks/cua-driver-bench/automated-eval/macos_bench/probes/MB-10/task.json
rename to libs/cua-driver-bench/automated-eval/macos_bench/probes/MB-10/task.json
diff --git a/benchmarks/cua-driver-bench/automated-eval/macos_bench/probes/MB-11/PROVENANCE.md b/libs/cua-driver-bench/automated-eval/macos_bench/probes/MB-11/PROVENANCE.md
similarity index 100%
rename from benchmarks/cua-driver-bench/automated-eval/macos_bench/probes/MB-11/PROVENANCE.md
rename to libs/cua-driver-bench/automated-eval/macos_bench/probes/MB-11/PROVENANCE.md
diff --git a/benchmarks/cua-driver-bench/automated-eval/macos_bench/probes/MB-11/brief.md b/libs/cua-driver-bench/automated-eval/macos_bench/probes/MB-11/brief.md
similarity index 100%
rename from benchmarks/cua-driver-bench/automated-eval/macos_bench/probes/MB-11/brief.md
rename to libs/cua-driver-bench/automated-eval/macos_bench/probes/MB-11/brief.md
diff --git a/benchmarks/cua-driver-bench/automated-eval/macos_bench/probes/MB-11/evaluate.py b/libs/cua-driver-bench/automated-eval/macos_bench/probes/MB-11/evaluate.py
similarity index 100%
rename from benchmarks/cua-driver-bench/automated-eval/macos_bench/probes/MB-11/evaluate.py
rename to libs/cua-driver-bench/automated-eval/macos_bench/probes/MB-11/evaluate.py
diff --git a/benchmarks/cua-driver-bench/automated-eval/macos_bench/probes/MB-11/render_brief.py b/libs/cua-driver-bench/automated-eval/macos_bench/probes/MB-11/render_brief.py
similarity index 100%
rename from benchmarks/cua-driver-bench/automated-eval/macos_bench/probes/MB-11/render_brief.py
rename to libs/cua-driver-bench/automated-eval/macos_bench/probes/MB-11/render_brief.py
diff --git a/benchmarks/cua-driver-bench/automated-eval/macos_bench/probes/MB-11/task.json b/libs/cua-driver-bench/automated-eval/macos_bench/probes/MB-11/task.json
similarity index 100%
rename from benchmarks/cua-driver-bench/automated-eval/macos_bench/probes/MB-11/task.json
rename to libs/cua-driver-bench/automated-eval/macos_bench/probes/MB-11/task.json
diff --git a/benchmarks/cua-driver-bench/automated-eval/macos_bench/probes/_common/benchlab_common.py b/libs/cua-driver-bench/automated-eval/macos_bench/probes/_common/benchlab_common.py
similarity index 100%
rename from benchmarks/cua-driver-bench/automated-eval/macos_bench/probes/_common/benchlab_common.py
rename to libs/cua-driver-bench/automated-eval/macos_bench/probes/_common/benchlab_common.py
diff --git a/benchmarks/cua-driver-bench/automated-eval/macos_bench/probes/_common/clicks.py b/libs/cua-driver-bench/automated-eval/macos_bench/probes/_common/clicks.py
similarity index 100%
rename from benchmarks/cua-driver-bench/automated-eval/macos_bench/probes/_common/clicks.py
rename to libs/cua-driver-bench/automated-eval/macos_bench/probes/_common/clicks.py
diff --git a/benchmarks/cua-driver-bench/automated-eval/macos_bench/probes/_common/interrupts.py b/libs/cua-driver-bench/automated-eval/macos_bench/probes/_common/interrupts.py
similarity index 100%
rename from benchmarks/cua-driver-bench/automated-eval/macos_bench/probes/_common/interrupts.py
rename to libs/cua-driver-bench/automated-eval/macos_bench/probes/_common/interrupts.py
diff --git a/benchmarks/cua-driver-bench/automated-eval/macos_bench/probes/tests/synth.py b/libs/cua-driver-bench/automated-eval/macos_bench/probes/tests/synth.py
similarity index 100%
rename from benchmarks/cua-driver-bench/automated-eval/macos_bench/probes/tests/synth.py
rename to libs/cua-driver-bench/automated-eval/macos_bench/probes/tests/synth.py
diff --git a/benchmarks/cua-driver-bench/automated-eval/macos_bench/probes/tests/test_common.py b/libs/cua-driver-bench/automated-eval/macos_bench/probes/tests/test_common.py
similarity index 100%
rename from benchmarks/cua-driver-bench/automated-eval/macos_bench/probes/tests/test_common.py
rename to libs/cua-driver-bench/automated-eval/macos_bench/probes/tests/test_common.py
diff --git a/benchmarks/cua-driver-bench/automated-eval/macos_bench/probes/tests/test_interrupts.py b/libs/cua-driver-bench/automated-eval/macos_bench/probes/tests/test_interrupts.py
similarity index 100%
rename from benchmarks/cua-driver-bench/automated-eval/macos_bench/probes/tests/test_interrupts.py
rename to libs/cua-driver-bench/automated-eval/macos_bench/probes/tests/test_interrupts.py
diff --git a/benchmarks/cua-driver-bench/automated-eval/macos_bench/probes/tests/test_mb_parity.py b/libs/cua-driver-bench/automated-eval/macos_bench/probes/tests/test_mb_parity.py
similarity index 100%
rename from benchmarks/cua-driver-bench/automated-eval/macos_bench/probes/tests/test_mb_parity.py
rename to libs/cua-driver-bench/automated-eval/macos_bench/probes/tests/test_mb_parity.py
diff --git a/benchmarks/cua-driver-bench/automated-eval/macos_bench/recorder.py b/libs/cua-driver-bench/automated-eval/macos_bench/recorder.py
similarity index 100%
rename from benchmarks/cua-driver-bench/automated-eval/macos_bench/recorder.py
rename to libs/cua-driver-bench/automated-eval/macos_bench/recorder.py
diff --git a/benchmarks/cua-driver-bench/automated-eval/macos_bench/run_bench.py b/libs/cua-driver-bench/automated-eval/macos_bench/run_bench.py
similarity index 100%
rename from benchmarks/cua-driver-bench/automated-eval/macos_bench/run_bench.py
rename to libs/cua-driver-bench/automated-eval/macos_bench/run_bench.py
diff --git a/benchmarks/cua-driver-bench/automated-eval/macos_bench/run_pilot.py b/libs/cua-driver-bench/automated-eval/macos_bench/run_pilot.py
similarity index 100%
rename from benchmarks/cua-driver-bench/automated-eval/macos_bench/run_pilot.py
rename to libs/cua-driver-bench/automated-eval/macos_bench/run_pilot.py
diff --git a/benchmarks/cua-driver-bench/automated-eval/macos_bench/swift/BenchLab.swift b/libs/cua-driver-bench/automated-eval/macos_bench/swift/BenchLab.swift
similarity index 100%
rename from benchmarks/cua-driver-bench/automated-eval/macos_bench/swift/BenchLab.swift
rename to libs/cua-driver-bench/automated-eval/macos_bench/swift/BenchLab.swift
diff --git a/benchmarks/cua-driver-bench/automated-eval/macos_bench/swift/BenchLabInterrupts.swift b/libs/cua-driver-bench/automated-eval/macos_bench/swift/BenchLabInterrupts.swift
similarity index 100%
rename from benchmarks/cua-driver-bench/automated-eval/macos_bench/swift/BenchLabInterrupts.swift
rename to libs/cua-driver-bench/automated-eval/macos_bench/swift/BenchLabInterrupts.swift
diff --git a/benchmarks/cua-driver-bench/automated-eval/macos_bench/swift/BenchLabModes.swift b/libs/cua-driver-bench/automated-eval/macos_bench/swift/BenchLabModes.swift
similarity index 100%
rename from benchmarks/cua-driver-bench/automated-eval/macos_bench/swift/BenchLabModes.swift
rename to libs/cua-driver-bench/automated-eval/macos_bench/swift/BenchLabModes.swift
diff --git a/benchmarks/cua-driver-bench/automated-eval/macos_bench/swift/BenchSentinel.swift b/libs/cua-driver-bench/automated-eval/macos_bench/swift/BenchSentinel.swift
similarity index 100%
rename from benchmarks/cua-driver-bench/automated-eval/macos_bench/swift/BenchSentinel.swift
rename to libs/cua-driver-bench/automated-eval/macos_bench/swift/BenchSentinel.swift
diff --git a/benchmarks/cua-driver-bench/automated-eval/macos_bench/swift/README.md b/libs/cua-driver-bench/automated-eval/macos_bench/swift/README.md
similarity index 100%
rename from benchmarks/cua-driver-bench/automated-eval/macos_bench/swift/README.md
rename to libs/cua-driver-bench/automated-eval/macos_bench/swift/README.md
diff --git a/benchmarks/cua-driver-bench/automated-eval/macos_bench/swift/build.sh b/libs/cua-driver-bench/automated-eval/macos_bench/swift/build.sh
similarity index 100%
rename from benchmarks/cua-driver-bench/automated-eval/macos_bench/swift/build.sh
rename to libs/cua-driver-bench/automated-eval/macos_bench/swift/build.sh
diff --git a/benchmarks/cua-driver-bench/automated-eval/macos_bench/swift/summarize_sentinel.py b/libs/cua-driver-bench/automated-eval/macos_bench/swift/summarize_sentinel.py
similarity index 100%
rename from benchmarks/cua-driver-bench/automated-eval/macos_bench/swift/summarize_sentinel.py
rename to libs/cua-driver-bench/automated-eval/macos_bench/swift/summarize_sentinel.py
diff --git a/benchmarks/cua-driver-bench/automated-eval/macos_bench/swift/tests/test_summarize_sentinel.py b/libs/cua-driver-bench/automated-eval/macos_bench/swift/tests/test_summarize_sentinel.py
similarity index 100%
rename from benchmarks/cua-driver-bench/automated-eval/macos_bench/swift/tests/test_summarize_sentinel.py
rename to libs/cua-driver-bench/automated-eval/macos_bench/swift/tests/test_summarize_sentinel.py
diff --git a/benchmarks/cua-driver-bench/automated-eval/macos_bench/tests/test_analyze.py b/libs/cua-driver-bench/automated-eval/macos_bench/tests/test_analyze.py
similarity index 100%
rename from benchmarks/cua-driver-bench/automated-eval/macos_bench/tests/test_analyze.py
rename to libs/cua-driver-bench/automated-eval/macos_bench/tests/test_analyze.py
diff --git a/benchmarks/cua-driver-bench/automated-eval/macos_bench/tests/test_bench.py b/libs/cua-driver-bench/automated-eval/macos_bench/tests/test_bench.py
similarity index 100%
rename from benchmarks/cua-driver-bench/automated-eval/macos_bench/tests/test_bench.py
rename to libs/cua-driver-bench/automated-eval/macos_bench/tests/test_bench.py
diff --git a/benchmarks/cua-driver-bench/automated-eval/macos_bench/tests/test_bench_v2.py b/libs/cua-driver-bench/automated-eval/macos_bench/tests/test_bench_v2.py
similarity index 100%
rename from benchmarks/cua-driver-bench/automated-eval/macos_bench/tests/test_bench_v2.py
rename to libs/cua-driver-bench/automated-eval/macos_bench/tests/test_bench_v2.py
diff --git a/benchmarks/cua-driver-bench/automated-eval/macos_bench/tests/test_cdb_adapter.py b/libs/cua-driver-bench/automated-eval/macos_bench/tests/test_cdb_adapter.py
similarity index 100%
rename from benchmarks/cua-driver-bench/automated-eval/macos_bench/tests/test_cdb_adapter.py
rename to libs/cua-driver-bench/automated-eval/macos_bench/tests/test_cdb_adapter.py
diff --git a/benchmarks/cua-driver-bench/automated-eval/macos_bench/tests/test_claude_cu_helper_arm.py b/libs/cua-driver-bench/automated-eval/macos_bench/tests/test_claude_cu_helper_arm.py
similarity index 100%
rename from benchmarks/cua-driver-bench/automated-eval/macos_bench/tests/test_claude_cu_helper_arm.py
rename to libs/cua-driver-bench/automated-eval/macos_bench/tests/test_claude_cu_helper_arm.py
diff --git a/benchmarks/cua-driver-bench/automated-eval/macos_bench/tests/test_codex_native.py b/libs/cua-driver-bench/automated-eval/macos_bench/tests/test_codex_native.py
similarity index 100%
rename from benchmarks/cua-driver-bench/automated-eval/macos_bench/tests/test_codex_native.py
rename to libs/cua-driver-bench/automated-eval/macos_bench/tests/test_codex_native.py
diff --git a/benchmarks/cua-driver-bench/automated-eval/macos_bench/tests/test_pilot_runner.py b/libs/cua-driver-bench/automated-eval/macos_bench/tests/test_pilot_runner.py
similarity index 100%
rename from benchmarks/cua-driver-bench/automated-eval/macos_bench/tests/test_pilot_runner.py
rename to libs/cua-driver-bench/automated-eval/macos_bench/tests/test_pilot_runner.py
diff --git a/benchmarks/cua-driver-bench/automated-eval/macos_bench/tests/test_runner_flow.py b/libs/cua-driver-bench/automated-eval/macos_bench/tests/test_runner_flow.py
similarity index 100%
rename from benchmarks/cua-driver-bench/automated-eval/macos_bench/tests/test_runner_flow.py
rename to libs/cua-driver-bench/automated-eval/macos_bench/tests/test_runner_flow.py
diff --git a/benchmarks/cua-driver-bench/automated-eval/macos_bench/tools/analyze_claude_cu.py b/libs/cua-driver-bench/automated-eval/macos_bench/tools/analyze_claude_cu.py
similarity index 100%
rename from benchmarks/cua-driver-bench/automated-eval/macos_bench/tools/analyze_claude_cu.py
rename to libs/cua-driver-bench/automated-eval/macos_bench/tools/analyze_claude_cu.py
diff --git a/benchmarks/cua-driver-bench/automated-eval/macos_bench/tools/analyze_v2.py b/libs/cua-driver-bench/automated-eval/macos_bench/tools/analyze_v2.py
similarity index 100%
rename from benchmarks/cua-driver-bench/automated-eval/macos_bench/tools/analyze_v2.py
rename to libs/cua-driver-bench/automated-eval/macos_bench/tools/analyze_v2.py
diff --git a/benchmarks/cua-driver-bench/automated-eval/macos_bench/tools/benchinput.swift b/libs/cua-driver-bench/automated-eval/macos_bench/tools/benchinput.swift
similarity index 100%
rename from benchmarks/cua-driver-bench/automated-eval/macos_bench/tools/benchinput.swift
rename to libs/cua-driver-bench/automated-eval/macos_bench/tools/benchinput.swift
diff --git a/benchmarks/cua-driver-bench/automated-eval/macos_bench/tools/check_named_electron.py b/libs/cua-driver-bench/automated-eval/macos_bench/tools/check_named_electron.py
similarity index 100%
rename from benchmarks/cua-driver-bench/automated-eval/macos_bench/tools/check_named_electron.py
rename to libs/cua-driver-bench/automated-eval/macos_bench/tools/check_named_electron.py
diff --git a/benchmarks/cua-driver-bench/automated-eval/macos_bench/tools/check_pack_pins.py b/libs/cua-driver-bench/automated-eval/macos_bench/tools/check_pack_pins.py
similarity index 100%
rename from benchmarks/cua-driver-bench/automated-eval/macos_bench/tools/check_pack_pins.py
rename to libs/cua-driver-bench/automated-eval/macos_bench/tools/check_pack_pins.py
diff --git a/benchmarks/cua-driver-bench/automated-eval/macos_bench/tools/claude_cu_helper/cu_disclaim.c b/libs/cua-driver-bench/automated-eval/macos_bench/tools/claude_cu_helper/cu_disclaim.c
similarity index 100%
rename from benchmarks/cua-driver-bench/automated-eval/macos_bench/tools/claude_cu_helper/cu_disclaim.c
rename to libs/cua-driver-bench/automated-eval/macos_bench/tools/claude_cu_helper/cu_disclaim.c
diff --git a/benchmarks/cua-driver-bench/automated-eval/macos_bench/tools/claude_cu_helper/cu_helper_mcp.py b/libs/cua-driver-bench/automated-eval/macos_bench/tools/claude_cu_helper/cu_helper_mcp.py
similarity index 100%
rename from benchmarks/cua-driver-bench/automated-eval/macos_bench/tools/claude_cu_helper/cu_helper_mcp.py
rename to libs/cua-driver-bench/automated-eval/macos_bench/tools/claude_cu_helper/cu_helper_mcp.py
diff --git a/benchmarks/cua-driver-bench/automated-eval/macos_bench/tools/claude_cu_helper/install_cu_helper.sh b/libs/cua-driver-bench/automated-eval/macos_bench/tools/claude_cu_helper/install_cu_helper.sh
similarity index 100%
rename from benchmarks/cua-driver-bench/automated-eval/macos_bench/tools/claude_cu_helper/install_cu_helper.sh
rename to libs/cua-driver-bench/automated-eval/macos_bench/tools/claude_cu_helper/install_cu_helper.sh
diff --git a/benchmarks/cua-driver-bench/automated-eval/macos_bench/tools/claude_cu_helper/winlist.swift b/libs/cua-driver-bench/automated-eval/macos_bench/tools/claude_cu_helper/winlist.swift
similarity index 100%
rename from benchmarks/cua-driver-bench/automated-eval/macos_bench/tools/claude_cu_helper/winlist.swift
rename to libs/cua-driver-bench/automated-eval/macos_bench/tools/claude_cu_helper/winlist.swift
diff --git a/benchmarks/cua-driver-bench/automated-eval/macos_bench/tools/fixture.py b/libs/cua-driver-bench/automated-eval/macos_bench/tools/fixture.py
similarity index 100%
rename from benchmarks/cua-driver-bench/automated-eval/macos_bench/tools/fixture.py
rename to libs/cua-driver-bench/automated-eval/macos_bench/tools/fixture.py
diff --git a/benchmarks/cua-driver-bench/automated-eval/macos_bench/tools/install_cua_driver.py b/libs/cua-driver-bench/automated-eval/macos_bench/tools/install_cua_driver.py
similarity index 100%
rename from benchmarks/cua-driver-bench/automated-eval/macos_bench/tools/install_cua_driver.py
rename to libs/cua-driver-bench/automated-eval/macos_bench/tools/install_cua_driver.py
diff --git a/benchmarks/cua-driver-bench/automated-eval/macos_bench/tools/make_codex_cu_mcp.py b/libs/cua-driver-bench/automated-eval/macos_bench/tools/make_codex_cu_mcp.py
similarity index 100%
rename from benchmarks/cua-driver-bench/automated-eval/macos_bench/tools/make_codex_cu_mcp.py
rename to libs/cua-driver-bench/automated-eval/macos_bench/tools/make_codex_cu_mcp.py
diff --git a/benchmarks/cua-driver-bench/automated-eval/macos_bench/tools/posthoc_calls.py b/libs/cua-driver-bench/automated-eval/macos_bench/tools/posthoc_calls.py
similarity index 100%
rename from benchmarks/cua-driver-bench/automated-eval/macos_bench/tools/posthoc_calls.py
rename to libs/cua-driver-bench/automated-eval/macos_bench/tools/posthoc_calls.py
diff --git a/benchmarks/cua-driver-bench/automated-eval/macos_bench/tools/smoke_cdb_apps.py b/libs/cua-driver-bench/automated-eval/macos_bench/tools/smoke_cdb_apps.py
similarity index 100%
rename from benchmarks/cua-driver-bench/automated-eval/macos_bench/tools/smoke_cdb_apps.py
rename to libs/cua-driver-bench/automated-eval/macos_bench/tools/smoke_cdb_apps.py
diff --git a/benchmarks/cua-driver-bench/automated-eval/macos_bench/tools/validate.py b/libs/cua-driver-bench/automated-eval/macos_bench/tools/validate.py
similarity index 100%
rename from benchmarks/cua-driver-bench/automated-eval/macos_bench/tools/validate.py
rename to libs/cua-driver-bench/automated-eval/macos_bench/tools/validate.py
diff --git a/benchmarks/cua-driver-bench/automated-eval/macos_bench/tools/validate_cdb.py b/libs/cua-driver-bench/automated-eval/macos_bench/tools/validate_cdb.py
similarity index 100%
rename from benchmarks/cua-driver-bench/automated-eval/macos_bench/tools/validate_cdb.py
rename to libs/cua-driver-bench/automated-eval/macos_bench/tools/validate_cdb.py
diff --git a/benchmarks/cua-driver-bench/automated-eval/macos_bench/tools/vm_main_build/assemble_main.sh b/libs/cua-driver-bench/automated-eval/macos_bench/tools/vm_main_build/assemble_main.sh
similarity index 100%
rename from benchmarks/cua-driver-bench/automated-eval/macos_bench/tools/vm_main_build/assemble_main.sh
rename to libs/cua-driver-bench/automated-eval/macos_bench/tools/vm_main_build/assemble_main.sh
diff --git a/benchmarks/cua-driver-bench/automated-eval/macos_bench/tools/vm_main_build/assemble_script.sh b/libs/cua-driver-bench/automated-eval/macos_bench/tools/vm_main_build/assemble_script.sh
similarity index 100%
rename from benchmarks/cua-driver-bench/automated-eval/macos_bench/tools/vm_main_build/assemble_script.sh
rename to libs/cua-driver-bench/automated-eval/macos_bench/tools/vm_main_build/assemble_script.sh
diff --git a/benchmarks/cua-driver-bench/automated-eval/macos_bench/tools/vm_main_build/build_main.sh b/libs/cua-driver-bench/automated-eval/macos_bench/tools/vm_main_build/build_main.sh
similarity index 100%
rename from benchmarks/cua-driver-bench/automated-eval/macos_bench/tools/vm_main_build/build_main.sh
rename to libs/cua-driver-bench/automated-eval/macos_bench/tools/vm_main_build/build_main.sh
diff --git a/benchmarks/cua-driver-bench/automated-eval/macos_bench/tools/vm_main_build/tcc_grant.sh b/libs/cua-driver-bench/automated-eval/macos_bench/tools/vm_main_build/tcc_grant.sh
similarity index 100%
rename from benchmarks/cua-driver-bench/automated-eval/macos_bench/tools/vm_main_build/tcc_grant.sh
rename to libs/cua-driver-bench/automated-eval/macos_bench/tools/vm_main_build/tcc_grant.sh
diff --git a/benchmarks/cua-driver-bench/ruff.toml b/libs/cua-driver-bench/ruff.toml
similarity index 100%
rename from benchmarks/cua-driver-bench/ruff.toml
rename to libs/cua-driver-bench/ruff.toml
diff --git a/benchmarks/cua-driver-bench/taskpack/README.md b/libs/cua-driver-bench/taskpack/README.md
similarity index 100%
rename from benchmarks/cua-driver-bench/taskpack/README.md
rename to libs/cua-driver-bench/taskpack/README.md
diff --git a/benchmarks/cua-driver-bench/taskpack/THIRD_PARTY_NOTICES.md b/libs/cua-driver-bench/taskpack/THIRD_PARTY_NOTICES.md
similarity index 100%
rename from benchmarks/cua-driver-bench/taskpack/THIRD_PARTY_NOTICES.md
rename to libs/cua-driver-bench/taskpack/THIRD_PARTY_NOTICES.md
diff --git a/benchmarks/cua-driver-bench/taskpack/tasks/shared/cdb-s02/.gitignore b/libs/cua-driver-bench/taskpack/tasks/shared/cdb-s02/.gitignore
similarity index 100%
rename from benchmarks/cua-driver-bench/taskpack/tasks/shared/cdb-s02/.gitignore
rename to libs/cua-driver-bench/taskpack/tasks/shared/cdb-s02/.gitignore
diff --git a/benchmarks/cua-driver-bench/taskpack/tasks/shared/cdb-s02/PROVENANCE.md b/libs/cua-driver-bench/taskpack/tasks/shared/cdb-s02/PROVENANCE.md
similarity index 100%
rename from benchmarks/cua-driver-bench/taskpack/tasks/shared/cdb-s02/PROVENANCE.md
rename to libs/cua-driver-bench/taskpack/tasks/shared/cdb-s02/PROVENANCE.md
diff --git a/benchmarks/cua-driver-bench/taskpack/tasks/shared/cdb-s02/README.md b/libs/cua-driver-bench/taskpack/tasks/shared/cdb-s02/README.md
similarity index 100%
rename from benchmarks/cua-driver-bench/taskpack/tasks/shared/cdb-s02/README.md
rename to libs/cua-driver-bench/taskpack/tasks/shared/cdb-s02/README.md
diff --git a/benchmarks/cua-driver-bench/taskpack/tasks/shared/cdb-s02/apps/lighthouse-desk/main.js b/libs/cua-driver-bench/taskpack/tasks/shared/cdb-s02/apps/lighthouse-desk/main.js
similarity index 100%
rename from benchmarks/cua-driver-bench/taskpack/tasks/shared/cdb-s02/apps/lighthouse-desk/main.js
rename to libs/cua-driver-bench/taskpack/tasks/shared/cdb-s02/apps/lighthouse-desk/main.js
diff --git a/benchmarks/cua-driver-bench/taskpack/tasks/shared/cdb-s02/apps/lighthouse-desk/package-lock.json b/libs/cua-driver-bench/taskpack/tasks/shared/cdb-s02/apps/lighthouse-desk/package-lock.json
similarity index 100%
rename from benchmarks/cua-driver-bench/taskpack/tasks/shared/cdb-s02/apps/lighthouse-desk/package-lock.json
rename to libs/cua-driver-bench/taskpack/tasks/shared/cdb-s02/apps/lighthouse-desk/package-lock.json
diff --git a/benchmarks/cua-driver-bench/taskpack/tasks/shared/cdb-s02/apps/lighthouse-desk/package.json b/libs/cua-driver-bench/taskpack/tasks/shared/cdb-s02/apps/lighthouse-desk/package.json
similarity index 100%
rename from benchmarks/cua-driver-bench/taskpack/tasks/shared/cdb-s02/apps/lighthouse-desk/package.json
rename to libs/cua-driver-bench/taskpack/tasks/shared/cdb-s02/apps/lighthouse-desk/package.json
diff --git a/benchmarks/cua-driver-bench/taskpack/tasks/shared/cdb-s02/apps/lighthouse-desk/preload.js b/libs/cua-driver-bench/taskpack/tasks/shared/cdb-s02/apps/lighthouse-desk/preload.js
similarity index 100%
rename from benchmarks/cua-driver-bench/taskpack/tasks/shared/cdb-s02/apps/lighthouse-desk/preload.js
rename to libs/cua-driver-bench/taskpack/tasks/shared/cdb-s02/apps/lighthouse-desk/preload.js
diff --git a/benchmarks/cua-driver-bench/taskpack/tasks/shared/cdb-s02/apps/lighthouse-desk/renderer/app.js b/libs/cua-driver-bench/taskpack/tasks/shared/cdb-s02/apps/lighthouse-desk/renderer/app.js
similarity index 100%
rename from benchmarks/cua-driver-bench/taskpack/tasks/shared/cdb-s02/apps/lighthouse-desk/renderer/app.js
rename to libs/cua-driver-bench/taskpack/tasks/shared/cdb-s02/apps/lighthouse-desk/renderer/app.js
diff --git a/benchmarks/cua-driver-bench/taskpack/tasks/shared/cdb-s02/apps/lighthouse-desk/renderer/index.html b/libs/cua-driver-bench/taskpack/tasks/shared/cdb-s02/apps/lighthouse-desk/renderer/index.html
similarity index 100%
rename from benchmarks/cua-driver-bench/taskpack/tasks/shared/cdb-s02/apps/lighthouse-desk/renderer/index.html
rename to libs/cua-driver-bench/taskpack/tasks/shared/cdb-s02/apps/lighthouse-desk/renderer/index.html
diff --git a/benchmarks/cua-driver-bench/taskpack/tasks/shared/cdb-s02/apps/lighthouse-desk/renderer/styles.css b/libs/cua-driver-bench/taskpack/tasks/shared/cdb-s02/apps/lighthouse-desk/renderer/styles.css
similarity index 100%
rename from benchmarks/cua-driver-bench/taskpack/tasks/shared/cdb-s02/apps/lighthouse-desk/renderer/styles.css
rename to libs/cua-driver-bench/taskpack/tasks/shared/cdb-s02/apps/lighthouse-desk/renderer/styles.css
diff --git a/benchmarks/cua-driver-bench/taskpack/tasks/shared/cdb-s02/apps/lighthouse-desk/store.js b/libs/cua-driver-bench/taskpack/tasks/shared/cdb-s02/apps/lighthouse-desk/store.js
similarity index 100%
rename from benchmarks/cua-driver-bench/taskpack/tasks/shared/cdb-s02/apps/lighthouse-desk/store.js
rename to libs/cua-driver-bench/taskpack/tasks/shared/cdb-s02/apps/lighthouse-desk/store.js
diff --git a/benchmarks/cua-driver-bench/taskpack/tasks/shared/cdb-s02/apps/lighthouse-desk/tests/store.test.js b/libs/cua-driver-bench/taskpack/tasks/shared/cdb-s02/apps/lighthouse-desk/tests/store.test.js
similarity index 100%
rename from benchmarks/cua-driver-bench/taskpack/tasks/shared/cdb-s02/apps/lighthouse-desk/tests/store.test.js
rename to libs/cua-driver-bench/taskpack/tasks/shared/cdb-s02/apps/lighthouse-desk/tests/store.test.js
diff --git a/benchmarks/cua-driver-bench/taskpack/tasks/shared/cdb-s02/brief.md b/libs/cua-driver-bench/taskpack/tasks/shared/cdb-s02/brief.md
similarity index 100%
rename from benchmarks/cua-driver-bench/taskpack/tasks/shared/cdb-s02/brief.md
rename to libs/cua-driver-bench/taskpack/tasks/shared/cdb-s02/brief.md
diff --git a/benchmarks/cua-driver-bench/taskpack/tasks/shared/cdb-s02/evaluator/evaluate.py b/libs/cua-driver-bench/taskpack/tasks/shared/cdb-s02/evaluator/evaluate.py
similarity index 100%
rename from benchmarks/cua-driver-bench/taskpack/tasks/shared/cdb-s02/evaluator/evaluate.py
rename to libs/cua-driver-bench/taskpack/tasks/shared/cdb-s02/evaluator/evaluate.py
diff --git a/benchmarks/cua-driver-bench/taskpack/tasks/shared/cdb-s02/evaluator/ods.py b/libs/cua-driver-bench/taskpack/tasks/shared/cdb-s02/evaluator/ods.py
similarity index 100%
rename from benchmarks/cua-driver-bench/taskpack/tasks/shared/cdb-s02/evaluator/ods.py
rename to libs/cua-driver-bench/taskpack/tasks/shared/cdb-s02/evaluator/ods.py
diff --git a/benchmarks/cua-driver-bench/taskpack/tasks/shared/cdb-s02/evaluator/oracle.json b/libs/cua-driver-bench/taskpack/tasks/shared/cdb-s02/evaluator/oracle.json
similarity index 100%
rename from benchmarks/cua-driver-bench/taskpack/tasks/shared/cdb-s02/evaluator/oracle.json
rename to libs/cua-driver-bench/taskpack/tasks/shared/cdb-s02/evaluator/oracle.json
diff --git a/benchmarks/cua-driver-bench/taskpack/tasks/shared/cdb-s02/fixture/calendar/events.json b/libs/cua-driver-bench/taskpack/tasks/shared/cdb-s02/fixture/calendar/events.json
similarity index 100%
rename from benchmarks/cua-driver-bench/taskpack/tasks/shared/cdb-s02/fixture/calendar/events.json
rename to libs/cua-driver-bench/taskpack/tasks/shared/cdb-s02/fixture/calendar/events.json
diff --git a/benchmarks/cua-driver-bench/taskpack/tasks/shared/cdb-s02/fixture/chat/audit.ndjson b/libs/cua-driver-bench/taskpack/tasks/shared/cdb-s02/fixture/chat/audit.ndjson
similarity index 100%
rename from benchmarks/cua-driver-bench/taskpack/tasks/shared/cdb-s02/fixture/chat/audit.ndjson
rename to libs/cua-driver-bench/taskpack/tasks/shared/cdb-s02/fixture/chat/audit.ndjson
diff --git a/benchmarks/cua-driver-bench/taskpack/tasks/shared/cdb-s02/fixture/chat/blockers.json b/libs/cua-driver-bench/taskpack/tasks/shared/cdb-s02/fixture/chat/blockers.json
similarity index 100%
rename from benchmarks/cua-driver-bench/taskpack/tasks/shared/cdb-s02/fixture/chat/blockers.json
rename to libs/cua-driver-bench/taskpack/tasks/shared/cdb-s02/fixture/chat/blockers.json
diff --git a/benchmarks/cua-driver-bench/taskpack/tasks/shared/cdb-s02/fixture/chat/messages.json b/libs/cua-driver-bench/taskpack/tasks/shared/cdb-s02/fixture/chat/messages.json
similarity index 100%
rename from benchmarks/cua-driver-bench/taskpack/tasks/shared/cdb-s02/fixture/chat/messages.json
rename to libs/cua-driver-bench/taskpack/tasks/shared/cdb-s02/fixture/chat/messages.json
diff --git a/benchmarks/cua-driver-bench/taskpack/tasks/shared/cdb-s02/fixture/mail/messages.json b/libs/cua-driver-bench/taskpack/tasks/shared/cdb-s02/fixture/mail/messages.json
similarity index 100%
rename from benchmarks/cua-driver-bench/taskpack/tasks/shared/cdb-s02/fixture/mail/messages.json
rename to libs/cua-driver-bench/taskpack/tasks/shared/cdb-s02/fixture/mail/messages.json
diff --git a/benchmarks/cua-driver-bench/taskpack/tasks/shared/cdb-s02/fixture/planning/lighthouse-replan.ods b/libs/cua-driver-bench/taskpack/tasks/shared/cdb-s02/fixture/planning/lighthouse-replan.ods
similarity index 100%
rename from benchmarks/cua-driver-bench/taskpack/tasks/shared/cdb-s02/fixture/planning/lighthouse-replan.ods
rename to libs/cua-driver-bench/taskpack/tasks/shared/cdb-s02/fixture/planning/lighthouse-replan.ods
diff --git a/benchmarks/cua-driver-bench/taskpack/tasks/shared/cdb-s02/platform/README.md b/libs/cua-driver-bench/taskpack/tasks/shared/cdb-s02/platform/README.md
similarity index 100%
rename from benchmarks/cua-driver-bench/taskpack/tasks/shared/cdb-s02/platform/README.md
rename to libs/cua-driver-bench/taskpack/tasks/shared/cdb-s02/platform/README.md
diff --git a/benchmarks/cua-driver-bench/taskpack/tasks/shared/cdb-s02/platform/launch.linux.json b/libs/cua-driver-bench/taskpack/tasks/shared/cdb-s02/platform/launch.linux.json
similarity index 100%
rename from benchmarks/cua-driver-bench/taskpack/tasks/shared/cdb-s02/platform/launch.linux.json
rename to libs/cua-driver-bench/taskpack/tasks/shared/cdb-s02/platform/launch.linux.json
diff --git a/benchmarks/cua-driver-bench/taskpack/tasks/shared/cdb-s02/platform/launch.macos.json b/libs/cua-driver-bench/taskpack/tasks/shared/cdb-s02/platform/launch.macos.json
similarity index 100%
rename from benchmarks/cua-driver-bench/taskpack/tasks/shared/cdb-s02/platform/launch.macos.json
rename to libs/cua-driver-bench/taskpack/tasks/shared/cdb-s02/platform/launch.macos.json
diff --git a/benchmarks/cua-driver-bench/taskpack/tasks/shared/cdb-s02/platform/launch.windows.json b/libs/cua-driver-bench/taskpack/tasks/shared/cdb-s02/platform/launch.windows.json
similarity index 100%
rename from benchmarks/cua-driver-bench/taskpack/tasks/shared/cdb-s02/platform/launch.windows.json
rename to libs/cua-driver-bench/taskpack/tasks/shared/cdb-s02/platform/launch.windows.json
diff --git a/benchmarks/cua-driver-bench/taskpack/tasks/shared/cdb-s02/reset/failure-fixtures/stale-blocker.json b/libs/cua-driver-bench/taskpack/tasks/shared/cdb-s02/reset/failure-fixtures/stale-blocker.json
similarity index 100%
rename from benchmarks/cua-driver-bench/taskpack/tasks/shared/cdb-s02/reset/failure-fixtures/stale-blocker.json
rename to libs/cua-driver-bench/taskpack/tasks/shared/cdb-s02/reset/failure-fixtures/stale-blocker.json
diff --git a/benchmarks/cua-driver-bench/taskpack/tasks/shared/cdb-s02/reset/failure-fixtures/stale-calendar.json b/libs/cua-driver-bench/taskpack/tasks/shared/cdb-s02/reset/failure-fixtures/stale-calendar.json
similarity index 100%
rename from benchmarks/cua-driver-bench/taskpack/tasks/shared/cdb-s02/reset/failure-fixtures/stale-calendar.json
rename to libs/cua-driver-bench/taskpack/tasks/shared/cdb-s02/reset/failure-fixtures/stale-calendar.json
diff --git a/benchmarks/cua-driver-bench/taskpack/tasks/shared/cdb-s02/reset/setup.py b/libs/cua-driver-bench/taskpack/tasks/shared/cdb-s02/reset/setup.py
similarity index 100%
rename from benchmarks/cua-driver-bench/taskpack/tasks/shared/cdb-s02/reset/setup.py
rename to libs/cua-driver-bench/taskpack/tasks/shared/cdb-s02/reset/setup.py
diff --git a/benchmarks/cua-driver-bench/taskpack/tasks/shared/cdb-s02/reset/verify.py b/libs/cua-driver-bench/taskpack/tasks/shared/cdb-s02/reset/verify.py
similarity index 100%
rename from benchmarks/cua-driver-bench/taskpack/tasks/shared/cdb-s02/reset/verify.py
rename to libs/cua-driver-bench/taskpack/tasks/shared/cdb-s02/reset/verify.py
diff --git a/benchmarks/cua-driver-bench/taskpack/tasks/shared/cdb-s02/task.cuabench.json b/libs/cua-driver-bench/taskpack/tasks/shared/cdb-s02/task.cuabench.json
similarity index 100%
rename from benchmarks/cua-driver-bench/taskpack/tasks/shared/cdb-s02/task.cuabench.json
rename to libs/cua-driver-bench/taskpack/tasks/shared/cdb-s02/task.cuabench.json
diff --git a/benchmarks/cua-driver-bench/taskpack/tasks/shared/cdb-s02/tests/test_cdb_s02.py b/libs/cua-driver-bench/taskpack/tasks/shared/cdb-s02/tests/test_cdb_s02.py
similarity index 100%
rename from benchmarks/cua-driver-bench/taskpack/tasks/shared/cdb-s02/tests/test_cdb_s02.py
rename to libs/cua-driver-bench/taskpack/tasks/shared/cdb-s02/tests/test_cdb_s02.py
diff --git a/benchmarks/cua-driver-bench/taskpack/tasks/shared/cdb-s02/tools/build_fixture_ods.py b/libs/cua-driver-bench/taskpack/tasks/shared/cdb-s02/tools/build_fixture_ods.py
similarity index 100%
rename from benchmarks/cua-driver-bench/taskpack/tasks/shared/cdb-s02/tools/build_fixture_ods.py
rename to libs/cua-driver-bench/taskpack/tasks/shared/cdb-s02/tools/build_fixture_ods.py
diff --git a/benchmarks/cua-driver-bench/taskpack/tasks/shared/cdb-s02/tools/build_platform_descriptors.py b/libs/cua-driver-bench/taskpack/tasks/shared/cdb-s02/tools/build_platform_descriptors.py
similarity index 100%
rename from benchmarks/cua-driver-bench/taskpack/tasks/shared/cdb-s02/tools/build_platform_descriptors.py
rename to libs/cua-driver-bench/taskpack/tasks/shared/cdb-s02/tools/build_platform_descriptors.py
diff --git a/benchmarks/cua-driver-bench/taskpack/tasks/shared/cdb-s02/tools/refresh_manifest_digests.py b/libs/cua-driver-bench/taskpack/tasks/shared/cdb-s02/tools/refresh_manifest_digests.py
similarity index 100%
rename from benchmarks/cua-driver-bench/taskpack/tasks/shared/cdb-s02/tools/refresh_manifest_digests.py
rename to libs/cua-driver-bench/taskpack/tasks/shared/cdb-s02/tools/refresh_manifest_digests.py
diff --git a/benchmarks/cua-driver-bench/taskpack/tasks/shared/cdb-s03/.gitignore b/libs/cua-driver-bench/taskpack/tasks/shared/cdb-s03/.gitignore
similarity index 100%
rename from benchmarks/cua-driver-bench/taskpack/tasks/shared/cdb-s03/.gitignore
rename to libs/cua-driver-bench/taskpack/tasks/shared/cdb-s03/.gitignore
diff --git a/benchmarks/cua-driver-bench/taskpack/tasks/shared/cdb-s03/PROVENANCE.md b/libs/cua-driver-bench/taskpack/tasks/shared/cdb-s03/PROVENANCE.md
similarity index 100%
rename from benchmarks/cua-driver-bench/taskpack/tasks/shared/cdb-s03/PROVENANCE.md
rename to libs/cua-driver-bench/taskpack/tasks/shared/cdb-s03/PROVENANCE.md
diff --git a/benchmarks/cua-driver-bench/taskpack/tasks/shared/cdb-s03/README.md b/libs/cua-driver-bench/taskpack/tasks/shared/cdb-s03/README.md
similarity index 100%
rename from benchmarks/cua-driver-bench/taskpack/tasks/shared/cdb-s03/README.md
rename to libs/cua-driver-bench/taskpack/tasks/shared/cdb-s03/README.md
diff --git a/benchmarks/cua-driver-bench/taskpack/tasks/shared/cdb-s03/apps/ledger-lantern-mail/main.js b/libs/cua-driver-bench/taskpack/tasks/shared/cdb-s03/apps/ledger-lantern-mail/main.js
similarity index 100%
rename from benchmarks/cua-driver-bench/taskpack/tasks/shared/cdb-s03/apps/ledger-lantern-mail/main.js
rename to libs/cua-driver-bench/taskpack/tasks/shared/cdb-s03/apps/ledger-lantern-mail/main.js
diff --git a/benchmarks/cua-driver-bench/taskpack/tasks/shared/cdb-s03/apps/ledger-lantern-mail/package-lock.json b/libs/cua-driver-bench/taskpack/tasks/shared/cdb-s03/apps/ledger-lantern-mail/package-lock.json
similarity index 100%
rename from benchmarks/cua-driver-bench/taskpack/tasks/shared/cdb-s03/apps/ledger-lantern-mail/package-lock.json
rename to libs/cua-driver-bench/taskpack/tasks/shared/cdb-s03/apps/ledger-lantern-mail/package-lock.json
diff --git a/benchmarks/cua-driver-bench/taskpack/tasks/shared/cdb-s03/apps/ledger-lantern-mail/package.json b/libs/cua-driver-bench/taskpack/tasks/shared/cdb-s03/apps/ledger-lantern-mail/package.json
similarity index 100%
rename from benchmarks/cua-driver-bench/taskpack/tasks/shared/cdb-s03/apps/ledger-lantern-mail/package.json
rename to libs/cua-driver-bench/taskpack/tasks/shared/cdb-s03/apps/ledger-lantern-mail/package.json
diff --git a/benchmarks/cua-driver-bench/taskpack/tasks/shared/cdb-s03/apps/ledger-lantern-mail/preload.js b/libs/cua-driver-bench/taskpack/tasks/shared/cdb-s03/apps/ledger-lantern-mail/preload.js
similarity index 100%
rename from benchmarks/cua-driver-bench/taskpack/tasks/shared/cdb-s03/apps/ledger-lantern-mail/preload.js
rename to libs/cua-driver-bench/taskpack/tasks/shared/cdb-s03/apps/ledger-lantern-mail/preload.js
diff --git a/benchmarks/cua-driver-bench/taskpack/tasks/shared/cdb-s03/apps/ledger-lantern-mail/renderer/app.js b/libs/cua-driver-bench/taskpack/tasks/shared/cdb-s03/apps/ledger-lantern-mail/renderer/app.js
similarity index 100%
rename from benchmarks/cua-driver-bench/taskpack/tasks/shared/cdb-s03/apps/ledger-lantern-mail/renderer/app.js
rename to libs/cua-driver-bench/taskpack/tasks/shared/cdb-s03/apps/ledger-lantern-mail/renderer/app.js
diff --git a/benchmarks/cua-driver-bench/taskpack/tasks/shared/cdb-s03/apps/ledger-lantern-mail/renderer/index.html b/libs/cua-driver-bench/taskpack/tasks/shared/cdb-s03/apps/ledger-lantern-mail/renderer/index.html
similarity index 100%
rename from benchmarks/cua-driver-bench/taskpack/tasks/shared/cdb-s03/apps/ledger-lantern-mail/renderer/index.html
rename to libs/cua-driver-bench/taskpack/tasks/shared/cdb-s03/apps/ledger-lantern-mail/renderer/index.html
diff --git a/benchmarks/cua-driver-bench/taskpack/tasks/shared/cdb-s03/apps/ledger-lantern-mail/renderer/styles.css b/libs/cua-driver-bench/taskpack/tasks/shared/cdb-s03/apps/ledger-lantern-mail/renderer/styles.css
similarity index 100%
rename from benchmarks/cua-driver-bench/taskpack/tasks/shared/cdb-s03/apps/ledger-lantern-mail/renderer/styles.css
rename to libs/cua-driver-bench/taskpack/tasks/shared/cdb-s03/apps/ledger-lantern-mail/renderer/styles.css
diff --git a/benchmarks/cua-driver-bench/taskpack/tasks/shared/cdb-s03/apps/ledger-lantern-mail/store.js b/libs/cua-driver-bench/taskpack/tasks/shared/cdb-s03/apps/ledger-lantern-mail/store.js
similarity index 100%
rename from benchmarks/cua-driver-bench/taskpack/tasks/shared/cdb-s03/apps/ledger-lantern-mail/store.js
rename to libs/cua-driver-bench/taskpack/tasks/shared/cdb-s03/apps/ledger-lantern-mail/store.js
diff --git a/benchmarks/cua-driver-bench/taskpack/tasks/shared/cdb-s03/apps/ledger-lantern-mail/tests/store.test.js b/libs/cua-driver-bench/taskpack/tasks/shared/cdb-s03/apps/ledger-lantern-mail/tests/store.test.js
similarity index 100%
rename from benchmarks/cua-driver-bench/taskpack/tasks/shared/cdb-s03/apps/ledger-lantern-mail/tests/store.test.js
rename to libs/cua-driver-bench/taskpack/tasks/shared/cdb-s03/apps/ledger-lantern-mail/tests/store.test.js
diff --git a/benchmarks/cua-driver-bench/taskpack/tasks/shared/cdb-s03/brief.md b/libs/cua-driver-bench/taskpack/tasks/shared/cdb-s03/brief.md
similarity index 100%
rename from benchmarks/cua-driver-bench/taskpack/tasks/shared/cdb-s03/brief.md
rename to libs/cua-driver-bench/taskpack/tasks/shared/cdb-s03/brief.md
diff --git a/benchmarks/cua-driver-bench/taskpack/tasks/shared/cdb-s03/evaluator/evaluate.py b/libs/cua-driver-bench/taskpack/tasks/shared/cdb-s03/evaluator/evaluate.py
similarity index 100%
rename from benchmarks/cua-driver-bench/taskpack/tasks/shared/cdb-s03/evaluator/evaluate.py
rename to libs/cua-driver-bench/taskpack/tasks/shared/cdb-s03/evaluator/evaluate.py
diff --git a/benchmarks/cua-driver-bench/taskpack/tasks/shared/cdb-s03/evaluator/gnucash.py b/libs/cua-driver-bench/taskpack/tasks/shared/cdb-s03/evaluator/gnucash.py
similarity index 100%
rename from benchmarks/cua-driver-bench/taskpack/tasks/shared/cdb-s03/evaluator/gnucash.py
rename to libs/cua-driver-bench/taskpack/tasks/shared/cdb-s03/evaluator/gnucash.py
diff --git a/benchmarks/cua-driver-bench/taskpack/tasks/shared/cdb-s03/evaluator/ods.py b/libs/cua-driver-bench/taskpack/tasks/shared/cdb-s03/evaluator/ods.py
similarity index 100%
rename from benchmarks/cua-driver-bench/taskpack/tasks/shared/cdb-s03/evaluator/ods.py
rename to libs/cua-driver-bench/taskpack/tasks/shared/cdb-s03/evaluator/ods.py
diff --git a/benchmarks/cua-driver-bench/taskpack/tasks/shared/cdb-s03/evaluator/oracle.json b/libs/cua-driver-bench/taskpack/tasks/shared/cdb-s03/evaluator/oracle.json
similarity index 100%
rename from benchmarks/cua-driver-bench/taskpack/tasks/shared/cdb-s03/evaluator/oracle.json
rename to libs/cua-driver-bench/taskpack/tasks/shared/cdb-s03/evaluator/oracle.json
diff --git a/benchmarks/cua-driver-bench/taskpack/tasks/shared/cdb-s03/fixture/book/kestrel-wharf.gnucash b/libs/cua-driver-bench/taskpack/tasks/shared/cdb-s03/fixture/book/kestrel-wharf.gnucash
similarity index 100%
rename from benchmarks/cua-driver-bench/taskpack/tasks/shared/cdb-s03/fixture/book/kestrel-wharf.gnucash
rename to libs/cua-driver-bench/taskpack/tasks/shared/cdb-s03/fixture/book/kestrel-wharf.gnucash
diff --git a/benchmarks/cua-driver-bench/taskpack/tasks/shared/cdb-s03/fixture/mail/attachments/NAR-773.txt b/libs/cua-driver-bench/taskpack/tasks/shared/cdb-s03/fixture/mail/attachments/NAR-773.txt
similarity index 100%
rename from benchmarks/cua-driver-bench/taskpack/tasks/shared/cdb-s03/fixture/mail/attachments/NAR-773.txt
rename to libs/cua-driver-bench/taskpack/tasks/shared/cdb-s03/fixture/mail/attachments/NAR-773.txt
diff --git a/benchmarks/cua-driver-bench/taskpack/tasks/shared/cdb-s03/fixture/mail/attachments/OCP-4821.txt b/libs/cua-driver-bench/taskpack/tasks/shared/cdb-s03/fixture/mail/attachments/OCP-4821.txt
similarity index 100%
rename from benchmarks/cua-driver-bench/taskpack/tasks/shared/cdb-s03/fixture/mail/attachments/OCP-4821.txt
rename to libs/cua-driver-bench/taskpack/tasks/shared/cdb-s03/fixture/mail/attachments/OCP-4821.txt
diff --git a/benchmarks/cua-driver-bench/taskpack/tasks/shared/cdb-s03/fixture/mail/attachments/OCP-4827.txt b/libs/cua-driver-bench/taskpack/tasks/shared/cdb-s03/fixture/mail/attachments/OCP-4827.txt
similarity index 100%
rename from benchmarks/cua-driver-bench/taskpack/tasks/shared/cdb-s03/fixture/mail/attachments/OCP-4827.txt
rename to libs/cua-driver-bench/taskpack/tasks/shared/cdb-s03/fixture/mail/attachments/OCP-4827.txt
diff --git a/benchmarks/cua-driver-bench/taskpack/tasks/shared/cdb-s03/fixture/mail/attachments/SVL-119.txt b/libs/cua-driver-bench/taskpack/tasks/shared/cdb-s03/fixture/mail/attachments/SVL-119.txt
similarity index 100%
rename from benchmarks/cua-driver-bench/taskpack/tasks/shared/cdb-s03/fixture/mail/attachments/SVL-119.txt
rename to libs/cua-driver-bench/taskpack/tasks/shared/cdb-s03/fixture/mail/attachments/SVL-119.txt
diff --git a/benchmarks/cua-driver-bench/taskpack/tasks/shared/cdb-s03/fixture/mail/attachments/open-house-menu.txt b/libs/cua-driver-bench/taskpack/tasks/shared/cdb-s03/fixture/mail/attachments/open-house-menu.txt
similarity index 100%
rename from benchmarks/cua-driver-bench/taskpack/tasks/shared/cdb-s03/fixture/mail/attachments/open-house-menu.txt
rename to libs/cua-driver-bench/taskpack/tasks/shared/cdb-s03/fixture/mail/attachments/open-house-menu.txt
diff --git a/benchmarks/cua-driver-bench/taskpack/tasks/shared/cdb-s03/fixture/mail/attachments/receiving-log-october.txt b/libs/cua-driver-bench/taskpack/tasks/shared/cdb-s03/fixture/mail/attachments/receiving-log-october.txt
similarity index 100%
rename from benchmarks/cua-driver-bench/taskpack/tasks/shared/cdb-s03/fixture/mail/attachments/receiving-log-october.txt
rename to libs/cua-driver-bench/taskpack/tasks/shared/cdb-s03/fixture/mail/attachments/receiving-log-october.txt
diff --git a/benchmarks/cua-driver-bench/taskpack/tasks/shared/cdb-s03/fixture/mail/messages.json b/libs/cua-driver-bench/taskpack/tasks/shared/cdb-s03/fixture/mail/messages.json
similarity index 100%
rename from benchmarks/cua-driver-bench/taskpack/tasks/shared/cdb-s03/fixture/mail/messages.json
rename to libs/cua-driver-bench/taskpack/tasks/shared/cdb-s03/fixture/mail/messages.json
diff --git a/benchmarks/cua-driver-bench/taskpack/tasks/shared/cdb-s03/fixture/planning/kestrel-wharf-reconciliation.ods b/libs/cua-driver-bench/taskpack/tasks/shared/cdb-s03/fixture/planning/kestrel-wharf-reconciliation.ods
similarity index 100%
rename from benchmarks/cua-driver-bench/taskpack/tasks/shared/cdb-s03/fixture/planning/kestrel-wharf-reconciliation.ods
rename to libs/cua-driver-bench/taskpack/tasks/shared/cdb-s03/fixture/planning/kestrel-wharf-reconciliation.ods
diff --git a/benchmarks/cua-driver-bench/taskpack/tasks/shared/cdb-s03/platform/README.md b/libs/cua-driver-bench/taskpack/tasks/shared/cdb-s03/platform/README.md
similarity index 100%
rename from benchmarks/cua-driver-bench/taskpack/tasks/shared/cdb-s03/platform/README.md
rename to libs/cua-driver-bench/taskpack/tasks/shared/cdb-s03/platform/README.md
diff --git a/benchmarks/cua-driver-bench/taskpack/tasks/shared/cdb-s03/platform/launch.linux.json b/libs/cua-driver-bench/taskpack/tasks/shared/cdb-s03/platform/launch.linux.json
similarity index 100%
rename from benchmarks/cua-driver-bench/taskpack/tasks/shared/cdb-s03/platform/launch.linux.json
rename to libs/cua-driver-bench/taskpack/tasks/shared/cdb-s03/platform/launch.linux.json
diff --git a/benchmarks/cua-driver-bench/taskpack/tasks/shared/cdb-s03/platform/launch.macos.json b/libs/cua-driver-bench/taskpack/tasks/shared/cdb-s03/platform/launch.macos.json
similarity index 100%
rename from benchmarks/cua-driver-bench/taskpack/tasks/shared/cdb-s03/platform/launch.macos.json
rename to libs/cua-driver-bench/taskpack/tasks/shared/cdb-s03/platform/launch.macos.json
diff --git a/benchmarks/cua-driver-bench/taskpack/tasks/shared/cdb-s03/platform/launch.windows.json b/libs/cua-driver-bench/taskpack/tasks/shared/cdb-s03/platform/launch.windows.json
similarity index 100%
rename from benchmarks/cua-driver-bench/taskpack/tasks/shared/cdb-s03/platform/launch.windows.json
rename to libs/cua-driver-bench/taskpack/tasks/shared/cdb-s03/platform/launch.windows.json
diff --git a/benchmarks/cua-driver-bench/taskpack/tasks/shared/cdb-s03/reset/failure-fixtures/stale-book.txt b/libs/cua-driver-bench/taskpack/tasks/shared/cdb-s03/reset/failure-fixtures/stale-book.txt
similarity index 100%
rename from benchmarks/cua-driver-bench/taskpack/tasks/shared/cdb-s03/reset/failure-fixtures/stale-book.txt
rename to libs/cua-driver-bench/taskpack/tasks/shared/cdb-s03/reset/failure-fixtures/stale-book.txt
diff --git a/benchmarks/cua-driver-bench/taskpack/tasks/shared/cdb-s03/reset/failure-fixtures/stale-workbook.txt b/libs/cua-driver-bench/taskpack/tasks/shared/cdb-s03/reset/failure-fixtures/stale-workbook.txt
similarity index 100%
rename from benchmarks/cua-driver-bench/taskpack/tasks/shared/cdb-s03/reset/failure-fixtures/stale-workbook.txt
rename to libs/cua-driver-bench/taskpack/tasks/shared/cdb-s03/reset/failure-fixtures/stale-workbook.txt
diff --git a/benchmarks/cua-driver-bench/taskpack/tasks/shared/cdb-s03/reset/setup.py b/libs/cua-driver-bench/taskpack/tasks/shared/cdb-s03/reset/setup.py
similarity index 100%
rename from benchmarks/cua-driver-bench/taskpack/tasks/shared/cdb-s03/reset/setup.py
rename to libs/cua-driver-bench/taskpack/tasks/shared/cdb-s03/reset/setup.py
diff --git a/benchmarks/cua-driver-bench/taskpack/tasks/shared/cdb-s03/reset/verify.py b/libs/cua-driver-bench/taskpack/tasks/shared/cdb-s03/reset/verify.py
similarity index 100%
rename from benchmarks/cua-driver-bench/taskpack/tasks/shared/cdb-s03/reset/verify.py
rename to libs/cua-driver-bench/taskpack/tasks/shared/cdb-s03/reset/verify.py
diff --git a/benchmarks/cua-driver-bench/taskpack/tasks/shared/cdb-s03/task.cuabench.json b/libs/cua-driver-bench/taskpack/tasks/shared/cdb-s03/task.cuabench.json
similarity index 100%
rename from benchmarks/cua-driver-bench/taskpack/tasks/shared/cdb-s03/task.cuabench.json
rename to libs/cua-driver-bench/taskpack/tasks/shared/cdb-s03/task.cuabench.json
diff --git a/benchmarks/cua-driver-bench/taskpack/tasks/shared/cdb-s03/tests/test_cdb_s03.py b/libs/cua-driver-bench/taskpack/tasks/shared/cdb-s03/tests/test_cdb_s03.py
similarity index 100%
rename from benchmarks/cua-driver-bench/taskpack/tasks/shared/cdb-s03/tests/test_cdb_s03.py
rename to libs/cua-driver-bench/taskpack/tasks/shared/cdb-s03/tests/test_cdb_s03.py
diff --git a/benchmarks/cua-driver-bench/taskpack/tasks/shared/cdb-s03/tools/build_fixture_ods.py b/libs/cua-driver-bench/taskpack/tasks/shared/cdb-s03/tools/build_fixture_ods.py
similarity index 100%
rename from benchmarks/cua-driver-bench/taskpack/tasks/shared/cdb-s03/tools/build_fixture_ods.py
rename to libs/cua-driver-bench/taskpack/tasks/shared/cdb-s03/tools/build_fixture_ods.py
diff --git a/benchmarks/cua-driver-bench/taskpack/tasks/shared/cdb-s03/tools/build_platform_descriptors.py b/libs/cua-driver-bench/taskpack/tasks/shared/cdb-s03/tools/build_platform_descriptors.py
similarity index 100%
rename from benchmarks/cua-driver-bench/taskpack/tasks/shared/cdb-s03/tools/build_platform_descriptors.py
rename to libs/cua-driver-bench/taskpack/tasks/shared/cdb-s03/tools/build_platform_descriptors.py
diff --git a/benchmarks/cua-driver-bench/taskpack/tasks/shared/cdb-s03/tools/refresh_manifest_digests.py b/libs/cua-driver-bench/taskpack/tasks/shared/cdb-s03/tools/refresh_manifest_digests.py
similarity index 100%
rename from benchmarks/cua-driver-bench/taskpack/tasks/shared/cdb-s03/tools/refresh_manifest_digests.py
rename to libs/cua-driver-bench/taskpack/tasks/shared/cdb-s03/tools/refresh_manifest_digests.py
diff --git a/benchmarks/cua-driver-bench/taskpack/tasks/shared/cdb-s04/PROVENANCE.md b/libs/cua-driver-bench/taskpack/tasks/shared/cdb-s04/PROVENANCE.md
similarity index 100%
rename from benchmarks/cua-driver-bench/taskpack/tasks/shared/cdb-s04/PROVENANCE.md
rename to libs/cua-driver-bench/taskpack/tasks/shared/cdb-s04/PROVENANCE.md
diff --git a/benchmarks/cua-driver-bench/taskpack/tasks/shared/cdb-s04/README.md b/libs/cua-driver-bench/taskpack/tasks/shared/cdb-s04/README.md
similarity index 100%
rename from benchmarks/cua-driver-bench/taskpack/tasks/shared/cdb-s04/README.md
rename to libs/cua-driver-bench/taskpack/tasks/shared/cdb-s04/README.md
diff --git a/benchmarks/cua-driver-bench/taskpack/tasks/shared/cdb-s04/apps/margin-lantern-manual/main.js b/libs/cua-driver-bench/taskpack/tasks/shared/cdb-s04/apps/margin-lantern-manual/main.js
similarity index 100%
rename from benchmarks/cua-driver-bench/taskpack/tasks/shared/cdb-s04/apps/margin-lantern-manual/main.js
rename to libs/cua-driver-bench/taskpack/tasks/shared/cdb-s04/apps/margin-lantern-manual/main.js
diff --git a/benchmarks/cua-driver-bench/taskpack/tasks/shared/cdb-s04/apps/margin-lantern-manual/package-lock.json b/libs/cua-driver-bench/taskpack/tasks/shared/cdb-s04/apps/margin-lantern-manual/package-lock.json
similarity index 100%
rename from benchmarks/cua-driver-bench/taskpack/tasks/shared/cdb-s04/apps/margin-lantern-manual/package-lock.json
rename to libs/cua-driver-bench/taskpack/tasks/shared/cdb-s04/apps/margin-lantern-manual/package-lock.json
diff --git a/benchmarks/cua-driver-bench/taskpack/tasks/shared/cdb-s04/apps/margin-lantern-manual/package.json b/libs/cua-driver-bench/taskpack/tasks/shared/cdb-s04/apps/margin-lantern-manual/package.json
similarity index 100%
rename from benchmarks/cua-driver-bench/taskpack/tasks/shared/cdb-s04/apps/margin-lantern-manual/package.json
rename to libs/cua-driver-bench/taskpack/tasks/shared/cdb-s04/apps/margin-lantern-manual/package.json
diff --git a/benchmarks/cua-driver-bench/taskpack/tasks/shared/cdb-s04/apps/margin-lantern-manual/preload.js b/libs/cua-driver-bench/taskpack/tasks/shared/cdb-s04/apps/margin-lantern-manual/preload.js
similarity index 100%
rename from benchmarks/cua-driver-bench/taskpack/tasks/shared/cdb-s04/apps/margin-lantern-manual/preload.js
rename to libs/cua-driver-bench/taskpack/tasks/shared/cdb-s04/apps/margin-lantern-manual/preload.js
diff --git a/benchmarks/cua-driver-bench/taskpack/tasks/shared/cdb-s04/apps/margin-lantern-manual/renderer/app.js b/libs/cua-driver-bench/taskpack/tasks/shared/cdb-s04/apps/margin-lantern-manual/renderer/app.js
similarity index 100%
rename from benchmarks/cua-driver-bench/taskpack/tasks/shared/cdb-s04/apps/margin-lantern-manual/renderer/app.js
rename to libs/cua-driver-bench/taskpack/tasks/shared/cdb-s04/apps/margin-lantern-manual/renderer/app.js
diff --git a/benchmarks/cua-driver-bench/taskpack/tasks/shared/cdb-s04/apps/margin-lantern-manual/renderer/index.html b/libs/cua-driver-bench/taskpack/tasks/shared/cdb-s04/apps/margin-lantern-manual/renderer/index.html
similarity index 100%
rename from benchmarks/cua-driver-bench/taskpack/tasks/shared/cdb-s04/apps/margin-lantern-manual/renderer/index.html
rename to libs/cua-driver-bench/taskpack/tasks/shared/cdb-s04/apps/margin-lantern-manual/renderer/index.html
diff --git a/benchmarks/cua-driver-bench/taskpack/tasks/shared/cdb-s04/apps/margin-lantern-manual/renderer/styles.css b/libs/cua-driver-bench/taskpack/tasks/shared/cdb-s04/apps/margin-lantern-manual/renderer/styles.css
similarity index 100%
rename from benchmarks/cua-driver-bench/taskpack/tasks/shared/cdb-s04/apps/margin-lantern-manual/renderer/styles.css
rename to libs/cua-driver-bench/taskpack/tasks/shared/cdb-s04/apps/margin-lantern-manual/renderer/styles.css
diff --git a/benchmarks/cua-driver-bench/taskpack/tasks/shared/cdb-s04/apps/margin-lantern-manual/store.js b/libs/cua-driver-bench/taskpack/tasks/shared/cdb-s04/apps/margin-lantern-manual/store.js
similarity index 100%
rename from benchmarks/cua-driver-bench/taskpack/tasks/shared/cdb-s04/apps/margin-lantern-manual/store.js
rename to libs/cua-driver-bench/taskpack/tasks/shared/cdb-s04/apps/margin-lantern-manual/store.js
diff --git a/benchmarks/cua-driver-bench/taskpack/tasks/shared/cdb-s04/apps/margin-lantern-manual/tests/store.test.js b/libs/cua-driver-bench/taskpack/tasks/shared/cdb-s04/apps/margin-lantern-manual/tests/store.test.js
similarity index 100%
rename from benchmarks/cua-driver-bench/taskpack/tasks/shared/cdb-s04/apps/margin-lantern-manual/tests/store.test.js
rename to libs/cua-driver-bench/taskpack/tasks/shared/cdb-s04/apps/margin-lantern-manual/tests/store.test.js
diff --git a/benchmarks/cua-driver-bench/taskpack/tasks/shared/cdb-s04/apps/rillwatch-cases/main.js b/libs/cua-driver-bench/taskpack/tasks/shared/cdb-s04/apps/rillwatch-cases/main.js
similarity index 100%
rename from benchmarks/cua-driver-bench/taskpack/tasks/shared/cdb-s04/apps/rillwatch-cases/main.js
rename to libs/cua-driver-bench/taskpack/tasks/shared/cdb-s04/apps/rillwatch-cases/main.js
diff --git a/benchmarks/cua-driver-bench/taskpack/tasks/shared/cdb-s04/apps/rillwatch-cases/package-lock.json b/libs/cua-driver-bench/taskpack/tasks/shared/cdb-s04/apps/rillwatch-cases/package-lock.json
similarity index 100%
rename from benchmarks/cua-driver-bench/taskpack/tasks/shared/cdb-s04/apps/rillwatch-cases/package-lock.json
rename to libs/cua-driver-bench/taskpack/tasks/shared/cdb-s04/apps/rillwatch-cases/package-lock.json
diff --git a/benchmarks/cua-driver-bench/taskpack/tasks/shared/cdb-s04/apps/rillwatch-cases/package.json b/libs/cua-driver-bench/taskpack/tasks/shared/cdb-s04/apps/rillwatch-cases/package.json
similarity index 100%
rename from benchmarks/cua-driver-bench/taskpack/tasks/shared/cdb-s04/apps/rillwatch-cases/package.json
rename to libs/cua-driver-bench/taskpack/tasks/shared/cdb-s04/apps/rillwatch-cases/package.json
diff --git a/benchmarks/cua-driver-bench/taskpack/tasks/shared/cdb-s04/apps/rillwatch-cases/preload.js b/libs/cua-driver-bench/taskpack/tasks/shared/cdb-s04/apps/rillwatch-cases/preload.js
similarity index 100%
rename from benchmarks/cua-driver-bench/taskpack/tasks/shared/cdb-s04/apps/rillwatch-cases/preload.js
rename to libs/cua-driver-bench/taskpack/tasks/shared/cdb-s04/apps/rillwatch-cases/preload.js
diff --git a/benchmarks/cua-driver-bench/taskpack/tasks/shared/cdb-s04/apps/rillwatch-cases/renderer/app.js b/libs/cua-driver-bench/taskpack/tasks/shared/cdb-s04/apps/rillwatch-cases/renderer/app.js
similarity index 100%
rename from benchmarks/cua-driver-bench/taskpack/tasks/shared/cdb-s04/apps/rillwatch-cases/renderer/app.js
rename to libs/cua-driver-bench/taskpack/tasks/shared/cdb-s04/apps/rillwatch-cases/renderer/app.js
diff --git a/benchmarks/cua-driver-bench/taskpack/tasks/shared/cdb-s04/apps/rillwatch-cases/renderer/index.html b/libs/cua-driver-bench/taskpack/tasks/shared/cdb-s04/apps/rillwatch-cases/renderer/index.html
similarity index 100%
rename from benchmarks/cua-driver-bench/taskpack/tasks/shared/cdb-s04/apps/rillwatch-cases/renderer/index.html
rename to libs/cua-driver-bench/taskpack/tasks/shared/cdb-s04/apps/rillwatch-cases/renderer/index.html
diff --git a/benchmarks/cua-driver-bench/taskpack/tasks/shared/cdb-s04/apps/rillwatch-cases/renderer/styles.css b/libs/cua-driver-bench/taskpack/tasks/shared/cdb-s04/apps/rillwatch-cases/renderer/styles.css
similarity index 100%
rename from benchmarks/cua-driver-bench/taskpack/tasks/shared/cdb-s04/apps/rillwatch-cases/renderer/styles.css
rename to libs/cua-driver-bench/taskpack/tasks/shared/cdb-s04/apps/rillwatch-cases/renderer/styles.css
diff --git a/benchmarks/cua-driver-bench/taskpack/tasks/shared/cdb-s04/apps/rillwatch-cases/store.js b/libs/cua-driver-bench/taskpack/tasks/shared/cdb-s04/apps/rillwatch-cases/store.js
similarity index 100%
rename from benchmarks/cua-driver-bench/taskpack/tasks/shared/cdb-s04/apps/rillwatch-cases/store.js
rename to libs/cua-driver-bench/taskpack/tasks/shared/cdb-s04/apps/rillwatch-cases/store.js
diff --git a/benchmarks/cua-driver-bench/taskpack/tasks/shared/cdb-s04/apps/rillwatch-cases/tests/store.test.js b/libs/cua-driver-bench/taskpack/tasks/shared/cdb-s04/apps/rillwatch-cases/tests/store.test.js
similarity index 100%
rename from benchmarks/cua-driver-bench/taskpack/tasks/shared/cdb-s04/apps/rillwatch-cases/tests/store.test.js
rename to libs/cua-driver-bench/taskpack/tasks/shared/cdb-s04/apps/rillwatch-cases/tests/store.test.js
diff --git a/benchmarks/cua-driver-bench/taskpack/tasks/shared/cdb-s04/brief.md b/libs/cua-driver-bench/taskpack/tasks/shared/cdb-s04/brief.md
similarity index 100%
rename from benchmarks/cua-driver-bench/taskpack/tasks/shared/cdb-s04/brief.md
rename to libs/cua-driver-bench/taskpack/tasks/shared/cdb-s04/brief.md
diff --git a/benchmarks/cua-driver-bench/taskpack/tasks/shared/cdb-s04/evaluator/evaluate.py b/libs/cua-driver-bench/taskpack/tasks/shared/cdb-s04/evaluator/evaluate.py
similarity index 100%
rename from benchmarks/cua-driver-bench/taskpack/tasks/shared/cdb-s04/evaluator/evaluate.py
rename to libs/cua-driver-bench/taskpack/tasks/shared/cdb-s04/evaluator/evaluate.py
diff --git a/benchmarks/cua-driver-bench/taskpack/tasks/shared/cdb-s04/evaluator/oracle.json b/libs/cua-driver-bench/taskpack/tasks/shared/cdb-s04/evaluator/oracle.json
similarity index 100%
rename from benchmarks/cua-driver-bench/taskpack/tasks/shared/cdb-s04/evaluator/oracle.json
rename to libs/cua-driver-bench/taskpack/tasks/shared/cdb-s04/evaluator/oracle.json
diff --git a/benchmarks/cua-driver-bench/taskpack/tasks/shared/cdb-s04/fixture/archive-site/data/records.json b/libs/cua-driver-bench/taskpack/tasks/shared/cdb-s04/fixture/archive-site/data/records.json
similarity index 100%
rename from benchmarks/cua-driver-bench/taskpack/tasks/shared/cdb-s04/fixture/archive-site/data/records.json
rename to libs/cua-driver-bench/taskpack/tasks/shared/cdb-s04/fixture/archive-site/data/records.json
diff --git a/benchmarks/cua-driver-bench/taskpack/tasks/shared/cdb-s04/fixture/archive-site/package-lock.json b/libs/cua-driver-bench/taskpack/tasks/shared/cdb-s04/fixture/archive-site/package-lock.json
similarity index 100%
rename from benchmarks/cua-driver-bench/taskpack/tasks/shared/cdb-s04/fixture/archive-site/package-lock.json
rename to libs/cua-driver-bench/taskpack/tasks/shared/cdb-s04/fixture/archive-site/package-lock.json
diff --git a/benchmarks/cua-driver-bench/taskpack/tasks/shared/cdb-s04/fixture/archive-site/package.json b/libs/cua-driver-bench/taskpack/tasks/shared/cdb-s04/fixture/archive-site/package.json
similarity index 100%
rename from benchmarks/cua-driver-bench/taskpack/tasks/shared/cdb-s04/fixture/archive-site/package.json
rename to libs/cua-driver-bench/taskpack/tasks/shared/cdb-s04/fixture/archive-site/package.json
diff --git a/benchmarks/cua-driver-bench/taskpack/tasks/shared/cdb-s04/fixture/archive-site/public/app.js b/libs/cua-driver-bench/taskpack/tasks/shared/cdb-s04/fixture/archive-site/public/app.js
similarity index 100%
rename from benchmarks/cua-driver-bench/taskpack/tasks/shared/cdb-s04/fixture/archive-site/public/app.js
rename to libs/cua-driver-bench/taskpack/tasks/shared/cdb-s04/fixture/archive-site/public/app.js
diff --git a/benchmarks/cua-driver-bench/taskpack/tasks/shared/cdb-s04/fixture/archive-site/public/styles.css b/libs/cua-driver-bench/taskpack/tasks/shared/cdb-s04/fixture/archive-site/public/styles.css
similarity index 100%
rename from benchmarks/cua-driver-bench/taskpack/tasks/shared/cdb-s04/fixture/archive-site/public/styles.css
rename to libs/cua-driver-bench/taskpack/tasks/shared/cdb-s04/fixture/archive-site/public/styles.css
diff --git a/benchmarks/cua-driver-bench/taskpack/tasks/shared/cdb-s04/fixture/archive-site/server.js b/libs/cua-driver-bench/taskpack/tasks/shared/cdb-s04/fixture/archive-site/server.js
similarity index 100%
rename from benchmarks/cua-driver-bench/taskpack/tasks/shared/cdb-s04/fixture/archive-site/server.js
rename to libs/cua-driver-bench/taskpack/tasks/shared/cdb-s04/fixture/archive-site/server.js
diff --git a/benchmarks/cua-driver-bench/taskpack/tasks/shared/cdb-s04/fixture/archive-site/tests/server.test.js b/libs/cua-driver-bench/taskpack/tasks/shared/cdb-s04/fixture/archive-site/tests/server.test.js
similarity index 100%
rename from benchmarks/cua-driver-bench/taskpack/tasks/shared/cdb-s04/fixture/archive-site/tests/server.test.js
rename to libs/cua-driver-bench/taskpack/tasks/shared/cdb-s04/fixture/archive-site/tests/server.test.js
diff --git a/benchmarks/cua-driver-bench/taskpack/tasks/shared/cdb-s04/fixture/cases/cases.json b/libs/cua-driver-bench/taskpack/tasks/shared/cdb-s04/fixture/cases/cases.json
similarity index 100%
rename from benchmarks/cua-driver-bench/taskpack/tasks/shared/cdb-s04/fixture/cases/cases.json
rename to libs/cua-driver-bench/taskpack/tasks/shared/cdb-s04/fixture/cases/cases.json
diff --git a/benchmarks/cua-driver-bench/taskpack/tasks/shared/cdb-s04/fixture/cdb-s04.workspace.json b/libs/cua-driver-bench/taskpack/tasks/shared/cdb-s04/fixture/cdb-s04.workspace.json
similarity index 100%
rename from benchmarks/cua-driver-bench/taskpack/tasks/shared/cdb-s04/fixture/cdb-s04.workspace.json
rename to libs/cua-driver-bench/taskpack/tasks/shared/cdb-s04/fixture/cdb-s04.workspace.json
diff --git a/benchmarks/cua-driver-bench/taskpack/tasks/shared/cdb-s04/fixture/logs/archive-access.log b/libs/cua-driver-bench/taskpack/tasks/shared/cdb-s04/fixture/logs/archive-access.log
similarity index 100%
rename from benchmarks/cua-driver-bench/taskpack/tasks/shared/cdb-s04/fixture/logs/archive-access.log
rename to libs/cua-driver-bench/taskpack/tasks/shared/cdb-s04/fixture/logs/archive-access.log
diff --git a/benchmarks/cua-driver-bench/taskpack/tasks/shared/cdb-s04/fixture/wiki/articles.json b/libs/cua-driver-bench/taskpack/tasks/shared/cdb-s04/fixture/wiki/articles.json
similarity index 100%
rename from benchmarks/cua-driver-bench/taskpack/tasks/shared/cdb-s04/fixture/wiki/articles.json
rename to libs/cua-driver-bench/taskpack/tasks/shared/cdb-s04/fixture/wiki/articles.json
diff --git a/benchmarks/cua-driver-bench/taskpack/tasks/shared/cdb-s04/platform/README.md b/libs/cua-driver-bench/taskpack/tasks/shared/cdb-s04/platform/README.md
similarity index 100%
rename from benchmarks/cua-driver-bench/taskpack/tasks/shared/cdb-s04/platform/README.md
rename to libs/cua-driver-bench/taskpack/tasks/shared/cdb-s04/platform/README.md
diff --git a/benchmarks/cua-driver-bench/taskpack/tasks/shared/cdb-s04/platform/launch.linux.json b/libs/cua-driver-bench/taskpack/tasks/shared/cdb-s04/platform/launch.linux.json
similarity index 100%
rename from benchmarks/cua-driver-bench/taskpack/tasks/shared/cdb-s04/platform/launch.linux.json
rename to libs/cua-driver-bench/taskpack/tasks/shared/cdb-s04/platform/launch.linux.json
diff --git a/benchmarks/cua-driver-bench/taskpack/tasks/shared/cdb-s04/platform/launch.macos.json b/libs/cua-driver-bench/taskpack/tasks/shared/cdb-s04/platform/launch.macos.json
similarity index 100%
rename from benchmarks/cua-driver-bench/taskpack/tasks/shared/cdb-s04/platform/launch.macos.json
rename to libs/cua-driver-bench/taskpack/tasks/shared/cdb-s04/platform/launch.macos.json
diff --git a/benchmarks/cua-driver-bench/taskpack/tasks/shared/cdb-s04/platform/launch.windows.json b/libs/cua-driver-bench/taskpack/tasks/shared/cdb-s04/platform/launch.windows.json
similarity index 100%
rename from benchmarks/cua-driver-bench/taskpack/tasks/shared/cdb-s04/platform/launch.windows.json
rename to libs/cua-driver-bench/taskpack/tasks/shared/cdb-s04/platform/launch.windows.json
diff --git a/benchmarks/cua-driver-bench/taskpack/tasks/shared/cdb-s04/reset/failure-fixtures/stale-linked-case.json b/libs/cua-driver-bench/taskpack/tasks/shared/cdb-s04/reset/failure-fixtures/stale-linked-case.json
similarity index 100%
rename from benchmarks/cua-driver-bench/taskpack/tasks/shared/cdb-s04/reset/failure-fixtures/stale-linked-case.json
rename to libs/cua-driver-bench/taskpack/tasks/shared/cdb-s04/reset/failure-fixtures/stale-linked-case.json
diff --git a/benchmarks/cua-driver-bench/taskpack/tasks/shared/cdb-s04/reset/failure-fixtures/stale-site-file.txt b/libs/cua-driver-bench/taskpack/tasks/shared/cdb-s04/reset/failure-fixtures/stale-site-file.txt
similarity index 100%
rename from benchmarks/cua-driver-bench/taskpack/tasks/shared/cdb-s04/reset/failure-fixtures/stale-site-file.txt
rename to libs/cua-driver-bench/taskpack/tasks/shared/cdb-s04/reset/failure-fixtures/stale-site-file.txt
diff --git a/benchmarks/cua-driver-bench/taskpack/tasks/shared/cdb-s04/reset/setup.py b/libs/cua-driver-bench/taskpack/tasks/shared/cdb-s04/reset/setup.py
similarity index 100%
rename from benchmarks/cua-driver-bench/taskpack/tasks/shared/cdb-s04/reset/setup.py
rename to libs/cua-driver-bench/taskpack/tasks/shared/cdb-s04/reset/setup.py
diff --git a/benchmarks/cua-driver-bench/taskpack/tasks/shared/cdb-s04/reset/verify.py b/libs/cua-driver-bench/taskpack/tasks/shared/cdb-s04/reset/verify.py
similarity index 100%
rename from benchmarks/cua-driver-bench/taskpack/tasks/shared/cdb-s04/reset/verify.py
rename to libs/cua-driver-bench/taskpack/tasks/shared/cdb-s04/reset/verify.py
diff --git a/benchmarks/cua-driver-bench/taskpack/tasks/shared/cdb-s04/task.cuabench.json b/libs/cua-driver-bench/taskpack/tasks/shared/cdb-s04/task.cuabench.json
similarity index 100%
rename from benchmarks/cua-driver-bench/taskpack/tasks/shared/cdb-s04/task.cuabench.json
rename to libs/cua-driver-bench/taskpack/tasks/shared/cdb-s04/task.cuabench.json
diff --git a/benchmarks/cua-driver-bench/taskpack/tasks/shared/cdb-s04/tests/test_cdb_s04.py b/libs/cua-driver-bench/taskpack/tasks/shared/cdb-s04/tests/test_cdb_s04.py
similarity index 100%
rename from benchmarks/cua-driver-bench/taskpack/tasks/shared/cdb-s04/tests/test_cdb_s04.py
rename to libs/cua-driver-bench/taskpack/tasks/shared/cdb-s04/tests/test_cdb_s04.py
diff --git a/benchmarks/cua-driver-bench/taskpack/tasks/shared/cdb-s04/tools/build_platform_descriptors.py b/libs/cua-driver-bench/taskpack/tasks/shared/cdb-s04/tools/build_platform_descriptors.py
similarity index 100%
rename from benchmarks/cua-driver-bench/taskpack/tasks/shared/cdb-s04/tools/build_platform_descriptors.py
rename to libs/cua-driver-bench/taskpack/tasks/shared/cdb-s04/tools/build_platform_descriptors.py
diff --git a/benchmarks/cua-driver-bench/taskpack/tasks/shared/cdb-s04/tools/refresh_manifest_digests.py b/libs/cua-driver-bench/taskpack/tasks/shared/cdb-s04/tools/refresh_manifest_digests.py
similarity index 100%
rename from benchmarks/cua-driver-bench/taskpack/tasks/shared/cdb-s04/tools/refresh_manifest_digests.py
rename to libs/cua-driver-bench/taskpack/tasks/shared/cdb-s04/tools/refresh_manifest_digests.py
diff --git a/libs/cua-driver/docs/mcp-envelope-carrier.md b/libs/cua-driver/docs/mcp-envelope-carrier.md
index 9a3f5cb671..62c984fc74 100644
--- a/libs/cua-driver/docs/mcp-envelope-carrier.md
+++ b/libs/cua-driver/docs/mcp-envelope-carrier.md
@@ -1,6 +1,6 @@
# Typed Driver envelopes over MCP
-This opt-in candidate implements the [accepted RFC 2512 transport addendum](../../../rfcs/2512-mcp-envelope-carrier.md).
+This opt-in candidate implements the [accepted RFC 2512 transport addendum](../../../docs/rfcs/2512-mcp-envelope-carrier.md).
It is not a released SDK feature or a qualification of an existing guest image.
The extension carries the canonical Driver envelopes through an existing MCP
transport. It does not replace cua-spacesd, add agent tools, or open a port.
diff --git a/libs/cua-driver/docs/sdk-first-runtime-north-star.md b/libs/cua-driver/docs/sdk-first-runtime-north-star.md
index ceb781bb39..4f36fbf73c 100644
--- a/libs/cua-driver/docs/sdk-first-runtime-north-star.md
+++ b/libs/cua-driver/docs/sdk-first-runtime-north-star.md
@@ -5,9 +5,9 @@
**Direction:** Make the typed SDK and its owned native runtime the product
boundary. Keep daemon and server topologies as optional adapters.
-**RFC:** [RFC 2549](../../../rfcs/2549-cua-driver-sdk-owned-runtime.md)
+**RFC:** [RFC 2549](../../../docs/rfcs/2549-cua-driver-sdk-owned-runtime.md)
-**Supersedes:** [RFC 2447](../../../rfcs/2447-cua-driver-native-core-and-mcp-adapter.md)
+**Supersedes:** [RFC 2447](../../../docs/rfcs/2447-cua-driver-native-core-and-mcp-adapter.md)
**Related:**
[permission adapters and session modes](permission-adapters-and-session-modes-plan.md),
diff --git a/libs/cua-driver/docs/test-harnesses-guide.md b/libs/cua-driver/docs/test-harnesses-guide.md
index aa49c31fef..d0efb0fcca 100644
--- a/libs/cua-driver/docs/test-harnesses-guide.md
+++ b/libs/cua-driver/docs/test-harnesses-guide.md
@@ -146,7 +146,7 @@ the 34 policy cases across both apps, are no longer a merge requirement.
Extended Python stress runs remain diagnostics for specific unresolved
failures. This decision changes test strategy, records no new passing result,
and does not waive the affected CI, native evidence, or release gates in
-[RFC 3550](../../../rfcs/3550-hyprland-isolated-input.md).
+[RFC 3550](../../../docs/rfcs/3550-hyprland-isolated-input.md).
## Repository Map
diff --git a/libs/cua-driver/docs/why-cua-driver-uses-mcp-instead-of-uniffi.md b/libs/cua-driver/docs/why-cua-driver-uses-mcp-instead-of-uniffi.md
index 7f07c2926f..6e0b21d14e 100644
--- a/libs/cua-driver/docs/why-cua-driver-uses-mcp-instead-of-uniffi.md
+++ b/libs/cua-driver/docs/why-cua-driver-uses-mcp-instead-of-uniffi.md
@@ -10,7 +10,7 @@ Decision date: 2026-07-21
> they cite resolve only in git history.
> This document preserves the rationale for the 0.11.0 daemon-client SDK.
-> [RFC 2447](../../../rfcs/2447-cua-driver-native-core-and-mcp-adapter.md)
+> [RFC 2447](../../../docs/rfcs/2447-cua-driver-native-core-and-mcp-adapter.md)
> keeps MCP as the agent boundary but replaces the imported SDK topology with a
> same-process runtime and makes MCP a downstream SDK consumer. Where this
> document says the SDK is only a daemon client, RFC 2447 is authoritative.
diff --git a/libs/cua-driver/examples/jev-use/README.md b/libs/cua-driver/examples/jev-use/README.md
index 512da6e7e9..412772a316 100644
--- a/libs/cua-driver/examples/jev-use/README.md
+++ b/libs/cua-driver/examples/jev-use/README.md
@@ -75,7 +75,7 @@ fixtures, and browser tasks keep sending `cua.jev_choice_request_v1`.
### Native desktop tasks
-`NativeAccessibilitySource` ([RFC #4268](../../../../rfcs/4268-jev-use-native-candidates.md))
+`NativeAccessibilitySource` ([RFC #4268](../../../../docs/rfcs/4268-jev-use-native-candidates.md))
builds candidates from the native elements of one `get_window_state` call that
returns the tree and the screenshot together, so element tokens and the
`capture_id` describe the same moment. `native_roles.py` / `native_roles.ts`
@@ -197,7 +197,7 @@ uv run --frozen python measure_native.py replay --provider s1 --reps 5 \
on macOS, Windows, and Linux, with both the Python and TypeScript runners,
TypeSafe Jev and Cua-S1 chose correctly in all 1,680 decisions at about 4,
12, and 24 candidates. The per-harness tables are in the
-[RFC 4268 decision record](../../../../rfcs/4268-jev-use-native-candidates.md).
+[RFC 4268 decision record](../../../../docs/rfcs/4268-jev-use-native-candidates.md).
#### Choose with Cua-S1
diff --git a/libs/cua-spacesd/README.md b/libs/cua-spacesd/README.md
index 298f0a328f..22dfb99b5f 100644
--- a/libs/cua-spacesd/README.md
+++ b/libs/cua-spacesd/README.md
@@ -256,5 +256,5 @@ current behavior.
## License
Source-available under FSL-1.1-MIT ([LICENSE](LICENSE), see
-[LICENSING.md](../../LICENSING.md)). Code extracted from the MIT-licensed Cua
+[LICENSING.md](../../legal/LICENSING.md)). Code extracted from the MIT-licensed Cua
prototype keeps its notice; see [Third-party notices](THIRD_PARTY_NOTICES.md).
diff --git a/libs/cua/scripts/generate-app-core-ffi.py b/libs/cua/scripts/generate-app-core-ffi.py
index 6fdadecca0..6fc78ce25c 100644
--- a/libs/cua/scripts/generate-app-core-ffi.py
+++ b/libs/cua/scripts/generate-app-core-ffi.py
@@ -159,7 +159,7 @@ def block(src, name):
out = [
- # cua-spaces-ffi is FSL-1.1-MIT (see LICENSING.md and scripts/spdx-headers.py).
+ # cua-spaces-ffi is FSL-1.1-MIT (see legal/LICENSING.md and scripts/spdx-headers.py).
"// SPDX-License-Identifier: FSL-1.1-MIT",
"// Copyright (c) 2026 Cua AI, Inc.",
"",
diff --git a/libs/images/sandbox-images.json b/libs/images/sandbox-images.json
index 0b7ed286e3..7f7b6ea558 100644
--- a/libs/images/sandbox-images.json
+++ b/libs/images/sandbox-images.json
@@ -1,5 +1,5 @@
{
- "$comment": "The sandbox images the apps offer (Cua Spaces, the OpenKoalaBots samples) and the docs list (os-image-catalog, generated by scripts/docs-generators/sandbox.ts). One source: edit here, then run `pnpm docs:generate:sandbox` in docs/ and `node samples/openkoalabot-example-swift/scripts/gen-images.mjs`. Canonical entries are checked against libs/cua/crates/cua-image/src/canonical.rs. Benchmark entries name their `lock` (the digests the bench publisher promoted; `python3 scripts/images/gen-image-constants.py` turns them into cua_bench/images.py) and the `benchmarks` they run. Every image ref elsewhere in the repo must be one of these, a lock pin, or an entry of scripts/images/image-refs-allowlist.json (scripts/images/check-image-refs.py). Pickers (the Spaces apps, the samples) and the image tables offer the entries with published=true whose group does not set `picker: false` (benchmark images are for cua-bench, not Spaces). `distro` names the guest: `id` (`ubuntu`, `omarchy`, `macos`, `windows`; it picks the OS icon) and `name`, the pretty name the apps show while a Space is created and until it reports its own. `arch` lists its platforms, `sdk` the SDK constructor that names it and `guide` its docs page. `browsers` lists the browsers the image ships; cua-driver browser tools (CDP) drive the Chromium-family ones when the image has cua-spacesd. `digest` (optional) is the published digest the moving tag was verified at. `sizes` (every entry with a digest) records, per platform, the bytes a pull downloads, what the pulled image takes on the host (`unpacked`) and the disk the Space sees (`disk`), measured at `sizes.digest` by `python3 scripts/images/record-image-sizes.py` (the release pipelines' `catalog` step; CI fails when it is stale). `tier` (canonical images) is `slim` (the minimum that passes `cua-spacesd doctor --strict` with every feature; CI and benchmarks use it), `full` (the default: slim plus dev tooling, no tag suffix) or `xcode` (macOS: full plus one pinned Xcode); the tag grammar is `<os-version>[-<tier>][-disk]`. `gpu: false` (optional; absent means offered): the guest cannot use GPU acceleration (macOS 15 predates the paravirtual GPU); the apps don't offer it and local creates refuse it.",
+ "$comment": "The sandbox images the apps offer (Cua Spaces, the OpenKoalaBots samples) and the docs list (os-image-catalog, generated by scripts/docs-generators/sandbox.ts). One source: edit here, then run `pnpm docs:generate:sandbox` in docs/ and `node examples/openkoalabot-example-swift/scripts/gen-images.mjs`. Canonical entries are checked against libs/cua/crates/cua-image/src/canonical.rs. Benchmark entries name their `lock` (the digests the bench publisher promoted; `python3 scripts/images/gen-image-constants.py` turns them into cua_bench/images.py) and the `benchmarks` they run. Every image ref elsewhere in the repo must be one of these, a lock pin, or an entry of scripts/images/image-refs-allowlist.json (scripts/images/check-image-refs.py). Pickers (the Spaces apps, the samples) and the image tables offer the entries with published=true whose group does not set `picker: false` (benchmark images are for cua-bench, not Spaces). `distro` names the guest: `id` (`ubuntu`, `omarchy`, `macos`, `windows`; it picks the OS icon) and `name`, the pretty name the apps show while a Space is created and until it reports its own. `arch` lists its platforms, `sdk` the SDK constructor that names it and `guide` its docs page. `browsers` lists the browsers the image ships; cua-driver browser tools (CDP) drive the Chromium-family ones when the image has cua-spacesd. `digest` (optional) is the published digest the moving tag was verified at. `sizes` (every entry with a digest) records, per platform, the bytes a pull downloads, what the pulled image takes on the host (`unpacked`) and the disk the Space sees (`disk`), measured at `sizes.digest` by `python3 scripts/images/record-image-sizes.py` (the release pipelines' `catalog` step; CI fails when it is stale). `tier` (canonical images) is `slim` (the minimum that passes `cua-spacesd doctor --strict` with every feature; CI and benchmarks use it), `full` (the default: slim plus dev tooling, no tag suffix) or `xcode` (macOS: full plus one pinned Xcode); the tag grammar is `<os-version>[-<tier>][-disk]`. `gpu: false` (optional; absent means offered): the guest cannot use GPU acceleration (macOS 15 predates the paravirtual GPU); the apps don't offer it and local creates refuse it.",
"schemaVersion": 1,
"groups": [
{ "id": "canonical", "label": "Desktop images" },
diff --git a/libs/lume/metal-capability-shim/README.md b/libs/lume/metal-capability-shim/README.md
index df27f7a0ac..d849b9c969 100644
--- a/libs/lume/metal-capability-shim/README.md
+++ b/libs/lume/metal-capability-shim/README.md
@@ -58,8 +58,8 @@ This code relies on private, version-sensitive Metal implementation details in t
## Evidence
-- [TinyLlama and MLX-LM validation](../../../evidence/lume-metal-capability-shim/2026-08-09-m1-ultra)
-- [Gemma 4 12B validation](../../../evidence/lume-metal-capability-shim/2026-08-10-m1-ultra-gemma4)
+- [TinyLlama and MLX-LM validation](evidence/2026-08-09-m1-ultra)
+- [Gemma 4 12B validation](evidence/2026-08-10-m1-ultra-gemma4)
## License
diff --git a/evidence/lume-metal-capability-shim/2026-08-09-m1-ultra/README.md b/libs/lume/metal-capability-shim/evidence/2026-08-09-m1-ultra/README.md
similarity index 100%
rename from evidence/lume-metal-capability-shim/2026-08-09-m1-ultra/README.md
rename to libs/lume/metal-capability-shim/evidence/2026-08-09-m1-ultra/README.md
diff --git a/evidence/lume-metal-capability-shim/2026-08-09-m1-ultra/SHA256SUMS b/libs/lume/metal-capability-shim/evidence/2026-08-09-m1-ultra/SHA256SUMS
similarity index 100%
rename from evidence/lume-metal-capability-shim/2026-08-09-m1-ultra/SHA256SUMS
rename to libs/lume/metal-capability-shim/evidence/2026-08-09-m1-ultra/SHA256SUMS
diff --git a/evidence/lume-metal-capability-shim/2026-08-09-m1-ultra/candidate-hooked-smoke.stderr b/libs/lume/metal-capability-shim/evidence/2026-08-09-m1-ultra/candidate-hooked-smoke.stderr
similarity index 100%
rename from evidence/lume-metal-capability-shim/2026-08-09-m1-ultra/candidate-hooked-smoke.stderr
rename to libs/lume/metal-capability-shim/evidence/2026-08-09-m1-ultra/candidate-hooked-smoke.stderr
diff --git a/evidence/lume-metal-capability-shim/2026-08-09-m1-ultra/candidate-hooked-smoke.txt b/libs/lume/metal-capability-shim/evidence/2026-08-09-m1-ultra/candidate-hooked-smoke.txt
similarity index 100%
rename from evidence/lume-metal-capability-shim/2026-08-09-m1-ultra/candidate-hooked-smoke.txt
rename to libs/lume/metal-capability-shim/evidence/2026-08-09-m1-ultra/candidate-hooked-smoke.txt
diff --git a/evidence/lume-metal-capability-shim/2026-08-09-m1-ultra/metadata.md b/libs/lume/metal-capability-shim/evidence/2026-08-09-m1-ultra/metadata.md
similarity index 100%
rename from evidence/lume-metal-capability-shim/2026-08-09-m1-ultra/metadata.md
rename to libs/lume/metal-capability-shim/evidence/2026-08-09-m1-ultra/metadata.md
diff --git a/evidence/lume-metal-capability-shim/2026-08-09-m1-ultra/mlx-broad-profile-failure.stderr b/libs/lume/metal-capability-shim/evidence/2026-08-09-m1-ultra/mlx-broad-profile-failure.stderr
similarity index 100%
rename from evidence/lume-metal-capability-shim/2026-08-09-m1-ultra/mlx-broad-profile-failure.stderr
rename to libs/lume/metal-capability-shim/evidence/2026-08-09-m1-ultra/mlx-broad-profile-failure.stderr
diff --git a/evidence/lume-metal-capability-shim/2026-08-09-m1-ultra/mlx-safe-shim-10x.json b/libs/lume/metal-capability-shim/evidence/2026-08-09-m1-ultra/mlx-safe-shim-10x.json
similarity index 100%
rename from evidence/lume-metal-capability-shim/2026-08-09-m1-ultra/mlx-safe-shim-10x.json
rename to libs/lume/metal-capability-shim/evidence/2026-08-09-m1-ultra/mlx-safe-shim-10x.json
diff --git a/evidence/lume-metal-capability-shim/2026-08-09-m1-ultra/mlx-stock-10x.json b/libs/lume/metal-capability-shim/evidence/2026-08-09-m1-ultra/mlx-stock-10x.json
similarity index 100%
rename from evidence/lume-metal-capability-shim/2026-08-09-m1-ultra/mlx-stock-10x.json
rename to libs/lume/metal-capability-shim/evidence/2026-08-09-m1-ultra/mlx-stock-10x.json
diff --git a/evidence/lume-metal-capability-shim/2026-08-09-m1-ultra/results.csv b/libs/lume/metal-capability-shim/evidence/2026-08-09-m1-ultra/results.csv
similarity index 100%
rename from evidence/lume-metal-capability-shim/2026-08-09-m1-ultra/results.csv
rename to libs/lume/metal-capability-shim/evidence/2026-08-09-m1-ultra/results.csv
diff --git a/evidence/lume-metal-capability-shim/2026-08-09-m1-ultra/tiny-hooked-minimal.json b/libs/lume/metal-capability-shim/evidence/2026-08-09-m1-ultra/tiny-hooked-minimal.json
similarity index 100%
rename from evidence/lume-metal-capability-shim/2026-08-09-m1-ultra/tiny-hooked-minimal.json
rename to libs/lume/metal-capability-shim/evidence/2026-08-09-m1-ultra/tiny-hooked-minimal.json
diff --git a/evidence/lume-metal-capability-shim/2026-08-09-m1-ultra/tiny-hooked-minimal.stderr b/libs/lume/metal-capability-shim/evidence/2026-08-09-m1-ultra/tiny-hooked-minimal.stderr
similarity index 100%
rename from evidence/lume-metal-capability-shim/2026-08-09-m1-ultra/tiny-hooked-minimal.stderr
rename to libs/lume/metal-capability-shim/evidence/2026-08-09-m1-ultra/tiny-hooked-minimal.stderr
diff --git a/evidence/lume-metal-capability-shim/2026-08-09-m1-ultra/tiny-host-minimal.json b/libs/lume/metal-capability-shim/evidence/2026-08-09-m1-ultra/tiny-host-minimal.json
similarity index 100%
rename from evidence/lume-metal-capability-shim/2026-08-09-m1-ultra/tiny-host-minimal.json
rename to libs/lume/metal-capability-shim/evidence/2026-08-09-m1-ultra/tiny-host-minimal.json
diff --git a/evidence/lume-metal-capability-shim/2026-08-09-m1-ultra/tiny-host-minimal.stderr b/libs/lume/metal-capability-shim/evidence/2026-08-09-m1-ultra/tiny-host-minimal.stderr
similarity index 100%
rename from evidence/lume-metal-capability-shim/2026-08-09-m1-ultra/tiny-host-minimal.stderr
rename to libs/lume/metal-capability-shim/evidence/2026-08-09-m1-ultra/tiny-host-minimal.stderr
diff --git a/evidence/lume-metal-capability-shim/2026-08-09-m1-ultra/tiny-safe-shim-10x-final.json b/libs/lume/metal-capability-shim/evidence/2026-08-09-m1-ultra/tiny-safe-shim-10x-final.json
similarity index 100%
rename from evidence/lume-metal-capability-shim/2026-08-09-m1-ultra/tiny-safe-shim-10x-final.json
rename to libs/lume/metal-capability-shim/evidence/2026-08-09-m1-ultra/tiny-safe-shim-10x-final.json
diff --git a/evidence/lume-metal-capability-shim/2026-08-09-m1-ultra/tiny-safe-shim-10x-final.stderr b/libs/lume/metal-capability-shim/evidence/2026-08-09-m1-ultra/tiny-safe-shim-10x-final.stderr
similarity index 100%
rename from evidence/lume-metal-capability-shim/2026-08-09-m1-ultra/tiny-safe-shim-10x-final.stderr
rename to libs/lume/metal-capability-shim/evidence/2026-08-09-m1-ultra/tiny-safe-shim-10x-final.stderr
diff --git a/evidence/lume-metal-capability-shim/2026-08-09-m1-ultra/tiny-stock-minimal.json b/libs/lume/metal-capability-shim/evidence/2026-08-09-m1-ultra/tiny-stock-minimal.json
similarity index 100%
rename from evidence/lume-metal-capability-shim/2026-08-09-m1-ultra/tiny-stock-minimal.json
rename to libs/lume/metal-capability-shim/evidence/2026-08-09-m1-ultra/tiny-stock-minimal.json
diff --git a/evidence/lume-metal-capability-shim/2026-08-09-m1-ultra/tiny-stock-minimal.stderr b/libs/lume/metal-capability-shim/evidence/2026-08-09-m1-ultra/tiny-stock-minimal.stderr
similarity index 100%
rename from evidence/lume-metal-capability-shim/2026-08-09-m1-ultra/tiny-stock-minimal.stderr
rename to libs/lume/metal-capability-shim/evidence/2026-08-09-m1-ultra/tiny-stock-minimal.stderr
diff --git a/evidence/lume-metal-capability-shim/2026-08-10-m1-ultra-gemma4/README.md b/libs/lume/metal-capability-shim/evidence/2026-08-10-m1-ultra-gemma4/README.md
similarity index 100%
rename from evidence/lume-metal-capability-shim/2026-08-10-m1-ultra-gemma4/README.md
rename to libs/lume/metal-capability-shim/evidence/2026-08-10-m1-ultra-gemma4/README.md
diff --git a/evidence/lume-metal-capability-shim/2026-08-10-m1-ultra-gemma4/SHA256SUMS b/libs/lume/metal-capability-shim/evidence/2026-08-10-m1-ultra-gemma4/SHA256SUMS
similarity index 100%
rename from evidence/lume-metal-capability-shim/2026-08-10-m1-ultra-gemma4/SHA256SUMS
rename to libs/lume/metal-capability-shim/evidence/2026-08-10-m1-ultra-gemma4/SHA256SUMS
diff --git a/evidence/lume-metal-capability-shim/2026-08-10-m1-ultra-gemma4/gemma4-host-10x.json b/libs/lume/metal-capability-shim/evidence/2026-08-10-m1-ultra-gemma4/gemma4-host-10x.json
similarity index 100%
rename from evidence/lume-metal-capability-shim/2026-08-10-m1-ultra-gemma4/gemma4-host-10x.json
rename to libs/lume/metal-capability-shim/evidence/2026-08-10-m1-ultra-gemma4/gemma4-host-10x.json
diff --git a/evidence/lume-metal-capability-shim/2026-08-10-m1-ultra-gemma4/gemma4-host-10x.stderr b/libs/lume/metal-capability-shim/evidence/2026-08-10-m1-ultra-gemma4/gemma4-host-10x.stderr
similarity index 100%
rename from evidence/lume-metal-capability-shim/2026-08-10-m1-ultra-gemma4/gemma4-host-10x.stderr
rename to libs/lume/metal-capability-shim/evidence/2026-08-10-m1-ultra-gemma4/gemma4-host-10x.stderr
diff --git a/evidence/lume-metal-capability-shim/2026-08-10-m1-ultra-gemma4/gemma4-safe-shim-10x.json b/libs/lume/metal-capability-shim/evidence/2026-08-10-m1-ultra-gemma4/gemma4-safe-shim-10x.json
similarity index 100%
rename from evidence/lume-metal-capability-shim/2026-08-10-m1-ultra-gemma4/gemma4-safe-shim-10x.json
rename to libs/lume/metal-capability-shim/evidence/2026-08-10-m1-ultra-gemma4/gemma4-safe-shim-10x.json
diff --git a/evidence/lume-metal-capability-shim/2026-08-10-m1-ultra-gemma4/gemma4-safe-shim-10x.stderr b/libs/lume/metal-capability-shim/evidence/2026-08-10-m1-ultra-gemma4/gemma4-safe-shim-10x.stderr
similarity index 100%
rename from evidence/lume-metal-capability-shim/2026-08-10-m1-ultra-gemma4/gemma4-safe-shim-10x.stderr
rename to libs/lume/metal-capability-shim/evidence/2026-08-10-m1-ultra-gemma4/gemma4-safe-shim-10x.stderr
diff --git a/evidence/lume-metal-capability-shim/2026-08-10-m1-ultra-gemma4/gemma4-stock-10x.json b/libs/lume/metal-capability-shim/evidence/2026-08-10-m1-ultra-gemma4/gemma4-stock-10x.json
similarity index 100%
rename from evidence/lume-metal-capability-shim/2026-08-10-m1-ultra-gemma4/gemma4-stock-10x.json
rename to libs/lume/metal-capability-shim/evidence/2026-08-10-m1-ultra-gemma4/gemma4-stock-10x.json
diff --git a/evidence/lume-metal-capability-shim/2026-08-10-m1-ultra-gemma4/gemma4-stock-10x.stderr b/libs/lume/metal-capability-shim/evidence/2026-08-10-m1-ultra-gemma4/gemma4-stock-10x.stderr
similarity index 100%
rename from evidence/lume-metal-capability-shim/2026-08-10-m1-ultra-gemma4/gemma4-stock-10x.stderr
rename to libs/lume/metal-capability-shim/evidence/2026-08-10-m1-ultra-gemma4/gemma4-stock-10x.stderr
diff --git a/evidence/lume-metal-capability-shim/2026-08-10-m1-ultra-gemma4/metadata.md b/libs/lume/metal-capability-shim/evidence/2026-08-10-m1-ultra-gemma4/metadata.md
similarity index 100%
rename from evidence/lume-metal-capability-shim/2026-08-10-m1-ultra-gemma4/metadata.md
rename to libs/lume/metal-capability-shim/evidence/2026-08-10-m1-ultra-gemma4/metadata.md
diff --git a/evidence/lume-metal-capability-shim/2026-08-10-m1-ultra-gemma4/results.csv b/libs/lume/metal-capability-shim/evidence/2026-08-10-m1-ultra-gemma4/results.csv
similarity index 100%
rename from evidence/lume-metal-capability-shim/2026-08-10-m1-ultra-gemma4/results.csv
rename to libs/lume/metal-capability-shim/evidence/2026-08-10-m1-ultra-gemma4/results.csv
diff --git a/evidence/lume-metal-capability-shim/2026-08-11-m1-ultra-muse-glimmer-64g/README.md b/libs/lume/metal-capability-shim/evidence/2026-08-11-m1-ultra-muse-glimmer-64g/README.md
similarity index 100%
rename from evidence/lume-metal-capability-shim/2026-08-11-m1-ultra-muse-glimmer-64g/README.md
rename to libs/lume/metal-capability-shim/evidence/2026-08-11-m1-ultra-muse-glimmer-64g/README.md
diff --git a/evidence/lume-metal-capability-shim/2026-08-11-m1-ultra-muse-glimmer-64g/SHA256SUMS b/libs/lume/metal-capability-shim/evidence/2026-08-11-m1-ultra-muse-glimmer-64g/SHA256SUMS
similarity index 100%
rename from evidence/lume-metal-capability-shim/2026-08-11-m1-ultra-muse-glimmer-64g/SHA256SUMS
rename to libs/lume/metal-capability-shim/evidence/2026-08-11-m1-ultra-muse-glimmer-64g/SHA256SUMS
diff --git a/evidence/lume-metal-capability-shim/2026-08-11-m1-ultra-muse-glimmer-64g/clean-stock-pp512.json b/libs/lume/metal-capability-shim/evidence/2026-08-11-m1-ultra-muse-glimmer-64g/clean-stock-pp512.json
similarity index 100%
rename from evidence/lume-metal-capability-shim/2026-08-11-m1-ultra-muse-glimmer-64g/clean-stock-pp512.json
rename to libs/lume/metal-capability-shim/evidence/2026-08-11-m1-ultra-muse-glimmer-64g/clean-stock-pp512.json
diff --git a/evidence/lume-metal-capability-shim/2026-08-11-m1-ultra-muse-glimmer-64g/clean-stock-pp512.stderr b/libs/lume/metal-capability-shim/evidence/2026-08-11-m1-ultra-muse-glimmer-64g/clean-stock-pp512.stderr
similarity index 100%
rename from evidence/lume-metal-capability-shim/2026-08-11-m1-ultra-muse-glimmer-64g/clean-stock-pp512.stderr
rename to libs/lume/metal-capability-shim/evidence/2026-08-11-m1-ultra-muse-glimmer-64g/clean-stock-pp512.stderr
diff --git a/evidence/lume-metal-capability-shim/2026-08-11-m1-ultra-muse-glimmer-64g/clean-stock-tg128.json b/libs/lume/metal-capability-shim/evidence/2026-08-11-m1-ultra-muse-glimmer-64g/clean-stock-tg128.json
similarity index 100%
rename from evidence/lume-metal-capability-shim/2026-08-11-m1-ultra-muse-glimmer-64g/clean-stock-tg128.json
rename to libs/lume/metal-capability-shim/evidence/2026-08-11-m1-ultra-muse-glimmer-64g/clean-stock-tg128.json
diff --git a/evidence/lume-metal-capability-shim/2026-08-11-m1-ultra-muse-glimmer-64g/clean-stock-tg128.stderr b/libs/lume/metal-capability-shim/evidence/2026-08-11-m1-ultra-muse-glimmer-64g/clean-stock-tg128.stderr
similarity index 100%
rename from evidence/lume-metal-capability-shim/2026-08-11-m1-ultra-muse-glimmer-64g/clean-stock-tg128.stderr
rename to libs/lume/metal-capability-shim/evidence/2026-08-11-m1-ultra-muse-glimmer-64g/clean-stock-tg128.stderr
diff --git a/evidence/lume-metal-capability-shim/2026-08-11-m1-ultra-muse-glimmer-64g/clean-unlocked-pp512.json b/libs/lume/metal-capability-shim/evidence/2026-08-11-m1-ultra-muse-glimmer-64g/clean-unlocked-pp512.json
similarity index 100%
rename from evidence/lume-metal-capability-shim/2026-08-11-m1-ultra-muse-glimmer-64g/clean-unlocked-pp512.json
rename to libs/lume/metal-capability-shim/evidence/2026-08-11-m1-ultra-muse-glimmer-64g/clean-unlocked-pp512.json
diff --git a/evidence/lume-metal-capability-shim/2026-08-11-m1-ultra-muse-glimmer-64g/clean-unlocked-pp512.stderr b/libs/lume/metal-capability-shim/evidence/2026-08-11-m1-ultra-muse-glimmer-64g/clean-unlocked-pp512.stderr
similarity index 100%
rename from evidence/lume-metal-capability-shim/2026-08-11-m1-ultra-muse-glimmer-64g/clean-unlocked-pp512.stderr
rename to libs/lume/metal-capability-shim/evidence/2026-08-11-m1-ultra-muse-glimmer-64g/clean-unlocked-pp512.stderr
diff --git a/evidence/lume-metal-capability-shim/2026-08-11-m1-ultra-muse-glimmer-64g/clean-unlocked-tg128.json b/libs/lume/metal-capability-shim/evidence/2026-08-11-m1-ultra-muse-glimmer-64g/clean-unlocked-tg128.json
similarity index 100%
rename from evidence/lume-metal-capability-shim/2026-08-11-m1-ultra-muse-glimmer-64g/clean-unlocked-tg128.json
rename to libs/lume/metal-capability-shim/evidence/2026-08-11-m1-ultra-muse-glimmer-64g/clean-unlocked-tg128.json
diff --git a/evidence/lume-metal-capability-shim/2026-08-11-m1-ultra-muse-glimmer-64g/clean-unlocked-tg128.stderr b/libs/lume/metal-capability-shim/evidence/2026-08-11-m1-ultra-muse-glimmer-64g/clean-unlocked-tg128.stderr
similarity index 100%
rename from evidence/lume-metal-capability-shim/2026-08-11-m1-ultra-muse-glimmer-64g/clean-unlocked-tg128.stderr
rename to libs/lume/metal-capability-shim/evidence/2026-08-11-m1-ultra-muse-glimmer-64g/clean-unlocked-tg128.stderr
diff --git a/evidence/lume-metal-capability-shim/2026-08-11-m1-ultra-muse-glimmer-64g/metadata.md b/libs/lume/metal-capability-shim/evidence/2026-08-11-m1-ultra-muse-glimmer-64g/metadata.md
similarity index 100%
rename from evidence/lume-metal-capability-shim/2026-08-11-m1-ultra-muse-glimmer-64g/metadata.md
rename to libs/lume/metal-capability-shim/evidence/2026-08-11-m1-ultra-muse-glimmer-64g/metadata.md
diff --git a/evidence/lume-metal-capability-shim/2026-08-11-m1-ultra-muse-glimmer-64g/results.csv b/libs/lume/metal-capability-shim/evidence/2026-08-11-m1-ultra-muse-glimmer-64g/results.csv
similarity index 100%
rename from evidence/lume-metal-capability-shim/2026-08-11-m1-ultra-muse-glimmer-64g/results.csv
rename to libs/lume/metal-capability-shim/evidence/2026-08-11-m1-ultra-muse-glimmer-64g/results.csv
diff --git a/evidence/lume-metal-capability-shim/2026-08-11-m1-ultra-muse-glimmer-64g/telemetry.csv b/libs/lume/metal-capability-shim/evidence/2026-08-11-m1-ultra-muse-glimmer-64g/telemetry.csv
similarity index 100%
rename from evidence/lume-metal-capability-shim/2026-08-11-m1-ultra-muse-glimmer-64g/telemetry.csv
rename to libs/lume/metal-capability-shim/evidence/2026-08-11-m1-ultra-muse-glimmer-64g/telemetry.csv
diff --git a/libs/spaces-sdk-swift/README.md b/libs/spaces-sdk-swift/README.md
index 31dee19072..07917fb71a 100644
--- a/libs/spaces-sdk-swift/README.md
+++ b/libs/spaces-sdk-swift/README.md
@@ -8,7 +8,7 @@ The package is MIT. The live screen (`CuaSpacesStreaming`: stream sessions,
H.264 decode, interactive input, presence cursors and the SwiftUI stream
views) is part of Cua Spaces and lives in
[`libs/spaces-app-swift`](../spaces-app-swift), source-available under
-FSL-1.1-MIT. See [LICENSING.md](../../LICENSING.md).
+FSL-1.1-MIT. See [LICENSING.md](../../legal/LICENSING.md).
It is a **thin overlay on the generated cua SDK** ([`libs/cua/swift`](../cua/swift),
product `Cua`). Every call runs the Rust `cua-spaces` implementation, either in
@@ -39,10 +39,10 @@ _ = try await run.delete()
This SDK was not designed and then validated. It was **extracted**. A full
product,
-[`samples/openkoalabot-example-swift`](../../samples/openkoalabot-example-swift), was built
+[`examples/openkoalabot-example-swift`](../../examples/openkoalabot-example-swift), was built
against the raw Spaces protocol first, and every place the protocol forced an
awkward shape on the app was written down as it happened. That log,
-[`samples/openkoalabot-example-swift/FRICTION.md`](../../samples/openkoalabot-example-swift/FRICTION.md), has
+[`examples/openkoalabot-example-swift/FRICTION.md`](../../examples/openkoalabot-example-swift/FRICTION.md), has
46 entries, and it is the requirements document for this package. OpenKoalaBots
now consumes the SDK instead of its own binding.
diff --git a/libs/spaces-sdk-swift/Sources/CuaSpaces/AgentTypes.swift b/libs/spaces-sdk-swift/Sources/CuaSpaces/AgentTypes.swift
index 542c68e8d1..4bf4aa68c0 100644
--- a/libs/spaces-sdk-swift/Sources/CuaSpaces/AgentTypes.swift
+++ b/libs/spaces-sdk-swift/Sources/CuaSpaces/AgentTypes.swift
@@ -413,7 +413,7 @@ public struct AgentStartRequest: Sendable, Hashable {
/// likewise defaults true server-side, so an older server that does not
/// know the key behaves as it always did.
///
- /// See `samples/openkoalabots/FRICTION.md` §54.
+ /// See `examples/openkoalabots/FRICTION.md` §54.
public var showsWindow: Bool
/// How long the **server** should let this run live.
diff --git a/libs/spaces-sdk-swift/Sources/CuaSpaces/Transport.swift b/libs/spaces-sdk-swift/Sources/CuaSpaces/Transport.swift
index b05c48a869..879f6ea105 100644
--- a/libs/spaces-sdk-swift/Sources/CuaSpaces/Transport.swift
+++ b/libs/spaces-sdk-swift/Sources/CuaSpaces/Transport.swift
@@ -126,7 +126,7 @@ extension SpacesError {
/// This lived in the app's own MCP client until the SDK absorbed the
/// transport. It belongs here: a counter that only saw the app's calls could
/// not see the SDK's, and after the extraction nearly every call is the SDK's.
-/// `samples/openkoalabots/FRICTION.md` §51.
+/// `examples/openkoalabots/FRICTION.md` §51.
public enum SpacesCallCounter {
private static let lock = NSLock()
nonisolated(unsafe) private static var counts: [String: Int] = [:]
diff --git a/libs/spaces-sdk-swift/Sources/CuaSpacesTranscript/README.md b/libs/spaces-sdk-swift/Sources/CuaSpacesTranscript/README.md
index e78a86b1cd..f9ee43707d 100644
--- a/libs/spaces-sdk-swift/Sources/CuaSpacesTranscript/README.md
+++ b/libs/spaces-sdk-swift/Sources/CuaSpacesTranscript/README.md
@@ -5,7 +5,7 @@ Terminal scrollback in, structured UI out.
`AgentTypes.swift` carries `output_tail`: the Spaces harness publishes what the
agent's terminal looks like, not what the agent did. Every proposal for
`agent.events` is blocked on that, and
-[`samples/openkoalabot-example-swift/FRICTION.md`](../../../../samples/openkoalabot-example-swift/FRICTION.md) §19 and
+[`examples/openkoalabot-example-swift/FRICTION.md`](../../../../examples/openkoalabot-example-swift/FRICTION.md) §19 and
§20 predicted the consequence: one undifferentiated text stream with no turn
boundary, so every app writes its own parser and they all guess differently.
@@ -90,4 +90,4 @@ CUA_TRANSCRIPT_RECORD=1 swift test --filter GoldenTests
Read every changed file before committing it. Re-blessing without reading the
diff defeats the mechanism.
-To re-record against a newer CLI, see [`tools/cli-cast/`](../../../../tools/cli-cast/README.md).
+To re-record against a newer CLI, see [`scripts/cli-cast/`](../../../../scripts/cli-cast/README.md).
diff --git a/pyproject.toml b/pyproject.toml
index 321d70cb42..238cae2d21 100644
--- a/pyproject.toml
+++ b/pyproject.toml
@@ -114,6 +114,26 @@ strict = true
warn_return_any = true
warn_unused_ignores = false
+[tool.pyright]
+include = ["**/*.py"]
+exclude = [
+ "**/node_modules/**",
+ "**/__pycache__/**",
+ "**/.*/**",
+ "**/venv/**",
+ "**/.venv/**",
+ "**/dist/**",
+ "**/build/**",
+ ".pdm-build/**",
+ "**/.git/**",
+ "logs/**",
+ "screenshots/**",
+]
+typeCheckingMode = "basic"
+useLibraryCodeForTypes = true
+reportMissingImports = false
+reportMissingModuleSource = false
+
[tool.isort]
profile = "black"
py_version = 312
diff --git a/pyrightconfig.json b/pyrightconfig.json
deleted file mode 100644
index 6130d72532..0000000000
--- a/pyrightconfig.json
+++ /dev/null
@@ -1,20 +0,0 @@
-{
- "include": ["**/*.py"],
- "exclude": [
- "**/node_modules/**",
- "**/__pycache__/**",
- "**/.*/**",
- "**/venv/**",
- "**/.venv/**",
- "**/dist/**",
- "**/build/**",
- ".pdm-build/**",
- "**/.git/**",
- "logs/**",
- "screenshots/**"
- ],
- "typeCheckingMode": "basic",
- "useLibraryCodeForTypes": true,
- "reportMissingImports": false,
- "reportMissingModuleSource": false
-}
diff --git a/samples/README.md b/samples/README.md
index 69b5bc31c3..035361c0f4 100644
--- a/samples/README.md
+++ b/samples/README.md
@@ -1,22 +1 @@
-# Samples
-
-| Sample | What it is |
-|---|---|
-| [`cua-bots-macos`](cua-bots-macos) | Cua Bots for macOS: persistent bots, each with a koala face, its own Space, a memory in the Cua Volume layout, routines, approvals, custom rules and saved sign-ins. SwiftUI on the Cua Swift SDK and the Cua Spaces app export. The featured example; source-available (FSL-1.1-MIT) |
-| [`cua-bots-ios`](cua-bots-ios) | Cua Bots for iPhone: a remote client for the Mac's bots; chat, watch and take over their computers, answer approvals, get notifications. Source-available (FSL-1.1-MIT) |
-| [`openkoalabot-example-swift`](openkoalabot-example-swift) | OpenKoalaBots, a chat app for agent coworkers on Cua Spaces: a SwiftUI app on the `Cua` package via the Swift overlay [`libs/spaces-sdk-swift`](../libs/spaces-sdk-swift) and `CuaSpacesStreaming` ([`libs/spaces-app-swift`](../libs/spaces-app-swift)). The first of the three; its 209-test suite and `RUBRIC.md` are the behaviour spec. Source-available (FSL-1.1-MIT) |
-| [`openkoalabot-example-tauri`](openkoalabot-example-tauri) | The same app as a Rust core on the `cua-spaces` crate, with a Tauri 2 + React shell |
-| [`openkoalabot-example-ts`](openkoalabot-example-ts) | The same app in TypeScript on `@trycua/cua`: a Node agent loop, a local server, and a web UI that streams through `@trycua/cua/browser` (gRPC-Web + the ticketed `/media` socket) and WebCodecs |
-| [`openkoalabot-example-scenario`](openkoalabot-example-scenario) | The shared, language-neutral scenario all three run headlessly: add or claim a Space, stream, run an agent thread (fake CLI), send a file, teleport a generated profile, run presence with two clients, release |
-| [`infinite-canvas-swift`](infinite-canvas-swift) | infinite-canvas: every window of every Space on one zoomable canvas, with agent and coworker cursors and agent threads. SwiftUI and AppKit on the Cua Swift packages. Source-available (FSL-1.1-MIT) |
-| [`driver`](driver) | cua-driver samples |
-| [`python`](python) | Python samples |
-
-Run all three OpenKoalaBots samples against the same Space kinds:
-
-```sh
-samples/openkoalabot-example-scenario/run.sh --impl all --lane fixture # hermetic
-samples/openkoalabot-example-scenario/run.sh --impl all --lane docker # linux under gVisor, one container at a time
-```
-
-Each implementation's README has its build, test and run commands.
+The samples moved to [examples/](../examples/). Old links to `samples/<name>` land on a stub that points to `examples/<name>`.
diff --git a/samples/cua-bots-ios/README.md b/samples/cua-bots-ios/README.md
index 8019f1465f..31a8b93c20 100644
--- a/samples/cua-bots-ios/README.md
+++ b/samples/cua-bots-ios/README.md
@@ -1,68 +1 @@
-# Cua Bots (iPhone)
-
-The iPhone companion to [`../cua-bots-macos`](../cua-bots-macos): chat with
-your bots, watch and take over their computers, answer approvals, and get
-their notifications. It is a remote client: bots are created and run by the
-Mac app, and the phone reaches each bot's own Space.
-
-It builds on the macOS sample's package, which links Cua Spaces pieces, so it
-is source-available under the [FSL-1.1-MIT](LICENSE) too. See
-[LICENSING.md](../../LICENSING.md).
-
-![Approving a purchase from the phone](../../docs/public/img/cua-bots/cua-bots-phone-approval.png)
-
-## How it connects
-
-The phone talks to the bot's Space through that Space's spacesd, with the Cua
-Swift SDK:
-
-| Need | Call |
-|---|---|
-| Reach the bot's computer | `Relay(relayUrl:accountToken:).connect(machineId:)` over the relay, or `Cua.spacesd(url:token:)` directly |
-| Find the bots in it | `SpacesdClient.sh` lists `~/bots/*/` |
-| Read the bot's state | `SpacesdClient.download(path:)` of `~/bots/<name>/.cua-bots/state.json`, which the Mac app writes |
-| Send a message, approve, pause, resume | `SpacesdClient.upload(path:data:options:)` into `~/bots/<name>/.cua-bots/outbox/`; the Mac applies it through the same calls its buttons make |
-| Stream its computer | `SpacesdClient.openMediaDecoded(options:frames:)` (BGRA frames, from `CuaSpacesFFI`) |
-| Take over | `SpacesdClient.click(x:y:)` and `typeText(text:)`: on the phone the computer opens in your control |
-| Notifications | new entries in the snapshot become local notifications |
-
-On the Mac, a bot's profile menu has **Pair iPhone**, which gives a
-`cuabots://direct?...` link for that bot's Space. On the same Mac (the iOS
-Simulator) the loopback address works.
-
-## Build
-
-The package (`CuaBotsRemote`, `CuaBotsPhone`) builds and tests on macOS:
-
-```sh
-(cd ../../libs/cua && cargo build --locked --release -p cua-sdk && node scripts/stage-uniffi-library.mjs --only=swift)
-swift build && scripts/test.sh
-```
-
-The iPhone app target is `App/` with an XcodeGen spec (`project.yml`). It needs
-Xcode 16 and the cua SDK XCFramework with iOS slices:
-
-```sh
-(cd ../../libs/cua/swift && scripts/build-xcframework.sh --ios)
-CUA_SWIFT_XCFRAMEWORK=build/CuaSDKFFI.xcframework xcodegen generate
-xcodebuild -scheme CuaBots -destination 'platform=iOS Simulator,name=iPhone 16' build
-```
-
-Without Xcode, `CuaBotsPhonePreview` shows the same screens in a phone-sized
-Mac window against a real bot (`CUA_BOTS_PREVIEW_SPACE=local:bot-ada`).
-
-## Gaps
-
-- **Reaching a bot from anywhere.** The relay publishes machines registered
- with `cua host setup`; the SDK has no call to register a bot's own Space as
- a relay machine, so a phone off the Mac's network can't reach it yet.
-- **State through the Space.** The snapshot and outbox live in the bot's
- Space because the Cua Volume isn't reachable from a phone yet. With a cloud
- Volume they move to `agents/<name>/`.
-- **Push.** Notifications arrive while the app is open; background push needs
- a notification service.
-- **Keyvault.** Saved sign-ins are approved on the Mac (a Cua-signed app with
- Touch ID); the phone offers take over instead.
-- **iOS SDK builds.** The cua SDK's iOS XCFramework slices are not exercised in
- CI, and `spaces-sdk-swift` (the Mac's streaming views) is macOS only, so the
- phone draws frames itself.
+This sample moved to [examples/cua-bots-ios](../../examples/cua-bots-ios).
diff --git a/samples/cua-bots-macos/README.md b/samples/cua-bots-macos/README.md
index a2c106382d..93bb4fe741 100644
--- a/samples/cua-bots-macos/README.md
+++ b/samples/cua-bots-macos/README.md
@@ -1,110 +1 @@
-# Cua Bots (macOS)
-
-Persistent bots on Cua: each bot has a name, a koala face you design, its own
-computer (a Space), a memory that outlives that computer (Cua Volume), work it
-does on its own (routines), and rules for when it must ask you first. A
-SwiftUI app on the Cua Swift SDK (`Cua`, `CuaSpaces`) and the Cua Spaces
-Swift packages (`CuaSpacesFFI`, for saved sign-ins through the Cua Keyvault,
-and `CuaSpacesStreaming`, for the live view of a bot's computer). Its
-iPhone companion is [`../cua-bots-ios`](../cua-bots-ios).
-
-The sample links Cua Spaces pieces, so it is source-available under the
-[Functional Source License, Version 1.1, MIT Future License](LICENSE)
-(FSL-1.1-MIT), like Cua Spaces itself. See [LICENSING.md](../../LICENSING.md).
-
-![Ada finished some research while you were away](../../docs/public/img/cua-bots/cua-bots-mac-research-ready.png)
-
-## Quick start
-
-```sh
-git clone https://github.com/trycua/cua && cd cua
-(cd libs/cua && cargo build --locked --release -p cua-spaces-ffi)
-libs/spaces-app-swift/scripts/stage-library.sh
-cd samples/cua-bots-macos
-swift build && .build/debug/CuaBots
-```
-
-`stage-library.sh` stages the Cua Spaces app export, which carries the MIT
-cua SDK too, where the Swift packages link it.
-
-A bot's agent needs a model key in the app's environment
-(`ANTHROPIC_API_KEY` for Claude Code, `OPENAI_API_KEY` for Codex; Hermes and
-OpenClaw take either). `CUA_BOTS_MODEL_URL`, `CUA_BOTS_MODEL` and
-`CUA_BOTS_MODEL_KEY_VARS` point every bot at another endpoint.
-`CUA_BOTS_OWNER` and `CUA_BOTS_DEVICE_NAME` set the name the bots use for you
-and the name shown for this Mac (default: your account and computer names).
-`CUA_BOTS_APPEARANCE=light` or `dark` pins the app's appearance (light is the
-design target; unset follows the system). Local Spaces
-need Docker (or Colima).
-
-## What maps to what
-
-| In the app | Cua underneath |
-|---|---|
-| New bot: name, look, where it runs, which agent | `Spaces.create` (`on: local` or `cloud`, `reuse`), one Space per bot named `bot-<name>`; `Space.agentStart` with the harness (`hermes`, `openclaw`, `openai-codex`, `claude-code`) |
-| The koala face and its expressions | `KoalaAvatar` (this sample), drawn from geometry derived from the Cua koala mark |
-| "Ada's computer", live, with picture in picture | `LiveStreamSession` and `StreamPiPController` (`CuaSpacesStreaming`) on the bot's Space |
-| Ada has control · Take over | the stream turns interactive and `agentInterrupt` pauses the turn |
-| Ada's face as her pointer | `SpacesdClient.cursorPosition()` |
-| Memory, outputs, inbox | Cua Volume layout `agents/<name>/` (`memory/MEMORY.md`, `outputs/`, `inbox/`), copied into the Space before a turn and back after it |
-| Works on its own | scheduled tasks on the SDK's routine clock (`RoutineStore`) |
-| Approvals and custom rules | `rules.yaml` and the instructions file in the bot's Volume home; the bot asks with `[[ask: ...]]`, the app answers in the conversation |
-| Log me into this site | `[[login: site]]`; a saved sign-in from the Cua Keyvault (`KeyvaultClient` from `CuaSpacesFFI`, `Space.teleport`), or take over and type it yourself |
-| Access to this Mac: Allow, Revoke | `Host.startSharing` / `Host.stopSharing` (`cua host`) |
-| Pause, Resume, Reset | interrupt the run and disarm routines (optionally `Sandbox.suspend`); reset stops the run, deletes the Space and the Volume home |
-| The iPhone app | the bot's snapshot and an outbox in its Space, read and written through spacesd (`RemoteBridge`) |
-
-## How a bot talks to the app
-
-The app writes the bot's standing instructions (`CLAUDE.md`, `SOUL.md` or
-`AGENTS.md`) into its home. They teach a few markers the app turns into UI and
-hides from the text:
-
-```text
-[[status: Checking inbox]] status under its name
-[[step: Read the docs]] [[step-done: ...]] Activity
-[[ask: Buy the desk | details]] an approval card
-[[handoff: Change the bank password]] you do it yourself
-[[login: github.com]] the sign-in card
-[[output: outputs/summary.md]] Outputs
-[[notify: Your research is ready | one line]] a notification
-[[schedule: daily 09:00 | title | what to do]] a routine
-[[done: Research standing desks]] a result card
-```
-
-The rules are instructions, not enforcement: the harness runs with its
-permissions auto-approved inside the bot's own Space. See the gaps below.
-
-## Tests and screenshots
-
-```sh
-scripts/test.sh # unit tests (swift-testing)
-scripts/capture.sh <out-dir> [<scratch-home>] [--phone]
-```
-
-`capture.sh` runs the app in a throwaway `HOME` with the file credential
-store, against a real local Space, with the scripted mock provider
-(`cua-mock-llm`, `scripts/demo-model.json`) behind the real harness. It
-photographs each surface with `screencapture -l` and deletes the Spaces it
-made. With `--phone` it also photographs the iPhone screens (in the macOS
-preview host) against the same bot.
-
-## Gaps
-
-What the sample does with today's primitives, and what needs core work:
-
-- Rules are guidance: agent runs auto-approve their own permissions. Enforced
- approvals need the runner to route permission requests to the app.
-- The Volume is a folder in the app's data (`LocalVolume`) with the Cua
- Volume layout and secret refusal. The SDK's `Spaces.volumeRead`,
- `volumeWrite` and `volumeLs` reach the daemon's Cua Volume; the app doesn't
- sync through them yet.
-- The routine clock runs in the app, so routines fire while it's open.
-- The app runs each bot with `Space.agentStart` and copies its home in and
- out itself. The SDK's persistent agents (`Spaces.persistentAgentCreate`,
- `persistentAgentSend`, `agentPause`, `agentResume`, `routineAdd`,
- `notifications`) keep the home in the Cua Volume, with saves, routines and
- notifications run by `cua daemon`; the app doesn't use them yet.
-- Host access is per account, not per bot.
-- Saved sign-ins need the Cua daemon's Keyvault and a Cua-signed app to
- approve; this sample's build shows the request and falls back to take over.
+This sample moved to [examples/cua-bots-macos](../../examples/cua-bots-macos).
diff --git a/samples/driver/README.md b/samples/driver/README.md
new file mode 100644
index 0000000000..0b089ff533
--- /dev/null
+++ b/samples/driver/README.md
@@ -0,0 +1 @@
+This sample moved to [examples/driver](../../examples/driver).
diff --git a/samples/infinite-canvas-swift/README.md b/samples/infinite-canvas-swift/README.md
index 23bc5d3bdb..705bf8c028 100644
--- a/samples/infinite-canvas-swift/README.md
+++ b/samples/infinite-canvas-swift/README.md
@@ -1,152 +1 @@
-# infinite-canvas (Swift)
-
-Every window of every Space on one zoomable canvas. A global hotkey opens it;
-each window is a live tile you can move, resize, zoom into and use. Agent and
-coworker cursors show up over the windows they act in, and agent threads are
-canvas windows of their own. Inspired by Zsolt Kacso's
-[infinite canvas for Omarchy](https://x.com/kaolti/status/2103257208616104111).
-
-SwiftUI and AppKit on the Cua Swift packages (`Cua`, `CuaSpaces`,
-`CuaSpacesStreaming`), macOS 26 (Liquid Glass).
-
-The sample links Cua Spaces pieces (`CuaSpacesStreaming`, in
-[`libs/spaces-app-swift`](../../libs/spaces-app-swift)), so it is
-source-available under the
-[Functional Source License, Version 1.1, MIT Future License](LICENSE)
-(FSL-1.1-MIT), like Cua Spaces itself. See [LICENSING.md](../../LICENSING.md).
-
-## Run
-
-```sh
-(cd ../../libs/cua && cargo build --release -p cua-sdk && node scripts/stage-uniffi-library.mjs --only=swift)
-swift build -c release
-.build/release/infinite-canvas --spaces spaces.json --show
-```
-
-`spaces.json`:
-
-```json
-{
- "spaces": [
- {"label": "macOS", "os": "macos", "url": "http://192.168.64.2:3211", "token": "…", "maxWindows": 4,
- "apps": ["Calculator", "TextEdit"]},
- {"label": "Linux", "os": "linux", "url": "127.0.0.1:3211", "token": "…", "maxWindows": 4,
- "agent": {"harness": "claude-code", "env": {"ANTHROPIC_API_KEY": "…"}}}
- ],
- "threads": ["Linux"]
-}
-```
-
-Every Space is an existing machine running cua-spacesd, added to a throwaway
-registry (`--registry DIR`, default a temp directory; `~/.cua` is never read
-or written). The canvas never creates or deletes a Space.
-
-| Flag | |
-|---|---|
-| `--hotkey option+space` | the global hotkey (Carbon, no Accessibility permission) |
-| `--show` | open at launch |
-| `--windowed 1600x1000` | a normal window instead of the full-screen overlay |
-| `--chromeless` | with `--windowed`: borderless, for window-only recordings |
-| `--control SOCKET` | a local control socket for scripted runs (0600) |
-| `--synthetic N` | N local H.264 test-pattern tiles (benchmark and tests only) |
-| `--perf-hud` | tiles decoding and frames requested, in the status pill |
-
-Keys: the hotkey hides, Return zooms into the selected tile, ⌘0 fits all,
-Esc steps back (search, then focus, then the overlay), typing searches window
-titles and Tab moves between matches. Click a tile to give it input; drag it
-by its title or while unfocused; resize from its bottom-right corner.
-
-## Architecture
-
-| Target | What it is |
-|---|---|
-| `CanvasModel` | Pure value types, no AppKit or SDK: `Camera` (zoom about a point, fitting, van Wijk smooth flights), `CanvasLayout` (tiles, z order, aspect-locked resize, justified-row arrangement), `LODPolicy`/`LODState` (tiers with hysteresis and a downgrade hold), `OverlayState` (hotkey toggling, debounce, reversal), `PresenceDirectory` (members, thread bindings, styles from the SDK's presence colors), `CursorGlide` (critically damped spring), `HumanPath` (a person's pointer path and typing cadence), `HoverInfo`, `StreamErrorMessage`, `FrameStats` |
-| `CanvasStreaming` | One tile's pipeline: `SpaceMediaSource` (a cua SDK `SpaceStreamSession` on one window), `TileDecoder` (VideoToolbox, hardware required, NV12 IOSurfaces, enqueued straight into an `AVSampleBufferDisplayLayer`), `TileStream` (level of detail applied as the media socket's `set_stream_preferences`, keyframe requests, ping latency, fps), `SyntheticMediaSource` (a local H.264 test pattern), `ProcessMetrics` |
-| `InfiniteCanvasApp` | The overlay window and hotkey, `CanvasScrollView` (the world is a huge layer-backed `NSScrollView` document; tiles are subviews at fixed world positions), tile views, the agent cursor (Cua Driver's `cua.default.lottie`, read and drawn natively), agent threads over ACP (`SpacesdClient.agents()`), presence (`SpacePresence` + the SDK's `PresenceRoster`), app icons fetched from each Space, the HUD, the control socket and the perf sweep |
-| `CanvasBench` | `canvas-bench`: the model's hot paths and the decode pipeline, headless |
-
-Performance design:
-
-- Pan and zoom are the scroll view's own, on the compositor: a gesture changes
- one clip-view bounds. No tile moves, no layout runs, no SwiftUI view
- updates per frame. The HUD reads a camera copy refreshed at most 20 times a
- second.
-- Frames never touch the main thread or SwiftUI: SDK delivery thread, then
- VideoToolbox, then the display layer's renderer.
-- Level of detail per tile from its drawn size: paused (off screen: 1 fps at
- 160 px from the Space, not decoded), thumbnail (4 fps, 360 px), low (12,
- 720), medium (30, 1280), full (60, 2560, or when focused). Upgrades are
- immediate and ask for a keyframe; downgrades wait 450 ms and need an 18%
- margin. While the overlay is hidden everything is paused.
-- A thread window (SwiftUI) is swapped for a bitmap of itself while the zoom
- changes and restored 200 ms after.
-- `os_signpost` intervals under `ai.cua.infinite-canvas`: `decode`, `tick`,
- `sweep`, and `tier` events.
-
-## Performance
-
-Measured on an M5 Max, 120 Hz ProMotion display, release build, a 1440x810 pt
-window. The sweep is the control socket's `perf` command: 20 or 30 s of
-pan (Lissajous) and log-scale zoom (overview to 140%) driven once per display
-frame, which crosses every level-of-detail transition. Frame times are the
-display link's intervals.
-
-| Run | fps | late (>12.5 ms) | worst frame | main thread | process CPU | GPU (mean / max) | memory |
-|---|---|---|---|---|---|---|---|
-| 8 live tiles (4 macOS, 4 Linux), 20 s | 119.9 | 1 | 20.8 ms | 10% | 12% | 26% / 42% | 229 MB |
-| 10 live tiles (+2 Omarchy), 30 s | 119.3 | 5 | 166 ms | 17% | 23% | 1% / 38% | 234 MB |
-| 8 live tiles before the thread-window freeze | 117.5 | 19 | 170 ms | 50% | 54% | 28% / 44% | 239 MB |
-| 8 synthetic 60 fps tiles (debug build), 10 s | 119.7 | 2 | 23.8 ms | 13% | 64% (incl. encoding) | 25% / 35% | 270 MB |
-
-All tiles decoded in hardware in every run. Decode latency per frame (submit
-to output), live tiles: p50 0.6 to 1.2 ms, p95 1.4 to 2.6 ms. GPU is
-whole-machine utilization (IOAccelerator), so it includes the rest of the
-Mac. The 166 ms frame is the first freeze of the thread window (one bitmap
-render); CPU and memory are this process.
-
-`canvas-bench --tiles 8 --seconds 10` (release):
-
-| | |
-|---|---|
-| level of detail for 100 tiles | 1.1 µs per frame |
-| one camera flight sample | 19 ns |
-| arranging 60 tiles | 15 µs |
-| 8 tiles at full (60 fps asked) | 475 decoded fps, p50 0.59 ms, p95 0.76 ms, hardware, 149 MB |
-| 8 tiles at mixed tiers | 150 decoded fps, 47 MB |
-
-Instruments is not available on this machine (Command Line Tools only, no
-Xcode), so the numbers come from the app's own counters and signposts.
-
-## Presence
-
-- An agent's cursor points along its direction of travel (the driver
- overlay's convention: heading = travel + π, resting at π/4), low-passed so
- it does not jitter and eased back upright at rest; it pivots on the tip.
- People's pointers stay upright.
-- An agent's cursor is the Cua Driver default theme, tinted with the color
- the Space's presence service assigned it. Its thread window's avatar uses
- the same color (before the agent joins, the SDK's stable `presence_color`
- for the thread). Message bubbles are neutral.
-- Before the agent acts, its cursor waits as a glyph in the thread window's
- title; it glides out to the first window it acts in and home when the turn
- ends.
-- A harness that opens two MCP sessions gets two driver cursors; while one
- thread's turn runs in a Space, the second is drawn as the first.
-- People are a plain pointer in their color. `{"cmd": "coworker"}` on the
- control socket joins a second, human participant whose pointer follows
- `HumanPath` and whose click and typing are real `interactive_input`.
-
-## Tests
-
-```sh
-scripts/test.sh # 59 tests
-scripts/sync-cursor-assets.sh --check
-```
-
-Hermetic: the model, the tile pipeline on the local test pattern
-(VideoToolbox encode and decode), presence and dock logic, icon lookup and
-fallback, stream errors, and a UI smoke test in an offscreen window (frames
-present in hardware, a flight ends focused, level of detail pauses off-screen
-tiles, search selects, the hotkey presents and dismisses). Nothing connects
-to a Space. `snapshots/` holds images the suite writes (the stream error and
-the stats card).
+This sample moved to [examples/infinite-canvas-swift](../../examples/infinite-canvas-swift).
diff --git a/samples/openkoalabot-example-scenario/README.md b/samples/openkoalabot-example-scenario/README.md
index d2d8adde4c..91dd52caac 100644
--- a/samples/openkoalabot-example-scenario/README.md
+++ b/samples/openkoalabot-example-scenario/README.md
@@ -1,72 +1 @@
-# openkoalabots scenario
-
-One language-neutral scenario, `scenario.json`, that every openkoalabots
-implementation runs headlessly. The three implementations share it:
-[`openkoalabot-example-swift`](../openkoalabot-example-swift), [`openkoalabot-example-tauri`](../openkoalabot-example-tauri)
-and [`openkoalabot-example-ts`](../openkoalabot-example-ts). Each one runs the spec through its
-own app core, so a passing run shows that the app's code works against a
-real Space. The spec only fixes what must be true. Each language decides how
-its runner gets there.
-
-| Step | Operation | What must be true |
-|---|---|---|
-| `space` | add (`fixture`, `docker`) or create (`cloud`) a Space | the Space is registered in a **temp** registry after a capabilities handshake |
-| `stream` | desktop stream session | at least 1 frame arrives, the first frame is a keyframe, and a keyframe request produces another. Skipped when the Space lacks `desktop_stream` |
-| `agent` | agent thread with a **fake** `claude` CLI | turn 1 (`agent_start`) and turn 2 (`agent_message`, which resumes with `--continue`) both reach `idle`, and each output tail contains the expected line |
-| `file` | `send_file` of a generated 1 MiB file | the bytes come from the spec's xorshift64 generator, the local sha256 equals `sha256`, and the guest's own `sha256sum` agrees |
-| `teleport` | teleport `firefox` with an explicit approval callback | the profile is **generated** from `fixtures/firefox-profile.json` in a temp teleport home, and the run's marker is found in the guest |
-| `presence` | two independent SDK runtimes join | the operator sees Koala join, then sees its cursor move to (0.25, 0.75), then sees it leave; the SDK's presence roster, folded from those events, shows Koala's cursor and then drops Koala. The operator holds Koala's stable color, so the server assigns Koala another; the app's avatar color for Koala must equal that cursor color. Skipped without `presence` |
-| `routine` | the app's routine store and live runner | a routine not yet due does not fire; the real scheduler fires it once, as a real agent turn whose prompt starts `[routine] <title>:` and whose output has the scripted reply; another tick fires nothing; a reloaded store has the run id. Skipped without a model endpoint |
-| `group` | the app's group store and live messenger, two Bots | groups of 1 and 7 are refused; one message reaches both Bots, framed with the other's name; each Bot's reply is attributed to it once. Skipped without a model endpoint |
-| `delete` | delete the Space | always runs. A Space added by address is only removed from the registry; a created cloud Space is deleted |
-
-No step calls a real model or uses real credentials: agent turns run the real harness against `cua-mock-llm`, whose `mock:` directive in the prompt scripts the reply. No step reads `~/.cua`,
-`~/.claude`, `~/.codex`, a real browser profile or the keychain. No step
-opens a window.
-
-## Runner contract
-
-```
-<runner> --spec scenario.json --lane fixture|docker|cloud --out result.json
-```
-
-| Variable | Meaning |
-|---|---|
-| `OPENKOALABOTS_SCENARIO_URL`, `OPENKOALABOTS_SCENARIO_TOKEN` | the spacesd to add (`fixture`, `docker`) |
-| `OPENKOALABOTS_SCENARIO_IMPORT_ROOT` | `{importRoot}` in `teleport.verifyCommand`: the literal `$HOME` in a real guest, or the fixture's teleport import directory |
-| `OPENKOALABOTS_SCENARIO_MODEL_URL` | the model endpoint as the Space reaches it (`cua-mock-llm`); the runner forwards `ANTHROPIC_API_KEY` from its own environment. Unset: `routine` and `group` skip |
-| `OPENKOALABOTS_CLOUD_IMAGE` | `cloud` lane: the linux (spacesd) image to create in Cua Cloud. Credentials come from the usual environment (`cua auth login`) |
-
-The result is `{impl, lane, ok, totalMs, steps: [{id, status, ms, detail}]}`,
-where `status` is `pass`, `fail` or `skip`. A run is `ok` when no step failed.
-
-| Implementation | Runner |
-|---|---|
-| swift | `samples/openkoalabot-example-swift/.build/debug/OpenKoalaBotExample scenario …` |
-| tauri | `samples/openkoalabot-example-tauri/src-tauri/target/debug/openkoalabot-example-scenario …` |
-| ts | `node samples/openkoalabot-example-ts/dist/scenario/cli.js …` |
-
-## Lanes
-
-```sh
-# Hermetic: an in-process spacesd server core (libs/cua cua-test-fixtures), confined to a temp HOME and PATH.
-samples/openkoalabot-example-scenario/run.sh --impl all --lane fixture
-
-# A local linux image container under gVisor, --memory=4g, one at a time.
-samples/openkoalabot-example-scenario/run.sh --impl all --lane docker \
- [--image cua-e2e-local/linux:docker-local-arm64] [--runtime runsc]
-
-# Cua Cloud (gated): needs a linux (spacesd) image the cloud can pull.
-OPENKOALABOTS_CLOUD_IMAGE=ghcr.io/trycua/linux:24.04 \
- samples/openkoalabot-example-scenario/run.sh --impl all --lane cloud
-```
-
-`run.sh` writes `results/<impl>-<lane>.json` and prints an
-implementation × step matrix. Build the runners first; each implementation's
-README has the command.
-
-The `docker` lane also starts `cua-mock-llm` (`--memory=256m`, removed with the Space) and sets the model variables, so `routine` and `group` run real agent turns; the first turn installs the harness in the Space (about 30 s). Point `--mock-llm` at a Linux build of `cua-mock-llm` (`cargo zigbuild --release -p cua-mock-llm --target aarch64-unknown-linux-musl` in libs/cua).
-
-The `fixture` lane has no desktop, so `stream` reports `skip`, and no model, so `routine` and `group` skip. The spacesd
-server core runs on the host with a temp `HOME`, and `presence` and
-`teleport` run against it for real.
+This sample moved to [examples/openkoalabot-example-scenario](../../examples/openkoalabot-example-scenario).
diff --git a/samples/openkoalabot-example-swift/README.md b/samples/openkoalabot-example-swift/README.md
index 212f7abbb0..e5c9426b1c 100644
--- a/samples/openkoalabot-example-swift/README.md
+++ b/samples/openkoalabot-example-swift/README.md
@@ -1,336 +1 @@
-# OpenKoalaBots (Swift)
-
-The Swift sample of OpenKoalaBots (package `OpenKoalaBotExample`, macOS 14,
-SwiftPM). The app is called OpenKoalaBots.
-
-The sample links Cua Spaces pieces (`CuaSpacesStreaming`, in
-[`libs/spaces-app-swift`](../../libs/spaces-app-swift)), so it is
-source-available under the
-[Functional Source License, Version 1.1, MIT Future License](LICENSE)
-(FSL-1.1-MIT), like Cua Spaces itself. See [LICENSING.md](../../LICENSING.md).
-
-## Quick start
-
-```sh
-git clone https://github.com/trycua/cua && cd cua/samples/openkoalabot-example-swift
-(cd ../../libs/cua && cargo build --release -p cua-sdk && node scripts/stage-uniffi-library.mjs --only=swift)
-swift build && .build/debug/OpenKoalaBotExample
-```
-
-**Local workspace override.** `Package.swift` depends on
-`../../libs/spaces-sdk-swift`, `../../libs/spaces-app-swift` and
-`../../libs/cua/swift` by path, and the `Cua` package links the cua SDK dylib
-staged into `libs/cua/swift/lib` by the second command. That is how the sample
-is developed inside this repository. A copy taken on its own
-(`npx degit trycua/cua/samples/openkoalabot-example-swift`) needs those three
-packages next to it at the same relative paths, or the three
-`.package(path:)` lines pointed at your checkout of them.
-
-## About
-
-A modern desktop chat app for agent coworkers, built on Cua Spaces, used to derive the Spaces SDK by
-building a real app against the raw primitives. This is one of three
-implementations with the same behaviour. The other two are
-[`openkoalabot-example-tauri`](../openkoalabot-example-tauri) (Rust) and
-[`openkoalabot-example-ts`](../openkoalabot-example-ts) (TypeScript). All three run the shared
-headless scenario in [`openkoalabot-example-scenario`](../openkoalabot-example-scenario).
-
-- `RUBRIC.md`: what each rendered surface is checked against, and what is
- ungradeable by design.
-- `FRICTION.md`: every place the old Spaces MCP forced an awkward shape on the
- client, with the code that absorbed it. This was the design input for the SDK.
-
-## The SDK exists now, and this app consumes it
-
-The 46 entries in `FRICTION.md` were turned into
-[`libs/spaces-sdk-swift`](../../libs/spaces-sdk-swift) and
-[`libs/spaces-app-swift`](../../libs/spaces-app-swift). The hand-rolled MCP
-binding that used to be `Sources/OpenKoalaBotExample/Spaces/MCPSpacesClient.swift` now
-lives in the first as `CuaSpaces`, and the whole of
-`Sources/OpenKoalaBotExample/Streaming/` in the second as `CuaSpacesStreaming`
-(source-available, FSL-1.1-MIT). What is left in this sample is the app: its own view
-models, its roster and transcript stores, and `Spaces/SDKSpacesClient.swift`,
-which is the thin mapping from the SDK into this app's vocabulary.
-
-The SDK's README carries the entry-by-entry mapping, including the entries it
-deliberately does **not** absorb because they are app, platform or server
-problems rather than API ones.
-
-## Layers and status
-
-| Layer | Status |
-|---|---|
-| Spaces client (`Sources/OpenKoalaBotExample/Spaces/`, on `CuaSpaces`): sandboxes, agent threads, windows, files | **live**, e2e-tested against a real Space |
-| Screen export (`export <dir>`) | live; renders from `Model/Fixtures.swift` |
-| Live data layer (`Sources/OpenKoalaBotExample/Model/`): one Space, a roster of Bots, live transcripts | **live**, e2e-tested against a real Space |
-| Roster / transcript views | rendered from an injected `BotDataSource`: `FixtureDataSource` for export, `BotStore` at runtime |
-| Picture-in-picture: the desktop (the button on the stream) or one window (the pane's window list), each in a floating panel (`StreamPiPSet`) | **live**, `live-pip` and `PiPLiveTests` against a real Space |
-| One drop zone (`SpaceDropZone`): files dropped or picked with "Send file…" upload into the Space | live |
-
-App teleport (moving a host app or window into a Space) ships with Cua
-Spaces (source-available) and is not part of this sample.
-
-`presentScreen` is deliberately inert: the Spaces tools that display a Space
-(`show_space_pip`, `open_space_viewer`, `stream_space_window`) draw onto the
-*operator's* Mac. An in-app stream reads frames from the Space's media plane
-(`SpaceStreamProvider`) and belongs to the streaming layer. `capabilities.liveScreenPixels` reports `false` so nothing
-mistakes the placeholder for live pixels.
-
-## The runtime underneath
-
-`SDKSpacesClient` is built on the
-Swift overlay [`libs/spaces-sdk-swift`](../../libs/spaces-sdk-swift). The
-overlay sits on the generated `Cua` package, so every tool is the Rust
-`cua-spaces` implementation, reached in one of two ways:
-
-| `OPENKOALABOTS_SPACES` | Backend |
-|---|---|
-| unset | a running `cua daemon` if its discovery file exists, otherwise embedded (`Spaces.local()`) |
-| `daemon` | `SpacesConnection.daemon()`: `cua daemon`, shared by every process on the machine |
-| `embedded` | `SpacesConnection.embedded()`: the runtime in this process. `OPENKOALABOTS_SPACES_HOME` moves its registry off `~/.cua` |
-
-The app streams through `SpaceStreamProvider`: a Space is its own stream
-source.
-
-## The app window
-
-One opaque window (no materials, light and dark): a sidebar with the Bots,
-routines and group chats, a centred conversation column, and the Agent
-Computer pane on the right when it is open. An empty conversation is a centred
-prompt; typing into it creates a Bot and sends the message. The koala artwork
-is drawn from `samples/openkoalabots-assets` geometry in `Design/KoalaArt.swift`,
-including the Dock icon.
-
-### New Space
-
-`New Space` (sidebar, `Shift-Cmd-N`) opens a four-step wizard: System (OS,
-image, Cua Cloud or This machine, and an optional Engine), Resources, Options,
-Summary. "Where it runs" starts from your default location (`cua config set
-default.on cloud|local`, `CUA_DEFAULT_ON`). The Engine chooser offers only what
-the image runs there: gVisor or runc for a local container, QEMU or Lume for a
-local VM, gVisor or KubeVirt in Cua Cloud, and Automatic by default. `Create`
-makes one call on the generated cua SDK, `Spaces.create(options:)` with `on`,
-`kind`, `runtime`, the image as is, and CPUs and memory for a local Space
-(`Spaces/SDKSpaceCreation.swift`). A Cua Cloud Space is metered.
-
-The image dropdown lists the published entries of
-`libs/images/sandbox-images.json`, generated into
-`Spaces/SandboxImages.generated.swift`:
-
-```sh
-node scripts/gen-images.mjs # regenerate
-node scripts/gen-images.mjs --check # exit 1 on drift
-```
-
-### Screenshots
-
-`OPENKOALABOTS_DESIGN_CAPTURE=<stage>` puts the window in one state with fixture
-Bots and transcripts, offline, for a screenshot taken from outside the app.
-Stages: `signin`, `empty`, `thread`, `computer`, `wizard`, `wizard-local`,
-`wizard-resources`, `wizard-options`, `wizard-summary`.
-`OPENKOALABOTS_APPEARANCE=light|dark` pins the appearance, and
-`OPENKOALABOTS_DATA_DIR` moves the roster and routines files off
-`~/Library/Application Support/OpenKoalaBots` (set it for any throwaway run).
-
-## Running
-
-Stage the cua SDK library first. The Swift package links the host dylib from
-`libs/cua/swift/lib`:
-
-```sh
-(cd ../../libs/cua && cargo build --release -p cua-sdk && node scripts/stage-uniffi-library.mjs --only=swift)
-swift build
-.build/debug/OpenKoalaBotExample export ./renders # every screen to PNG (no windows)
-.build/debug/OpenKoalaBotExample spaces-probe embedded # the Spaces contract tools, from the linked SDK
-OPENKOALABOTS_TEST_SPACE=space://direct/127.0.0.1:3211 .build/debug/OpenKoalaBotExample # the app, attached to a registered Space
-```
-
-The last command opens the app's window. Run it yourself; the test suite and
-the scenario never do.
-
-## The shared scenario
-
-```sh
-../openkoalabot-example-scenario/run.sh --impl swift --lane fixture # hermetic
-../openkoalabot-example-scenario/run.sh --impl swift --lane docker # a linux container (runsc, 4 GiB)
-```
-
-`OpenKoalaBotExample scenario --spec … --lane … --out …` runs the spec through this
-app's own code, headlessly: `SDKSpacesClient` for the Space and the agent
-thread, `SpaceStreamProvider` for frames, and the SDK handle for files,
-teleport and presence (`Sources/OpenKoalaBotExample/Scenario/ScenarioRunner.swift`).
-Session teleport ships with Cua Spaces (source-available). The runner's
-embedded runtime refuses it with `HostCapabilityMissing`, so that step skips.
-
-## Picture-in-picture
-
-```sh
-.build/debug/OpenKoalaBotExample live-pip 127.0.0.1:3211 "$TOKEN" /tmp/pip "terminal"
-```
-
-Adds the spacesd to a temp registry, pops out the desktop and the first
-window whose title matches, and prints both sessions' frame counts sampled
-twice. `OPENKOALABOTS_PIP_CAPTURE=<dir>` runs the same tour in the app.
-
-## Tests
-
-```sh
-scripts/test.sh # `swift test`, plus the swift-testing paths the Command Line Tools need
-```
-
-The suites run on swift-testing. XCTest ships only with Xcode. The assertion
-lines keep XCTest's names through `Tests/OpenKoalaBotExampleTests/XCTAssertCompat.swift`.
-Offline, 212 tests pass and the 22 live ones skip. Against a local
-linux container (gVisor, `OPENKOALABOTS_TEST_SPACE_URL`), 212 pass
-and one skips: the Terminal-window test, which only runs on a macOS Space.
-
-The e2e suite drives `SDKSpacesClient`, and through it the SDK, against a
-**live Space** through the cua SDK's Spaces runtime. Nothing is mocked.
-
-### `OPENKOALABOTS_TEST_SPACE_URL`: a spacesd
-
-```sh
-OPENKOALABOTS_TEST_SPACE_URL=http://127.0.0.1:32768 OPENKOALABOTS_TEST_SPACE_TOKEN=… scripts/test.sh
-```
-
-The machine is added to a **temp** registry in an embedded runtime and pinned
-for the run. Install the scenario's fake agent CLI in the guest first
-(`samples/openkoalabot-example-scenario/fixtures/fake-claude.sh` as `~/.local/bin/claude`),
-so the agent tests make no model calls. Otherwise the harness installs the
-real CLI. `~/.cua` is never touched. A local linux container
-works for this. The few assertions that are about a macOS Space, such as
-opening a Terminal window, skip on Linux and say why.
-
-### `OPENKOALABOTS_TEST_SPACE`: the warm-Space override
-
-Point the suite at a Space that is already up, instead of creating one:
-
-```sh
-OPENKOALABOTS_TEST_SPACE=local:cua-space-e3c1b54907 scripts/test.sh
-```
-
-With the variable set, `ensureSpace()` returns exactly that Space: no
-`create_space`, no `delete_space`, and no call that displays
-the Space on the operator's desktop. Every artefact a test creates (an uploaded
-file, an agent run, a window it opened) is named with a fresh UUID and removed
-in teardown whether the test passes or fails, so the suite is safe to run
-against a Space you demo from.
-
-With it **unset the live tests skip** rather than run. That is deliberate: the
-ordinary `ensureSpace()` path calls `create_space` with `reuse: true` in your
-default location, which creates a **new sandbox** (metered in Cua Cloud) when it
-finds none to reuse (see `FRICTION.md` #5). Costing a reviewer a sandbox for
-typing `swift test` is not acceptable, so the suite never takes that path.
-
-Per-test cleanup, which used to be XCTest's async `tearDown`, and the
-end-of-suite sweeper, which used to be `XCTestObservation`, are now the
-`.liveSpace` trait (`Tests/OpenKoalaBotExampleTests/LiveSpace.swift`).
-
-### What is covered
-
-| Primitive | Tool | Test |
-|---|---|---|
-| Space inventory | `list_spaces` | `testListSpacesDecodesTheRealInventory`, `testWarmSpaceIsRunning` |
-| Attach to a Space | override (never `create_space`) | `testEnsureSpaceAttachesToWarmSpaceWithoutCreating` |
-| Start a Bot | `agent_start` | `testBotLifecycleStartMessageStatusStop` |
-| Steer a Bot | `agent_message` | `testBotLifecycleStartMessageStatusStop`, `testMessageToARunningBotIsRefusedNotQueued` |
-| Poll a Bot | `agent_status` | `testBotLifecycleStartMessageStatusStop`, `testStatusOfUnknownRunIsUnknownNotDone` |
-| Stop a Bot | `agent_stop` | `testBotLifecycleStartMessageStatusStop` |
-| Bot roster | `agent_list` | `testBotLifecycleStartMessageStatusStop` |
-| Live window view | `list_space_windows` | `testWindowsReturnsLiveWindowsWithUsableIdentifiers`, `testWindowsReflectsAWindowOpenedAndClosedByTheTest` |
-| Attachment in | `upload` | `testUploadDeliversFileContentsIntoTheSpace`, `testUploadOfMissingHostFileThrows` |
-| Attachment out | `download` | `testDownloadBringsAFileBackOutOfTheSpace`, `testDownloadOfMissingPathThrows` |
-
-### What is **not** covered, and why
-
-- **`create_space` / `delete_space`.** Implemented and typed, but untested
- here: exercising them means creating and deleting a sandbox, which this suite
- is forbidden to do against the Space it runs on. The shared scenario's
- `cloud` lane covers them.
-- **`ensureSpace()`'s create branch.** Same reason: it can create a sandbox.
- The override branch is tested; the `create_space` branch is not.
-- **`presentScreen` / tier 2 and 3 pixels.** Not implemented in this layer.
- `testPresentScreenIsInertAndCapabilitiesSaySo` asserts it stays inert. That
- is proof the build does not open a window on the operator's Mac, **not**
- coverage of a streaming operation.
-
-### Screen → Spaces operation → test
-
-Screens whose behaviour is backed by a Spaces operation:
-
-| Screen | Operation | Test |
-|---|---|---|
-| `mobile-02-thread-card`, `mobile-03-thread-links` | agent thread: `agent_start` → `agent_status` → `agent_message` | `testBotLifecycleStartMessageStatusStop` |
-| `mobile-01-roster` (populated) | `agent_list` | `testBotLifecycleStartMessageStatusStop` |
-| `mobile-05-takeover`, `mobile-07-pinned-preview`, `mobile-09-takeover-controlled` | live window view (`list_space_windows`); the *pixels* are `stream_space_window` | window list: `testWindowsReturnsLiveWindowsWithUsableIdentifiers`. Streaming and take/hand-back: **not implemented** |
-| `mobile-08-attachments` | `upload` (and `download` on the way back) | `testUploadDeliversFileContentsIntoTheSpace`, `testDownloadBringsAFileBackOutOfTheSpace` |
-| `mobile-06-approval` | approval gate before a Bot uses a saved login | **no Spaces operation exists for this.** The Spaces tool contract has no approval primitive: `agent_start` runs auto-approved because the Space *is* the sandbox. The screen is deliberately uncovered rather than faked (RUBRIC.md) |
-| `desktop-01-dark`, `desktop-02-light`, `desktop-03-no-panel` | the desktop shell hosts the same thread and window operations as above | same tests; the shell itself is fixture-rendered |
-
-UI-only screens, with no Spaces interaction and **no test**, correctly:
-
-- `mobile-04-signin`: sign-in, entirely local.
-- `mobile-10-empty-roster`: the zero-Bot empty state; by definition no run to list.
-
-### The live data layer
-
-`Model/BotStore.swift` is the app's data layer: it attaches to **one** Space and
-starts **one long-lived agent thread per Bot** inside it (never a Space per
-Bot; `Spaces/SpacesClient.swift` argues out why), keeps a live roster from
-`agent_list` joined to local Bot identity, and derives each Bot's transcript
-from real `agent_status` output.
-
-| Live behaviour | Operation | Test |
-|---|---|---|
-| Attach to the one shared Space, create nothing | override (never `create_space`) | `testConnectAttachesToTheWarmSpaceAndCreatesNothing`, `testEveryBotRunsInTheOneSharedSpace` |
-| Real agent output becomes a transcript | `agent_start` → `agent_status` | `testLiveThreadCarriesRealAgentOutputRosterStateAndAttachments` |
-| Per-turn attribution of output | `agent_message` + tail offsets | `testLiveThread…`, `testOutputIsAttributedToTheTurnThatCausedIt` |
-| Live roster with per-Bot state and `accepts_message` | `agent_list` | `testLiveThread…`, `testRosterJoinsRunsBackToLocalBotIdentity`, `testUnmarkedRunsStillAppearInTheRoster` |
-| A refusal is shown, not swallowed | `agent_message` | `testMidTurnRefusalIsShownToTheUser`, `testRefusalSurfacesInOutcomeNoticesAndTranscript` |
-| Attachments in, files out | `upload` / `download` | `testLiveThread…`, `testAttachmentIsEchoedIntoTheTranscript` |
-| One poll loop for the whole roster | `agent_status` | `testPollLoopRefreshesTheRosterFromOneTask` |
-| A failed probe degrades to `unknown`, never to health | `agent_status` | `testFailedStatusProbeDegradesToUnknown` |
-
-The views read through `BotDataSource`, which has two implementations:
-`FixtureDataSource` (what `export` renders, so the regression renders
-`RUBRIC.md` describes do not move; the PNGs were byte-identical before and
-after this layer landed) and `BotStore` (live). `BotStatusChip` and the composer's refusal
-line surface `accepts_message` in the UI, so a user can see that a Bot will
-refuse a message before typing one.
-
-### Routines, group chats, and the transcript affordances
-
-`Sources/OpenKoalaBotExample/Routines/` and `Sources/OpenKoalaBotExample/Groups/` are
-self-contained views the app shell mounts:
-
-| Feature | Mount point | Backing |
-|---|---|---|
-| Routines | `RoutinesPanel(botID:botName:store:dark:scale:)`: desktop right panel under the Agent Computer preview; mobile thread overflow | `RoutineStore` (JSON on disk) + `BotStoreRoutineRunner` → real `agent_start` / `agent_message` |
-| Group chat | `GroupChatScreen(chatID:store:bots:)`, opened from `NewGroupSheet` | `GroupChatStore` + `BotStoreGroupMessenger` → one agent thread per member in the one shared Space |
-
-A routine is a saved prompt plus a clock. `RoutineStore.tick(now:)` is the whole
-scheduler and takes the instant to evaluate, so the policy is testable without
-sleeping; `startScheduler(every:)` is a thin loop over it. Firing an unhired Bot
-**hires it** (a real `agent_start`), and firing a Bot that is mid-turn is
-*refused*, never an interruption. Routines persist to
-`~/Library/Application Support/OpenKoalaBots/routines.json` and survive a restart,
-firing history included, so a relaunch does not re-fire the past.
-
-| Live behaviour | Operation | Test |
-|---|---|---|
-| A due routine starts a real run in the Space | `agent_start` → `agent_list` → `agent_stop` | `RoutinesLiveTests.testADueRoutineStartsARealAgentRunInTheSpace` |
-| The background loop fires without being ticked | same | `testTheBackgroundSchedulerLoopFiresWithoutBeingTicked` |
-| A group fans out to one real thread per member | `agent_start` / `agent_message` per member | `testAGroupChatFansOutToRealAgentThreads` |
-
-A group chat holds **2-6 Bots plus one human**, enforced in `GroupChat`'s
-initialiser rather than in a view, so an out-of-bounds group cannot be built by
-going round the UI. Hitting either limit produces a named error, a banner, and a
-line in the group transcript saying what the limit is.
-
-Everything in `Design/BotAvatar.swift`'s motion section and the affordance
-section of `Mobile/Transcript.swift` (typing indicator, reaction bar, link card,
-approval card) is outside the export renders `RUBRIC.md` describes. The
-approval card **enforces nothing**: there is no approval primitive in the
-Spaces tool contract (`FRICTION.md` §43), `agent_start` runs auto-approved, and
-`ApprovalCard.enforcementIsImplemented` is `false` so no caller can mistake the
-card for a control.
+This sample moved to [examples/openkoalabot-example-swift](../../examples/openkoalabot-example-swift).
diff --git a/samples/openkoalabot-example-tauri/README.md b/samples/openkoalabot-example-tauri/README.md
index 7e6f94a089..3e0bee99ba 100644
--- a/samples/openkoalabot-example-tauri/README.md
+++ b/samples/openkoalabot-example-tauri/README.md
@@ -1,145 +1 @@
-# OpenKoalaBots (Rust + Tauri)
-
-A desktop app where you hire named Bots, give each one its own computer (a
-Space), and watch it work beside the thread. Built on the cua SDK's Rust
-crates with a Tauri 2 shell and a React UI.
-
-```sh
-npx degit trycua/cua/samples/openkoalabot-example-tauri my-app
-cd my-app && pnpm install
-pnpm tauri dev
-```
-
-> The cua crates and the image list are not published yet, so a degit copy
-> does not build on its own today. Until they are, develop inside the cua
-> repo (below).
-
-## Developing inside the cua repo
-
-This example depends on the cua SDK by path, as a local workspace override:
-
-| Dependency | Where it comes from today |
-|---|---|
-| `cua-spaces`, `cua-sandbox-core`, `cua-daemon` | `../../../libs/cua/crates/*` (path dependencies in `src-tauri/Cargo.toml`) |
-| The sandbox image list | `../../libs/images/sandbox-images.json`, imported by the UI (`ui/src/images.ts`) and compiled into the core (`src-tauri/core/src/plan.rs`) |
-
-None of these are on crates.io or npm yet. Once they are, the path
-dependencies become version dependencies and the degit quick start above
-works as is.
-
-```sh
-cd samples/openkoalabot-example-tauri
-pnpm install --frozen-lockfile
-pnpm tauri dev # Vite on :1430 plus the Rust shell
-```
-
-## What is in it
-
-| Path | What |
-|---|---|
-| `src-tauri/core` (`openkoalabot-example-core`) | The app logic, headless, on `cua-spaces`: add, create and delete a Space, the desktop and per-window streams (media tickets), the window list, one agent thread per Bot, SHA-256 verified file drops, approval-gated session teleport (it ships with Cua Spaces; see below), presence, and the New Space plan (`plan.rs`). Also the `openkoalabot-example-scenario` runner. |
-| `src-tauri/app` (`openkoalabot-example-tauri`) | The Tauri shell. Every command is a one-liner over the core. Local Spaces run on the SDK's own runtime (`cua_daemon::local::VmmLocal`: containers, QEMU, Lume). |
-| `ui/` | The webview (Vite + React): the Bots roster, one thread per Bot with step, status, approval and file cards, the docked composer, the Computer panel (live desktop over media wire v2, decoded with WebCodecs, picture in picture, window list, drop zone), the New Space wizard and the teleport approval sheet. |
-| `ui/src/assets` | The koala artwork (copied from `samples/openkoalabots-assets`). |
-
-The UI follows the system's light or dark mode.
-
-## Spaces
-
-**New Space** opens a four-step wizard (System, Resources, Options,
-Summary). The image dropdown lists the `published` entries of the shared
-image list, and each entry names the engine it runs on in each location, so
-the wizard never offers a combination the image cannot run. Create makes one
-SDK call, `Spaces::create(SpaceCreate { on, image, kind, runtime, name, .. })`:
-
-| Where | `on` | `kind` / `runtime` |
-|---|---|---|
-| This machine | `local` | container / `auto` (gVisor when available), vm / `qemu`, vm / `lume`; plus `cpus`, `memory_mb` |
-| Cua Cloud | `cloud` | Ended: a cloud plan fails with "Cua Cloud has ended; use a local sandbox or your own machine". Create the Space on This machine instead. |
-
-**Add by address** (in the wizard footer or the empty state) registers a
-machine that already runs cua-spacesd, for example a local container:
-
-```sh
-TOKEN=$(openssl rand -hex 16)
-docker run -d --name cua-e2e-openkoalabots --runtime=runsc --memory=4g -e CUA_ENV_TOKEN=$TOKEN \
- -p 127.0.0.1:3211:3211 cua-e2e-local/linux:docker-local-arm64
-# then add 127.0.0.1:3211 with $TOKEN
-```
-
-**Delete…** is a separate control that always asks first: a Space the app
-created (in Cua Cloud or on this machine) is deleted with its sandbox; a Space
-added by address is only removed from the list.
-
-## Teleport
-
-Teleport ships with Cua Spaces (source-available), not with the MIT SDK
-this sample uses.
-
-- **Session teleport** (the approval sheet) calls the Spaces tools
- `teleport_manifest` and `teleport_app` (`openkoalabot_example_core::teleport`).
- The app runs the Spaces runtime in process with no teleport extension, so
- the runtime refuses with `HostCapabilityMissing` and the sheet shows
- "Session teleport ships with Cua Spaces (source-available)."
-- **App teleport** (the app picker, dropped app bundles and window drags) is
- not part of this sample. The drop zone's **Teleport an app…** button and a
- dropped app bundle show "App teleport ships with Cua Spaces
- (source-available)." and send nothing.
-
-The Computer panel has one drop zone, the SDK's `<cua-drop-zone>`. Dropped
-files upload (SHA-256 verified); **Send file…** picks files to upload.
-
-## Picture in picture
-
-The PiP button on the stream pops the desktop out; each row of the window
-list pops out that one window. Each is a small always-on-top window
-(`open_pip`) with its own media session, closed with it. Labels and routes
-come from `@trycua/cua/spaces/pip` (`pipWindowLabel`, `encodePipRoute`).
-
-## Host safety
-
-The app keeps its Spaces registry and local sandbox state in its own data
-directory (never `~/.cua`). Tests and the scenario use temp registries.
-
-`OPENKOALABOTS_WALKTHROUGH=<file.json>` runs a scripted demo through the same
-commands a person uses (add Spaces, hire Bots, send messages, open a sheet);
-see the `Walkthrough` type in `ui/src/api.ts`.
-
-## Tests
-
-```sh
-pnpm test # vitest: 57 tests (image dropdown, wizard, thread cards, Space section, media wire, PiP, drop zone, error messages)
-cd src-tauri
-cargo test -p openkoalabot-example-core -- --test-threads=4 # 34 unit + 8 hermetic + 4 plan
-cargo build -p openkoalabot-example-tauri --features custom-protocol # the shell, serving ui/dist (run `pnpm build` first)
-OKB_WEBVIEW_ISOLATION=1 cargo test -p openkoalabot-example-tauri --features custom-protocol --test webview_isolation # macOS: a temp-HOME run writes nothing under the real ~/Library
-```
-
-Webview data stays in the app's data directory (`$HOME/Library/Application Support/ai.cua.openkoalabot.example` on macOS): a data directory under it on Windows and Linux, a non-persistent store on macOS. The page's saved state (Bots, selection, threads) is `ui-state.json` there, not web storage.
-
-The hermetic tests run against the SDK's in-process mock cua-spacesd
-(`cua_spacesd_client::testing`) on loopback: processes are simulated and
-files live in memory, so nothing runs on or writes to the host. The mock has
-no file transfers, so there a drop is checked to fail loudly; the docker lane
-of the scenario covers real drops. Teleport is checked to refuse with the
-Cua Spaces message. `tests/plan.rs`
-checks that a wizard plan reaches the SDK as the right call (a recording fake
-`LocalRuntime`, no container or VM is started).
-
-## Scenario
-
-```sh
-cd src-tauri && cargo build -p openkoalabot-example-core --bins
-../../openkoalabot-example-scenario/run.sh --impl tauri --lane fixture # no docker
-../../openkoalabot-example-scenario/run.sh --impl tauri --lane docker # linux, runsc, 4 GiB
-```
-
-The same behaviour ships in [`openkoalabot-example-swift`](../openkoalabot-example-swift)
-and [`openkoalabot-example-ts`](../openkoalabot-example-ts); all three pass the shared
-scenario in [`openkoalabot-example-scenario`](../openkoalabot-example-scenario).
-
-## License
-
-Source-available under [FSL-1.1-MIT](LICENSE): its live stream uses the
-streaming client that ships with Cua Spaces (`cua-spaces-ext`). Each release
-becomes MIT two years after it ships.
+This sample moved to [examples/openkoalabot-example-tauri](../../examples/openkoalabot-example-tauri).
diff --git a/samples/openkoalabot-example-ts/README.md b/samples/openkoalabot-example-ts/README.md
index 6b4d220857..fa42bb7c76 100644
--- a/samples/openkoalabot-example-ts/README.md
+++ b/samples/openkoalabot-example-ts/README.md
@@ -1,146 +1 @@
-# OpenKoalaBots (TypeScript)
-
-A web app where you hire named Bots, give each one its own computer (a
-Space), and watch it work beside the thread. A small Node server on
-[`@trycua/cua`](../../libs/cua/typescript) runs the agents; the page is plain
-TypeScript built with Vite.
-
-```sh
-npx degit trycua/cua/samples/openkoalabot-example-ts my-app
-cd my-app && npm install
-npm run build && npm run build:web && npm run serve
-```
-
-> `@trycua/cua` is not published on npm yet, so a degit copy does not
-> install on its own today. Until it is, develop inside the cua repo (below).
-
-## Developing inside the cua repo
-
-The SDK dependency is a local workspace override:
-
-| Dependency | Where it comes from today |
-|---|---|
-| `@trycua/cua` | `file:../../libs/cua/typescript` in `package.json` (native Node library plus the wasm browser build) |
-| The sandbox image list | `../../libs/images/sandbox-images.json`, imported by the page (`web/main.ts`) and read by the server (`src/core/plan.ts`) |
-
-Once `@trycua/cua` is on npm, the `file:` dependency becomes a version and
-the quick start above works as is.
-
-```sh
-# 1. The SDK: native library for Node, and the wasm browser build
-cd libs/cua && cargo build --release -p cua-sdk
-cd typescript && npm ci && node ../scripts/stage-uniffi-library.mjs --only=node && npm run build && npm run build:browser
-
-# 2. This example
-cd ../../../samples/openkoalabot-example-ts
-npm ci
-npm run build && npm run build:web
-
-# 3. The server; open the URL it prints (it carries #token=…)
-npm run serve # embedded runtime, state in ~/.openkoalabot-example-ts
-npm run serve -- --home /tmp/okb # or any directory
-npm run serve -- --daemon # or a running `cua daemon`
-npm run serve -- --teleport-home /path/to/generated-home # teleport from a directory, not the real host
-```
-
-## Teleport
-
-Session teleport (`POST /api/teleport/manifest`, then `POST /api/teleport`
-with the items you approved) uses the SDK's `space.teleportManifest` and
-`space.teleport`. These are tool calls: they work when the server uses the
-Cua Spaces daemon (`--daemon`). The embedded runtime refuses them with
-`HostCapabilityMissing`, and the server answers 501 with the SDK's message
-that teleport ships with Cua Spaces.
-
-App teleport ("Teleport an app…": the app list, the move plan and run, and
-window drags) ships with Cua Spaces (source-available), not with the MIT
-SDK. The Computer panel's drop zone, the SDK's `<cua-drop-zone>`, still
-shows **Send file…** and **Teleport an app…**: files upload (SHA-256
-verified), while **Teleport an app…** and an app bundle dropped from Finder
-or the Dock show "App teleport ships with Cua Spaces (source-available)."
-The `/api/teleport/apps`, `icon`, `plan`, `run` and `window-drags` routes
-answer 501 with the same message.
-
-## Routines and group chats
-
-A routine is a saved prompt plus a schedule (every N minutes, daily at, weekly on) that gives one Bot another turn; a group chat sends one message to two to six Bots and shows each reply under its Bot. Both are the SDK's `RoutineStore` and `GroupChatStore` (`@trycua/cua/spaces/routines`, `/groups`) over this app's `BotStore` (`src/core/coworkers.ts`). Routines live in `<home>/routines.json` and fire while the server runs; a Bot mid-turn refuses its slot. `--model-url URL [--model NAME] [--key-var VAR]` points every Bot at a custom model endpoint.
-
-## Picture in picture
-
-The PiP button on the stream pops the desktop out; each row of the window
-list pops out that one window (its own media session, closed with the PiP).
-Both use `PictureInPicture` from `@trycua/cua/spaces/pip`: the Document
-Picture-in-Picture API when the browser has it, video picture-in-picture
-otherwise. Browsers allow one PiP at a time, so a new one replaces the last.
-
-For UI work, `npm run dev:web` serves the page through Vite with `/api` and
-`/events` proxied to the server on port 4780 (`OPENKOALABOTS_SERVER`
-overrides); open `http://127.0.0.1:5173/#token=<the printed token>`.
-
-## What is in it
-
-| Part | Where | What |
-|---|---|---|
-| App model | `src/core/app.ts` | One Space, one long-lived agent thread per Bot, a roster from one `agentList` per tick, per-turn transcripts folded from the run's structured events by the SDK's `AgentTranscript`, refusal (never a queue) while a Bot is mid-turn, verified attachments, session teleport behind an approval callback |
-| New Space | `src/core/plan.ts` | The wizard's plan to one SDK call (below) |
-| Wire | `src/core/wire.ts`, `src/core/webmedia.ts` | Media wire v2 framing (`libs/cua/proto/MEDIA.md`), control messages, Annex B keyframes, `OpenMedia` over the wasm gRPC-Web client |
-| Server | `src/server/` | Loopback HTTP + WebSocket, random bearer, one poll loop, stream **tickets** (the spacesd token never reaches the page), session teleport only for a manifest the page showed, app teleport routes that say it ships with Cua Spaces |
-| Page pieces | `src/ui/` | DOM-only building blocks shared by the page and the tests: the image dropdown and wizard, thread cards, the Space section, friendly errors |
-| Page | `web/` | Sidebar (New Bot, search, roster, Space picker), the thread with the Bot's messages as prose, its activity (install, tools, thinking, turn ends) as muted collapsible groups, approval and file cards and a docked composer, the Computer panel (live desktop decoded by WebCodecs, picture in picture, window list with each app's icon from the Space, drop zone), light and dark |
-| Scenario runner | `src/scenario/` | Runs `../openkoalabot-example-scenario/scenario.json` headlessly |
-
-## Spaces
-
-**New Space** opens a four-step wizard (System, Resources, Options,
-Summary). The image dropdown lists the `published` entries of the shared
-image list, and each entry names the engine it runs on in each location, so
-the wizard never offers a combination the image cannot run. Create posts the
-plan to `POST /api/spaces/create`, which makes one SDK call,
-`spaces.create({ on, image, kind, runtime, name, wait: true, ... })`:
-
-| Where | `on` | `kind` / `runtime` |
-|---|---|---|
-| This machine | `local` | container / `auto` (gVisor when available), vm / `qemu`, vm / `lume`; plus `cpus`, `memoryMb`. The SDK runs it itself |
-| Cua Cloud | `cloud` | Ended: a create fails with "Cua Cloud has ended". Create the Space on this machine instead |
-
-**Add by address** (wizard footer or empty state) registers a machine that
-already runs cua-spacesd. **Delete…** is a separate control that always asks
-first: a created Space is deleted with its sandbox, one added by address is
-only removed from the list.
-
-## Tests
-
-```sh
-npm test # build + node --test test/*.test.mjs
-npm run typecheck # server and page
-```
-
-| File | Covers |
-|---|---|
-| `ui.test.mjs` | under happy-dom: the dropdown equals the published list, the wizard (disabled targets, one plan), Delete needs confirmation, thread cards, friendly errors |
-| `computer.test.mjs` | under happy-dom: the window list (one line per window, a PiP button each) and the one drop zone |
-| `plan.test.mjs` | plan to `spaces.create` options (location, kind, engine), refusals, defaults |
-| `server.test.mjs` | loopback + bearer, the whole API against a fake Space, `spaces/create`, window list and per-window stream tickets, the event socket |
-| `app.test.mjs` | thread lifecycle, refusal, degraded probes, the one-call roster, verified attachments, teleport consent |
-| `teleport.test.mjs` | the app teleport routes answer that it ships with Cua Spaces; the embedded runtime's session teleport refusal (`HostCapabilityMissing`) reaches the page as that message |
-| `wire.test.mjs`, `webmedia.test.mjs` | framing, codec string, `OpenMedia`, ticket subprotocol |
-| `spec.test.mjs` | the shared scenario parses |
-| `web-client.test.mjs`, `fixture-lane.test.mjs` | the stream path and the whole scenario against `cua-test-fixtures` |
-
-The last two need `cua-test-fixtures` (`libs/cua/scripts/build-test-fixtures.sh`,
-or point `CUA_TEST_FIXTURES` at a build) and skip without it.
-
-## The scenario
-
-```sh
-npm run build
-../openkoalabot-example-scenario/run.sh --impl ts --lane fixture # loopback spacesd core
-../openkoalabot-example-scenario/run.sh --impl ts --lane docker # a linux container (gVisor, 4 GiB)
-```
-
-The runner embeds the MIT runtime, so the `teleport` step skips with the
-SDK's reason (teleport ships with Cua Spaces).
-
-The same behaviour ships in [`openkoalabot-example-swift`](../openkoalabot-example-swift)
-and [`openkoalabot-example-tauri`](../openkoalabot-example-tauri); all three pass the
-shared scenario in [`openkoalabot-example-scenario`](../openkoalabot-example-scenario).
+This sample moved to [examples/openkoalabot-example-ts](../../examples/openkoalabot-example-ts).
diff --git a/samples/openkoalabots-assets/README.md b/samples/openkoalabots-assets/README.md
index 09b56e37c1..92c9efab12 100644
--- a/samples/openkoalabots-assets/README.md
+++ b/samples/openkoalabots-assets/README.md
@@ -1,14 +1 @@
-# OpenKoalaBots artwork
-
-Original koala artwork for the three OpenKoalaBots samples. Made for this
-repository; no third-party marks.
-
-| File | Use |
-|---|---|
-| `app-icon.svg` | App icon (Tauri icons are rendered from it) |
-| `koala-mark.svg` | The mark: sidebar header, avatars, the empty chat |
-| `koala-peek.svg` | Empty states (no Space yet) |
-| `koala-sleep.svg` | Idle states (a Bot with nothing to do) |
-
-The shapes are circles, ellipses and a few paths, so the Swift sample draws
-the same koala with SwiftUI shapes (`Design/KoalaArt.swift`).
+This sample moved to [examples/openkoalabots-assets](../../examples/openkoalabots-assets).
diff --git a/samples/python/README.md b/samples/python/README.md
new file mode 100644
index 0000000000..843bb89f75
--- /dev/null
+++ b/samples/python/README.md
@@ -0,0 +1 @@
+This sample moved to [examples/python](../../examples/python).
diff --git a/scripts/check-no-em-dash.sh b/scripts/check-no-em-dash.sh
index b67ce329ad..b572b09ed8 100755
--- a/scripts/check-no-em-dash.sh
+++ b/scripts/check-no-em-dash.sh
@@ -13,7 +13,7 @@ set -euo pipefail
cd "$(git rev-parse --show-toplevel)"
-EXCLUDE='(^|/)CHANGELOG[^/]*\.md$|^\.github/release-backfill/|^\.github/release-notes/|^blog/|^changelog/|^libs/fleet/'
+EXCLUDE='(^|/)CHANGELOG[^/]*\.md$|^\.github/release-backfill/|^\.github/release-notes/|^blog/|^docs/changelog/|^libs/fleet/'
EM=$'\xe2\x80\x94'
if [ "$#" -gt 0 ]; then
diff --git a/tools/cli-cast/README.md b/scripts/cli-cast/README.md
similarity index 100%
rename from tools/cli-cast/README.md
rename to scripts/cli-cast/README.md
diff --git a/tools/cli-cast/record-all.sh b/scripts/cli-cast/record-all.sh
similarity index 100%
rename from tools/cli-cast/record-all.sh
rename to scripts/cli-cast/record-all.sh
diff --git a/tools/cli-cast/record.py b/scripts/cli-cast/record.py
similarity index 100%
rename from tools/cli-cast/record.py
rename to scripts/cli-cast/record.py
diff --git a/tools/cli-cast/scripts/claude-awaiting-answer.json b/scripts/cli-cast/scripts/claude-awaiting-answer.json
similarity index 100%
rename from tools/cli-cast/scripts/claude-awaiting-answer.json
rename to scripts/cli-cast/scripts/claude-awaiting-answer.json
diff --git a/tools/cli-cast/scripts/claude-bash-error.json b/scripts/cli-cast/scripts/claude-bash-error.json
similarity index 100%
rename from tools/cli-cast/scripts/claude-bash-error.json
rename to scripts/cli-cast/scripts/claude-bash-error.json
diff --git a/tools/cli-cast/scripts/claude-basic-turn.json b/scripts/cli-cast/scripts/claude-basic-turn.json
similarity index 100%
rename from tools/cli-cast/scripts/claude-basic-turn.json
rename to scripts/cli-cast/scripts/claude-basic-turn.json
diff --git a/tools/cli-cast/scripts/claude-interrupted.json b/scripts/cli-cast/scripts/claude-interrupted.json
similarity index 100%
rename from tools/cli-cast/scripts/claude-interrupted.json
rename to scripts/cli-cast/scripts/claude-interrupted.json
diff --git a/tools/cli-cast/scripts/claude-plan-question.json b/scripts/cli-cast/scripts/claude-plan-question.json
similarity index 100%
rename from tools/cli-cast/scripts/claude-plan-question.json
rename to scripts/cli-cast/scripts/claude-plan-question.json
diff --git a/tools/cli-cast/scripts/claude-subagent-and-mode.json b/scripts/cli-cast/scripts/claude-subagent-and-mode.json
similarity index 100%
rename from tools/cli-cast/scripts/claude-subagent-and-mode.json
rename to scripts/cli-cast/scripts/claude-subagent-and-mode.json
diff --git a/tools/cli-cast/scripts/claude-tool-error.json b/scripts/cli-cast/scripts/claude-tool-error.json
similarity index 100%
rename from tools/cli-cast/scripts/claude-tool-error.json
rename to scripts/cli-cast/scripts/claude-tool-error.json
diff --git a/tools/cli-cast/scrub.py b/scripts/cli-cast/scrub.py
similarity index 100%
rename from tools/cli-cast/scrub.py
rename to scripts/cli-cast/scrub.py
diff --git a/scripts/images/image-refs-allowlist.json b/scripts/images/image-refs-allowlist.json
index 61c25b6c4a..11027f1af4 100644
--- a/scripts/images/image-refs-allowlist.json
+++ b/scripts/images/image-refs-allowlist.json
@@ -3,17 +3,16 @@
"exclude": [
"libs/fleet/**",
"blog/**",
- "changelog/**",
+ "docs/changelog/**",
"CHANGELOG*",
"*/CHANGELOG*",
"*.lock",
"pnpm-lock.yaml",
"*/package-lock.json",
- "evidence/**",
"*/evidence/**",
".github/release-backfill/**",
"docs/superpowers/**",
- "rfcs/**"
+ "docs/rfcs/**"
],
"generated": [
"docs/content/docs/cua-sdk/reference/os-image-catalog.mdx",
@@ -33,7 +32,7 @@
"libs/cua/typescript/src/native/cua_sdk.ts",
"libs/cua/typescript/src/native/cua_sdk-ffi.ts",
"libs/cua/spaces-contract/manifest.json",
- "samples/openkoalabot-example-swift/Sources/OpenKoalaBotExample/Spaces/SandboxImages.generated.swift",
+ "examples/openkoalabot-example-swift/Sources/OpenKoalaBotExample/Spaces/SandboxImages.generated.swift",
"libs/cua-bench/cua_bench/images.py"
],
"thirdParty": {
diff --git a/scripts/licenses/README.md b/scripts/licenses/README.md
index a6520fb2c2..e17474d669 100644
--- a/scripts/licenses/README.md
+++ b/scripts/licenses/README.md
@@ -1,7 +1,7 @@
# Licence notices for the Cua Spaces UI
`notices.mjs` regenerates the npm dependency section of the repository's
-[`THIRD_PARTY_NOTICES.md`](../../THIRD_PARTY_NOTICES.md) for
+[`THIRD_PARTY_NOTICES.md`](../../legal/THIRD_PARTY_NOTICES.md) for
`apps/cua-spaces-web` and `apps/cua-spaces-desktop`, and checks every
licence against an allow-list.
@@ -33,7 +33,7 @@ resources with electron-builder's `extraResources`:
```yaml
extraResources:
- - from: ../../THIRD_PARTY_NOTICES.md
+ - from: ../../legal/THIRD_PARTY_NOTICES.md
to: THIRD_PARTY_NOTICES.md
```
@@ -44,7 +44,7 @@ credits, or the app's own About view) that opens it with
**SwiftUI (`apps/cua-spaces-macos`).** Add the file to the app target's bundle
resources (in `project.yml`, a `resources` entry pointing at
-`../../THIRD_PARTY_NOTICES.md`), next to the app's own
+`../../legal/THIRD_PARTY_NOTICES.md`), next to the app's own
`apps/cua-spaces-macos/THIRD_PARTY_NOTICES.md`. In the About panel, add a
"Third-party notices" link that opens
`Bundle.main.url(forResource: "THIRD_PARTY_NOTICES", withExtension: "md")`
diff --git a/scripts/licenses/notices.mjs b/scripts/licenses/notices.mjs
index 29a53717b2..5d88c06c82 100644
--- a/scripts/licenses/notices.mjs
+++ b/scripts/licenses/notices.mjs
@@ -16,7 +16,7 @@ import path from 'node:path';
import { fileURLToPath } from 'node:url';
const ROOT = path.resolve(path.dirname(fileURLToPath(import.meta.url)), '..', '..');
-const NOTICES = path.join(ROOT, 'THIRD_PARTY_NOTICES.md');
+const NOTICES = path.join(ROOT, 'legal', 'THIRD_PARTY_NOTICES.md');
const APPS = ['apps/cua-spaces-web', 'apps/cua-spaces-desktop'];
const BEGIN = '<!-- BEGIN GENERATED NPM DEPENDENCIES (scripts/licenses/notices.mjs) -->';
const END = '<!-- END GENERATED NPM DEPENDENCIES -->';
diff --git a/scripts/spdx-headers.py b/scripts/spdx-headers.py
index c84dc61655..725a5c2e0b 100755
--- a/scripts/spdx-headers.py
+++ b/scripts/spdx-headers.py
@@ -6,7 +6,7 @@ Two trees carry headers:
libs/cua-driver (MIT, .rs and .swift), the default root;
every FSL-1.1-MIT package (`--fsl`): each source file whose nearest LICENSE
- file is the Functional Source License (see LICENSING.md).
+ file is the Functional Source License (see legal/LICENSING.md).
Modes:
--apply (default): insert the header on files that lack it
@@ -74,8 +74,8 @@ GENERATED_ELSEWHERE = re.compile(r"_pb2(_grpc)?\.py$|_pb\.ts$")
GENERATED_DIRS = ("libs/cua/crates/cua-spacesd-html5/assets/",)
# FSL directories whose files are pinned by content digest: a header would
# change the digests the benchmark checks, so the folder-level LICENSE covers
-# them instead (see benchmarks/cua-driver-bench/LICENSE).
-HEADER_EXEMPT_DIRS = ("benchmarks/cua-driver-bench/taskpack/tasks/",)
+# them instead (see libs/cua-driver-bench/LICENSE).
+HEADER_EXEMPT_DIRS = ("libs/cua-driver-bench/taskpack/tasks/",)
def spdx_header(license_id: str, suffix: str) -> list[str]: