# Agent Chat Sessions Protocol

> **NOTE**: This document is the single source of truth. All implementations must follow this specification.

## Overview

Agent chat session state snapshot for preserving conversation context.

## Version

- **Current**: `1.0`
- **Status**: Active

---

## Session State Snapshot

```typescript
interface SessionStateSnapshot {
  // Reserved for future use
  // Currently unused, allowing custom extensions
  [key: string]: any;
}
```

---

## Database Field

| Field | Type | Description |
|-------|------|-------------|
| state_snapshot | jsonb | Session state for preserving conversation context |

---

## JSON Examples

### Empty State

```json
{}
```

### Future Usage Example

```json
{
  "conversation_context": {
    "last_topic": "calendar_events",
    "mentioned_dates": ["2026-03-15", "2026-03-20"]
  },
  "agent_memory": {
    "user_preferences": {
      "timezone": "Asia/Shanghai",
      "language": "zh-CN"
    }
  }
}
```