import '../../../core/api_gateway.dart'; import 'chat_transcript.dart'; /// Entries a chat's model showed the operator through the Pipelines tools /// (`show_file`, `show_image`, `show_html`, `notify`). /// /// The server keeps them per chat, outside the harness transcript: the /// `chat_subscribe` reply carries the retained list (oldest first) and a /// pushed `chat_shown` frame carries each new or updated item. Items are keyed /// by `id`; a later copy replaces the held one in place. /// The four recorded kinds. const chatShownKinds = {'file', 'image', 'html', 'notify'}; /// The transcript row kind an item is drawn as. const String chatShownRowKind = 'shown'; /// The items of a `chat_shown` body for [sessionId], or null when the body is /// absent, malformed or for another chat. Items of unknown kind or without an /// id are dropped rather than drawn as something they are not. List? chatShownItemsOf(Object? body, String sessionId) { if (body is! Map || '${body['session_id'] ?? ''}' != sessionId) return null; final items = body['items']; if (items is! List) return const []; return [ for (final item in items.whereType()) if ('${item['id'] ?? ''}'.isNotEmpty && chatShownKinds.contains(item['kind'])) Map.from(item), ]; } /// [held] with [incoming] merged by id: a known item is replaced where it is, /// a new one is appended. [replace] adopts [incoming] as the whole list (the /// subscribe reply is the server's complete retained set). List mergeChatShownItems( List held, List incoming, { bool replace = false, }) { if (replace) return List.unmodifiable(incoming); final byId = {for (final item in incoming) '${item['id']}': item}; final merged = [ for (final item in held) byId.remove('${item['id']}') ?? item, ...byId.values, ]; return List.unmodifiable(merged); } /// The tool names a harness reports for the Pipelines tools: Claude Code /// `mcp__pipelines__show_file`, OpenCode `pipelines_show_file`, Codex /// `pipelines/show_file`. final RegExp _pipelinesTool = RegExp( r'^(?:mcp__pipelines__|pipelines_|pipelines/)' r'(?:show_file|show_image|show_html|notify)$', ); /// Whether [part] is a call of a Pipelines tool whose result the transcript /// draws as its own entry. A failed call stays a normal tool row: its error is /// the only record of what went wrong. bool chatPipelinesToolRepresented(JsonMap part) { if ('${part['type'] ?? ''}' != 'tool') return false; if (!_pipelinesTool.hasMatch('${part['name'] ?? ''}'.trim())) return false; final state = part['state']; return !(state is Map && '${state['status'] ?? ''}' == 'error'); } int? _createdAt(JsonMap value) => chatMessageCreatedAt(value); /// A transcript row's recorded time, or null for a row without one. int? _rowTime(JsonMap row) { final own = _createdAt(row); if (own != null) return own; final message = row['message']; return message is Map ? _createdAt(Map.from(message)) : null; } /// [rows] (from [transcriptRows]) with the Pipelines tool calls removed from /// answer turns and each shown item placed by its time. /// /// An item goes before the first timed row recorded after it, else after the /// last timed row (so it never follows the pending cards or the response /// shell that come after the transcript). While older history pages remain /// ([hasMore]), an item older than the oldest loaded row stays out until that /// page loads, so it is never drawn above messages that precede it. List withChatShownItems( List rows, List items, { required bool hasMore, }) { final out = []; for (final row in rows) { final parts = row['parts']; if (row['kind'] != 'assistant' || parts is! List) { out.add(row); continue; } final kept = [ for (final part in parts.whereType()) if (!chatPipelinesToolRepresented(Map.from(part))) part, ]; if (kept.length == parts.length) { out.add(row); } else if (kept.isNotEmpty || row['streaming'] == true || row['activityRecords'] != null) { out.add({...row, 'parts': kept}); } } if (items.isEmpty) return out; final timed = [ for (final item in items) if (_createdAt(item) != null) item, ]..sort((a, b) => _createdAt(a)!.compareTo(_createdAt(b)!)); int? oldest; var lastTimed = -1; for (var index = 0; index < out.length; index++) { final time = _rowTime(out[index]); if (time == null) continue; oldest ??= time; lastTimed = index; } final result = []; var next = 0; JsonMap rowOf(JsonMap item) => { 'kind': chatShownRowKind, 'key': 'chat-shown-${item['id']}', 'messageIds': ['shown:${item['id']}'], 'item': item, }; if (hasMore) { while (next < timed.length && (oldest == null || _createdAt(timed[next])! < oldest)) { next++; } } for (var index = 0; index < out.length; index++) { final time = _rowTime(out[index]); if (time != null) { while (next < timed.length && _createdAt(timed[next])! < time) { result.add(rowOf(timed[next++])); } } result.add(out[index]); if (index == lastTimed) { while (next < timed.length) { result.add(rowOf(timed[next++])); } } } // A transcript with no timed row yet: the items lead. if (lastTimed < 0) { return [for (; next < timed.length; next++) rowOf(timed[next]), ...result]; } return result; }