Method TouchStep

coderd/x/chatd/chatdebug/service.go:508–523

TouchStep bumps the step's and its parent run's updated_at timestamps without changing any other fields. This prevents long-running operations (e.g. streaming) from being prematurely swept by FinalizeStale, which first marks runs stale by chat_debug_runs.updated_at and then cascades to steps whose r

(
	ctx context.Context,
	stepID uuid.UUID,
	runID uuid.UUID,
	chatID uuid.UUID,
)

// first marks runs stale by chat_debug_runs.updated_at and then cascades
// to steps whose run_id was just finalized.
func (s *Service) TouchStep(
	ctx context.Context,
	stepID uuid.UUID,
	runID uuid.UUID,
	chatID uuid.UUID,
) error {
	// Atomically bump both the step and its parent run so
	// FinalizeStale cannot interleave between the two touches.
	return s.db.TouchChatDebugStepAndRun(chatdContext(ctx),
		database.TouchChatDebugStepAndRunParams{
			Now:    s.clock.Now(),
			StepID: stepID,
			RunID:  runID,
			ChatID: chatID,
		})
}

// DeleteByChatID deletes debug data for a chat and emits a delete event.
// The startedBefore bound scopes deletion to runs created before that