ChatMessage

Individual chat message in a conversation with an AI assistant

Schema

| Property | Type | Required | Description | |----------|------|----------|-------------| | id | string (uuid) | ✓ | Unique identifier for the message | | role | enum | ✓ | Role of the message sender | | content | string | ✓ | Message content text | | timestamp | string (date-time) | ✓ | Message creation timestamp | | model | string | | AI model used for this response (e.g., 'llama-3.3', 'claude-sonnet') | | provider | string | | AI provider name (e.g., 'groq', 'anthropic', 'openai') | | usage | TokenUsage | | Token usage statistics for this message | | metadata | SkillMetadata | | Additional metadata about skills and suggestions |

Example

{
  "id": "550e8400-e29b-41d4-a716-446655440000",
  "role": "user",
  "content": "Explain agentic programming in one sentence",
  "timestamp": "2025-11-21T10:00:00Z"
}

Enums

role

user | assistant | system