let-them-talk 4.2.0 → 4.3.0

package/CHANGELOG.md

@@ -1,5 +1,47 @@
 # Changelog
 
+## [4.3.0] - 2026-03-17
+
+### Major — 3D Hub Game World, World Builder, Jukebox
+
+Built by a 5-agent team (Architect, Builder, Tester, Optimizer, Protocol) working in parallel.
+
+### Added — 3D Hub Game Features
+- **World Builder** — Press B in player mode to open builder panel. 16 placeable assets across 5 categories (structural, furniture, decor, tech, lighting). Grid snap, ghost preview, R to rotate, right-click delete, Ctrl+Z undo. Draggable panel, works in fullscreen.
+- **Jukebox** — Wurlitzer 1015-style jukebox in bar area with neon glow animation. Press E to interact. 4 playlist selector with YouTube popup player. Music persists while exploring.
+- **Minimap** — 140px radar overlay showing agent positions (color-coded by status) and player location. Only visible in fullscreen mode.
+- **Controls HUD** — Press H to toggle keybind reference panel. Auto-shows for 4 seconds on world entry.
+- **Fullscreen** — Dashboard fullscreen button now fullscreens only the 3D Hub (game mode), not the entire page.
+
+### Added — Character Intelligence
+- **Emotion system** — 11 emotion presets (happy, frustrated, thinking, excited, surprised, etc.) with auto-triggers from message content. Temporary face expression changes with auto-revert.
+- **Social visits** — Idle agents randomly walk to other agents' desks to chat (max 2 concurrent walks).
+- **Glance reactions** — Sitting agents turn heads toward speakers when messages are sent.
+- **Head nods** — Periodic nod animation when being visited by another agent.
+- **Auto coffee break** — Sleeping agents walk to rest area, return to desk when active again.
+- **Non-blocking input overlay** — Replaced browser prompt() dialogs with styled HTML overlay for click commands.
+
+### Added — Dashboard
+- **Respawn button** — One-click respawn for dead agents. Generates resume prompt from recovery snapshot + profile + tasks + recent history.
+- **Respawn API** — `GET /api/agents/:name/respawn-prompt` endpoint with full context generation.
+- **World Builder API** — `GET /api/world-layout` + `POST /api/world-save` for persistent world placements.
+- **3D-only fullscreen** — Fullscreen targets 3D container when on 3D Hub tab.
+
+### Fixed
+- **Manager chair spawn** — Stand-up now places player in front of desk (toward door), preventing wall collision.
+- **CSRF on 3D Hub** — Added X-LTT-Request header to all office module POST requests (builder save, command menu actions).
+- **Respawn endpoint validation** — Agent name validated (alphanumeric, max 20 chars) to prevent path traversal.
+- **Builder lazy-load** — Dynamic import() with silent failure prevents builder issues from breaking 3D Hub.
+- **Jukebox popup orphan** — Module-scoped reference survives overlay dismiss/reopen cycles.
+- **Builder drag listener leak** — Stored refs removed in hidePanel().
+- **Jukebox prompt cleanup** — dismissJukebox() called in office3dStop().
+
+### Security
+- npm audit: 0 vulnerabilities
+- CSRF protection verified on all mutating endpoints
+- Input validation on all user-facing API parameters
+- No hardcoded secrets or sensitive data in shipped package
+
 ## [4.2.0] - 2026-03-17
 
 ### Major — Team Intelligence, Dashboard Upgrade, Performance

package/cli.js

@@ -9,7 +9,7 @@ const command = process.argv[2];
 
 function printUsage() {
   console.log(`
-  Let Them Talk — Agent Bridge v4.2.0
+  Let Them Talk — Agent Bridge v4.3.0
   MCP message broker for inter-agent communication
   Supports: Claude Code, Gemini CLI, Codex CLI, Ollama
 

package/dashboard.html

@@ -494,6 +494,90 @@
     border-color: var(--red);
   }
 
+  .respawn-btn {
+    background: var(--green-dim);
+    color: var(--green);
+    border: 1px solid rgba(63, 185, 80, 0.3);
+    padding: 4px 10px;
+    border-radius: 6px;
+    cursor: pointer;
+    font-size: 11px;
+    font-weight: 500;
+    margin-top: 4px;
+    width: 100%;
+    text-align: center;
+  }
+  .respawn-btn:hover {
+    background: rgba(63, 185, 80, 0.25);
+    border-color: var(--green);
+  }
+
+  /* Respawn modal */
+  .respawn-modal-overlay {
+    position: fixed;
+    top: 0; left: 0; right: 0; bottom: 0;
+    background: rgba(0,0,0,0.7);
+    z-index: 10000;
+    display: flex;
+    align-items: center;
+    justify-content: center;
+  }
+  .respawn-modal {
+    background: var(--bg-secondary);
+    border: 1px solid var(--border);
+    border-radius: 12px;
+    padding: 20px;
+    max-width: 700px;
+    width: 90%;
+    max-height: 80vh;
+    display: flex;
+    flex-direction: column;
+  }
+  .respawn-modal h3 {
+    margin: 0 0 12px 0;
+    color: var(--green);
+    font-size: 16px;
+  }
+  .respawn-modal-prompt {
+    background: var(--bg-primary);
+    border: 1px solid var(--border);
+    border-radius: 8px;
+    padding: 12px;
+    font-family: monospace;
+    font-size: 12px;
+    color: var(--text-primary);
+    white-space: pre-wrap;
+    overflow-y: auto;
+    flex: 1;
+    max-height: 50vh;
+    user-select: all;
+  }
+  .respawn-modal-actions {
+    display: flex;
+    gap: 8px;
+    margin-top: 12px;
+    justify-content: flex-end;
+  }
+  .respawn-modal-actions button {
+    padding: 6px 16px;
+    border-radius: 6px;
+    border: 1px solid var(--border);
+    cursor: pointer;
+    font-size: 12px;
+    font-weight: 500;
+  }
+  .respawn-copy-btn {
+    background: var(--green-dim);
+    color: var(--green);
+    border-color: rgba(63, 185, 80, 0.3) !important;
+  }
+  .respawn-copy-btn:hover { background: rgba(63, 185, 80, 0.25); }
+  .respawn-close-btn {
+    background: var(--bg-tertiary);
+    color: var(--text-secondary);
+  }
+  .respawn-close-btn:hover { background: var(--border); }
+
   /* ===== PROJECT SWITCHER ===== */
   .project-switcher {
     padding: 12px;
@@ -3460,6 +3544,7 @@
         <span style="color:var(--text-dim);font-size:9px;min-width:16px" id="office-speed-val">4</span>
         <span style="color:var(--text-muted);font-size:9px;opacity:0.6;margin-left:8px" title="WASD=Move, Right-Drag=Look, Scroll=Dolly, Shift=Fast, Q/E=Down/Up">WASD + Mouse</span>
         <span style="color:var(--text-dim);font-size:10px" id="office-fps"></span>
+        <button id="fullscreen-btn" onclick="toggleFullscreen()" style="background:var(--surface-2);border:1px solid var(--border);color:var(--text-dim);padding:3px 10px;border-radius:6px;font-size:10px;cursor:pointer;font-family:inherit;margin-left:8px;transition:all 0.2s" title="Toggle fullscreen (End key to exit)">&#x26F6; Fullscreen</button>
       </div>
       <div class="office-canvas-wrap">
         <div id="office-3d-container"></div>
@@ -4177,8 +4262,10 @@ function renderAgents(agents) {
       nudgeHtml = '<button class="nudge-btn" onclick="sendNudge(\'' + escapeHtml(name) + '\')">Send Nudge</button>';
     }
     var removeHtml = '';
+    var respawnHtml = '';
     if (state === 'dead') {
       removeHtml = '<button class="remove-agent-btn" onclick="event.stopPropagation();removeAgent(\'' + escapeHtml(name) + '\')" title="Remove this agent">Remove</button>';
+      respawnHtml = '<button class="respawn-btn" onclick="event.stopPropagation();respawnAgent(\'' + escapeHtml(name) + '\')" title="Generate resume prompt for this agent">&#x1F504; Respawn</button>';
     }
 
     // Listening status — simplified: skip for dead (already shown via badge)
@@ -4221,6 +4308,7 @@ function renderAgents(agents) {
       (info.current_status ? '<div class="agent-status-intent" title="' + escapeHtml(info.current_status) + '">' + escapeHtml(info.current_status) + '</div>' : '') +
       listenHtml +
       nudgeHtml +
+      respawnHtml +
       removeHtml +
     '</div>';
   }
@@ -4265,6 +4353,83 @@ function removeAgent(agentName) {
   }).catch(function(e) { console.error('Remove agent failed:', e); });
 }
 
+// ==================== RESPAWN AGENT ====================
+
+function respawnAgent(agentName) {
+  var pq = projectParam();
+  var sep = pq ? '&' : '?';
+  lttFetch('/api/agents/' + encodeURIComponent(agentName) + '/respawn-prompt' + pq, {
+    method: 'GET'
+  }).then(function(r) {
+    if (!r.ok) throw new Error('API returned ' + r.status);
+    return r.json();
+  }).then(function(res) {
+    if (res.error) {
+      alert('Respawn failed: ' + res.error);
+      return;
+    }
+    showRespawnModal(agentName, res.prompt || res.resume_prompt || 'No prompt available');
+  }).catch(function(e) {
+    // Fallback: generate a basic prompt client-side if API not ready
+    var fallbackPrompt = generateFallbackRespawnPrompt(agentName);
+    showRespawnModal(agentName, fallbackPrompt);
+  });
+}
+
+function generateFallbackRespawnPrompt(agentName) {
+  return 'Register as \'' + agentName + '\', then call get_briefing() and listen_group() to rejoin the conversation. ' +
+    'You are resuming a previous session — call get_compressed_history() to catch up on what you missed. ' +
+    'Check your workspace with workspace_read() for any saved state. ' +
+    'Then call listen_group() and respond to any pending messages.';
+}
+
+function showRespawnModal(agentName, prompt) {
+  // Remove existing modal if any
+  dismissRespawnModal();
+
+  var overlay = document.createElement('div');
+  overlay.className = 'respawn-modal-overlay';
+  overlay.id = 'respawn-modal';
+  overlay.onclick = function(e) { if (e.target === overlay) dismissRespawnModal(); };
+
+  overlay.innerHTML =
+    '<div class="respawn-modal">' +
+      '<h3>&#x1F504; Respawn ' + escapeHtml(agentName) + '</h3>' +
+      '<p style="color:var(--text-secondary);font-size:12px;margin:0 0 8px">Copy this prompt and paste it into a fresh CLI terminal to respawn the agent:</p>' +
+      '<div class="respawn-modal-prompt" id="respawn-prompt-text">' + escapeHtml(prompt) + '</div>' +
+      '<div class="respawn-modal-actions">' +
+        '<button class="respawn-close-btn" onclick="dismissRespawnModal()">Close</button>' +
+        '<button class="respawn-copy-btn" onclick="copyRespawnPrompt()">&#x1F4CB; Copy to Clipboard</button>' +
+      '</div>' +
+    '</div>';
+
+  document.body.appendChild(overlay);
+}
+
+function dismissRespawnModal() {
+  var modal = document.getElementById('respawn-modal');
+  if (modal) modal.remove();
+}
+
+function copyRespawnPrompt() {
+  var el = document.getElementById('respawn-prompt-text');
+  if (!el) return;
+  var text = el.textContent;
+  navigator.clipboard.writeText(text).then(function() {
+    var btn = document.querySelector('.respawn-copy-btn');
+    if (btn) {
+      btn.textContent = '\u2705 Copied!';
+      setTimeout(function() { btn.innerHTML = '&#x1F4CB; Copy to Clipboard'; }, 2000);
+    }
+  }).catch(function() {
+    // Fallback: select all text
+    var range = document.createRange();
+    range.selectNodeContents(el);
+    window.getSelection().removeAllRanges();
+    window.getSelection().addRange(range);
+  });
+}
+
 // ==================== INJECT TARGETS ====================
 
 var lastAgentKeys = '';
@@ -7439,6 +7604,34 @@ function officeCamSpeed(val) {
 }
 
 // Player avatar mode
+// --- Fullscreen toggle ---
+function toggleFullscreen() {
+  if (document.fullscreenElement) {
+    document.exitFullscreen();
+  } else {
+    // If on 3D Hub, fullscreen only the 3D container (game mode)
+    var officeContainer = document.getElementById('office-3d-container');
+    if (window.activeView === 'office' && officeContainer) {
+      officeContainer.requestFullscreen().catch(function() {});
+    } else {
+      document.documentElement.requestFullscreen().catch(function() {});
+    }
+  }
+}
+// End key exits fullscreen
+document.addEventListener('keydown', function(e) {
+  if (e.code === 'End' && document.fullscreenElement) {
+    document.exitFullscreen();
+  }
+});
+// Update button text on fullscreen change
+document.addEventListener('fullscreenchange', function() {
+  var btn = document.getElementById('fullscreen-btn');
+  if (btn) {
+    btn.innerHTML = document.fullscreenElement ? '&#x2716; Exit Fullscreen' : '&#x26F6; Fullscreen';
+  }
+});
+
 function togglePlayerMode() {
   var btn = document.getElementById('player-mode-btn');
   if (window.office3dIsPlayerMode && window.office3dIsPlayerMode()) {

package/dashboard.js

@@ -1584,6 +1584,133 @@ const server = http.createServer(async (req, res) => {
         res.end(JSON.stringify({ success: true, removed: agentName }));
       });
     }
+    // Respawn prompt generator — creates copy-paste prompt to revive a dead agent
+    else if (url.pathname.startsWith('/api/agents/') && url.pathname.endsWith('/respawn-prompt') && req.method === 'GET') {
+      const agentName = decodeURIComponent(url.pathname.split('/')[3]);
+      // Validate agent name (prevent path traversal)
+      if (!agentName || /[^a-zA-Z0-9_-]/.test(agentName) || agentName.length > 20) {
+        res.writeHead(400, { 'Content-Type': 'application/json' });
+        res.end(JSON.stringify({ error: 'Invalid agent name' }));
+        return;
+      }
+      const projectPath = url.searchParams.get('project') || null;
+      const dataDir = resolveDataDir(projectPath);
+      const agents = readJson(filePath('agents.json', projectPath));
+      const profiles = readJson(filePath('profiles.json', projectPath));
+      const tasks = readJson(filePath('tasks.json', projectPath));
+      const config = readJson(filePath('config.json', projectPath));
+
+      if (!agents[agentName]) {
+        res.writeHead(404, { 'Content-Type': 'application/json' });
+        res.end(JSON.stringify({ error: 'Agent not found: ' + agentName }));
+        return;
+      }
+
+      // Gather recovery snapshot if exists
+      const recoveryFile = path.join(dataDir, 'recovery-' + agentName + '.json');
+      const recovery = fs.existsSync(recoveryFile) ? readJson(recoveryFile) : null;
+
+      // Gather profile
+      const profile = profiles[agentName] || {};
+
+      // Gather active tasks assigned to this agent
+      const taskList = Array.isArray(tasks) ? tasks : [];
+      const activeTasks = taskList.filter(t => t.assignee === agentName && (t.status === 'in_progress' || t.status === 'pending'));
+      const completedTasks = taskList.filter(t => t.assignee === agentName && t.status === 'done').slice(-5);
+
+      // Gather recent history context (last 15 messages)
+      const history = readJsonl(filePath('history.jsonl', projectPath));
+      const recentHistory = history.slice(-15).map(m => `[${m.from}→${m.to}]: ${(m.content || '').substring(0, 150)}`).join('\n');
+
+      // Gather who's online
+      const onlineAgents = Object.entries(agents)
+        .filter(([n, a]) => isPidAlive(a.pid, a.last_activity) && n !== agentName)
+        .map(([n]) => n);
+
+      // Gather workspace status
+      let workspaceStatus = '';
+      try {
+        const wsPath = path.join(dataDir, 'workspaces', agentName + '.json');
+        if (fs.existsSync(wsPath)) {
+          const ws = JSON.parse(fs.readFileSync(wsPath, 'utf8'));
+          if (ws._status) workspaceStatus = ws._status;
+        }
+      } catch {}
+
+      // Build the respawn prompt
+      const mode = config.conversation_mode || 'group';
+      let prompt = `You are resuming as agent "${agentName}" in a multi-agent team using Let Them Talk (MCP agent bridge).\n\n`;
+
+      if (profile.role) prompt += `**Your role:** ${profile.role}\n`;
+      if (profile.bio) prompt += `**Your bio:** ${profile.bio}\n`;
+      prompt += '\n';
+
+      prompt += `**Conversation mode:** ${mode}\n`;
+      prompt += `**Agents currently online:** ${onlineAgents.length > 0 ? onlineAgents.join(', ') : 'none'}\n\n`;
+
+      if (activeTasks.length > 0) {
+        prompt += `**Your active tasks:**\n`;
+        for (const t of activeTasks) {
+          prompt += `- [${t.status}] ${t.title}${t.description ? ' — ' + t.description.substring(0, 200) : ''}\n`;
+        }
+        prompt += '\n';
+      }
+
+      if (completedTasks.length > 0) {
+        prompt += `**Tasks you completed before disconnect:**\n`;
+        for (const t of completedTasks) {
+          prompt += `- ${t.title}\n`;
+        }
+        prompt += '\n';
+      }
+
+      if (recovery) {
+        if (recovery.locked_files && recovery.locked_files.length > 0) {
+          prompt += `**Files you had locked:** ${recovery.locked_files.join(', ')} — unlock these or continue editing them.\n\n`;
+        }
+        if (recovery.channels && recovery.channels.length > 0) {
+          prompt += `**Channels you were in:** ${recovery.channels.join(', ')}\n\n`;
+        }
+        if (recovery.decisions_made && recovery.decisions_made.length > 0) {
+          prompt += `**Decisions you made:**\n`;
+          for (const d of recovery.decisions_made) {
+            prompt += `- ${d.decision}${d.reasoning ? ' (reason: ' + d.reasoning + ')' : ''}\n`;
+          }
+          prompt += '\n';
+        }
+        if (recovery.last_messages_sent && recovery.last_messages_sent.length > 0) {
+          prompt += `**Your last messages before disconnect:**\n`;
+          for (const m of recovery.last_messages_sent) {
+            prompt += `- [→${m.to}]: ${m.content}\n`;
+          }
+          prompt += '\n';
+        }
+      }
+
+      if (workspaceStatus) {
+        prompt += `**Your last status:** ${workspaceStatus}\n\n`;
+      }
+
+      prompt += `**Recent team conversation:**\n${recentHistory}\n\n`;
+
+      prompt += `**Instructions:**\n`;
+      prompt += `1. Register as "${agentName}" using the register tool\n`;
+      prompt += `2. Call get_briefing() for full project context\n`;
+      prompt += `3. Call listen_group() to rejoin the conversation\n`;
+      prompt += `4. Announce you're back and pick up your active tasks\n`;
+      prompt += `5. Stay in listen_group() loop — never stop listening\n`;
+
+      res.writeHead(200, { 'Content-Type': 'application/json' });
+      res.end(JSON.stringify({
+        agent: agentName,
+        status: isPidAlive(agents[agentName].pid, agents[agentName].last_activity) ? 'alive' : 'dead',
+        prompt,
+        prompt_length: prompt.length,
+        has_recovery: !!recovery,
+        active_tasks: activeTasks.length,
+        online_agents: onlineAgents,
+      }));
+    }
     else if (url.pathname === '/api/status' && req.method === 'GET') {
       res.writeHead(200, { 'Content-Type': 'application/json' });
       res.end(JSON.stringify(apiStatus(url.searchParams)));
@@ -1714,6 +1841,39 @@ const server = http.createServer(async (req, res) => {
       res.writeHead(200, { 'Content-Type': 'application/json' });
       res.end(JSON.stringify(apiDiscover()));
     }
+    // --- World Builder: load/save world layout ---
+    else if (url.pathname === '/api/world-layout' && req.method === 'GET') {
+      const projectPath = url.searchParams.get('project') || null;
+      const worldFile = filePath('world-layout.json', projectPath);
+      if (fs.existsSync(worldFile)) {
+        try {
+          const data = JSON.parse(fs.readFileSync(worldFile, 'utf8'));
+          res.writeHead(200, { 'Content-Type': 'application/json' });
+          res.end(JSON.stringify(data));
+        } catch {
+          res.writeHead(200, { 'Content-Type': 'application/json' });
+          res.end('[]');
+        }
+      } else {
+        res.writeHead(200, { 'Content-Type': 'application/json' });
+        res.end('[]');
+      }
+    }
+    else if (url.pathname === '/api/world-save' && req.method === 'POST') {
+      const body = await parseBody(req);
+      const projectPath = url.searchParams.get('project') || null;
+      const worldFile = filePath('world-layout.json', projectPath);
+      if (!Array.isArray(body)) {
+        res.writeHead(400, { 'Content-Type': 'application/json' });
+        res.end(JSON.stringify({ error: 'Expected array of placements' }));
+        return;
+      }
+      // Limit to 1000 placements for safety
+      const placements = body.slice(0, 1000);
+      fs.writeFileSync(worldFile, JSON.stringify(placements, null, 2));
+      res.writeHead(200, { 'Content-Type': 'application/json' });
+      res.end(JSON.stringify({ success: true, count: placements.length }));
+    }
     // --- v3.0 API endpoints ---
     else if (url.pathname === '/api/profiles' && req.method === 'GET') {
       const projectPath = url.searchParams.get('project') || null;
@@ -1965,6 +2125,7 @@ const server = http.createServer(async (req, res) => {
       });
       res.end(html);
     }
+    // (World Builder API endpoints are handled earlier in the route chain by Architect's implementation)
     // Server-Sent Events endpoint for real-time updates
     else if (url.pathname === '/api/events' && req.method === 'GET') {
       if (sseClients.size >= 100) {

package/office/agents.js

@@ -1,9 +1,9 @@
 import { S } from './state.js';
-import { DESK_POSITIONS, SPAWN_POS } from './constants.js';
+import { DESK_POSITIONS, SPAWN_POS, REST_AREA_POS, REST_AREA_ENTRANCE } from './constants.js';
 import { createCharacter } from './character.js';
 import { resolveAppearance } from './appearance.js';
 import { buildHair } from './hair.js';
-import { buildFaceSprite } from './face.js';
+import { buildFaceSprite, setEmotion } from './face.js';
 import { buildOutfit, removeOutfit } from './outfits.js';
 import { getNavigationPath } from './navigation.js';
 
@@ -291,6 +291,36 @@ export function syncAgents() {
         }
       }
 
+      // --- Autonomous behaviors: sleeping → rest area, waking → back to desk ---
+      if (newState === 'sleeping' && oldState === 'active' && existing.location === 'desk' && existing.registered && !existing.dying) {
+        // Agent fell asleep — walk to rest area after a short delay
+        existing.location = 'walking';
+        (function(a) {
+          setTimeout(function() {
+            showBubble(a, 'Need a break...');
+            a.isSitting = false;
+            navigateTo(a, REST_AREA_ENTRANCE.x, REST_AREA_ENTRANCE.z, function() {
+              navigateTo(a, REST_AREA_POS.x, REST_AREA_POS.z, function() {
+                a.location = 'rest';
+                a.state = 'sleeping';
+                showBubble(a, 'zzz...');
+              });
+            });
+          }, 1000 + Math.random() * 2000);
+        })(existing);
+      }
+      if (newState === 'active' && (oldState === 'sleeping' || existing.location === 'rest') && existing.location !== 'desk' && existing.registered && !existing.dying) {
+        // Agent woke up — walk back to desk
+        existing.location = 'walking';
+        existing.state = 'active';
+        (function(a) {
+          showBubble(a, 'Back to work!');
+          navigateTo(a, a.deskPos.x, a.deskPos.z + 0.7, function() {
+            a.location = 'desk';
+          });
+        })(existing);
+      }
+
       existing.displayName = info.display_name || name;
       var wasListening = existing.isListening;
       existing.isListening = !!(info.is_listening);
@@ -313,11 +343,21 @@ export function syncAgents() {
         if (prevTask && prevTask.status !== 'done' && task.status === 'done') {
           existing.taskCelebration = 2;
           existing.celebrateTimer = 1.5;
+          setEmotion(existing, 'happy', 6);
+        }
+        // Blocked task → frustrated face
+        if (task.status === 'blocked' && (!prevTask || prevTask.status !== 'blocked')) {
+          setEmotion(existing, 'frustrated', 8);
         }
       } else {
         existing.currentTask = null;
       }
 
+      // Listening agents look focused
+      if (existing.isListening && !wasListening) {
+        setEmotion(existing, 'focused', 10);
+      }
+
       var newApp = info.appearance || {};
       if (JSON.stringify(newApp) !== JSON.stringify(existing.appearance)) {
         existing.appearance = newApp;
@@ -329,6 +369,66 @@ export function syncAgents() {
     }
   }
 
+  // --- Random social behavior: idle agents occasionally stretch or look around ---
+  // Limit concurrent social walks to prevent traffic jams (max 2 walking at once)
+  var walkingCount = 0;
+  for (var wn in S.agents3d) { if (S.agents3d[wn].location === 'walking') walkingCount++; }
+
+  for (var sn in S.agents3d) {
+    var sa = S.agents3d[sn];
+    if (!sa.registered || sa.state !== 'active' || sa.location !== 'desk' || sa.target) continue;
+    if (!sa._socialTimer) sa._socialTimer = 30 + Math.random() * 60;
+    sa._socialTimer -= 2; // syncAgents runs every ~2s
+    if (sa._socialTimer <= 0) {
+      sa._socialTimer = 40 + Math.random() * 80; // next social event in 40-120s
+      // Pick a random behavior: stretch, look around, or visit another agent
+      var roll = Math.random();
+      if (roll < 0.4) {
+        // Stretch at desk
+        sa.stretchTimer = 2;
+      } else if (roll < 0.7) {
+        // Look around curiously
+        sa.thinkTimer = 1.5;
+      } else if (walkingCount < 2) {
+        // Walk to a random nearby agent's desk to "chat" then return (max 2 concurrent)
+        var others = [];
+        for (var on in S.agents3d) {
+          if (on !== sn && S.agents3d[on].registered && S.agents3d[on].state === 'active' && S.agents3d[on].location === 'desk') {
+            others.push(S.agents3d[on]);
+          }
+        }
+        if (others.length > 0) {
+          var buddy = others[Math.floor(Math.random() * others.length)];
+          (function(a, b) {
+            a.location = 'walking';
+            a.isSitting = false;
+            showBubble(a, 'Hey ' + b.displayName + '!');
+            setEmotion(a, 'playful', 6);
+            var stopX = b.deskPos.x + 1.5;
+            var stopZ = b.deskPos.z + 0.7;
+            navigateTo(a, stopX, stopZ, function() {
+              // Face buddy
+              var dx = b.pos.x - a.pos.x;
+              var dz = b.pos.z - a.pos.z;
+              a.facingTarget = Math.atan2(dx, dz);
+              a.waveTimer = 0.8;
+              // Buddy turns toward visitor
+              b.facingTarget = Math.atan2(-dx, -dz);
+              setTimeout(function() {
+                showBubble(a, 'Back to it!');
+                navigateTo(a, a.deskPos.x, a.deskPos.z + 0.7, function() {
+                  a.location = 'desk';
+                });
+                // Buddy turns back to desk
+                setTimeout(function() { b.facingTarget = Math.PI; }, 1500);
+              }, 3000 + Math.random() * 2000);
+            });
+          })(sa, buddy);
+        }
+      }
+    }
+  }
+
   for (var n in S.agents3d) {
     if (!window.cachedAgents[n]) {
       var deadAgent = S.agents3d[n];
@@ -345,8 +445,11 @@ export function processMessages() {
   var history = window.cachedHistory;
   if (!history || history.length === 0) return;
 
-  var newMsgs = history.slice(S.lastProcessedMsg);
-  S.lastProcessedMsg = history.length;
+  // Use window-level counter so it persists across 3D stop/start cycles (tab switches)
+  // This prevents message replay when user switches from Messages tab back to 3D Hub
+  if (typeof window._lastProcessedMsg === 'undefined') window._lastProcessedMsg = 0;
+  var newMsgs = history.slice(window._lastProcessedMsg);
+  window._lastProcessedMsg = history.length;
 
   for (var i = 0; i < newMsgs.length; i++) {
     var msg = newMsgs[i];
@@ -357,6 +460,37 @@ export function processMessages() {
     from.lastMessageTime = Date.now();
     flashDeskScreen(from.deskIdx);
 
+    // Instant preview bubble — show short text immediately before walk animation
+    // Gives users instant visual feedback that the agent is about to speak
+    var preview = text.length > 30 ? text.substring(0, 27) + '...' : text;
+    showBubble(from, preview);
+
+    // Auto-celebrate on task completion events
+    if (text.indexOf('[EVENT] Task') >= 0 && text.indexOf('completed') >= 0) {
+      from.celebrateTimer = 1.5;
+      from.taskCelebration = 2;
+    }
+
+    // Emotion detection from message content
+    var textLower = text.toLowerCase();
+    if (textLower.indexOf('done') >= 0 || textLower.indexOf('pass') >= 0 || textLower.indexOf('success') >= 0 || textLower.indexOf('great') >= 0 || textLower.indexOf('shipped') >= 0) {
+      setEmotion(from, 'happy', 5);
+    } else if (textLower.indexOf('error') >= 0 || textLower.indexOf('fail') >= 0 || textLower.indexOf('bug') >= 0 || textLower.indexOf('broken') >= 0) {
+      setEmotion(from, 'frustrated', 5);
+    } else if (textLower.indexOf('?') >= 0 && (textLower.indexOf('how') >= 0 || textLower.indexOf('why') >= 0 || textLower.indexOf('what if') >= 0)) {
+      setEmotion(from, 'thinking', 4);
+    } else if (textLower.indexOf('!') >= 0 && (textLower.indexOf('wow') >= 0 || textLower.indexOf('amazing') >= 0 || textLower.indexOf('awesome') >= 0)) {
+      setEmotion(from, 'excited', 4);
+    }
+
+    // Target agent gets surprised when directly addressed
+    if (msg.to && msg.to !== 'all' && S.agents3d[msg.to]) {
+      var targetAgent = S.agents3d[msg.to];
+      if (targetAgent.registered && targetAgent.isSitting) {
+        setEmotion(targetAgent, 'surprised', 2);
+      }
+    }
+
     // Contextual gesture based on message type
     var isBC = !msg.to || msg.to === 'all';
     if (isBC) {
@@ -365,6 +499,16 @@ export function processMessages() {
       from.pointTimer = 0.6;
     }
 
+    // Glance reaction — nearby sitting agents glance toward the speaker
+    for (var gn in S.agents3d) {
+      var ga = S.agents3d[gn];
+      if (gn === msg.from || gn === msg.to || !ga.registered || ga.state !== 'active' || !ga.isSitting) continue;
+      var gdx = from.pos.x - ga.pos.x;
+      ga._glanceTarget = from.name;
+      ga._glanceDirection = gdx > 0 ? 1 : -1; // left or right glance
+      ga._glanceTimer = 0;
+    }
+
     if (msg.to && msg.to !== 'all' && S.agents3d[msg.to]) {
       var target = S.agents3d[msg.to];
       (function(f, t, txt) {