agent-core / Exports / ConversationSession

Class: ConversationSession

Conversation session with duplicate prevention and API format conversion.

Implements

• IConversationHistory

Table of contents

Constructors

• constructor

Methods

• addMessage
• addUserMessage
• addAssistantMessage
• addSystemMessage
• addToolMessage
• addToolMessageWithId
• getMessages
• getMessagesByRole
• getRecentMessages
• getMessageCount
• getMessagesForAPI
• clear

Constructors

constructor

• new ConversationSession(maxMessages?): ConversationSession

Parameters

Name	Type	Default value
maxMessages	number	100

Returns

ConversationSession

Defined in

packages/agent-core/src/managers/conversation-session.ts:221

Methods

addMessage

▸ addMessage(message): void

Parameters

Name	Type
message	TUniversalMessage

Returns

void

Implementation of

IConversationHistory.addMessage

Defined in

packages/agent-core/src/managers/conversation-session.ts:225

---

addUserMessage

▸ addUserMessage(content, metadata?, parts?): void

Parameters

Name	Type
content	string
metadata?	TUniversalMessageMetadata
parts?	TUniversalMessagePart[]

Returns

void

Implementation of

IConversationHistory.addUserMessage

Defined in

packages/agent-core/src/managers/conversation-session.ts:228

---

addAssistantMessage

▸ addAssistantMessage(content, toolCalls?, metadata?, parts?): void

Parameters

Name	Type
content	null | string
toolCalls?	IToolCall[]
metadata?	TUniversalMessageMetadata
parts?	TUniversalMessagePart[]

Returns

void

Implementation of

IConversationHistory.addAssistantMessage

Defined in

packages/agent-core/src/managers/conversation-session.ts:235

---

addSystemMessage

▸ addSystemMessage(content, metadata?, parts?): void

Parameters

Name	Type
content	string
metadata?	TUniversalMessageMetadata
parts?	TUniversalMessagePart[]

Returns

void

Implementation of

IConversationHistory.addSystemMessage

Defined in

packages/agent-core/src/managers/conversation-session.ts:243

---

addToolMessage

▸ addToolMessage(content, toolCallId, toolName?, metadata?, parts?): void

Parameters

Name	Type
content	string
toolCallId	string
toolName?	string
metadata?	TUniversalMessageMetadata
parts?	TUniversalMessagePart[]

Returns

void

Defined in

packages/agent-core/src/managers/conversation-session.ts:251

---

addToolMessageWithId

▸ addToolMessageWithId(content, toolCallId, toolName, metadata?, parts?): void

Parameters

Name	Type
content	string
toolCallId	string
toolName	string
metadata?	TUniversalMessageMetadata
parts?	TUniversalMessagePart[]

Returns

void

Implementation of

IConversationHistory.addToolMessageWithId

Defined in

packages/agent-core/src/managers/conversation-session.ts:261

---

getMessages

▸ getMessages(): TUniversalMessage[]

Returns

TUniversalMessage[]

Implementation of

IConversationHistory.getMessages

Defined in

packages/agent-core/src/managers/conversation-session.ts:277

---

getMessagesByRole

▸ getMessagesByRole(role): TUniversalMessage[]

Parameters

Name	Type
role	TUniversalMessageRole

Returns

TUniversalMessage[]

Implementation of

IConversationHistory.getMessagesByRole

Defined in

packages/agent-core/src/managers/conversation-session.ts:280

---

getRecentMessages

▸ getRecentMessages(count): TUniversalMessage[]

Parameters

Name	Type
count	number

Returns

TUniversalMessage[]

Implementation of

IConversationHistory.getRecentMessages

Defined in

packages/agent-core/src/managers/conversation-session.ts:283

---

getMessageCount

▸ getMessageCount(): number

Returns

number

Implementation of

IConversationHistory.getMessageCount

Defined in

packages/agent-core/src/managers/conversation-session.ts:286

---

getMessagesForAPI

▸ getMessagesForAPI(): IProviderApiMessage[]

Returns

IProviderApiMessage[]

Defined in

packages/agent-core/src/managers/conversation-session.ts:290

---

clear

▸ clear(): void

Returns

void

Implementation of

IConversationHistory.clear

Defined in

packages/agent-core/src/managers/conversation-session.ts:300