```
@Serializable() 
public final class Message

                    
```
One transcript line / message. Mirrors the Rust Message shape.
For outbound sends the SDK fires MessageAdded with a provisional Message(id = "", localId = <uuid>, status = SENDING, ...) before the wire round-trip. The server-issued id lands on the follow-up MessageUpdated. The stable lookup key during the sending phase is localId; once delivered, both id and localId are populated.

Field Summary

Fields
Modifier and Type	Field	Description
`private final MessageRole`	`role`
`private final String`	`id`
`private final String`	`localId`
`private final String`	`text`
`private final String`	`html`
`private final String`	`timestamp`
`private final String`	`userId`
`private final String`	`userName`
`private final String`	`action`
`private final List<Attachment>`	`attachments`
`private final List<MessageButton>`	`buttons`
`private final List<MessageCard>`	`gallery`
`private final String`	`errorText`
`private final MessageStatus`	`status`
`private final MessageState`	`state`
`private final MessageMetadata`	`metadata`

Constructor Summary

Constructors
Constructor	Description
`Message(MessageRole role, String id, String localId, String text, String html, String timestamp, String userId, String userName, String action, List<Attachment> attachments, List<MessageButton> buttons, List<MessageCard> gallery, String errorText, MessageStatus status, MessageState state, MessageMetadata metadata)`

Method Summary

Modifier and Type	Method	Description
`final MessageRole`	`getRole()`
`final String`	`getId()`
`final String`	`getLocalId()`	SDK-issued temporary id for outbound messages awaiting server confirmation.
`final String`	`getText()`
`final String`	`getHtml()`
`final String`	`getTimestamp()`
`final String`	`getUserId()`
`final String`	`getUserName()`
`final String`	`getAction()`	Lifecycle action for a `role == SYSTEM` row: `"queued"` \| `"joined"` \| `"ended"`.
`final List<Attachment>`	`getAttachments()`
`final List<MessageButton>`	`getButtons()`	Interactive prompt options on a flow-authored `role == SYSTEM` row.
`final List<MessageCard>`	`getGallery()`	Gallery-card carousel on a flow-authored `role == SYSTEM` row — the card-shaped sibling of buttons.
`final String`	`getErrorText()`
`final MessageStatus`	`getStatus()`
`final MessageState`	`getState()`
`final MessageMetadata`	`getMetadata()`

Methods inherited from class java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

- Constructor Detail
  - Message
```
Message(MessageRole role, String id, String localId, String text, String html, String timestamp, String userId, String userName, String action, List<Attachment> attachments, List<MessageButton> buttons, List<MessageCard> gallery, String errorText, MessageStatus status, MessageState state, MessageMetadata metadata)
```
- Method Detail
  - getRole
```
 final MessageRole getRole()
```
  - getId
```
 final String getId()
```
  - getLocalId
```
 final String getLocalId()
```
    SDK-issued temporary id for outbound messages awaiting server confirmation. Set on the provisional MessageAdded payload so the consumer can locate the row when MessageUpdated arrives. null for inbound messages or any message originating on the server.
  - getText
```
 final String getText()
```
  - getHtml
```
 final String getHtml()
```
  - getTimestamp
```
 final String getTimestamp()
```
  - getUserId
```
 final String getUserId()
```
  - getUserName
```
 final String getUserName()
```
  - getAction
```
 final String getAction()
```
    Lifecycle action for a role == SYSTEM row: "queued" | "joined" | "ended". Set by connect on lifecycle system messages; absent on ordinary messages and on flow-bot system messages (which keep bubble rendering — the divider discriminator is action-presence, NOT role). Wire key: action. Connect owns the vocabulary; a distinct "left" was considered and dropped there.
  - getAttachments
```
 final List<Attachment> getAttachments()
```
  - getButtons
```
 final List<MessageButton> getButtons()
```
    Interactive prompt options on a flow-authored role == SYSTEM row. Empty on every ordinary message — a non-empty list is what makes this message a prompt. Note a prompt carries NO action, so it renders as a bubble, not a lifecycle divider.
  - getGallery
```
 final List<MessageCard> getGallery()
```
    Gallery-card carousel on a flow-authored role == SYSTEM row — the card-shaped sibling of buttons. Empty on ordinary messages.
  - getErrorText
```
 final String getErrorText()
```
  - getStatus
```
 final MessageStatus getStatus()
```
  - getState
```
 final MessageState getState()
```
  - getMetadata
```
 final MessageMetadata getMetadata()
```

Class Message

Field Summary

Constructor Summary

Method Summary

Methods inherited from class java.lang.Object

Constructor Detail

Message

Method Detail

getRole

getId

getLocalId

getText

getHtml

getTimestamp

getUserId

getUserName

getAction

getAttachments

getButtons

getGallery

getErrorText

getStatus

getState

getMetadata