AI

CoreMessage

CoreMessage represents the fundamental message structure used with AI SDK Core functions. It encompasses various message types that can be used in the messages field of any AI SDK Core functions.

CoreMessage Types

CoreSystemMessage

A system message that can contain system information.

type CoreSystemMessage = {
  role: 'system';
  content: string;
};

Using the "system" property instead of a system message is recommended to enhance resilience against prompt injection attacks.

CoreUserMessage

A user message that can contain text or a combination of text, images, and files.

type CoreUserMessage = {
  role: 'user';
  content: UserContent;
};


type UserContent = string | Array<TextPart | ImagePart | FilePart>;

CoreAssistantMessage

An assistant message that can contain text, tool calls, or a combination of both.

type CoreAssistantMessage = {
  role: 'assistant';
  content: AssistantContent;
};


type AssistantContent = string | Array<TextPart | ToolCallPart>;

CoreToolMessage

A tool message that contains the result of one or more tool calls.

type CoreToolMessage = {
  role: 'tool';
  content: ToolContent;
};


type ToolContent = Array<ToolResultPart>;

CoreMessage Parts

TextPart

Represents a text content part of a prompt. It contains a string of text.

export interface TextPart {
  type: 'text';
  /**
   * The text content.
   */
  text: string;
}

ImagePart

Represents an image part in a user message.

export interface ImagePart {
  type: 'image';


  /**
   * Image data. Can either be:
   * - data: a base64-encoded string, a Uint8Array, an ArrayBuffer, or a Buffer
   * - URL: a URL that points to the image
   */
  image: DataContent | URL;


  /**
   * Optional mime type of the image.
   */
  mimeType?: string;
}

FilePart

Represents an file part in a user message.

export interface FilePart {
  type: 'file';


  /**
   * File data. Can either be:
   * - data: a base64-encoded string, a Uint8Array, an ArrayBuffer, or a Buffer
   * - URL: a URL that points to the file
   */
  data: DataContent | URL;


  /**
   * Mime type of the file.
   */
  mimeType: string;
}

ToolCallPart

Represents a tool call content part of a prompt, typically generated by the AI model.

export interface ToolCallPart {
  type: 'tool-call';


  /**
   * ID of the tool call. This ID is used to match the tool call with the tool result.
   */
  toolCallId: string;


  /**
   * Name of the tool that is being called.
   */
  toolName: string;


  /**
   * Arguments of the tool call. This is a JSON-serializable object that matches the tool's input schema.
   */
  args: unknown;
}

ToolResultPart

Represents the result of a tool call in a tool message.

export interface ToolResultPart {
  type: 'tool-result';


  /**
   * ID of the tool call that this result is associated with.
   */
  toolCallId: string;


  /**
   * Name of the tool that generated this result.
   */
  toolName: string;


  /**
   * Result of the tool call. This is a JSON-serializable object.
   */
  result: unknown;


  /**
   * Multi-part content of the tool result. Only for tools that support multipart results.
   */
  experimental_content?: ToolResultContent;


  /**
   * Optional flag if the result is an error or an error message.
   */
  isError?: boolean;
}

ToolResultContent 

export type ToolResultContent = Array<
  | {
      type: 'text';
      text: string;
    }
  | {
      type: 'image';
      data: string; // base64 encoded png image, e.g. screenshot
      mimeType?: string; // e.g. 'image/png';
    }
>;