Claude's tmux team mode let teammates message each other and share a task
list; that mode is undocumented and unavailable headless. clide rebuilds
the same behavior over its own managed sessions, as the broker.
Verified live against claude 2.1.150 that a spawner can host an in-process
("SDK") MCP server entirely over the stream-json control channel — no
subprocess, no --mcp-config, no socket: declare the server name in the
initialize handshake's sdkMcpServers, answer the mcp_message JSON-RPC
round-trips (initialize / tools/list / tools/call) under
response.response.mcp_response. SDK tool calls are permission-gated through
the existing can_use_tool path. Documented in the 2.1.150 spike §6.
StreamJsonSession gains an McpServer hosting seam; TeamBroker + TeamMcpServer
expose send_message / broadcast / list_teammates / inbox / claim_task /
task_status, all routed through one shared broker. The orchestrator owns the
broker, registers each team session, delivers a message into the target's
next turn on its stdin, and injects roster + role via --append-system-prompt.
Solo sessions are unchanged (no MCP server, no initialize handshake).
T-170, D-77.
Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
129 lines
5.3 KiB
Dart
129 lines
5.3 KiB
Dart
import 'dart:convert';
|
|
|
|
import 'package:clide/builtin/claude/src/team_broker.dart';
|
|
import 'package:test/test.dart';
|
|
|
|
/// Decode a [TeamMcpServer] tool result's single text block back into the
|
|
/// structured map the broker returned.
|
|
Map<String, dynamic> decode(Map<String, dynamic> mcpResult) {
|
|
final text = ((mcpResult['content'] as List).single as Map)['text'] as String;
|
|
return jsonDecode(text) as Map<String, dynamic>;
|
|
}
|
|
|
|
void main() {
|
|
late TeamBroker broker;
|
|
late List<(String, String)> delivered; // (toMemberId, text)
|
|
late TeamMcpServer lead;
|
|
late TeamMcpServer tyre;
|
|
|
|
setUp(() {
|
|
delivered = [];
|
|
broker = TeamBroker(deliver: (to, text) => delivered.add((to, text)));
|
|
broker.addMember(const TeamMemberRef(id: 'primary', name: 'lead', role: 'lead'));
|
|
broker.addMember(const TeamMemberRef(id: 'teammate:tyre', name: 'tyre', role: 'teammate'));
|
|
lead = TeamMcpServer(broker: broker, memberId: 'primary');
|
|
tyre = TeamMcpServer(broker: broker, memberId: 'teammate:tyre');
|
|
});
|
|
|
|
test('send_message delivers into the named teammate next turn', () async {
|
|
final r = decode(await lead.callTool('send_message', {'to': 'tyre', 'text': 'pick up T-9'}));
|
|
expect(r['ok'], isTrue);
|
|
expect(r['to'], 'tyre');
|
|
expect(delivered, [('teammate:tyre', '[team] lead: pick up T-9')]);
|
|
});
|
|
|
|
test('addressing an unknown teammate fails with a helpful error', () async {
|
|
final result = await lead.callTool('send_message', {'to': 'ghost', 'text': 'hi'});
|
|
expect(result['isError'], isTrue);
|
|
expect(decode(result)['ok'], isFalse);
|
|
expect(delivered, isEmpty);
|
|
});
|
|
|
|
test('the recipient can read the message from its inbox', () async {
|
|
await lead.callTool('send_message', {'to': 'tyre', 'text': 'hello'});
|
|
final box = decode(await tyre.callTool('inbox', {}));
|
|
final msgs = box['messages'] as List;
|
|
expect(msgs.single['from'], 'lead');
|
|
expect(msgs.single['text'], 'hello');
|
|
// Draining: a second read is empty.
|
|
expect((decode(await tyre.callTool('inbox', {}))['messages'] as List), isEmpty);
|
|
});
|
|
|
|
test('broadcast reaches every other member but not the sender', () async {
|
|
broker.addMember(const TeamMemberRef(id: 'teammate:qatux', name: 'qatux', role: 'teammate'));
|
|
final r = decode(await lead.callTool('broadcast', {'text': 'standup'}));
|
|
expect((r['recipients'] as List).toSet(), {'tyre', 'qatux'});
|
|
expect(delivered.map((d) => d.$1).toSet(), {'teammate:tyre', 'teammate:qatux'});
|
|
});
|
|
|
|
test('list_teammates returns the other members with roles', () async {
|
|
final r = decode(await lead.callTool('list_teammates', {}));
|
|
final mates = r['teammates'] as List;
|
|
expect(mates.single, {'name': 'tyre', 'role': 'teammate'});
|
|
});
|
|
|
|
test('a claimed task is visible to every member as shared state', () async {
|
|
final claimed = decode(await tyre.callTool('claim_task', {'title': 'wire the broker'}));
|
|
final taskId = (claimed['task'] as Map)['id'] as String;
|
|
expect((claimed['task'] as Map)['owner'], 'tyre');
|
|
|
|
final seenByLead = decode(await lead.callTool('task_status', {}));
|
|
final tasks = seenByLead['tasks'] as List;
|
|
expect(tasks.single['id'], taskId);
|
|
expect(tasks.single['status'], 'claimed');
|
|
|
|
final done = decode(await lead.callTool('task_status', {'id': taskId, 'status': 'done'}));
|
|
expect((done['task'] as Map)['status'], 'done');
|
|
});
|
|
|
|
test('removing a member releases its claimed tasks', () async {
|
|
final claimed = decode(await tyre.callTool('claim_task', {'title': 'temp'}));
|
|
final taskId = (claimed['task'] as Map)['id'] as String;
|
|
broker.removeMember('teammate:tyre');
|
|
final tasks = decode(await lead.callTool('task_status', {}))['tasks'] as List;
|
|
final t = tasks.firstWhere((t) => t['id'] == taskId);
|
|
expect(t['status'], 'open');
|
|
expect(t.containsKey('owner'), isFalse);
|
|
});
|
|
|
|
test('claim_task by id claims an existing open task', () async {
|
|
final created = decode(await lead.callTool('task_status', {'title': 'open work'}));
|
|
final id = (created['task'] as Map)['id'] as String;
|
|
expect((created['task'] as Map)['status'], 'open');
|
|
|
|
final claimed = decode(await tyre.callTool('claim_task', {'id': id}));
|
|
expect((claimed['task'] as Map)['status'], 'claimed');
|
|
expect((claimed['task'] as Map)['owner'], 'tyre');
|
|
});
|
|
|
|
test('claim_task with neither id nor title is an error', () async {
|
|
final r = await lead.callTool('claim_task', {});
|
|
expect(r['isError'], isTrue);
|
|
});
|
|
|
|
test('claiming an unknown task id is an error', () async {
|
|
final r = await lead.callTool('claim_task', {'id': 'task-999'});
|
|
expect(r['isError'], isTrue);
|
|
});
|
|
|
|
test('task_status on an unknown id is an error', () async {
|
|
final r = await lead.callTool('task_status', {'id': 'task-999', 'status': 'done'});
|
|
expect(r['isError'], isTrue);
|
|
});
|
|
|
|
test('an unknown team tool is an error', () async {
|
|
final r = await lead.callTool('nope', {});
|
|
expect(r['isError'], isTrue);
|
|
});
|
|
|
|
test('removing an unknown member is a no-op', () {
|
|
broker.removeMember('teammate:ghost');
|
|
expect(broker.members.map((m) => m.name).toSet(), {'lead', 'tyre'});
|
|
});
|
|
|
|
test('the MCP tool surface lists all six team tools', () {
|
|
final names = lead.tools.map((t) => t['name']).toSet();
|
|
expect(names, {'send_message', 'broadcast', 'list_teammates', 'inbox', 'claim_task', 'task_status'});
|
|
});
|
|
}
|