ChatSession

A conversation session containing multiple messages

Schema

| Property | Type | Required | Description | |----------|------|----------|-------------| | id | string (uuid) | ✓ | Unique identifier for the session | | messages | ChatMessage.schema.json[] | ✓ | List of messages in this conversation | | created_at | string (date-time) | ✓ | Session creation timestamp | | updated_at | string (date-time) | ✓ | Last update timestamp | | title | string | | Optional title for the conversation | | model_preference | enum | | Preferred AI model for this session |

Example

{
  "id": "550e8400-e29b-41d4-a716-446655440000",
  "messages": [
    {
      "id": "msg-001",
      "role": "user",
      "content": "What is cuppa-cli?",
      "timestamp": "2025-11-21T10:00:00Z"
    },
    {
      "id": "msg-002",
      "role": "assistant",
      "content": "cuppa-cli is a code generation tool that creates platform-specific code from JSON Schemas and OpenAPI specifications.",
      "timestamp": "2025-11-21T10:00:02Z",
      "model": "llama-3.3",
      "provider": "groq"
    }
  ],
  "created_at": "2025-11-21T10:00:00Z",
  "updated_at": "2025-11-21T10:00:02Z",
  "title": "Learning about cuppa-cli",
  "model_preference": "llama-3.3"
}

Enums

model_preference

llama-3.3 | claude-sonnet | claude-haiku | gpt-4o