Fraghab

Search retailers for the best current price on something already on this user's wishlist, and return the cheapest offer with the retailer selling it. Name the fragrance, or pass the wishlistId that add_to_wishlist returned. It also gives the item a product photo if it doesn't have one yet. Each hunt spends one of the account's limited daily price scans, so call it when the user asks about price or where to buy — not automatically after every add.

hunt_wishlist_price

Use this when the user asks about one bottle or decant in depth — its notes and note pyramid, performance, price paid, remaining ml, how often and when it has been worn, cost per wear, which shelves it sits on, whether it is running low. list_collection gives the summary row; this gives everything the app's own detail page shows. Take the id from list_collection.

get_collection_item

List the user's layering combos — the fragrance pairings they have saved — with what is in each, how often it has been worn, and when it was last worn.

list_combos

List the user's shelves — the way they group bottles — with what is on each one.

list_shelves

List the fragrances this user owns — full bottles and decants — with remaining ml, rating, wear count and the date each was last worn. The ids it returns are what every other tool takes.

list_collection

Record that the user wore something from their collection on a given day. Deducts the sprayed ml from that bottle's remaining amount. Take the id from list_collection. For a layering combo use log_combo_wearing instead.

log_wearing

Record that the user wore a whole saved combo on a day. Logs one wearing covering every fragrance in it and deducts each one's sprays from its remaining ml, using the combo's own spray map where it has one.

log_combo_wearing

The user bought something off their wishlist. Moves it into the collection — restoring the original entry if this item came from one — and records what they paid.

promote_wishlist

The user got rid of a bottle but still wants it tracked — sold it, used it up, or decided to rebuy later. Archives the collection entry and puts it on the wishlist. Nothing is deleted, and promote_wishlist puts it back.

move_to_wishlist

Use this when the user is travelling and asks what to bring: give the destination and dates and Fraghab builds a day-by-day packing list from their own collection against the forecast there — one pick per day with alternatives, a small set of bottles overall, and notes on travel-friendly sizes. Pass tripType for the occasion (Travel, Wedding, Beach…), bottleLimit to cap how many bottles they will carry, and mustPack for entries that go regardless. Trips are at most 14 days. It spends one of the user's daily planner runs, so call it once per trip and not to re-ask the same question; a repeat can differ.

plan_trip_packing

Add bottles to a shelf or take them off it. Only bottles can sit on a shelf. Taking a bottle off a shelf does not remove it from the collection.

set_shelf_members

The user liked a decant enough to want the full bottle. Adds it to the wishlist as a Full Bottle. The decant stays in the collection.

reorder_decant

Record how a fragrance actually performed on a day the user wore it — a thumbs up or down plus optional tags. This is what teaches the app's recommendations.

submit_wearing_feedback

Use this to see the user's buy queue: every active wishlist item with its priority, the size and price they noted, their target price, and the best offer the last retailer scan found (price, shop, size, when). Read it before hunt_wishlist_price so you spend a scan only on an item that has none or a stale one, and take wishlist ids from here. Set includeBought to also list what they already bought.

list_wishlist

Save a layering combo — two or more fragrances the user wears together. Take the ids from list_collection. Optionally record where each one goes and how many sprays.

create_combo

Search Fraghab's fragrance catalog and the wider community's entries by name or house. Returns matches with their house, concentration, notes and accords, and flags the ones already in this user's collection. Use this to resolve a fragrance before adding it.

search_fragrances

Set a single field to the same value across many entries at once — for example tagging a dozen bottles as Winter. An empty value clears the field. Season and occasion REPLACE the whole list on each entry rather than adding to it, so read the entries first if the user means to add a tag.

bulk_update_collection

The user bought a full bottle of something they had as a decant. Creates the full-bottle entry from the decant's details, with its own copy of the artwork, and closes any full-bottle wishlist entry for the same scent. If the user had archived a bottle of it, that bottle is restored instead of duplicated. Pass bottleSize and pricePaid when the user says them — they describe the bottle, never the decant. By default the decant is left in the collection; set retireDecant to true only when the user says they are done with the decant, which archives it (reversible in the app) rather than deleting it.

promote_decant

Use this to read what the user wore and when — last week, a date range, a single day — newest first, with the occasion, their note, the spray count per fragrance, and the combo it came from if any. Use it for questions like 'what did I wear on Friday', 'how often have I worn X this month' or 'what have I not worn lately' (combine with list_collection's lastWorn for the latter). Page with the cursor it returns. To change a wearing, use update_wearing with the id.

list_wearings

Use this when the user asks what to wear — today, tonight, for an occasion, in a mood — and let Fraghab's own engine rank their collection: weather at their saved location, season, the occasion and mood you pass, what they have worn lately and how it performed, their ratings and their own learned preferences. Returns the daily pick, the top-ranked entries each with the reasons it scored, and any layering combos that fit. Pass the user's IANA timezone so 'today' is their today. Do not call it to answer general fragrance questions; it ranks only what the user owns. If the user has never logged a wearing it says so — suggestions need at least one.

suggest_wearing