Skip to content

AgentChat: split the 2,646-line page into composition + nine module folders - #150

Draft
kai-openswarm wants to merge 6 commits into
openswarm-ai:devfrom
kai-openswarm:c11/agentchat
Draft

AgentChat: split the 2,646-line page into composition + nine module folders#150
kai-openswarm wants to merge 6 commits into
openswarm-ai:devfrom
kai-openswarm:c11/agentchat

Conversation

@kai-openswarm

Copy link
Copy Markdown

Draft, stacked on #147 (its test runner and import-safe shared modules; the extra commits in this diff disappear once #147 merges). Second of three god-file splits (#149 is the layout slice, electron/main.js follows). Same ask as #149: a short freeze on AgentChat.tsx before this leaves draft — you stop touching the file, I rebase and mark ready within the hour, you review/merge, freeze lifts.

AgentChat.tsx held the whole chat page: session lookup and lifecycle, the transcript derivation (message windowing, tool grouping, streaming merge), scroll mechanics, the message queue, model/MCP notices, and the render of header / transcript / approvals / composer. It is now a 291-line composition of these modules, each under its own folder next to the existing ChatInput/, bubbles/, tool-bubbles/, tool-ui/, shell/:

Folder Responsibility
session/ session resolution, resume/close lifecycle, per-session refs
transcript/ render-item derivation, tool grouping, streaming/partial merge
windowing/ message window bounds and estimated heights
scroll/ windowed scrolling, follow/pin, height measurement, scroll-to-bottom
streaming/ thinking bubble + just-streamed tracking
queue/ queued-while-running messages and their panel
model/ model-switch and MCP-activation notices
composer/ continue glow, Haiku/MCP warnings, MCP suggestions banner
render/ header, resume button, MCP connect offer

No behaviour change is intended: the exported page and every element the e2e suites address (data-* selectors, ids, text) are unchanged. Two pure module tests come with it (windowing bounds, scroll window solver — 23 cases, node:test). scripts/run-tests.mjs gains --require ./scripts/css-stub.cjs because some units live in component files that import a stylesheet.

Proof: tsc --noEmit clean; runner 166/166; packaged macOS app: upstream smoke 5/5 + the characterization suite (#146) 19/19 — the chat/tool-ui and resilience specs exercise this page directly.

Offered separately if wanted: 12 hook/component tests for these modules exist on @testing-library/react; they need jsdom + testing-library as devDeps, which the repo does not have today.

… a window, so reducer tests run under node:test

Both modules touched window at import time (port/host derivation, the fetch
interceptor install, the debug handle), so any node:test file that imports a
reducer importing API_BASE died with 'window is not defined' before its first
assertion; fetchSessionsStrip.test.ts has been red that way since the
resilience work landed, unnoticed because nothing runs these tests in CI. In a
renderer (window present) nothing changes: same port/host, same interceptor,
same handle. Without one the module answers with the defaults and installs
nothing.
Nothing ran any of them in CI: the 235-file backend pytest suite, the 22
renderer node:test files and the edge suite were run by hand, one file at a
time, so a regression only surfaced when someone happened to run the right
one. Three small workflows, hosted ubuntu, path-filtered, read-only token:

- backend-tests: pytest on Python 3.13 from the locked requirements, plus a
  completion assertion (junit testcase count == collect-only count) so a test
  process that dies mid-run can never read as green
- frontend-tests: tsc --noEmit + node:test via tsx over src/**/*.test.ts(x),
  through frontend/scripts/run-tests.mjs (the runner the tests already name)
- edge-tests: pytest for openswarm-edge

All three are green on the current tree: 2951 backend tests, 143 frontend
tests across 22 files, 14 edge tests.
Two of five hosted runs of the backend suite stalled at 99% until the job cap
with no summary and no junit: one test blocked forever on a bare
ws.receive_json() (fixed on its own in a separate change). A CI lane should
never depend on every test being unable to hang, so add pytest-timeout to the
dev requirements and run the suite with --timeout=300. On Linux the default
signal method fails just the offending test and the run continues, so the
report and the "every collected test ran" assertion stay meaningful.
test_ws_endpoint_streams_a_full_turn_end_to_end read the socket with a bare
ws.receive_json() in a 40-iteration loop and broke only on the assistant reply.
When the loop ends early for any reason (fewer than 40 events, no reply), the
next receive blocks forever and the whole pytest run stalls at 99% until the
job cap. On hosted runners it does exactly that intermittently, on Linux and
Windows alike: the turn path's configure_provider_env decides whether 9Router
needs reviving from provider evidence earlier tests may leave behind, and that
revival spawns/installs the router behind a module-level asyncio.Lock; the
background turn-label aux call reaches the same machinery. Neither is part of
this test's contract ("SDK and WS auth mocked, everything else real").

Pin both out with monkeypatch, bound every receive at 5s (a regression now
fails this test instead of hanging the runner), and wait for the turn's
completed status before asserting on session.messages so the assertion cannot
race the loop's tail.
Same class as the config/backendConnection change: safeMode.ts read `window`
at import, and dashboardLayoutSlice imports it, so any reducer test that
imports the slice died under node:test before it ran. Guard the read; in a
renderer nothing changes.
…olders

AgentChat.tsx held the whole chat page: session lookup and lifecycle, the
transcript derivation (message windowing, tool grouping, streaming merge),
scroll mechanics, the message queue, model/MCP notices, and the render of
header / transcript / approvals / composer. It is now a 291-line composition
of these modules, each under its own folder next to the existing ChatInput/,
bubbles/, tool-bubbles/, tool-ui/ and shell/ folders:

  session/     session resolution, resume/close lifecycle, per-session refs
  transcript/  render-item derivation, tool grouping, streaming/partial merge
  windowing/   message window bounds and estimated heights
  scroll/      windowed scrolling, follow/pin, height measurement, scroll-to-bottom
  streaming/   thinking bubble + just-streamed tracking
  queue/       queued-while-running messages and their panel
  model/       model-switch and MCP-activation notices
  composer/    continue glow, Haiku/MCP warnings, MCP suggestions banner
  render/      header, resume button, MCP connect offer

No behaviour change is intended; the exported page and every element the e2e
suites address (data-* selectors, ids, text) are unchanged. Two pure module
tests come with it (windowing bounds, scroll window solver; node:test).

The frontend test runner gains --require ./scripts/css-stub.cjs: some units
live in component files that import a stylesheet, which node would otherwise
parse as JavaScript.
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant