Function ToFile

pkg/app/export/html.go:127–161

ToFile exports session data to an HTML file. If filename is empty, a default name based on the title and timestamp is used. Returns the absolute path of the created file.

(data SessionData, filename string)

// If filename is empty, a default name based on the title and timestamp is used.
// Returns the absolute path of the created file.
func ToFile(data SessionData, filename string) (string, error) {
	if len(data.Messages) == 0 {
		return "", errors.New("session is empty")
	}

	// Generate filename if not provided
	if filename == "" {
		title := data.Title
		if title == "" {
			title = "cagent-session"
		}
		title = sanitizeFilename(title)
		filename = fmt.Sprintf("%s-%s.html", title, time.Now().Format("2006-01-02-150405"))
	}

	// Ensure .html extension
	if !strings.HasSuffix(strings.ToLower(filename), ".html") {
		filename += ".html"
	}

	htmlContent, err := Generate(data)
	if err != nil {
		return "", fmt.Errorf("failed to generate HTML: %w", err)
	}

	if err := os.WriteFile(filename, []byte(htmlContent), 0o644); err != nil { //nolint:gosec // exported HTML is meant to be readable by browsers/users
		return "", fmt.Errorf("failed to write file: %w", err)
	}

	absPath, err := filepath.Abs(filename)
	if err != nil {
		return filename, nil
	}
	return absPath, nil
}

func sanitizeFilename(name string) string {
	replacer := strings.NewReplacer(