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

# 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.