ModelMessage

Defined in: packages/ai/src/types.ts:374

Type Parameters#

TContent#

TContent extends string | null | ContentPart[] = string | null | ContentPart[]

Properties#

content#

content: TContent;

Defined in: packages/ai/src/types.ts:381

createdAt?#

optional createdAt?: Date;

Defined in: packages/ai/src/types.ts:414

Optional message creation timestamp. When present, message converters preserve it across persist → hydrate round-trips.

error?#

optional error?: string;

Defined in: packages/ai/src/types.ts:392

Error reported by an AG-UI tool message.

id?#

optional id?: string;

Defined in: packages/ai/src/types.ts:409

Optional stable message id. Providers ignore it; it exists so a persisted transcript can retain the streaming messageId and survive the persist → hydrate round-trip. When present, modelMessagesToUIMessages reuses it instead of generating a fresh id, so a hydrated message keeps the same identity as its live stream — which is what lets a mid-stream reload resume the SAME message bubble in place (see @tanstack/ai-persistence).

metadata?#

optional metadata?: Record<string, any>;

Defined in: packages/ai/src/types.ts:394

Optional AG-UI message metadata. TanStack-owned fields live under tanstack.

name?#

optional name?: string;

Defined in: packages/ai/src/types.ts:382

role#

role: "assistant" | "user" | "tool";

Defined in: packages/ai/src/types.ts:380

structuredOutput?#

optional structuredOutput?: StructuredOutputPart<unknown>;

Defined in: packages/ai/src/types.ts:400

Completed structured output represented by this assistant message. content remains the provider-facing JSON text; this field preserves the typed UI part across persistence and message conversion.

thinking?#

optional thinking?: object[];

Defined in: packages/ai/src/types.ts:390

Signed thinking to send back to the provider. redacted: true marks a block the provider encrypted: content is empty and signature holds its opaque data. See ThinkingPart.signature for the planned rename.

content#

content: string;

redacted?#

optional redacted?: boolean;

signature?#

optional signature?: string;

toolCallId?#

optional toolCallId?: string;

Defined in: packages/ai/src/types.ts:384

toolCalls?#

optional toolCalls?: ToolCall<unknown>[];

Defined in: packages/ai/src/types.ts:383