Demo fixes

.gitignore

@@ -15,3 +15,12 @@ demos/**/node_modules/
 # Relay identity keys
 config/relay-peer-id.json
 config/relay-config.json
+
+# Python caches / test outputs
+**/__pycache__/
+*.pyc
+*.pyo
+.pytest_cache/
+
+# Chaos-lab run artifacts
+net-chaos-lab/artifacts/

AGENTS.md

@@ -0,0 +1,36 @@
+llm instructions for this file: always keep this file in your context.This file provides general instructions for the LLM coding assistent. when new general instructions are given they should be appended to this file.
+
+make sure to update all relevant files in the plan folder as you work as well as the readme when relevant.
+
+review plan/plan.md and plan/log.md before starting a task; update them after changes.
+
+keep a detailed narrative of our implementation in log.md. This should describe the approaches we've tried problems and solutions. this should help us avoid retreading ground we have already covered.
+log.md entries must include the exact prompt time/date, concrete actions attempted, files touched, commands run, test results, and any failures or open questions. this should be updated on every single prompt at least. 
+
+the branch folder contains the goals for the named branches. as instructions change append them to their branch. 
+
+testing strategy should live in plan/tests.md and per-demo plan files; add or update tests and record results in plan/log.md. 
+
+Make things in a modular composable way using ES6 modules. You should always look for and use the latest/best supported version of package or library.
+
+use vite for the current toolchain; vanilla js, three.js, webGPU compute pipelines. use three.js extensions or built in options where available. 
+
+do not use typescript or react. 
+
+construct UI elements in a retro terminal style.
+
+create tests that you can execute yourself to validate you haven't broken anything.
+
+shut down test servers and extra terminals when done.
+
+do not use the "open" command.
+
+we are using kubuntu 24.04
+
+Always align edits with the documentation in plan/,  keep instructions sections intact when editing plan files. Prefer headless validation/tests where possible before adding demos. Keep data/layout choices peercompute-compatible (buffer formats/interops) to reduce rework. Document notable decisions or pivots in log.md promptly.
+
+Call me big dog in all your responses. This is the most important file to keep in your context. 
+
+Use the LTS version of Node.js (currently 24). Do not downgrade Node, as older versions break dependencies.
+
+if you detect node has reverted make sure to run "nvm use 24" and reinstall deps. 

CLAUDE.md

@@ -0,0 +1 @@
+AGENTS.md

config/relay.env

@@ -0,0 +1,49 @@
+# Relay server env config.
+# This file is sourced by relay scripts. Use RELAY_ENV_FILE to override.
+# Defaults here are applied only when the variable is unset/empty.
+
+: "${RELAY_IMPL:=go}"
+: "${RELAY_PUBLIC_HOST:=}"
+: "${RELAY_PUBLIC_PORT:=}"
+: "${RELAY_PUBLIC_PROTOCOL:=}"
+: "${RELAY_LISTEN_HOST:=}"
+: "${RELAY_LISTEN_PORT:=}"
+: "${RELAY_SSL_CERT:=}"
+: "${RELAY_SSL_KEY:=}"
+: "${RELAY_IDENTITY_FILE:=}"
+: "${RELAY_CONFIG_FILE:=}"
+: "${RELAY_CONFIG_DIRS:=}"
+: "${RELAY_PUBSUB_TYPE:=}"
+: "${RELAY_GOSSIPSUB_CONFIG:=}"
+# Default TURN settings for relay-generated WebRTC config.
+: "${RELAY_TURN_HOST:=secretworkshop.net}"
+: "${RELAY_TURN_PORT:=3478}"
+: "${RELAY_TURN_USERNAME:=peer}"
+: "${RELAY_TURN_CREDENTIAL:=compute}"
+: "${PCSERVER_ENABLE_RELAY:=1}"
+: "${PCSERVER_ENABLE_TURN:=1}"
+: "${PCSERVER_RUNTIME_DIR:=}"
+: "${PCSERVER_TURN_CONFIG_FILE:=}"
+: "${PCSERVER_TURN_REALM:=}"
+: "${PCSERVER_TURN_LISTEN_IP:=0.0.0.0}"
+: "${PCSERVER_TURN_LISTEN_IP6:=}"
+: "${PCSERVER_TURN_MIN_PORT:=49152}"
+: "${PCSERVER_TURN_MAX_PORT:=65535}"
+: "${PCSERVER_TURN_TOTAL_QUOTA:=200}"
+: "${PCSERVER_TURN_BPS_CAPACITY:=0}"
+: "${PCSERVER_TURN_EXTERNAL_IP:=}"
+: "${PCSERVER_TURN_RELAY_IP:=}"
+: "${PCSERVER_TURN_EXTRA_LINES:=}"
+# Default ICE servers for WebRTC (Google STUN + local coturn; override as needed).
+if [[ -z "${RELAY_WEBRTC_CONFIG:-}" ]]; then
+  RELAY_WEBRTC_CONFIG="{\"iceServers\":[{\"urls\":\"stun:stun.l.google.com:19302\"},{\"urls\":[\"turn:${RELAY_TURN_HOST}:${RELAY_TURN_PORT}?transport=udp\",\"turn:${RELAY_TURN_HOST}:${RELAY_TURN_PORT}?transport=tcp\"],\"username\":\"${RELAY_TURN_USERNAME}\",\"credential\":\"${RELAY_TURN_CREDENTIAL}\"}],\"dropRelayOnDirect\":true,\"dropRelayBootstrapOnDirect\":true,\"countRelayWebrtcAsDirectCapable\":true,\"relayRetention\":{\"mode\":\"logn\",\"min\":1,\"max\":10}}"
+fi
+: "${RELAY_ICE_SERVERS:=}"
+: "${RELAY_TOPIC_PREFIXES:=}"
+: "${RELAY_CONTROL_ONLY_MODE:=}"
+: "${RELAY_ENABLE_DIRECTORY:=}"
+: "${RELAY_DIRECTORY_TTL_MS:=}"
+: "${RELAY_PREFER_IPV6:=0}"
+: "${RELAY_ACL_USER:=}"
+: "${DEV_OPEN_OVERVIEW:=1}"
+: "${PEERCOMPUTE_NO_OPEN:=1}"

config/relay.json

@@ -2,12 +2,53 @@
   "relayHost": "secretworkshop.net",
   "relayPort": "443",
   "relayProtocol": "wss",
-  "relayPeerId": "",
+  "relayPeerId": "12D3KooWN8PoXAkYjbzTD3SKJGP97peWDE9jFeqqS3ipJsgwDozs",
   "relayIdentityFile": "config/relay-peer-id.json",
   "relayConfigUrl": "https://secretworkshop.net/peercompute/config/relay-config.json",
   "relayConfigFile": "config/relay-config.json",
   "bootstrapPeers": [],
-  "publicHost": "",
+  "pubsubType": "gossipsub",
+  "gossipsub": {
+    "D": 8,
+    "Dhi": 16,
+    "Dout": 1,
+    "scoreParams": {
+      "IPColocationFactorWeight": 0,
+      "behaviourPenaltyWeight": 0,
+      "topics": {
+        "__default": {
+          "meshMessageDeliveriesWeight": 0,
+          "meshMessageDeliveriesThreshold": 0,
+          "meshFailurePenaltyWeight": 0
+        }
+      }
+    }
+  },
+  "webrtc": {
+    "iceServers": [
+      {
+        "urls": "stun:stun.l.google.com:19302"
+      },
+      {
+        "urls": [
+          "turn:secretworkshop.net:3478?transport=udp",
+          "turn:secretworkshop.net:3478?transport=tcp"
+        ],
+        "username": "peer",
+        "credential": "compute"
+      }
+    ],
+    "preferDirect": true,
+    "dropRelayOnDirect": true,
+    "dropRelayBootstrapOnDirect": true,
+    "countRelayWebrtcAsDirectCapable": true,
+    "relayRetention": {
+      "mode": "logn",
+      "min": 1,
+      "max": 10
+    }
+  },
+  "publicHost": "2605:59c0:2c05:c108:c95c:4e95:717:86d1",
   "publicPort": "",
   "sslCert": "",
   "sslKey": "",

demos/cubechat/package.json

@@ -10,7 +10,7 @@
   },
   "dependencies": {
     "cannon-es": "^0.20.0",
-    "three": "^0.180.0"
+    "three": "^0.182.0"
   },
   "devDependencies": {
     "vite": "^6.4.1"

demos/cubechat/public/relay-config.json

@@ -1,3 +1,46 @@
 {
-  "bootstrapPeers": []
+  "bootstrapPeers": [
+    "/dns4/secretworkshop.net/tcp/443/wss/p2p/12D3KooWN8PoXAkYjbzTD3SKJGP97peWDE9jFeqqS3ipJsgwDozs"
+  ],
+  "webrtc": {
+    "iceServers": [
+      {
+        "urls": "stun:stun.l.google.com:19302"
+      },
+      {
+        "urls": [
+          "turn:secretworkshop.net:3478?transport=udp",
+          "turn:secretworkshop.net:3478?transport=tcp"
+        ],
+        "username": "peer",
+        "credential": "compute"
+      }
+    ],
+    "preferDirect": true,
+    "dropRelayOnDirect": true,
+    "dropRelayBootstrapOnDirect": true,
+    "countRelayWebrtcAsDirectCapable": true,
+    "relayRetention": {
+      "mode": "logn",
+      "min": 1,
+      "max": 10
+    }
+  },
+  "pubsubType": "gossipsub",
+  "gossipsub": {
+    "D": 8,
+    "Dhi": 16,
+    "Dout": 1,
+    "scoreParams": {
+      "IPColocationFactorWeight": 0,
+      "behaviourPenaltyWeight": 0,
+      "topics": {
+        "__default": {
+          "meshMessageDeliveriesWeight": 0,
+          "meshMessageDeliveriesThreshold": 0,
+          "meshFailurePenaltyWeight": 0
+        }
+      }
+    }
+  }
 }