Chat History API

Persistent conversation storage.

langchain_cockroachdb.chat_message_histories.CockroachDBChatMessageHistory

Bases: BaseChatMessageHistory

Chat message history stored in CockroachDB.

messages property

Get all messages for this session.

__del__()

Cleanup on deletion.

__init__(session_id, connection_string=None, engine=None, table_name='message_store', schema='public')

Initialize chat message history.

Parameters:

Name	Type	Description	Default
session_id	str	Unique session/thread identifier	required
connection_string	str | None	Database connection string	None
engine	AsyncEngine | None	Existing async engine	None
table_name	str	Table name for messages	'message_store'
schema	str	Database schema	'public'

aadd_message(message) async

Add a message (async).

aadd_messages(messages) async

Add multiple messages (async).

aclear() async

Clear messages (async).

aclose() async

Close engine if we own it.

add_message(message)

Add a message to the session.

add_messages(messages)

Add multiple messages.

aget_messages() async

Get all messages for this session (async).

clear()

Clear all messages for this session.

close()

Close engine (sync).

create_table_if_not_exists()

Create table (sync wrapper).

Key Methods

Method	Description
add_user_message()	Add user message
add_ai_message()	Add AI response
add_message()	Add any message type
clear()	Clear session history
messages	Get all messages

Examples

See Chat History Guide for comprehensive examples.