| title | ConversationMessage |
|---|---|
| description | ConversationMessage Schema Reference |
| Property | Type | Required | Description |
|---|---|---|---|
| id | string |
✅ | Unique message ID |
| timestamp | string |
✅ | ISO 8601 timestamp |
| role | Enum<'system' | 'user' | 'assistant' | 'function' | 'tool'> |
✅ | |
| content | string | object[] |
✅ | Message content (text or multimodal) |
| functionCall | object |
optional | Legacy function call |
| toolCalls | object[] |
optional | Tool calls |
| toolCallId | string |
optional | Tool call ID this message responds to |
| name | string |
optional | Name of the function/user |
| tokens | object |
optional | Token usage for this message |
| pinned | boolean |
optional | Prevent removal during pruning |
| importance | number |
optional | Importance score for pruning |
| embedding | number[] |
optional | Vector embedding for semantic search |
| metadata | Record<string, any> |
optional |