@nyosegawa/agent-ui-react

React preset, headless controllers, and transcript-first UI primitives for Agent UI.

Use this package when a host application wants to compose Agent UI in a React surface while keeping runtime ownership in the host.

Install

bun add @nyosegawa/agent-ui-react @nyosegawa/agent-ui-core @nyosegawa/agent-ui-codex

Import the public stylesheet once:

import "@nyosegawa/agent-ui-react/styles.css";

Common Imports

| Use case | Import | | --- | --- | | Default provider and chat preset | import { AgentProvider, AgentChat } from "@nyosegawa/agent-ui-react"; | | Preset replacement map and defaults | import { defaultAgentComponents, type AgentComponents } from "@nyosegawa/agent-ui-react"; | | Visual building blocks | import { AgentThreadView, AgentComposer } from "@nyosegawa/agent-ui-react/primitives"; | | Host-owned controllers | import { useAgentChatController } from "@nyosegawa/agent-ui-react/headless"; | | Bundled stylesheet | import "@nyosegawa/agent-ui-react/styles.css"; |

Transcript display policy is controlled with transcriptDisplay, not block-kind conditionals. The same semantic policy works on AgentChat, AgentThreadView, AgentMessageList, and useAgentTranscriptController():

<AgentChat transcriptMode="answer-focused" />

Use an explicit policy when the host needs category or role-specific behavior:

<AgentChat
  transcriptDisplay={{
    byCategory: {
      reasoning: { visibility: "hidden" },
      command: { density: "expanded", visibility: "collapsed" },
    },
    default: { density: "comfortable", visibility: "visible" },
  }}
/>

Package Boundary

This package provides three public entrypoints:

• @nyosegawa/agent-ui-react for the default AgentProvider / AgentChat preset.
• @nyosegawa/agent-ui-react/primitives for visual building blocks.
• @nyosegawa/agent-ui-react/headless for hooks, controllers, and stable input/resource types.

It does not own routing, persistence, credentials, process lifecycle, or host-specific product workflows.

Customize the preset through public props, the components prop, primitives, headless controllers, and tokens. Import @nyosegawa/agent-ui-react/styles.css once; do not depend on private style chunks, internal .aui-* selectors, source modules, or generated Codex payloads as React API.

See the repository docs for current package exports and integration guidance: https://github.com/nyosegawa/agent-ui