ConversationProps

The long tail of ChatInputProps — triggers, commands, history, ghost-text suggestions, chip serialization, submit mode, …. The top-level placeholder/busy/onSubmit/onInterrupt take precedence over the same keys here.

disabled?

optional disabled?: boolean

Defined in: react/components/types.ts:52

Marks the widget (and its descendants) as inert: not focusable, ignores key/mouse input, and interactive controls render in a muted style. A disabled container propagates to every control inside it.

Inherited from

ComponentProps.disabled

extraHints?

optional extraHints?: ChatHint[]

Defined in: react/components/agent/conversation.tsx:45

Extra hints appended to the auto-rendered hint line.

focusable?

optional focusable?: boolean

Defined in: react/components/types.ts:40

Allow this widget to take keyboard focus.

Inherited from

ComponentProps.focusable

focusOnClick?

optional focusOnClick?: boolean

Defined in: react/components/types.ts:46

When a click lands on this container (its padding, border, or a non-focusable child), move focus to its first focusable descendant — so clicking a Form/Panel/Box hands focus to its first field. Off by default.

Inherited from

ComponentProps.focusOnClick

followTail?

optional followTail?: boolean

Defined in: react/components/agent/conversation.tsx:15

Pin to the newest turn until the user scrolls up (and re-pin on return). Default true.

optional footer?: ReactNode

Defined in: react/components/agent/conversation.tsx:38

Optional region between the transcript and the composer (e.g. a UsageMeter).

optional header?: ReactNode

Defined in: react/components/agent/conversation.tsx:36

Optional region above the transcript (e.g. a title bar).

hintLeading?

optional hintLeading?: ReactNode

Defined in: react/components/agent/conversation.tsx:50

Slot pinned to the left of the hint line, on the same row — for a status glyph, a connection Pill, a mode badge, etc.

hintTrailing?

optional hintTrailing?: ReactNode

Defined in: react/components/agent/conversation.tsx:56

Slot pinned to the right of the hint line, on the same row — for a model name, a UsageMeter, a token-rate readout, etc. A 1fr spacer separates it from the hints, so it hugs the right edge.

hoverInterest?

optional hoverInterest?: boolean

Defined in: react/components/types.ts:66

Opt-in hint that this widget cares about passive hover movement.

Inherited from

ComponentProps.hoverInterest

id?

optional id?: string

Defined in: react/components/types.ts:22

Stable identifier, handy for tests and lookups.

Inherited from

ComponentProps.id

label?

optional label?: string

Defined in: react/components/types.ts:36

Structural/accessible label (also the tab title inside TabContainer).

Inherited from

ComponentProps.label

onClick?

optional onClick?: (ev) => void

Defined in: react/components/types.ts:54

Pointer click.

Parameters

ev

any

Returns

void

Inherited from

ComponentProps.onClick

onDragEnd?

optional onDragEnd?: (x, y, moved) => void

Defined in: react/components/types.ts:72

Drag released; moved is false for a tap with no movement.

Parameters

x

number

y

number

moved

boolean

Returns

void

Inherited from

ComponentProps.onDragEnd

onDragMove?

optional onDragMove?: (x, y) => void

Defined in: react/components/types.ts:70

Pointer moved while dragging from this widget.

Parameters

x

number

y

number

Returns

void

Inherited from

ComponentProps.onDragMove

onDragStart?

optional onDragStart?: (x, y) => void

Defined in: react/components/types.ts:68

Pointer-drag lifecycle; moved is false for a tap with no movement.

Parameters

x

number

y

number

Returns

void

Inherited from

ComponentProps.onDragStart

onInterrupt?

optional onInterrupt?: () => void

Defined in: react/components/agent/conversation.tsx:26

Called when the user interrupts a busy agent (Esc / stop glyph).

Returns

void

onKey?

optional onKey?: (ev) => void

Defined in: react/components/types.ts:58

Key event while focused; set ev.handled to consume it.

Parameters

ev

any

Returns

void

Inherited from

ComponentProps.onKey

onMouseDown?

optional onMouseDown?: (ev) => void

Defined in: react/components/types.ts:56

Pointer pressed (any button); the event carries button and x/y.

Parameters

ev

any

Returns

void

Inherited from

ComponentProps.onMouseDown

onMouseEnter?

optional onMouseEnter?: (ev) => void

Defined in: react/components/types.ts:62

Pointer entered this widget’s region.

Parameters

ev

any

Returns

void

Inherited from

ComponentProps.onMouseEnter

onMouseLeave?

optional onMouseLeave?: (ev) => void

Defined in: react/components/types.ts:64

Pointer left this widget’s region.

Parameters

ev

any

Returns

void

Inherited from

ComponentProps.onMouseLeave

onScroll?

optional onScroll?: (ev) => void

Defined in: react/components/types.ts:60

Wheel / scroll event.

Parameters

ev

any

Returns

void

Inherited from

ComponentProps.onScroll

onSubmit?

optional onSubmit?: (value, attachments) => void

Defined in: react/components/agent/conversation.tsx:24

Called when the user sends a turn.

Parameters

value

string

attachments

Attachment[]

Returns

void

placeholder?

optional placeholder?: string

Defined in: react/components/agent/conversation.tsx:20

Hint shown in the empty composer.

readOnly?

optional readOnly?: boolean

Defined in: react/components/agent/conversation.tsx:18

Hide the composer for a read-only transcript view.

ref?

optional ref?: Ref<Widget>

Defined in: react/components/types.ts:30

Captures the underlying widget instance (React 19 ref-as-prop). Defaults to the base Widget; narrow it with a cast when you need a subclass field, e.g. ref={inputRef as React.Ref<InputWidget>}.