Files
pipelines/app/lib/features/chat/conversation/chat_thread_view.dart
T
alan c1b87dea54 feat(app): dismiss recorded local chat notices in the thread
Show dismissible notices for refused history reads, refused live watches and a running compaction. A dismissal lasts only while the recorded condition is unchanged; a syncToken gap hides pre-gap notices until fresh state arrives.
2026-10-22 11:10:42 +01:00

757 lines
27 KiB
Dart

import 'dart:async';
import 'package:flutter/cupertino.dart';
import 'package:flutter/material.dart';
import '../../../core/api_gateway.dart';
import '../domain/chat_activity_detail.dart';
import '../domain/chat_notice.dart';
import '../domain/chat_transcript.dart';
import '../ui/sessions/chat_adaptive.dart';
import '../ui/transcript/chat_markdown_view.dart';
import '../ui/transcript/chat_message_view.dart';
import 'chat_composer_bar.dart';
import 'chat_composer_controller.dart';
import 'chat_draft_store.dart';
import 'chat_row_keys.dart';
import 'chat_thread_controller.dart';
import 'chat_transcript_card.dart';
/// One read-only conversation: the controller's transcript in the order the
/// server reports it, rendered by the existing [ChatMessageView].
///
/// Assistant text goes through [ChatMarkdownView]'s builder, so stored and live
/// prose share the supported markdown subset. User text keeps the server's exact
/// characters, and reasoning/tool disclosures stay plain text.
///
/// History and live-subscription failures are separate notices: readable stored
/// history must never hide a refused live watch. The shell owns the navigation
/// bar, so this view adds only its own Back control and content.
class ChatThreadView extends StatefulWidget {
const ChatThreadView({
super.key,
required this.gateway,
required this.sessionId,
required this.onBack,
this.title = '',
this.syncToken = 0,
this.drafts,
this.newOperationId,
});
final ApiGateway gateway;
final String sessionId;
final VoidCallback onBack;
/// The list row's title when this visit knows it; a deep link may not.
final String title;
/// Advances when the shared socket is replaced, keeping this selection.
final int syncToken;
/// Draft persistence for tests and previews; production uses the app store.
final ChatDraftStore? drafts;
/// Test/fixture seam for deterministic operation ids.
final String Function()? newOperationId;
@override
State<ChatThreadView> createState() => _ChatThreadViewState();
}
class _ChatThreadViewState extends State<ChatThreadView> {
late ChatThreadController _controller = _attach();
late ChatComposerController _composer = _attachComposer();
late ChatRowKeys _rowKeys = ChatRowKeys();
/// Local notices the operator hid; cleared when the conversation or socket
/// changes so a reconnect never keeps a stale dismissal.
ChatNoticeDismissals _dismissals = ChatNoticeDismissals();
/// True while a reconnect repair is in flight: notices recorded before the
/// gap are stale, so none is drawn until the repair reports fresh state.
bool _reconnecting = false;
int _syncGeneration = 0;
/// The transcript held when the socket was replaced. A running state recorded
/// before the gap cannot be trusted again until a fresh read or frame
/// replaces that transcript.
List<JsonMap>? _preGapMessages;
/// The chain that repairs the newest socket gap. A second gap waits for an
/// in-flight repair instead of treating the controller's immediate return as
/// completion, which would expose stale notices mid-repair.
Future<void>? _repair;
/// A sent turn shown before history or a live frame echoes it.
final List<JsonMap> _optimistic = [];
ChatThreadController _attach() =>
ChatThreadController(widget.gateway, widget.sessionId)..load();
ChatComposerController _attachComposer() => ChatComposerController(
widget.gateway,
widget.sessionId,
drafts: widget.drafts,
newOperationId: widget.newOperationId,
onOptimistic: _onOptimistic,
onRejected: _onRejected,
);
void _onOptimistic(ChatComposerSend send) {
if (!mounted) return;
setState(() {
_optimistic.add({
'id': send.optimisticId,
'session_id': send.sessionId,
'role': 'user',
'operation_id': send.operationId,
'native_message_id': send.nativeMessageId,
'parts': [
{'type': 'text', 'text': send.text},
],
});
});
}
void _onRejected(ChatComposerSend send, String error) {
if (!mounted) return;
setState(() {
_optimistic.removeWhere((row) => row['operation_id'] == send.operationId);
});
}
/// Local turns whose authoritative copy is not in the held transcript yet.
/// A live user frame or a history page that carries the same operation,
/// native id or message id hides the local copy instead of drawing it twice.
List<JsonMap> _visibleMessages() {
final messages = _controller.messages;
return [
...messages,
for (final pending in _optimistic)
if (!messages.any((message) => _isEcho(pending, message))) pending,
];
}
bool _isEcho(JsonMap pending, JsonMap message) {
if (message['role'] != 'user') return false;
if (pending['id'] == message['id']) return true;
final operation = pending['operation_id'];
if (operation != null && operation == message['operation_id']) return true;
final native = '${pending['native_message_id'] ?? ''}';
return native.isNotEmpty && native == message['native_message_id'];
}
@override
void didUpdateWidget(covariant ChatThreadView oldWidget) {
super.didUpdateWidget(oldWidget);
if (oldWidget.gateway != widget.gateway ||
oldWidget.sessionId != widget.sessionId) {
_controller.dispose();
_composer.dispose();
_controller = _attach();
_composer = _attachComposer();
_rowKeys = ChatRowKeys();
_dismissals = ChatNoticeDismissals();
_reconnecting = false;
_preGapMessages = null;
_syncGeneration++;
_optimistic.clear();
} else if (oldWidget.syncToken != widget.syncToken) {
// The socket was replaced: conditions recorded before the gap are stale,
// so no earlier dismissal survives and nothing recorded before the gap is
// painted while the repair runs.
_dismissals.clear();
_preGapMessages = _controller.messages;
_reconnecting = true;
final generation = ++_syncGeneration;
final previous = _repair;
final repair = (previous ?? Future<void>.value())
.then((_) async {
// A newer gap owns the repair; its own step in this chain runs next.
if (!mounted || generation != _syncGeneration) return;
await _controller.resync();
})
.whenComplete(() {
if (!mounted || generation != _syncGeneration) return;
setState(() {
_reconnecting = false;
// A successful repair replaced the transcript with fresh state.
if (!identical(_controller.messages, _preGapMessages)) {
_preGapMessages = null;
}
});
});
_repair = repair;
unawaited(repair);
}
}
@override
void dispose() {
_composer.dispose();
_controller.dispose();
super.dispose();
}
@override
Widget build(BuildContext context) => AnimatedBuilder(
animation: _controller,
builder: (context, _) {
final cupertino =
chatControlsStyleOf(context) == ChatControlsStyle.cupertino;
final messages = _visibleMessages();
final cards = chatCardRows(
permissions: _controller.permissionFrames,
forms: _controller.questionForms,
answerFor: _controller.permissionAnswerFor,
permissionErrorFor: _controller.permissionErrorFor,
formErrorFor: _controller.questionErrorFor,
);
// A pending approval/question means the turn is waiting on the operator,
// not generating, so the transcript indicator and its live region stand
// down; the composer's Stop control still follows `running`.
final awaiting = cards.any(chatCardAwaitingOperator);
final allRows = transcriptRows(messages, trailing: cards);
// A transcript held from before a socket gap may still say a compaction is
// running even when the repair's read is refused. That running state is
// stale, so no compaction notice is derived from it until a fresh read or
// frame replaces the transcript. Fresh failure notices still report.
//
// Notices report recorded conditions only: a refused read/watch and a
// running compaction. A dismissal keeps one hidden until its condition
// changes. A running compaction's own activity line is that notice, so it
// is not drawn twice; hiding it when dismissed is the whole dismissal.
final allNotices = _reconnecting
? const <ChatNotice>[]
: chatNotices(
historyError: _controller.error,
liveError: _controller.subscriptionError,
messages: _staleTranscript ? const [] : _controller.messages,
);
final notices = _dismissals.visible(allNotices);
final compactionNotice = _noticeOf(notices, ChatNoticeKind.compaction);
final rows = [
for (final row in allRows)
if (!_hiddenRunningCompaction(row)) row,
];
// Older pages prepend messages and a live frame can append one, so a
// folded assistant turn's first message id is not a stable identity.
// ChatRowKeys carries a turn's key forward while it still holds any of
// its previous messages, keeping the element (and its open disclosures)
// across paging and streaming.
final keys = _rowKeys.forRows(rows);
final initialLoad = !_controller.loaded && _controller.loading;
final historyNotice = _noticeOf(
notices,
ChatNoticeKind.connectionRefused,
);
final liveNotice = _noticeOf(notices, ChatNoticeKind.liveFailure);
return Column(
children: [
Expanded(
child: ListView(
key: ValueKey<String>('chat-thread-${widget.sessionId}'),
padding: const EdgeInsets.symmetric(vertical: 8),
children: [
Padding(
key: const Key('chat-thread-header'),
padding: const EdgeInsetsDirectional.fromSTEB(8, 0, 16, 4),
child: Wrap(
spacing: 8,
runSpacing: 4,
crossAxisAlignment: WrapCrossAlignment.center,
children: [
_backButton(cupertino),
if (widget.title.trim().isNotEmpty)
Text(
widget.title.trim(),
style: cupertino
? CupertinoTheme.of(
context,
).textTheme.navTitleTextStyle
: Theme.of(context).textTheme.titleLarge,
),
],
),
),
if (initialLoad)
Padding(
key: const Key('chat-thread-loading'),
padding: const EdgeInsets.all(16),
child: Center(
child: cupertino
? const CupertinoActivityIndicator()
: const CircularProgressIndicator(),
),
),
if (_controller.hasMore)
Padding(
key: const Key('chat-load-older'),
padding: const EdgeInsets.symmetric(horizontal: 16),
child: Align(
alignment: AlignmentDirectional.centerStart,
child: cupertino
? CupertinoButton(
padding: EdgeInsets.zero,
onPressed: _controller.loading
? null
: _controller.loadOlder,
child: const Text('Load older'),
)
: TextButton(
onPressed: _controller.loading
? null
: _controller.loadOlder,
child: const Text('Load older'),
),
),
),
if (historyNotice != null)
_ChatNoticeLine(
key: const Key('chat-history-error'),
notice: historyNotice,
onDismiss: _dismiss,
onRetry: _controller.load,
),
if (liveNotice != null)
_ChatNoticeLine(
key: const Key('chat-live-error'),
notice: liveNotice,
onDismiss: _dismiss,
onRetry: _controller.resync,
),
if (_controller.loaded &&
allRows.isEmpty &&
allNotices.isEmpty &&
_controller.error == null)
const Padding(
key: Key('chat-thread-empty'),
padding: EdgeInsets.all(16),
child: Text('No messages in this chat yet.'),
),
for (var index = 0; index < rows.length; index++)
Padding(
key: ValueKey<String>(keys[index]),
padding: const EdgeInsets.symmetric(horizontal: 16),
child: _transcriptRow(
rows[index],
onDismissCompaction:
compactionNotice != null &&
chatNoticeActivityCondition(rows[index]) ==
compactionNotice.condition
? () => _dismiss(compactionNotice)
: null,
),
),
if (_controller.running && !awaiting)
Padding(
key: const Key('chat-running'),
padding: const EdgeInsets.all(16),
child: Semantics(
liveRegion: true,
child: const Text('Assistant is responding…'),
),
),
],
),
),
ChatComposerBar(
key: ValueKey<String>('chat-composer-${widget.sessionId}'),
composer: _composer,
running: _controller.running,
),
],
);
},
);
ChatNotice? _noticeOf(List<ChatNotice> notices, ChatNoticeKind kind) {
for (final notice in notices) {
if (notice.kind == kind) return notice;
}
return null;
}
/// Whether a running compaction's activity line must stay off screen.
///
/// That line is the compaction notice, so it follows the same conditions: it
/// is hidden while the repair runs, while the held transcript is still the
/// pre-gap one, and when the operator dismissed this exact compaction. A
/// different running compaction in the transcript keeps its own line.
bool _hiddenRunningCompaction(JsonMap row) {
final condition = chatNoticeActivityCondition(row);
if (condition == null) return false;
return _reconnecting ||
_staleTranscript ||
_dismissals.isDismissed(condition);
}
/// Whether the held transcript is still the one recorded before the gap.
bool get _staleTranscript =>
_preGapMessages != null &&
identical(_controller.messages, _preGapMessages);
void _dismiss(ChatNotice notice) {
setState(() => _dismissals.dismiss(notice));
}
Widget _transcriptRow(JsonMap row, {VoidCallback? onDismissCompaction}) {
final kind = '${row['kind'] ?? ''}';
if (kind == 'activity') {
return _ChatActivityLine(row: row, onDismiss: onDismissCompaction);
}
if (kind == 'permission' || kind == 'question') {
return ChatTranscriptCard(
row: row,
onPermissionDecision: _controller.replyPermission,
onQuestionAnswer: _controller.answerQuestion,
);
}
return ChatMessageView(row: row, textBuilder: chatMarkdownText);
}
Widget _backButton(bool cupertino) => cupertino
? CupertinoButton(
padding: const EdgeInsetsDirectional.fromSTEB(8, 0, 8, 0),
onPressed: widget.onBack,
child: const Row(
mainAxisSize: MainAxisSize.min,
children: [
Icon(CupertinoIcons.back),
SizedBox(width: 4),
Text('Back'),
],
),
)
: TextButton.icon(
onPressed: widget.onBack,
icon: const Icon(Icons.arrow_back),
label: const Text('Back to chats'),
);
}
/// The native dismiss control shared by a local notice and a running
/// compaction's activity line. Material uses a tooltip; Cupertino carries the
/// same accessible name on the wrapping node, since its button has none.
Widget _noticeDismissControl({
required bool cupertino,
required String label,
required Key key,
required VoidCallback onPressed,
}) {
final icon = Icon(cupertino ? CupertinoIcons.xmark_circle_fill : Icons.close);
if (!cupertino) {
return IconButton(
key: key,
tooltip: label,
onPressed: onPressed,
icon: icon,
);
}
return Semantics(
container: true,
button: true,
label: label,
onTap: onPressed,
child: ExcludeSemantics(
child: CupertinoButton(
key: key,
padding: EdgeInsets.zero,
onPressed: onPressed,
child: icon,
),
),
);
}
/// One local failure notice beside the conversation.
///
/// It is never a message bubble and never sent to the agent. The line carries
/// the kind's own words plus the recorded reason, keeps its native Retry and
/// adds a native dismiss control. Colour only repeats the failure state, so the
/// words remain readable without it. A running compaction is a recorded activity
/// line and is dismissed there instead.
class _ChatNoticeLine extends StatelessWidget {
const _ChatNoticeLine({
super.key,
required this.notice,
required this.onDismiss,
this.onRetry,
});
final ChatNotice notice;
final ValueChanged<ChatNotice> onDismiss;
final VoidCallback? onRetry;
@override
Widget build(BuildContext context) {
final cupertino =
chatControlsStyleOf(context) == ChatControlsStyle.cupertino;
final theme = Theme.of(context);
final color = cupertino
? CupertinoColors.systemRed.resolveFrom(context)
: theme.colorScheme.error;
final style =
(cupertino
? CupertinoTheme.of(context).textTheme.textStyle
: theme.textTheme.bodyMedium)
?.copyWith(color: color);
final icon = cupertino
? CupertinoIcons.exclamationmark_circle
: Icons.error_outline;
return Padding(
padding: const EdgeInsetsDirectional.fromSTEB(16, 4, 8, 4),
child: Column(
crossAxisAlignment: CrossAxisAlignment.stretch,
children: [
Row(
crossAxisAlignment: CrossAxisAlignment.start,
children: [
Padding(
padding: const EdgeInsetsDirectional.only(top: 8),
child: Icon(icon, color: color),
),
const SizedBox(width: 8),
Expanded(
child: Padding(
padding: const EdgeInsets.symmetric(vertical: 8),
child: Semantics(
liveRegion: true,
child: Text(notice.text, style: style),
),
),
),
_dismissControl(cupertino),
],
),
if (onRetry != null)
Align(
alignment: AlignmentDirectional.centerStart,
child: cupertino
? CupertinoButton(
padding: EdgeInsets.zero,
onPressed: onRetry,
child: const Text('Retry'),
)
: TextButton(onPressed: onRetry, child: const Text('Retry')),
),
],
),
);
}
Widget _dismissControl(bool cupertino) {
return _noticeDismissControl(
cupertino: cupertino,
label: chatNoticeDismissLabel(notice.kind),
key: ValueKey<String>('chat-notice-dismiss-${notice.kind.name}'),
onPressed: () => onDismiss(notice),
);
}
}
/// One recorded activity line for a turn.
///
/// The line is a summary of the recorded sequence. Its wording and state come
/// from the recorded row, and the icon only repeats that state with theme roles,
/// so an unknown kind or state is still readable without colour. The trailing
/// control expands the same line into the recorded lifecycle and any recorded
/// input, output, error, duration and edit diff; collapsing restores the single
/// line without touching the turn.
class _ChatActivityLine extends StatefulWidget {
const _ChatActivityLine({required this.row, this.onDismiss});
final JsonMap row;
/// Set only for a running compaction, whose line is the local notice the
/// operator can hide until that compaction's condition changes.
final VoidCallback? onDismiss;
@override
State<_ChatActivityLine> createState() => _ChatActivityLineState();
}
class _ChatActivityLineState extends State<_ChatActivityLine> {
bool _expanded = false;
void _toggle() => setState(() => _expanded = !_expanded);
/// The latest recorded update, which is also the line's label/state. With no
/// records (a caller-built row) the row itself carries the same fields.
JsonMap _record() {
final records = widget.row['records'];
if (records is List) {
for (final record in records.reversed) {
if (record is Map) return JsonMap.from(record);
}
}
return widget.row;
}
@override
Widget build(BuildContext context) {
final cupertino =
chatControlsStyleOf(context) == ChatControlsStyle.cupertino;
final state = '${widget.row['state'] ?? ''}'.trim().toLowerCase();
final failed = state == 'failed' || state == 'error';
final running = state == 'running';
final completed =
state == 'completed' || state == 'ended' || state == 'succeeded';
final secondary = _secondary(context, cupertino);
final color = failed
? (cupertino
? CupertinoColors.systemRed.resolveFrom(context)
: Theme.of(context).colorScheme.error)
: secondary;
final style =
(cupertino
? CupertinoTheme.of(context).textTheme.textStyle
: Theme.of(context).textTheme.bodySmall)
?.copyWith(color: color);
final icon = failed
? (cupertino
? CupertinoIcons.exclamationmark_circle
: Icons.error_outline)
: running
? (cupertino ? CupertinoIcons.arrow_2_circlepath : Icons.sync)
: completed
? (cupertino
? CupertinoIcons.check_mark_circled
: Icons.check_circle_outline)
: (cupertino ? CupertinoIcons.circle : Icons.circle_outlined);
final label = '${widget.row['label'] ?? ''}'.trim();
return Padding(
padding: const EdgeInsets.symmetric(vertical: 6),
child: Column(
mainAxisSize: MainAxisSize.min,
crossAxisAlignment: CrossAxisAlignment.stretch,
children: [
Row(
crossAxisAlignment: CrossAxisAlignment.start,
children: [
Expanded(
child: Semantics(
container: true,
label: label,
value: state,
child: ExcludeSemantics(
child: Row(
crossAxisAlignment: CrossAxisAlignment.start,
children: [
Icon(icon, color: color),
const SizedBox(width: 8),
Expanded(child: Text(label, style: style)),
],
),
),
),
),
_toggleControl(cupertino),
if (widget.onDismiss != null)
_noticeDismissControl(
cupertino: cupertino,
label: chatNoticeDismissLabel(ChatNoticeKind.compaction),
key: const ValueKey<String>('chat-notice-dismiss-compaction'),
onPressed: widget.onDismiss!,
),
],
),
if (_expanded) _detail(context, cupertino, secondary),
],
),
);
}
/// The host's own disclosure control, with an action label that states what a
/// tap does. Cupertino's button has no built-in label, so the wrapping node
/// carries it and the button keeps the pointer handling.
Widget _toggleControl(bool cupertino) {
const key = ValueKey<String>('chat-activity-toggle');
final label = _expanded ? 'Collapse activity' : 'Expand activity';
final icon = Icon(
_expanded
? (cupertino ? CupertinoIcons.chevron_up : Icons.expand_less)
: (cupertino ? CupertinoIcons.chevron_down : Icons.expand_more),
);
if (!cupertino) {
return IconButton(
key: key,
tooltip: label,
onPressed: _toggle,
icon: icon,
);
}
return Semantics(
container: true,
button: true,
label: label,
onTap: _toggle,
child: ExcludeSemantics(
child: CupertinoButton(
key: key,
padding: EdgeInsets.zero,
onPressed: _toggle,
child: icon,
),
),
);
}
/// The expanded section: every recorded field, with the exact absence sentence
/// for one the record did not carry. Only [ChatActivityDetail] reads the
/// record, so the line and its details cannot disagree about a field.
Widget _detail(BuildContext context, bool cupertino, Color secondary) {
final detail = chatActivityDetail(_record());
final baseStyle = cupertino
? CupertinoTheme.of(context).textTheme.textStyle
: Theme.of(context).textTheme.bodyMedium;
final labelStyle = TextStyle(color: secondary, fontWeight: FontWeight.w600);
Widget field(String label, String value) {
final absent =
value == chatActivityLifecycleAbsent ||
value == chatActivityInputAbsent ||
value == chatActivityOutputAbsent ||
value == chatActivityErrorAbsent ||
value == chatActivityDurationAbsent ||
value == chatActivityDiffAbsent;
return Padding(
padding: const EdgeInsetsDirectional.only(top: 8),
child: Column(
crossAxisAlignment: CrossAxisAlignment.start,
children: [
Text(label, style: labelStyle),
DefaultTextStyle.merge(
style: absent ? TextStyle(color: secondary) : const TextStyle(),
child: SelectableText(value),
),
],
),
);
}
return DefaultTextStyle.merge(
style: baseStyle,
child: Padding(
key: const ValueKey<String>('chat-activity-details'),
padding: const EdgeInsetsDirectional.only(bottom: 2),
child: Column(
crossAxisAlignment: CrossAxisAlignment.stretch,
children: [
field('Lifecycle', detail.lifecycle),
field('Input', detail.input),
field('Output', detail.output),
field('Error', detail.error),
field('Duration', detail.duration),
field('Edit diff', detail.diff),
],
),
),
);
}
Color _secondary(BuildContext context, bool cupertino) => cupertino
? CupertinoColors.secondaryLabel.resolveFrom(context)
: Theme.of(context).colorScheme.onSurfaceVariant;
}