let-them-talk 3.3.3 → 3.4.1

package/CHANGELOG.md

@@ -1,5 +1,73 @@
 # Changelog
 
+## [3.4.1] - 2026-03-15
+
+### Added
+- **File-level mutex** — in-memory promise queue per file for serializing edit/delete operations
+- **Agent permissions enforcement** — `canSendTo()` checks in `send_message` and `broadcast`, `can_read` filtering in `get_history` and message delivery
+- **Read receipts** — auto-recorded when agents consume messages, visible as agent-initial dots under messages in dashboard
+
+### Security
+- HTTP 500 responses now return generic error instead of raw `err.message` (prevents filesystem path leaks)
+- `/api/discover` changed from GET to POST (now under CSRF protection)
+- `workspace_read`/`workspace_list` validate agent name parameter with regex
+- `get_history` filters results by agent's `can_read` permissions
+- `read_receipts.json` and `permissions.json` added to both MCP and dashboard reset cleanup
+- Dashboard workspace API regex aligned with server (`[a-zA-Z0-9_-]`)
+
+### Fixed
+- `toolWaitForReply` missing `markAsRead` calls (read receipts not recorded)
+- `toolBroadcast` bypassing permission checks entirely
+- `toolReset` not cleaning up `permissions.json` and `read_receipts.json`
+
+## [3.4.0] - 2026-03-15
+
+### Added — Dashboard Features
+- **Stats Tab** — per-agent message counts, avg response time, peak hours, 24-hour activity chart, conversation velocity. Keyboard shortcut `6`.
+- **Compact View** — toggle button in search bar. Hides avatars, inlines timestamps, reduces padding. Persists to localStorage.
+- **Message Edit** — edit any message via hover action. Full edit history tracked, "edited" badge displayed.
+- **Message Delete** — delete dashboard/system messages with confirmation dialog.
+- **Copy Message** — clipboard button on message hover to copy raw content.
+- **JSON Export** — new export format alongside HTML and Markdown.
+- **Kanban Drag-and-Drop** — drag task cards between columns (pending/in_progress/done/blocked).
+- **SSE Auto-Reconnect** — exponential backoff (1s→30s), yellow "Reconnecting..." indicator, polling fallback.
+- **Conversation Templates** — 4 built-in multi-agent workflow templates (Code Review Pipeline, Debug Squad, Feature Development, Research & Write) in the Launch tab with copyable agent prompts.
+
+### Added — API Endpoints
+- `PUT /api/message` — edit a message (with edit history)
+- `DELETE /api/message` — delete a message (dashboard/system only)
+- `GET /api/conversation-templates` — list conversation templates
+- `POST /api/conversation-templates/launch` — get template agent prompts
+- `GET /api/stats` — analytics data (per-agent stats, velocity, hourly distribution)
+- `GET/POST /api/permissions` — agent permission management
+
+### Added — CLI Commands
+- `npx let-them-talk msg <agent> <text>` — send a message from CLI
+- `npx let-them-talk status` — show active agents and message counts
+
+### Changed — Premium UI Redesign
+- Deeper dark palette with blue undertones (#080b12 background)
+- Inter font from Google Fonts with anti-aliased rendering
+- Glassmorphism header with backdrop-filter blur
+- Gradient accent system (blue→purple) on buttons, active tabs, send button
+- Refined shadow system (sm/md/lg) with colored glows
+- Focus rings on all inputs
+- Smoother transitions (0.2-0.25s) with lift effects on hover
+- Glass effects on modals and popups
+- Inset shadows on code blocks
+- Thinner scrollbars with transparent tracks
+
+### Fixed
+- Task notes crash when `notes` array undefined
+- Message edit always rewrites messages.jsonl regardless of match
+- Permissions API accepted arbitrary fields (now whitelisted)
+- Task status accepted any string (now validated against whitelist)
+- Reset button ignored active project in multi-project mode
+- Edit modal missing error handler on network failure
+- CLI msg command accepted invalid agent names
+- Copy-to-clipboard double-escaped HTML entities in template prompts
+- Duplicate deleteMessage function shadowing
+
 ## [3.3.2] - 2026-03-14
 
 ### Changed

package/LICENSE

@@ -6,7 +6,7 @@ License text copyright (c) 2017 MariaDB Corporation Ab, All Rights Reserved.
 Parameters
 
 Licensor:             Dekelelz
-Licensed Work:        Let Them Talk v3.3.3
+Licensed Work:        Let Them Talk v3.4.1
                       The Licensed Work is (c) 2024-2026 Dekelelz.
 Additional Use Grant: You may make use of the Licensed Work, provided that
                       you may not use the Licensed Work for a Commercial

package/README.md

@@ -85,13 +85,17 @@ Each terminal spawns its own MCP server process. All processes share a `.agent-b
 ## Highlights
 
 - **27 MCP tools** — messaging, tasks, workflows, profiles, workspaces, branching, plugins
-- **Real-time dashboard** — SSE-powered (~200ms latency), markdown rendering, dark/light theme
-- **Multi-agent** — 2 agents auto-route, 3+ agents specify recipients, broadcast to all
-- **Task management** — kanban board with create/assign/track between agents
+- **Premium dashboard** — glassmorphism UI, Inter font, gradient accents, SSE real-time (~200ms)
+- **Stats & analytics** — per-agent message counts, response times, hourly activity charts, velocity
+- **Conversation templates** — 4 built-in multi-agent workflows (Code Review, Debug Squad, Feature Dev, Research & Write)
+- **Message management** — edit, delete, copy messages with full edit history
+- **Task management** — drag-and-drop kanban board between agents
 - **Workflow pipelines** — multi-step automation with auto-handoff
 - **Agent profiles** — display names, SVG avatars, roles, bios
 - **Conversation branching** — fork at any point, isolated history per branch
-- **File sharing** — send code, diffs, and results directly between agents
+- **Compact view** — dense message toggle for power users, persists to localStorage
+- **Multi-format export** — HTML, Markdown, and JSON export
+- **CLI tools** — send messages and check status directly from the command line
 - **Plugin system** — extend with custom tools, 30s sandboxed execution
 - **Zero config** — one `npx` command, auto-detects your CLI, works immediately
 
@@ -118,22 +122,26 @@ npx let-them-talk templates                # List all available templates
 
 Launch with `npx let-them-talk dashboard` — opens at `http://localhost:3000`.
 
-**4 main tabs:**
+**6 main tabs:**
 
-- **Messages** — live feed with full markdown, message grouping, search, bookmarks, pins, emoji reactions, conversation replay
-- **Tasks** — kanban board (pending / in progress / done / blocked), update status from dashboard
+- **Messages** — live feed with full markdown, message grouping, search, bookmarks, pins, emoji reactions, conversation replay, compact view
+- **Tasks** — drag-and-drop kanban board (pending / in progress / done / blocked)
 - **Workspaces** — per-agent key-value storage browser
 - **Workflows** — horizontal pipeline visualization, advance or skip steps
+- **Launch** — spawn new agents with templates, 4 built-in conversation templates with copyable prompts
+- **Stats** — per-agent message counts, avg response times, hourly activity charts, conversation velocity
 
 **Plus:**
 
 - Agent monitoring with active / sleeping / dead / listening status
 - Profile popups with avatars and role badges
-- Activity heatmap and per-agent stats
+- Message edit, delete, and copy actions on hover
+- SSE auto-reconnect with exponential backoff and visual indicator
 - Message injection and broadcast from browser
 - Conversation branching with branch tabs
-- Export as shareable HTML or Markdown
+- Export as shareable HTML, Markdown, or JSON
 - Multi-project support with auto-discover
+- Premium glassmorphism UI with gradient accents
 - Dark / light theme toggle
 - Mobile responsive with hamburger sidebar
 - Browser notifications and sound alerts

package/cli.js

@@ -8,7 +8,7 @@ const command = process.argv[2];
 
 function printUsage() {
   console.log(`
-  Let Them Talk — Agent Bridge v3.3.3
+  Let Them Talk — Agent Bridge v3.4.1
   MCP message broker for inter-agent communication
   Supports: Claude Code, Gemini CLI, Codex CLI
 
@@ -28,7 +28,9 @@ function printUsage() {
     npx let-them-talk plugin remove <n> Remove a plugin by name
     npx let-them-talk plugin enable <n> Enable a plugin
     npx let-them-talk plugin disable <n> Disable a plugin
-    npx let-them-talk help              Show this help message
+    npx let-them-talk msg <agent> <text> Send a message to an agent
+    npx let-them-talk status             Show active agents and message count
+    npx let-them-talk help               Show this help message
   `);
 }
 
@@ -416,6 +418,97 @@ function dashboard() {
   require('./dashboard.js');
 }
 
+function resolveDataDirCli() {
+  return process.env.AGENT_BRIDGE_DATA_DIR || path.join(process.cwd(), '.agent-bridge');
+}
+
+function readJsonl(filePath) {
+  if (!fs.existsSync(filePath)) return [];
+  return fs.readFileSync(filePath, 'utf8')
+    .split('\n')
+    .filter(l => l.trim())
+    .map(l => { try { return JSON.parse(l); } catch { return null; } })
+    .filter(Boolean);
+}
+
+function readJson(filePath) {
+  if (!fs.existsSync(filePath)) return {};
+  try { return JSON.parse(fs.readFileSync(filePath, 'utf8')); } catch { return {}; }
+}
+
+function isPidAlive(pid) {
+  if (!pid) return false;
+  try { process.kill(pid, 0); return true; } catch { return false; }
+}
+
+function cliMsg() {
+  const recipient = process.argv[3];
+  const textParts = process.argv.slice(4);
+  if (!recipient || !textParts.length) {
+    console.error('  Usage: npx let-them-talk msg <agent> <text>');
+    process.exit(1);
+  }
+  if (!/^[a-zA-Z0-9_-]{1,20}$/.test(recipient)) {
+    console.error('  Agent name must be 1-20 alphanumeric characters (with _ or -).');
+    process.exit(1);
+  }
+  const text = textParts.join(' ');
+  const dir = resolveDataDirCli();
+  if (!fs.existsSync(dir)) {
+    console.error('  No .agent-bridge/ directory found. Run "npx let-them-talk init" first.');
+    process.exit(1);
+  }
+
+  const msgId = 'm' + Date.now().toString(36) + Math.random().toString(36).slice(2, 6);
+  const msg = {
+    id: msgId,
+    from: 'CLI',
+    to: recipient,
+    content: text,
+    timestamp: new Date().toISOString(),
+  };
+
+  const messagesFile = path.join(dir, 'messages.jsonl');
+  const historyFile = path.join(dir, 'history.jsonl');
+  fs.appendFileSync(messagesFile, JSON.stringify(msg) + '\n');
+  fs.appendFileSync(historyFile, JSON.stringify(msg) + '\n');
+
+  console.log('  Message sent to ' + recipient + ': ' + text);
+}
+
+function cliStatus() {
+  const dir = resolveDataDirCli();
+  if (!fs.existsSync(dir)) {
+    console.error('  No .agent-bridge/ directory found. Run "npx let-them-talk init" first.');
+    process.exit(1);
+  }
+
+  const agents = readJson(path.join(dir, 'agents.json'));
+  const history = readJsonl(path.join(dir, 'history.jsonl'));
+
+  console.log('');
+  console.log('  Agent Bridge Status');
+  console.log('  ===================');
+  console.log('  Messages: ' + history.length);
+  console.log('');
+
+  const names = Object.keys(agents);
+  if (!names.length) {
+    console.log('  No agents registered.');
+  } else {
+    console.log('  Agents:');
+    for (const name of names) {
+      const info = agents[name];
+      const alive = isPidAlive(info.pid);
+      const status = alive ? '\x1b[32monline\x1b[0m' : '\x1b[31moffline\x1b[0m';
+      const lastActivity = info.last_activity || info.timestamp || '';
+      const msgCount = history.filter(m => m.from === name).length;
+      console.log('    ' + name.padEnd(16) + ' ' + status + '  msgs: ' + msgCount + '  last: ' + (lastActivity ? new Date(lastActivity).toLocaleTimeString() : '-'));
+    }
+  }
+  console.log('');
+}
+
 switch (command) {
   case 'init':
     init();
@@ -429,6 +522,14 @@ switch (command) {
   case 'reset':
     reset();
     break;
+  case 'msg':
+  case 'message':
+  case 'send':
+    cliMsg();
+    break;
+  case 'status':
+    cliStatus();
+    break;
   case 'plugin':
   case 'plugins':
     pluginCmd();