session

type CleanupConfig struct {
	RetentionDays   int           // Number of days to retain sessions (default: 30)
	CleanupInterval time.Duration // Interval between cleanup runs (default: 24h)
}

type ConversationContext struct {
	SessionID string         `json:"session_id"`
	UserID    int32          `json:"user_id"`
	AgentType string         `json:"agent_type"`
	Messages  []Message      `json:"messages"`
	Metadata  map[string]any `json:"metadata"`
	CreatedAt int64          `json:"created_at"`
	UpdatedAt int64          `json:"updated_at"`
}

type Message struct {
	Role    string `json:"role"` // "user" | "assistant" | "system"
	Content string `json:"content"`
}

type MockSessionService struct {
	// contains filtered or unexported fields
}

type SessionCleanupJob struct {
	// contains filtered or unexported fields
}

type SessionRecovery struct {
	// contains filtered or unexported fields
}

type SessionService interface {
	// SaveContext saves the conversation context.
	SaveContext(ctx context.Context, sessionID string, context *ConversationContext) error

	// LoadContext loads the conversation context.
	LoadContext(ctx context.Context, sessionID string) (*ConversationContext, error)

	// ListSessions lists user sessions.
	ListSessions(ctx context.Context, userID int32, limit int) ([]SessionSummary, error)

	// DeleteSession deletes a session (user privacy control).
	DeleteSession(ctx context.Context, sessionID string) error

	// CleanupExpired removes sessions older than retentionDays.
	// Returns the number of deleted sessions.
	CleanupExpired(ctx context.Context, retentionDays int) (int64, error)
}

type SessionSummary struct {
	SessionID   string `json:"session_id"`
	AgentType   string `json:"agent_type"`
	LastMessage string `json:"last_message"`
	UpdatedAt   int64  `json:"updated_at"`
}