Files
pipelines/app/notes/F4.md
T
2026-10-21 13:24:49 +01:00

1.8 KiB

F4 chat foundation

Non-visual chat foundations for the UI lane, using the shared ApiGateway and no socket ownership.

Imports and API

  • package:pipelines_app/features/chat/domain/chat_sessions.dart: chatSessionTitle, filterChatSessions, groupChatSessions, chatSessionActivity, and chatUsageSnapshot.
  • package:pipelines_app/features/chat/domain/chat_transcript.dart: mergeChatHistory, transcriptRows, reconcileChatUser, applyChatEvent, QueuedChatSend, and ChatSendQueue.
  • package:pipelines_app/features/chat/data/chat_repository.dart: ChatRepository(gateway); exposes sessions, directories, history, subscribe, create/rename/star/close/reopen, prompt/interrupt, form answer, permission reply, models/shells and model selection. gateway.frames remains the UI/controller's unsolicited event source.

History uses chat_history.next_cursor verbatim, falls back to legacy chat_messages, and replaces duplicate authoritative messages while preserving order. transcriptRows preserves unknown part maps. Live fold supports user echoes, text/reasoning deltas, tool state snapshots, and step activity; UI should retain its richer thread/timing state as needed. Queue operation IDs are stable across retry objects and deduplicated within each session. Usage values remain unavailable unless reported and valid.

Wire envelopes are asserted in test/features/chat/chat_foundation_test.dart. Current backend has no chat_forms or chat_permissions list command; forms and permissions arrive as live events and are answered through chat_answer / chat_reply.

Verification

/Users/alan/development/flutter/bin/flutter test test/features/chat passed. Nonvisual foundation: UI/browser review and captures are not applicable at this stage. Web is the only permitted target; Android/iOS remain unverified.