Goodsend

Use this when the user asks what they already own, or when checking a visible Goodsend profile before choosing a gift. Omit profile_url for the connected account; provide a direct Goodsend profile URL for someone else. Owned items are taste signals and duplicate-gift warnings, not wishlist requests.

list_owned_items

Use for broad Circle lists, ambiguous people, or when gift research needs a person's canonical Goodsend profile URL. For a request about one exact person, finish with render_user_profile after a clear match; that render tool can also resolve a unique name or handle itself.

list_circle

List product links saved by the connected Goodsend account. Use for broad lists, ambiguity, or resolving an item ID before a write. For a conversational request about one exact item, finish with render_good_preview after a clear match; that render tool can also resolve a unique saved-item query itself.

list_saved_items

Use this when the user says they already own or no longer own an active saved item. Use list_saved_items before marking an item owned, or list_owned_items before removing owned status. Owned status helps track belongings and keeps that item out of the account's visible gift-candidate list.

set_saved_item_owned

Move one item from a source collection to a destination collection. This removes the source membership after adding the destination membership atomically, and clears a source wishlist reservation if present. Omit from_collection_id when the item has only one other editable collection membership.

move_item

Data-oriented lookup for a shared Goodsend collection URL. Use when another workflow needs full data without UI, or when the user asks for text only. For a normal request about this one shared collection, finish with render_collection_preview using the same URL. Wishlist status never reveals who reserved an item.

get_shared_collection

Remove one to twenty item memberships from an editable collection or wishlist. The items remain saved in the connected Goodsend account. Any reservation for a removed wishlist item is also removed.

remove_items_from_collection

Default final presentation for exactly one Goodsend collection or wishlist. Call this with an exact ID, shared URL, or unique connected-account title even when the user did not say show, open, card, or preview. Skip only for an explicit text-only request or a broad multi-collection result. Provide exactly one reference. Renders up to eight image-rich item cards and eligible reservation actions.

render_collection_preview

Default final presentation for exactly one Goodsend item. Call this after resolving an item or directly with a unique query, even when the user did not say show, open, card, or preview. Skip only for an explicit text-only request or a broad multi-item result. Provide profile_url when the item belongs to someone else's visible profile; omit it for the connected account. The server resolves, reloads, and authorizes the item instead of trusting model-supplied product data.

render_good_preview

Default final presentation for exactly one Goodsend profile. Call this with an exact URL or unique Circle name/handle even when the user did not say show, open, card, or preview. Skip only for an explicit text-only request or a broad multi-profile result. The server resolves, reloads, and authorizes the profile. This preview does not load items; use get_user_items_from_profile_url for gift ideas.

render_user_profile

Use this when the connected user explicitly chooses an available item from someone else's shareable Goodsend wishlist. The operation is retry-safe, never reveals another reserver's identity, and rejects private lists, ordinary collections, and lists the user can edit.

reserve_wishlist_item

Save one public HTTP or HTTPS product link to the connected Goodsend account. Goodsend reuses its normal duplicate handling and product parsing pipeline.

save_link

Use this when the connected user explicitly asks to undo their own reservation on a shareable Goodsend wishlist item. It cannot remove another person's reservation and is retry-safe.

unreserve_wishlist_item

Update the title, description, kind, or visibility of a collection owned by the connected account. Collaborators cannot change settings. Omitted fields stay unchanged; use clear_description=true to remove the description. A wishlist becomes recipient-reservable only while its visibility is public/shareable.

update_collection