| # Perplexity Macro VM — Java SDK | |
| Java execution runtime for the Perplexity Macro VM. Compiles to WASM via TeaVM (open) or CheerpJ (full JDK fallback). | |
| ## Structure | |
| ``` | |
| java-sdk/ | |
| ├── pom.xml ← Maven build (TeaVM 0.9.2, Java 17) | |
| ├── src/main/java/vm/ | |
| │ ├── Main.java ← Entry point + execute() ABI | |
| │ ├── Capability.java ← WASM import bridge (search, file, clock) | |
| │ └── Wasm.java ← WASM memory introspection | |
| └── src/test/java/vm/ | |
| └── MainTest.java ← Unit tests | |
| ``` | |
| ## Build | |
| ```bash | |
| # Local JAR | |
| mvn package | |
| # WASM (TeaVM) | |
| mvn package -P teavm | |
| # Emits: target/macro-vm-java.wasm + target/macro-vm-java.js | |
| ``` | |
| ## Toolchain | |
| | Tool | Version | Purpose | | |
| |------|---------|---------| | |
| | TeaVM | 0.9.2 | Java bytecode → JS/WASM (open, no JDK needed) | | |
| | CheerpJ | 3.0 | Full JDK in browser (fallback) | | |
| | Java | 17 | Source level | | |
| ## Flow | |
| ``` | |
| Main.java + Capability.java + Wasm.java | |
| ↓ javac (Maven) | |
| ↓ TeaVM / CheerpJ | |
| target/macro-vm-java.wasm + .js | |
| ↓ fetch + WebAssembly.instantiate | |
| Browser WASM runtime | |
| ↓ stdout/result via Capability bridge | |
| Agent Console (Swift or JS frontend) | |
| ``` | |
| ## Runtime Imports (WASM → Browser) | |
| Capability bridge provides typed imports: | |
| - `vm_request(cap, json)` — tool/capability request | |
| - `file_read(path)` / `file_write(path, content)` | |
| - `clock_now()` — ISO8601 timestamp | |
| - `random_bytes(n)` — hex random | |
| - `memory_size()` — WASM pages | |
| - `stdout(msg)` / `stderr(msg)` | |
| ## License | |
| BEL ESPRIT D ACCORD TRUST HOLDINGS INC. Patent Pending. | |