session

type EventType string

type ListSessionsOptions struct {
	PageParams storage.PageParams
	Search     string // 空=全部，非空=按消息内容 LIKE 模糊匹配
}

type Message struct {
	ID              int64  `gorm:"column:id;primaryKey;autoIncrement"                            json:"id"`
	SessionID       string `gorm:"column:session_id;index;not null"                             json:"session_id"`
	TurnID          int    `gorm:"column:turn_id;not null;default:0;index"                      json:"turn_id"` // 所属 turn，回退时直接 DELETE WHERE turn_id
	Role            string `gorm:"column:role;not null"                                          json:"role"`   // "system" | "user" | "assistant" | "tool"
	Content         string `gorm:"column:content;not null"                                       json:"content"`
	ThinkingContent string `gorm:"column:thinking_content"                                     json:"thinking_content,omitempty"`
	TokenCount      int    `gorm:"column:token_count;not null;default:0"                        json:"token_count"`
	ExtraMetadata   string `gorm:"column:extra_metadata"                                         json:"extra_metadata,omitempty"` // JSON：tool_calls / tool_call_id / display_text 等
	Version         int    `gorm:"column:version;not null;default:1;index"                      json:"version"`                   // 压缩代数，查询时 = session.active_version
	ToAPI           bool   `gorm:"column:to_api;not null;default:0;index"                       json:"to_api"`                    // LLM context 是否需要此消息。注：default:0 原因同上，子 agent 的 ToAPI=false 不能被默认值覆盖
	ToFrontend      bool   `gorm:"column:to_frontend;not null;default:0;index"                  json:"to_frontend"`               // 前端是否需要渲染此消息。注：default:0 必须与 Go false 一致，否则 GORM 跳过零值时 DB 填入默认值 1 导致泄漏
	// EventType 取值见上方 EventType 常量定义。
	EventType EventType `gorm:"column:event_type"                                             json:"event_type,omitempty"`
	AgentType string    `gorm:"column:agent_type;not null;default:'main';index"              json:"agent_type"`            // "main" | "review" | "memory"
	SubTaskID string    `gorm:"column:sub_task_id;index"                                     json:"sub_task_id,omitempty"` // run_subagent 的 tool call ID，前端路由子 Agent 消息用
	CreatedAt time.Time `gorm:"column:created_at;autoCreateTime;index"                       json:"created_at"`
}

type Session struct {
	SessionID       string    `gorm:"column:session_id;primaryKey"                                 json:"session_id"`
	NovelID         int64     `gorm:"column:novel_id;index:idx_sessions_novel;not null"            json:"novel_id"`
	Title           string    `gorm:"column:title;not null;default:''"                            json:"title"`
	Model           string    `gorm:"column:model;not null;default:deepseek-v4-pro"               json:"model"`
	ReasoningEffort string    `gorm:"column:reasoning_effort"                                      json:"reasoning_effort,omitempty"` // "high" | "max" | ""，DeepSeek 推理深度
	Summary         string    `gorm:"column:summary;not null;default:''"                          json:"summary"`                     // 最新压缩摘要，每次压缩全量替换
	PendingChanges  string    `gorm:"column:pending_changes"                                       json:"pending_changes,omitempty"`  // JSON，待确认的编辑变更列表
	ExtraMetadata   string    `gorm:"column:extra_metadata"                                        json:"extra_metadata,omitempty"`   // JSON，扩展槽
	ActiveVersion   int       `gorm:"column:active_version;not null;default:1"                    json:"active_version"`              // 当前活跃的上下文代数
	LastTurnID      int       `gorm:"column:last_turn_id;not null;default:0"                      json:"last_turn_id"`                // 最后一个 turn 的编号，原子自增
	Usage           string    `gorm:"column:usage"                                                 json:"usage,omitempty"`            // JSON，最近一次 LLM 调用的 token 用量
	CreatedAt       time.Time `gorm:"column:created_at;autoCreateTime"                            json:"created_at"`
	UpdatedAt       time.Time `gorm:"column:updated_at;autoUpdateTime;index:idx_sessions_novel"   json:"updated_at"`
}

type Store struct {
	DB *gorm.DB
	// contains filtered or unexported fields
}