let-them-talk 3.6.1 → 3.6.2

package/office/environment.js

@@ -2,6 +2,7 @@ import * as THREE from 'three';
 import { CSS2DObject } from 'three/addons/renderers/CSS2DRenderer.js';
 import { S } from './state.js';
 import { FLOOR_W, FLOOR_D, DESK_POSITIONS, RECEPTION_POS, ENVS, DRESSING_ROOM_POS, REST_AREA_POS } from './constants.js';
+import { buildCampusEnvironment, getCampusDeskPositions } from './campus-env.js';
 
 export function buildEnvironment() {
   if (S.furnitureGroup) {
@@ -27,6 +28,15 @@ export function buildEnvironment() {
   }
   S.furnitureGroup = new THREE.Group();
   S.deskMeshes = [];
+
+  if (S.currentEnv === 'campus') {
+    buildCampusEnvironment();
+    // Store campus desk positions for agent assignment
+    S._campusDeskPositions = getCampusDeskPositions();
+    S.scene.add(S.furnitureGroup);
+    return;
+  }
+
   var env = ENVS[S.currentEnv] || ENVS.modern;
 
   buildFloor(env);

package/office/index.js

@@ -5,7 +5,7 @@ import { DESK_POSITIONS, DRESSING_ROOM_POS, DRESSING_ROOM_ENTRANCE, REST_AREA_PO
 import { initScene } from './scene.js';
 import { buildEnvironment, updateTVScreen } from './environment.js';
 import { updateAgent } from './animation.js';
-import { syncAgents, processMessages, walkTo, showBubble } from './agents.js';
+import { syncAgents, processMessages, walkTo, navigateTo, showBubble } from './agents.js';
 // Side-effect: registers window.officeGetAppearance
 import './appearance.js';
 
@@ -141,8 +141,8 @@ function executeCommand(agentName, action) {
       agent.location = 'walking';
       agent.isSitting = false;
       showBubble(agent, 'Going to change!');
-      walkTo(agent, DRESSING_ROOM_ENTRANCE.x, DRESSING_ROOM_ENTRANCE.z, function() {
-        walkTo(agent, DRESSING_ROOM_POS.x, DRESSING_ROOM_POS.z, function() {
+      navigateTo(agent, DRESSING_ROOM_ENTRANCE.x, DRESSING_ROOM_ENTRANCE.z, function() {
+        navigateTo(agent, DRESSING_ROOM_POS.x, DRESSING_ROOM_POS.z, function() {
           agent.location = 'dressing_room';
           agent.isSitting = false;
           showBubble(agent, 'Time for a new look!');
@@ -161,8 +161,8 @@ function executeCommand(agentName, action) {
       agent.location = 'walking';
       agent.isSitting = false;
       showBubble(agent, 'Need a break...');
-      walkTo(agent, REST_AREA_ENTRANCE.x, REST_AREA_ENTRANCE.z, function() {
-        walkTo(agent, REST_AREA_POS.x, REST_AREA_POS.z, function() {
+      navigateTo(agent, REST_AREA_ENTRANCE.x, REST_AREA_ENTRANCE.z, function() {
+        navigateTo(agent, REST_AREA_POS.x, REST_AREA_POS.z, function() {
           agent.location = 'rest';
           agent.state = 'sleeping';
           agent.isSitting = false;
@@ -176,7 +176,7 @@ function executeCommand(agentName, action) {
       agent.state = 'active';
       agent.isSitting = false;
       showBubble(agent, 'Back to work!');
-      walkTo(agent, agent.deskPos.x, agent.deskPos.z + 0.7, function() {
+      navigateTo(agent, agent.deskPos.x, agent.deskPos.z + 0.7, function() {
         agent.location = 'desk';
         agent.registered = true;
       });
@@ -201,8 +201,8 @@ function waitForEditorClose(agent) {
       if (agent.location === 'dressing_room') {
         agent.location = 'walking';
         showBubble(agent, 'Looking good!');
-        walkTo(agent, DRESSING_ROOM_ENTRANCE.x, DRESSING_ROOM_ENTRANCE.z, function() {
-          walkTo(agent, agent.deskPos.x, agent.deskPos.z + 0.7, function() {
+        navigateTo(agent, DRESSING_ROOM_ENTRANCE.x, DRESSING_ROOM_ENTRANCE.z, function() {
+          navigateTo(agent, agent.deskPos.x, agent.deskPos.z + 0.7, function() {
             agent.location = 'desk';
             agent.registered = true;
           });
@@ -226,6 +226,29 @@ function animate() {
     updateAgent(S.agents3d[name], dt, time);
   }
 
+  // Hide roof when camera is above ceiling height
+  if (S._roofGroup) {
+    S._roofGroup.visible = S.camera.position.y < 6.5;
+  }
+
+  // Manager office door animation — opens when agent is near the door
+  if (S._managerDoor && S._managerOfficePos) {
+    var doorX = S._managerOfficePos.x;
+    var doorZ = S._managerOfficePos.z - 3.5; // front of office
+    var shouldOpen = false;
+    for (var an in S.agents3d) {
+      var ag = S.agents3d[an];
+      if (ag.target || ag.location === 'walking') {
+        var adx = ag.pos.x - doorX;
+        var adz = ag.pos.z - doorZ;
+        if (Math.sqrt(adx * adx + adz * adz) < 3) { shouldOpen = true; break; }
+      }
+    }
+    S._managerDoorOpen = shouldOpen ? 1 : 0;
+    S._managerDoorLerp += (S._managerDoorOpen - S._managerDoorLerp) * Math.min(1, dt * 4);
+    S._managerDoor.position.x = S._managerDoorLerp * 1.3; // slide open to the right
+  }
+
   // Update TV screen every ~0.5s for smooth ticker
   if (!S._tvTimer) S._tvTimer = 0;
   S._tvTimer += dt;
@@ -309,17 +332,24 @@ window.office3dSetEnvironment = function(env) {
   if (env === S.currentEnv) return;
   S.currentEnv = env;
   if (S.scene) {
-    buildEnvironment();
-    var i = 0;
+    // Remove all existing agents so they get recreated with proper desk assignments
     for (var name in S.agents3d) {
       var agent = S.agents3d[name];
-      if (i < DESK_POSITIONS.length) {
-        agent.deskIdx = i;
-        agent.deskPos = { x: DESK_POSITIONS[i].x, z: DESK_POSITIONS[i].z };
-        walkTo(agent, agent.deskPos.x, agent.deskPos.z + 0.7);
-      }
-      i++;
+      S.scene.remove(agent.parts.group);
+      agent.parts.group.traverse(function(child) {
+        if (child.geometry) child.geometry.dispose();
+        if (child.material) {
+          if (child.material.map) child.material.map.dispose();
+          child.material.dispose();
+        }
+      });
     }
+    S.agents3d = {};
+    S.lastProcessedMsg = 0;
+    buildEnvironment();
+    // syncAgents will recreate all agents with correct desk assignments
+    syncAgents();
+    processMessages();
   }
 };
 

package/office/navigation.js

@@ -0,0 +1,263 @@
+import { S } from './state.js';
+
+// ============================================================
+// NAVIGATION SYSTEM — Waypoint graph pathfinding
+// Agents walk along connected waypoints to avoid walls/objects
+// ============================================================
+
+// Manager office geometry reference:
+// Office group at (12, 5), size 8x7, walls at:
+//   Front (door): z = 5 - 3.5 = 1.5   (door at center x=12)
+//   Back:         z = 5 + 3.5 = 8.5
+//   Left:         x = 12 - 4  = 8
+//   Right:        x = 12 + 4  = 16
+// Glass partition at z = -7 (between workspace and rec)
+// Glass partition at x = -8 (between designer and main)
+
+var CAMPUS_WAYPOINTS = [
+  // === LOBBY / ENTRANCE ===
+  { id: 'spawn',         x: 0,     z: 14 },
+  { id: 'lobby',         x: 0,     z: 10 },
+  { id: 'lobby_left',    x: -6,    z: 10 },
+  { id: 'lobby_right',   x: 6,     z: 10 },
+
+  // === MAIN CORRIDOR (runs along z=6, above workspace) ===
+  { id: 'corr_L',        x: -8,    z: 7 },
+  { id: 'corr_CL',       x: -3,    z: 7 },
+  { id: 'corr_C',        x: 0,     z: 7 },
+  { id: 'corr_CR',       x: 3,     z: 7 },
+  { id: 'corr_R',        x: 7,     z: 7 },
+
+  // === WORKSPACE ZONE (center area, between glass partitions) ===
+  { id: 'work_N',        x: 0,     z: 4 },    // north end
+  { id: 'work_NW',       x: -5,    z: 4 },
+  { id: 'work_NE',       x: 5,     z: 4 },
+  { id: 'work_W',        x: -5,    z: 0 },
+  { id: 'work_C',        x: 0,     z: 0 },
+  { id: 'work_E',        x: 5,     z: 0 },
+  { id: 'work_SW',       x: -5,    z: -3 },
+  { id: 'work_S',        x: 0,     z: -5 },
+  { id: 'work_SE',       x: 5,     z: -3 },
+
+  // === DESIGNER WING (left of glass partition x=-8) ===
+  { id: 'design_gate',   x: -8,    z: 3 },   // gap in partition
+  { id: 'design_N',      x: -12,   z: 3 },
+  { id: 'design_C',      x: -12.5, z: 0 },
+  { id: 'design_S',      x: -12,   z: -3 },
+
+  // === MANAGER OFFICE (right side, enclosed glass room) ===
+  // Office walls: left x=8, right x=16, front z=1.5, back z=8.5
+  // Door at front wall center (x=12, z=1.5)
+  // Path must go AROUND the left-front corner, then to door from outside
+  { id: 'mgr_hallway',   x: 7,     z: 3 },    // south of corridor, OUTSIDE left wall (x<8)
+  { id: 'mgr_corner',    x: 7,     z: 0 },    // past the front-left corner (x<8, z<1.5)
+  { id: 'mgr_outside',   x: 12,    z: 0 },    // in front of door, OUTSIDE front wall (z<1.5)
+  { id: 'mgr_doorstep',  x: 12,    z: 1.5 },  // at the door threshold (triggers door open)
+  { id: 'mgr_entry',     x: 12,    z: 3 },    // just inside the door
+  { id: 'mgr_center',    x: 12,    z: 5 },    // middle of office
+  { id: 'mgr_desk',      x: 12,    z: 7 },    // at the desk/chair
+
+  // === BACK ZONE CORRIDOR (runs along z=-7 to z=-8, south of glass partition) ===
+  { id: 'back_gate',     x: 0,     z: -6.5 },  // gap in glass partition
+  { id: 'back_L',        x: -8,    z: -8 },
+  { id: 'back_C',        x: 0,     z: -8 },
+  { id: 'back_R',        x: 8,     z: -8 },
+
+  // === BAR (back left) ===
+  { id: 'bar_entry',     x: -10,   z: -10 },
+  { id: 'bar_center',    x: -14,   z: -12 },
+
+  // === REC CENTER (back center) ===
+  { id: 'rec_entry',     x: 0,     z: -10 },
+  { id: 'rec_center',    x: 0,     z: -12 },
+
+  // === GYM (back right) ===
+  { id: 'gym_entry',     x: 10,    z: -10 },
+  { id: 'gym_center',    x: 14,    z: -12 },
+
+  // === MEZZANINE / STAIRS ===
+  { id: 'stairs_bot',    x: 20,    z: -5 },
+  { id: 'stairs_top',    x: 20,    z: -8 },
+  { id: 'mezz_C',        x: 0,     z: -13 },
+
+  // === REST / DRESSING (right wing, for old office compat) ===
+  { id: 'rest_entry',    x: 7.5,   z: -5.5 },
+  { id: 'dress_entry',   x: 7.5,   z: -1.5 },
+];
+
+var CAMPUS_CONNECTIONS = [
+  // Lobby connections
+  ['spawn', 'lobby'],
+  ['lobby', 'lobby_left'],
+  ['lobby', 'lobby_right'],
+  ['lobby', 'corr_C'],
+  ['lobby_left', 'corr_L'],
+  ['lobby_right', 'corr_R'],
+
+  // Main corridor (horizontal)
+  ['corr_L', 'corr_CL'],
+  ['corr_CL', 'corr_C'],
+  ['corr_C', 'corr_CR'],
+  ['corr_CR', 'corr_R'],
+
+  // Corridor → workspace
+  ['corr_C', 'work_N'],
+  ['corr_CL', 'work_NW'],
+  ['corr_CR', 'work_NE'],
+
+  // Workspace grid
+  ['work_N', 'work_NW'],
+  ['work_N', 'work_NE'],
+  ['work_N', 'work_C'],
+  ['work_NW', 'work_W'],
+  ['work_NE', 'work_E'],
+  ['work_W', 'work_C'],
+  ['work_C', 'work_E'],
+  ['work_W', 'work_SW'],
+  ['work_C', 'work_S'],
+  ['work_E', 'work_SE'],
+  ['work_SW', 'work_S'],
+  ['work_S', 'work_SE'],
+
+  // Designer wing (through gap in glass partition)
+  ['work_NW', 'design_gate'],
+  ['corr_L', 'design_gate'],
+  ['design_gate', 'design_N'],
+  ['design_N', 'design_C'],
+  ['design_C', 'design_S'],
+
+  // Manager office — path goes AROUND the corner then through door
+  // corr_R(7,7) → mgr_hallway(7,3) → mgr_corner(7,0) → mgr_outside(12,0) → door → inside
+  ['corr_R', 'mgr_hallway'],           // walk south, outside left wall (x=7 < wall x=8)
+  ['mgr_hallway', 'mgr_corner'],       // walk further south past front-left corner (z=0 < wall z=1.5)
+  ['mgr_corner', 'mgr_outside'],       // walk east to front of door (z=0, safely below front wall z=1.5)
+  ['mgr_outside', 'mgr_doorstep'],     // step to door threshold (triggers open)
+  ['mgr_doorstep', 'mgr_entry'],       // walk through open door into office
+  ['mgr_entry', 'mgr_center'],         // walk deeper inside
+  ['mgr_center', 'mgr_desk'],          // walk to desk
+
+  // Workspace → back zone (through gap in glass partition at z=-7)
+  ['work_S', 'back_gate'],
+  ['back_gate', 'back_C'],
+
+  // Back corridor
+  ['back_L', 'back_C'],
+  ['back_C', 'back_R'],
+  ['work_SW', 'back_L'],
+  ['work_SE', 'back_R'],
+
+  // Back zones
+  ['back_L', 'bar_entry'],
+  ['bar_entry', 'bar_center'],
+  ['back_C', 'rec_entry'],
+  ['rec_entry', 'rec_center'],
+  ['back_R', 'gym_entry'],
+  ['gym_entry', 'gym_center'],
+
+  // Stairs / mezzanine
+  ['back_R', 'stairs_bot'],
+  ['stairs_bot', 'stairs_top'],
+  ['stairs_top', 'mezz_C'],
+
+  // Rest/dressing (legacy)
+  ['work_SE', 'rest_entry'],
+  ['work_E', 'dress_entry'],
+];
+
+// === BUILD GRAPH ===
+var adjacency = {};
+var waypointMap = {};
+
+function buildGraph() {
+  adjacency = {};
+  waypointMap = {};
+  CAMPUS_WAYPOINTS.forEach(function(wp) {
+    adjacency[wp.id] = [];
+    waypointMap[wp.id] = wp;
+  });
+  CAMPUS_CONNECTIONS.forEach(function(conn) {
+    if (adjacency[conn[0]] && adjacency[conn[1]]) {
+      adjacency[conn[0]].push(conn[1]);
+      adjacency[conn[1]].push(conn[0]);
+    }
+  });
+}
+buildGraph();
+
+// Find nearest waypoint to a world position
+function nearestWaypoint(x, z) {
+  var best = null, bestDist = Infinity;
+  CAMPUS_WAYPOINTS.forEach(function(wp) {
+    var dx = wp.x - x, dz = wp.z - z;
+    var d = dx * dx + dz * dz;
+    if (d < bestDist) { bestDist = d; best = wp.id; }
+  });
+  return best;
+}
+
+// BFS shortest path
+function findPath(startId, endId) {
+  if (startId === endId) return [startId];
+  var visited = {};
+  var queue = [[startId]];
+  visited[startId] = true;
+  while (queue.length > 0) {
+    var path = queue.shift();
+    var current = path[path.length - 1];
+    var neighbors = adjacency[current] || [];
+    for (var i = 0; i < neighbors.length; i++) {
+      var next = neighbors[i];
+      if (visited[next]) continue;
+      var newPath = path.concat([next]);
+      if (next === endId) return newPath;
+      visited[next] = true;
+      queue.push(newPath);
+    }
+  }
+  return null;
+}
+
+// ==================== PUBLIC API ====================
+
+export function getNavigationPath(fromX, fromZ, toX, toZ) {
+  if (S.currentEnv !== 'campus') {
+    return [{ x: toX, z: toZ }];
+  }
+
+  var startWP = nearestWaypoint(fromX, fromZ);
+  var endWP = nearestWaypoint(toX, toZ);
+
+  if (!startWP || !endWP || startWP === endWP) {
+    return [{ x: toX, z: toZ }];
+  }
+
+  var wpPath = findPath(startWP, endWP);
+  if (!wpPath || wpPath.length === 0) {
+    return [{ x: toX, z: toZ }];
+  }
+
+  var result = [];
+  // Skip first waypoint if very close to current position
+  var firstWP = waypointMap[wpPath[0]];
+  var dx0 = firstWP.x - fromX, dz0 = firstWP.z - fromZ;
+  var startIdx = (dx0 * dx0 + dz0 * dz0 < 4) ? 1 : 0;
+
+  for (var i = startIdx; i < wpPath.length; i++) {
+    var wp = waypointMap[wpPath[i]];
+    var point = { x: wp.x, z: wp.z };
+    // Flag door waypoint
+    if (wpPath[i] === 'mgr_doorstep') {
+      point.triggerDoor = 'open';
+    }
+    result.push(point);
+  }
+
+  // Add final walk to exact destination if far from last waypoint
+  var lastWP = waypointMap[wpPath[wpPath.length - 1]];
+  var dxEnd = lastWP.x - toX, dzEnd = lastWP.z - toZ;
+  if (dxEnd * dxEnd + dzEnd * dzEnd > 1) {
+    result.push({ x: toX, z: toZ });
+  }
+
+  return result;
+}

package/office/scene.js

@@ -9,10 +9,10 @@ export function initScene() {
 
   S.scene = new THREE.Scene();
   S.scene.background = new THREE.Color(0x0d1117);
-  S.scene.fog = new THREE.Fog(0x0d1117, 25, 55);
+  S.scene.fog = new THREE.Fog(0x0d1117, 30, 80);
 
-  S.camera = new THREE.PerspectiveCamera(50, S.container.clientWidth / S.container.clientHeight, 0.1, 200);
-  S.camera.position.set(0, 12, 16);
+  S.camera = new THREE.PerspectiveCamera(50, S.container.clientWidth / S.container.clientHeight, 0.1, 300);
+  S.camera.position.set(0, 15, 22);
   S.camera.lookAt(0, 0, 0);
 
   S.renderer = new THREE.WebGLRenderer({ antialias: true });

package/office/spectator-camera.js

@@ -131,7 +131,7 @@ export function SpectatorCamera(camera, domElement) {
     if (keys['KeyA'] || keys['ArrowLeft']) moveDir.x -= 1;
     if (keys['KeyD'] || keys['ArrowRight']) moveDir.x += 1;
     if (keys['KeyE'] || keys['Space']) moveDir.y += 1;
-    if (keys['KeyQ'] || keys['ControlLeft']) moveDir.y -= 1;
+    if (keys['KeyQ']) moveDir.y -= 1;
 
     if (moveDir.lengthSq() > 0) {
       moveDir.normalize();

package/office/state.js

@@ -12,7 +12,7 @@ export const S = {
   clock: null,
   agents3d: {},
   lastProcessedMsg: 0,
-  currentEnv: 'modern',
+  currentEnv: 'campus',
   furnitureGroup: null,
   deskMeshes: [],
   syncInterval: null,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "let-them-talk",
-  "version": "3.6.1",
+  "version": "3.6.2",
   "description": "MCP message broker + web dashboard for inter-agent communication. Let AI CLI agents talk to each other.",
   "main": "server.js",
   "bin": {

package/server.js

@@ -871,6 +871,15 @@ async function toolSendMessage(content, to = null, reply_to = null) {
   if (currentBranch !== 'main') result.branch = currentBranch;
   if (!recipientAlive) {
     result.warning = `Agent "${to}" appears offline (PID not running). Message queued but may not be received until they reconnect.`;
+  } else if (agents[to] && !agents[to].listening_since) {
+    result.note = `Agent "${to}" is currently working (not in listen mode). Message queued — they'll see it when they finish their current task and call listen_group().`;
+  }
+
+  // Nudge: check if THIS agent has unread messages waiting
+  const myPending = getUnconsumedMessages(registeredName);
+  if (myPending.length > 0) {
+    result.you_have_messages = myPending.length;
+    result.urgent = `You have ${myPending.length} unread message(s) waiting. Call listen_group() after this to read them.`;
   }
   return result;
 }
@@ -925,6 +934,19 @@ function toolBroadcast(content) {
 
   const result = { success: true, sent_to: ids, recipient_count: ids.length };
   if (skipped.length > 0) result.skipped = skipped;
+  // Show which recipients are busy vs listening
+  const agentsNow = getAgents();
+  const busy = ids.filter(function(i) { return agentsNow[i.to] && !agentsNow[i.to].listening_since; }).map(function(i) { return i.to; });
+  if (busy.length > 0) {
+    result.busy_agents = busy;
+    result.note = busy.join(', ') + (busy.length === 1 ? ' is' : ' are') + ' currently working (not listening). Messages queued.';
+  }
+  // Nudge for own unread messages
+  const myPending = getUnconsumedMessages(registeredName);
+  if (myPending.length > 0) {
+    result.you_have_messages = myPending.length;
+    result.urgent = `You have ${myPending.length} unread message(s). Call listen_group() soon.`;
+  }
   return result;
 }
 
@@ -1370,17 +1392,28 @@ async function toolListenGroup(timeout_seconds = 300) {
       const recentSpeakers = new Set(history.slice(-10).map(m => m.from));
       const silent = agentNames.filter(n => !recentSpeakers.has(n) && n !== registeredName);
 
+      const now = Date.now();
       const result = {
-        messages: batch.map(m => ({
-          id: m.id, from: m.from, to: m.to, content: m.content,
-          timestamp: m.timestamp,
-          ...(m.reply_to && { reply_to: m.reply_to }),
-          ...(m.thread_id && { thread_id: m.thread_id }),
-        })),
+        messages: batch.map(m => {
+          const ageMs = now - new Date(m.timestamp).getTime();
+          const ageSec = Math.round(ageMs / 1000);
+          return {
+            id: m.id, from: m.from, to: m.to, content: m.content,
+            timestamp: m.timestamp,
+            age_seconds: ageSec,
+            ...(ageSec > 30 && { delayed: true }),
+            ...(m.reply_to && { reply_to: m.reply_to }),
+            ...(m.thread_id && { thread_id: m.thread_id }),
+          };
+        }),
         message_count: batch.length,
         context: recentHistory,
         agents_online: agentNames.length,
         agents_silent: silent,
+        agents_status: agentNames.reduce(function(acc, n) {
+          acc[n] = agents[n].listening_since ? 'listening' : 'working';
+          return acc;
+        }, {}),
         hint: silent.length > 0
           ? `${silent.join(', ')} haven't spoken recently. Consider addressing them.`
           : 'All agents are active in the conversation.',
@@ -1416,6 +1449,7 @@ async function toolListenGroup(timeout_seconds = 300) {
         }
       }
 
+      result.next_action = 'After processing these messages and sending your response, call listen_group() again immediately. Never stop listening.';
       return result;
     }
 
@@ -1423,7 +1457,13 @@ async function toolListenGroup(timeout_seconds = 300) {
   }
 
   setListening(false);
-  return { timeout: true, message: 'No messages received within timeout.', messages: [], message_count: 0 };
+  return {
+    timeout: true,
+    retry: true,
+    message: 'No messages yet. Call listen_group() again immediately to keep listening. Do NOT stop — you must stay in the conversation.',
+    messages: [],
+    message_count: 0,
+  };
 }
 
 function toolGetHistory(limit = 50, thread_id = null) {
@@ -2094,7 +2134,7 @@ function toolListBranches() {
 // --- MCP Server setup ---
 
 const server = new Server(
-  { name: 'agent-bridge', version: '3.6.1' },
+  { name: 'agent-bridge', version: '3.6.2' },
   { capabilities: { tools: {} } }
 );
 
@@ -2505,7 +2545,7 @@ server.setRequestHandler(ListToolsRequestSchema, async () => {
       },
       {
         name: 'listen_group',
-        description: 'Listen for messages in group or managed conversation mode. Returns ALL unconsumed messages as a batch (not just one), plus recent conversation context and hints about which agents are silent. In managed mode, also includes floor/phase context and instructions on whether you should respond. Use this instead of listen() when in group or managed mode.',
+        description: 'Listen for messages in group or managed conversation mode. Returns ALL unconsumed messages as a batch, plus conversation context and hints. IMPORTANT: After processing messages and responding, you MUST call listen_group() again immediately. If it times out with retry:true, call it again. Never stop listening — this is how you stay in the conversation.',
         inputSchema: {
           type: 'object',
           properties: {
@@ -2666,6 +2706,19 @@ server.setRequestHandler(CallToolRequestSchema, async (request) => {
       };
     }
 
+    // Global hook: on non-listen tools, check for pending messages and nudge the agent
+    // This catches agents who are mid-work and have messages piling up
+    const listenTools = ['listen', 'listen_group', 'listen_codex', 'wait_for_reply', 'check_messages'];
+    if (registeredName && !listenTools.includes(name) && (isGroupMode() || isManagedMode())) {
+      try {
+        const pending = getUnconsumedMessages(registeredName);
+        if (pending.length > 0 && !result.you_have_messages) {
+          result._pending_messages = pending.length;
+          result._nudge = `You have ${pending.length} unread message(s) from the team. Finish your current task quickly, then call listen_group() to read them.`;
+        }
+      } catch {}
+    }
+
     return {
       content: [{ type: 'text', text: JSON.stringify(result, null, 2) }],
     };
@@ -2698,7 +2751,7 @@ async function main() {
   ensureDataDir();
   const transport = new StdioServerTransport();
   await server.connect(transport);
-  console.error('Agent Bridge MCP server v3.6.1 running (32 tools)');
+  console.error('Agent Bridge MCP server v3.6.2 running (32 tools)');
 }
 
 main().catch(console.error);