Snapkitty/sovereign-emulator

╔══════════════════════════════════════════════════════════════════════════════════╗
║                                                                                  ║
║  ███████╗ ██████╗ ██╗   ██╗    ███████╗███╗   ███╗██╗   ██╗██╗      █████╗     ║
║  ██╔════╝██╔═══██╗██║   ██║    ██╔════╝████╗ ████║██║   ██║██║     ██╔══██╗    ║
║  ███████╗██║   ██║██║   ██║    █████╗  ██╔████╔██║██║   ██║██║     ███████║    ║
║  ╚════██║██║   ██║╚██╗ ██╔╝    ██╔══╝  ██║╚██╔╝██║██║   ██║██║     ██╔══██║    ║
║  ███████║╚██████╔╝ ╚████╔╝     ███████╗██║ ╚═╝ ██║╚██████╔╝███████╗██║  ██║    ║
║  ╚══════╝ ╚═════╝   ╚═══╝      ╚══════╝╚═╝     ╚═╝ ╚═════╝ ╚══════╝╚═╝  ╚═╝    ║
║                                                                                  ║
║   ███████╗ █████╗  ██████╗ ███████╗███╗  ██╗████████╗    █████╗  ██╗            ║
║   ██╔════╝██╔══██╗██╔════╝ ██╔════╝████╗ ██║╚══██╔══╝   ██╔══██╗ ██║            ║
║   █████╗  ███████║██║  ███╗█████╗  ██╔██╗██║   ██║      ███████║ ██║            ║
║   ██╔══╝  ██╔══██║██║   ██║██╔══╝  ██║╚████║   ██║      ██╔══██║ ██║            ║
║   ███████╗██║  ██║╚██████╔╝███████╗██║ ╚███║   ██║      ██║  ██║ ██║            ║
║   ╚══════╝╚═╝  ╚═╝ ╚═════╝ ╚══════╝╚═╝  ╚══╝   ╚═╝      ╚═╝  ╚═╝ ╚═╝            ║
║                                                                                  ║
║      S N A P K I T T Y   —   S O V E R E I G N   A G E N T   E M U L A T O R    ║
╚══════════════════════════════════════════════════════════════════════════════════╝

Live: snapkittywest.github.io/sovereign-emulator · Virtual runtime for governed autonomous agents

---

WHAT YOU ARE LOOKING AT

A sovereign agent emulator — a virtual environment where governed AI agents can:

• Propose actions without being able to execute them unilaterally
• Be constrained by a Prolog-style constitution before anything executes
• Leave receipts — cryptographically sealed records of every decision (SHA-256 WORM chain)
• Browse the web — agent-driven browser with iframe + text snapshot fetch
• Bash in / bash out — virtual shell for agents (constitution-gated)
• Run on any device — zero install, pure browser environment

This is not a chat interface. This is a runtime inspection tool.

---

WHAT'S NEW (v∞.1)

Feature	Status
Web Browser app	Live — dock, home grid, menus, key B
Bash in / Bash out terminal	Live — virtual FS, agent identity, key T
Constitution engine	Live — can_execute/2, trust · domain · resonance · risk
WORM ledger	Live — append-only SHA-256 chain, verify, dump
Top bar menus	Fixed — File / Edit / View / Run / Tools / Help
Dock icons	Fixed — Call · Messages · Browser · Terminal
Keyboard shortcuts	Fixed — Space P C V W ? B T H
Chat slash commands	/browse /bash /worm /const /status /help
Local API fallback	Chat works offline when mesh API is down
Incoming call stub	Fixed — dock phone / Tools → Simulate Call

---

APPS ON THE PHONE

HOME GRID
  BROWSER  — navigate + agent fetch (CORS snapshot)
  BASH     — constitution-gated virtual shell
  WORM     — ledger viewer + verify
  CONST    — Prolog-style rules + live can_execute probe
  + agent icons (AHMAD, SENTINEL, VAULT, …)

DOCK
  📞 Call simulator
  💬 Open messages with active agent
  🌐 Browser
  ⌨  Terminal

Browser

• URL bar, back / forward / reload
• Iframe navigation for embeddable sites
• Text snapshot via CORS proxy for agent reading (sites that block iframes still yield content when fetch succeeds)
• Agents: chat /browse https://example.com or terminal browse <url>

Bash in / Bash out

Virtual shell (browser-safe — not host OS shell):

help | clear | echo | date | whoami | id | uname | pwd
agents | ls | cat | status | gates | history
worm [verify|dump] | constitution
browse <url> | fetch <url>
msg <agent> <text> | tick | export

• Bash in — command line at the bottom ($)
• Bash out — stdout/stderr in the scrollback (green / white / red)
• Acting agent selectable in the terminal app bar
• Read commands → bash_read (low risk)
• Write / dangerous → bash / bash_write (high trust required)

---

THE EMULATION STACK

┌─────────────────────────────────────────────────────────────┐
│  SOVEREIGN EMULATOR v∞.1                                    │
│  ─────────────────────────────────────────────────────────  │
│                                                             │
│  ┌─────────────────────────────────────────────────────┐   │
│  │  AGENT LAYER (34 agents)                            │   │
│  │  role · trust · domain · gates · message heap       │   │
│  │  Agents propose — they never execute unilaterally   │   │
│  └────────────────────────┬────────────────────────────┘   │
│                           │ proposal                        │
│  ┌────────────────────────▼────────────────────────────┐   │
│  │  CONSTITUTION ENGINE                                │   │
│  │  can_execute(Agent, Action)?                        │   │
│  │  trust_gte · domain_ok · resonance_ok · risk_gate   │   │
│  │  HIGH-risk + low trust → DENIED (council path stub) │   │
│  └────────────────────────┬────────────────────────────┘   │
│                           │ verdict                         │
│  ┌────────────────────────▼────────────────────────────┐   │
│  │  TOOL SURFACE                                       │   │
│  │  Browser · Bash in/out · Chat · World dump          │   │
│  └────────────────────────┬────────────────────────────┘   │
│                           │ result                          │
│  ┌────────────────────────▼────────────────────────────┐   │
│  │  WORM LEDGER                                        │   │
│  │  Every decision sealed: SHA-256 chained receipts    │   │
│  │  Append-only · tamper-evident · auditable           │   │
│  └─────────────────────────────────────────────────────┘   │
│                                                             │
│  ZERO INSTALL · RUNS IN ANY BROWSER                        │
└─────────────────────────────────────────────────────────────┘

---

THE VIRTUAL MACHINE DESIGN

SOVEREIGN VM — MEMORY LAYOUT
════════════════════════════════════════════════════

  AGENT HEAP                    WORM CHAIN
  ─────────────────────         ─────────────────────
  [0x0000] AHMAD   ● active     GENESIS
  [0x0100] BOB     ● active       ↓ a1b2c3d4...
  [0x0200] SENTINEL● active     [0001] proposal
  ...                             ↓ e5f6a7b8...
  [0xN000] INFLUENCE ● active   [0002] execute / deny
                                  ↓ ...

  BROWSER STATE                 BASH STATE
  ─────────────────────         ─────────────────────
  history[] · index             term_out · term_in
  iframe + text snapshot        acting agent selector

  CONSTITUTION
  ─────────────────────
  action/4 facts
  can_execute/2 rules
  live gate scores

---

THE CLAIM

"A virtual machine where every instruction is governed, every decision is sealed, and the entire session is reproducible from the WORM chain. You cannot claim the agent behaved — the ledger proves it did."

This is what regulated AI looks like.
Not "our AI is safe."
"Here is the cryptographic proof."

---

KEYBOARD SHORTCUTS

Key	Action
Space	Step agent clock
P	Pause / resume simulation
C	Clear ledger (testnet only)
V	Verify chain integrity
W	Dump world state to WORM
?	Show constitution
B	Open browser
T	Open terminal (bash)
H	Home screen

(Ignored while typing in an input field.)

---

CHAT SLASH COMMANDS

Command	Effect
/browse <url>	Constitution-gated browse + snapshot
/bash <cmd>	Run virtual shell as current agent
/worm	Open WORM ledger
/const	Open constitution viewer
/status	Tick, pause, chain length
/help	List slash commands

---

MENUS

• File — Dump world, export session JSON, clear ledger
• Edit — Focus terminal / browser
• View — Home, WORM, Constitution, Terminal, Browser
• Run — Step, pause, verify chain
• Tools — Bash, Browser, simulate call, force agent tick
• Help — Shortcuts + constitution

---

LOCAL RUN

Open index.html in a modern browser, or serve the folder:

# any static server
npx serve .
# or
python -m http.server 8080

Then visit http://localhost:8080.

---

NOTES / LIMITATIONS

• Bash is virtual — it does not execute host OS commands (by design: pure browser, sandboxed).
• Some sites block iframes — the browser still attempts a text snapshot for agent reading.
• Mesh chat API — when unreachable, agents reply with local governed fallbacks.
• NATS / mesh feed — best-effort; emulator stays fully usable offline.

---

⬡  SnapKitty Collective · SEIT NGO · EIN 42-2652897
⬡  collectivekitty.com · github.com/SNAPKITTYWEST
⬡  CC0 — no rights reserved — emulate freely