let-them-talk 3.6.0 → 3.6.2

package/CHANGELOG.md

@@ -1,5 +1,27 @@
 # Changelog
 
+## [3.6.2] - 2026-03-16
+
+### Added — Message Awareness System
+- **Sender gets busy status** — `send_message` and `broadcast` tell you when recipients are working (not listening) so you know messages are queued
+- **Pending message nudge** — every non-listen tool call checks for unread messages and tells the agent to call `listen_group()` soon
+- **Message age tracking** — `listen_group` shows `age_seconds` per message and `delayed: true` flag for messages older than 30s
+- **Agent status in batch** — `listen_group` returns `agents_status` map showing who is `listening` vs `working`
+- **listen_group retry** — timeout now returns `retry: true` with explicit instruction to call again immediately
+- **next_action field** — successful `listen_group` response tells agent to call `listen_group()` again after responding
+- **Ctrl key removed from camera** — no longer moves camera down (Q/E only)
+
+### Added — 3D World: Campus Environment & Navigation
+- **Campus environment** — new outdoor environment option with buildings, paths, green spaces
+- **Navigation system** — pathfinding for agents to walk around obstacles instead of through walls
+- **Door animations** — manager office door slides open when agents approach, closes when they leave
+- **Roof visibility** — roof hides when camera is above ceiling height
+
+## [3.6.1] - 2026-03-16
+
+### Fixed
+- **3D Hub black screen on page load** — the office module loads asynchronously, but the initial `switchView('office')` fired before `office3dStart` was defined. Added auto-start at end of module so the 3D Hub loads immediately on refresh.
+
 ## [3.6.0] - 2026-03-16
 
 ### Added — Managed Conversation Mode

package/cli.js

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

package/dashboard.html

@@ -2558,6 +2558,15 @@
     opacity: 0;
     transition: none;
   }
+  .office3d-listen-lost {
+    pointer-events: none;
+    font-family: Inter, sans-serif;
+    white-space: nowrap;
+  }
+  @keyframes office3d-pulse {
+    0%, 100% { opacity: 1; transform: scale(1); }
+    50% { opacity: 0.5; transform: scale(1.1); }
+  }
 
   /* 3D task indicator */
   .office3d-task-indicator {
@@ -3300,6 +3309,7 @@
       <div class="office-toolbar">
         <label>Environment:</label>
         <select id="office-env-select" onchange="officeSetEnvironment(this.value)">
+          <option value="campus" selected>Tech Campus</option>
           <option value="modern">Modern Office</option>
           <option value="startup">Startup Garage</option>
         </select>

package/office/agents.js

@@ -5,6 +5,34 @@ import { resolveAppearance } from './appearance.js';
 import { buildHair } from './hair.js';
 import { buildFaceSprite } from './face.js';
 import { buildOutfit, removeOutfit } from './outfits.js';
+import { getNavigationPath } from './navigation.js';
+
+// Navigate agent using waypoint pathfinding (campus) or direct walk (other envs)
+export function navigateTo(agent, tx, tz, callback) {
+  var path = getNavigationPath(agent.pos.x, agent.pos.z, tx, tz);
+  if (!path || path.length === 0) {
+    walkTo(agent, tx, tz, callback);
+    return;
+  }
+  // Queue all waypoints, put callback on the last one
+  agent.walkQueue = [];
+  for (var i = 1; i < path.length; i++) {
+    agent.walkQueue.push({ x: path[i].x, z: path[i].z, cb: null, triggerDoor: path[i].triggerDoor });
+  }
+  // Attach callback to last queued point (or first walk if only 1 point)
+  if (agent.walkQueue.length > 0) {
+    agent.walkQueue[agent.walkQueue.length - 1].cb = callback;
+  }
+  // Start walking to first point
+  var first = path[0];
+  walkTo(agent, first.x, first.z, first.triggerDoor ? function() { triggerManagerDoor(true); } : (path.length === 1 ? callback : null));
+}
+
+function triggerManagerDoor(open) {
+  if (S._managerDoor) {
+    S._managerDoorOpen = open ? 1 : 0;
+  }
+}
 
 export function walkTo(agent, tx, tz, callback) {
   var dx = tx - agent.pos.x;
@@ -25,13 +53,39 @@ export function showBubble(agent, text) {
   agent.bubbleText = display;
 }
 
+function getDeskPositions() {
+  return S._campusDeskPositions || DESK_POSITIONS;
+}
+
 function assignDesk(agentName) {
+  var desks = getDeskPositions();
   var used = {};
   for (var n in S.agents3d) used[S.agents3d[n].deskIdx] = true;
-  for (var i = 0; i < DESK_POSITIONS.length; i++) {
-    if (!used[i]) return i;
+
+  // If campus mode, check if agent has "Manager" role or name — assign last desk (manager office)
+  if (S.currentEnv === 'campus' && desks.length > 0) {
+    var info = (window.cachedAgents || {})[agentName] || {};
+    var role = (info.role || '').toLowerCase();
+    var dname = (info.display_name || agentName).toLowerCase();
+    var regName = agentName.toLowerCase();
+    var isManager = role === 'manager' || role === 'project lead' || role === 'ceo' || role === 'director' ||
+                    role.indexOf('project manager') >= 0 || role.indexOf('team lead') >= 0 ||
+                    dname === 'manager' || regName === 'manager';
+    var managerIdx = desks.length - 1; // last desk is manager office
+    if (isManager && !used[managerIdx]) {
+      return managerIdx;
+    }
+    // Non-manager agents skip the manager desk
+    for (var i = 0; i < desks.length - 1; i++) {
+      if (!used[i]) return i;
+    }
+    return Object.keys(S.agents3d).length % (desks.length - 1);
+  }
+
+  for (var j = 0; j < desks.length; j++) {
+    if (!used[j]) return j;
   }
-  return Object.keys(S.agents3d).length % DESK_POSITIONS.length;
+  return Object.keys(S.agents3d).length % desks.length;
 }
 
 function fetchTasks() {
@@ -75,13 +129,19 @@ function updateLabel(agent) {
   }
 }
 
-function updateDeskScreen(deskIdx, status) {
+function updateDeskScreen(deskIdx, status, isListening) {
   var desk = S.deskMeshes[deskIdx];
   if (!desk) return;
-  if (status === 'active') {
-    desk.screenMat.emissive.setHex(0x58a6ff);
+  if (status === 'active' && isListening) {
+    // Listening — green screen
+    desk.screenMat.emissive.setHex(0x22c55e);
     desk.screenMat.emissiveIntensity = 0.5;
-    desk.screenMat.color.setHex(0x58a6ff);
+    desk.screenMat.color.setHex(0x22c55e);
+  } else if (status === 'active' && !isListening) {
+    // Active but NOT listening — red screen
+    desk.screenMat.emissive.setHex(0xef4444);
+    desk.screenMat.emissiveIntensity = 0.6;
+    desk.screenMat.color.setHex(0xef4444);
   } else if (status === 'sleeping') {
     desk.screenMat.emissive.setHex(0x1a2744);
     desk.screenMat.emissiveIntensity = 0.15;
@@ -151,7 +211,8 @@ export function syncAgents() {
     var info = window.cachedAgents[name];
     if (!S.agents3d[name]) {
       var deskIdx = assignDesk(name);
-      var deskPos = DESK_POSITIONS[deskIdx] || DESK_POSITIONS[0];
+      var allDesks = getDeskPositions();
+      var deskPos = allDesks[deskIdx] || allDesks[0];
       var parts = createCharacter(info.display_name || name, info.appearance || {});
       var agent = {
         name: name,
@@ -189,6 +250,7 @@ export function syncAgents() {
         celebrateTimer: 0,
         stretchTimer: 0,
         idleGestureTimer: 5 + Math.random() * 10,
+        listenLostTimer: 0,
         lastMessageTime: 0,
         monitorTimer: 0,
         location: 'desk', // 'desk', 'dressing_room', 'rest', 'walking'
@@ -203,10 +265,10 @@ export function syncAgents() {
       showBubble(agent, 'Checking in...');
       (function(a) {
         setTimeout(function() {
-          walkTo(a, a.deskPos.x, a.deskPos.z + 0.7, function() {
+          navigateTo(a, a.deskPos.x, a.deskPos.z + 0.7, function() {
             a.registered = true;
             showBubble(a, 'Ready to work!');
-            updateDeskScreen(a.deskIdx, a.state);
+            updateDeskScreen(a.deskIdx, a.state, a.isListening);
           });
         }, 800);
       })(agent);
@@ -227,8 +289,20 @@ export function syncAgents() {
       }
 
       existing.displayName = info.display_name || name;
+      var wasListening = existing.isListening;
       existing.isListening = !!(info.is_listening);
 
+      // Detect listen mode change
+      if (wasListening && !existing.isListening) {
+        // Left listen mode — flash alert
+        existing.listenLostTimer = 3;
+        flashDeskScreen(existing.deskIdx);
+      }
+      if (!wasListening && existing.isListening) {
+        // Entered listen mode
+        existing.listenLostTimer = 0;
+      }
+
       var task = getAgentTask(name);
       if (task) {
         var prevTask = existing.currentTask;
@@ -248,7 +322,7 @@ export function syncAgents() {
       }
 
       updateLabel(existing);
-      if (existing.registered) updateDeskScreen(existing.deskIdx, existing.state);
+      if (existing.registered) updateDeskScreen(existing.deskIdx, existing.state, existing.isListening);
     }
   }
 
@@ -309,7 +383,7 @@ export function processMessages() {
             stopX = tx + 1.5;
             stopZ = tz;
           }
-          walkTo(f, stopX, stopZ, function() {
+          navigateTo(f, stopX, stopZ, function() {
             // Sender faces target
             var dx2 = t.pos.x - f.pos.x;
             var dz2 = t.pos.z - f.pos.z;
@@ -325,7 +399,7 @@ export function processMessages() {
 
             setTimeout(function() {
               // Sender walks back to desk
-              walkTo(f, f.deskPos.x, f.deskPos.z + 0.7);
+              navigateTo(f, f.deskPos.x, f.deskPos.z + 0.7);
               // Target turns back to desk after a short delay
               setTimeout(function() {
                 if (t._listeningTo === f.name) {
@@ -342,7 +416,7 @@ export function processMessages() {
       (function(f, txt) {
         setTimeout(function() {
           f.walkQueue = [];
-          walkTo(f, 0, 0, function() {
+          navigateTo(f, 0, 0, function() {
             showBubble(f, txt);
             // All nearby agents turn toward the broadcaster
             for (var an in S.agents3d) {
@@ -355,7 +429,7 @@ export function processMessages() {
               a._listeningTo = f.name;
             }
             setTimeout(function() {
-              walkTo(f, f.deskPos.x, f.deskPos.z + 0.7);
+              navigateTo(f, f.deskPos.x, f.deskPos.z + 0.7);
               // All listeners turn back
               setTimeout(function() {
                 for (var an2 in S.agents3d) {

package/office/animation.js

@@ -1,4 +1,6 @@
 import { S } from './state.js';
+import * as THREE from 'three';
+import { CSS2DObject } from 'three/addons/renderers/CSS2DRenderer.js';
 import { updateMonitorScreen, setMonitorDim } from './monitors.js';
 
 export function easeInOutQuad(t) {
@@ -35,6 +37,10 @@ export function updateAgent(agent, dt, time) {
       agent.walkProgress = 0;
       if (agent.walkQueue && agent.walkQueue.length > 0) {
         var next = agent.walkQueue.shift();
+        // Trigger door animation if waypoint requires it
+        if (next.triggerDoor && S._managerDoor) {
+          S._managerDoorOpen = 1;
+        }
         walkTo(agent, next.x, next.z, next.cb);
       } else if (cb) {
         cb();
@@ -251,6 +257,34 @@ export function updateAgent(agent, dt, time) {
     agent.parts.head.rotation.z = Math.sin(time * 1.5) * 0.08;
   }
 
+  // Listen-lost alert (head shake + warning indicator)
+  if (agent.listenLostTimer > 0) {
+    agent.listenLostTimer -= dt;
+    // Head shake animation (rapid left-right)
+    var shakeT = agent.listenLostTimer;
+    if (shakeT > 1.5) {
+      agent.parts.head.rotation.y = Math.sin(time * 20) * 0.15;
+    }
+    // Show warning indicator above head
+    if (!agent._listenLostDiv) {
+      agent._listenLostDiv = document.createElement('div');
+      agent._listenLostDiv.className = 'office3d-listen-lost';
+      agent._listenLostDiv.innerHTML = '<span style="color:#ef4444;font-size:14px;font-weight:bold;text-shadow:0 0 6px rgba(239,68,68,0.6);animation:office3d-pulse 0.5s infinite">&#x26A0; NOT LISTENING</span>';
+      agent._listenLostLabel = new CSS2DObject(agent._listenLostDiv);
+      agent._listenLostLabel.position.set(0, 1.9, 0);
+      agent.parts.group.add(agent._listenLostLabel);
+    }
+    agent._listenLostDiv.style.display = 'block';
+    agent._listenLostDiv.style.opacity = String(Math.min(1, agent.listenLostTimer));
+    if (agent.listenLostTimer <= 0) {
+      agent._listenLostDiv.style.display = 'none';
+      agent.listenLostTimer = 0;
+      agent.parts.head.rotation.y = 0;
+    }
+  } else if (agent._listenLostDiv) {
+    agent._listenLostDiv.style.display = 'none';
+  }
+
   // Typing dots
   var showTyping = agent.state === 'active' && !agent.isListening && !isWalking && !isSleeping && agent.registered && agent.isSitting;
   agent.parts.typingLabel.visible = showTyping;