Skip to main content

Interface: IConversationMessage

Defined in: packages/agentos/src/core/storage/IStorageAdapter.ts:93

Represents a single message within a conversation.

Follows OpenAI's chat completion message format for compatibility with LLM providers.

IConversationMessage

Example​

const userMessage: IConversationMessage = {
  id: 'msg-001',
  conversationId: 'conv-123',
  role: 'user',
  content: 'What is TypeScript?',
  timestamp: Date.now()
};

const assistantMessage: IConversationMessage = {
  id: 'msg-002',
  conversationId: 'conv-123',
  role: 'assistant',
  content: 'TypeScript is a typed superset of JavaScript...',
  timestamp: Date.now(),
  model: 'gpt-4o',
  usage: { promptTokens: 10, completionTokens: 50, totalTokens: 60 }
};

Properties​

content​

content: string

Defined in: packages/agentos/src/core/storage/IStorageAdapter.ts:97

The text content of the message

conversationId​

conversationId: string

Defined in: packages/agentos/src/core/storage/IStorageAdapter.ts:95

ID of the conversation this message belongs to

id​

id: string

Defined in: packages/agentos/src/core/storage/IStorageAdapter.ts:94

Unique identifier for the message

metadata?​

optional metadata: Record<string, any>

Defined in: packages/agentos/src/core/storage/IStorageAdapter.ts:104

Additional metadata for extensibility

model?​

optional model: string

Defined in: packages/agentos/src/core/storage/IStorageAdapter.ts:99

LLM model used to generate this message (for assistant messages)

name?​

optional name: string

Defined in: packages/agentos/src/core/storage/IStorageAdapter.ts:103

Name field for tool/function messages

role​

role: "user" | "tool" | "system" | "assistant"

Defined in: packages/agentos/src/core/storage/IStorageAdapter.ts:96

Message role in conversation

timestamp​

timestamp: number

Defined in: packages/agentos/src/core/storage/IStorageAdapter.ts:98

Unix timestamp (milliseconds) when message was created

toolCallId?​

optional toolCallId: string

Defined in: packages/agentos/src/core/storage/IStorageAdapter.ts:102

ID linking this message to a tool call response

toolCalls?​

optional toolCalls: any[]

Defined in: packages/agentos/src/core/storage/IStorageAdapter.ts:101

Tool/function calls made in this message

usage?​

optional usage: ITokenUsage

Defined in: packages/agentos/src/core/storage/IStorageAdapter.ts:100

Token usage statistics for this message