content thumbnails

Invocation#

echo-cli content thumbnails list --post <post-id>
echo-cli content thumbnails make --post <post-id> --count <n> --prompt <text> --by <who>
echo-cli content thumbnails choose --id <variant-id> --by <who>

Inputs and output#

list writes post_id, thumbnail_url (the post's thumbnail now), post_metrics (its stored metrics now) and variants, newest job first: id, post_id, job_id, variant (its number in the job), prompt, route, object_uri (the Stado object), url (where Echo serves it), created_by, created_at, chosen_by and chosen_at. make writes the variants it drew; choose writes the variant chosen.

State effect#

The verbs call Echo Web's authenticated /api/analytics/thumbnails with ECHO_INTERNAL_BEARER at ECHO_WEB_BASE_URL; the Thumbnail variants section of the ecosystem's analytics and of Echo Desktop's GEO screen do the same, and echo-mcp runs them as echo_thumbnails, echo_thumbnails_make and echo_thumbnail_choose. make draws --count images one after another from --prompt on the image route Echo Web's ECHO_THUMBNAIL_ROUTE declares, through Brama, stores each as a Stado object under echo/thumbnails/<post>/<job>/ and records it in thumbnail_variants. choose makes the variant's address the post's thumbnail_url through the checks the content queue runs on an edit (media rights, people shown, review), and records who chose it and when; the post's stored metrics are then read against the thumbnail it carried. Click-through per thumbnail is not measured: the scrapes store no impressions.

Refusals#

• A wrong invocation is refused before anything is sent: "content thumbnails takes list …; make …; choose …; got <word>", "content thumbnails <verb> does not take <flag>; it takes …", "<flag> needs a value" and "content thumbnails <verb> needs <flag>"; --count is left to Echo Web, so its refusal names the field.
• Echo Web answers a bad request with "count is required: how many thumbnail variants to draw", "count must be a positive whole number: how many thumbnail variants to draw; got <value>", "prompt is required: what the thumbnails show", "post_id is required: …", "id is required: …" or "<field>_by is required: an internal caller has no signed-in user, so it names who is acting"; not found with "no queued post has id <id>" or "no thumbnail variant has id <id>"; and a conflict with the content queue's refusal of the edit. A deployment without ECHO_THUMBNAIL_ROUTE answers naming the setting, and a route that draws nothing answers "Brama <route> answered no inline image". The command prints Echo Web's sentence and exits 1.