zero/internal/tui/session_title.go

package tui

import (
	"context"
	"errors"
	"strings"
	"time"

	tea "charm.land/bubbletea/v2"

	"github.com/Gitlawb/zero/internal/agent"
	"github.com/Gitlawb/zero/internal/sessions"
	"github.com/Gitlawb/zero/internal/zeroruntime"
)

const (
	// sessionTitleMaxMessageChars caps how much of any single message goes into
	// the title prompt — a title only needs the gist, not the whole turn.
	sessionTitleMaxMessageChars = 320
	// sessionTitleMaxDigestChars bounds the whole digest so titling stays a cheap
	// one-shot call regardless of how long the conversation was.
	sessionTitleMaxDigestChars = 1600
	// sessionTitleWordCap is the most words a cleaned title may keep.
	sessionTitleWordCap = 8
	// sessionTitleTimeout bounds a single title generation so a hung provider can
	// never wedge the background command.
	sessionTitleTimeout = 30 * time.Second
)

// titleTrimCutset is stripped from both ends of a model-produced title:
// whitespace, surrounding quotes/backticks, markdown emphasis/heading marks, and
// trailing sentence punctuation. ` is a backtick.
const titleTrimCutset = " \t\r\n\"'`*#.,:;!"

const sessionTitleSystemPrompt = "You write a short, specific title for a coding-assistant conversation so a user can tell it apart from others in a list. " +
	"Reply with ONLY the title and nothing else: 3 to 6 words, Title Case, naming the concrete task or topic. " +
	"No surrounding quotes, no trailing punctuation, no preamble, no explanation."

// errSessionTitleNoContent marks a session that has nothing worth titling, so the
// background command exits without a wasted provider call.
var errSessionTitleNoContent = errors.New("session has no content to title")

// sessionTitleGeneratedMsg carries the outcome of a background title generation
// back to the Update loop.
type sessionTitleGeneratedMsg struct {
	sessionID string
	title     string
	applied   bool
	err       error
}

// sessionTitleDigest renders a compact, bounded transcript of a session for the
// title prompt: user/assistant text and tool names, each trimmed, the whole
// thing capped. The no-output guardrail stop is skipped so a failed run never
// becomes the "topic".
func sessionTitleDigest(events []sessions.Event) string {
	var builder strings.Builder
	total := 0
	add := func(label, content string) bool {
		content = strings.Join(strings.Fields(content), " ")
		if content == "" {
			return true
		}
		content = cutRunes(content, sessionTitleMaxMessageChars)
		line := label + ": " + content + "\n"
		if total > 0 && total+len(line) > sessionTitleMaxDigestChars {
			return false // budget spent — keep what we have
		}
		builder.WriteString(line)
		total += len(line)
		return true
	}
	for _, event := range events {
		payload := sessionPayload(event)
		switch event.Type {
		case sessions.EventMessage:
			content := payloadString(payload, "content")
			if agent.IsNoProgressStop(content) {
				continue
			}
			switch strings.ToLower(strings.TrimSpace(payloadString(payload, "role"))) {
			case "user":
				if !add("User", content) {
					return strings.TrimSpace(builder.String())
				}
			case "assistant":
				if !add("Assistant", content) {
					return strings.TrimSpace(builder.String())
				}
			}
		case sessions.EventToolCall:
			if name := strings.TrimSpace(payloadString(payload, "name")); name != "" {
				if !add("Tool", name) {
					return strings.TrimSpace(builder.String())
				}
			}
		}
	}
	return strings.TrimSpace(builder.String())
}

// cleanGeneratedTitle normalizes a raw model response into a single short title
// line: first non-empty line only, surrounding quotes/markup and a leading
// "Title:" label removed, whitespace collapsed, word- and rune-capped. Returns ""
// when nothing usable remains so the caller keeps the existing title.
func cleanGeneratedTitle(raw string) string {
	title := strings.TrimSpace(raw)
	if title == "" {
		return ""
	}
	// Use the first line with real content after trimming markup — a model may
	// open with a bare code fence or blank line before the title itself.
	for _, line := range strings.Split(title, "\n") {
		if trimmed := strings.Trim(line, titleTrimCutset); trimmed != "" {
			title = trimmed
			break
		}
	}
	title = strings.Trim(title, titleTrimCutset)
	// Drop a leading "Title:" / "Title -" label the model sometimes prepends.
	if idx := strings.IndexAny(title, ":-"); idx > 0 && idx <= 6 {
		if strings.EqualFold(strings.TrimSpace(title[:idx]), "title") {
			title = strings.TrimSpace(title[idx+1:])
		}
	}
	title = strings.Trim(title, titleTrimCutset)
	fields := strings.Fields(title)
	if len(fields) == 0 {
		return ""
	}
	if len(fields) > sessionTitleWordCap {
		fields = fields[:sessionTitleWordCap]
	}
	return cutRunes(strings.Join(fields, " "), tuiSessionTitleLimit)
}

// generateSessionTitle asks the provider for a concise title for digest and
// returns the cleaned result. It is provider-shaped exactly like the one-shot
// summarization call: system instructions + a single user turn, no tools.
func generateSessionTitle(ctx context.Context, provider zeroruntime.Provider, digest string) (string, error) {
	if provider == nil {
		return "", errors.New("no provider configured")
	}
	if strings.TrimSpace(digest) == "" {
		return "", errSessionTitleNoContent
	}
	request := zeroruntime.CompletionRequest{
		Messages: []zeroruntime.Message{
			{Role: zeroruntime.MessageRoleSystem, Content: sessionTitleSystemPrompt},
			{Role: zeroruntime.MessageRoleUser, Content: "Conversation:\n\n" + digest + "\n\nTitle:"},
		},
	}
	stream, err := provider.StreamCompletion(ctx, request)
	if err != nil {
		return "", err
	}
	collected := zeroruntime.CollectStreamWithOptions(ctx, stream, zeroruntime.CollectOptions{})
	if collected.Error != "" {
		return "", errors.New(collected.Error)
	}
	title := cleanGeneratedTitle(collected.Text)
	if title == "" {
		return "", errors.New("model returned no usable title")
	}
	return title, nil
}

// generateSessionTitleCmd builds the background command that generates and
// persists a title for sessionID if its original automatic title is still
// current. The compare-and-update keeps a manual /rename authoritative when it
// races a slow provider response.
func (m model) generateSessionTitleCmd(sessionID string, digest string) tea.Cmd {
	provider := m.provider
	store := m.sessionStore
	originalTitle := m.activeSession.Title
	return func() tea.Msg {
		ctx, cancel := context.WithTimeout(context.Background(), sessionTitleTimeout)
		defer cancel()
		title, err := generateSessionTitle(ctx, provider, digest)
		if err != nil {
			return sessionTitleGeneratedMsg{sessionID: sessionID, err: err}
		}
		updated, applied, err := store.UpdateTitleIfCurrent(sessionID, originalTitle, title)
		if err != nil {
			return sessionTitleGeneratedMsg{sessionID: sessionID, title: title, err: err}
		}
		return sessionTitleGeneratedMsg{sessionID: sessionID, title: updated.Title, applied: applied}
	}
}

// firstUserMessageTitle is the auto title a session would get from its first user
// message (the same derivation Create uses), or "" if it has no user message.
func firstUserMessageTitle(events []sessions.Event) string {
	for _, event := range events {
		if event.Type != sessions.EventMessage {
			continue
		}
		payload := sessionPayload(event)
		if !strings.EqualFold(payloadString(payload, "role"), "user") {
			continue
		}
		if content := strings.TrimSpace(payloadString(payload, "content")); content != "" {
			return tuiSessionTitle(content)
		}
	}
	return ""
}

// sessionTitleIsAuto reports whether a session still carries its default
// first-message title (so it is worth replacing with a model-generated one). A
// title the model already produced differs from the first message and is left
// alone.
func sessionTitleIsAuto(currentTitle string, events []sessions.Event) bool {
	trimmed := strings.TrimSpace(currentTitle)
	if trimmed == "" || trimmed == tuiSessionTitle("") {
		return true
	}
	if first := firstUserMessageTitle(events); first != "" && trimmed == first {
		return true
	}
	return false
}

// maybeAutoTitleActiveSession fires a one-shot title generation for the active
// session after a successful turn, if it still has its default first-message
// title and we have not already attempted it this process. It is a no-op when
// there is no provider, no session, or nothing worth titling.
func (m model) maybeAutoTitleActiveSession() (model, tea.Cmd) {
	// Both are required: the title cmd captures the provider AND calls
	// store.UpdateTitle, so a nil store (e.g. a fallback model in tests) would
	// nil-deref on the auto-title path. Mirrors the nil-store guards on resume.
	if m.provider == nil || m.sessionStore == nil {
		return m, nil
	}
	sessionID := m.activeSession.SessionID
	if sessionID == "" || m.titledSessions[sessionID] {
		return m, nil
	}
	if !sessionTitleIsAuto(m.activeSession.Title, m.sessionEvents) {
		return m, nil
	}
	digest := sessionTitleDigest(m.sessionEvents)
	if digest == "" {
		return m, nil
	}
	if m.titledSessions == nil {
		m.titledSessions = map[string]bool{}
	}
	m.titledSessions[sessionID] = true
	return m, m.generateSessionTitleCmd(sessionID, digest)
}

// handleSessionTitleGenerated applies a finished automatic title to the active
// model. The store update has already been skipped when a manual rename won.
func (m model) handleSessionTitleGenerated(msg sessionTitleGeneratedMsg) (model, tea.Cmd) {
	titleOK := msg.err == nil && msg.title != "" && msg.applied
	if titleOK {
		if msg.sessionID == m.activeSession.SessionID {
			m.activeSession.Title = msg.title
			m = m.syncPeerIdentity()
		}
	} else if msg.err != nil || msg.title == "" {
		// titledSessions is marked optimistically when the cmd is scheduled (so a
		// second turn can't double-fire a title for the same session while the
		// first is in flight). A FAILED generation — provider error, empty title,
		// or store write error — must not leave that gate set forever, so release
		// it here so a later turn can retry. Success keeps the gate.
		delete(m.titledSessions, msg.sessionID)
	}
	return m, nil
}