@vitest-agent/ui

Part of the vitest-agent ecosystem. Most users want @vitest-agent/plugin, which pulls this package in automatically. Install @vitest-agent/ui directly only if you build custom rendering on the primitives.

Pure rendering primitives for vitest-agent. Owns the RunEvent reducer, the shape-tailored 12-cell dispatcher matrix, two render paths (agent string and React Ink tree), and the synthesizers that bridge live Vitest data and stored reports into the event taxonomy. React and Ink are required peer dependencies.

Features

• Reducer — pure (state, event) => state fold over the RunEvent discriminated union; reduceRenderStateAll for one-shot replay
• Dispatcher matrix — dispatch routes a DispatchInputs to the matching (RunShape, RunOutcome) cell; classifyRunShape and classifyOutcome derive the coordinates
• Ink components (@vitest-agent/ui/ink) — StreamApp and the supporting primitives (ModuleHeader, TestRow, CoverageBlock, TrendLine, FailureSection, etc.) for live stream-mode frames, plus dispatchInk / inkDispatcherTable, the Ink half of the matrix. The package root never loads React or Ink; only this subpath does
• Synthesizers — synthesizeRunEvents from live Vitest modules; synthesizeFromAgentReport from a stored AgentReport
• Footer builder — buildFooter assembles the L1 MCP-tool-pointer footer; dominantClassification picks the most actionable failure class

Install

npm install @vitest-agent/ui
# or
pnpm add @vitest-agent/ui

React and Ink are optional peers, needed only for the @vitest-agent/ui/ink subpath:

npm install react ink

Quick start

import { reduceRenderStateAll } from "@vitest-agent/ui";
import { dispatch } from "@vitest-agent/ui";

const state = reduceRenderStateAll(events);
// state is a fully reduced RenderState

const agentString = dispatch(buildDispatchInputs(state, input), opts);
// agentString is the markdown-flavored final-frame string for the run

Documentation

Package reference at vitest-agent.dev/ui.

License

MIT