60 lines
972 B
Markdown
60 lines
972 B
Markdown
|
# 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"
|
||
|
|
}
|
||
|
|
}
|
||
|
|
}
|
||
|
|
```
|