claude-live 0.4.0 → 0.4.2

package/client/dist/assets/index-DjcKbX6b.css

@@ -0,0 +1 @@
+@import"https://fonts.googleapis.com/css2?family=Fira+Code:wght@300;400;500&family=Space+Mono:wght@400;700&display=swap";*{margin:0;padding:0;box-sizing:border-box}html,body,#root{width:100%;height:100%;overflow:hidden;background:#050507}#root{position:relative}#root:before{content:"";position:fixed;top:0;right:0;bottom:0;left:0;background-image:url("data:image/svg+xml,%3Csvg viewBox='0 0 200 200' xmlns='http://www.w3.org/2000/svg'%3E%3Cfilter id='noise'%3E%3CfeTurbulence type='fractalNoise' baseFrequency='0.9' numOctaves='4' stitchTiles='stitch'/%3E%3C/filter%3E%3Crect width='100%25' height='100%25' filter='url(%23noise)' opacity='1'/%3E%3C/svg%3E");background-size:150px;opacity:.035;pointer-events:none;z-index:10}.hud{position:fixed;top:24px;left:24px;z-index:20;font-family:Space Mono,monospace;pointer-events:none}.hud-title{font-size:17px;font-weight:700;color:#fff;letter-spacing:-.5px;margin-bottom:14px;line-height:1}.hud-title span{color:#4ade80}.hud-stat{display:flex;align-items:baseline;gap:8px;margin-bottom:5px}.hud-label{font-size:9px;color:#666;text-transform:uppercase;letter-spacing:1px;width:52px}.hud-value{font-size:13px;color:#ccc}.hud-tool{font-weight:700}.tooltip{position:fixed;z-index:30;background:#08080ef0;border:1px solid rgba(255,255,255,.12);border-radius:6px;padding:10px 14px;pointer-events:none;transition:opacity .1s ease;-webkit-backdrop-filter:blur(16px);backdrop-filter:blur(16px);min-width:160px;box-shadow:0 8px 32px #000000b3}.tooltip-label{font-family:Fira Code,monospace;font-size:12px;color:#fff;font-weight:500;margin-bottom:2px;white-space:nowrap;max-width:260px;overflow:hidden;text-overflow:ellipsis}.tooltip-type{font-family:Space Mono,monospace;font-size:9px;color:#888;text-transform:uppercase;letter-spacing:1px;margin-bottom:7px}.tooltip-meta{font-family:Space Mono,monospace;font-size:10px;color:#aaa;margin-bottom:3px}.tooltip-count{font-family:Space Mono,monospace;font-size:9px;color:#666}.sidebar{position:fixed;right:0;top:0;height:100%;width:280px;background:#06060bf5;border-left:1px solid rgba(255,255,255,.08);z-index:25;transform:translate(100%);transition:transform .25s cubic-bezier(.16,1,.3,1);-webkit-backdrop-filter:blur(24px);backdrop-filter:blur(24px);display:flex;flex-direction:column;overflow:hidden}.sidebar--open{transform:translate(0)}.sidebar-header{padding:24px 20px 16px;border-bottom:1px solid rgba(255,255,255,.06);position:relative}.sidebar-close{position:absolute;top:20px;right:16px;width:26px;height:26px;display:flex;align-items:center;justify-content:center;color:#666;cursor:pointer;font-size:18px;border-radius:4px;transition:color .15s,background .15s;pointer-events:all;line-height:1}.sidebar-close:hover{color:#fff;background:#ffffff14}.sidebar-title{font-family:Fira Code,monospace;font-size:13px;color:#fff;font-weight:500;margin-bottom:4px;padding-right:32px;word-break:break-all}.sidebar-type{font-family:Space Mono,monospace;font-size:9px;color:#666;text-transform:uppercase;letter-spacing:1px}.sidebar-section{padding:16px 20px;border-bottom:1px solid rgba(255,255,255,.05)}.sidebar-section-label{font-family:Space Mono,monospace;font-size:9px;color:#555;text-transform:uppercase;letter-spacing:1px;margin-bottom:8px}.sidebar-action{font-family:Fira Code,monospace;font-size:15px;font-weight:500;margin-bottom:3px}.sidebar-time{font-family:Space Mono,monospace;font-size:10px;color:#777}.sidebar-count{font-family:Space Mono,monospace;font-size:24px;color:#ccc;font-weight:700}.sidebar-session{font-family:Fira Code,monospace;font-size:11px;color:#4ade80}.perm-badge{display:inline-flex;align-items:center;gap:5px;font-family:Space Mono,monospace;font-size:9px;color:#fbbf24;background:#fbbf241a;border:1px solid rgba(251,191,36,.3);border-radius:3px;padding:2px 6px;margin-top:6px}.perm-dot{width:5px;height:5px;border-radius:50%;background:#fbbf24;animation:perm-pulse 1s ease-in-out infinite}@keyframes perm-pulse{0%,to{opacity:1;transform:scale(1)}50%{opacity:.4;transform:scale(.7)}}.bottom-left-panel{position:fixed;bottom:24px;left:24px;z-index:20;display:flex;flex-direction:column;gap:10px;pointer-events:none}.bottom-left-panel>*{pointer-events:all}.event-log{display:flex;flex-direction:column;gap:5px;max-width:250px}.event-log-entry{display:flex;align-items:center;gap:5px;position:relative;overflow:hidden;animation:log-entry-in .38s cubic-bezier(.16,1,.3,1)}.event-log-entry:after{content:"";position:absolute;top:0;bottom:0;left:-60%;width:60%;background:linear-gradient(90deg,transparent 0%,var(--entry-color, #888) 60%,transparent 100%);opacity:.22;animation:log-scan .55s ease-out forwards;pointer-events:none}@keyframes log-entry-in{0%{opacity:0;transform:translate(-16px)}55%{opacity:1;transform:translate(3px)}78%{transform:translate(-1px)}to{opacity:1;transform:translate(0)}}@keyframes log-scan{0%{left:-60%;opacity:.22}to{left:130%;opacity:0}}.event-log-dot{width:5px;height:5px;border-radius:50%;flex-shrink:0;animation:log-dot-pop .42s cubic-bezier(.34,1.56,.64,1)}@keyframes log-dot-pop{0%{transform:scale(0) rotate(-90deg)}70%{transform:scale(1.5) rotate(8deg)}to{transform:scale(1) rotate(0)}}.event-log-tool{font-family:Space Mono,monospace;font-size:8px;font-weight:700;min-width:38px;text-transform:uppercase;letter-spacing:.04em;animation:log-tool-in .3s ease-out}@keyframes log-tool-in{0%{opacity:0;letter-spacing:.28em}to{opacity:1;letter-spacing:.04em}}.event-log-file{font-family:Fira Code,monospace;font-size:8px;color:#999;white-space:nowrap;overflow:hidden;text-overflow:ellipsis;max-width:100px}.event-log-session{font-family:Fira Code,monospace;font-size:7px;color:#3a3a3a;white-space:nowrap;margin-left:auto}.event-log-entry--static,.event-log-entry--static .event-log-dot,.event-log-entry--static .event-log-tool{animation:none}.event-log-entry--static:after{display:none}.event-log-history{width:280px;height:calc(100vh - 80px);overflow-y:scroll;display:flex;flex-direction:column;gap:5px;background:#020209eb;border:1px solid rgba(255,255,255,.08);border-radius:4px;padding:6px;box-sizing:border-box}.event-log-history-back{font-family:Space Mono,monospace;font-size:8px;color:#555;background:none;border:none;cursor:pointer;text-align:left;padding:0 0 4px}.event-log-history-back:hover{color:#aaa}.event-log-history-btn{font-family:Space Mono,monospace;font-size:7px;color:#333;background:none;border:none;cursor:pointer;text-align:left;padding:2px 0 0 10px}.event-log-history-btn:hover{color:#777}.help-btn{background:none;border:1px solid rgba(255,255,255,.1);border-radius:4px;color:#444;font-family:Space Mono,monospace;font-size:9px;padding:3px 8px;cursor:pointer;width:fit-content;transition:color .15s,border-color .15s;letter-spacing:.05em;text-transform:uppercase}.help-btn:hover{color:#999;border-color:#ffffff40}.top-right-buttons{position:fixed;top:24px;right:24px;z-index:50;display:flex;gap:8px;align-items:center;pointer-events:auto}.audio-toggle{background:none;border:1px solid rgba(255,255,255,.1);border-radius:4px;color:#666;cursor:pointer;transition:color .15s,border-color .15s,background-color .15s;display:flex;align-items:center;justify-content:center;width:32px;height:32px;padding:0;font-size:0}.audio-toggle svg{width:16px;height:16px;stroke:currentColor}.audio-toggle:hover{color:#999;border-color:#ffffff40;background-color:#ffffff0d}.audio-toggle:active{background-color:#ffffff1a}.autofit-toggle{background:none;border:1px solid rgba(255,255,255,.1);color:#ccc;cursor:pointer;display:inline-flex;align-items:center;justify-content:center;border-radius:4px;transition:all .2s ease;width:32px;height:32px;padding:0;font-size:0}.autofit-toggle svg{width:16px;height:16px;stroke:currentColor}.autofit-toggle:hover{color:#999;border-color:#ffffff40;background-color:#ffffff0d}.autofit-toggle:active{background-color:#ffffff1a}.hud-button{width:32px;height:32px;background:#ffffff14;border:1px solid rgba(255,255,255,.12);border-radius:4px;color:#666;cursor:pointer;font-size:14px;display:flex;align-items:center;justify-content:center;transition:color .2s}.hud-button:hover{color:#aaa}.help-overlay{position:fixed;top:0;right:0;bottom:0;left:0;z-index:60;background:#0000008c;display:flex;align-items:center;justify-content:center;-webkit-backdrop-filter:blur(4px);backdrop-filter:blur(4px)}.help-panel{background:#08080efa;border:1px solid rgba(255,255,255,.1);border-radius:8px;padding:20px 24px;min-width:200px;box-shadow:0 16px 48px #000c}.help-panel-header{display:flex;align-items:center;justify-content:space-between;margin-bottom:14px}.help-panel-title{font-family:Space Mono,monospace;font-size:9px;color:#555;text-transform:uppercase;letter-spacing:1.5px}.legend-title{font-size:8px;color:#444;text-transform:uppercase;letter-spacing:1.5px;margin-bottom:8px}.legend-items{display:flex;flex-direction:column;gap:5px}.legend-item{display:flex;align-items:center;gap:8px}.legend-dot{width:8px;height:8px;border-radius:50%;flex-shrink:0}.legend-badge{width:14px;height:14px;border-radius:50%;display:flex;align-items:center;justify-content:center;font-size:7px;font-weight:700;color:#000;flex-shrink:0}.legend-name{font-size:9px;color:#888}.legend-key{font-size:8px;color:#555;margin-left:auto;padding-left:8px}.legend-perm{display:flex;align-items:center;gap:8px;margin-top:4px;padding-top:6px;border-top:1px solid rgba(255,255,255,.04)}.legend-perm-ring{width:14px;height:14px;border-radius:50%;border:2px dashed #fbbf24;flex-shrink:0}.legend-perm-name{font-size:9px;color:#fbbf24}.debug-toggle{position:fixed;bottom:24px;right:24px;z-index:40;background:#fbbf241f;border:1px solid rgba(251,191,36,.4);border-radius:5px;color:#fbbf24e6;font-family:Space Mono,monospace;font-size:10px;font-weight:700;letter-spacing:.15em;padding:6px 12px;cursor:pointer;transition:color .15s,background .15s,border-color .15s}.debug-toggle:hover{background:#fbbf2438;border-color:#fbbf24b3;color:#fbbf24}.debug-panel{position:fixed;bottom:56px;right:24px;width:260px;background:#06060cf7;border:1px solid rgba(255,255,255,.1);border-radius:8px;z-index:40;-webkit-backdrop-filter:blur(20px);backdrop-filter:blur(20px);box-shadow:0 16px 48px #000c;transform:translateY(8px) scale(.97);opacity:0;pointer-events:none;transition:opacity .18s ease,transform .18s ease}.debug-panel--open{opacity:1;transform:translateY(0) scale(1);pointer-events:all}.debug-panel-header{display:flex;align-items:center;justify-content:space-between;padding:12px 14px 10px;border-bottom:1px solid rgba(255,255,255,.07)}.debug-panel-title{font-family:Space Mono,monospace;font-size:9px;color:#555;text-transform:uppercase;letter-spacing:1.5px}.debug-close{background:none;border:none;color:#555;font-size:16px;cursor:pointer;padding:0 2px;line-height:1;transition:color .15s}.debug-close:hover{color:#ccc}.debug-section{padding:10px 14px;border-bottom:1px solid rgba(255,255,255,.05)}.debug-section:last-child{border-bottom:none}.debug-section-label{font-family:Space Mono,monospace;font-size:8px;color:#444;text-transform:uppercase;letter-spacing:1.5px;margin-bottom:8px}.debug-session-row{display:flex;gap:6px}.debug-select{flex:1;background:#ffffff0d;border:1px solid rgba(255,255,255,.1);border-radius:4px;color:#aaa;font-family:Fira Code,monospace;font-size:10px;padding:4px 7px;outline:none;cursor:pointer}.debug-new-btn{background:#ffffff0f;border:1px solid rgba(255,255,255,.12);border-radius:4px;color:#888;font-family:Space Mono,monospace;font-size:9px;padding:4px 8px;cursor:pointer;white-space:nowrap;transition:color .15s,background .15s}.debug-new-btn:hover{color:#ccc;background:#ffffff1a}.debug-tool-grid{display:grid;grid-template-columns:repeat(3,1fr);gap:5px}.debug-tool-btn{background:#ffffff0a;border:1px solid rgba(255,255,255,.08);border-radius:4px;color:var(--tool-color, #888);font-family:Space Mono,monospace;font-size:9px;padding:6px 4px;cursor:pointer;transition:background .15s,border-color .15s,opacity .15s;text-align:center}.debug-tool-btn:hover{background:color-mix(in srgb,var(--tool-color, #888) 15%,transparent);border-color:color-mix(in srgb,var(--tool-color, #888) 40%,transparent)}.debug-tool-btn:active{opacity:.6}.perm-notifications{position:fixed;left:24px;top:130px;display:flex;flex-direction:column;gap:6px;z-index:100;pointer-events:none;max-width:280px}.perm-notifications-title{font-size:9px;letter-spacing:.2em;text-transform:uppercase;color:#fbbf24;text-align:left;margin-bottom:2px;opacity:.7}.perm-notification-item{display:flex;align-items:flex-start;gap:10px;background:#fbbf240f;border:1px solid rgba(251,191,36,.25);border-radius:3px;padding:8px 14px;animation:perm-fadein .3s ease}@keyframes perm-fadein{0%{opacity:0;transform:translateY(6px)}to{opacity:1;transform:translateY(0)}}.perm-notification-dot{width:6px;height:6px;border-radius:50%;background:#fbbf24;margin-top:3px;flex-shrink:0;animation:perm-pulse 1s ease-in-out infinite}.perm-notification-body{display:flex;flex-direction:column;gap:2px}.perm-notification-session{font-size:9px;letter-spacing:.15em;color:#fbbf2499;text-transform:uppercase}.perm-notification-msg{font-size:11px;color:#fbbf24e6;max-width:320px;white-space:nowrap;overflow:hidden;text-overflow:ellipsis}.panel-overlay{position:fixed;top:24px;right:24px;max-width:400px;max-height:calc(100vh - 48px);background:#020209f2;border:1px solid rgba(255,255,255,.1);border-radius:8px;padding:16px;overflow-y:auto;z-index:100;font-size:12px;line-height:1.6;color:#ccc}.panel-close,.panel-close-btn{position:absolute;top:8px;right:8px;background:none;border:none;color:#666;cursor:pointer;font-size:16px;padding:0;width:24px;height:24px}.panel-close:hover,.panel-close-btn:hover{color:#aaa}.panel-overlay h3{margin:0 0 12px;font-size:14px;font-weight:600;color:#fff}.panel-overlay h4{margin:8px 0 6px;font-size:12px;font-weight:600;color:#aaa;text-transform:uppercase;letter-spacing:.05em}.panel-section{margin-bottom:16px}.panel-section:last-child{margin-bottom:0}.node-types-grid{display:flex;flex-direction:column;gap:8px}.node-type-item{display:flex;align-items:center;gap:8px}.node-type-badge{width:28px;height:28px;border-radius:4px;display:flex;align-items:center;justify-content:center;font-size:11px;font-weight:600;color:#fff;flex-shrink:0}.node-type-info{display:flex;flex-direction:column;gap:2px}.node-type-name{font-size:12px;font-weight:500;color:#fff}.node-type-description{font-size:10px;color:#888}.animations-list{display:flex;flex-direction:column;gap:10px}.animation-item{font-size:11px}.animation-name{font-weight:500;color:#fff;margin-bottom:2px}.animation-description{font-size:10px;color:#888;padding-left:8px;border-left:2px solid rgba(255,255,255,.1)}

package/client/dist/index.html

@@ -9,8 +9,8 @@
       body { background: #080808; overflow: hidden; }
       #root { width: 100vw; height: 100vh; }
     </style>
-    <script type="module" crossorigin src="/assets/index-C2EVAfon.js"></script>
-    <link rel="stylesheet" crossorigin href="/assets/index-DMfuaPRG.css">
+    <script type="module" crossorigin src="/assets/index-B1BUdq7a.js"></script>
+    <link rel="stylesheet" crossorigin href="/assets/index-DjcKbX6b.css">
   </head>
   <body>
     <div id="root"></div>

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "claude-live",
-  "version": "0.4.0",
+  "version": "0.4.2",
   "description": "Realtime Claude Code activity visualizer",
   "bin": {
     "claude-live": "./bin/claude-live.js"
@@ -10,10 +10,12 @@
     "build": "cd client && vite build",
     "start": "node server/index.js",
     "test": "vitest run",
-    "prepublishOnly": "npm run build"
+    "sync-versions": "node scripts/sync-plugin-version.js",
+    "prepublishOnly": "npm run sync-versions && npm run build"
   },
   "dependencies": {
     "express": "^4.18.2",
+    "matter-js": "^0.20.0",
     "open": "^10.1.0",
     "uuid": "^9.0.0"
   },

package/scripts/sync-plugin-version.js

@@ -0,0 +1,32 @@
+#!/usr/bin/env node
+
+import { readFileSync, writeFileSync } from 'fs';
+import { resolve } from 'path';
+import { fileURLToPath } from 'url';
+
+const __dirname = resolve(fileURLToPath(import.meta.url), '..');
+
+const packagePath = resolve(__dirname, '../package.json');
+const pluginJsonPath = resolve(__dirname, '../.claude-plugin/plugin.json');
+const marketplaceJsonPath = resolve(__dirname, '../.claude-plugin/marketplace.json');
+
+// Read package.json to get the version
+const packageJson = JSON.parse(readFileSync(packagePath, 'utf8'));
+const version = packageJson.version;
+
+console.log(`Syncing plugin versions to ${version}...`);
+
+// Update plugin.json
+const pluginJson = JSON.parse(readFileSync(pluginJsonPath, 'utf8'));
+pluginJson.version = version;
+writeFileSync(pluginJsonPath, JSON.stringify(pluginJson, null, 2) + '\n');
+console.log(`✓ Updated .claude-plugin/plugin.json`);
+
+// Update marketplace.json
+const marketplaceJson = JSON.parse(readFileSync(marketplaceJsonPath, 'utf8'));
+marketplaceJson.metadata.version = version;
+marketplaceJson.plugins[0].version = version;
+writeFileSync(marketplaceJsonPath, JSON.stringify(marketplaceJson, null, 2) + '\n');
+console.log(`✓ Updated .claude-plugin/marketplace.json`);
+
+console.log(`Done! Plugin versions are now ${version}`);

package/server/index.js

@@ -10,6 +10,141 @@ const EVENTS_PER_SESSION = 50  // rolling buffer per session
 const SESSION_TIMEOUT_MS = 11 * 60 * 1000  // 11 minutes (server-side cleanup)
 const HEARTBEAT_MS = 15000
 
+// ── Ported from client constants/nodeKeys (JS) ──────────────────────────────
+
+const TOOL_COLOR_HEX = {
+  Read: '#4ade80', Edit: '#60a5fa', Write: '#60a5fa',
+  Bash: '#f59e0b', Grep: '#a78bfa', Glob: '#a78bfa',
+  WebFetch: '#f472b6', Stop: '#888888', Notification: '#34d399',
+}
+const DEFAULT_HEX = '#555555'
+const FILE_TOOLS = new Set(['Read', 'Edit', 'Write', 'Glob', 'Grep'])
+
+function nodeKeyFor(event) {
+  const t = event.tool_name
+  if (!t) {
+    if (event.hook_event_name === 'Stop') return 'session:stop'
+    if (event.hook_event_name === 'Notification') {
+      const msg = event.tool_input?.message || ''
+      return `notification:${msg.slice(0, 20)}`
+    }
+    return null
+  }
+  const input = event.tool_input || {}
+  if (FILE_TOOLS.has(t)) {
+    const fp = input.file_path || input.path || null
+    return fp ? `file:${fp}` : null
+  }
+  if (t === 'Bash') return `bash:${input.command || ''}`
+  if (t === 'WebFetch') {
+    try { return `web:${new URL(input.url || '').hostname}` } catch { return 'web:unknown' }
+  }
+  return `tool:${t}`
+}
+
+function nodeTypeFor(event) {
+  const t = event.tool_name
+  if (FILE_TOOLS.has(t || '')) return 'file'
+  if (t === 'Bash') return 'bash'
+  if (t === 'WebFetch') return 'web'
+  if (event.hook_event_name === 'Stop') return 'stop'
+  if (event.hook_event_name === 'Notification') return 'notification'
+  return 'tool'
+}
+
+function labelFor(event) {
+  const t = event.tool_name
+  const input = event.tool_input || {}
+  if (FILE_TOOLS.has(t || '')) {
+    const fp = input.file_path || input.path || ''
+    return fp.split('/').pop() || fp
+  }
+  if (t === 'Bash') return `$ ${(input.command || '').slice(0, 22)}`
+  if (t === 'WebFetch') { try { return `↗ ${new URL(input.url || '').hostname}` } catch { return '↗ web' } }
+  if (event.hook_event_name === 'Stop') return '✓ done'
+  if (event.hook_event_name === 'Notification') return (input.message || 'notification').slice(0, 24)
+  return t || event.hook_event_name || '?'
+}
+
+// ── State snapshot computation ───────────────────────────────────────────────
+
+// Compute a lightweight state snapshot from a session's event buffer.
+// Returns null if the session has no events.
+function computeSessionSnapshot(session_id, events) {
+  if (events.length === 0) return null
+
+  let label = null
+  let cwd = null
+  let stopping = false
+  let eventCount = events.length
+
+  // file nodes: persistent, grow with each touch
+  const fileNodes = new Map()  // key → { key, nodeType, label, colorHex, baseRadius }
+  // ephemeral keys seen in recent N events (they decay fast so only show recent ones)
+  const RECENT_N = 15
+  const recentEphemeralKeys = new Set()
+
+  for (let i = 0; i < events.length; i++) {
+    const event = events[i]
+
+    if (event.cwd) cwd = event.cwd
+    if (cwd && (!label || label.length <= 8)) {
+      const parts = cwd.split('/').filter(Boolean)
+      label = parts[parts.length - 1] || null
+    }
+
+    if (event.hook_event_name === 'Stop') {
+      stopping = true
+    } else if (event.hook_event_name !== 'SessionEnd') {
+      stopping = false
+    }
+
+    const key = nodeKeyFor(event)
+    if (!key) continue
+    const type = nodeTypeFor(event)
+    const isFile = type === 'file'
+    const colorHex = TOOL_COLOR_HEX[event.tool_name || event.hook_event_name] ?? DEFAULT_HEX
+
+    if (isFile) {
+      if (fileNodes.has(key)) {
+        fileNodes.get(key).baseRadius = Math.min(8, fileNodes.get(key).baseRadius + 0.3)
+      } else {
+        fileNodes.set(key, { key, nodeType: type, label: labelFor(event), colorHex, baseRadius: 2.5 })
+      }
+    } else if (i >= events.length - RECENT_N) {
+      recentEphemeralKeys.add(key)
+    }
+  }
+
+  // Build node list: files first, then recent ephemerals
+  const nodes = [...fileNodes.values()]
+
+  // Add recent ephemerals (not already in files)
+  const fileKeySet = new Set(fileNodes.keys())
+  for (let i = Math.max(0, events.length - RECENT_N); i < events.length; i++) {
+    const event = events[i]
+    const key = nodeKeyFor(event)
+    if (!key || fileKeySet.has(key)) continue
+    const type = nodeTypeFor(event)
+    const colorHex = TOOL_COLOR_HEX[event.tool_name || event.hook_event_name] ?? DEFAULT_HEX
+    if (!nodes.find(n => n.key === key)) {
+      nodes.push({ key, nodeType: type, label: labelFor(event), colorHex, baseRadius: 4 })
+    }
+  }
+
+  // Ring assignment is handled by the client (server just sends node data)
+  return {
+    session_id,
+    label: label || session_id.slice(0, 8),
+    cwd,
+    stopping,
+    eventCount,
+    nodes,  // [{ key, nodeType, label, colorHex, baseRadius }]
+  }
+}
+
+// ── Server ───────────────────────────────────────────────────────────────────
+
 function makeSessionId(ip, ts) {
   return 'unknown-' + createHash('sha1').update(ip + ts).digest('hex').slice(0, 8)
 }
@@ -28,7 +163,6 @@ function normalizeEvent(raw, remoteIp) {
     agent_type: raw.agent_type ?? null,
     cwd: raw.cwd ?? null,
     error: raw.error ?? null,
-    // Extended fields
     tool_use_id: raw.tool_use_id ?? null,
     prompt: raw.prompt ?? null,
     model: raw.model ?? null,
@@ -91,13 +225,15 @@ export function createServer({ port = 43451 } = {}) {
     res.setHeader('Cache-Control', 'no-cache')
     res.setHeader('Connection', 'keep-alive')
     res.flushHeaders()
-    // replay all events from all sessions
-    for (const session of sessionBuffers.values()) {
-      for (const event of session.events) {
-        res.write(`data: ${JSON.stringify(event)}\n\n`)
-      }
+
+    // Send state snapshot instead of replaying raw events
+    const sessions = []
+    for (const [sid, session] of sessionBuffers) {
+      const snap = computeSessionSnapshot(sid, session.events)
+      if (snap) sessions.push(snap)
     }
-    res.write(`data: ${JSON.stringify({ type: 'replay_done' })}\n\n`)
+    res.write(`data: ${JSON.stringify({ type: 'state_snapshot', sessions })}\n\n`)
+
     clients.add(res)
     const heartbeat = setInterval(() => {
       try { res.write(': heartbeat\n\n') } catch { clients.delete(res); clearInterval(heartbeat) }

package/test-agent-animations-long.js

@@ -0,0 +1,144 @@
+#!/usr/bin/env node
+// Extended test with more agents and longer animation sequence
+
+import http from 'http';
+import { URL } from 'url';
+
+const SERVER = 'http://localhost:43453';
+const SESSION_ID = 'test-session-' + Date.now();
+
+function sendHook(eventName, data = {}) {
+  return new Promise((resolve, reject) => {
+    const payload = JSON.stringify({
+      hook_event_name: eventName,
+      session_id: SESSION_ID,
+      timestamp: Date.now(),
+      ...data
+    });
+
+    const url = new URL('/hook', SERVER);
+    const options = {
+      hostname: url.hostname,
+      port: url.port || 80,
+      path: url.pathname,
+      method: 'POST',
+      headers: {
+        'Content-Type': 'application/json',
+        'Content-Length': Buffer.byteLength(payload)
+      }
+    };
+
+    const req = http.request(options, (res) => {
+      resolve(`${eventName}: ${res.statusCode}`);
+    });
+
+    req.on('error', reject);
+    req.write(payload);
+    req.end();
+  });
+}
+
+async function wait(ms) {
+  return new Promise(r => setTimeout(r, ms));
+}
+
+async function agentAction(agentId, tool, filePath, delay = 800) {
+  await sendHook('PreToolUse', {
+    tool_name: tool,
+    tool_input: { file_path: filePath, pattern: filePath },
+    agent_id: agentId
+  });
+  await wait(delay);
+  await sendHook('PostToolUse', {
+    tool_name: tool,
+    tool_input: { file_path: filePath, pattern: filePath },
+    agent_id: agentId
+  });
+}
+
+async function testAgentAnimationsLong() {
+  console.log('🚀 Extended Agent Animation Test (4 agents, many actions)\n');
+
+  try {
+    // Spawn 4 agents
+    console.log('📍 Spawning 4 agents...');
+    for (let i = 1; i <= 4; i++) {
+      await sendHook('SubagentStart', {
+        agent_id: `agent-${i}`,
+        agent_type: 'claude-opus-4-6'
+      });
+      console.log(`   Agent ${i} spawned`);
+      await wait(300);
+    }
+
+    await wait(1000);
+
+    // Agent 1: Multiple reads
+    console.log('\n📖 Agent 1: Multiple read operations...');
+    await agentAction('agent-1', 'Read', 'client/src/store.ts', 1000);
+    await wait(500);
+    await agentAction('agent-1', 'Read', 'client/src/types.ts', 1000);
+    await wait(500);
+    await agentAction('agent-1', 'Read', 'README.md', 1000);
+
+    // Agent 2: Grep operations
+    console.log('\n🔎 Agent 2: Search operations...');
+    await agentAction('agent-2', 'Grep', 'agentPositionMap', 1000);
+    await wait(500);
+    await agentAction('agent-2', 'Grep', 'getAnimationOrigin', 1000);
+
+    // Agent 3: Glob operations
+    console.log('\n📂 Agent 3: File matching operations...');
+    await agentAction('agent-3', 'Glob', 'client/src/**/*.tsx', 1200);
+    await wait(600);
+    await agentAction('agent-3', 'Glob', '**/*.ts', 1200);
+
+    // Agent 4: Mixed operations
+    console.log('\n🔄 Agent 4: Mixed operations...');
+    await agentAction('agent-4', 'Read', 'package.json', 1000);
+    await wait(500);
+    await agentAction('agent-4', 'Grep', 'vite', 1000);
+
+    await wait(1000);
+
+    // More concurrent-looking operations
+    console.log('\n⚡ Agents 1 & 2: Concurrent operations...');
+    await Promise.all([
+      agentAction('agent-1', 'Read', 'client/src/canvas/renderer.ts', 1200),
+      agentAction('agent-2', 'Grep', 'projectile', 1200)
+    ]);
+
+    await wait(800);
+
+    // Agent 3 continues
+    console.log('\n📂 Agent 3: More operations...');
+    await agentAction('agent-3', 'Glob', 'docs/**/*.md', 1200);
+
+    await wait(1000);
+
+    // Final operations before termination
+    console.log('\n🎬 Final actions before termination...');
+    await agentAction('agent-1', 'Read', 'client/src/canvas/graph.ts', 1000);
+    await wait(400);
+    await agentAction('agent-4', 'Grep', 'animation', 1000);
+    await wait(400);
+    await agentAction('agent-2', 'Read', '.gitignore', 1000);
+
+    await wait(1500);
+
+    // Terminate agents one by one
+    console.log('\n🛑 Terminating agents...');
+    for (let i = 1; i <= 4; i++) {
+      await sendHook('SubagentStop', { agent_id: `agent-${i}` });
+      console.log(`   Agent ${i} terminated (star fading out)`);
+      await wait(600);
+    }
+
+    console.log('\n✅ Extended test complete! All agents have terminated.\n');
+  } catch (err) {
+    console.error('❌ Error:', err.message);
+    process.exit(1);
+  }
+}
+
+testAgentAnimationsLong();

package/test-agent-animations.js

@@ -0,0 +1,126 @@
+#!/usr/bin/env node
+// Test script to trigger agent animation routing by sending hooks to claude-live server
+
+import http from 'http';
+import { URL } from 'url';
+
+const SERVER = 'http://localhost:43453';
+const SESSION_ID = 'test-session-' + Date.now();
+
+function sendHook(eventName, data = {}) {
+  return new Promise((resolve, reject) => {
+    const payload = JSON.stringify({
+      hook_event_name: eventName,
+      session_id: SESSION_ID,
+      timestamp: Date.now(),
+      ...data
+    });
+
+    const url = new URL('/hook', SERVER);
+    const options = {
+      hostname: url.hostname,
+      port: url.port || 80,
+      path: url.pathname,
+      method: 'POST',
+      headers: {
+        'Content-Type': 'application/json',
+        'Content-Length': Buffer.byteLength(payload)
+      }
+    };
+
+    const req = http.request(options, (res) => {
+      resolve(`${eventName}: ${res.statusCode}`);
+    });
+
+    req.on('error', reject);
+    req.write(payload);
+    req.end();
+  });
+}
+
+async function testAgentAnimations() {
+  console.log('🚀 Testing Agent Animation Routing...\n');
+
+  try {
+    // Agent 1: Spawn and read
+    console.log('📍 Agent 1: Spawning...');
+    await sendHook('SubagentStart', {
+      agent_id: 'agent-1',
+      agent_type: 'claude-opus-4-6'
+    });
+    await new Promise(r => setTimeout(r, 500));
+
+    console.log('📖 Agent 1: Reading file...');
+    await sendHook('PreToolUse', {
+      tool_name: 'Read',
+      tool_input: { file_path: 'client/src/store.ts' },
+      agent_id: 'agent-1'
+    });
+    await new Promise(r => setTimeout(r, 300));
+
+    await sendHook('PostToolUse', {
+      tool_name: 'Read',
+      tool_input: { file_path: 'client/src/store.ts' },
+      agent_id: 'agent-1'
+    });
+    await new Promise(r => setTimeout(r, 500));
+
+    // Agent 2: Spawn and read
+    console.log('📍 Agent 2: Spawning...');
+    await sendHook('SubagentStart', {
+      agent_id: 'agent-2',
+      agent_type: 'claude-opus-4-6'
+    });
+    await new Promise(r => setTimeout(r, 500));
+
+    console.log('📖 Agent 2: Reading file...');
+    await sendHook('PreToolUse', {
+      tool_name: 'Read',
+      tool_input: { file_path: 'README.md' },
+      agent_id: 'agent-2'
+    });
+    await new Promise(r => setTimeout(r, 300));
+
+    await sendHook('PostToolUse', {
+      tool_name: 'Read',
+      tool_input: { file_path: 'README.md' },
+      agent_id: 'agent-2'
+    });
+    await new Promise(r => setTimeout(r, 500));
+
+    // Agent 1: Glob operation
+    console.log('🔍 Agent 1: Globbing...');
+    await sendHook('PreToolUse', {
+      tool_name: 'Glob',
+      tool_input: { pattern: 'client/src/**/*.tsx' },
+      agent_id: 'agent-1'
+    });
+    await new Promise(r => setTimeout(r, 300));
+
+    await sendHook('PostToolUse', {
+      tool_name: 'Glob',
+      tool_input: { pattern: 'client/src/**/*.tsx' },
+      agent_id: 'agent-1'
+    });
+    await new Promise(r => setTimeout(r, 500));
+
+    // Terminate agents
+    console.log('🛑 Agent 1: Terminating...');
+    await sendHook('SubagentStop', {
+      agent_id: 'agent-1'
+    });
+    await new Promise(r => setTimeout(r, 300));
+
+    console.log('🛑 Agent 2: Terminating...');
+    await sendHook('SubagentStop', {
+      agent_id: 'agent-2'
+    });
+
+    console.log('\n✅ Test complete! Check http://localhost:43451 for animations.\n');
+  } catch (err) {
+    console.error('❌ Error:', err.message);
+    process.exit(1);
+  }
+}
+
+testAgentAnimations();

package/test-agents.js

@@ -0,0 +1,61 @@
+import fs from "fs";
+import path from "path";
+import { fileURLToPath } from "url";
+
+const __dirname = path.dirname(fileURLToPath(import.meta.url));
+
+// Get all files in current directory
+function getAllFiles(dir = ".") {
+  try {
+    return fs
+      .readdirSync(dir)
+      .filter((f) => fs.statSync(path.join(dir, f)).isFile())
+      .map((f) => path.join(dir, f));
+  } catch {
+    return [];
+  }
+}
+
+// Pick random items from array
+function pickRandom(arr, count) {
+  const shuffled = [...arr].sort(() => Math.random() - 0.5);
+  return shuffled.slice(0, Math.min(count, arr.length));
+}
+
+// Agent function
+async function agent(id, interval = 2000) {
+  console.log(`[Agent ${id}] Started`);
+
+  const tick = () => {
+    const allFiles = getAllFiles();
+    const randomCount = Math.floor(Math.random() * 3) + 1; // 1-3 files
+    const randomFiles = pickRandom(allFiles, randomCount);
+
+    console.log(
+      `[Agent ${id}] Processing ${randomFiles.length} files:`,
+      randomFiles.join(", ")
+    );
+
+    // Simulate work
+    randomFiles.forEach((file) => {
+      try {
+        const stats = fs.statSync(file);
+        console.log(`  ├─ ${file}: ${stats.size} bytes`);
+      } catch {
+        console.log(`  ├─ ${file}: (error reading)`);
+      }
+    });
+  };
+
+  // Run immediately and then every interval
+  tick();
+  setInterval(tick, interval);
+}
+
+// Start 3 agents
+console.log("Starting 3 test agents...\n");
+agent(1);
+agent(2);
+agent(3);
+
+console.log("\nPress Ctrl+C to stop\n");

package/tests/store.test.ts

@@ -66,4 +66,76 @@ describe('store', () => {
       expect(node.age).toBeGreaterThanOrEqual(80)
     }
   })
+
+  it('spawns ResponseSnakes on PostToolUse Write with words', () => {
+    const store = createStore()
+    store.addEvent(makeEvent({ id: '1', tool_input: { file_path: '/test.ts' }, tool_name: 'Write' }))
+    // First pass: replay phase (skipAnimations=true)
+    store.addEvent(makeEvent({
+      id: '2',
+      hook_event_name: 'PostToolUse',
+      tool_name: 'Write',
+      tool_input: { file_path: '/test.ts', content: 'function hello world test animation' },
+      tool_response: null
+    }), true)
+    let cluster = store.getSessions().get('sess-1')!
+    expect(cluster.promptSnakes.length).toBe(0) // No snakes during replay
+
+    // Second pass: live phase (skipAnimations=false)
+    store.addEvent(makeEvent({
+      id: '3',
+      hook_event_name: 'PostToolUse',
+      tool_name: 'Write',
+      tool_input: { file_path: '/test.ts', content: 'function hello world test animation' },
+      tool_response: null
+    }), false)
+    cluster = store.getSessions().get('sess-1')!
+    expect(cluster.promptSnakes.length).toBe(1)
+    expect(cluster.promptSnakes[0].words.length).toBeGreaterThan(0)
+    expect(cluster.promptSnakes[0].words[0]).toBe('function')
+  })
+
+  it('spawns ResponseSnakes on PostToolUse Read with file content', () => {
+    const store = createStore()
+    store.addEvent(makeEvent({ id: '1', tool_input: { file_path: '/test.ts' } }))
+    store.addEvent(makeEvent({
+      id: '2',
+      hook_event_name: 'PostToolUse',
+      tool_name: 'Read',
+      tool_input: { file_path: '/test.ts' },
+      tool_response: { type: 'text', file: { filePath: '/test.ts', content: 'const x = 42 testing' } }
+    }), false)
+    const cluster = store.getSessions().get('sess-1')!
+    expect(cluster.promptSnakes.length).toBe(1)
+    expect(cluster.promptSnakes[0].words[0]).toBe('const')
+  })
+
+  it('spawns ResponseSnakes on PostToolUse Bash with stdout', () => {
+    const store = createStore()
+    store.addEvent(makeEvent({ id: '1', tool_input: { file_path: '/test.sh' } }))
+    store.addEvent(makeEvent({
+      id: '2',
+      hook_event_name: 'PostToolUse',
+      tool_name: 'Bash',
+      tool_input: { command: 'echo hello world' },
+      tool_response: { stdout: 'hello world from bash output', stderr: '', interrupted: false }
+    }), false)
+    const cluster = store.getSessions().get('sess-1')!
+    expect(cluster.promptSnakes.length).toBe(1)
+    expect(cluster.promptSnakes[0].words[0]).toBe('hello')
+  })
+
+  it('skips ResponseSnakes during replay phase', () => {
+    const store = createStore()
+    store.addEvent(makeEvent({ id: '1', tool_input: { file_path: '/test.ts' } }))
+    store.addEvent(makeEvent({
+      id: '2',
+      hook_event_name: 'PostToolUse',
+      tool_name: 'Write',
+      tool_input: { content: 'test content words' },
+      tool_response: null
+    }), true) // skipAnimations=true
+    const cluster = store.getSessions().get('sess-1')!
+    expect(cluster.promptSnakes.length).toBe(0)
+  })
 })