Hugging Face's logo

Snapkitty
/
perplexity-macro-vm

custom
code
sovereign-compute
Model card Files
xet
 Community
perplexity-macro-vm
File size: 2,589 Bytes
92d9567
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
# 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