Step

A step is a "how it works" card. Display only. Despite the name, it is not part of an execution pipeline, workflow definition, or state machine.

Schema (agent_steps)

Column	Type	Notes
id	UUID	PK
agentId	UUID	FK → agents
title	text	Short heading
description	text	One-sentence body
sortOrder	int	Render order, ascending

Endpoints

Verb	Path	Guard
GET	/agents/:agentId/steps	public
POST	/agents/:agentId/steps	platform_admin
PATCH	/agents/:agentId/steps/:id	platform_admin
DELETE	/agents/:agentId/steps/:id	platform_admin

DTO

type StepDto = {
  id: string;
  title: string;
  description: string;
  sortOrder: number;
};

Idiomatic copy

The frontend renders these as a 3-or-4-up horizontal strip. Keep titles ≤ 25 characters and descriptions ≤ 100 — anything longer wraps awkwardly on mobile.