Method UpdateStep

coderd/x/chatd/chatdebug/service.go:472–501

UpdateStep updates an existing debug step and emits a step update event. When a terminal status is set without an explicit FinishedAt, the service auto-fills the timestamp so the stale sweep does not leave terminal rows with finished_at = NULL.

(
	ctx context.Context,
	params UpdateStepParams,
)

// service auto-fills the timestamp so the stale sweep does not leave
// terminal rows with finished_at = NULL.
func (s *Service) UpdateStep(
	ctx context.Context,
	params UpdateStepParams,
) (database.ChatDebugStep, error) {
	if params.Status.IsTerminal() && params.FinishedAt.IsZero() {
		params.FinishedAt = s.clock.Now()
	}
	step, err := s.db.UpdateChatDebugStep(chatdContext(ctx),
		database.UpdateChatDebugStepParams{
			Status:              nullString(string(params.Status)),
			HistoryTipMessageID: sql.NullInt64{},
			AssistantMessageID:  nullInt64(params.AssistantMessageID),
			NormalizedRequest:   pqtype.NullRawMessage{},
			NormalizedResponse:  s.nullJSON(ctx, params.NormalizedResponse),
			Usage:               s.nullJSON(ctx, params.Usage),
			Attempts:            s.nullJSON(ctx, params.Attempts),
			Error:               s.nullJSON(ctx, params.Error),
			Metadata:            s.nullJSON(ctx, params.Metadata),
			FinishedAt:          nullTime(params.FinishedAt),
			Now:                 s.clock.Now(),
			ID:                  params.ID,
			ChatID:              params.ChatID,
		})
	if err != nil {
		return database.ChatDebugStep{}, err
	}

	s.publishEvent(ctx, step.ChatID, EventKindStepUpdate, step.RunID, step.ID)
	return step, nil
}

// TouchStep bumps the step's and its parent run's updated_at timestamps
// without changing any other fields. This prevents long-running operations