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_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 createState() => _ChatThreadViewState(); } class _ChatThreadViewState extends State { late ChatThreadController _controller = _attach(); late ChatComposerController _composer = _attachComposer(); late ChatRowKeys _rowKeys = ChatRowKeys(); /// A sent turn shown before history or a live frame echoes it. final List _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 _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(); _optimistic.clear(); } else if (oldWidget.syncToken != widget.syncToken) { unawaited(_controller.resync()); } } @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 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 rows = transcriptRows(_visibleMessages(), trailing: cards); // 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; return Column( children: [ Expanded( child: ListView( key: ValueKey('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 (_controller.error != null) ChatErrorNotice( key: const Key('chat-history-error'), message: 'Chat history unavailable\n${_controller.error}', onRetry: _controller.load, ), if (_controller.subscriptionError != null) ChatErrorNotice( key: const Key('chat-live-error'), message: 'Live updates unavailable\n${_controller.subscriptionError}', onRetry: _controller.resync, ), if (_controller.loaded && rows.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(keys[index]), padding: const EdgeInsets.symmetric(horizontal: 16), child: _transcriptRow(rows[index]), ), 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('chat-composer-${widget.sessionId}'), composer: _composer, running: _controller.running, ), ], ); }, ); Widget _transcriptRow(JsonMap row) { final kind = '${row['kind'] ?? ''}'; if (kind == 'activity') return _ChatActivityLine(row: row); 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'), ); } /// 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}); final JsonMap row; @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 (_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('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('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; }