Follow-up to #31.
Today, list-shaped responses (search_collection, search_discogs, get_recommendations, list_folders) end with breadcrumbs that say release_id=<ID> / folder_id=<ID>. That's correct when the user genuinely has to pick from many candidates, but the first suggestion in those breadcrumbs is almost always "expand the top hit" — and we already know what the top hit is.
Proposed: when the response has a single clear leader (top of the list, top recommendation, default folder), template that into the first breadcrumb so the model can copy it verbatim. Keep <ID> for the second/third suggestions where the picking choice is real.
Example, search_collection returning Bill Evans Trio at the top:
- `get_release(release_id=28861354)` — expand the top hit
- `get_release(release_id=<ID>)` — expand any other hit using its [ID:...]
- `rate_release(instance_id=<INSTANCE>, folder_id=<FOLDER>, rating=1..5)` — rate one of these items
Caught this while exercising #31 end-to-end — the value-templated breadcrumbs (e.g. get_release interpolating the actual release ID and artist name into follow-ups) were dramatically more useful than placeholder ones. This is the same pattern applied to list responses where there's an obvious anchor.
Follow-up to #31.
Today, list-shaped responses (
search_collection,search_discogs,get_recommendations,list_folders) end with breadcrumbs that sayrelease_id=<ID>/folder_id=<ID>. That's correct when the user genuinely has to pick from many candidates, but the first suggestion in those breadcrumbs is almost always "expand the top hit" — and we already know what the top hit is.Proposed: when the response has a single clear leader (top of the list, top recommendation, default folder), template that into the first breadcrumb so the model can copy it verbatim. Keep
<ID>for the second/third suggestions where the picking choice is real.Example,
search_collectionreturning Bill Evans Trio at the top:Caught this while exercising #31 end-to-end — the value-templated breadcrumbs (e.g.
get_releaseinterpolating the actual release ID and artist name into follow-ups) were dramatically more useful than placeholder ones. This is the same pattern applied to list responses where there's an obvious anchor.