Gathrd

Use this whenever the user asks to add, save, import, pin, or put products into Gathrd. Call it directly without a preamble like 'I'm saving that now'. A collection is optional: if the user does not name one, save the item into Gathrd without assigning a collection. If the user names a collection and there is one obvious match, use it directly. Only call this tool when you have real retailer product URLs. Reuse product links already surfaced earlier in the conversation when the user says save those. If the collection name is genuinely ambiguous, call show_collection_picker instead of guessing. When this tool succeeds, rely on the widget to show the saved results instead of restating every item in plain text. Never claim items were added unless this tool succeeds.

save_product_links

Use this only when a collection name is ambiguous and the user needs a focused picker to choose the correct Gathrd collection before browsing or saving. Call it directly without preamble. Let the widget handle the choice instead of repeating the candidates in prose.

show_collection_picker

Use this when the user explicitly asks to create a new collection in Gathrd. Call it directly without a preamble like 'I'm creating that now'. Keep the confirmation conversational after it succeeds.

create_collection

Use this when the user wants to open, view, or share a specific Gathrd collection in the web viewer or app.

get_collection_link

Use this when the user asks what collections they have in Gathrd. After calling this tool, list the collections directly in plain chat text in the conversation. Never tell the user to look above, never refer to a widget or tool card, and do not assume any inline UI is visible. Do not include per-collection links; if you include a link, include only one final 'View all in Gathrd' link at the end. Do not use this tool for item browsing.

list_collections

Use this for browsing saved items in Gathrd, including prompts about a collection, favourites, retailer-specific items, price ranges, search terms, and recently added items. For prompts like 'Show me my H&M items in Gathrd' or 'Show my Zara saves', always set the retailer field instead of falling back to a generic recent-items view. Only use recent sorting when the user explicitly asks for recently added items. Call it directly without preamble. When this tool succeeds, rely on the widget to show the results and do not restate every item in plain text. If the collection name is ambiguous, call show_collection_picker instead of guessing.

list_saved_items