merge(app): land chat-tasks

This commit is contained in:
2026-10-22 17:56:21 +01:00
6 changed files with 1673 additions and 0 deletions
@@ -0,0 +1,251 @@
import 'dart:math' as math;
import 'package:flutter/cupertino.dart';
import 'package:flutter/material.dart';
import '../../../core/api_gateway.dart';
import '../domain/chat_shells.dart';
import '../ui/sessions/chat_adaptive.dart';
/// One bounded output page: the web's 220 px pane is twelve 18 px monospace
/// lines (`web/chat.css`), so the bound is read from the host's own output type
/// and the user's text scale rather than a fixed pixel row. A longer page
/// scrolls inside this box and never moves the transcript or composer.
const _outputVisibleLines = 12;
const _outputLineHeight = 1.5;
/// Even at a large text scale one pane keeps this share of the bar's own height
/// budget, so the bar's chrome and list keep room and the conversation below it
/// is never crowded out.
const _outputMaxBudgetShare = 0.45;
/// The selected background task's read-only detail and bounded output page.
///
/// Every value is a recorded fact: the server's command, the shell identity, the
/// running status, and one lazy `chat_shell_output` page. The output area keeps
/// the five states apart, so an unavailable or empty page and a refused read are
/// never shown as output. Output is selectable and reads in a monospace body.
class ChatBackgroundTaskDetail extends StatelessWidget {
const ChatBackgroundTaskDetail({
super.key,
required this.shell,
required this.output,
required this.heightBudget,
required this.onRefresh,
});
final JsonMap shell;
final ChatShellOutputSnapshot? output;
/// The space the enclosing task bar has for its whole body. The output pane is
/// measured against this, not the window, so a list of rows, a narrow phone or
/// a large text scale cannot make the detail outgrow its own bar.
final double heightBudget;
final VoidCallback onRefresh;
@override
Widget build(BuildContext context) {
final cupertino =
chatControlsStyleOf(context) == ChatControlsStyle.cupertino;
final content = DefaultTextStyle.merge(
style: cupertino
? CupertinoTheme.of(context).textTheme.textStyle
: DefaultTextStyle.of(context).style,
child: Column(
crossAxisAlignment: CrossAxisAlignment.start,
spacing: 4,
children: [
_label(context, cupertino, shellOutputCommandLabel),
Text(
blankShellValue(shell['command'])
? shellOutputUnavailableLabel
: '${shell['command']}',
),
_label(context, cupertino, shellOutputTaskIdentityLabel),
Text(
shellIdOf(shell),
style: const TextStyle(fontFamily: 'monospace'),
),
Text(shellStatusRunningLabel),
_outputArea(context, cupertino),
],
),
);
if (cupertino) {
return CupertinoListSection.insetGrouped(
children: [Padding(padding: const EdgeInsets.all(12), child: content)],
);
}
return Card(
margin: EdgeInsets.zero,
child: Padding(padding: const EdgeInsets.all(12), child: content),
);
}
Widget _label(BuildContext context, bool cupertino, String text) {
final style = cupertino
? CupertinoTheme.of(context).textTheme.tabLabelTextStyle.copyWith(
color: CupertinoColors.secondaryLabel.resolveFrom(context),
)
: Theme.of(context).textTheme.labelSmall?.copyWith(
color: Theme.of(context).colorScheme.onSurfaceVariant,
);
return Text(text, style: style);
}
/// The host's own monospace body for one output page. `height` is set so the
/// visible-line bound below is measured on the same line box that is drawn.
TextStyle _outputStyle(BuildContext context, bool cupertino) =>
(cupertino
? CupertinoTheme.of(context).textTheme.textStyle
: Theme.of(context).textTheme.bodySmall ?? const TextStyle())
.copyWith(
fontFamily: 'monospace',
height: _outputLineHeight,
// Cupertino's style is not inheriting; a selectable body needs a
// baseline from its own style.
textBaseline: TextBaseline.alphabetic,
);
/// The number of output lines the pane shows before it scrolls: up to twelve,
/// fewer when the user's text scale or the bar's remaining height would let
/// the pane crowd out the conversation.
int _outputVisibleLineCount(BuildContext context, TextStyle style) {
final scaledLine =
MediaQuery.textScalerOf(context).scale(style.fontSize ?? 12) *
_outputLineHeight;
final fit = (heightBudget * _outputMaxBudgetShare / scaledLine).floor();
return math.max(2, math.min(_outputVisibleLines, fit));
}
/// Selectable output in the host's own control. A Cupertino-only app has no
/// `MaterialLocalizations`, which `SelectableText` asserts on, so one English
/// default scope is supplied for its context menu (the chat markdown view's
/// own pattern).
Widget _selectableOutput(
BuildContext context,
bool cupertino,
String output,
TextStyle style,
int maxLines,
) {
final text = SelectableText(
output,
key: const Key('chat-bg-task-output'),
style: style,
// A multiline selectable body scrolls itself: the host's text control
// keeps the page selectable and gives it its own scrollbar/drag, so no
// nested scroller can steal the conversation's gestures.
maxLines: maxLines,
);
if (!cupertino) return text;
return Localizations(
locale: Localizations.maybeLocaleOf(context) ?? const Locale('en'),
delegates: const [
DefaultWidgetsLocalizations.delegate,
DefaultMaterialLocalizations.delegate,
DefaultCupertinoLocalizations.delegate,
],
child: text,
);
}
Widget _outputArea(BuildContext context, bool cupertino) {
final state = output?.state ?? ChatShellOutputState.none;
final muted = cupertino
? CupertinoColors.secondaryLabel.resolveFrom(context)
: Theme.of(context).colorScheme.onSurfaceVariant;
final noteStyle =
(cupertino
? CupertinoTheme.of(context).textTheme.textStyle
: Theme.of(context).textTheme.bodySmall)
?.copyWith(color: muted);
switch (state) {
case ChatShellOutputState.none:
return const SizedBox.shrink();
case ChatShellOutputState.loading:
return Align(
alignment: AlignmentDirectional.centerStart,
child: cupertino
? const CupertinoActivityIndicator()
: const CircularProgressIndicator(),
);
case ChatShellOutputState.error:
return Row(
key: const Key('chat-bg-task-output-error'),
crossAxisAlignment: CrossAxisAlignment.start,
spacing: 8,
children: [
Expanded(
child: Text(
output?.error ?? '',
style: noteStyle?.copyWith(
color: cupertino
? CupertinoColors.systemRed.resolveFrom(context)
: Theme.of(context).colorScheme.error,
),
),
),
ChatBackgroundTaskButton(
label: shellOutputRetryLabel,
onPressed: onRefresh,
),
],
);
case ChatShellOutputState.unavailable:
return Text(shellOutputUnavailableNote, style: noteStyle);
case ChatShellOutputState.empty:
return Text(shellOutputEmptyNote, style: noteStyle);
case ChatShellOutputState.ready:
final page = output!.page!;
final style = _outputStyle(context, cupertino);
return Column(
crossAxisAlignment: CrossAxisAlignment.start,
spacing: 4,
children: [
_label(context, cupertino, shellOutputLabel),
_selectableOutput(
context,
cupertino,
page.output,
style,
_outputVisibleLineCount(context, style),
),
if (page.truncated) Text(shellOutputBoundedNote, style: noteStyle),
Align(
alignment: AlignmentDirectional.centerStart,
child: ChatBackgroundTaskButton(
label: shellOutputRefreshLabel,
onPressed: onRefresh,
),
),
],
);
}
}
}
/// The host's own text button for a task action (Retry/Refresh).
class ChatBackgroundTaskButton extends StatelessWidget {
const ChatBackgroundTaskButton({
super.key,
required this.label,
required this.onPressed,
});
final String label;
final VoidCallback onPressed;
@override
Widget build(BuildContext context) {
if (chatControlsStyleOf(context) == ChatControlsStyle.cupertino) {
return CupertinoButton(
padding: EdgeInsets.zero,
onPressed: onPressed,
child: Text(label),
);
}
return TextButton(onPressed: onPressed, child: Text(label));
}
}
@@ -0,0 +1,480 @@
import 'dart:async';
import 'package:flutter/cupertino.dart';
import 'package:flutter/material.dart';
import '../../../core/api_gateway.dart';
import '../../../core/error_reason.dart';
import '../data/chat_repository.dart';
import '../domain/chat_shells.dart';
import '../ui/sessions/chat_adaptive.dart';
import 'chat_background_task_detail.dart';
/// The bar is pinned above the transcript, so the whole surface keeps at most
/// this share of the window and scrolls inside itself. The transcript and the
/// composer therefore always keep most of the window, however many tasks are
/// listed and however large the selected page is.
const backgroundTaskViewportShare = 0.5;
/// The running background tasks a chat session owns (C11).
///
/// The list is read from recorded facts only: the session's `chat_shells`
/// snapshot on open and every pushed `shell` frame for that session. Every task
/// is linked to its conversation because both reads carry this session's id.
/// A task that exits leaves the list, so the bar disappears with the last exit
/// instead of keeping a history of finished processes.
///
/// Selecting a task reveals its read-only detail and reads one bounded output
/// page (`chat_shell_output`, cursor 0, the server's 64 KiB limit). The pane
/// reports an unavailable or empty page and a refused read truthfully; it never
/// invents output. A refused list read is reported with the server's reason and
/// a native Retry rather than pretending there are no tasks.
class ChatBackgroundTasks extends StatefulWidget {
const ChatBackgroundTasks({
super.key,
required this.gateway,
required this.sessionId,
this.syncToken = 0,
});
final ApiGateway gateway;
final String sessionId;
/// Advances when the shared socket is replaced: a gap may have swallowed an
/// exit, so the retained tasks are dropped and re-learned from the snapshot.
final int syncToken;
@override
State<ChatBackgroundTasks> createState() => _ChatBackgroundTasksState();
}
class _ChatBackgroundTasksState extends State<ChatBackgroundTasks> {
late ChatRepository _repository = ChatRepository(widget.gateway);
StreamSubscription<JsonMap>? _frames;
List<JsonMap> _shells = const [];
String? _selectedId;
ChatShellOutputSnapshot? _output;
String? _listError;
int _generation = 0;
int _outputGeneration = 0;
bool _disposed = false;
@override
void initState() {
super.initState();
_listen();
unawaited(_loadShells());
}
@override
void didUpdateWidget(covariant ChatBackgroundTasks oldWidget) {
super.didUpdateWidget(oldWidget);
if (oldWidget.gateway != widget.gateway ||
oldWidget.sessionId != widget.sessionId) {
unawaited(_frames?.cancel());
_generation++;
_repository = ChatRepository(widget.gateway);
_shells = const [];
_selectedId = null;
_output = null;
_listError = null;
_listen();
unawaited(_loadShells());
return;
}
if (oldWidget.syncToken != widget.syncToken) {
// The reconnect repair: an exit could have been lost in the gap.
_shells = const [];
_selectedId = null;
_output = null;
_listError = null;
unawaited(_loadShells());
}
}
void _listen() =>
_frames = widget.gateway.frames.listen(_onFrame, onError: (_) {});
void _onFrame(JsonMap envelope) {
if (_disposed || envelope['type'] != 'chat_event') return;
final value = envelope['chat_event'];
if (value is! Map) return;
final frame = Map<String, dynamic>.from(value);
if ('${frame['session_id'] ?? ''}' != widget.sessionId) return;
if (frame['kind'] != 'shell') return;
final valueShell = frame['shell'];
if (valueShell is! Map) return;
final next = mergeShellFrame(
_shells,
Map<String, dynamic>.from(valueShell),
);
setState(() {
_shells = next;
_dropStaleSelection();
});
}
Future<void> _loadShells() async {
final token = ++_generation;
try {
final running = await _repository.shells(widget.sessionId);
if (!mounted || token != _generation) return;
setState(() {
_shells = shellsLoaded(_shells, running);
_listError = null;
_dropStaleSelection();
});
} catch (error) {
if (!mounted || token != _generation) return;
setState(
() => _listError = describeErrorReason(
error,
fallback: 'The server did not answer.',
),
);
}
}
/// An exit, or a fresh snapshot that no longer lists the selected task,
/// closes its pane so a finished task never keeps showing output.
void _dropStaleSelection() {
final selected = _selectedId;
if (selected == null) return;
if (!runningShells(_shells).any((shell) => shellIdOf(shell) == selected)) {
_selectedId = null;
_output = null;
}
}
void _select(String shellId) {
final closing = _selectedId == shellId;
if (!closing &&
!runningShells(_shells).any((shell) => shellIdOf(shell) == shellId)) {
return;
}
setState(() {
_selectedId = closing ? null : shellId;
_output = null;
});
if (!closing) unawaited(_readOutput(shellId));
}
Future<void> _readOutput(String shellId) async {
if (_selectedId != shellId) return;
final token = ++_outputGeneration;
setState(() => _output = const ChatShellOutputSnapshot(loading: true));
try {
final reply = await _repository.shellOutput(
widget.sessionId,
shellId,
cursor: 0,
limit: chatShellOutputLimit,
);
if (!mounted || token != _outputGeneration || _selectedId != shellId) {
return;
}
final page = ChatShellOutputPage.fromReply(reply);
final reported = page.shell;
setState(() {
if (reported != null && !blankShellValue(reported['id'])) {
_shells = mergeShellFrame(_shells, reported);
}
_output = ChatShellOutputSnapshot(page: page);
_dropStaleSelection();
});
} catch (error) {
if (!mounted || token != _outputGeneration || _selectedId != shellId) {
return;
}
setState(
() => _output = ChatShellOutputSnapshot(
error: describeErrorReason(
error,
fallback: 'The server did not answer.',
),
),
);
}
}
@override
void dispose() {
_disposed = true;
_generation++;
unawaited(_frames?.cancel());
super.dispose();
}
@override
Widget build(BuildContext context) {
final running = runningShells(_shells);
final error = _listError;
// Recorded facts only, honestly: no tasks and no refusal draws nothing.
if (running.isEmpty && error == null) return const SizedBox.shrink();
final cupertino =
chatControlsStyleOf(context) == ChatControlsStyle.cupertino;
final selectedShell = _selectedShell(running);
// The bar is pinned above the transcript, so it keeps a bounded share of
// the window and scrolls its own body. Even three rows plus an open detail
// can then never push the transcript or the composer out of the viewport.
return ConstrainedBox(
key: const Key('chat-background-tasks'),
constraints: BoxConstraints(
maxHeight:
MediaQuery.sizeOf(context).height * backgroundTaskViewportShare,
),
child: LayoutBuilder(
builder: (context, constraints) => SingleChildScrollView(
key: const Key('chat-background-tasks-scroll'),
padding: const EdgeInsetsDirectional.fromSTEB(16, 4, 16, 4),
child: Column(
crossAxisAlignment: CrossAxisAlignment.stretch,
spacing: 4,
children: [
_heading(context, cupertino, running.length, error == null),
if (error != null) _listFailure(context, cupertino, error),
if (running.isNotEmpty) _taskList(context, cupertino, running),
if (selectedShell != null)
ChatBackgroundTaskDetail(
key: const Key('chat-bg-task-detail'),
shell: selectedShell,
output: _output,
// The detail derives its output pane from the space this bar
// actually has left instead of the whole window.
heightBudget: constraints.maxHeight,
onRefresh: () =>
unawaited(_readOutput(shellIdOf(selectedShell))),
),
],
),
),
),
);
}
/// The running task this visit has selected, or null after it exited.
JsonMap? _selectedShell(List<JsonMap> running) {
for (final shell in running) {
if (shellIdOf(shell) == _selectedId) return shell;
}
return null;
}
Widget _heading(
BuildContext context,
bool cupertino,
int count,
bool countKnown,
) {
final titleStyle = cupertino
? CupertinoTheme.of(context).textTheme.textStyle
: Theme.of(context).textTheme.labelLarge;
final countStyle = cupertino
? CupertinoTheme.of(context).textTheme.tabLabelTextStyle.copyWith(
color: CupertinoColors.secondaryLabel.resolveFrom(context),
)
: Theme.of(context).textTheme.labelMedium?.copyWith(
color: Theme.of(context).colorScheme.onSurfaceVariant,
);
return Row(
spacing: 8,
children: [
Expanded(
flex: 2,
child: Semantics(
header: true,
child: Text(
backgroundTasksTitle,
// One compact line like the web's head: a large text scale elides
// rather than wrapping the heading into a tall stack.
maxLines: 1,
overflow: TextOverflow.ellipsis,
style: titleStyle,
),
),
),
if (countKnown)
Flexible(
child: Text(
backgroundTasksRunningLabel(count),
maxLines: 1,
overflow: TextOverflow.ellipsis,
style: countStyle,
),
),
],
);
}
Widget _listFailure(BuildContext context, bool cupertino, String error) {
final color = cupertino
? CupertinoColors.systemRed.resolveFrom(context)
: Theme.of(context).colorScheme.error;
final style =
(cupertino
? CupertinoTheme.of(context).textTheme.textStyle
: Theme.of(context).textTheme.bodySmall)
?.copyWith(color: color);
return Row(
key: const Key('chat-background-tasks-error'),
crossAxisAlignment: CrossAxisAlignment.start,
children: [
Icon(
cupertino
? CupertinoIcons.exclamationmark_circle
: Icons.error_outline,
color: color,
),
const SizedBox(width: 8),
Expanded(
child: Padding(
padding: const EdgeInsets.symmetric(vertical: 8),
child: Text('Background tasks unavailable. $error', style: style),
),
),
ChatBackgroundTaskButton(
label: shellOutputRetryLabel,
onPressed: () => unawaited(_loadShells()),
),
],
);
}
Widget _taskList(
BuildContext context,
bool cupertino,
List<JsonMap> running,
) {
final rows = [
for (final shell in running)
_taskRow(context, cupertino, shell, shellIdOf(shell) == _selectedId),
];
final list = Column(
mainAxisSize: MainAxisSize.min,
crossAxisAlignment: CrossAxisAlignment.stretch,
children: rows,
);
if (rows.length <= backgroundTaskVisibleRows) return list;
// More than the recorded visible-row cap: the list scrolls instead of
// pushing the composer down. The bound is the host's own touch target.
return ConstrainedBox(
key: const Key('chat-bg-task-list'),
constraints: const BoxConstraints(
maxHeight: kMinInteractiveDimension * backgroundTaskVisibleRows,
),
child: SingleChildScrollView(child: list),
);
}
Widget _taskRow(
BuildContext context,
bool cupertino,
JsonMap shell,
bool selected,
) {
final id = shellIdOf(shell);
final key = ValueKey<String>('chat-bg-task-$id');
final command = shellCommandSummary(shell['command']);
if (cupertino) {
final primary = CupertinoTheme.of(context).primaryColor;
final muted = CupertinoColors.secondaryLabel.resolveFrom(context);
final style = CupertinoTheme.of(context).textTheme.textStyle;
return Semantics(
selected: selected,
child: CupertinoButton(
key: key,
padding: EdgeInsets.zero,
onPressed: () => _select(id),
child: Row(
spacing: 8,
children: [
Icon(CupertinoIcons.play_fill, color: primary),
Flexible(
child: Text(
shellRowLabel,
maxLines: 1,
overflow: TextOverflow.ellipsis,
style: style.copyWith(color: primary),
),
),
Expanded(
flex: 3,
child: Text(
command,
maxLines: 1,
overflow: TextOverflow.ellipsis,
style: style.copyWith(color: muted),
),
),
if (selected)
Flexible(
child: Text(
shellDetailsLabel,
maxLines: 1,
overflow: TextOverflow.ellipsis,
style: CupertinoTheme.of(
context,
).textTheme.tabLabelTextStyle.copyWith(color: muted),
),
),
],
),
),
);
}
final theme = Theme.of(context);
final fullCommand = '${shell['command'] ?? ''}'.trim();
final rowStyle = theme.textTheme.labelMedium;
return Semantics(
selected: selected,
child: Tooltip(
// The row elides its command; the full recorded one stays reachable,
// as the web row's `title` attribute does.
message: fullCommand.isEmpty ? command : fullCommand,
excludeFromSemantics: true,
child: ListTile(
key: key,
dense: true,
contentPadding: EdgeInsets.zero,
leading: Icon(Icons.play_arrow, color: theme.colorScheme.tertiary),
title: Row(
spacing: 8,
children: [
// Every part of the row is flexible: at a large text scale or a
// narrow phone the labels elide instead of overflowing the row.
Flexible(
child: Text(
shellRowLabel,
maxLines: 1,
overflow: TextOverflow.ellipsis,
style: rowStyle?.copyWith(color: theme.colorScheme.tertiary),
),
),
Expanded(
flex: 3,
child: Text(
command,
maxLines: 1,
overflow: TextOverflow.ellipsis,
style: rowStyle?.copyWith(
color: theme.colorScheme.onSurfaceVariant,
),
),
),
if (selected)
Flexible(
child: Text(
shellDetailsLabel,
maxLines: 1,
overflow: TextOverflow.ellipsis,
style: theme.textTheme.labelSmall,
),
),
],
),
onTap: () => _select(id),
),
),
);
}
}
@@ -11,6 +11,7 @@ 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_background_tasks.dart';
import 'chat_composer_bar.dart';
import 'chat_composer_controller.dart';
import 'chat_draft_store.dart';
@@ -582,6 +583,15 @@ class _ChatThreadViewState extends State<ChatThreadView> {
_scheduleFollow();
return Column(
children: [
// The session's still-running background tasks, above the transcript
// and outside its scroller (web C11). It removes itself when the last
// task exits and never draws a finished task.
ChatBackgroundTasks(
key: ValueKey<String>('chat-background-tasks-${widget.sessionId}'),
gateway: widget.gateway,
sessionId: widget.sessionId,
syncToken: widget.syncToken,
),
Expanded(
child: NotificationListener<ScrollMetricsNotification>(
onNotification: _onScrollMetrics,
@@ -0,0 +1,185 @@
import '../../../core/api_gateway.dart';
/// The background shells a chat session owns (C11).
///
/// These are recorded facts only: the status and command come from the server's
/// `chat_shells` snapshot or a pushed `shell` frame. Nothing here invents an
/// exit, an output or a command, and every read below is scoped to one session
/// so a task stays linked to the conversation that owns it.
const chatShellRunning = 'running';
const chatShellExited = 'exited';
/// The retained shell tail a client keeps (mirrors ChatStore's observation
/// bound). This is not task history, only what this client itself observed.
const observedShellLimit = 16;
/// How many running-task rows are drawn before the list scrolls instead of
/// growing, so a burst of tasks cannot push the composer off screen.
const backgroundTaskVisibleRows = 3;
/// The server's absolute-byte bound for one lazy output page
/// (ChatShellOutputLimit). Reads always start at cursor 0.
const chatShellOutputLimit = 64 * 1024;
const backgroundTasksTitle = 'Background tasks';
const shellRowLabel = 'Running';
const shellDetailsLabel = 'Details';
String backgroundTasksRunningLabel(int count) => '$count running';
const shellOutputCommandLabel = 'Command';
const shellOutputUnavailableLabel = 'Unavailable';
const shellOutputTaskIdentityLabel = 'Task identity';
const shellStatusRunningLabel = 'Status: running';
const shellOutputUnavailableNote = 'Output unavailable for this task.';
const shellOutputEmptyNote = 'No output yet.';
const shellOutputLabel = 'Output';
const shellOutputBoundedNote = 'Output is bounded to 64 KiB.';
const shellOutputRetryLabel = 'Retry';
const shellOutputRefreshLabel = 'Refresh';
/// The generic name for a running shell that reported no command, rather than
/// an empty row. Mirrors the web and Android shellCommandSummary.
const shellCommandFallback = 'background process';
/// A one-line command is elided past this width like a tool call's detail.
const shellCommandSummaryLength = 72;
bool blankShellValue(Object? value) => value == null || '$value'.trim().isEmpty;
String shellIdOf(JsonMap shell) => '${shell['id'] ?? ''}';
/// Whether [shell] is a task that is still running: a non-blank id whose status
/// the server recorded as running. An exited shell is never a task.
bool isRunningShell(JsonMap shell) =>
!blankShellValue(shell['id']) &&
'${shell['status'] ?? ''}' == chatShellRunning;
/// The running tasks in the order they started. The visible-row cap is a view
/// concern, so this never truncates the recorded list.
List<JsonMap> runningShells(List<JsonMap> shells) => [
for (final shell in shells)
if (isRunningShell(shell)) shell,
];
/// Folds one shell frame (or a snapshot entry) into the retained shells, keyed
/// by id and kept in observation order.
///
/// A blank incoming command keeps the command already learned, so a later frame
/// that omits it never blanks the row. The retained list is trimmed to the last
/// [observedShellLimit] entries.
List<JsonMap> mergeShellFrame(List<JsonMap> shells, JsonMap? shell) {
if (shell == null || blankShellValue(shell['id'])) return shells;
final id = shellIdOf(shell);
final next = List<JsonMap>.of(shells);
final index = next.indexWhere((candidate) => shellIdOf(candidate) == id);
final prior = index >= 0 ? next[index] : null;
final merged = <String, dynamic>{
...shell,
'id': id,
'command': blankShellValue(shell['command'])
? (prior?['command'] ?? '')
: shell['command'],
};
if (index >= 0) {
next[index] = merged;
} else {
next.add(merged);
}
return next.length <= observedShellLimit
? next
: next.sublist(next.length - observedShellLimit);
}
/// Folds a `chat_shells` snapshot into the retained shells: an exit this client
/// observed is kept, the server's current running list wins by id, and a shell
/// the server no longer lists (and whose exit this client never saw) drops out.
List<JsonMap> shellsLoaded(List<JsonMap> shells, List<JsonMap> running) {
final byId = <String, JsonMap>{};
for (final shell in shells) {
if (!blankShellValue(shell['id']) &&
'${shell['status'] ?? ''}' == chatShellExited) {
byId[shellIdOf(shell)] = shell;
}
}
for (final shell in running) {
if (blankShellValue(shell['id'])) continue;
byId[shellIdOf(shell)] = shell;
}
final values = byId.values.toList();
return values.length <= observedShellLimit
? values
: values.sublist(values.length - observedShellLimit);
}
/// The one-line command a background process is running: whitespace collapsed,
/// elided past [shellCommandSummaryLength], and a generic word when the server
/// reported no command.
String shellCommandSummary(Object? command) {
final text = '${command ?? ''}'.trim().replaceAll(RegExp(r'\s+'), ' ');
if (text.isEmpty) return shellCommandFallback;
if (text.length <= shellCommandSummaryLength) return text;
return '${text.substring(0, shellCommandSummaryLength - 1).trimRight()}…';
}
/// One bounded, read-only output page from a verified shell. Unknown fields stay
/// empty/false instead of being guessed.
class ChatShellOutputPage {
const ChatShellOutputPage({
this.output = '',
this.truncated = false,
this.unavailable = false,
this.shell,
});
factory ChatShellOutputPage.fromReply(JsonMap reply) {
final value = reply['chat_shell_output'];
// A reply without the page is not evidence of an empty shell. Report it as
// unavailable (as the web refuses it) instead of inventing "No output yet.".
if (value is! Map) {
return const ChatShellOutputPage(unavailable: true);
}
final page = Map<String, dynamic>.from(value);
final shell = page['shell'];
return ChatShellOutputPage(
output: '${page['output'] ?? ''}',
truncated: page['truncated'] == true,
unavailable: page['unavailable'] == true,
shell: shell is Map ? Map<String, dynamic>.from(shell) : null,
);
}
final String output;
final bool truncated;
final bool unavailable;
/// The shell the page reports, so a settled task can be folded back into the
/// retained list without losing the command already learned.
final JsonMap? shell;
}
/// The five shapes a selected task's output area can take. Unknown fields are
/// reported as unavailable or empty, never rendered as invented output.
enum ChatShellOutputState { none, loading, error, unavailable, empty, ready }
class ChatShellOutputSnapshot {
const ChatShellOutputSnapshot({
this.loading = false,
this.error = '',
this.page,
});
final bool loading;
final String error;
final ChatShellOutputPage? page;
ChatShellOutputState get state {
if (loading) return ChatShellOutputState.loading;
if (error.trim().isNotEmpty) return ChatShellOutputState.error;
final current = page;
if (current == null) return ChatShellOutputState.none;
if (current.unavailable) return ChatShellOutputState.unavailable;
if (current.output.isEmpty) return ChatShellOutputState.empty;
return ChatShellOutputState.ready;
}
}
@@ -0,0 +1,582 @@
import 'dart:async';
import 'package:flutter/cupertino.dart';
import 'package:flutter/material.dart';
import 'package:flutter_test/flutter_test.dart';
import 'package:pipelines_app/core/api_gateway.dart';
import 'package:pipelines_app/core/transport/connection_state.dart';
import 'package:pipelines_app/features/chat/conversation/chat_background_tasks.dart';
import 'package:pipelines_app/features/chat/conversation/chat_thread_view.dart';
import 'package:pipelines_app/features/chat/domain/chat_shells.dart';
/// A gateway that scripts the session snapshot and bounded output reads and can
/// push a shell frame for the selected conversation.
class _TasksGateway implements ApiGateway {
final calls = <({String type, JsonMap fields})>[];
final _frames = StreamController<JsonMap>.broadcast();
Future<JsonMap> Function()? shells;
Future<JsonMap> Function(JsonMap fields)? output;
@override
Stream<JsonMap> get frames => _frames.stream;
@override
Future<JsonMap> call(String type, [JsonMap fields = const {}]) async {
calls.add((type: type, fields: fields));
switch (type) {
case 'chat_shells':
return shells == null
? <String, dynamic>{'chat_shells': const []}
: shells!();
case 'chat_shell_output':
return output == null
? <String, dynamic>{'chat_shell_output': const {}}
: output!(fields);
case 'chat_subscribe':
return <String, dynamic>{};
case 'chat_messages':
return <String, dynamic>{
'chat_history': {
'messages': const [],
'next_cursor': '',
'has_more': false,
},
};
}
return <String, dynamic>{};
}
List<JsonMap> fieldsFor(String type) => [
for (final call in calls)
if (call.type == type) call.fields,
];
void emitShell(
String id,
String status, {
String command = '',
String session = 's',
}) => _frames.add({
'type': 'chat_event',
'chat_event': {
'session_id': session,
'kind': 'shell',
'shell': {'id': id, 'status': status, 'command': command},
},
});
void close() => _frames.close();
}
JsonMap _running(String id, {String command = 'go test ./...'}) => {
'id': id,
'status': 'running',
'command': command,
};
JsonMap _snapshot(List<JsonMap> shells) => {'chat_shells': shells};
/// A realistically long recorded page (200 shell lines, more than one screen).
List<String> _pageLines() => [
for (var index = 0; index < 200; index++) 'line $index',
];
Widget _host(
_TasksGateway gateway, {
bool cupertino = false,
int syncToken = 0,
}) {
final child = ChatBackgroundTasks(
gateway: gateway,
sessionId: 's',
syncToken: syncToken,
);
if (cupertino) {
return CupertinoApp(
home: CupertinoPageScaffold(child: SingleChildScrollView(child: child)),
);
}
return MaterialApp(
theme: ThemeData(platform: TargetPlatform.android),
home: Scaffold(body: SingleChildScrollView(child: child)),
);
}
Widget _thread(_TasksGateway gateway) => MaterialApp(
theme: ThemeData(platform: TargetPlatform.android),
home: Scaffold(
body: ChatThreadView(gateway: gateway, sessionId: 's', onBack: () {}),
),
);
Future<void> _tapTask(WidgetTester tester, String id) async {
await tester.tap(find.byKey(ValueKey<String>('chat-bg-task-$id')));
await tester.pumpAndSettle();
}
void main() {
testWidgets('shows only the session snapshot tasks that are still running', (
tester,
) async {
final gateway = _TasksGateway();
gateway.shells = () async => _snapshot([
_running('sh1'),
{'id': 'sh2', 'status': 'exited', 'command': 'pnpm build'},
{'id': '', 'status': 'running', 'command': 'no identity'},
]);
addTearDown(gateway.close);
await tester.pumpWidget(_host(gateway));
await tester.pumpAndSettle();
expect(find.text('Background tasks'), findsOneWidget);
expect(find.text('1 running'), findsOneWidget);
expect(find.text('Running'), findsOneWidget);
expect(find.text('go test ./...'), findsOneWidget);
expect(find.text('pnpm build'), findsNothing);
expect(find.text('no identity'), findsNothing);
expect(gateway.fieldsFor('chat_shells'), [
{
'chat_query': {'session_id': 's'},
},
]);
});
testWidgets('an honest empty snapshot draws no task surface', (tester) async {
final gateway = _TasksGateway();
addTearDown(gateway.close);
await tester.pumpWidget(_host(gateway));
await tester.pumpAndSettle();
expect(find.byKey(const Key('chat-background-tasks')), findsNothing);
expect(find.text('Background tasks'), findsNothing);
expect(gateway.fieldsFor('chat_shells'), hasLength(1));
});
testWidgets('pushed shell frames add and remove this session tasks', (
tester,
) async {
final gateway = _TasksGateway();
addTearDown(gateway.close);
await tester.pumpWidget(_host(gateway));
await tester.pumpAndSettle();
expect(find.text('Background tasks'), findsNothing);
gateway.emitShell('sh1', 'running', command: 'tail -f server.log');
await tester.pumpAndSettle();
expect(find.text('Background tasks'), findsOneWidget);
expect(find.text('1 running'), findsOneWidget);
expect(find.text('tail -f server.log'), findsOneWidget);
gateway.emitShell('sh1', 'exited');
await tester.pumpAndSettle();
expect(find.text('Background tasks'), findsNothing);
gateway.emitShell('other', 'running', session: 'other-session');
await tester.pumpAndSettle();
expect(find.text('Background tasks'), findsNothing);
});
testWidgets('more than three running tasks scroll inside the bar', (
tester,
) async {
final gateway = _TasksGateway()
..shells = () async => _snapshot([
for (var index = 0; index < 4; index++) _running('sh$index'),
]);
addTearDown(gateway.close);
await tester.pumpWidget(_host(gateway));
await tester.pumpAndSettle();
expect(find.text('4 running'), findsOneWidget);
expect(find.byKey(const Key('chat-bg-task-list')), findsOneWidget);
expect(
tester.getRect(find.byKey(const Key('chat-bg-task-list'))).height,
lessThanOrEqualTo(kMinInteractiveDimension * backgroundTaskVisibleRows),
);
for (var index = 0; index < 4; index++) {
expect(
find.byKey(ValueKey<String>('chat-bg-task-sh$index')),
findsOneWidget,
);
}
});
testWidgets('selecting a task reads one bounded session-linked page', (
tester,
) async {
final gateway = _TasksGateway();
gateway.shells = () async => _snapshot([_running('sh1')]);
gateway.output = (fields) async => {
'chat_shell_output': {
'shell': _running('sh1'),
'output': 'ok example\n--- PASS: TestOne\n',
'cursor': 0,
'size': 8192,
'truncated': true,
},
};
addTearDown(gateway.close);
await tester.pumpWidget(_host(gateway));
await tester.pumpAndSettle();
await _tapTask(tester, 'sh1');
expect(gateway.fieldsFor('chat_shell_output'), [
{
'chat_shell_output_query': {
'session_id': 's',
'shell_id': 'sh1',
'cursor': 0,
'limit': chatShellOutputLimit,
},
},
]);
expect(find.byKey(const Key('chat-bg-task-detail')), findsOneWidget);
expect(find.text('Command'), findsOneWidget);
expect(find.text('Task identity'), findsOneWidget);
expect(find.text('sh1'), findsOneWidget);
expect(find.text('Status: running'), findsOneWidget);
expect(find.text('Output'), findsOneWidget);
expect(
tester
.widget<SelectableText>(find.byKey(const Key('chat-bg-task-output')))
.data,
'ok example\n--- PASS: TestOne\n',
);
expect(find.text('Output is bounded to 64 KiB.'), findsOneWidget);
expect(find.text('Refresh'), findsOneWidget);
// Selecting the open task again closes its detail without another read.
await _tapTask(tester, 'sh1');
expect(find.byKey(const Key('chat-bg-task-detail')), findsNothing);
expect(gateway.fieldsFor('chat_shell_output'), hasLength(1));
});
testWidgets('the output pane reports empty, unavailable and a refusal', (
tester,
) async {
final gateway = _TasksGateway()
..shells = () async => _snapshot([_running('sh1')]);
addTearDown(gateway.close);
await tester.pumpWidget(_host(gateway));
await tester.pumpAndSettle();
// A reply with no page at all is unavailable, not "No output yet.".
gateway.output = (_) async => const <String, dynamic>{};
await _tapTask(tester, 'sh1');
expect(find.text('Output unavailable for this task.'), findsOneWidget);
gateway.output = (_) async => {
'chat_shell_output': {'shell': _running('sh1')},
};
await _tapTask(tester, 'sh1');
await _tapTask(tester, 'sh1');
expect(find.text('No output yet.'), findsOneWidget);
gateway.output = (_) async => {
'chat_shell_output': {'shell': _running('sh1'), 'unavailable': true},
};
await _tapTask(tester, 'sh1');
await _tapTask(tester, 'sh1');
expect(find.text('Output unavailable for this task.'), findsOneWidget);
gateway.output = (_) async => throw ProtocolError('output refused');
await _tapTask(tester, 'sh1');
await _tapTask(tester, 'sh1');
expect(find.byKey(const Key('chat-bg-task-output-error')), findsOneWidget);
expect(find.text('output refused'), findsOneWidget);
expect(find.text('Retry'), findsOneWidget);
gateway.output = (_) async => {
'chat_shell_output': {'shell': _running('sh1'), 'output': 'fresh output'},
};
await tester.tap(find.text('Retry'));
await tester.pumpAndSettle();
expect(find.byKey(const Key('chat-bg-task-output-error')), findsNothing);
expect(
tester
.widget<SelectableText>(find.byKey(const Key('chat-bg-task-output')))
.data,
'fresh output',
);
});
testWidgets('a refused snapshot is reported and Retry rereads it', (
tester,
) async {
final gateway = _TasksGateway()
..shells = () async => throw ProtocolError('server down');
addTearDown(gateway.close);
await tester.pumpWidget(_host(gateway));
await tester.pumpAndSettle();
expect(
find.textContaining('Background tasks unavailable. server down'),
findsOneWidget,
);
expect(find.text('0 running'), findsNothing);
gateway.shells = () async => _snapshot([_running('sh1')]);
await tester.tap(find.text('Retry'));
await tester.pumpAndSettle();
expect(find.byKey(const Key('chat-background-tasks-error')), findsNothing);
expect(find.text('Background tasks'), findsOneWidget);
expect(find.text('1 running'), findsOneWidget);
expect(gateway.fieldsFor('chat_shells'), hasLength(2));
});
testWidgets('an exit closes the selected pane and the bar', (tester) async {
final gateway = _TasksGateway();
gateway.shells = () async => _snapshot([_running('sh1')]);
gateway.output = (_) async => {
'chat_shell_output': {
'shell': _running('sh1'),
'output': 'still running',
},
};
addTearDown(gateway.close);
await tester.pumpWidget(_host(gateway));
await tester.pumpAndSettle();
await _tapTask(tester, 'sh1');
expect(find.byKey(const Key('chat-bg-task-detail')), findsOneWidget);
gateway.emitShell('sh1', 'exited');
await tester.pumpAndSettle();
expect(find.byKey(const Key('chat-bg-task-detail')), findsNothing);
expect(find.text('Background tasks'), findsNothing);
});
testWidgets('a replaced socket drops held tasks and re-learns the snapshot', (
tester,
) async {
final gateway = _TasksGateway()
..shells = () async => _snapshot([_running('sh1')]);
addTearDown(gateway.close);
await tester.pumpWidget(_host(gateway));
await tester.pumpAndSettle();
expect(find.text('1 running'), findsOneWidget);
gateway.shells = () async => _snapshot(const []);
await tester.pumpWidget(_host(gateway, syncToken: 1));
await tester.pumpAndSettle();
expect(find.text('Background tasks'), findsNothing);
expect(gateway.fieldsFor('chat_shells'), hasLength(2));
});
testWidgets('the Cupertino host keeps native buttons and the same facts', (
tester,
) async {
final gateway = _TasksGateway();
gateway.shells = () async => _snapshot([_running('sh1')]);
gateway.output = (_) async => {
'chat_shell_output': {
'shell': _running('sh1'),
'output': 'native output',
},
};
addTearDown(gateway.close);
await tester.pumpWidget(_host(gateway, cupertino: true));
await tester.pumpAndSettle();
expect(find.byType(CupertinoButton), findsWidgets);
expect(find.text('1 running'), findsOneWidget);
await _tapTask(tester, 'sh1');
expect(find.text('Command'), findsOneWidget);
expect(find.text('Status: running'), findsOneWidget);
expect(
tester
.widget<SelectableText>(find.byKey(const Key('chat-bg-task-output')))
.data,
'native output',
);
});
testWidgets('a long output page scrolls inside a bounded pane', (
tester,
) async {
tester.view.physicalSize = const Size(400, 700);
tester.view.devicePixelRatio = 1;
addTearDown(tester.view.resetPhysicalSize);
addTearDown(tester.view.resetDevicePixelRatio);
final lines = [for (var index = 0; index < 200; index++) 'line $index'];
final gateway = _TasksGateway();
gateway.shells = () async => _snapshot([_running('sh1')]);
gateway.output = (_) async => {
'chat_shell_output': {
'shell': _running('sh1'),
'output': '${lines.join('\n')}\n',
},
};
addTearDown(gateway.close);
await tester.pumpWidget(_thread(gateway));
await tester.pumpAndSettle();
await _tapTask(tester, 'sh1');
// A real shell tail is bounded: the transcript and composer stay in the
// viewport instead of being pushed out by the whole page.
expect(tester.takeException(), isNull);
final outputFinder = find.byKey(const Key('chat-bg-task-output'));
final output = tester.getRect(outputFinder);
expect(output.height, lessThanOrEqualTo(210));
final detail = tester.getRect(find.byKey(const Key('chat-bg-task-detail')));
final composer = tester.getRect(
find.byKey(const ValueKey<String>('chat-composer-s')),
);
expect(detail.bottom, lessThanOrEqualTo(composer.top));
expect(composer.bottom, lessThanOrEqualTo(700));
// The page scrolls through the host's own text control to its last line.
expect(
tester.widget<SelectableText>(outputFinder).data,
contains('line 199'),
);
final scrollable = tester.state<ScrollableState>(
find.descendant(of: outputFinder, matching: find.byType(Scrollable)),
);
expect(scrollable.position.maxScrollExtent, greaterThan(0));
await tester.drag(outputFinder, const Offset(0, -300));
await tester.pumpAndSettle();
expect(scrollable.position.pixels, greaterThan(0));
});
testWidgets('three tasks and an open page fit a 320px phone', (tester) async {
tester.view.physicalSize = const Size(320, 568);
tester.view.devicePixelRatio = 1;
addTearDown(tester.view.resetPhysicalSize);
addTearDown(tester.view.resetDevicePixelRatio);
final gateway = _TasksGateway();
gateway.shells = () async =>
_snapshot([_running('sh1'), _running('sh2'), _running('sh3')]);
gateway.output = (_) async => {
'chat_shell_output': {
'shell': _running('sh1'),
'output': '${_pageLines().join('\n')}\n',
},
};
addTearDown(gateway.close);
await tester.pumpWidget(_thread(gateway));
await tester.pumpAndSettle();
await _tapTask(tester, 'sh1');
// Three rows plus the whole detail can no longer take the viewport: the bar
// keeps its share, scrolls its own body, and the composer stays reachable.
expect(tester.takeException(), isNull);
final bar = tester.getRect(find.byKey(const Key('chat-background-tasks')));
final composer = tester.getRect(
find.byKey(const ValueKey<String>('chat-composer-s')),
);
final transcript = tester.getRect(
find.byKey(const ValueKey<String>('chat-thread-s')),
);
expect(
bar.height,
lessThanOrEqualTo(568 * backgroundTaskViewportShare + 0.5),
);
expect(bar.bottom, lessThanOrEqualTo(composer.top));
expect(composer.bottom, lessThanOrEqualTo(568));
expect(transcript.height, greaterThan(0));
expect(
find.byKey(const Key('chat-background-tasks-scroll')),
findsOneWidget,
);
});
testWidgets('one open task at 2x text keeps the composer on screen', (
tester,
) async {
tester.view.physicalSize = const Size(320, 568);
tester.view.devicePixelRatio = 1;
tester.platformDispatcher.textScaleFactorTestValue = 2;
addTearDown(tester.view.resetPhysicalSize);
addTearDown(tester.view.resetDevicePixelRatio);
addTearDown(tester.platformDispatcher.clearTextScaleFactorTestValue);
final gateway = _TasksGateway();
gateway.shells = () async => _snapshot([_running('sh1')]);
gateway.output = (_) async => {
'chat_shell_output': {
'shell': _running('sh1'),
'output': '${_pageLines().join('\n')}\n',
},
};
addTearDown(gateway.close);
await tester.pumpWidget(_thread(gateway));
await tester.pumpAndSettle();
await _tapTask(tester, 'sh1');
expect(find.byKey(const Key('chat-bg-task-detail')), findsOneWidget);
// The row labels and the detail are laid out at twice the text size without
// overflowing, and the bar's bound still leaves the composer on screen.
expect(tester.takeException(), isNull);
final bar = tester.getRect(find.byKey(const Key('chat-background-tasks')));
final composer = tester.getRect(
find.byKey(const ValueKey<String>('chat-composer-s')),
);
expect(bar.bottom, lessThanOrEqualTo(composer.top));
expect(composer.bottom, lessThanOrEqualTo(568));
});
testWidgets('the Cupertino row elides its labels instead of overflowing', (
tester,
) async {
tester.view.physicalSize = const Size(320, 568);
tester.view.devicePixelRatio = 1;
tester.platformDispatcher.textScaleFactorTestValue = 2;
addTearDown(tester.view.resetPhysicalSize);
addTearDown(tester.view.resetDevicePixelRatio);
addTearDown(tester.platformDispatcher.clearTextScaleFactorTestValue);
final gateway = _TasksGateway();
gateway.shells = () async => _snapshot([
_running('sh1', command: 'go test ./... -run TestSomethingLongEnough'),
]);
gateway.output = (_) async => {
'chat_shell_output': {
'shell': _running('sh1'),
'output': 'native output',
},
};
addTearDown(gateway.close);
await tester.pumpWidget(_host(gateway, cupertino: true));
await tester.pumpAndSettle();
expect(tester.takeException(), isNull);
await _tapTask(tester, 'sh1');
expect(tester.takeException(), isNull);
expect(find.text('Details'), findsOneWidget);
});
testWidgets('the conversation mounts the session task surface', (
tester,
) async {
final gateway = _TasksGateway()
..shells = () async => _snapshot([_running('sh1')]);
addTearDown(gateway.close);
await tester.pumpWidget(_thread(gateway));
await tester.pumpAndSettle();
expect(find.byKey(const Key('chat-background-tasks')), findsOneWidget);
expect(find.text('Background tasks'), findsOneWidget);
expect(find.text('1 running'), findsOneWidget);
});
}
@@ -0,0 +1,165 @@
import 'package:flutter_test/flutter_test.dart';
import 'package:pipelines_app/core/api_gateway.dart';
import 'package:pipelines_app/features/chat/domain/chat_shells.dart';
JsonMap _shell(String id, String status, {String command = ''}) => {
'id': id,
'status': status,
'command': command,
};
void main() {
group('recorded running tasks', () {
test('only a non-blank id with status running is a task', () {
final shells = [
_shell('sh1', 'running', command: 'go test ./...'),
_shell('sh2', 'exited', command: 'pnpm build'),
_shell('', 'running', command: 'no identity'),
{'status': 'running', 'command': 'no id'},
_shell('sh3', 'pending', command: 'not started'),
];
expect(runningShells(shells).map((shell) => shell['id']), ['sh1']);
});
test('a shell frame merges by id and keeps the command already known', () {
final first = mergeShellFrame(
const [],
_shell('sh1', 'running', command: 'go test ./...'),
);
final exited = mergeShellFrame(first, _shell('sh1', 'exited'));
final other = mergeShellFrame(
exited,
_shell('sh2', 'running', command: 'sleep 1'),
);
expect(other, hasLength(2));
expect(other.first['status'], 'exited');
expect(other.first['command'], 'go test ./...');
expect(runningShells(other).map((shell) => shell['id']), ['sh2']);
expect(mergeShellFrame(other, null), same(other));
expect(mergeShellFrame(other, _shell('', 'running')), same(other));
});
test('the retained observation tail is bounded', () {
var shells = const <JsonMap>[];
for (var index = 0; index < observedShellLimit + 4; index++) {
shells = mergeShellFrame(shells, _shell('sh$index', 'running'));
}
expect(shells, hasLength(observedShellLimit));
expect(shells.first['id'], 'sh4');
expect(shells.last['id'], 'sh${observedShellLimit + 3}');
});
test('a snapshot keeps observed exits and drops shells never seen', () {
final observed = [
_shell('exited', 'exited', command: 'pnpm build'),
_shell('running', 'running', command: 'go test ./...'),
_shell('gone', 'running', command: 'old fact'),
];
final loaded = shellsLoaded(observed, [
_shell('running', 'running', command: 'go test ./...'),
_shell('new', 'running', command: 'tail -f log'),
]);
expect(loaded.map((shell) => '${shell['id']}:${shell['status']}'), [
'exited:exited',
'running:running',
'new:running',
]);
expect(runningShells(loaded).map((shell) => shell['id']), [
'running',
'new',
]);
});
});
group('shell wording', () {
test('the command collapses whitespace and names a blank one', () {
expect(shellCommandSummary(' go test\n ./... '), 'go test ./...');
expect(shellCommandSummary(' '), 'background process');
expect(shellCommandSummary(null), 'background process');
});
test('a long command is elided to the tool-detail width', () {
final summary = shellCommandSummary('x' * 200);
expect(summary.length, shellCommandSummaryLength);
expect(summary.endsWith('…'), isTrue);
expect(summary, '${'x' * (shellCommandSummaryLength - 1)}…');
});
test('the heading keeps the recorded count', () {
expect(backgroundTasksTitle, 'Background tasks');
expect(backgroundTasksRunningLabel(0), '0 running');
expect(backgroundTasksRunningLabel(3), '3 running');
});
});
group('bounded output page', () {
test('a page carries its output, bound and reported shell', () {
final page = ChatShellOutputPage.fromReply({
'chat_shell_output': {
'shell': {'id': 'sh1', 'status': 'running', 'command': 'go test'},
'output': 'ok example\n',
'cursor': 0,
'size': 11,
'truncated': true,
},
});
expect(page.output, 'ok example\n');
expect(page.truncated, isTrue);
expect(page.unavailable, isFalse);
expect(page.shell?['command'], 'go test');
expect(chatShellOutputLimit, 64 * 1024);
});
test('a reply without the page is unavailable, never invented output', () {
final page = ChatShellOutputPage.fromReply(const {});
expect(page.output, '');
expect(page.shell, isNull);
expect(page.unavailable, isTrue);
expect(
ChatShellOutputSnapshot(page: page).state,
ChatShellOutputState.unavailable,
);
expect(
const ChatShellOutputSnapshot(page: ChatShellOutputPage()).state,
ChatShellOutputState.empty,
);
});
test(
'the pane state follows loading, error, unavailable, empty, ready',
() {
expect(
const ChatShellOutputSnapshot().state,
ChatShellOutputState.none,
);
expect(
const ChatShellOutputSnapshot(loading: true).state,
ChatShellOutputState.loading,
);
expect(
const ChatShellOutputSnapshot(error: 'refused').state,
ChatShellOutputState.error,
);
expect(
const ChatShellOutputSnapshot(
page: ChatShellOutputPage(unavailable: true),
).state,
ChatShellOutputState.unavailable,
);
expect(
const ChatShellOutputSnapshot(
page: ChatShellOutputPage(output: 'ready'),
).state,
ChatShellOutputState.ready,
);
},
);
});
}