let-them-talk 3.6.1 → 3.7.0

package/CHANGELOG.md

@@ -1,5 +1,51 @@
 # Changelog
 
+## [3.7.0] - 2026-03-16
+
+### Added — Agent Ecosystem (20 new tools, 52 total)
+
+**Tier 1 — Critical Infrastructure:**
+- **`get_briefing()`** — full project onboarding in one call: agents, tasks, decisions, KB, locked files, progress, project file tree
+- **`lock_file(path)` / `unlock_file(path?)`** — exclusive file editing with auto-release on agent death
+- **`log_decision(decision, reasoning?, topic?)` / `get_decisions(topic?)`** — persistent decision log, prevents re-debating
+- **Agent recovery on rejoin** — `register()` returns active tasks, workspace keys, recent messages for returning agents
+
+**Tier 2 — Quality of Life:**
+- **`kb_write(key, content)` / `kb_read(key?)` / `kb_list()`** — shared team knowledge base (any agent reads/writes)
+- **Event hooks** — auto-fires system messages on `agent_join`, `task_complete`, `all_tasks_done`, `dependency_met`
+- **`update_progress(feature, percent, notes)` / `get_progress()`** — feature-level progress tracking with overall %
+- **`get_compressed_history()`** — auto-compresses old messages into summary segments, keeps recent verbatim
+- **`listen_group()` now blocks indefinitely** — no more timeout, agents never drop out
+
+**Tier 3 — Advanced Collaboration:**
+- **`call_vote(question, options)` / `cast_vote(vote_id, choice)` / `vote_status(vote_id?)`** — team voting with auto-resolve when all vote
+- **`request_review(file, desc)` / `submit_review(review_id, status, feedback)`** — code review pipeline with approve/changes_requested
+- **`declare_dependency(task_id, depends_on)` / `check_dependencies(task_id?)`** — task dependency tracking with auto-notify on resolve
+- **`get_reputation(agent?)` / `suggest_task()`** — agent reputation tracking (auto-detects strengths), task suggestions based on skills
+- **Auto-reputation tracking** — global hook tracks every action (messages, tasks, reviews, decisions, KB writes) without manual calls
+
+### Fixed
+- **Monitor screens stay red** when agent stops listening — persistent color state instead of 300ms flash
+- **"NOT LISTENING" warning** shown prominently on desk monitor canvas
+- **Status color logic** — green = listening, red = active but not listening, yellow = sleeping, dim = dead
+
+## [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

package/README.md

@@ -86,7 +86,7 @@ Each terminal spawns its own MCP server process. All processes share a `.agent-b
 
 - **3D virtual office** — chibi characters at desks, spectator camera (WASD+mouse), 11 hairstyles, 6 outfits, gestures, furniture, TV dashboard
 - **Managed conversation mode** — structured turn-taking with floor control for 3+ agents, prevents broadcast storms
-- **32 MCP tools** — messaging, tasks, workflows, profiles, workspaces, branching, managed mode
+- **52 MCP tools** — messaging, tasks, workflows, profiles, workspaces, branching, managed mode, briefing, file locking, decisions, KB, voting, reviews, dependencies, reputation
 - **8-tab dashboard** — 3D Hub (default), messages, tasks, workspaces, workflows, launch, stats, docs
 - **Group conversation mode** — free multi-agent collaboration with auto-broadcast and cooldown
 - **5 agent templates** — pair, team, review, debate, managed — with ready-to-paste prompts
@@ -175,7 +175,7 @@ The dashboard's default view is a **real-time 3D virtual office** (the "3D Hub")
 
 **Animations:** walk, sit, type, raise hand, sleep (ZZZ), wave, think, point, celebrate, stretch, idle gestures. Agents turn toward speakers during conversations.
 
-## MCP Tools (32)
+## MCP Tools (52)
 
 <details>
 <summary><strong>Messaging (13 tools)</strong></summary>
@@ -249,6 +249,90 @@ The dashboard's default view is a **real-time 3D virtual office** (the "3D Hub")
 
 </details>
 
+<details>
+<summary><strong>Briefing & Recovery (1 tool)</strong></summary>
+
+| Tool | Description |
+|------|-------------|
+| `get_briefing` | Full project onboarding — agents, tasks, decisions, KB, locks, progress, files |
+
+</details>
+
+<details>
+<summary><strong>File Locking (2 tools)</strong></summary>
+
+| Tool | Description |
+|------|-------------|
+| `lock_file` | Lock a file for exclusive editing. Auto-releases on death |
+| `unlock_file` | Unlock a file or all your locked files |
+
+</details>
+
+<details>
+<summary><strong>Decision Log (2 tools)</strong></summary>
+
+| Tool | Description |
+|------|-------------|
+| `log_decision` | Log a team decision with reasoning and topic |
+| `get_decisions` | Get all decisions, optionally filtered by topic |
+
+</details>
+
+<details>
+<summary><strong>Knowledge Base (3 tools)</strong></summary>
+
+| Tool | Description |
+|------|-------------|
+| `kb_write` | Write to shared team knowledge base |
+| `kb_read` | Read KB entries (one or all) |
+| `kb_list` | List all KB keys with metadata |
+
+</details>
+
+<details>
+<summary><strong>Progress & Compression (3 tools)</strong></summary>
+
+| Tool | Description |
+|------|-------------|
+| `update_progress` | Update feature-level completion percentage |
+| `get_progress` | Get all feature progress with overall % |
+| `get_compressed_history` | Compressed old messages + recent verbatim |
+
+</details>
+
+<details>
+<summary><strong>Voting (3 tools)</strong></summary>
+
+| Tool | Description |
+|------|-------------|
+| `call_vote` | Start a team vote with options |
+| `cast_vote` | Cast your vote (auto-resolves when all vote) |
+| `vote_status` | Check vote results |
+
+</details>
+
+<details>
+<summary><strong>Code Review (2 tools)</strong></summary>
+
+| Tool | Description |
+|------|-------------|
+| `request_review` | Request a code review from the team |
+| `submit_review` | Approve or request changes with feedback |
+
+</details>
+
+<details>
+<summary><strong>Dependencies & Reputation (4 tools)</strong></summary>
+
+| Tool | Description |
+|------|-------------|
+| `declare_dependency` | Declare task dependency (auto-notifies on resolve) |
+| `check_dependencies` | Check blocked/resolved dependencies |
+| `get_reputation` | Agent leaderboard with strengths |
+| `suggest_task` | Get next task suggestion based on your skills |
+
+</details>
+
 ## CLI Reference
 
 ```bash

package/cli.js

@@ -9,7 +9,7 @@ const command = process.argv[2];
 
 function printUsage() {
   console.log(`
-  Let Them Talk — Agent Bridge v3.6.1
+  Let Them Talk — Agent Bridge v3.7.0
   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>
@@ -6848,9 +6858,9 @@ function renderDocs() {
       '</div>' +
     '</div>' +
 
-    // All 32 Tools
+    // All 52 Tools
     '<div class="docs-section">' +
-      '<h3>All 32 MCP Tools</h3>' +
+      '<h3>All 52 MCP Tools</h3>' +
       '<h4>Core Messaging</h4>' +
       '<div class="docs-tool-grid">' +
         '<div class="docs-tool-item"><code>register(name, provider?)</code><div class="desc">Register your agent identity. Must be called first.</div></div>' +

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;
@@ -96,11 +156,14 @@ function updateDeskScreen(deskIdx, status) {
 function flashDeskScreen(deskIdx) {
   var desk = S.deskMeshes[deskIdx];
   if (!desk) return;
+  // Flash white briefly — the next syncAgents call (every 2s) will set the correct persistent color via updateDeskScreen
   desk.screenMat.emissive.setHex(0xffffff);
   desk.screenMat.emissiveIntensity = 1.5;
   setTimeout(function() {
-    desk.screenMat.emissive.setHex(0x58a6ff);
-    desk.screenMat.emissiveIntensity = 0.5;
+    // Force immediate red until next sync corrects it
+    desk.screenMat.emissive.setHex(0xef4444);
+    desk.screenMat.emissiveIntensity = 0.6;
+    desk.screenMat.color.setHex(0xef4444);
   }, 300);
 }
 
@@ -151,7 +214,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 +253,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 +268,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 +292,20 @@ export function syncAgents() {
       }
 
       existing.displayName = info.display_name || name;
+      var wasListening = existing.isListening;
       existing.isListening = !!(info.is_listening);
 
+      // Detect listen mode change — update screen color persistently
+      if (wasListening && !existing.isListening) {
+        // Left listen mode — flash then stay red until next sync sets updateDeskScreen
+        existing.listenLostTimer = 3;
+        flashDeskScreen(existing.deskIdx);
+      }
+      if (!wasListening && existing.isListening) {
+        // Entered listen mode — next updateDeskScreen will set green
+        existing.listenLostTimer = 0;
+      }
+
       var task = getAgentTask(name);
       if (task) {
         var prevTask = existing.currentTask;
@@ -248,7 +325,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 +386,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 +402,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 +419,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 +432,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();
@@ -148,7 +154,7 @@ export function updateAgent(agent, dt, time) {
   var sittingTarget = agent.isSitting ? 1 : 0;
   agent.sittingLerp += (sittingTarget - agent.sittingLerp) * Math.min(1, dt * 5);
 
-  agent.parts.group.position.y = agent.sittingLerp * 0.06;
+  agent.parts.group.position.y = agent.sittingLerp * 0.14;
   var sitHip = -1.5 * agent.sittingLerp;
   agent.parts.leftLeg.rotation.x = agent.parts.leftLeg.rotation.x * (1 - agent.sittingLerp) + sitHip * agent.sittingLerp;
   agent.parts.rightLeg.rotation.x = agent.parts.rightLeg.rotation.x * (1 - agent.sittingLerp) + sitHip * agent.sittingLerp;
@@ -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;