Method generateManualTitleCandidate

coderd/x/chatd/chatd.go:3170–3259

generateManualTitleCandidate performs only model generation and returns the candidate plus accounting metadata. Endpoint-specific commit paths are responsible for recording usage and deciding whether to persist the title. The context may carry the caller's delegated API key for manual title routes.

(
	ctx context.Context,
	store database.Store,
	chat database.Chat,
	keys chatprovider.ProviderAPIKeys,
)

// responsible for recording usage and deciding whether to persist the title.
// The context may carry the caller's delegated API key for manual title routes.
func (p *Server) generateManualTitleCandidate(
	ctx context.Context,
	store database.Store,
	chat database.Chat,
	keys chatprovider.ProviderAPIKeys,
) (manualTitleCandidateResult, error) {
	if limitErr := p.checkUsageLimit(ctx, store, chat.OwnerID, uuid.NullUUID{UUID: chat.OrganizationID, Valid: true}); limitErr != nil {
		return manualTitleCandidateResult{}, limitErr
	}

	headMessages, err := store.GetChatMessagesByChatIDAscPaginated(
		ctx,
		database.GetChatMessagesByChatIDAscPaginatedParams{
			ChatID:   chat.ID,
			AfterID:  0,
			LimitVal: manualTitleMessageWindowLimit,
		},
	)
	if err != nil {
		return manualTitleCandidateResult{}, xerrors.Errorf("get head chat messages: %w", err)
	}
	tailMessages, err := store.GetChatMessagesByChatIDDescPaginated(
		ctx,
		database.GetChatMessagesByChatIDDescPaginatedParams{
			ChatID:   chat.ID,
			BeforeID: 0,
			LimitVal: manualTitleMessageWindowLimit,
		},
	)
	if err != nil {
		return manualTitleCandidateResult{}, xerrors.Errorf("get tail chat messages: %w", err)
	}
	messages := mergeManualTitleMessages(headMessages, tailMessages)
	if len(messages) == 0 {
		return manualTitleCandidateResult{}, nil
	}
	modelOpts := modelBuildOptionsFromMessages(messages)
	// Manual title routes can run over messages that lack API key attribution.
	// Fall back to the authenticated caller's delegated key for AI Gateway routing.
	if modelOpts.ActiveAPIKeyID == "" {
		if apiKeyID, ok := aibridge.DelegatedAPIKeyIDFromContext(ctx); ok {
			modelOpts.ActiveAPIKeyID = apiKeyID
		}
	}

	model, modelConfig, modelKeys, err := p.resolveManualTitleModel(ctx, store, chat, keys, modelOpts)
	result := manualTitleCandidateResult{
		modelConfig:    modelConfig,
		activeAPIKeyID: modelOpts.ActiveAPIKeyID,
		hasMessages:    true,
	}
	if err != nil {
		return result, err
	}

	titleCtx := ctx
	titleModel := model
	finishDebugRun := func(error) {}