add the team chat inbox over the broker

Renders broker traffic as a chat timeline and makes the user a first-class participant. The broker grows a Stream<TeamMessage> and a recipient field, auto-registers a virtual `user` member, and gains sendAsUser. A Flutter-free TeamChatModel (owned by the orchestrator) accumulates the feed and exposes postAsUser with @-routing (a new at_commands helper mirroring slash) and an optional interrupt that cancels the target's turn before delivery. One model backs two surfaces: a compact cockpit widget that pops out into a full workspace chat pane. CLI parity via clide.team-chat.open / .post. T-180. Co-Authored-By: Claude <noreply@anthropic.com>
2026-05-31 10:49:04 +02:00
parent e3c0b0146b
commit a0636c2e5a
17 changed files with 1656 additions and 31 deletions
@@ -0,0 +1,104 @@
+/// The shared chat model for team broker traffic (T-180).
+///
+/// Subscribes to the broker's [TeamBroker.messages] stream and keeps an
+/// append-only timeline of [TeamMessage]s. Both the compact sidebar widget
+/// and the full workspace pane read from this one model — they share state,
+/// they do NOT each hold their own copy.
+///
+/// [postAsUser] is the user's write path: it routes by @tag (one agent or
+/// broadcast) and, when the interrupt flag is set, calls [interrupt()] on the
+/// target session THEN delivers the message.
+///
+/// Flutter-free on purpose: this module (like [TeamBroker]) runs under
+/// `dart test`. Use [dart:async] Stream/StreamController for observability;
+/// do NOT use [ChangeNotifier].
+library;
+
+import 'dart:async';
+
+import 'package:clide/builtin/claude/src/team_broker.dart';
+import 'package:clide/builtin/claude/src/stream_json_session.dart';
+
+/// Resolves a session by orchestrator member name — injected by the
+/// orchestrator so the model doesn't depend on the Flutter-coupled
+/// [ClaudeSessionOrchestrator] type directly.
+typedef SessionResolver = StreamJsonSession? Function(String memberName);
+
+/// The shared timeline + user-post logic for team broker chat (T-180).
+///
+/// Lifetime matches the orchestrator: created once, subscribed to the broker,
+/// disposed when the orchestrator is torn down.
+class TeamChatModel {
+  TeamChatModel({
+    required TeamBroker broker,
+    SessionResolver? sessionResolver,
+  })  : _broker = broker,
+        _sessionResolver = sessionResolver {
+    _sub = broker.messages.listen(_onMessage);
+  }
+
+  final TeamBroker _broker;
+  final SessionResolver? _sessionResolver;
+  late final StreamSubscription<TeamMessage> _sub;
+
+  final _messages = <TeamMessage>[];
+
+  final _changeCtl = StreamController<void>.broadcast();
+
+  /// All broker messages in arrival order. Unmodifiable snapshot; new messages
+  /// are signalled via [changes].
+  List<TeamMessage> get messages => List.unmodifiable(_messages);
+
+  /// Fires a void event whenever a new message is appended. Broadcast —
+  /// multiple listeners are supported. Flutter-free.
+  Stream<void> get changes => _changeCtl.stream;
+
+  void _onMessage(TeamMessage msg) {
+    _messages.add(msg);
+    if (!_changeCtl.isClosed) _changeCtl.add(null);
+  }
+
+  // ---------------------------------------------------------------------------
+  // User post path
+  // ---------------------------------------------------------------------------
+
+  /// Post [text] as the user into the broker channel.
+  ///
+  /// - [toName] `null` or `'team'` → broadcast to all agents.
+  /// - [toName] a specific member name → `send_message(to: toName)`.
+  /// - [interrupt] `true` → call [StreamJsonSession.interrupt] on the target
+  ///   session first (cancels its current turn), then deliver. Default false.
+  ///
+  /// The message is also appended to the local timeline immediately so the
+  /// user sees it without waiting for the broker echo.
+  void postAsUser(String text, {String? toName, bool interrupt = false}) {
+    final from = 'user';
+    final isTeam = toName == null || toName.isEmpty || toName == 'team';
+
+    if (interrupt && !isTeam) {
+      // isTeam is false only when toName is a non-null, non-empty, non-'team'
+      // string, so Dart's flow analysis promotes it to non-null here.
+      _sessionResolver?.call(toName)?.interrupt();
+    }
+
+    if (isTeam) {
+      // Broadcast: create a local record and deliver via the broker.
+      final msg = TeamMessage(from: from, to: null, text: text, at: DateTime.now(), broadcast: true);
+      _messages.add(msg);
+      if (!_changeCtl.isClosed) _changeCtl.add(null);
+      _broker.sendAsUser(text);
+    } else {
+      // Directed message.
+      final msg = TeamMessage(from: from, to: toName, text: text, at: DateTime.now());
+      _messages.add(msg);
+      if (!_changeCtl.isClosed) _changeCtl.add(null);
+      _broker.sendAsUser(text, to: toName);
+    }
+  }
+
+  /// Dispose — cancels the broker subscription and closes the changes stream.
+  void dispose() {
+    _sub.cancel();
+    _changeCtl.close();
+  }
+}