Interface ScenarioExecutionStateLike

Readonlyconfig

Readonlydescription

currentTurn

• get currentTurn(): number

  The current turn number in the scenario.

  Returns number

messages

• get messages(): ModelMessage[]

  The sequence of messages exchanged during the scenario.

  Returns ModelMessage[]

threadId

• get threadId(): string

  The unique identifier for the execution thread.

  Returns string

addMessage

• addMessage(message: ModelMessage): void

  Adds a message to the scenario's execution state.

  Parameters

  • message: ModelMessage

    The core message to add.

  Returns void

hasToolCall

• hasToolCall(toolName: string): boolean

  Checks if a tool call for a specific tool exists in the execution state.

  Parameters

  • toolName: string

    The name of the tool.

  Returns boolean

  True if the tool call exists, false otherwise.

lastAgentMessage

• lastAgentMessage(): AssistantModelMessage

  Retrieves the last agent message from the execution state.

  Returns AssistantModelMessage

  The last agent message.

lastMessage

• lastMessage(): ModelMessage

  Retrieves the last message from the execution state.

  Returns ModelMessage

  The last message.

lastToolCall

• lastToolCall(toolName: string): ToolModelMessage

  Retrieves the last tool call message for a specific tool.

  Parameters

  • toolName: string

    The name of the tool.

  Returns ToolModelMessage

  The last tool call message.

lastUserMessage

• lastUserMessage(): UserModelMessage

  Retrieves the last user message from the execution state.

  Returns UserModelMessage

  The last user message.

rollbackMessagesTo

• rollbackMessagesTo(index: number): ModelMessage[]

  Remove all messages from position index onward.

  Truncates the message list and cleans up any pending message queues so no agent sees stale messages.

  Parameters

  • index: number

    Truncate point (clamped to [0, messages.length]). Messages at positions >= index are removed.

  Returns ModelMessage[]

  The removed messages (empty array if nothing to remove).

  Throws

  If index is negative.