ModelAssistantToolMessage

CORE · type · Type contract

Assistant turn that may declare tool calls and may carry an empty text body.

Import

TypeScript

import type { ModelAssistantToolMessage } from '@jangts/agent-core/types';

JavaScript

/** @typedef {import('@jangts/agent-core/types').ModelAssistantToolMessage} ModelAssistantToolMessage */

Other public entry points:@jangts/agent-core/types, @jangts/agent-core/structs.

Definition

Type: ModelAssistantToolMessage

Type expression

type ModelAssistantToolMessage = ModelMessage & {
  readonly role: 'assistant';
  readonly toolCalls?: readonly ModelToolCall[];
  readonly toolCallId?: never;
  readonly images?: never;
};

Field structure

Field	Type	Required	Description
role	"assistant"	Required	See the type definition and usage context.
content	string	Required	Rendered text content sent to the model.
images	undefined	Optional	User-supplied visual input. Binary payload is separate from the text character budget.
toolCalls	readonly ModelToolCall[] | undefined	Optional	Tool declarations made by an assistant turn; rejected on every other role at runtime.
toolCallId	undefined	Optional	Call id answered by a tool result; rejected on every other role at runtime.

Using the type

Read the contract at the call site

TypeScript

import type { ModelAssistantToolMessage } from '@jangts/agent-core/types';

// Keep the original contract at the call site; TS and JS share the same runtime behavior.
function inspect(value: ModelAssistantToolMessage) {
  return value.role;
}

JavaScript

/** @param {import('@jangts/agent-core/types').ModelAssistantToolMessage} value */
function inspect(value) {
  return value.role;
}

Related definitions

• ModelMessage
• ModelToolCall