| # AgentConsole — Swift front end for Perplexity Macro VM | |
| Super-clean Swift (Tokamak/SwiftWasm) + GitHub Pages static console. VM owns control flow, `RQ` requests capabilities, `ResearchBroker` returns typed TLV + CRC16, LiveView streams `TraceHub`. | |
| ``` | |
| PHOENIX LIVEVIEW (Agent Console) | |
| instruction → PLAN → EXECUTE → OBSERVE VM Trace | Memory | Tools | Python | |
| │ | |
| AGENT RUNTIME (instruction model · planner · dispatcher) | |
| │ | |
| ┌─────────────┼──────────────┐ | |
| ▼ ▼ ▼ | |
| Macro VM WASM Box Tool Broker | |
| 16-bit Python search/fetch/browser/code/local_model/wikipedia/mathematica/dictionary | |
| ROM/RAM IPython + 14 Sovereign Tool API (slc/ere/quantum/worm/swarm/...) | |
| Pyodide (sovereign-tool-api.mjs:220) | |
| ``` | |
| ## Swift package | |
| ```bash | |
| swift build | |
| swift run AgentConsoleApp | |
| swift test | |
| # SwiftWasm (GitHub Pages): | |
| # carton build --product AgentConsole --deployment-target browser | |
| ``` | |
| ## GitHub Pages | |
| Static console at `docs/agent-console/` — no server. Phoenix LiveView WS optional (`ws://localhost:4000/socket/websocket`). Pyodide loaded from CDN, Web Worker-friendly. | |
| ## Sandbox | |
| `python.execute / inspect / reset / install / export` — **no direct net/fs**. `tools.search(...)` inside Python is mediated → Capability Router → policy check → ResearchBroker → typed result → Python. | |
| ## Tools (22) | |
| VM caps `0x01-0x08` (sensitive `browser/code/wikipedia/mathematica` require `CONFIRM 0x2A` + expiring token): search, fetch, browser, code, local_model, wikipedia, mathematica, dictionary. Sovereign Tool API: slc.evaluate, slc.gate, ere.score, quantum.temp, quantum.entropy, worm.seal, worm.verify, metatron.phi, metatron.cube, swarm.run, regex.match, agent.call, corpus.score, colosseum.judge. Sandbox: python.*, macrogrok.infer4, tavily.search. | |
| ## VM Contract | |
| Word 16-bit, ROM $0000-$1FFF RAM $2000-$DFFF MMIO $E000, regs A,B,C,D PC SP=0xDFFF, fuel 128, transcript_hash. Mailbox $00 phase $01 fuel $02 cap $03 status, TLV @$46 CRC16 @$C6 (lib/perplexity_macro/rom.ex). | |
| ## References | |
| - `perplexity-macro-vm/lib/perplexity_macro/rom.ex`, `capability.ex`, `research/broker.ex`, `vm/state.ex` | |
| - `bob-orchestrator/bridges/sovereign-tool-api.mjs` (14 tools) | |
| - Pyodide https://pyodide.org/en/stable/usage/index.html | |