Method FinalizeRun

coderd/x/chatd/chatdebug/service.go:615–654

FinalizeRun aggregates the run summary, updates the run status, and cleans up the step counter. It detaches from the parent context's cancellation so finalization succeeds even when the request context is already done. Errors are returned but are always safe to ignore; callers that treat debug instr

(ctx context.Context, p FinalizeRunParams)

// callers that treat debug instrumentation as best-effort can discard
// them.
func (s *Service) FinalizeRun(ctx context.Context, p FinalizeRunParams) error {
	timeout := p.Timeout
	if timeout <= 0 {
		timeout = 5 * time.Second
	}

	finalizeCtx, cancel := context.WithTimeout(
		context.WithoutCancel(ctx), timeout,
	)
	defer cancel()

	finalSummary := p.SeedSummary
	if aggregated, aggErr := s.AggregateRunSummary(
		finalizeCtx,
		p.RunID,
		p.SeedSummary,
	); aggErr != nil {
		// Non-fatal: proceed with the seed summary.
		s.log.Warn(ctx, "failed to aggregate debug run summary",
			slog.F("chat_id", p.ChatID),
			slog.F("run_id", p.RunID),
			slog.Error(aggErr),
		)
	} else {
		finalSummary = aggregated
	}

	if _, err := s.UpdateRun(finalizeCtx, UpdateRunParams{
		ID:         p.RunID,
		ChatID:     p.ChatID,
		Status:     p.Status,
		Summary:    finalSummary,
		FinishedAt: s.clock.Now(),
	}); err != nil {
		CleanupStepCounter(p.RunID)
		return xerrors.Errorf("update debug run: %w", err)
	}
	CleanupStepCounter(p.RunID)
	return nil
}

// ClassifyError maps a run error to the appropriate debug status.
// nil → StatusCompleted, context.Canceled → StatusInterrupted,