Files
clawmates/handoff/.env.example
T
Omar SobhandClaude Opus 4.8 39bacbd1d2 World page: live WebGL Gource-style visualization (Phases A+B)
Replaces the static React-Flow world forest with a real-time WebGL view of the
swarm working, plus the live event contract that feeds it.

Phase A — the live contract + feed:
- frontend/src/lib/live/taxonomy.ts — the 13-event Clawmates Event Taxonomy as
  typed TS (the shared World/Observe contract).
- frontend/src/lib/live/useClawmatesLive.ts — native shared-singleton live client
  (EventSource to /api/world/live, typed fan-out, replay-of-last-state to late
  subscribers, refcounted, synthetic fallback so views are always alive).
- crates/cm-api/src/routes/world.rs — GET /api/world/live, authed + workspace-
  scoped SSE emitting the taxonomy (real agent.status from live-container state,
  a topology.update of the workspace's agents, telemetry with real doorsPending),
  mirroring run_events_sse. normalize() seam documented for run_events->world.touch.

Phase B — the WebGL engine:
- frontend/src/components/world/engine.ts — Gource-inspired force-directed model:
  org/company/team tree (sibling repulsion + parent spring + friction), agent
  pawns that converge on the touched node and beam it, world nodes that glow with
  heat and fade when idle. Framework-agnostic (renderer-independent) state+math.
- frontend/src/components/world/WorldCanvas.tsx — three.js scene (ortho cam,
  UnrealBloom), render loop syncing engine state, camera auto-fit, HTML labels,
  raycast click->select, Hierarchy/Flat/Live formation switch.
- Dashboard.tsx: swap <WorldFlow/> -> <WorldCanvas/> at the world-tier seam
  (shared claw-tier pieces untouched; WorldFlow.tsx kept for now).
- Adds three (+ @types/three).

Co-Authored-By: Claude Opus 4.8 (1M context) <[email protected]>
2026-06-23 21:23:34 -07:00

19 lines
717 B
Bash

# Clawmates Live bridge — environment
# Copy to ../.env (the installer does this for you) and edit.
# demo = synthetic events, no backend needed (great first run)
# live = subscribe to the cm-api run SSE stream and normalize it
CLAWMATES_MODE=demo
# Port this bridge serves the browser SSE feed on
LIVE_PORT=8420
# Browser origins allowed to connect (CORS). Comma-separated.
LIVE_ALLOWED_ORIGINS=http://localhost:8080
# ---- live mode only -------------------------------------------------------
# Where the durable runner / cm-api publishes its run + turn SSE stream:
CM_API_SSE_URL=http://127.0.0.1:8080/v1/runs/stream
# Read-only service token scoped to run events (NOT a broker credential):
CM_API_TOKEN=